Makuco UI
ComponentesGeneral

Drag Handle

Alça de arrasto (`mk-drag-handle`) para reordenar itens, usada pelo `mk-list` com `reorderable`.

mk-drag-handle é o ponto por onde o usuário pega um item para reordená-lo. É um <button> com o ícone de seis pontos e não move nada sozinho: o componente que o usa, como o List com reorderable, controla o arrasto e o estado dragging.

Padrão

import { MkDragHandle } from '@db1/makuco-ui-react';

<MkDragHandle label="Mover Revisar PR" />
<mk-drag-handle label="Mover Revisar PR"></mk-drag-handle>

Estados

  • Repouso: ícone grip em --icon-low-emphasis.
  • Hover: ícone grip-vertical em --icon-high-emphasis e cursor grab.
  • dragging: ícone na cor da marca e cursor grabbing.
  • disabled: cor de desabilitado, sem foco e sem arrasto.

Props — mk-drag-handle

PropTipoPadrãoDescrição
labelstring—Nome acessível do botão. Diga o que será movido (ex.: "Mover Revisar PR"). Sem ele, usa "Arrastar para reordenar" no idioma da página.
descriptionstring—Dica lida depois do nome (ex.: como mover com o teclado). Vai para aria-description.
draggingbooleanfalseArrasto em andamento: cor de marca e cursor grabbing. Controlado pelo componente pai.
disabledbooleanfalseDesabilita a alça: sem foco, sem arrasto e com a cor de desabilitado.

Acessibilidade

  • <button type="button"> na ordem de Tab; label define o nome acessível e description vira aria-description.
  • A área de 32 × 32 px atende ao alvo mínimo da WCAG 2.5.8.

On this page