@k8ordo/ui

Toolbar

矢印キーで移動するボタンのまとまりです。エディタの書式のボタンのように、関連する操作を1か所に並べるときに使います。

インポート

ts
import { Toolbar } from '@k8ordo/ui';

使い方

Tabキーで止まるのは、ツールバーの中の1か所だけです。中は矢印キーで移動します。HomeとEndで端へ移り、無効な項目は飛ばします。外に出てから戻ると、最後にフォーカスのあった項目に戻ります。各項目はToolbar.ItemのrenderItemで作ります。受け取ったrefとtabIndex、onFocusをButtonやIconButtonに展開します。

tsx
<Toolbar.Root aria-label="Formatting">
  <Toolbar.Item
    renderItem={(props) => (
      <IconButton {...props} label="Copy">
        <CopyIcon size="sm" />
      </IconButton>
    )}
  />
  <Toolbar.Item
    renderItem={(props) => (
      <IconButton
        {...props}
        aria-pressed={isList}
        label="Bulleted list"
        onClick={toggleList}
      >
        <ListIcon size="sm" />
      </IconButton>
    )}
  />
  <Toolbar.Separator />
  <Toolbar.Item
    renderItem={(props) => (
      <Button {...props} size="sm">
        Save
      </Button>
    )}
  />
</Toolbar.Root>

トグル

押した状態はaria-pressedで渡します。押された項目は背景色が濃くなります。

縦並び

tsx
<Toolbar.Root aria-label="Formatting" orientation="vertical">
  {/* … */}
</Toolbar.Root>

Props

Toolbar.Root

children?
Type: ReactNode
Default: -
orientation?
Type: 'horizontal'|'vertical'
Default: 'horizontal'
ref?
Type: Ref<HTMLDivElement>
Default: -
PropTypeDefault
children?ReactNode-
orientation?'horizontal'|'vertical''horizontal'
ref?Ref<HTMLDivElement>-

継承する属性(内部で固定するものを除く): HTMLAttributes<HTMLDivElement>

Toolbar.Item

renderItem
Type: (props: ToolbarItemProps) => ReactElement
Default: -
PropTypeDefault
renderItem(props: ToolbarItemProps) => ReactElement-
k8ordo

Baselineに入った機能を、制限なく使うReactのライブラリ群。