Acesso Rápido
Quando pressionado, um botão de ação flutuante pode exibir de três a seis ações relacionadas na forma de um acesso rápido.
Se mais de seis ações forem necessárias, algo diferente de um BAF deve ser usado para apresentá-las.
Ícone de fechamento customizado
Você pode fornecer um ícone alternativo para os estados de aberto e fechado usando as propriedades icon
e openIcon
do componente SpeedDialIcon
.
Os SpeedDialActions podem exibir dicas de forma fixadas para que os usuários não precisem manter as ações pressionadas para ver a dica nos dispositivos de toque.
Ícone de fechamento customizado
Você pode fornecer um ícone alternativo para os estados de aberto e fechado usando as propriedades icon
e openIcon
do componente SpeedDialIcon
.
<SpeedDial
ariaLabel="SpeedDial openIcon example"
className={classes.speedDial}
icon={<SpeedDialIcon openIcon={<EditIcon />} />}
>
{actions.map((action) => (
<SpeedDialAction
key={action.name}
icon={action.icon}
tooltipTitle={action.name}
/>
))}
</SpeedDial>
Dicas de ação fixadas
The SpeedDialActions tooltips can be displayed persistently so that users don't have to long-press to see the tooltip on touch devices.
It is enabled here across all devices for demo purposes, but in production it could use the isTouch
logic to conditionally set the prop.
Acessibilidade
ARIA
Required
- You should provide an
ariaLabel
for the speed dial component. - You should provide a
tooltipTitle
for each speed dial action.
Provided
- The Fab has
aria-haspopup
,aria-expanded
andaria-controls
attributes. - The speed dial actions container has
role="menu"
andaria-orientation
set according to the direction. - The speed dial actions have
role="menuitem"
, and anaria-describedby
attribute that references the associated tooltip.
Teclado
- The speed dial opens on focus.
- The Space and Enter keys trigger the selected speed dial action, and toggle the speed dial open state.
- The cursor keys move focus to the next or previous speed dial action. (Note that any cursor direction can be used initially to open the speed dial. This enables the expected behavior for the actual or perceived orientation of the speed dial, for example for a screen reader user who perceives the speed dial as a drop-down menu.)
- The Escape key closes the speed dial and, if a speed dial action was focused, returns focus to the Fab.