Buscar en los Docs cargados de la app
Usa el campo Buscar en Docs de la pantalla de Docs para acotar las secciones ya cargadas en la barra lateral. Escribir filtra solo los resúmenes de artículo locales; no envía una nueva petición de búsqueda al backend y no mueve el panel de artículo hasta que se selecciona un resultado filtrado.
En este artículo
La pantalla de Docs carga primero el índice de documentación usando el locale, la plataforma y el tema resueltos. En la demo es-ES de ES, el campo de búsqueda visible es Buscar en Docs.
Esta búsqueda sirve para navegar rápido dentro del índice cargado. Comprueba los metadatos de los resúmenes de artículo y actualiza la barra lateral en el sitio.
Antes de empezar
- El usuario ha iniciado sesión en la app.
- La pantalla de Docs está abierta desde /docs, antylogic://docs o Menú de usuario > Docs.
- El índice de Docs se ha cargado y contiene al menos un artículo, así que el campo Buscar en Docs es visible.
- Para capturas es-ES de ES, usa la sesión del usuario demo y el locale de docs en español.
Instrucciones
- 1.
Abre Docs
Abre la pantalla de Docs y espera a que el índice termine de cargarse. La barra lateral muestra Buscar en Docs y un contador de artículos del índice cargado.
- 2.
Filtra la barra lateral
Escribe un término como accesos. La barra lateral conserva solo las secciones con resúmenes de artículo coincidentes, y las secciones coincidentes permanecen abiertas mientras el campo de búsqueda no esté en blanco.
- 3.
Limpia la búsqueda
Borra el texto de búsqueda para restaurar el índice cargado completo. El comportamiento normal de secciones abiertas y contraídas vuelve a aplicarse cuando el campo está vacío.
- 4.
Lee el estado sin resultados
Si el valor no coincide con ningún resumen de artículo cargado, la barra lateral muestra Ningún artículo coincide con esta búsqueda. El panel de artículo actual sigue controlado por el estado de artículo existente.
Validaciones y límites
- Una búsqueda en blanco o solo con espacios muestra todos los artículos cargados.
- La búsqueda recorta el valor y coincide sin distinguir mayúsculas.
- La app coincide solo por título, resumen, slug de sección, id de acción y palabra clave principal de los resúmenes cargados.
- Escribir en el campo no llama a /api/app/docs?q=... y no cambia los parámetros de consulta de Docs.
- El contador de artículos sigue siendo el total del índice cargado, no el número de coincidencias filtradas.
- Las secciones sin artículos coincidentes se eliminan de la barra lateral, y el mensaje de sin resultados aparece cuando no queda ninguna sección.
- La búsqueda no tiene ranking, resaltado, debounce, tokenización ni plegado de acentos.
Resultado esperado
El usuario acota o restaura localmente la barra lateral de Docs. El contenido de docs del backend, los datos de usuario y los registros de la demo de Marea no cambian, y el artículo abierto cambia solo cuando el usuario selecciona un resultado filtrado.