id: button-group
kind: component
name: Button Group
description: A set of related buttons laid out together, sharing consistent spacing and alignment.

metadata:
  status: {status: stable}
  since: 1.1.0
  tags: [actions, layout]

refs:
  - to: button
    rel: composes

sections:
  - kind: guidelines
    for: all
    items:
      - statement: Limit to actions a user is choosing between, not an unrelated toolbar of controls.
        level: should
      - statement: Order buttons by how often each action is taken, most frequent first, unless a platform convention dictates otherwise.
        level: may
