platform-guideline 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.

Open source

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.

Evidence Role

This source is treated as platform-guideline evidence. Use it to validate the decision rules above, not as a visual style reference.

Publisher: Apple Developer. Last checked: .