Control de tarjeta en Power Apps

Proporciona la experiencia de visualización y edición para un único campo de un control Formulario para mostrar o Editar formulario .

Description

Mostrar los controles formulario y Editar formulario actúan como contenedores para mostrar y ver registros completos. Cada contenedor puede contener un conjunto de controles card que muestran campos individuales o proporcionan una manera de actualizar esos campos. Cada tarjeta tiene una propiedad DataField que especifica en qué campo del registro funciona.

Las tarjetas predefinidas se definen para diferentes tipos de datos y experiencias de usuario. Por ejemplo, puede haber una tarjeta para editar un campo de número con un control Entrada de texto , que es excelente para su uso con el teclado. Otra tarjeta podría admitir la edición de un número mediante un control Slider en su lugar. Con el control de formulario seleccionado, puede, en el panel derecho, seleccionar fácilmente una tarjeta basada en un campo.

Las tarjetas contienen controles. Los controles de una tarjeta componen la experiencia para mostrar y editar un único campo. Por ejemplo, una tarjeta de número puede constar de un control Etiqueta para proporcionar el nombre para mostrar del campo y un control Entrada de texto para proporcionar un editor para el valor del campo. La tarjeta también puede tener un control Label que muestre los errores de validación que se producen y un control Label para el asterisco común para indicar que se requiere un campo.

Puede personalizar los controles de una tarjeta predefinida cambiando su tamaño, moviéndolo, ocultándolo, agregando controles a ella y realizando otros cambios. También puede empezar con una tarjeta completamente en blanco, una "tarjeta personalizada", a la que agrega controles desde cero.

Las tarjetas predefinidas están bloqueadas de forma predeterminada. En una tarjeta bloqueada, solo puede modificar determinadas propiedades de la tarjeta o los controles de la tarjeta y no puede eliminar una tarjeta bloqueada. Puede mostrar el bloqueo de la tarjeta y desbloquearlo en la pestaña Ver de la vista Avanzadas . Si una propiedad está bloqueada y no se puede modificar, aparece con un icono de bloqueo junto a su nombre. Desbloquear una tarjeta es una actividad avanzada y debe realizarse con cuidado, ya que la generación automática de fórmulas ya no se producirá para la tarjeta y no se puede volver a interbloquear una tarjeta.

Dentro del contenedor del formulario, el registro ThisItem está disponible y contiene todos los campos del registro. Por ejemplo, la propiedad Default de la tarjeta se establece a menudo en ThisItem. FieldName.

Puede usar la referencia parent para configurar un control para hacer referencia a las propiedades de una tarjeta. Por ejemplo, un control debe usar Parent.Default para leer el estado inicial del campo desde el origen de datos. Mediante el uso de Parent en lugar de acceder directamente a la información que desee, la tarjeta se encapsula mejor y puede cambiarla a otro campo sin interrumpir fórmulas internas.

Consulte Descripción de las tarjetas de datos para obtener ejemplos de cómo personalizar, desbloquear y crear tarjetas.

Propiedades importantes

DataField : el nombre del campo dentro de un registro que muestra y edita esta tarjeta.

• Especifique el nombre como una sola cadena estática que se incluye entre comillas dobles (por ejemplo, "Nombre"), no como una fórmula.
• Desenlace una tarjeta estableciendo su propiedad DataFielden blanco. Las propiedades Valid y Update se omiten para las tarjetas sin enlazar.

Valor predeterminado : valor inicial de un control antes de que el usuario lo cambie.

• Para cada control de una tarjeta, establezca esta propiedad en Parent.Default para hacer referencia al valor predeterminado del campo según el origen de datos. Por ejemplo, establezca la propiedad Default de un control deslizante en Parent.Default para asegurarse de que el usuario comienza con un valor genérico para ese control deslizante.

DisplayMode : los valores pueden ser Editar, Ver o Deshabilitar. Configura si el control dentro de la tarjeta permite la entrada del usuario (Editar), solo muestra datos (Vista) o está deshabilitado (Deshabilitado).

• Permite usar una sola tarjeta en formularios de edición y vista, configurando esta propiedad, que está vinculada al comportamiento del formulario de forma predeterminada.
• En el modo Vista , los controles secundarios, como entrada de texto, Lista desplegable, Selector de fecha solo mostrarán el valor de texto y no representarán elementos interactivos ni decoraciones.

DisplayName : el nombre descriptivo de un campo de un origen de datos.

• La función DataSourceInfo proporciona estos metadatos del origen de datos.
• Los controles de la tarjeta deben usar Parent.DisplayName para hacer referencia al nombre del campo.

Error : mensaje de error descriptivo que se va a mostrar para este campo cuando se produce un error en la validación.

• Esta propiedad se establece cuando se llama a SubmitForm .
• El mensaje describe los problemas de validación en función de los metadatos del origen de datos y la comprobación de la propiedad Required de la tarjeta.

Obligatorio : si una tarjeta, editando el campo de un origen de datos, debe contener un valor.

• La función DataSourceInfo proporciona los metadatos necesarios del origen de datos.
• Los controles de la tarjeta deben usar Parent.Required para determinar si se requiere el campo de esa tarjeta.

Actualización : valor que se va a volver a escribir en el origen de datos de un campo.

• Use la fórmula de esta propiedad para extraer los valores de los controles de edición de la tarjeta para volver a escribir en el origen de datos. Por ejemplo, establezca la propiedad Update de una tarjeta en Slider.Value para actualizar el origen de datos con un valor del control deslizante de esa tarjeta.

Ancho : distancia entre los bordes izquierdo y derecho de un control.

WidthFit : indica si un control crece horizontalmente para rellenar cualquier espacio vacío en un control de contenedor, como un control Editar formulario . Si varias tarjetas tienen esta propiedad establecida en true, el espacio se divide entre ellas. Para obtener más información, consulte Descripción del diseño del formulario de datos.

Propiedades adicionales

BorderColor : color del borde de un control.

BorderStyle : indica si el borde de un control es Sólido, Discontinuo, Punteado o Ninguno.

BorderThickness : grosor del borde de un control.

Relleno : color de fondo de un control.

Alto : distancia entre los bordes superior e inferior de un control.

Válido : indica si un control de formulario de tarjeta o edición contiene entradas válidas, listas para enviarse al origen de datos.

Visible : indica si un control aparece o está oculto.

X: la distancia entre el borde izquierdo de un control y el borde izquierdo de su contenedor primario (la pantalla si no hay un contenedor primario). Para un control Tarjeta en un contenedor que tiene varias columnas, esta propiedad determina la columna en la que aparece la tarjeta.

Y: la distancia entre el borde superior de un control y el borde superior de su contenedor primario (la pantalla si no hay un contenedor primario). Para un control Tarjeta en un contenedor que tiene varias filas, esta propiedad determina la fila en la que aparece la tarjeta.

Examples

Consulte Descripción de las tarjetas de datos y Descripción del diseño del formulario de datos para obtener ejemplos.

Directrices de accesibilidad

Contraste de color

Debe haber un contraste de color adecuado entre:

• Rellenar y cualquier control secundario. Por ejemplo, si una tarjeta contiene una etiqueta y la etiqueta tiene relleno transparente, el relleno de la tarjeta se convierte eficazmente en el color de fondo de la etiqueta. Por lo tanto, debe haber un contraste adecuado entre el relleno de la tarjeta y el color de la etiqueta.

Compatibilidad con lector de pantalla

• DisplayName debe estar presente.