Apple HIG: Navigation Components
Implementar búsqueda y navegación según los estándares de Apple
Obtén implementaciones de campo de búsqueda, control de página y control de ruta aprobadas por Apple que siguen las Directrices de Interfaz Humana. Garantiza que la navegación de tu aplicación se sienta nativa e intuitiva en iOS, macOS y otras plataformas de Apple.
Descargar el ZIP de la skill
Subir en Claude
Ve a Configuración → Capacidades → Skills → Subir skill
Activa y empieza a usar
Pruébalo
Usando "Apple HIG: Navigation Components". ¿Dónde debería ir la búsqueda en una aplicación iOS con una barra de pestañas?
Resultado esperado:
Para aplicaciones iOS con una barra de pestañas, tienes tres opciones principales: 1) Búsqueda como una pestaña visualmente distinta en el lado posterior de la barra de pestañas (mantiene la búsqueda siempre visible), 2) Búsqueda en una barra de herramientas inferior (campo expandido o botón que se anima para convertirse en campo), o 3) Búsqueda en línea con el contenido. Apple recomienda la colocación inferior cuando la búsqueda es una prioridad y hay espacio, ya que es más fácil de alcanzar. Considera si el campo de búsqueda debe comenzar enfocado (el teclado aparece inmediatamente) o desenfocado (promueve el descubrimiento) según los objetivos de tu aplicación.
Usando "Apple HIG: Navigation Components". ¿Cuál es la diferencia entre controles de página y controles de ruta?
Resultado esperado:
Los controles de página muestran una fila de puntos indicadores que representan páginas en una secuencia plana y lineal (como pantallas de incorporación o galerías de fotos). Ayudan a los usuarios a navegar entre elementos del mismo nivel en una lista ordenada. Los controles de ruta muestran la ruta del sistema de archivos de un elemento seleccionado, mostrando la jerarquía desde el disco raíz hasta las carpetas principales y el elemento actual. Los controles de ruta son exclusivos de macOS y se usan para la navegación de archivos (como la barra de ruta de Finder), mientras que los controles de página son para la paginación de páginas de contenido discretas en iOS/iPadOS.
Usando "Apple HIG: Navigation Components". ¿Cómo agrego tokens de ámbito de búsqueda como en Mail?
Resultado esperado:
Los tokens son representaciones visuales de términos de búsqueda que los usuarios pueden seleccionar y editar como filtros. Para implementar tokens en tu campo de búsqueda: 1) Define términos de búsqueda comunes o elementos (como contactos específicos en Mail o filtros de fotos en Messages), 2) Aplica un tratamiento visual que encapsule el término como un elemento seleccionable, 3) Permite que los tokens filtren términos de búsqueda adicionales, 4) Considera emparejar tokens con sugerencias de búsqueda para que los usuarios descubran tokens disponibles, 5) Usa las APIs buscables de SwiftUI o UISearchTextField para la compatibilidad con tokens. Los tokens aclaran las búsquedas al enfocarlas en atributos específicos.
Auditoría de seguridad
SeguroAll 200 static analysis findings are false positives from pattern matching on Markdown documentation content. This skill contains only Apple Human Interface Guidelines reference documentation with no executable code. The detected 'external_commands' patterns are inline code formatting (backticks in Markdown), 'network' patterns are legitimate documentation links to developer.apple.com, and 'blocker' patterns match words in UI component names and API references. This is safe documentation content.
Puntuación de calidad
Lo que puedes crear
Implementar búsqueda en una aplicación iOS
Un desarrollador de iOS necesita agregar funcionalidad de búsqueda a su aplicación. Usa esta skill para entender si debe colocar la búsqueda en una barra de pestañas, barra de herramientas o en línea, y cómo implementar controles de ámbito para filtrar resultados.
Agregar paginación a una galería de fotos
Un desarrollador que crea una aplicación de galería de fotos necesita controles de página para la navegación. Consulta esta skill para aprender la colocación adecuada de los controles de página, la personalización de indicadores y los comportamientos específicos de la plataforma para iOS frente a watchOS.
Diseñar un navegador de archivos de macOS
Un desarrollador de Mac está creando un navegador de archivos y necesita controles de ruta para la navegación de breadcrumbs. Consulta esta skill para entender los controles de ruta estándar frente a emergentes y su colocación adecuada en el cuerpo de la ventana frente a la barra de herramientas.
Prueba estos prompts
¿Dónde debería colocar el campo de búsqueda en mi aplicación iOS? La aplicación tiene una barra de pestañas en la parte inferior.
¿En qué se diferencian los controles de página entre iOS y watchOS? Estoy creando una aplicación de fitness que tiene como objetivo ambas plataformas.
Estoy creando una aplicación tipo Mail. ¿Cómo implemento controles de ámbito y tokens para el filtrado de búsqueda?
Necesito mostrar la navegación de jerarquía de archivos en una aplicación de documentos de macOS. ¿Debo usar controles de ruta estándar o emergentes, y dónde debería colocarlos?
Mejores prácticas
- Inicia la búsqueda inmediatamente cuando los usuarios escriben para proporcionar resultados continuamente refinados e instantáneos en lugar de esperar el envío del formulario
- Coloca los campos de búsqueda donde los usuarios esperen encontrarlos, típicamente en la parte superior de la lista, barra de herramientas o barra de navegación, con texto de marcador de posición útil que describa qué se puede buscar
- De manera predeterminada, usa un ámbito de búsqueda más amplio y permite que los usuarios lo estrechen con controles de ámbito, proporcionando contexto para el conjunto completo de resultados antes del refinamiento
Evitar
- Evita usar texto de marcador de posición genérico como 'Buscar' en los campos de búsqueda: no proporciona un contexto útil sobre qué contenido se puede buscar
- No uses controles de página para navegación jerárquica: están diseñados solo para secuencias de página planas y lineales donde todas las páginas tienen el mismo peso
- Nunca coloques controles de ruta en barras de herramientas o barras de estado: pertenecen al cuerpo de la ventana, como la barra de ruta de Finder en la parte inferior de la ventana
Preguntas frecuentes
¿Qué plataformas cubre esta skill?
¿Esta skill proporciona ejemplos de código?
¿Cuál es la diferencia entre controles de ámbito y tokens?
¿Cuándo debo usar búsqueda enfocada vs desenfocada en una barra de pestañas?
¿Puedo usar controles de ruta en iOS?
¿Cuántos indicadores de página son demasiados?
Detalles del desarrollador
Autor
sickn33Licencia
MIT
Repositorio
https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/hig-components-searchRef.
main
Estructura de archivos