ButtonGroup
Botões unidos numa só peça. O grupo repassa variante, cor, tamanho e desabilitado aos itens e só ajusta cantos e bordas; cada item continua sendo o Button do z-ui.
Botão dividido
Ação principal com um chevron ao lado para as alternativas. O chevron exige aria-label.
Paginação do documento
Grupo com texto no meio. A página atual vem do estado da tela.
Página 3 de 12
Vertical e largura total
Na vertical, os cantos se ajustam em cima e embaixo. Com fullWidth, os itens dividem a largura.
Props
| Prop | Tipo | Padrão | Descrição |
|---|---|---|---|
| orientation | "horizontal" | "vertical" | "horizontal" | Direção do grupo. |
| variant / color / size | props do Button | — | Repassados aos itens. O item pode sobrescrever. |
| disabled | boolean | — | Desabilita todos os itens que não definirem o próprio valor. |
| fullWidth | boolean | false | O grupo ocupa a largura e os itens dividem o espaço. |
| ButtonGroupItem | ButtonProps sem shape | — | Button do z-ui com os padrões do grupo. |
| ButtonGroupChevron | icon?, aria-label | — | Botão só de ícone para o botão dividido. ChevronDown por padrão. |
| ButtonGroupSeparator | orientation? | — | Divisória entre itens sólidos. |
| ButtonGroupText | span | — | Texto ou valor dentro do grupo. |