El campo de texto es un elemento básico de formulario que permite la inserción y edición de texto en una única línea. Se debe usar cuando el texto a introducir es corto, por ejemplo nombre o apellidos. Para textos largos usar áreas de texto.
Parámetros Nunjucks del componente: "Input". Versión: 4.0.0
Los parámetros de Nunjucks para este componente están dentro de la siguiente etiqueta code en formato yaml.
{"val":"params:\n- name: id\n type: string\n required: true\n description: The id of the input.\n- name: name\n type: string\n required: true\n description: The name of the input, which is submitted with the form data.\n- name: type\n type: string\n required: false\n description: Type of input control to render. Defaults to \"text\".\n- name: inputmode\n type: string\n require: false\n description: Optional value for [inputmode](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/inputmode).\n- name: value\n type: string\n required: false\n description: Optional initial value of the input.\n- name: describedBy\n type: string\n required: false\n description: One or more element IDs to add to the `aria-describedby` attribute, used to provide additional descriptive information for screenreader users.\n- name: label\n type: object\n required: true\n description: Options for the label component.\n isComponent: true\n- name: hint\n type: object\n required: false\n description: Options for the hint component.\n isComponent: true\n- name: errorMessage\n type: object\n required: false\n description: Options for the error message component. The error message component will not display if you use a falsy value for `errorMessage`, for example `false` or `null`.\n isComponent: true\n- name: errorId\n type: string\n required: false\n description: Custom ID to add to the `aria-errormessage` attribute, used to provide additional descriptive information for screenreader users. Used in date-input component with errors.\n- name: describedBy\n type: string\n required: false\n description: One or more element IDs to add to the `aria-describedby` attribute, used to provide additional descriptive information for screenreader users.\n- name: formGroup\n type: object\n required: false\n description: Options for the form-group wrapper\n params:\n - name: classes\n type: string\n required: false\n description: Classes to add to the form group (e.g. to show error state for the whole group)\n- name: classes\n type: string\n required: false\n description: Classes to add to the input.\n- name: autocomplete\n type: string\n required: false\n description: Attribute to [identify input purpose](https://www.w3.org/WAI/WCAG21/Understanding/identify-input-purpose.html), for instance \"postal-code\" or \"username\". See [autofill](https://html.spec.whatwg.org/multipage/form-control-infrastructure.html#autofill) for full list of attributes that can be used.\n- name: pattern\n type: string\n required: false\n description: Attribute to [provide a regular expression pattern](https://www.w3.org/TR/html51/sec-forms.html#the-pattern-attribute), used to match allowed character combinations for the input value.\n- name: placeholder\n type: string\n required: false\n description: Placeholder text\n- name: disabled\n type: boolean\n required: false\n description: If true, input will be disabled.\n- name: attributes\n type: object\n required: false\n description: HTML attributes (for example data attributes) to add to the anchor tag.","length":3028}
Ejemplo: "Por defecto", de código HTML, para maquetar el componente: "Input", versión: 4.0.0, del sistema de diseño DESY
Para compilar el css del siguiente código deberás instalar Tailwind CSS y usar el archivo tailwind.config.js del proyecto: desy-html.
Para que funcione el comportamiento del siguiente código deberás importar el archivo index.js y todos los archivos javascript de la carpeta /src/js y /src/js/aria del proyecto: desy-html.
Usar sólo el código que está dentro de la siguiente etiqueta <code>.
Ejemplo: "Deshabilitado", de código HTML, para maquetar el componente: "Input", versión: 4.0.0, del sistema de diseño DESY
Para compilar el css del siguiente código deberás instalar Tailwind CSS y usar el archivo tailwind.config.js del proyecto: desy-html.
Para que funcione el comportamiento del siguiente código deberás importar el archivo index.js y todos los archivos javascript de la carpeta /src/js y /src/js/aria del proyecto: desy-html.
Usar sólo el código que está dentro de la siguiente etiqueta <code>.
Ejemplo: "Con pista", de código HTML, para maquetar el componente: "Input", versión: 4.0.0, del sistema de diseño DESY
Para compilar el css del siguiente código deberás instalar Tailwind CSS y usar el archivo tailwind.config.js del proyecto: desy-html.
Para que funcione el comportamiento del siguiente código deberás importar el archivo index.js y todos los archivos javascript de la carpeta /src/js y /src/js/aria del proyecto: desy-html.
Usar sólo el código que está dentro de la siguiente etiqueta <code>.
Ejemplo: "Con mensaje de error", de código HTML, para maquetar el componente: "Input", versión: 4.0.0, del sistema de diseño DESY
Para compilar el css del siguiente código deberás instalar Tailwind CSS y usar el archivo tailwind.config.js del proyecto: desy-html.
Para que funcione el comportamiento del siguiente código deberás importar el archivo index.js y todos los archivos javascript de la carpeta /src/js y /src/js/aria del proyecto: desy-html.
Usar sólo el código que está dentro de la siguiente etiqueta <code>.
<!-- input -->
<div class="c-form-group c-form-group--error">
<!-- label -->
<label class="block" for="input-with-error-message-a">Esto es un label</label>
<!-- /label -->
<!-- hint -->
<p id="input-with-error-message-a-hint" class="block text-neutral-dark">Esto es una pista.</p>
<!-- /hint -->
<!-- error-message -->
<p id="input-with-error-message-a-error" class="block font-semibold text-alert-base">
<span class="sr-only">Error:</span>Error: esto es un mensaje de error
</p>
<!-- /error-message -->
<input class="c-input block mt-sm border-black rounded font-semibold placeholder-neutral-dark focus:border-black focus:shadow-outline-focus-input focus:ring-4 focus:ring-warning-base disabled:bg-neutral-light disabled:border-neutral-base border-alert-base ring-2 ring-alert-base " id="input-with-error-message-a" name="test-name" type="text" aria-describedby="input-with-error-message-a-hint input-with-error-message-a-error" aria-errormessage="input-with-error-message-a-error" aria-invalid="true">
</div>
<!-- /input -->
Ejemplo: "Con mensaje de error", de código Nunjucks, para maquetar el componente: "Input", versión: 4.0.0, del sistema de diseño DESY
Pegar en la página: pagina-prueba.html del proyecto: desy-html-starter.
Usar sólo el código que está dentro de la siguiente etiqueta <code>.
{% from "components/input/_macro.input.njk" import componentInput %}
{{ componentInput({
"label": {
"text": "Esto es un label"
},
"hint": {
"text": "Esto es una pista."
},
"id": "input-with-error-message-a",
"name": "test-name",
"errorMessage": {
"text": "Error: esto es un mensaje de error"
}
}) }}
Esto es una pista.
Error:Error: esto es un mensaje de error
Mostrar códigodel ejemplo: Con mensaje de error
Contenido
Nunjucks macro
{%from"components/input/_macro.input.njk" import componentInput %}{{ componentInput({
"label": {
"text": "Esto es un label"
},
"hint": {
"text": "Esto es una pista."
},
"id": "input-with-error-message-a",
"name": "test-name",
"errorMessage": {
"text": "Error: esto es un mensaje de error"
}
}) }}
HTML
<!-- input --><divclass="c-form-group c-form-group--error"><!-- label --><labelclass="block"for="input-with-error-message-a">Esto es un label</label><!-- /label --><!-- hint --><pid="input-with-error-message-a-hint"class="block text-neutral-dark">Esto es una pista.</p><!-- /hint --><!-- error-message --><pid="input-with-error-message-a-error"class="block font-semibold text-alert-base"><spanclass="sr-only">Error:</span>Error: esto es un mensaje de error
</p><!-- /error-message --><inputclass="c-input block mt-sm border-black rounded font-semibold placeholder-neutral-dark focus:border-black focus:shadow-outline-focus-input focus:ring-4 focus:ring-warning-base disabled:bg-neutral-light disabled:border-neutral-base border-alert-base ring-2 ring-alert-base "id="input-with-error-message-a"name="test-name"type="text"aria-describedby="input-with-error-message-a-hint input-with-error-message-a-error"aria-errormessage="input-with-error-message-a-error"aria-invalid="true"></div><!-- /input -->
Ejemplo: "Con mensaje de error con id personalizado", de código HTML, para maquetar el componente: "Input", versión: 4.0.0, del sistema de diseño DESY
Para compilar el css del siguiente código deberás instalar Tailwind CSS y usar el archivo tailwind.config.js del proyecto: desy-html.
Para que funcione el comportamiento del siguiente código deberás importar el archivo index.js y todos los archivos javascript de la carpeta /src/js y /src/js/aria del proyecto: desy-html.
Usar sólo el código que está dentro de la siguiente etiqueta <code>.
<!-- input -->
<div class="c-form-group c-form-group--error">
<!-- label -->
<label class="block" for="input-with-error-message-b">Esto es un label</label>
<!-- /label -->
<!-- hint -->
<p id="input-with-error-message-b-hint" class="block text-neutral-dark">Esto es una pista.</p>
<!-- /hint -->
<!-- error-message -->
<p id="custom-error-id" class="block font-semibold text-alert-base">
<span class="sr-only">Error:</span>Error: esto es un mensaje de error
</p>
<!-- /error-message -->
<input class="c-input block mt-sm border-black rounded font-semibold placeholder-neutral-dark focus:border-black focus:shadow-outline-focus-input focus:ring-4 focus:ring-warning-base disabled:bg-neutral-light disabled:border-neutral-base border-alert-base ring-2 ring-alert-base " id="input-with-error-message-b" name="test-name" type="text" aria-describedby="input-with-error-message-b-hint" aria-errormessage="custom-error-id" aria-invalid="true">
</div>
<!-- /input -->
Ejemplo: "Con mensaje de error con id personalizado", de código Nunjucks, para maquetar el componente: "Input", versión: 4.0.0, del sistema de diseño DESY
Pegar en la página: pagina-prueba.html del proyecto: desy-html-starter.
Usar sólo el código que está dentro de la siguiente etiqueta <code>.
{% from "components/input/_macro.input.njk" import componentInput %}
{{ componentInput({
"label": {
"text": "Esto es un label"
},
"hint": {
"text": "Esto es una pista."
},
"id": "input-with-error-message-b",
"name": "test-name",
"errorId": "custom-error-id",
"errorMessage": {
"text": "Error: esto es un mensaje de error"
}
}) }}
Esto es una pista.
Error:Error: esto es un mensaje de error
Mostrar códigodel ejemplo: Con mensaje de error con id personalizado
Contenido
Nunjucks macro
{%from"components/input/_macro.input.njk" import componentInput %}{{ componentInput({
"label": {
"text": "Esto es un label"
},
"hint": {
"text": "Esto es una pista."
},
"id": "input-with-error-message-b",
"name": "test-name",
"errorId": "custom-error-id",
"errorMessage": {
"text": "Error: esto es un mensaje de error"
}
}) }}
HTML
<!-- input --><divclass="c-form-group c-form-group--error"><!-- label --><labelclass="block"for="input-with-error-message-b">Esto es un label</label><!-- /label --><!-- hint --><pid="input-with-error-message-b-hint"class="block text-neutral-dark">Esto es una pista.</p><!-- /hint --><!-- error-message --><pid="custom-error-id"class="block font-semibold text-alert-base"><spanclass="sr-only">Error:</span>Error: esto es un mensaje de error
</p><!-- /error-message --><inputclass="c-input block mt-sm border-black rounded font-semibold placeholder-neutral-dark focus:border-black focus:shadow-outline-focus-input focus:ring-4 focus:ring-warning-base disabled:bg-neutral-light disabled:border-neutral-base border-alert-base ring-2 ring-alert-base "id="input-with-error-message-b"name="test-name"type="text"aria-describedby="input-with-error-message-b-hint"aria-errormessage="custom-error-id"aria-invalid="true"></div><!-- /input -->
Este ejemplo usa todo el ancho disponible. Mira el archivo tailwind.config.js para una lista completa de anchuras disponibles.
Ejemplo: "Con clase de anchura completa", de código HTML, para maquetar el componente: "Input", versión: 4.0.0, del sistema de diseño DESY
Para compilar el css del siguiente código deberás instalar Tailwind CSS y usar el archivo tailwind.config.js del proyecto: desy-html.
Para que funcione el comportamiento del siguiente código deberás importar el archivo index.js y todos los archivos javascript de la carpeta /src/js y /src/js/aria del proyecto: desy-html.
Usar sólo el código que está dentro de la siguiente etiqueta <code>.
Este ejemplo usa la mitad del ancho disponible por su contenedor. Mira el archivo tailwind.config.js para una lista completa de anchuras disponibles.
Ejemplo: "Con clase de anchura 1/2", de código HTML, para maquetar el componente: "Input", versión: 4.0.0, del sistema de diseño DESY
Para compilar el css del siguiente código deberás instalar Tailwind CSS y usar el archivo tailwind.config.js del proyecto: desy-html.
Para que funcione el comportamiento del siguiente código deberás importar el archivo index.js y todos los archivos javascript de la carpeta /src/js y /src/js/aria del proyecto: desy-html.
Usar sólo el código que está dentro de la siguiente etiqueta <code>.
Este ejemplo usa una anchura predefinida de DESY. Mira el archivo tailwind.config.js para una lista completa de anchuras disponibles
Ejemplo: "Con clase width-32", de código HTML, para maquetar el componente: "Input", versión: 4.0.0, del sistema de diseño DESY
Para compilar el css del siguiente código deberás instalar Tailwind CSS y usar el archivo tailwind.config.js del proyecto: desy-html.
Para que funcione el comportamiento del siguiente código deberás importar el archivo index.js y todos los archivos javascript de la carpeta /src/js y /src/js/aria del proyecto: desy-html.
Usar sólo el código que está dentro de la siguiente etiqueta <code>.
Ejemplo: "Con label como encabezado", de código HTML, para maquetar el componente: "Input", versión: 4.0.0, del sistema de diseño DESY
Para compilar el css del siguiente código deberás instalar Tailwind CSS y usar el archivo tailwind.config.js del proyecto: desy-html.
Para que funcione el comportamiento del siguiente código deberás importar el archivo index.js y todos los archivos javascript de la carpeta /src/js y /src/js/aria del proyecto: desy-html.
Usar sólo el código que está dentro de la siguiente etiqueta <code>.
Ejemplo: "Con clases de form-group opcionales", de código HTML, para maquetar el componente: "Input", versión: 4.0.0, del sistema de diseño DESY
Para compilar el css del siguiente código deberás instalar Tailwind CSS y usar el archivo tailwind.config.js del proyecto: desy-html.
Para que funcione el comportamiento del siguiente código deberás importar el archivo index.js y todos los archivos javascript de la carpeta /src/js y /src/js/aria del proyecto: desy-html.
Usar sólo el código que está dentro de la siguiente etiqueta <code>.
Ejemplo: "Con valores de autocompletado", de código HTML, para maquetar el componente: "Input", versión: 4.0.0, del sistema de diseño DESY
Para compilar el css del siguiente código deberás instalar Tailwind CSS y usar el archivo tailwind.config.js del proyecto: desy-html.
Para que funcione el comportamiento del siguiente código deberás importar el archivo index.js y todos los archivos javascript de la carpeta /src/js y /src/js/aria del proyecto: desy-html.
Usar sólo el código que está dentro de la siguiente etiqueta <code>.
Usa el atributo pattern para elegir un patrón de entrada de datos nativo del navegador.
Ejemplo: "Con al atributo pattern", de código HTML, para maquetar el componente: "Input", versión: 4.0.0, del sistema de diseño DESY
Para compilar el css del siguiente código deberás instalar Tailwind CSS y usar el archivo tailwind.config.js del proyecto: desy-html.
Para que funcione el comportamiento del siguiente código deberás importar el archivo index.js y todos los archivos javascript de la carpeta /src/js y /src/js/aria del proyecto: desy-html.
Usar sólo el código que está dentro de la siguiente etiqueta <code>.
El formulario debe comenzar con un párrafo que ponga: * Todos los campos marcados con asterisco son obligatorios.
Ejemplo: "Campo obligatorio", de código HTML, para maquetar el componente: "Input", versión: 4.0.0, del sistema de diseño DESY
Para compilar el css del siguiente código deberás instalar Tailwind CSS y usar el archivo tailwind.config.js del proyecto: desy-html.
Para que funcione el comportamiento del siguiente código deberás importar el archivo index.js y todos los archivos javascript de la carpeta /src/js y /src/js/aria del proyecto: desy-html.
Usar sólo el código que está dentro de la siguiente etiqueta <code>.
Ejemplo: "Peque", de código HTML, para maquetar el componente: "Input", versión: 4.0.0, del sistema de diseño DESY
Para compilar el css del siguiente código deberás instalar Tailwind CSS y usar el archivo tailwind.config.js del proyecto: desy-html.
Para que funcione el comportamiento del siguiente código deberás importar el archivo index.js y todos los archivos javascript de la carpeta /src/js y /src/js/aria del proyecto: desy-html.
Usar sólo el código que está dentro de la siguiente etiqueta <code>.
Label en linea + Input flexible y mensaje de error
Ejemplo: "Con clases de css aplicadas", de código HTML, para maquetar el componente: "Input", versión: 4.0.0, del sistema de diseño DESY
Para compilar el css del siguiente código deberás instalar Tailwind CSS y usar el archivo tailwind.config.js del proyecto: desy-html.
Para que funcione el comportamiento del siguiente código deberás importar el archivo index.js y todos los archivos javascript de la carpeta /src/js y /src/js/aria del proyecto: desy-html.
Usar sólo el código que está dentro de la siguiente etiqueta <code>.
Si no se espacifica, el tipo por defecto es text. Este Input tiene un type='number'
Ejemplo: "Tipo personalizado", de código HTML, para maquetar el componente: "Input", versión: 4.0.0, del sistema de diseño DESY
Para compilar el css del siguiente código deberás instalar Tailwind CSS y usar el archivo tailwind.config.js del proyecto: desy-html.
Para que funcione el comportamiento del siguiente código deberás importar el archivo index.js y todos los archivos javascript de la carpeta /src/js y /src/js/aria del proyecto: desy-html.
Usar sólo el código que está dentro de la siguiente etiqueta <code>.
Ejemplo: "Valor", de código HTML, para maquetar el componente: "Input", versión: 4.0.0, del sistema de diseño DESY
Para compilar el css del siguiente código deberás instalar Tailwind CSS y usar el archivo tailwind.config.js del proyecto: desy-html.
Para que funcione el comportamiento del siguiente código deberás importar el archivo index.js y todos los archivos javascript de la carpeta /src/js y /src/js/aria del proyecto: desy-html.
Usar sólo el código que está dentro de la siguiente etiqueta <code>.
Ejemplo: "Placeholder", de código HTML, para maquetar el componente: "Input", versión: 4.0.0, del sistema de diseño DESY
Para compilar el css del siguiente código deberás instalar Tailwind CSS y usar el archivo tailwind.config.js del proyecto: desy-html.
Para que funcione el comportamiento del siguiente código deberás importar el archivo index.js y todos los archivos javascript de la carpeta /src/js y /src/js/aria del proyecto: desy-html.
Usar sólo el código que está dentro de la siguiente etiqueta <code>.
Ejemplo: "Con describedby", de código HTML, para maquetar el componente: "Input", versión: 4.0.0, del sistema de diseño DESY
Para compilar el css del siguiente código deberás instalar Tailwind CSS y usar el archivo tailwind.config.js del proyecto: desy-html.
Para que funcione el comportamiento del siguiente código deberás importar el archivo index.js y todos los archivos javascript de la carpeta /src/js y /src/js/aria del proyecto: desy-html.
Usar sólo el código que está dentro de la siguiente etiqueta <code>.
Ejemplo: "Pista con describedby", de código HTML, para maquetar el componente: "Input", versión: 4.0.0, del sistema de diseño DESY
Para compilar el css del siguiente código deberás instalar Tailwind CSS y usar el archivo tailwind.config.js del proyecto: desy-html.
Para que funcione el comportamiento del siguiente código deberás importar el archivo index.js y todos los archivos javascript de la carpeta /src/js y /src/js/aria del proyecto: desy-html.
Usar sólo el código que está dentro de la siguiente etiqueta <code>.
Ejemplo: "Error con describedby", de código HTML, para maquetar el componente: "Input", versión: 4.0.0, del sistema de diseño DESY
Para compilar el css del siguiente código deberás instalar Tailwind CSS y usar el archivo tailwind.config.js del proyecto: desy-html.
Para que funcione el comportamiento del siguiente código deberás importar el archivo index.js y todos los archivos javascript de la carpeta /src/js y /src/js/aria del proyecto: desy-html.
Usar sólo el código que está dentro de la siguiente etiqueta <code>.
Ejemplo: "Con error, pista y describedby", de código HTML, para maquetar el componente: "Input", versión: 4.0.0, del sistema de diseño DESY
Para compilar el css del siguiente código deberás instalar Tailwind CSS y usar el archivo tailwind.config.js del proyecto: desy-html.
Para que funcione el comportamiento del siguiente código deberás importar el archivo index.js y todos los archivos javascript de la carpeta /src/js y /src/js/aria del proyecto: desy-html.
Usar sólo el código que está dentro de la siguiente etiqueta <code>.
<!-- input -->
<div class="c-form-group c-form-group--error">
<!-- label -->
<label class="block" for="input-with-both">Esto es un label</label>
<!-- /label -->
<!-- hint -->
<p id="input-with-both-hint" class="block text-neutral-dark">Esto es una pista.</p>
<!-- /hint -->
<!-- error-message -->
<p id="input-with-both-error" class="block font-semibold text-alert-base">
<span class="sr-only">Error:</span>Error: esto es un mensaje de error
</p>
<!-- /error-message -->
<input class="c-input block mt-sm border-black rounded font-semibold placeholder-neutral-dark focus:border-black focus:shadow-outline-focus-input focus:ring-4 focus:ring-warning-base disabled:bg-neutral-light disabled:border-neutral-base border-alert-base ring-2 ring-alert-base " id="input-with-both" name="test-name" type="text" aria-describedby="input-example-a input-with-both-hint input-with-both-error" aria-errormessage="input-with-both-error" aria-invalid="true">
</div>
<!-- /input -->
Ejemplo: "Con error, pista y describedby", de código Nunjucks, para maquetar el componente: "Input", versión: 4.0.0, del sistema de diseño DESY
Pegar en la página: pagina-prueba.html del proyecto: desy-html-starter.
Usar sólo el código que está dentro de la siguiente etiqueta <code>.
{% from "components/input/_macro.input.njk" import componentInput %}
{{ componentInput({
"label": {
"text": "Esto es un label"
},
"hint": {
"text": "Esto es una pista."
},
"id": "input-with-both",
"name": "test-name",
"describedBy": "input-example-a",
"errorMessage": {
"text": "Error: esto es un mensaje de error"
}
}) }}
Esto es una pista.
Error:Error: esto es un mensaje de error
Mostrar códigodel ejemplo: Con error, pista y describedby
Contenido
Nunjucks macro
{%from"components/input/_macro.input.njk" import componentInput %}{{ componentInput({
"label": {
"text": "Esto es un label"
},
"hint": {
"text": "Esto es una pista."
},
"id": "input-with-both",
"name": "test-name",
"describedBy": "input-example-a",
"errorMessage": {
"text": "Error: esto es un mensaje de error"
}
}) }}
HTML
<!-- input --><divclass="c-form-group c-form-group--error"><!-- label --><labelclass="block"for="input-with-both">Esto es un label</label><!-- /label --><!-- hint --><pid="input-with-both-hint"class="block text-neutral-dark">Esto es una pista.</p><!-- /hint --><!-- error-message --><pid="input-with-both-error"class="block font-semibold text-alert-base"><spanclass="sr-only">Error:</span>Error: esto es un mensaje de error
</p><!-- /error-message --><inputclass="c-input block mt-sm border-black rounded font-semibold placeholder-neutral-dark focus:border-black focus:shadow-outline-focus-input focus:ring-4 focus:ring-warning-base disabled:bg-neutral-light disabled:border-neutral-base border-alert-base ring-2 ring-alert-base "id="input-with-both"name="test-name"type="text"aria-describedby="input-example-a input-with-both-hint input-with-both-error"aria-errormessage="input-with-both-error"aria-invalid="true"></div><!-- /input -->
Este atributo proporciona información al navegador para que se pueda mostrar el teclado virtual apropiado, especialmente en dispositivos móviles. Este input tiene un inputmode='email'
Ejemplo: "Inputmode", de código HTML, para maquetar el componente: "Input", versión: 4.0.0, del sistema de diseño DESY
Para compilar el css del siguiente código deberás instalar Tailwind CSS y usar el archivo tailwind.config.js del proyecto: desy-html.
Para que funcione el comportamiento del siguiente código deberás importar el archivo index.js y todos los archivos javascript de la carpeta /src/js y /src/js/aria del proyecto: desy-html.
Usar sólo el código que está dentro de la siguiente etiqueta <code>.