Control de galeria al Power Apps

Control que conté altres controls i que mostra un conjunt de dades.

Descripció

El control de Gallery pot mostrar diversos registres des d’una font de dades i cada registre pot contenir diversos tipus de dades. Per exemple, utilitzeu un control Gallery per mostrar diversos contactes amb cada element que mostri informació de contacte que inclogui un nom, una adreça i un número de telèfon per a cada contacte.

Cada camp de dades es mostra en un control separat dins del control Gallery. I podeu configurar aquests controls a la seva plantilla. La plantilla apareix com a primer element dins de la galeria:

• A la vora esquerra d'un control Gallery en orientació horitzontal.
• I a la part superior d'un control Gallery en orientació vertical.

Tots els canvis que feu a la plantilla es reflecteixen a tot el control Gallery.

Hi ha disponibles plantilles predefinides per mostrar imatges i text en una galeria i una galeria per a elements d'alçada variable.

Limitacions

El control de galeria té aquestes limitacions:

1. Si un usuari desplaça el control de la galeria Alçada flexible abans que es carreguin tots els elements, l'element que està a la vista actualment es pot moure cap avall i no es mostra quan s'acaba la càrrega de dades. Per evitar aquest problema, utilitzeu un control estàndard Gallery en comptes de la variant Alçada flexible.
2. Els controls següents no estan admesos en una galeria:
   • Display form
   • Formulari d'edició
   • Visualitzador PDF
   • Peça del Power BI
   • Rich text editor
   • Pantalla desplaçable (quadrícula fluïda)
   • Lector de codis de barres web
3. Només es pot afegir una galeria dins d'una altra galeria.
4. El TemplateSize mínim és un. Això pot fer que els controls de la galeria es desviïn dels valors X o Y esperats, quan no es té en compte la mida de la plantilla.
5. Si genereu una aplicació automàticament des de les dades, deseu l'aplicació i, a continuació, torneu a obrir-la; la galeria de navegació podria no mostrar immediatament les dades. Per solucionar aquest problema, escriviu com a mínim un caràcter al quadre de cerca i, a continuació, suprimiu el text que heu escrit. La galeria mostrarà les dades tal com s'esperava.
6. Si una galeria inclou un control ComboBox, DatePicker, Slider o Toggle amb una OnChange regla que aplica pedaços a la mateixa font de dades o col·lecció que la galeria, pot provocar un rendiment inesperat o reduït. Això es deu al fet que una OnChange regla que pega la font de dades de la galeria pot crear un cicle interminable de pedaços i recàrrega. Per evitar aquest problema, és recomanable no utilitzar OnChange regles quan aquests controls es col·loquen dins d'una galeria.

Propietats de la clau

Default: l'element o el registre de la font de dades que cal seleccionar a la galeria quan s'inicia l'aplicació.

Items: la font de dades que es mostra en un control, com ara una galeria, una llista o un gràfic.

Selected: l'element seleccionat.

Propietats addicionals

AccessibleLabel: etiqueta de la galeria (no els elements que conté) per als lectors de pantalla. Ha d'explicar quina és la llista d'elements.

AllItems : elements que es carreguen a la galeria. Pot ser menor que el nombre real d'elements de la font de dades. Es poden carregar més elements quan es desplaça la galeria. AllItems també conté controls que s'utilitzen a cada element de la galeria.

AllItemsCount : recompte d'elements que es carreguen a la galeria. Pot ser menor que el nombre real d'elements de la font de dades. Es poden carregar més elements quan es desplaça la galeria.

BorderColor: el color de la vora d'un control.

BorderStyle: si la vora d'un control és Sòlid, Amb guions, Amb punts o Cap.

BorderThickness: el gruix de la vora d'un control.

DelayItemLoading: retarda la càrrega dels elements (files) fins després de carregar la primera pantalla.

DisplayMode: si el control permet l'entrada de l'usuari (Edita), només mostra les dades (Visualitza) o està inhabilitada (Inhabilitat).

Fill: el color de fons d'un control.

Height: la distància entre les vores superior i inferior d'un control.

ItemAccessibleLabel: etiqueta de cada element de la galeria per a lectors de pantalla. Cal que descrigui què és cada element.

LoadingSpinner (Cap, Controls o Dades): quan sigui Cap, no es mostrarà un indicador circular. Quan sigui Controls | Dades, l'indicador circular es mostrarà quan es produeix un pas de representació que resulti en files buides visibles.

LoadingSpinnerColor: el color d'emplenament de l'indicador circular de càrrega. Per defecte està definit a BorderColor.

NavigationStep: com de lluny es desplaça una galeria si la seva propietat ShowNavigation es defineix com a cert i l'usuari selecciona una fletxa de navegació a qualsevol extrem de la galeria.

Seleccionable: si es poden seleccionar elements de la galeria. Quan es defineix com a cert, els lectors de pantalla identifiquen la galeria com a llista de selecció. I seleccioneu un element seleccionant-lo. Si es defineix com a fals, els lectors de pantalla identifiquen la galeria com a llista normal i seleccionar un element no el selecciona.

ShowNavigation: si apareix una fletxa a cada extrem d'una galeria per tal que un usuari pugui desplaçar-se pels elements de la galeria seleccionant una fletxa.

ShowScrollbar: si una barra de desplaçament apareix quan l'usuari passa el punter per sobre d'una galeria.

TemplateFill: el color de fons d'una galeria.

TemplatePadding: la distància entre els elements d'una galeria.

TemplateSize: l'alçada de la plantilla per a una galeria en orientació vertical. O l'amplada de la plantilla per a una galeria a l'orientació horitzontal. La mida mínima és una.

Transition: l'efecte visual (Emergent, Inserció o Cap) quan l'usuari passa el punter sobre un element d'una galeria.

Visible: si es mostra o s'amaga un control.

Width: la distància entre les vores esquerra i dreta d'un control.

WrapCount nombre d'elements mostrats per fila o columna segons la disposició horitzontal o vertical.

X: la distància entre la vora esquerra d'un control i la vora esquerra del seu contenidor principal o la pantalla.

Y: la distància entre la vora superior d'un control i la vora superior del seu contenidor principal o la pantalla.

Funcions relacionades

Filter( DataSource, Fórmula )

Reset( Control ): reinicialitza la galeria a l'estat inicial. L'estat inicial inclou el desplaçament al primer element i la selecció del primer element o per defecte si està present.

Nota

El control Reset no restableix recursivament tots els elements secundaris de la galeria.

Exemples

Mostrar i filtrar dades

• Mostrar text
• Mostrar imatges
• Filtrar dades seleccionant una opció de llista
• Filtrar dades ajustant un control lliscant

Obtenir dades de l'usuari

• Obtenir text
• Obtenir imatges
• Obtenir fotos
• Obtenir sons
• Obtenir dibuixos

Pautes d'accessibilitat

Contrast de color

Si fer clic a qualsevol part d'un element de la galeria està pensat per seleccionar-lo, ha d'haver-hi un contrast de color adient entre:

• BorderColor i el color de fora de la galeria (si hi ha una vora).
• Fill i el color de fora de la galeria (si no hi ha una vora).

Suport del lector de pantalla

• AccessibleLabel ha d'estar present.

  Nota

  Els lectors de pantalla anunciaran quan els elements de la galeria canviïn. També s'esmenta AccessibleLabel. Això dona context a l'anunci i és encara més important quan hi ha diverses galeries a la mateixa pantalla.

• Quan un element de la galeria conté diversos controls, utilitzeu ItemAccessibleLabel per mostrar el contingut dels elements de la galeria.

• Definiu el valor de Selectable a cert si voleu que els usuaris seleccionin un element de la galeria. Altrament, definiu aquest valor com a fals.

• Quan un element de la galeria conté diversos controls, utilitzeu ItemAccessibleLabel per proporcionar un resum del contingut de l'element de la galeria.

• Selectable s'ha de definir correctament, en funció de si els usuaris han de seleccionar un element de la galeria.

Compatibilitat amb el teclat

• Considereu la possibilitat d'establir ShowScrollbar a cert. A la majoria de dispositius amb pantalla tàctil, la barra de desplaçament no es mostrarà fins que comenci el desplaçament.

• Si fer clic a qualsevol part d'un element de la galeria està pensat per seleccionar-lo, també hi ha d'haver manera que els usuaris del teclat seleccionin l'element de la galeria. Per exemple, si afegiu un control Button que tingui la seva propietat OnSelect definida a Select(Principal).

  Nota

  Els controls fora de la galeria no es consideren a l'ordre de navegació del teclat dins de la galeria. Els controls TabIndex dins d'una galeria tenen un àmbit. Consulteu més informació sobre les propietats d'accessibilitat.

Consulteu també

Ús de l'indicador giratori DelayItemLoading i Loading per millorar el rendiment a la Galeria

Nota

Ens podeu dir quines són les vostres preferències d'idioma per a la documentació? Responeu una breu enquesta. (tingueu en compte que l'idioma de l'enquesta és l'anglès)

Trigareu uns set minuts a completar l'enquesta. No es recopilen dades personals (declaració de privadesa).