Control Targeta al Power Apps

Proporciona l'experiència de visualització i edició per a un sol camp d'un control Display form o Edit form.

Descripció

Els controls Display form i Edit form actuen com a contenidors per mostrar i visualitzar registres sencers. Cada contenidor pot contenir un conjunt de controls Card que mostren camps individuals o proporcionen una manera d'actualitzar aquests camps. Cada targeta té una propietat DataField que especifica el camp del registre sobre el qual treballa.

Les targetes predefinides es defineixen per a diferents tipus de dades i experiències d'usuari. Per exemple, pot haver-hi una targeta per editar un camp de número amb un control Text input, que és genial per a l'ús amb el teclat. Una altra targeta podria ser compatible amb l'edició d'un número mitjançant el control Slider en el seu lloc. Amb el control de formulari seleccionat, podeu seleccionar fàcilment una targeta segons un camp.

Les targetes contenen controls. Els controls d'una targeta configuren l'experiència per visualitzar i editar un únic camp. Per exemple, una targeta de número pot consistir en un control Label per proporcionar el nom de visualització del camp i un control Text input per proporcionar un editor per al valor del camp. La targeta també pot tenir un control Label que mostri tots els errors de validació que es produeixen i un control Label per a l'asterisc comú per indicar que un camp és obligatori.

Podeu personalitzar els controls d'una targeta predefinida redimensionant-la, movent-la, amagant-la, afegint-hi controls i fent-hi altres canvis. També podeu començar amb una targeta totalment en blanc, una "targeta personalitzada" a la qual afegiu controls des de zero.

Les targetes predefinides estan bloquejades per defecte. En una targeta blocada, només es poden modificar certes propietats de la targeta o els controls de la targeta i no es pot suprimir una targeta blocada. Podeu mostrar el bloqueig de la targeta i desbloquejar-la a la pestanya Visualització de la visualització Avançada. Si una propietat està bloquejada i no es pot modificar, apareix amb una icona de bloqueig al costat del seu nom. El desbloqueig d'una targeta és una activitat avançada i s'ha de fer amb compte, ja que la generació de fórmules automàtica ja no es produirà per a la targeta i no es pot tornar a blocar.

Dins del contenidor del formulari, el registre ThisItem està disponible i conté tots els camps del registre. Per exemple, la propietat Default de la targeta sovint es defineix a ThisItem.FieldName.

Podeu utilitzar la referència Parent per configurar un control per fer referència a les propietats d'una targeta. Per exemple, un control hauria d'utilitzar Parent.Default per llegir l'estat inicial del camp des de la font de dades. En utilitzar Parent, en comptes d'accedir directament a la informació que voleu, la targeta s'encapsula millor i podeu canviar-la a un altre camp sense trencar les fórmules internes.

Vegeu Comprendre les targetes de dades per veure exemples de com personalitzar, desbloquejar i crear targetes.

Propietats clau

DataField: nom del camp d'un registre que aquesta targeta mostra i edita.

  • Especifiqueu el nom com a cadena estàtica única entre cometes dobles (per exemple, "Nom"), no una fórmula.
  • Desenllaceu una targeta deixant la propietat DataField en blanc. Les propietats Valid i Update s'ignoraran per a les targetes desenllaçades.

Default: el valor inicial d'un control abans que l'usuari el canviï.

  • Per a cadascun dels controls d'una targeta, definiu aquesta propietat a Parent.Default per referir-vos al valor per defecte del camp d'acord amb la font de dades. Per exemple, definiu la propietat Default d'un control lliscant a Parent.Default per assegurar-vos que l'usuari comenci amb un valor genèric per a aquest control lliscant.

DisplayMode: els valors poden ser Edita, Visualitza o Inhabilitat. Configura si el control dins de la targeta permet l'entrada de l'usuari (Edita), només mostra les dades (Visualitza) o està inhabilitada (Inhabilitat).

  • Permet utilitzar una única targeta en formularis d'edició i visualització, configurant aquesta propietat, que està lligada al comportament del formulari per defecte.
  • Al mode Visualitza, els controls secundaris, com ara Text input, Drop down, Date Picker, només mostraran el valor de text i no representaran cap decoració ni element interactiu.

DisplayName: el nom descriptiu d'un camp en una font de dades.

  • La funció DataSourceInfo proporciona aquestes metadades des de la font de dades.
  • Els controls de la targeta han d'utilitzar Parent.DisplayName per referir-se al nom del camp.

Error: el missatge d'error descriptiu que es mostrarà per a aquest camp quan falli la validació.

  • Aquesta propietat es defineix quan es crida SubmitForm.
  • El missatge explica els problemes de validació segons les metadades de la font de dades i comprovant la propietat Required per a la targeta.

Required: si una targeta, en editar el camp d'una font de dades, ha de contenir un valor.

  • La funció DataSourceInfo proporciona les metadades obligatòries des de la font de dades.
  • Els controls de la targeta han d'utilitzar Parent.Required per determinar si el camp d'una targeta és obligatori.

Update: valor per tornar a escriure a la font de dades per a un camp.

  • Utilitzeu la fórmula de la propietat per recuperar els valors dels controls d'edició de la targeta per tornar a escriure a la font de dades. Per exemple, definiu la propietat Update d'una targeta a Slider.Value per actualitzar la font de dades amb un valor del control lliscant d'aquesta targeta.

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

WidthFit: si un control creix horitzontalment de forma automàtica per omplir qualsevol espai buit d'un control de contenidor, com ara un control Edit form. Si diverses targetes tenen aquesta propietat definida com a cert, l'espai es divideix entre elles. Per obtenir més informació, vegeu Informació sobre la disposició dels formularis de dades.

Propietats addicionals

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.

Fill: el color de fons d'un control.

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

Valid: si un control Card o Edit form conté entrades vàlides, a punt per enviar a la font de dades.

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

X: la distància entre la vora esquerra d'un control i la vora esquerra del seu contenidor principal (la pantalla si no hi ha cap contenidor principal). Per a un control Card d'un contenidor que té diverses columnes, aquesta propietat determina la columna en què es mostra la targeta.

Y: la distància entre la vora superior d'un control i la vora superior del seu contenidor principal (la pantalla si no hi ha cap contenidor principal). Per a un control Card d'un contenidor que té diverses files, aquesta propietat determina la fila en què es mostra la targeta.

Exemples

Vegeu Comprendre les targetes de dades i Comprendre el format de formulari de dades per veure exemples.

Pautes d'accessibilitat

Contrast de color

Hi ha d'haver un contrast de color adient entre:

  • Fill i controls secundaris. Per exemple, si una targeta conté un control Label i l'etiqueta té un emplenament transparent, l'Fill de la targeta es converteix eficaçment en el color de fons de l'etiqueta. D'aquesta manera, hi ha d'haver un contrast adequat entre l'Fill de la targeta i el Color de l'etiqueta.

Suport del lector de pantalla

  • DisplayName ha d'estar present.

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