導入
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プラットフォーム機能のためにゼロから構築されています。