ドキュメントを検索

導入

leve-uiは、Qwik向けのヘッドレスでWAI-ARIA準拠のUIコンポーネントライブラリです。スタイルは自由に設定できます。

コンポーネントは、ロールやARIA属性、キーボード操作、フォーカス管理、controlledまたはuncontrolledな状態など、正しく実装するのが難しい部分を処理し、デザインのすべてのピクセルをあなたに委ねます。

leve-uiを選ぶ理由#

  • アクセシブル。すべてのコンポーネントは、キーボード操作やフォーカス管理を含め、WAI-ARIA Authoring Practices Guide(APG)に準拠しており、E2Eテストで検証されています。適切な場所にはネイティブのHTML要素が使用されています。
  • スタイルなし。コンポーネントはCSSを提供しません。各DOM要素は独立したパーツとなっており、クラスまたはライブラリが出力するdata-*属性でスタイルを適用できます。
  • 使うものだけインストール。すべてのコンポーネントが個別のパッケージです。利便性のために@leve-ui/coreがそれらすべてをバンドルしています。
  • QwikとWeb標準向けに構築。コンポーネントはcomponent$で記述され、サーバー上でレンダリングされ、ハイドレーションなしでレジュームし、ブラウザネイティブのトップレイヤー(<dialog>およびPopover API)を使用してオーバーレイを適切な場所にレンダリングします。
  • ネイティブフォームに対応。フォームコントロールはFieldと統合してラベル、説明、エラーの自動関連付けを行い、ネイティブな<form>の送信に参加します。

コンポーネントの構成#

コンポーネントはパーツの集まりで構成され、DOM要素1つにつき1つのパーツが対応します。パーツは自身で組み立てます。

<Switch.Root>
  <Switch.Label>Airplane mode</Switch.Label>
  <Switch.Control>
    <Switch.Thumb />
  </Switch.Control>
</Switch.Root>

各パーツは、レンダリングする要素の属性(class、style、id、aria-*、イベントハンドラーなど)を受け入れます。ライブラリは、パターンに必要な属性(たとえばrole="switch"やaria-checked)やスタイリング用のdata属性(たとえばdata-state="checked")を追加します。

ステータス#

leve-uiは0.xシリーズです。1.0まではマイナーリリース(0.1 → 0.2)で破壊的変更が発生する可能性があり、それらは各パッケージの更新履歴およびGitHub Releasesに記載されます。leve-uiはQwik 1.xをサポートしています。

インスピレーション#

合成可能なパーツ、data-stateスタイリングフック、ポリモーフィックなas propsといったコンポーネントのAPI設計は、Ark UI、Base UI、Radix UIからインスピレーションを得ており、Qwikの再開可能性(resumability)とネイティブWebプラットフォーム機能のためにゼロから構築されています。

次のステップ#

  • はじめに: leve-uiをインストールして最初のコンポーネントをレンダリングします。
  • スタイリング: クラス、data属性、CSS変数を使用してパーツをスタイリングします。
  • コンポーネント: すべてのコンポーネントを閲覧します。