Barra de búsqueda
Navegación
Consiste en una caja que permite introducir texto. Este componente se emplea para que el usuario pueda realizar búsquedas de contenido en el sitio web o en una vista.
Searchbar
Mostrar parámetros
Parámetros Nunjucks del componente: "Searchbar"
params:
- name: id
type: string
required: true
description: The id of the input
- name: value
type: string
required: false
description: Optional initial value of the input.
- name: describedBy
type: string
required: false
description: One or more element IDs to add to the `aria-describedby` attribute, used to provide additional descriptive information for screenreader users.
- name: label
type: object
required: true
description: Options for the label component.
isComponent: true
- name: errorMessage
type: object
required: false
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`.
isComponent: true
- name: classes
type: string
required: false
description: Classes to add to the input.
- name: buttonClasses
type: string
required: false
description: Classes to add to the search icon.
- name: button
type: component
required: false
description: button component parameters. If there are any, the searchbar will show a button after the input instead of the lens icon.
- name: placeholder
type: string
required: false
description: Placeholder text
- name: disabled
type: boolean
required: false
description: If true, input will be disabled.
- name: attributes
type: object
required: false
description: HTML attributes (for example data attributes) to add to the anchor tag.
Por defecto #
Descripción visual
Campo de búsqueda rectangular con borde gris claro de 1px y fondo blanco. Incluye label "Buscar" en texto negro pequeño arriba del campo. Botón de búsqueda con icono de lupa en azul oscuro alineado a la derecha dentro del campo.
Mostrar códigodel ejemplo: Por defecto
Con placeholder #
Descripción visual
Campo de búsqueda rectangular con borde gris claro de 1px y fondo blanco. Texto placeholder "Buscar en este sitio" en gris claro visible dentro del campo. Botón de búsqueda con icono de lupa en azul oscuro alineado a la derecha dentro del campo.
Mostrar códigodel ejemplo: Con placeholder
Deshabilitado #
Descripción visual
Campo de búsqueda rectangular con borde gris muy claro de 1px y fondo gris claro(#f5f5f5) . El campo aparece sin texto ni placeholder visible. Botón de búsqueda con icono de lupa en azul oscuro alineado a la derecha dentro del campo.
Mostrar códigodel ejemplo: Deshabilitado
Con mensaje de error #
Por accesibilidad, los mensajes de error deben incluir la palabra "error", para que no recaiga tan sólo en el color el hecho de que es un mensaje de error.
Descripción visual
Barra de búsqueda con input de texto rectangular con borde rojo de 2px, fondo blanco, y botón de búsqueda(ícono de lupa) alineado a la derecha dentro del campo. Debajo del input aparece un mensaje de error en texto rojo pequeño. Encima del campo hay un título descriptivo en texto negro normal.
Mostrar códigodel ejemplo: Con mensaje de error
Con label visible #
Descripción visual
Barra de búsqueda con input de texto rectangular con borde gris de 1px, fondo blanco, y botón de búsqueda(ícono de lupa) alineado a la derecha dentro del campo. Encima del input hay un label descriptivo en texto negro pequeño. El campo tiene altura estándar con espaciado interno generoso.
Mostrar códigodel ejemplo: Con label visible
Peque #
Descripción visual
Barra de búsqueda con input de texto rectangular de altura reducida, borde gris claro de 1px, fondo blanco, y botón de búsqueda(ícono de lupa) alineado a la derecha dentro del campo. No presenta label superior ni mensajes auxiliares. Las dimensiones verticales son compactas con espaciado interno mínimo.
Mostrar códigodel ejemplo: Peque
Botón personalizado #
Añade parámetros del componente Botón para sustituir el icono de la lupa con un botón junto al input.
Descripción visual
Campo de búsqueda con input de texto rectangular con borde gris de 1px y fondo blanco. Botón "Buscar" de fondo azul petróleo con texto blanco en mayúsculas está alineado a la derecha del input. El campo ocupa todo el ancho disponible con altura estándar.
Mostrar códigodel ejemplo: Botón personalizado
Botón personalizado pequeño #
Usamos los parámetros del componente Botón para personalizarlo, en este ejemplo botón peque.
Descripción visual
Campo de búsqueda con input de texto rectangular con borde gris de 1px y fondo blanco. Botón "Buscar" compacto con borde azul petróleo y texto azul petróleo está posicionado a la derecha del input. El campo ocupa todo el ancho disponible con altura reducida.
Mostrar códigodel ejemplo: Botón personalizado pequeño