Control de galeria al Power Apps

  • Article

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

  • 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.
  • Els controls següents no estan admesos en una galeria:
  • Només es pot afegir una galeria dins d'una altra galeria.
  • El mínim TemplateSize és un. Això pot fer que els controls de la Galeria vagin a la deriva dels valors X o Y esperats , quan no teniu en compte la mida de la plantilla.

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. Això pot ser inferior al nombre real d'Elements del font de dades. És possible que es carreguin 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. Això pot ser inferior al nombre real d'Elements del font de dades. És possible que es carreguin 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 talla 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.

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

Obtenir dades de l'usuari

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).