Novi UI
コンポーネント一覧

Tooltip

ツールチップだけに情報を置かない。触れないと読めないため、操作に必須の情報は本文かラベルに書く。

デモ

使い分け

こうする

  • アイコンだけのボタンの名前や、短い補足に使う
  • delay で出るまでの間を調整する

こうしない

  • 操作に必要な情報を Tooltip にだけ書かない。タッチ端末では出ない
  • Tooltip の中にリンクやボタンを置かない。押せない

Props

Tooltip の props 一覧
名前型説明
contentReactNode
placementNoviPlacement
offsetnumber
delaynumber開くまでの遅延(ミリ秒)
isOpenboolean
defaultOpenboolean
onOpenChange(isOpen: boolean) => void
isDisabledboolean
childrenReactNode
classNamesClassNames<typeof tooltipSlots>

Slot

構成部位に data-slot が出力されます。 CSS の上書きやテストはこれを狙ってください。

  • root必須
  • arrow
  • content必須

アクセシビリティ

キーボード操作
キー動作
Tab(フォーカス)表示
Escape隠す
  • ホバーとフォーカスの両方で開く。触れないと読めないため、操作に必須の情報は置かない
  • キーボードだけで操作できます。フォーカスリングはコントラスト比 3:1 以上です。
  • 本文のコントラスト比は light / dark とも 4.5:1 以上を検査で保証しています。
  • prefers-reduced-motion が有効なときはアニメーションを行いません。