Partilhar via


Estilo SearchBar no iOS

Este específico da plataforma iOS controla se a SearchBar tem um plano de fundo. Ele é consumido em XAML definindo a SearchBar.SearchBarStyle propriedade associável como um valor da UISearchBarStyle enumeração:

<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>

Como alternativa, ele pode ser consumido do C# usando a API fluente:

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

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

O método SearchBar.On<iOS> especifica que essa plataforma específica só será executada no iOS. O SearchBar.SetSearchBarStyle método, no Xamarin.Forms.PlatformConfiguration.iOSSpecific namespace, é usado para controlar se o SearchBar tem um plano de fundo. A UISearchBarStyle enumeração fornece três valores possíveis:

  • Default indica que o SearchBar tem o estilo padrão. Esse é o valor padrão da SearchBar.SearchBarStyle propriedade associável.
  • Prominent indica que o SearchBar tem um plano de fundo translúcido e o campo de pesquisa é opaco.
  • Minimal indica que o não SearchBar tem plano de fundo e o campo de pesquisa é translúcido.

Além disso, o SearchBar.GetSearchBarStyle método pode ser usado para retornar o UISearchBarStyle que é aplicado ao SearchBar.

O resultado é que um membro especificado UISearchBarStyle é aplicado a um SearchBar, que controla se o SearchBar tem um plano de fundo:

Captura de tela dos estilos SearchBar, no iOS

As capturas de tela a seguir mostram os UISearchBarStyle membros aplicados a SearchBar objetos que têm suas BackgroundColor propriedades definidas:

Captura de tela dos estilos do SearchBar com cor de fundo, no iOS