Expandir o contraer una sección de Docs
Usa las cabeceras de sección de la barra lateral de Documentación de la app para mostrar u ocultar la lista de artículos de una sección de docs. La acción solo cambia la vista actual de la barra lateral; no edita contenido de docs, no cambia el artículo seleccionado, no actualiza parámetros de ruta ni guarda nada en el servidor.
En este artículo
Usa esta guía cuando un operador, un usuario de soporte o un lector de documentación necesite hacer más fácil de recorrer una barra lateral larga de Docs mientras lee las guías de Antylogic.
La sección del artículo seleccionado se abre automáticamente, y Buscar en Docs mantiene abiertas las secciones coincidentes para que los resultados visibles de búsqueda no queden ocultos por una cabecera contraída.
Antes de empezar
- Has iniciado sesión en la app de Antylogic.
- Estás en la pantalla de Documentación de la app nativa, abierta desde la navegación de la app o con `antylogic://docs`.
- El índice de docs se ha cargado desde `/api/app/docs` y al menos una sección es visible en la barra lateral.
- No hace falta seleccionar organización ni ubicación para la ruta de Documentación.
Instrucciones
- 1.
Abre Documentación
Abre la pantalla de Documentación desde la navegación de la app o usa `antylogic://docs`. Espera hasta que la barra lateral muestre Docs, Buscar en Docs, el contador de artículos y al menos una cabecera de sección.
- 2.
Localiza la sección
Busca debajo de Buscar en Docs la sección que contiene los artículos que quieres revisar. Si ya hay un artículo seleccionado, su sección se trata como abierta para que el artículo seleccionado siga siendo localizable.
- 3.
Contrae una sección abierta
Pulsa una cabecera de sección abierta. Los enlaces de artículo bajo esa cabecera se ocultan, el chevron vuelve a su orientación contraída y el artículo del área de lectura no cambia.
- 4.
Vuelve a expandir la sección
Pulsa de nuevo la misma cabecera de sección. Los enlaces de artículo de esa sección vuelven a ser visibles y el chevron muestra la orientación abierta.
- 5.
Usa la búsqueda cuando haga falta
Escribe en Buscar en Docs para filtrar la lista de artículos ya cargada. Mientras haya texto de búsqueda, todas las secciones coincidentes permanecen visualmente abiertas, aunque se pulse una cabecera de sección.
Validaciones y límites
- Los controles de sección aparecen solo después de que el índice de docs se haya cargado y el filtrado local deje al menos un artículo en una sección.
- La clave de conmutación es el valor exacto de `DocsSection.slug` de la sección visible.
- Expandir o contraer una sección no envía payload, no realiza validación en el backend y no vuelve a llamar a `/api/app/docs`.
- La acción no cambia el estado de `sectionSlug`, `articleSlug`, `articleId`, locale, plataforma, tema, organización ni ubicación.
- Buscar en Docs es local al índice cargado y coincide por título, resumen, `section_slug`, `action_id` y `primary_keyword`; no envía una consulta `q` a `/api/app/docs`.
- Mientras Buscar en Docs contenga texto, las secciones coincidentes no pueden contraerse visualmente aunque pulsar una cabecera pueda seguir actualizando el estado local oculto de apertura.
- El estado de expansión no se guarda entre remontajes de la app, recargas ni reinicios de navegación.
- Hallazgo de implementación: una primera pulsación sobre una sección contraída nunca abierta y no seleccionada puede escribir `false`, así que esa sección puede no abrirse visualmente hasta la segunda pulsación.
Resultado esperado
La barra lateral de Docs muestra u oculta las filas de artículo de la sección elegida en el dispositivo actual, mientras el artículo seleccionado, el contenido de docs, la ruta y el estado del servidor permanecen sin cambios.