Controle da galeria no Power Apps

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

Description

Um controle da Galeria pode mostrar vários registros de uma fonte de dados e cada registro pode conter vários tipos de dados. Por exemplo, use um controle da Galeria para 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 para 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 da Galeria na orientação horizontal/paisagem.
• E na parte superior de um controle da Galeria na orientação vertical/retrato.

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

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

Limitações

O controle da galeria tem estas limitações:

1. Se um usuário rolar o controle de galeria de altura flexível antes de todos os itens serem carregados, o item que está atualmente em exibição poderá ser enviado por push para baixo e para fora da exibição quando o carregamento de dados for concluído. Para evitar esse problema, use um controle padrão da Galeria em vez da variante de altura flexível .
2. Não há suporte para os seguintes controles em uma galeria:
   • Formulário de exibição
   • Editar formulário
   • Visualizador de PDF
   • Bloco do Power BI
   • Editor de rich text
   • Tela rolável (grade fluida)
   • Verificador de código de barras da Web
3. Você não poderá adicionar uma galeria dentro de outra galeria se ela já estiver dentro de outra galeria. O nível máximo de aninhamento é 2.
4. O TemplateSize mínimo é um. Isso pode fazer com que os controles na Galeria descompassem de seus valores X ou Y esperados, quando você não contabiliza o tamanho do modelo.
5. Se você gerar um aplicativo automaticamente a partir de dados, salvar o aplicativo e reabri-lo, a galeria de navegação poderá não mostrar imediatamente nenhum dado. Para resolver esse problema, digite pelo menos um caractere na caixa de pesquisa e exclua o texto digitado. Em seguida, a galeria mostrará os dados conforme o esperado.
6. Se uma galeria incluir um controle ComboBox, DatePicker, Slider ou Toggle com uma OnChange regra que remenda a mesma fonte de dados ou coleção que a galeria, isso pode levar a um desempenho inesperado ou reduzido. Isso ocorre porque uma OnChange regra que corrige a fonte de dados da galeria pode criar um ciclo interminável de patch e recarregamento. Para evitar esse problema, é aconselhável não usar OnChange regras quando esses controles são colocados em uma galeria.

Principais propriedades

Padrão – o item ou registro da fonte de dados a ser selecionado na galeria quando o aplicativo for iniciado.

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

Selecionado – O item selecionado.

Propriedades adicionais

AccessibleLabel – Rótulo da galeria (não os itens que ela contém) para leitores de tela. Deve descrever qual é a lista de itens.

AllItems – Itens carregados na galeria. Isso pode ser menor do que o número real de itens da fonte de dados. Mais itens podem ser carregados quando a galeria é rolada. 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. Isso pode ser menor do que o número real de itens da fonte de dados. Mais itens podem ser carregados quando a galeria é rolada.

BorderColor – A cor da borda de um controle.

BorderStyle – se a borda de um controle é Solid, Dashed, Dotted ou None.

BorderThickness – A espessura da borda de um controle.

DelayItemLoading – Atrasar o carregamento de itens (linhas) até que a tela seja carregada pela primeira vez.

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

Preenchimento – A cor da tela de fundo de um controle.

Altura – a distância entre as bordas superior e inferior de um controle.

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 controles | Dados, o spinner será mostrado quando ocorrer uma passagem de renderização que resulta em linhas vazias visíveis.

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

NavigationStep – Até que ponto uma galeria rola se sua propriedade ShowNavigation está definida como true e o usuário seleciona uma seta de navegação em ambas as extremidades da galeria.

Selecionável – 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ê seleciona um item selecionando-o. Quando definido como false, os leitores de tela identificam a galeria como uma lista regular e selecionar um item não a seleciona.

ShowNavigation – Se uma seta aparece em cada extremidade de uma galeria para que um usuário possa rolar pelos itens na galeria selecionando uma seta.

ShowScrollbar – Se uma barra de rolagem aparece 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.

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

Visível – se um controle aparece ou está oculto.

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

WrapCount – Número de itens mostrados 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 de seu contêiner ou tela pai.

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

Funções relacionadas

Filter( DataSource, Formula )

Redefinir( Controle ) – redefine sua galeria de volta ao estado inicial. O estado inicial inclui rolar até o primeiro item e selecionar o primeiro item ou padrão, se presente.

Exemplos

Mostrar e filtrar dados

• Mostrar texto
• Mostrar imagens
• Filtrar dados selecionando uma opção de lista
• Filtrar dados ajustando um controle deslizante

Obter dados do usuário

• Obter texto
• Obter imagens
• Obter fotos
• Obter sons
• Obter desenhos

Diretrizes de acessibilidade

Contraste de cores

Se clicar em qualquer lugar em um item da galeria for destinado a selecioná-lo, deverá haver um contraste de cores adequado entre:

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

Suporte ao leitor de tela

• AccessibleLabel deve estar presente.

  Observação

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

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

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

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

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

Suporte ao teclado

• Considere definir ShowScrollbar como true. Na maioria dos dispositivos de tela sensível ao toque, a barra de rolagem não será exibida até que a rolagem comece.

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

  Observação

  Os controles fora da galeria não são considerados na ordem de navegação do teclado dentro da galeria. Os controles TabIndex dentro de uma galeria têm escopo. Confira as propriedades de acessibilidade para saber mais.

Consulte também

Use DelayItemLoading e Loading Spinner para melhorar o desempenho na Galeria