Campo de Formulario, Tipo text

From Joomla! Documentation

This page is a translated version of the page Text form field type and the translation is 100% complete.
Other languages:
Deutsch • ‎English • ‎Nederlands • ‎español • ‎français

El campo de formulario tipo text proporciona un cuadro de texto para la entrada de datos. Si el campo tiene un valor guardado, este valor se muestra cuando la página se carga por primera vez. Si no, el valor predeterminado (si existe) está seleccionado.

Params.text.jpg
  • type (obligatorio) debe ser text.
  • name (obligatorio) es el nombre único del campo.
  • label (obligatoria) (traducible) es el título descriptivo del campo.
  • size (opcional) es el ancho del cuadro de texto en caracteres. Si se omite el ancho será determinado por el navegador. El valor de tamaño no limita el número de caracteres que se pueden ingresar.
  • maxlength (opcional) limita el número de caracteres que se pueden ingresar.
  • default (opcional) (no traducible) es el valor predeterminado.
  • description (opcional) (traducible) es el texto que será mostrado como un texto de ayuda cuando el usuario mueve el ratón sobre el cuadro de texto.
  • class (opcional) es un nombre de una clase CSS para el campo de formulario HTML. Si se omite, el valor predeterminado será 'text_area'.
  • readonly (opcional) El campo no se puede cambiar y se hereda automáticamente el valor predeterminado. (Posible valores: "true", "1", "readonly" para establecerlo en verdadero)
  • disabled (opcional) El campo, no se puede cambiar y se heredan automáticamente el valor por defecto - tampoco se pasa el valor. (Posible valores: "true", "1", "readonly" para establecerlo en verdadero)
  • required (opcional) El campo debe ser llenado antes de enviar el formulario. (Posible valores: "true", "1", "readonly" para establecerlo en verdadero)
  • filter (opcional) permite que el sistema guarde ciertas etiquetas html o datos en bruto.
  • message (opcional) El mensaje de error que se mostrará en lugar del mensaje predeterminado.
  • hint (opcional) El texto mostrado en el marcador de posición del elemento html, usualmente es un pequeño texto guía con un color suave en un campo vacío.
  • inputtype (opcional) Establece el tipo de entrada HTML5
  • pattern (opcional) Un patrón de expresión regular a usar para la validación.

The Text field can also take an array of option sub elements in order to show suggestions to user in the text field.

Ejemplo de Definición XML del campo:

<field name="mytextvalue" type="text" default="Some text" label="Enter some text" description="" size="10" />

Utiliza el filtro integer para asegurarte que las letras tipos quedan despojadas cuando se procesa el formulario.

<field name="myintvalue" type="text" default="8" label="Enter some text" description="Enter some description" filter="integer" />

Utiliza el filtro raw para asegurarte que el código html es preservado cuándo el formulario es procesado.

<field name="myhtmlvalue" type="text" default="" label="Enter some text" description="Enter some description" filter="raw" />

Ver también