[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-43a52117-cd83-4540-bb5f-c7595198ed1a":3,"$fWVmnvBcnxzl7WXoC-ueVOEUcAFOZLvoZkz_ADQ6AOjc":43},{"id":4,"title":5,"description":6,"categoryId":7,"moduleId":8,"tags":9,"prompt":10,"icon":11,"source":12,"sourceUrl":13,"authorId":14,"authorName":15,"isPublic":16,"stars":17,"runs":18,"createdAt":19,"updatedAt":19,"module":20,"category":27,"packages":34},"43a52117-cd83-4540-bb5f-c7595198ed1a","hig-components-status","苹果HIG指南中关于状态和进度UI组件的说明，包括进度指示器、状态栏和活动环。","cat_life_career","mod_other","sickn33,other","---\nname: hig-components-status\ndescription: Apple HIG guidance for status and progress UI components including progress indicators, status bars, and activity rings.\nrisk: unknown\nsource: community\ndate_added: '2026-02-27'\n---\n\n# Apple HIG: Status Components\n\nCheck for `.claude\u002Fapple-design-context.md` before asking questions. Use existing context and only ask for information not already covered.\n\n## Key Principles\n\n### Progress Indicators\n\n1. **Show progress for operations longer than a second or two.**\n\n2. **Determinate when duration\u002Fpercentage is known.** A filling progress bar gives users a clear sense of remaining work. Use for downloads, uploads, or any measurable process.\n\n3. **Indeterminate when duration is unknown.** A spinner communicates work is happening without promising a timeframe. Use for unpredictable network requests.\n\n4. **Prefer progress bars over spinners.** Determinate progress feels faster and more trustworthy.\n\n5. **Place indicators where content will appear.** Inline progress near the content area, not modal or distant.\n\n6. **Don't stack multiple indicators.** Aggregate simultaneous operations into one representation or show the most relevant.\n\n### Status Bars\n\n7. **Don't hide the status bar without good reason.** Reserve hiding for immersive experiences (full-screen media, games, AR).\n\n8. **Match status bar style to your content.** Light or dark for adequate contrast.\n\n9. **Respect safe areas.** No interactive content behind the status bar.\n\n10. **Restore promptly** when exiting immersive contexts.\n\n### Activity Rings\n\n11. **Activity rings are for Move, Exercise, and Stand goals.** Don't repurpose the ring metaphor for unrelated data.\n\n12. **Respect ring color conventions.** Red (Move), green (Exercise), blue (Stand) are strongly associated with Apple Fitness.\n\n13. **Use HealthKit APIs** for activity data rather than manual tracking.\n\n14. **Celebrate completions** with animation and haptics when rings close.\n\n## Reference Index\n\n| Reference | Topic | Key content |\n|---|---|---|\n| [progress-indicators.md](references\u002Fprogress-indicators.md) | Progress bars and spinners | Determinate, indeterminate, inline placement, duration |\n| [status-bars.md](references\u002Fstatus-bars.md) | iOS\u002FiPadOS status bar | System info, visibility, style, safe areas |\n| [activity-rings.md](references\u002Factivity-rings.md) | watchOS activity rings | Move\u002FExercise\u002FStand, HealthKit, fitness tracking, color |\n\n## Output Format\n\n1. **Indicator type recommendation** with rationale (determinate vs indeterminate).\n2. **Timing and animation guidance** -- duration thresholds, animation style, transitions.\n3. **Accessibility** -- VoiceOver progress announcements, live region updates.\n4. **Platform-specific behavior** across targeted platforms.\n\n## Questions to Ask\n\n1. Is the duration known or unknown?\n2. Which platforms?\n3. How long does the operation typically take?\n4. System-level or in-app indicator?\n\n## Related Skills\n\n- **hig-components-system** -- Widgets and complications displaying progress or status\n- **hig-inputs** -- Gestures triggering progress states (pull-to-refresh)\n- **hig-technologies** -- HealthKit for activity ring data; VoiceOver for progress announcements\n\n---\n\n*Built by [Raintree Technology](https:\u002F\u002Fraintree.technology) · [More developer tools](https:\u002F\u002Fraintree.technology)*\n\n## When to Use\nThis skill is applicable to execute the workflow or actions described in the overview.\n\n## Limitations\n- Use this skill only when the task clearly matches the scope described above.\n- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.\n- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.\n","","imported","https:\u002F\u002Fgithub.com\u002Fsickn33\u002Fantigravity-awesome-skills","user_system_seed","SkillOPIC",true,211,1611,"2026-05-16 13:21:59",{"id":8,"name":21,"slug":22,"icon":23,"description":24,"sort":25,"createdAt":26},"其他","other","mdi-page-next-outline","其他类型Skill",5,"2026-05-16 12:53:40",{"id":7,"name":28,"slug":29,"icon":30,"description":31,"moduleId":8,"sort":32,"skillCount":33,"createdAt":26},"职场发展","career","mdi-briefcase-outline","面试准备、简历优化、职业规划",4,575,[35],{"id":36,"skillId":4,"version":37,"fileName":38,"fileSize":39,"filePath":40,"fileHash":41,"manifest":42,"createdAt":19},"8c1582c6-b60f-41aa-98d3-2d6dc3acc7e6","1.0.0","hig-components-status.zip",10412,"uploads\u002Fskills\u002F43a52117-cd83-4540-bb5f-c7595198ed1a\u002Fhig-components-status.zip","28f76097cfe27c1635abb626c83e4a378b7b80dc5861fa99f8b7d5faf4627efa","[{\"path\":\"SKILL.md\",\"isDirectory\":false,\"size\":3763},{\"path\":\"references\u002Factivity-rings.md\",\"isDirectory\":false,\"size\":9159},{\"path\":\"references\u002Fprogress-indicators.md\",\"isDirectory\":false,\"size\":10831},{\"path\":\"references\u002Fstatus-bars.md\",\"isDirectory\":false,\"size\":3512}]",{"code":44,"message":45,"data":46},200,"success",{"items":47,"stats":48,"page":51},[],{"averageRating":49,"totalRatings":49,"ratingCounts":50},0,[49,49,49,49,49],{"limit":52,"offset":49,"hasMore":53,"nextOffset":52,"ratedOnly":16},15,false]