Control de galería en Power Apps

Un control que contén outros controis e amosa un conxunto de datos.

Descripción

Un control de Galería pode mostrar varios rexistros dunha orixe de datos e cada rexistro pode conter varios tipos de datos. Por exemplo, use o control Galería para mostrar varios contactos con cada elemento mostrando información de contacto que inclúa un nome, un enderezo e un número de teléfono para cada contacto.

Cada campo de datos aparece nun control separado dentro do control Galería. E pode configurar eses controis no seu modelo. O modelo aparece como o primeiro elemento dentro da galería:

• No bordo esquerdo dun control de Galería en orientación horizontal/de paisaxe.
• E na parte superior do control de Galería en orientación vertical/retrato.

Os cambios que faga no modelo reflíctense ao longo do control de Galería.

Existen modelos predefinidos para amosar imaxes e texto nunha galería e unha galería para elementos de altura variable.

Limitacións

O control da galería ten estas limitacións:

1. Se un usuario despraza o control da galería de Altura flexible antes de cargar todos os elementos, o elemento que está actualmente visualizándose pode ser empuxado cara abaixo e sacado da vista cando remate a carga de datos. Para evitar este problema, use un control de Galería estándar en lugar da variante Altura flexible.
2. Os seguintes controis non son compatibles nunha galería:
   • Display form
   • Formulario de edición
   • Visualizador PDF
   • Power BI mosaicos
   • Rich text editor
   • Pantalla de desprazamento (grade fluida)
   • Escáner de códigos de barras web
3. Só pode engadir unha galería dentro doutra galería.
4. O mínimo TemplateSize é un. Isto pode provocar que os controis da Galería se desvíen do seu X ou Y esperado valores, cando non ten en conta o tamaño do modelo.
5. Se xera unha aplicación automaticamente a partir de datos, garda a aplicación e logo volve a abrila, é posible que a galería de exploración non mostre de inmediato ningún dato. Para resolver este problema, escriba polo menos un carácter na caixa de busca e, a continuación, elimine o texto que escribiu. A galería mostrará os datos como se esperaba.
6. Se unha galería inclúe un control ComboBox, DatePicker, Slider ou Toggle cunha regra OnChange que parchea o mesmo orixe de datos ou colección que a galería, pode provocar un rendemento inesperado ou reducido. Isto débese a que unha OnChange regra que modifica o orixe de datos da galería pode crear un ciclo interminable de parches e recargas. Para evitar este problema, é recomendable non usar regras OnChange cando estes controis se coloquen dentro dunha galería.

Propiedades da clave

Predeterminado - O elemento ou rexistro da orixe de datos a seleccionar na galería cando se inicia a aplicación.

Elementos – A orixe de datos que aparece nun control como unha galería, unha lista ou unha gráfica.

Seleccionado – O elemento seleccionado.

Propiedades adicionais

AccessibleLabel - Etiqueta da galería (non os elementos que contén) para os lectores de pantalla. Debería describir cal é a lista de elementos.

AllItems – Elementos que se cargan na galería. Isto pode ser inferior ao número real de Elementos de orixe de datos. É posible que se carguen máis elementos cando se desprace a galería. AllItems tamén contén controis que se usan en cada elemento da galería.

AllItemsCount : reconto de elementos que se cargan na galería. Isto pode ser inferior ao número real de Elementos de orixe de datos. É posible que se carguen máis elementos cando se desprace a galería.

BorderColor - A cor do bordo dun control.

BorderStyle - Se a fronteira dun control é Continua, A trazos, Punteada ou Ningunha.

BorderThickness - O grosor do bordo dun control.

DelayItemLoading - Atrase a carga de elementos (filas) ata despois da primeira carga da pantalla.

DisplayMode - Configura se o control permite a entrada do usuario (Editar), só mostra datos (Ver) ou está desactivado (Desactivado).

Enchemento: a cor de fondo dun control.

Altura - A distancia entre os bordos superior e inferior dun control.

ItemAccessibleLabel - Etiqueta de cada elemento da galería para os lectores de pantalla. Debería describir que é cada elemento.

LoadingSpinner (Ningún, Controis ou Datos) - Se se establece Ningún, o indicador de progreso non se amosará. Cando se establece Controis | Datos, o indicador de progreso mostraranse cando se produza un pase de renderización que dá como resultado filas baleiras visibles.

LoadingSpinnerColor - A cor de recheo do indicador de progreso de carga. Por defecto, está definido como CorDeBordo.

NavigationStep - Ata onde se despraza unha galería se a súa propiedade ShowNavigation está definida en verdadeira e o usuario selecciona unha frecha de navegación nos dous extremos da galería.

Seleccionable - Se se poden seleccionar elementos da galería. Cando está configurado en verdadeiro, os lectores de pantalla identifican a galería como unha lista seleccionable. E pode seleccionarse un elemento seleccionándoo. Cando está configurado en falso, os lectores da pantalla identifican a galería como unha lista regular e seleccionando un elemento non a selecciona.

ShowNavigation - Se unha frecha aparece en cada extremo dunha galería para que o usuario poida desprazarse polos elementos da galería seleccionando unha frecha.

ShowScrollbar - Se unha barra de desprazamento aparece cando o usuario pasa o punteiro do rato por unha galería.

TemplateFill - A cor de fondo dunha galería.

TemplatePadding - A distancia entre os elementos dunha galería.

TemplateSize - A altura do modelo para unha galería en orientación vertical/retrato. Ou o ancho do modelo para unha galería en orientación horizontal/paisaxe. O tamaño mínimo é un.

Transición - O efecto visual (Emerxente, Empurrón ou Ningún) cando o usuario pasa o punteiro sobre un elemento nunha galería.

Visible – Se aparece un control ou está oculto.

Ancho - A distancia entre os bordos esquerdo e dereito dun control.

WrapCount - Número de elementos mostrados por fila ou columna en función da disposición horizontal ou vertical.

X - A distancia entre o bordo esquerdo dun control e o bordo esquerdo do seu recipiente ou pantalla principal.

Y - A distancia entre o bordo superior dun control e o bordo superior do recipiente ou pantalla principal.

Funcións relacionadas

Filter( DataSource, Formula )

Restablecer( Control ) - Restablece o estado inicial da galería. O estado inicial inclúe o desprazamento ao primeiro elemento e a selección do primeiro elemento ou o predeterminado se está presente.

Nota

O control de Restablecemento non restablece de xeito recursivo todos os elementos secundarios da galería.

Exemplos

Mostrar e filtrar datos

• Amosar texto
• Mostrar imaxes
• Filtrar datos seleccionando unha opción de lista
• Filtrar os datos axustando un cursor da barra de desprazamento

Obter datos do usuario

• Obter texto
• Obter imaxes
• Obter fotos
• Obter sons
• Obter debuxos

Directrices de accesibilidade

Contraste de cor

Se fai clic en calquera parte dun elemento da galería para seleccionalo, debe haber un contraste de cor adecuado entre:

• BorderColor e a cor fóra da galería (se hai un bordo).
• Fill e a cor fóra da galería (se non hai un bordo).

Soporte do lector de pantalla

• AccessibleLabel debe estar presente.

  Nota

  Os lectores da pantalla anunciarán cando os elementos da galería cambian. A AccesibleLabel tamén se menciona Isto dá contexto ao anuncio e é aínda máis importante cando hai varias galerías na mesma pantalla.

• Cando un elemento da galería contén varios controis, use ItemAccessibleLabel para mostrar os contidos dos artigos da galería.

• Estableza o valor de Seleccionable en verdadeiro se desexa que os usuarios seleccionen un elemento da galería. Do contrario, estableza ese valor en falso.

• Cando un elemento da galería contén varios controis, use ItemAccessibleLabel para fornecer un resumo do contido do elemento da galería.

• Seleccionable debería axustarse adecuadamente, dependendo de se os usuarios deben seleccionar un elemento da galería.

Compatibilidade do teclado

• Considere establecer ShowScrollbar en verdadeiro. Na maioría dos dispositivos de pantalla táctil, a barra de desprazamento non se mostrará ata que comece o desprazamento.

• Se ao facer clic en calquera parte dun elemento da galería debería seleccionarse, tamén debe haber un xeito para que os usuarios do teclado seleccionen o elemento da galería. Por exemplo, engadir un Button que teña a súa propiedade OnSelect establecida en Select(Parent).

  Nota

  Os controis fóra da galería non se consideran na orde de navegación do teclado dentro da galería. Os controis de TabIndex dentro dunha galería están dentro do ámbito. Consulte as propiedades de accesibilidade para obter máis información.

Consulte tamén

Utilizar DelayItemLoading e Loading spinner para mellorar o rendemento na Galería

Nota

Pode indicarnos as súas preferencias para o idioma da documentación? Realice unha enquisa breve. (teña en conta que esa enquisa está en inglés)

Esta enquisa durará sete minutos aproximadamente. Non se recompilarán datos persoais (declaración de privacidade).