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:
MasterDetailPage
gerencia duas páginas, um mestre e um detalheTabbedPage
Gerencia 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 ContentPage
arquivo . 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
false
para desativar o gestoIsGestureEnabled
de percorrer - Substitua o
ShouldShowToolbarButton
método e retornefalse
para 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:
Children
propriedade 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:
ItemsSource
do tipoIEnumerable
ItemTemplate
do 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:
CurrentPage
do tipoT
, referindo-se à páginaSelectedItem
do tipoObject
, referindo-se ao objeto naItemsSource
coleção
MultiPage<T>
também define dois eventos:
PagesChanged
quando aItemsSource
coleção mudaCurrentPageChanged
quando 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 TabbedPage
DiscreteTabbedColorsPage.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 NamedColor
Xamarin.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.