El widget de campo de texto es un elemento de entrada que se utiliza normalmente en formularios. Se puede utilizar un campo de texto para permitir a los usuarios escribir texto en un mashup. Se puede definir o recuperar el texto del campo mediante la propiedad Text. A diferencia del widget de área de texto, el campo de texto se limita a una sola línea. Además de las propiedades comunes del widget, este se puede configurar mediante propiedades, de las siguientes maneras:

Se pueden utilizar los siguientes eventos de widget para ejecutar servicios o funciones de datos cuando se actualiza el valor del widget en tiempo de ejecución:

El widget de campo de texto activa dos eventos enlazables:

Se pueden utilizar los eventos de widget para activar funciones, servicios de datos o servicios dentro de widgets. Por ejemplo, se pueden enlazar los eventos a una función del validador para validar la entrada a medida que se escribe o cuando se pulsa la tecla Intro.

Se puede activar la propiedad ReadOnly para impedir que se realicen cambios en el texto en tiempo de ejecución. Por ejemplo, esta propiedad se puede utilizar para evitar que se realicen cambios hasta que se active un botón de alternar o se seleccione una casilla en el mashup. Si se activa la opción de solo lectura, se puede seleccionar y copiar texto, pero no se puede editar, cortar ni borrar el valor actual. Para cambiar el valor del texto de un campo de texto de solo lectura, introduzca un valor para la propiedad Text en la fase de diseño. También se puede enlazar un origen de datos a la propiedad para cambiar el valor del texto en tiempo de ejecución.

Se puede limitar la entrada del campo de texto a un número específico de caracteres de una de las siguientes maneras:

Para añadir un contador que muestre el número de caracteres en el campo de texto, defina la propiedad Counter en True. La propiedad MaxNumberOfCharacters se utiliza para definir el límite de caracteres, incluido el espacio en blanco. En la siguiente imagen se muestra el widget de campo de texto con un contador visible y un número máximo de caracteres de 10:

Cuando se alcanza el límite de caracteres, cambia el color del contador:

Se puede activar la propiedad ShowClearText para añadir un botón de texto al cuadro de entrada del widget. El botón aparece automáticamente en el lado derecho del widget cuando el campo de entrada contiene un valor. De este modo, los usuarios pueden quitar rápidamente cualquier texto existente en el widget.

La propiedad Icon se puede utilizar para mostrar un icono dentro del campo de texto. El icono aparece automáticamente en el lado izquierdo del widget. Se puede seleccionar un icono entre los iconos de SVG proporcionados que están disponibles en la plataforma. Para obtener más información sobre estos iconos, consulte Uso de iconos SVG.

La propiedad Mask se puede utilizar para especificar un patrón de entrada para caracteres numéricos, alfabéticos y alfanuméricos. Cuando se define un patrón, se añaden guías de marcador al cuadro de entrada. Las guías son líneas que se utilizan para indicar el patrón de texto que un usuario puede escribir en el campo de texto. Además del patrón requerido, la propiedad define el número de caracteres en el campo de texto. Se pueden crear patrones mediante los siguientes caracteres especiales:

Para crear un patrón, combine los caracteres especiales en una cadena que represente la entrada requerida. Por ejemplo, los siguientes patrones representan distintos tipos de entradas:

En la siguiente imagen se muestran las guías de un patrón numérico 999–999–999–999 que contiene cuatro números de tres dígitos en tiempo de ejecución:

El patrón se utiliza para definir el formato del número además del número de dígitos. En este ejemplo, se puede escribir cualquier número de 12 dígitos como, por ejemplo: 256120233234. A medida que se escribe, las guías de guion bajo (_) se reemplazan por números.

Las guías de indicador se muestran en función del número total de caracteres que se han definido en el patrón durante la fase de diseño. Cuando se escribe un número con menos dígitos que el patrón, la entrada permanece incompleta. Se debe utilizar la máscara para definir patrones con un número específico de caracteres, como números de teléfono o códigos postales. Evite utilizar una máscara cuando la entrada no sea un número específico de caracteres, como una cantidad monetaria.

Las propiedades del widget de campo de texto se muestran a continuación.

Además de las propiedades comunes, se pueden utilizar las propiedades de validación MaxLength y MinLength para validar el número de caracteres del widget de campo de texto.

Se puede personalizar el mensaje de fallo por defecto con las propiedades MaxLengthFailureMessage y MinLengthFailureMessage. Los valores máximos y mínimos se muestran en los mensajes mediante el parámetro ${value}.

Para obtener más información sobre el uso de las propiedades de validación comunes, consulte Aplicación de validación a widgets.

En la siguiente tabla se enumeran las propiedades de validación que están disponibles en el panel Validación.