スタイリング
クラス、data属性、CSS変数を使用してleve-uiのパーツをスタイリングします。
leve-uiにはCSSが含まれておらず、独自にclassやstyleを出力することもありません。プレーンなCSS、CSS Modules、Tailwind CSS、Panda CSS、QwikのuseStyles$など、あらゆるスタイリング手法を使用できます。
クラスとその他の属性#
すべてのパーツは1つの要素をレンダリングし、そのすべてのpropsをその要素に渡します。class、style、idやその他の属性をパーツに直接追加できます:
<Tabs.Trigger value="account" class="tab">
Account
</Tabs.Trigger>
roleやaria-selectedなど、アクセシビリティパターンが必要とする属性はライブラリによって設定され、propsで上書きすることはできません。
パーツの属性#
すべてのパーツにはdata-leve-<component>-<part>属性があります(Rootにはdata-leve-<component>があります)。クラスを追加せずにパーツのスタイルを設定する場合、例えばleve-uiをラップするデザインシステムなどで使用します:
[data-leve-tabs-trigger] {
padding: 8px 12px;
}
属性名は各コンポーネントのAPIリファレンスに記載されています。
状態属性#
パーツの状態はdata属性として公開されます。これらを独自のクラスまたはパーツの属性と組み合わせます:
| 属性 | 値 | 使用箇所 |
|---|---|---|
data-state | open / closed, checked / unchecked / indeterminate, active / inactive, on / off, loading / complete / indeterminate, … | 状態を持つほとんどのパーツ |
data-disabled | 無効時に存在 | コントロールおよびアイテム |
data-orientation | horizontal / vertical | Tabs、Accordion、Radio Group、Separatorなど |
data-invalid | フィールドが無効な場合に存在 | Field内のフォームコントロール |
.switch-control[data-state='checked'] {
background: #009dfd;
}
.switch-control[data-disabled] {
opacity: 0.5;
cursor: not-allowed;
}
data-disabledなどのブール属性は、falseの場合完全に削除されるため、[data-disabled='true']ではなく[data-disabled]を使用してください。
各パーツの正確な値は、各コンポーネントのAPIリファレンスに記載されています。
子の状態に応じた親のスタイリング#
Qwikはサーバー上で子の前に親の属性をレンダリングするため、状態はその状態を保持するパーツ(およびその後にレンダリングされるパーツ)にのみ公開されます。例えば、Avatar.Rootにはdata-stateがなく、読み込み状態はAvatar.ImageおよびAvatar.Fallbackにあります。子の状態に応じて親のスタイルを設定するには:has()を使用します:
.avatar:has([data-leve-avatar-image][data-state='loaded']) {
outline: 2px solid #009dfd;
}
CSS変数#
一部のパーツは、CSS変数としてのみ意味を持つ値を公開します:
| 変数 | 設定先 | 値 |
|---|---|---|
--leve-progress-percent | Progress.Root | 範囲に対する割合としての値(例: 40%) |
--leve-meter-percent | Meter.Root | 範囲に対する割合としての値(例: 25%) |
.progress-indicator {
height: 100%;
width: var(--leve-progress-percent);
}
表示と非表示#
閉じられたCollapsibleのコンテンツや非アクティブなTabsパネルなど、非表示のパーツにはhidden属性が使用されます。CSSでそのようなパーツにdisplayを設定する場合は、非表示のままになるようルールを追加してください:
.tabs-content[hidden] {
display: none;
}
フォーカススタイル#
leve-uiはフォーカスのアウトラインを削除しません。キーボードフォーカスには:focus-visibleでスタイルを設定します:
.tab:focus-visible {
outline: 2px solid #009dfd;
outline-offset: 2px;
}