Components
Every published Android / Compose pattern, with the situation it selects for. The patterns cover Android phones and tablets. Android TV, Google TV, and Fire TV are out of scope. The table is generated from patterns.json.
| Component | Summary |
|---|---|
| Badge | Small indicator on an icon or control reporting a count or a status. Material's Badge and BadgedBox set no semantics, so a badge's text joins its host's name as a bare number and a dot badge says nothing at all; the badge carries its meaning in words. |
| Bottom App Bar | Bar along the bottom of a screen holding a few actions and an optional floating action button. Material's BottomAppBar reads the actions in order and the floating button last, as one group, and sets nothing else, so each action's name and keeping the bar off the content above are the caller's. |
| Bottom Sheet (Modal) | Overlay that rises from the bottom edge and blocks the content behind it. Most of the dismissal contract arrives with the component rather than the caller, and every part of it disappears under some configuration the caller controls. |
| Button (Basic) | Control that triggers an immediate action. Covers text, icon-only, floating, and action-chip presentations, which share one role and differ in where the accessible name comes from. |
| Button (Toggle) | Icon button that turns something on or off in place and keeps the same name in both states. Material's icon toggle buttons report a checked state, so the name says what the control turns on and the state says whether it is on; the standard toggle shows that state by color alone. |
| Card | Surface grouping related content, either static or opening something when tapped. Material's static Card keeps its contents together in traversal order; its clickable overload merges everything into one stop with no role, so the order of that announcement, its click label, and any secondary actions are the caller's. |
| Checkbox | Yes or no choice submitted with a form, independent of any other checkbox beside it. The control and its label form one accessibility node, and the row that owns the toggle owns the role and the touch target. |
| Checkbox (Group) | Several checkboxes that together answer one question, any number of them checked. Nothing on Android ties a label to a set of controls, and selectableGroup does nothing for checkboxes, so the set's name, its position information, and its one group-level error are all the caller's. |
| Checkbox (Tri-State) | Parent checkbox that checks or clears a set of child checkboxes and shows partially checked when only some of them are. Compose reports the third state as "Partially checked" without being asked; the parent's state has to be derived from its children rather than stored. |
| Chip (Filter) | Chip that turns a filter on or off for the content it sits above. Material's FilterChip reports a checkbox role and a selected state and drops its border when selected; naming the set of chips and announcing the changed results are the caller's. |
| Chip (Input) | Chip standing for a value the user entered, such as a recipient or a tag, that can be selected and removed. Material's InputChip is a single click target, and its trailing icon is content rather than a button, so removal is the caller's to build, as a remove button inside the chip plus a Remove action on it. |
| Content Shelf | Horizontally scrolling strip of tiles under a heading that says what the tiles have in common. A LazyRow reports that the user is in a list and nothing else, so the shelf's name, each tile's name, and every position announcement are the app's to supply. |
| Dialog (Alert) | Modal message that interrupts to ask for a decision or report something the user must acknowledge. Material's dialog window blocks the screen and closes on back and Escape, but announces itself only as a generic "Dialog", so the title has to be the first thing the user lands on. |
| Image | Picture or icon whose accessibility comes down to one decision about what it means. A meaningful image is named for what it conveys, a decorative one passes null and leaves the tree, and an empty string is not decorative. |
| Link (Standalone) | Link that stands on its own and opens a web page or another app. Compose has no link role and no Link composable, so a standalone link is a TextButton whose text names the destination; a text link's tap area is only as large as its letters. |
| Link (Inline) | Link inside a sentence of body text, built with LinkAnnotation. TalkBack reaches it through its Links menu rather than as a stop of its own, and Material draws nothing when a keyboard focuses it, so the link's text and its focused style are the caller's to get right. |
| List Item | A row in a vertical list. The row is one accessibility node rather than the several elements it looks like, so a second control inside it becomes a custom action rather than a nested target. |
| Menu | Pull-down list of commands opened from a button. Material's menu takes focus and closes on back and Escape on its own; its items carry no role, so each one's label has to stand on its own as a command. |
| Navigation Bar | Bar of three to five top-level destinations along the bottom of the screen. Each item reports Role.Tab, its selected state, and its position, and Material removes the icon's semantics whenever the label shows, which takes any badge with it. |
| Navigation Drawer (Modal) | Panel that slides over the screen holding the app's destinations, behind a scrim. Material's ModalNavigationDrawer names the panel and gives it a dismiss action and a scrim that closes it, but leaves the screen behind in the accessibility tree and does nothing with focus or keys, so containing TalkBack and the keyboard, Escape, and moving focus in and back are the caller's. |
| Progress Indicator | Bar or ring showing that work is under way, with or without a measure of how much is done. Material reports a value or an indeterminate state but names neither, so on its own the indicator says "45 percent" or "in progress" without saying of what, and nothing says when the work ends. |
| Radio Group | Exactly one choice from a mutually exclusive set. The group carries selectableGroup, which is what makes each option announce its position in the set, and each row carries the selection rather than the button. |
| Segmented Button | Row of two to five connected options, with exactly one selected or any number on at once. Material's single-choice segments report radio semantics and their position in the set; its multiple-choice segments report a checked state with no role and no position, so the caller adds both, and names the row either way. |
| Select | Field showing one chosen value that opens a list of the others. Material's ExposedDropdownMenuBox reports the field as a dropdown list and opens it from touch, TalkBack, and the keyboard, but its menu items report no selection, so marking the current option is the caller's. The component is still marked experimental, so the call site opts in. |
| Snackbar | Brief message confirming something that already happened, shown at the bottom of the screen without taking focus. SnackbarHost supplies the announcement, the dismiss action, and the time extension a user can ask for; a Snackbar drawn outside it gets none of them. |
| Snackbar with Action | Brief message carrying one action, such as Undo, shown without taking focus. Because focus never moves to it, its action is hard to reach from a keyboard and easy to miss with TalkBack, so the action must also be available somewhere else and the message must stay until dismissed. |
| Switch | Persistent on or off setting that takes effect immediately. The control and its label form one accessibility node, and the row that owns the toggle owns the role and the touch target. |
| Tabs | Row of tabs that switches between views of the same screen. Each tab reports Role.Tab, its selected state, and its position, and only the selected tab's content belongs in the tree. Unlike a navigation bar item, a tab keeps its icon's semantics. |
| Text Field | Single-line text entry whose accessible name has to come from the field's own label slot rather than a Text beside it. Supporting text and error messages are separate nodes the component does not attach, so both have to be associated deliberately. |
| Top App Bar | Bar across the top of a screen holding its title, a navigation control, and a few actions. Material's top app bars read those in order as one group, but none marks the title as a heading, so the heading, the navigation control's name, and keeping the bar off the content beneath are the caller's. |