# Hig Components Status > HIG de Apple para progreso y estado: progress indicators, status bars y activity rings. Cuándo usar barra determinate frente a spinner. Fuente: https://skillsagentes.com/skills/raintree-technology/hig-doctor/hig-components-status Markdown: https://skillsagentes.com/skills/raintree-technology/hig-doctor/hig-components-status.md Repositorio: https://github.com/raintree-technology/hig-doctor Autor: raintree-technology Licencia: MIT Actualizado: hace 3 meses Coste de contexto: 174 tok instalada, 963 tok al activarse, 2.3k tok con todos los archivos del bundle Bundle: 4 archivos, 9 KB Permisos que pide: ninguno declarado ## Instalación Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina. ```bash # Claude Code npx -y skills add raintree-technology/hig-doctor --skill hig-components-status --agent claude-code # Cursor npx -y skills add raintree-technology/hig-doctor --skill hig-components-status --agent cursor # Codex npx -y skills add raintree-technology/hig-doctor --skill hig-components-status --agent codex # Gemini CLI npx -y skills add raintree-technology/hig-doctor --skill hig-components-status --agent gemini # Windsurf npx -y skills add raintree-technology/hig-doctor --skill hig-components-status --agent windsurf # Cline npx -y skills add raintree-technology/hig-doctor --skill hig-components-status --agent cline ``` ## Qué hace - Aplica HIG a indicadores de progreso, status bars y activity rings. - Determinate (barra) si se conoce duración; spinner si no; prefiere barras y las coloca donde aparecerá el contenido. - No apila indicadores; no oculta la status bar salvo inmersión, y la restaura al salir. ## Cuándo usarla - El usuario pregunta por progress bar, spinner, status bar, activity ring o cómo mostrar un loading. - Hay que elegir entre spinner y barra de progreso. ## Qué la activa - "¿Spinner o barra de progreso para esta descarga?" - "¿Qué va en la status bar?" - "Cómo mostrar que está cargando sin bloquear" ## Archivos - SKILL.md — 4 KB - references/activity-rings.md — 3 KB - references/progress-indicators.md — 2 KB - references/status-bars.md — 928 B ## SKILL.md Reproducido tal cual desde raintree-technology/hig-doctor bajo MIT. Esta sección es el documento original y está en inglés. # Apple HIG: Status Components Check for `.claude/apple-design-context.md` before asking questions. Use existing context and only ask for information not already covered. ## Key Principles 1. **Show progress for operations longer than a second or two.** 2. **Determinate when duration/percentage is known.** A filling progress bar gives users a clear sense of remaining work. Use for downloads, uploads, or any measurable process. 3. **Indeterminate when duration is unknown.** A spinner communicates work is happening without promising a timeframe. Use for unpredictable network requests. 4. **Prefer progress bars over spinners.** Determinate progress feels faster and more trustworthy. 5. **Place indicators where content will appear.** Inline progress near the content area, not modal or distant. 6. **Don't stack multiple indicators.** Aggregate simultaneous operations into one representation or show the most relevant. 7. **Don't hide the status bar without good reason.** Reserve hiding for immersive experiences (full-screen media, games, AR). 8. **Match status bar style to your content.** Light or dark for adequate contrast. 9. **Respect safe areas.** No interactive content behind the status bar. 10. **Restore the status bar promptly** when exiting immersive contexts. 11. **Activity rings are for Move, Exercise, and Stand goals.** Don't repurpose the ring metaphor for unrelated data. 12. **Respect ring color conventions.** Red (Move), green (Exercise), blue (Stand) are strongly associated with Apple Fitness. 13. **Use HealthKit APIs** for activity data rather than manual tracking. 14. **Celebrate completions** with animation and haptics when rings close. ## Reference Index | Reference | Topic | Key content | |---|---|---| | [progress-indicators.md](references/progress-indicators.md) | Progress bars and spinners | Determinate, indeterminate, inline placement, duration | | [status-bars.md](references/status-bars.md) | iOS/iPadOS status bar | System info, visibility, style, safe areas | | [activity-rings.md](references/activity-rings.md) | watchOS activity rings | Move/Exercise/Stand, HealthKit, fitness tracking, color | ## Output Format 1. **Indicator type recommendation** with rationale (determinate vs indeterminate). 2. **Timing and animation guidance** -- duration thresholds, animation style, transitions. 3. **Accessibility** -- VoiceOver progress announcements, live region updates. 4. **Platform-specific behavior** across targeted platforms. ## Questions to Ask 1. Is the duration known or unknown? 2. Which platforms? 3. How long does the operation typically take? 4. System-level or in-app indicator? ## Related Skills - **hig-components-system** -- Widgets and complications displaying progress or status - **hig-inputs** -- Gestures triggering progress states (pull-to-refresh) - **hig-technologies** -- HealthKit for activity ring data; VoiceOver for progress announcements --- *Built by [Raintree Technology](https://raintree.technology) · [More developer tools](https://raintree.technology)* ## Dónde encaja - Categoría: [Diseño y UI](https://skillsagentes.com/categorias/diseno-ui.md) — Sistemas de diseño, trabajo con componentes y acabado visual. - Creador: [raintree-technology](https://skillsagentes.com/creators/raintree-technology.md) — 14 skills en el directorio - [Todas las skills](https://skillsagentes.com/skills.md) - [Ranking de instalaciones](https://skillsagentes.com/ranking.md) ## Otras skills del mismo repositorio - [Hig Components System](https://skillsagentes.com/skills/raintree-technology/hig-doctor/hig-components-system.md): HIG de Apple para experiencias de sistema: widgets, Live Activities, notificaciones, complications, App Clips y shortcuts. - [Hig Components Controls](https://skillsagentes.com/skills/raintree-technology/hig-doctor/hig-components-controls.md): HIG de Apple para controles de selección y entrada: pickers, toggles, sliders, steppers, segmented controls, campos de texto y teclados virtuales. - [Hig Components Dialogs](https://skillsagentes.com/skills/raintree-technology/hig-doctor/hig-components-dialogs.md): HIG de Apple para presentación: alerts, action sheets, popovers, sheets y digit entry. Cuándo interrumpir y cómo confirmar acciones destructivas. - [Hig Components Layout](https://skillsagentes.com/skills/raintree-technology/hig-doctor/hig-components-layout.md): HIG de Apple para layout y navegación: sidebars, split views, tab bars, lists, tables y windows, adaptados a cada tamaño de pantalla. - [Hig Components Content](https://skillsagentes.com/skills/raintree-technology/hig-doctor/hig-components-content.md): HIG de Apple para componentes de contenido: charts, collection views, imágenes, web views, lockups y visualización de datos. ## Skills relacionadas - [Hig Components Content](https://skillsagentes.com/skills/raintree-technology/hig-doctor/hig-components-content.md): HIG de Apple para componentes de contenido: charts, collection views, imágenes, web views, lockups y visualización de datos. - [Hig Components System](https://skillsagentes.com/skills/raintree-technology/hig-doctor/hig-components-system.md): HIG de Apple para experiencias de sistema: widgets, Live Activities, notificaciones, complications, App Clips y shortcuts. - [Hig Components Controls](https://skillsagentes.com/skills/raintree-technology/hig-doctor/hig-components-controls.md): HIG de Apple para controles de selección y entrada: pickers, toggles, sliders, steppers, segmented controls, campos de texto y teclados virtuales. - [Hig Components Dialogs](https://skillsagentes.com/skills/raintree-technology/hig-doctor/hig-components-dialogs.md): HIG de Apple para presentación: alerts, action sheets, popovers, sheets y digit entry. Cuándo interrumpir y cómo confirmar acciones destructivas. - [Hig Components Layout](https://skillsagentes.com/skills/raintree-technology/hig-doctor/hig-components-layout.md): HIG de Apple para layout y navegación: sidebars, split views, tab bars, lists, tables y windows, adaptados a cada tamaño de pantalla. --- Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)