Grupos de botões: Especificações
Os grupos de botões organizam botões e adicionam interações entre eles.
Variantes

- Grupo de botões padrão
- Grupo de botões conectado
| Variante | M3 | M3 Expressive |
|---|---|---|
| Grupo de botões padrão | -- | Disponível |
| Grupo de botões conectado | Disponível como botão segmentadoOs botões segmentados ajudam as pessoas a selecionar opções, alternar visualizações ou ordenar elementos. Observação: os botões segmentados ficaram obsoletos na atualização do M3 Expressive. Use um trilho de navegação em vez disso.Mais sobre botões segmentados | Disponível |
Configurações

Configurações para ambas as variantes de grupos de botões:
- Extra pequeno
- Pequeno
- Médio
- Grande
- Extra grande
- Seleção única e seleção múltipla
- Arredondada e quadrada
| Categoria | Configuração | M3 | M3 Expressive |
|---|---|---|---|
| Tamanho | XS, S, M, L, XL | -- | Disponível |
| Forma padrão | Arredondada, quadrada | -- | Disponível |
| Seleção | Seleção única, seleção múltipla, seleção obrigatória | Disponível como botão segmentadoOs botões segmentados ajudam as pessoas a selecionar opções, alternar visualizações ou ordenar elementos. Observação: os botões segmentados ficaram obsoletos na atualização do M3 Expressive. Use um trilho de navegação em vez disso.Mais sobre botões segmentados | Disponível |
Tokens e especificações
Os tokens dos grupos de botões padrão e conectados são organizados por tamanho. No menu do conjunto de tokens, selecione a variante e o tamanho. Consulte as páginas do botão e do botão de ícone para ver os tokens correspondentes. Saiba mais sobre tokens de design
Grupo de botões padrão - Tamanho - Extra pequeno
| Token | Valor |
|---|---|
| Button group xsmall container height | 32dp |
| Button group xsmall between space | 18dp |
Grupo de botões padrão - Tamanho - Pequeno
| Token | Valor |
|---|---|
| Button group small container height | 40dp |
| Button group small between space | 12dp |
Grupo de botões padrão - Tamanho - Médio
| Token | Valor |
|---|---|
| Button group medium container height | 56dp |
| Button group medium between space | 8dp |
Grupo de botões padrão - Tamanho - Grande
| Token | Valor |
|---|---|
| Button group large container height | 96dp |
| Button group large between space | 8dp |
Grupo de botões padrão - Tamanho - Extra grande
| Token | Valor |
|---|---|
| Button group xlarge container height | 136dp |
| Button group xlarge between space | 8dp |
Grupo de botões conectado - Tamanho - Extra pequeno
| Token | Valor |
|---|---|
| Button group connected xsmall container height | 32dp |
| Button group connected xsmall space between buttons | 2dp |
| Button group connected xsmall container shape | Circular |
| Button group connected xsmall inner corner size | 8dp |
| Button group connected xsmall pressed inner corner size | 4dp |
| Button group connected xsmall selected inner corner size | 50% |
Grupo de botões conectado - Tamanho - Pequeno
| Token | Valor |
|---|---|
| Button group connected small container height | 40dp |
| Button group connected small space between buttons | 2dp |
| Button group connected small container shape | Circular |
| Button group connected small inner corner size | 8dp |
| Button group connected small pressed inner corner size | 4dp |
| Button group connected small selected inner corner size | 50% |
Grupo de botões conectado - Tamanho - Médio
| Token | Valor |
|---|---|
| Button group connected medium container height | 56dp |
| Button group connected medium space between buttons | 2dp |
| Button group connected medium container shape | Circular |
| Button group connected medium inner corner size | 8dp |
| Button group connected medium pressed inner corner size | 4dp |
| Button group connected medium selected inner corner size | 50% |
Grupo de botões conectado - Tamanho - Grande
| Token | Valor |
|---|---|
| Button group connected large container height | 96dp |
| Button group connected large space between buttons | 2dp |
| Button group connected large container shape | Circular |
| Button group connected large inner corner size | 16dp |
| Button group connected large pressed inner corner size | 12dp |
| Button group connected large selected inner corner size | 50% |
Grupo de botões conectado - Tamanho - Extra grande
| Token | Valor |
|---|---|
| Button group connected xlarge container height | 136dp |
| Button group connected xlarge space between buttons | 2dp |
| Button group connected xlarge container shape | Circular |
| Button group connected xlarge inner corner size | 20dp |
| Button group connected xlarge pressed inner corner size | 16dp |
| Button group connected xlarge selected inner corner size | 50% |
Anatomia
Os grupos de botões são contêineres invisíveis: adicionam preenchimento entre os botões e modificam a forma deles. Por padrão, não contêm botões.

- Contêiner
Layouts comuns
Combine botões e botões de ícone conforme o cenário.

- Botões com rótulo
- Botões com rótulo e botões de ícone
- Botões de ícone extra pequenos
- Botões de ícone grandes
Cor
Os grupos de botões não têm propriedades de cor. Eles podem usar os estilos de cor do botão padrão ou do botão de alternância, como preenchido, tonal e contornado. Evite usar botões de ícone padrão ou botões de texto, pois eles não têm tratamento de contêiner.

- Preenchido
- Tonal
- Contornado
- Elevado
Seleção e ativação
Grupos de botões padrão adicionam interação entre botões adjacentes quando um botão é selecionado ou ativado.
Essa interação altera a largura, a forma e o preenchimento do botão selecionado ou ativado e, consequentemente, ajusta a largura dos botões imediatamente adjacentes.
Grupos de botões conectados não adicionam interação entre os botões quando um botão é selecionado ou ativado.
Eles afetam apenas a forma do botão que está sendo selecionado ou ativado.
Estados
Grupo de botões padrão
Quando um botão é pressionado, os grupos de botões padrão modificam a largura e a forma tanto desse botão quanto dos botões adjacentes.

- Habilitado
- Desabilitado
- Em hover
- Em foco
- Pressionado
Quando um botão de alternância é selecionado em um grupo de botões padrão, a forma do botão deve alternar entre quadrada e arredondada. A cor deve mudar de acordo com as especificações do botão.

- Habilitado
- Desabilitado
- Em hover
- Em foco
- Pressionado
Grupo de botões conectado
Os grupos de botões conectados apresentam mudanças de forma diferentes das mudanças dos grupos de botões padrão. Selecionar um botão não afeta os botões adjacentes.

Estados não selecionados do grupo de botões conectado:
- Habilitado
- Desabilitado
- Em hover
- Em foco
- Pressionado

Estados selecionados do grupo de botões conectado:
- Habilitado
- Em hover
- Em foco
- Pressionado
Medidas
Grupo de botões padrão
Os grupos de botões padrão aplicam preenchimento entre todos os botões. O valor do preenchimento varia conforme o tamanho do botão para garantir uma área-alvo acessível mínima de 48dp. Para mais detalhes sobre preenchimento, consulte as especificações do botão e as especificações do botão de ícone.

Preenchimento interno do grupo de botões padrão:
- XS: 18dp
- S: 12dp
- M: 8dp
- L: 8dp
- XL: 8dp
Grupo de botões conectado
Para todos os grupos de botões conectados, use preenchimento de 2dp. Isso proporciona consistência visual em escala.

O preenchimento interno do grupo de botões conectado arredondado é de 2dp em todos os tamanhos. A forma externa é totalmente arredondada; a forma interna permanece quadrada, com os seguintes raios de canto:
- XS: 4dp
- S: 8dp
- M: 8dp
- L: 16dp
- XL: 20dp

O preenchimento interno do grupo de botões conectado quadrado é de 2dp em todos os tamanhos. A forma externa tem os seguintes raios de canto:
- XS: 4dp
- S: 8dp
- M: 8dp
- L: 16dp
- XL: 20dp
Larguras mínimas
Os grupos de botões conectados extra pequenos e pequenos têm áreas-alvo de 48dp e uma largura mínima de 48dp.

- Extra pequeno
- Pequeno
Densidade
Os grupos de botões se adaptam à densidade dos botões internos. Mais sobre densidade
