Resumo do Capítulo 25. Variedades de página
Observação
Este livro foi publicado na primavera de 2016, e não foi atualizado desde então. Há muito no livro que permanece valioso, mas parte do material está desatualizado, e alguns tópicos não estão mais totalmente corretos ou completos.
Até agora você viu duas classes que derivam de Page: ContentPage e NavigationPage. Este capítulo apresenta outros dois:
MasterDetailPagegerencia duas páginas, um mestre e um detalheTabbedPageGerencia várias páginas filhas acessadas por meio de guias
Esses tipos de página fornecem opções de navegação mais sofisticadas do que as discutidas NavagationPage no Capítulo 24. Navegação de Página.
Mestre e Detalhe
O MasterDetailPage define duas propriedades do tipo Page: Master e Detail. Geralmente, você define cada uma dessas propriedades como um ContentPagearquivo . O MasterDetailPage exibe e alterna entre essas duas páginas.
Há duas maneiras fundamentais de alternar entre essas duas páginas:
- divisão onde o mestre e o detalhe estão lado a lado
- popover onde a página de detalhes cobre ou cobre parcialmente a página mestra
Existem várias variações da abordagem popover (slide, overlap e swap), mas elas geralmente dependem da plataforma. Você pode definir a MasterDetailBehavior propriedade de MasterDetailPage para um membro da MasterBehavior enumeração:
No entanto, essa propriedade não tem efeito sobre os telefones. Os telefones sempre têm um comportamento popover. Somente tablets e janelas de desktop podem ter um comportamento dividido.
Explorando os comportamentos
O exemplo MasterDetailBehaviors permite que você experimente o comportamento padrão em diferentes dispositivos. O programa contém duas derivadas separadas ContentPage para o mestre e o detalhe (com uma Title propriedade definida em ambos) e outra classe que deriva disso MasterDetailPage os combina. A página de detalhes é incluída em um NavigationPage porque o programa UWP não funcionaria sem ele.
As plataformas Windows 8.1 e Windows Phone 8.1 exigem que um bitmap seja definido como a Icon propriedade da página mestra.
Volta às aulas
O exemplo SchoolAndDetail adota uma abordagem um pouco diferente para construir o programa para exibir os alunos da biblioteca SchoolOfFineArt.
As propriedades e Detail são definidas com árvores visuais no arquivo SchoolAndDetailPage.xaml, que deriva de MasterDetailPage.Master Essa organização permite que associações de dados sejam definidas entre as páginas mestre e de detalhes.
Esse arquivo XAML também define a IsPresented propriedade de MasterDetailPage como True. Isso faz com que a página mestra seja exibida na inicialização; Por padrão, a página de detalhes é exibida. O arquivo SchoolAndDetailPage.xaml.cs é definido IsPresented como false quando um item é selecionado na ListView página mestra. A página de detalhes é então exibida:
Sua própria interface de usuário
Embora Xamarin.Forms forneça uma interface de usuário para alternar entre os modos de exibição mestre e de detalhes, você pode fornecer o seu próprio. Para fazer isso:
- Defina a propriedade como
falsepara desativar o gestoIsGestureEnabledde percorrer - Substitua o
ShouldShowToolbarButtonmétodo e retornefalsepara ocultar os botões da barra de ferramentas no Windows 8.1 e no Windows Phone 8.1.
Em seguida, você deve fornecer um meio de alternar entre as páginas mestra e de detalhes, como demonstrado pelo exemplo ColorsDetail .
O exemplo MasterDetailTaps demonstra outra abordagem usando um TapGestureRecognizer nas páginas mestre e de detalhes.
TabbedPage
O TabbedPage é uma coleção de páginas entre as quais você pode alternar usando guias. Ela deriva MultiPage<Page> e não define nenhuma propriedade pública ou métodos próprios. MultiPage<T>, no entanto, define uma propriedade:
Childrenpropriedade do tipoIList<T>
Você preenche essa Children coleção com objetos de página.
Outra abordagem permite que você defina os TabbedPage filhos como um ListView usando essas duas propriedades que geram as páginas com guias automaticamente:
ItemsSourcedo tipoIEnumerableItemTemplatedo tipoDataTemplate
No entanto, essa abordagem não funciona bem no iOS quando a coleção contém mais de alguns itens.
MultiPage<T> define mais duas propriedades que permitem controlar qual página está visualizada no momento:
CurrentPagedo tipoT, referindo-se à páginaSelectedItemdo tipoObject, referindo-se ao objeto naItemsSourcecoleção
MultiPage<T> também define dois eventos:
PagesChangedquando aItemsSourcecoleção mudaCurrentPageChangedquando a página visualizada é alterada
Páginas de guias discretas
O exemplo DiscreteTabbedColors consiste em três páginas com guias que exibem cores de três maneiras diferentes. Cada guia é uma ContentPage derivada e, em seguida, a derivada TabbedPageDiscreteTabbedColorsPage.xaml combina as três páginas.
Para cada página que aparece em um TabbedPage, a Title propriedade é necessária para especificar o texto na guia, e a Apple Store exige que um ícone também seja usado, para que a Icon propriedade seja definida para iOS:
O exemplo StudentNotes tem uma home page que lista todos os alunos. Quando um aluno é tocado, este navega para uma TabbedPage derivada, StudentNotesDataPage, que incorpora três ContentPage objetos em sua árvore visual, um dos quais permite inserir algumas notas para esse aluno.
Usando um ItemTemplate
O exemplo MultiTabbedColor usa a NamedColorXamarin.Formsclasse na biblioteca Book.Toolkit. O arquivo MultiTabbedColorsPage.xaml define a DataTemplate propriedade de TabbedPage para uma árvore visual que começa com ContentPage que contém ligações para propriedades de NamedColor (incluindo uma associação à Title propriedade).
No entanto, isso é problemático no iOS. Apenas alguns dos itens podem ser exibidos, e não há uma boa maneira de dar-lhes ícones.