Compartilhar via


Estilo SearchBar no iOS

Esta interface do usuário do aplicativo multiplataforma .NET (.NET MAUI) específica da plataforma iOS controla se um tem um SearchBar plano de fundo. Ele é consumido em XAML definindo a SearchBar.SearchBarStyle propriedade bindable como um valor da UISearchBarStyle enumeração:

<ContentPage ...
             xmlns:ios="clr-namespace:Microsoft.Maui.Controls.PlatformConfiguration.iOSSpecific;assembly=Microsoft.Maui.Controls">
    <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 Microsoft.Maui.Controls.PlatformConfiguration;
using Microsoft.Maui.Controls.PlatformConfiguration.iOSSpecific;
...

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

O SearchBar.On<iOS> método especifica que essa plataforma específica só será executada no iOS. O SearchBar.SetSearchBarStyle método, no Microsoft.Maui.Controls.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 tem o SearchBar estilo padrão. Esse é o valor padrão da SearchBar.SearchBarStyle propriedade bindable.
  • Prominent indica que o tem um fundo translúcido e o SearchBar campo de pesquisa é opaco.
  • Minimal indica que o não tem plano de fundo e o SearchBar campo de pesquisa é translúcido.

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

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

Screenshot of SearchBar styles, on iOS.

A captura de tela a seguir mostra os membros aplicados a UISearchBarStyle SearchBar objetos que têm suas BackgroundColor propriedades definidas:

Screenshot of SearchBar styles with background color, on iOS.