Componente Búsqueda rápida quick-search-component
El componente Búsqueda rápida proporciona funciones de búsqueda en un sitio web y presenta resultados de búsqueda para que los visitantes puedan encontrar fácilmente contenido coincidente y ver resultados.
Uso usage
El componente Búsqueda rápida permite a los visitantes del sitio buscar contenido, ver los resultados in situ y navegar fácilmente a las páginas coincidentes. Los nuevos resultados se obtienen de forma dinámica a medida que el usuario se desplaza por los resultados de la búsqueda.
El cuadro de diálogo de edición permite que el autor del contenido defina dónde debería comenzar la búsqueda en el árbol de contenido y, opcionalmente, ocultar la opción Búsqueda semántica. Con el cuadro de diálogo de diseño, el autor de la plantilla puede establecer el valor predeterminado de dónde debería comenzar la búsqueda en el árbol de contenido, el tamaño máximo del conjunto de resultados, la longitud mínima del término de búsqueda y si se mostrará a los visitantes la opción Búsqueda semántica de forma predeterminada.
Versión y compatibilidad version-and-compatibility
La versión actual del componente Búsqueda rápida es la versión 3, que se introdujo con versión 2.32.0 de los componentes principales agregando una opción de búsqueda semántica opcional y se describe en este documento.
La siguiente tabla detalla todas las versiones compatibles del componente, las versiones de AEM con las que son compatibles las versiones del componente y los vínculos a la documentación de versiones anteriores.
*La opción de búsqueda semántica solo está disponible con AEM as a Cloud Service.
Para obtener más información acerca de las versiones y publicaciones de los componentes principales, consulte el documento Versiones de componentes principales.
Salida del componente de ejemplo sample-component-output
Para experimentar el componente Búsqueda rápida, ver ejemplos de sus opciones de configuración y la salida de HTML y JSON, visite la Biblioteca de componentes.
Detalles técnicos technical-details
mod_security en Dispatcher.La documentación técnica más reciente sobre el componente Búsqueda rápida se encuentra en GitHub.
Puede encontrar más información acerca del desarrollo de componentes principales en la documentación para desarrolladores de componentes principales.
Cuadro de diálogo de edición edit-dialog
El cuadro de diálogo de edición permite al autor del contenido definir dónde debería comenzar la búsqueda en el árbol de contenido y, opcionalmente, ocultar la opción Búsqueda semántica.
Raíz de búsqueda: página raíz desde la que se inicia la búsqueda. La raíz de búsqueda puede ser un modelo maestro, un idioma maestro o una página normal.
-
ID: esta opción permite controlar el identificador único del componente en el HTML y en la capa de datos.
- Si se deja en blanco, se generará automáticamente un ID único que se puede encontrar inspeccionando la página resultante.
- Si se especifica un ID, es responsabilidad del autor asegurarse de que sea único.
- Cambiar el ID puede afectar al seguimiento de CSS, JS y de la capa de datos.
-
Ocultar opción de búsqueda semántica en esta instancia: cuando está marcada, la opción de búsqueda semántica está oculta, independientemente de lo que el cuadro de diálogo de diseño esté configurado para mostrar.
- Deje sin marcar para utilizar la plantilla predeterminada.
- Esta opción no puede forzar que se muestre la opción en una ubicación en la que el cuadro de diálogo de diseño la oculta.
Cuadro de diálogo Diseño design-dialog
Con el cuadro de diálogo de diseño, el autor de la plantilla puede establecer el valor predeterminado para el lugar en el que en el árbol de contenido debe comenzar la búsqueda, así como un tamaño máximo del conjunto de resultados, una longitud mínima del término de búsqueda y si la opción Búsqueda semántica se muestra a los visitantes de forma predeterminada.
Pestaña Propiedades properties-tab
-
Raíz de búsqueda: el valor predeterminado de la raíz de búsqueda cuando un autor de contenido coloca el componente Búsqueda rápida en una página de contenido
-
Tamaño de resultados: el número máximo de resultados recuperados por una solicitud de búsqueda
-
Longitud mínima del término de búsqueda: Longitud mínima del término de búsqueda para iniciar la búsqueda.
-
Ocultar alternancia de búsqueda semántica: cuando está marcada, la opción Búsqueda semántica descrita en Uso no se muestra a los visitantes del sitio de forma predeterminada, y el componente se comporta como el componente v2 (solo búsqueda de texto completo).
- Desactivado de forma predeterminada.
- Los autores de contenido también pueden invalidar esto para un componente de búsqueda rápida individual en el cuadro de diálogo de edición.
Pestaña Estilos styles-tab
El componente Búsqueda rápida es compatible con el sistema de estilos AEM.