Compartilhar via

Controle Galeria no Power Apps

  • Artigo

Um controle que contém outros controles e mostra um conjunto de dados.

Descrição

Um controle Galeria pode mostrar vários registros de uma fonte de dados, e cada registro pode conter vários tipos de dados. Por exemplo, um controle de Galeria pode mostrar vários contatos, com cada item mostrando informações de contato que incluem um nome, um endereço e um número de telefone de cada contato.

Cada campo de dados aparece em um controle separado dentro do controle Galeria. E você pode configurar esses controles em seu modelo. O modelo aparece como o primeiro item dentro da galeria:

  • Na borda esquerda de um controle Galeria na orientação horizontal/paisagem.
  • E no topo de um controle Galeria na orientação vertical/retrato.

Quaisquer alterações feitas no modelo são refletidas em todo o controle Galeria.

Modelos predefinidos para mostrar imagens e texto em uma galeria e uma galeria com itens de altura variável estão disponíveis.

Limitações

O controle de galeria tem estas limitações:

  1. Se um usuário rolar o controle de galeria de Altura flexível, antes que todos os itens sejam carregados, o item que está sendo exibido no momento pode ser empurrado para baixo e para fora da vista quando o carregamento dos dados for concluído. Para evitar esse problema, use um controle Galeria padrão, em vez da variante Flexible height.
  2. Não há suporte para os seguintes controles em uma galeria:
  3. Você só pode adicionar uma galeria dentro de outra galeria.
  4. O mínimo para TemplateSize é um. Isso pode fazer com que os controles na Galeria se desviem de seus valores esperados X ou Y ao não considerar o tamanho do modelo.
  5. Se você gerar um aplicativo de forma automática a partir de dados, salvá-lo e depois reabri-lo, a galeria de navegação talvez não mostre nenhum dado imediatamente. Para resolver esse problema, digite pelo menos um caractere na caixa de pesquisa e, depois, exclua o texto digitado. Em seguida, a galeria vai acabar mostrando os dados conforme esperado.
  6. Se uma galeria incluir um controle ComboBox, DatePicker, Slider ou Toggle com uma OnChange regra que corrige o mesmo fonte de dados ou coleção da galeria, isso pode levar a um desempenho inesperado ou reduzido. Isso ocorre porque uma regra que corrige o fonte de dados da galeria pode criar um ciclo interminável de patches e recarregamentos. OnChange Para evitar esse problema, é aconselhável não usar OnChange regras quando esses controles forem colocados em uma galeria.

Principais propriedades

Default – o item ou o registro da fonte de dados a ser selecionado na galeria quando o aplicativo é iniciado.

Items – a fonte de dados exibida em um controle como uma galeria, uma lista ou um gráfico.

Selected – o item selecionado.

Propriedades adicionais

AccessibleLabel - Rótulo da galeria (não os itens que ela contém) para os leitores de tela. Deve descrever o que são as listas de itens.

AllItems – Itens que são carregados na galeria. Pode ser menor que o número real de Itens da fonte de dados. Mais itens podem ser carregados quando rola-se a galeria. AllItems também contém controles que são usados em cada item da galeria.

AllItemsCount – Contagem de itens que são carregados na galeria. Pode ser menor que o número real de Itens da fonte de dados. Mais itens podem ser carregados quando rola-se a galeria.

BorderColor – a cor da borda do controle.

BorderStyle – se a borda do controle é Sólida, Tracejada, Pontilhada ou Nenhuma.

BorderThickness – a espessura da borda do controle.

DelayItemLoading - atrasa o carregamento dos itens (linhas) até depois que a tela for carregada pela primeira vez.

DisplayMode – se o controle permite a entrada do usuário (Editar), apenas exibe dados (Exibir) ou está desabilitado (Desabilitado).

Fill – a cor da tela de fundo de um controle.

Height – a distância entre a parte superior do controle e as bordas inferiores.

ItemAccessibleLabel – rótulo de cada item da galeria para leitores de tela. Deve descrever o que é cada item.

LoadingSpinner ( Nenhum, Controles ou Dados) - Quando definido como Nenhum, o botão giratório não será exibido. Quando for Controles | Dados, o botão giratório será mostrado quando ocorrer uma renderização que resulte em linhas vazias visíveis.

LoadingSpinnerColor - A cor de preenchimento do botão giratório de carregamento. Por padrão, é definido como BorderColor.

NavigationStep – o quão longe uma galeria é rolada se a propriedadeShowNavigation estiver definida como true e o usuário selecionar uma seta de navegação no final dessa galeria.

Selectable - se os itens da galeria podem ser selecionados. Quando definido como true, os leitores de tela identificam a galeria como uma lista selecionável. E você escolhe um item, selecionando-o. Quando definido como false, os leitores de tela identificam a galeria como uma lista regular e a seleção de um item não a seleciona.

ShowNavigation – se uma seta é exibida em cada extremidade de uma galeria para que um usuário possa percorrer os itens na galeria selecionando uma seta.

ShowScrollbar – se uma barra de rolagem é exibida quando o usuário passa o mouse sobre uma galeria.

TemplateFill – a cor da tela de fundo de uma galeria.

TemplatePadding – a distância entre os itens em uma galeria.

TemplateSize - A altura do modelo para uma galeria na orientação vertical/retrato. Ou a largura do modelo para uma galeria na orientação horizontal/paisagem. O tamanho mínimo é um.

Transition – o efeito visual (Pop, Push ou None) quando o usuário passa o mouse sobre um item em uma galeria.

Visible – se um controle é exibido ou está oculto.

Width – a distância entre as bordas esquerda e direita de um controle.

WrapCount – número de itens exibidos por linha ou coluna com base no layout horizontal ou vertical.

X – a distância entre a borda esquerda de um controle e a borda esquerda da respectiva tela ou contêiner pai.

Y – a distância entre a borda superior de um controle e a borda superior da tela ou contêiner pai.

Filter( DataSource, Formula )

Reset( Control ) - Redefine sua galeria de volta ao seu estado inicial. O estado inicial inclui a rolagem para o primeiro item e a seleção do primeiro item ou padrão, se presente.

Observação

O controle Reset não redefine recursivamente todos os filhos da galeria.

Exemplos

Exibir e filtrar dados

Obter dados do usuário

Diretrizes de acessibilidade

Contraste de cores

Se clicar em qualquer lugar de um item da galeria significa selecioná-lo, é preciso haver contraste de cores adequado entre:

  • BorderColor e a cor fora da galeria (se houver borda).
  • Fill e a cor fora da galeria (se não houver borda).

Suporte ao leitor de tela

  • AccessibleLabel precisa estar presente.

    Observação

    Leitores de tela anunciarão quando os itens na galeria forem alterados. O AccessibleLabel também é mencionado. Isso fornece contexto para o anúncio e é ainda mais importante quando há várias galerias na mesma tela.

  • Quando um item da galeria contém vários controles, use ItemAccessibleLabel para mostrar o conteúdo dos itens da galeria.

  • Defina o valor de Selectable como true, se você deseja que os usuários selecionem um item da galeria. Caso contrário, defina esse valor como false.

  • Quando um item da galeria contém vários controles, use ItemAccessibleLabel para fornecer um resumo do conteúdo de item da galeria.

  • Selectable deve ser definido adequadamente, dependendo se os usuários devem selecionar um item da galeria.

Suporte de teclado

  • Defina ShowScrollbar como true. Na maioria dos dispositivos de tela touch, a barra de rolagem não aparecerá até a rolagem começar.

  • Se clicar em qualquer lugar em um item da galeria significa selecioná-lo, será preciso haver também uma maneira para os usuários de teclado selecionarem o item da galeria. Por exemplo, ao adicionar um Botão que tem sua propriedade OnSelect definida como Select(Parent).

    Observação

    Controles externos à galeria não são considerados na ordem de navegação de teclado interna da galeria. O controles TabIndex dentro de uma galeria estão no escopo. Consulte as propriedades de acessibilidade para saber mais.

Confira também

Usar o controle giratório DelayItemLoading e Loading para melhorar o desempenho na Galeria

Observação

Você pode nos falar mais sobre suas preferências de idioma para documentação? Faça uma pesquisa rápida. (Observe que esta pesquisa está em inglês)

A pesquisa levará cerca de sete minutos. Nenhum dado pessoal é coletado (política de privacidade).