ドキュメントを検索

スタイリング

クラス、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-stateopen / closed, checked / unchecked / indeterminate, active / inactive, on / off, loading / complete / indeterminate, …状態を持つほとんどのパーツ
data-disabled無効時に存在コントロールおよびアイテム
data-orientationhorizontal / verticalTabs、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-percentProgress.Root範囲に対する割合としての値(例: 40%)
--leve-meter-percentMeter.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;
}