Visibilidade da barra de status da página no iOS

  • Artigo

Esse específico da plataforma iOS é usado para definir a visibilidade da barra de status em um Page, e inclui a capacidade de controlar como a barra de status entra ou sai do Page. Ele é consumido em XAML definindo a propriedade anexada Page.PrefersStatusBarHidden como um valor da StatusBarHiddenMode enumeração e, opcionalmente, a Page.PreferredStatusBarUpdateAnimation propriedade anexada como um valor da UIStatusBarAnimation enumeração:

<ContentPage ...
             xmlns:ios="clr-namespace:Xamarin.Forms.PlatformConfiguration.iOSSpecific;assembly=Xamarin.Forms.Core"
             ios:Page.PrefersStatusBarHidden="True"
             ios:Page.PreferredStatusBarUpdateAnimation="Fade">
  ...
</ContentPage>

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

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

On<iOS>().SetPrefersStatusBarHidden(StatusBarHiddenMode.True)
         .SetPreferredStatusBarUpdateAnimation(UIStatusBarAnimation.Fade);

O método Page.On<iOS> especifica que essa plataforma específica só será executada no iOS. O Page.SetPrefersStatusBarHidden método, no Xamarin.Forms.PlatformConfiguration.iOSSpecific namespace, é usado para definir a visibilidade da barra de status em um Page especificando um dos StatusBarHiddenMode valores de enumeração: Default, True, ou False. Os StatusBarHiddenMode.True valores e StatusBarHiddenMode.False definem a visibilidade da barra de status independentemente da orientação do dispositivo, e o StatusBarHiddenMode.Default valor oculta a barra de status em um ambiente verticalmente compacto.

O resultado é que a visibilidade da barra de status em um Page pode ser definida:

Visibilidade da barra de status específica da plataforma

Observação

Em um TabbedPage, o valor de enumeração especificado StatusBarHiddenMode também atualizará a barra de status em todas as páginas filho. Em todos os outros Pagetipos derivados de -, o valor de enumeração especificado StatusBarHiddenMode atualizará apenas a barra de status na página atual.

O Page.SetPreferredStatusBarUpdateAnimation método é usado para definir como a barra de status entra ou sai do Page especificando um dos UIStatusBarAnimation valores de enumeração: None, Fade, ou Slide. Se o valor de Fade enumeração or Slide for especificado, uma animação de 0,25 segundo será executada à medida que a barra de status entrar ou sair do Page.