ガイド
セレクターのルール
疑似クラス、疑似要素、クエリをどう入れ子にできるか、そしてその理由。
ネスト
スタイルの中では、次の向きに一段だけセレクターを入れ子にできます。
@mediaや@containerの中に疑似セレクターを書けます。- 疑似セレクターの中にクエリーは書けません。クエリーの中に別のクエリーを置くこともできません。
- 疑似セレクターの中に別の疑似セレクターを置く場合は、
':hover::before'のように一つのキーにまとめます。
import * as css from '@plumeria/core';
const styles = css.create({
list: {
'@media (max-width: 768px)': {
':hover': {
listStyleType: 'none',
},
},
},
});StyleX は各プロパティの値の中に疑似クラスのキーを書きます。Plumeria では疑似セレクターをキーにして、その中にプロパティと値を書きます。
import * as stylex from '@stylexjs/stylex';
const styles = stylex.create({
button: {
backgroundColor: {
default: 'lightblue',
':hover': 'blue',
},
},
});import * as css from '@plumeria/core';
const styles = css.create({
button: {
backgroundColor: 'lightblue',
':hover': {
backgroundColor: 'blue',
},
},
});次の書き方はビルドエラーになります。
import * as css from '@plumeria/core';
const styles = css.create({
list: {
':hover': {
'@media (max-width: 768px)': {
background: 'skyblue',
},
},
},
});結合子
:has() などの関数形式の疑似クラスの引数以外では、キーに結合子(>、+、~、空白)を使えません。親の状態に合わせて子を変えるには marker と extended を使います。
@plumeria/eslint-plugin の no-invalid-selector と no-combinator がこれらの問題を報告します。
関数形式の疑似クラス
関数形式の疑似クラスの内側に、同じ名前の疑似クラスは書けません。間に別の疑似クラスがあっても同じです。名前が違えば ':is(:where(:not(:has(.a))))' のように入れ子にできます。例外は :not() です。':not(:not(.a), .b)' のように平らに書き換えられない場合があるため、同じ名前でも使えます。
':where(:where(.a, .b), .c)'
':where(.a, .b, .c)'
':is(:where(:is(.a)))'この規則に反するキーがあるとビルドは止まります。例の一行目のように内側の呼び出しが引数一つを占める場合は、no-invalid-selector が入れ子を外す修正を提案します。ほかの形では一致する要素が変わるため、手で直します。
キー内のかっこは最大16段です。引用符は角括弧か丸括弧の中で文字列を囲むために使います。深すぎるかっこや ':hover":is(.x)' のように余った引用符は、ビルドエラーになり、no-invalid-selector でも報告されます。
向きを 1 つにする理由
同じ CSS ルールに対する書き方を一つにそろえるためです。CSS では @media (…) { .a:hover { … } } のようにクエリーの中にセレクターを置くので、スタイルのキーもその順に書きます。
逆順も許すと、同じルールに二つの書き方ができ、型もすべての疑似セレクターとクエリーを再帰的に調べる必要が出ます。一方向に一段だけにすると、型が単純になり、補完の候補が正確になり、プロジェクト内の書き方もそろいます。