Share via

iOS での SearchBar スタイル

  • [アーティクル]

この iOS プラットフォーム固有設定では、SearchBar に背景があるかどうかを制御します。 これは、SearchBar.SearchBarStyle のバインド可能なプロパティを UISearchBarStyle 列挙型の値に設定することによって XAML で使用されます。

<ContentPage ...
             xmlns:ios="clr-namespace:Xamarin.Forms.PlatformConfiguration.iOSSpecific;assembly=Xamarin.Forms.Core">
    <StackLayout>
        <SearchBar ios:SearchBar.SearchBarStyle="Minimal"
                   Placeholder="Enter search term" />
        ...
    </StackLayout>
</ContentPage>

あるいは、Fluent API を使用して C# から使用することもできます。

using Xamarin.Forms.PlatformConfiguration;
using Xamarin.Forms.PlatformConfiguration.iOSSpecific;
...

SearchBar searchBar = new SearchBar { Placeholder = "Enter search term" };
searchBar.On<iOS>().SetSearchBarStyle(UISearchBarStyle.Minimal);

SearchBar.On<iOS> メソッドは、このプラットフォーム固有の機能が iOS でのみ実行されるように指定します。 Xamarin.Forms.PlatformConfiguration.iOSSpecific 名前空間の SearchBar.SetSearchBarStyle メソッドは、SearchBar に背景があるかどうかを制御するために使用されます。 UISearchBarStyle 列挙は、次の 3 つの取り得る値を提供します。

  • Default は、SearchBar に既定のスタイルがあることを示します。 これは、バインド可能な SearchBar.SearchBarStyle プロパティの既定値です。
  • Prominent は、SearchBar に半透明の背景があり、検索フィールドが不透明であることを示します。
  • Minimal は、SearchBar に背景がなく、検索フィールドが半透明であることを示します。

さらに、SearchBar.GetSearchBarStyle メソッドを使用すると、SearchBar に適用される UISearchBarStyle を返すことができます。

その結果、指定した UISearchBarStyle メンバーが SearchBar に適用され、SearchBar に背景があるかどうかが制御されます。

iOS での SearchBar のスタイルのスクリーンショット

次のスクリーンショットは、BackgroundColor プロパティが設定されている SearchBar オブジェクトに適用されている UISearchBarStyle メンバーを示しています。

iOS での背景色がある SearchBar のスタイルのスクリーンショット