platform-guideline 2 linked patterns checked
Apple HIG: Lists and tables
Documents list and table presentations for organized data, including grouped or hierarchical organization, selecting, adding, deleting, and moving items, row content, disclosure, swipe actions, editing mode, and platform-specific list behavior.
Read with a purpose
What this source can teach
Use this source to understand a platform convention and the setting it was designed for.
- Start with the original. Open the source and find the guidance or example relevant to your task.
- Trace the connection. Use the claim notes below to see how this site applies the source to specific patterns.
- Check the setting. Compare the source's platform, people, and constraints with your own decision.
Pattern Decisions This Source Supports
| Pattern | Supported decision | Required contract | Claim note |
|---|---|---|---|
| List view | Choose list view when each row is a compact object summary and users scan primarily by name, title, snippet, status, or recency. | Each row has one primary object identity that remains visible across selection, hover, focus, filtering, and responsive states. | Apple lists and tables guidance supports row organization, grouping, selection, adding, deleting, moving, disclosure, swipe actions, and platform list behavior. |
| Swipe action | Choose swipe action when the design problem is a horizontal item-level gesture that reveals or commits row-scoped commands. | Swipe action starts only from the intended row and horizontal axis; vertical scroll and pull-to-refresh win when movement is primarily vertical. | Supports list and table row actions, including deleting, moving, and swipe actions. |
Comparisons supported by this source
- List view vs table vs data grid vs details panel
Apple lists and tables guidance supports row-based organization, grouped data, selection, adding, deleting, moving, disclosure, and swipe actions.
Evidence Role
This source is treated as platform-guideline evidence. Its value comes from the specific claims and setting described above.
Publisher: Apple Developer. Last checked: .