Control Etiqueta en Power Apps

Cuadro que muestra los datos como texto, números, fechas o moneda.

Descripción

En una etiqueta se muestran datos que se especifican como una cadena literal de texto, que aparece exactamente igual que se escribe o como una fórmula que se analiza como cadena de texto. Las etiquetas suelen aparecer fuera de cualquier otro control (por ejemplo, como encabezado que identifica una pantalla), como una etiqueta que identifica otro control (por ejemplo, un control Calificación o Audio) o en una galería para mostrar un tipo específico de información sobre un elemento.

Propiedades clave

AutoHeight: establezca esta propiedad en true para permitir que la etiqueta se agrande automáticamente para mostrar todo el texto. Establézcalo en false para truncar el texto con el alto asignado.

Color: el color del texto en un control.

Font: el nombre de la familia de fuentes en la que aparece el texto.

Text: texto que aparece en un control o que el usuario escribe en un control.

DelayOutput: establézcalo en true para retrasar la acción durante la entrada de texto.

Propiedades adicionales

Align: ubicación del texto respecto al centro horizontal de su control.

AutoHeight: indica si una etiqueta aumenta automáticamente su propiedad Height si su propiedad Text contiene más caracteres de los que el control permite mostrar a la vez.

BorderColor: el color del borde de un control.

BorderStyle: si el borde del control es Solid, Dashed, Dotted o None.

BorderThickness: el grosor del borde de un control.

DisplayMode: indica si el control permite entradas de usuario (Editar), solo muestra datos (Ver) o si está deshabilitado (Deshabilitado).

DisabledBorderColor: el color del borde de un control si la propiedad DisplayMode del control está establecida en Deshabilitado.

DisabledColor: el color del texto en un control si su propiedad DisplayMode está establecida en Deshabilitado.

DisabledFill: el color de fondo de un control si su propiedad DisplayMode está establecida en Deshabilitado.

Fill: el color de fondo de un control.

FocusedBorderColor: el color del borde de un control cuando el control recibe el foco.

FocusedBorderThickness: el grosor del borde de un control cuando el control recibe el foco.

FontWeight: el peso del texto en un control: Bold, Semibold, Normal o Lighter.

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

HoverBorderColor: el color del borde de un control cuando el usuario mantiene el puntero del ratón sobre ese control.

HoverColor: el color del texto de un control cuando el usuario mantiene el puntero del ratón sobre él.

HoverFill: el color de fondo de un control cuando el usuario mantiene el puntero del ratón sobre él.

Italic: indica si el texto de un control está en cursiva.

LineHeight: distancia entre, por ejemplo, líneas de texto o elementos de una lista.

Live - Cómo una lector de pantalla anuncia cambios en el valor de la propiedad Text de la etiqueta.

  • Cuando se configura como Off, el lector de pantalla no anuncia cambios.
  • Cuando se configura como Polite, el lector de pantalla termina de hablar antes de anunciar los cambios que ocurrieron mientras él hablaba.
  • Cuando se configura como Assertive, el lector de pantalla se interrumpe para anunciar los cambios que ocurrieron mientras él hablaba.

OnSelect: acciones para llevar a cabo cuando el usuario toca o hace clic en un control.

Overflow: indica si aparece una barra de desplazamiento en una etiqueta si su propiedad Wrap está establecida en true y el valor de la propiedad Text del control contiene más caracteres de los que el control permite mostrar a la vez.

PaddingBottom: distancia entre el texto de un control y el borde inferior de ese control.

PaddingLeft: distancia entre el texto de un control y el borde izquierdo de ese control.

PaddingRight: distancia entre el texto de un control y el borde derecho de ese control.

PaddingTop: distancia entre el texto de un control y el borde superior de ese control.

PressedBorderColor: el color de un borde del control cuando el usuario toca o hace clic en ese control.

PressedColor: el color de texto de un control cuando el usuario toca o hace clic en ese control.

PressedFill: el color de fondo de un control cuando el usuario toca o hace clic en ese control.

Role - El rol semántico del texto de la etiqueta, como Título 1. No cambia el estilo de la etiqueta, pero hace que la salida sea semánticamente correcta para que los lectores de pantalla la interpreten.

Size: tamaño de la fuente del texto que aparece en un control.

Strikethrough: indica si aparece una línea sobre el texto de un control.

TabIndex: orden de navegación del teclado en relación con otros controles.

Tooltip: texto explicativo que aparece cuando el usuario mantiene el mouse sobre un control.

Underline: indica si aparece una línea debajo del texto de un control.

VerticalAlign: ubicación del texto en un control respecto al centro vertical de ese control.

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

Width: la distancia entre los bordes derecho e izquierdo de un control.

Wrap: si el texto debe ajustarse a varias líneas.

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

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

Text( Number, "FormatCodes" )

Ejemplos

Mostrar una cadena literal

Mostrar el resultado de una fórmula

  • Agregue una etiqueta y establezca su propiedad Text en una fórmula como esta:
    Today()

    Nota

    Al especificar una fórmula, no use comillas, a menos que un argumento de la misma sea una cadena literal. En ese caso, incluya el argumento, no la fórmula, entre comillas inglesas.

    ¿Desea más información sobre la función Today u otras funciones?

En este procedimiento, creará una colección, denominada CityPopulations, que contiene datos sobre la población de varias ciudades de Europa. A continuación, mostrará esos datos en una galería que contiene tres etiquetas y especificará el tipo de datos que mostrará cada etiqueta.

  1. Agregue un botón y establezca su propiedad OnSelect en esta fórmula:
    ClearCollect(CityPopulations, {City:"London", Country:"United Kingdom", Population:8615000}, {City:"Berlin", Country:"Germany", Population:3562000}, {City:"Madrid", Country:"Spain", Population:3165000}, {City:"Rome", Country:"Italy", Population:2874000}, {City:"Paris", Country:"France", Population:2273000}, {City:"Hamburg", Country:"Germany", Population:1760000}, {City:"Barcelona", Country:"Spain", Population:1602000}, {City:"Munich", Country:"Germany", Population:1494000}, {City:"Milan", Country:"Italy", Population:1344000})

  2. Presione F5, seleccione el botón y presione Esc.

  3. Agregue una galería de texto y establezca su propiedad Items en CityPopulations.

    Con la galería seleccionada, el panel derecho muestra opciones para esa galería.

  4. En el panel Gallery1, establezca la lista superior en Population, la del medio en City y la inferior en Country.

Instrucciones para accesibilidad

A pesar de su nombre, un control Etiqueta no tiene que usarse como etiqueta con otro control. Se puede utilizar para mostrar cualquier fragmento de texto.

Un control Etiqueta se puede usar como botón o vínculo mediante la especificación del comportamiento OnSelect. Cuando se utiliza de este modo, hay algunas consideraciones sobre accesibilidad parecidas a las que se tienen con los botones.

Contraste de color

Debe haber un contraste de color adecuado entre:

Compatibilidad con el lector de pantalla

  • La propiedad Text debe existir.

  • Live debe establecerse en Polite o Assertive si un lector de pantallas debe anunciar cambios en el valor de la propiedad Text.

    Nota

    Los lectores de pantalla tratan los controles Etiqueta como botones cuando TabIndex es cero o superior.

Apoyo para deficiencia visual

  • El control Etiqueta debe parecerse a un vínculo, si se utiliza como vínculo.

Compatibilidad con el teclado

  • TabIndex debe ser cero o mayor si el texto se utiliza como botón o vínculo. De esta forma, los usuarios de teclado pueden navegar hasta él.
  • Los indicadores de enfoque deben ser claramente visibles si el texto se usa como botón o vínculo. Use FocusedBorderColor y FocusedBorderThickness para conseguirlo.

Nota

¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)

La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).