API

css.marker / css.extended

★★★★☆ Stable

結合子を書かずに、親の状態に合わせて子孫のスタイルを変えます。

export type marker = (id: string, pseudo: string) => Marker;
export const marker: marker;

export type extended = <I extends string, P extends string>(id: I, pseudo: P) => Extended<I, P>;
export const extended: extended;

marker と extended はペアです:子要素はコンビネーターを使用せず、それらの間のパスを名付けずに祖先の状態に応答します。スタイルは 原子的 に保たれます。

生産準備完了。 これらのAPIは、現在のバージョンであるChrome、Edge、Safari、FirefoxがすべてサポートしているCSSコンテナスタイルクエリ(@container style())にコンパイルされます。

  • marker(id, pseudo) - 親要素にCSS変数のマーカーを設定します。
  • extended(id, pseudo) - マークヤーがアクティブなときに、子要素にスタイルを適用します。

引数

両方の呼び出しは同じ2つの引数を持ち、一致するとペアがリンクされます。

  • id - マークと拡張スタイルをリンクするユニークな識別子
  • pseudo - 疑似クラスの状態(例:':hover', ':focus', ':active')

例

Grand Container (Hover me)
Parent Container (Hover me too)
Child Element
TypeScript
import * as css from '@plumeria/core';

const animation = css.keyframes({
  '0%': {
    scale: 1.2,
  },
  '50%': {
    scale: 1.3,
  },
  '100%': {
    scale: 1.2,
  },
});

const styles = css.create({
  grand: {
    display: 'flex',
    flexDirection: 'column',
    gap: 15,
    alignItems: 'center',
    justifyContent: 'center',
    width: '100%',
    minHeight: 250,
    padding: 20,
    border: '2px dashed #c4c4c466',
    borderRadius: 12,
    transition: 'all 0.3s',
    ...css.marker('grand', ':hover'),
  },
  parent: {
    display: 'flex',
    flexDirection: 'column',
    gap: 10,
    alignItems: 'center',
    justifyContent: 'center',
    width: '80%',
    minHeight: 120,
    padding: 10,
    backgroundColor: '#f5f5f7',
    border: '2px solid #c4c4c444',
    borderRadius: 8,
    transition: 'all 0.3s',
    ...css.marker('parent', ':hover'),
  },
  child: {
    padding: '8px 16px',
    fontWeight: 'bold',
    color: '#86868b',
    background: '#e8e8ed',
    borderRadius: 6,
    transition: 'all 0.3s',
    [css.extended('grand', ':hover')]: {
      color: '#0066cc',
      background: '#e1f0ff',
    },
    [css.extended('parent', ':hover')]: {
      color: '#ffffff',
      background: '#ff9500',
      scale: 1.2,
      ':hover': {
        background: 'skyblue',
        animationName: animation,
        animationDuration: '1.2s',
        animationTimingFunction: 'ease-in-out',
        animationIterationCount: 'infinite',
      },
    },
  },
  description: {
    fontSize: '14px',
    color: '#86868b',
  },
});

const MarkerExtended = () => {
  return (
    <div sx={styles.grand}>
      <span sx={styles.description}>Grand Container (Hover me)</span>
      <div sx={styles.parent}>
        <span sx={styles.description}>Parent Container (Hover me too)</span>
        <div sx={styles.child}>Child Element</div>
      </div>
    </div>
  );
};

仕組み

内部の動き

**marker()**は、擬似クラスがアクティブになっているときにCSS変数を生成します:

.parent:hover {
  --xyuz5mma-ul-hover: 1;
}

**extended()**は子スタイルをコンテナクエリにラップします:

@container style(--xyuz5mma-ul-hover: 1) {
  .child { /* styles */ }
}

CSS変数は、マークアップのどこに配置されていても、すべての子要素が継承する信号です。

ESLint のルール

no-combinatorルールは、コンビナタール構文を許可しないことでこのパターンを強制します。

関数形式の疑似クラス

機能的なものを含む、任意の偽クラスが受け入れられます。

const styles = css.create({
  wrap: {
    ...css.marker('wrap', ':has(a:hover)'),
  },
  child: {
    [css.extended('wrap', ':has(a:hover)')]: { color: 'red' },
  },
});
.xwpr9f08:has(a:hover) {
  --xg204awn-wrap-has: 1;
}

@container style(--xg204awn-wrap-has: 1) {
  .xof70rr5:not(#\#) {
    color: red;
  }
}

:has() はマーカーの移動方向を反転させます:状態は子要素に属し、マーカーはそれを含む要素に配置され、スタイルはその要素の任意の子要素に配置されます。CSSでは同じ関係を .a:has(.b:hover) .c と表現し、3つの要素間のパスを名付けますが、マーカーはそれらのいずれにも名前を付けません。

:definedはすべての標準要素に一致するため、マーカーを永続的なシグナルに変換します。つまり、状態を伴わない単純な子孫関係です。

祖先の要素にマーカーを置く

extended スタイルは、マークされた要素の下にある要素に適用され、それ以外には適用されません。そのサブツリーの外に同じコンポーネントをレンダリングすると、スタイルは単に欠如します — エラーも警告もありません、なぜならクエリに一致するものがないからです。:hover のようなステートでは「ステートは一度もトリガーされなかった」と読み取られ、常に有効な :defined では、スタイルが消えたと読み取られます。

すべての結合子を表す

CSSPlumeria
.a .b — 状態上の子孫css.marker(id, ':hover') + css.extended
.a .b — 派生子、状態なしcss.marker(id, ':defined') + css.extended
.a > .b — 子css.marker(id, ':defined') + css.extended を子要素に
.a + .b, .a ~ .b — 兄弟css.marker(id, ':defined') + css.extended を親族に
.a:hover ~ .b — ステータスに反応する親族css.marker(id, ':has(a:hover)') + css.extended
.a:has(.b) .c — 子孫の状態、上下をまたいでバックアップするcss.marker(id, ':has(input:focus)') + css.extended

マーカーは、両方が共有する要素に適用されます。子供の場合、それは親であり、兄弟の場合、共通の親です。子供と兄弟を区別するものはセレクターではなく、あなたがextendedをどの要素に渡すかです。

CSSの列名はパスを名付けますが、Plumeriaの列名は付けません。markerとextendedはIDでリンクされているため、スタイルは任意の深さのすべての子要素に到達し、要素をさらに深くに移動してもペアが無効になることはありません。

まず marker / extended を取得してください。 その代替手段はセレクターキーです。これは、no-combinator が許可する、機能的な擬似クラス内のコンビナタであり、あなたが自分で指定した要素に付着しています:

const styles = css.create({
  cell: { ':is([data-row] > *)': { color: 'red' } },
});

それはパスを名付けているため、要素を移動するとそれを壊し、各宣言ごとにセレクター全体が繰り返されます。マーカーペアはパスを名付けておらず、idを共有するすべてのextendedは一つの@containerブロックに配置されます。

1つの関係の下のターゲットセレクターキーmarker / extended
194 B147 B
5281 B43 B
同じマークアップを Vite の本番ビルドで測り、それぞれの方法で増えた CSS のバイト数を比べました。

セレクターキーはエスケープハッチです。ターゲットがマークアップされている場合、書き込まないためスタイルを添付できません。

コンテナクエリのコスト

extendedはスタイルクエリにコンパイルされ、状態が変更されたときにエンジンがコンテナごとに再評価します。ヘッドレスChromiumでのクラストグルを測定したスタイル再計算、30回の実行のメディアン値:

要素シンプルなCSSセレクターキーmarker / extended
5000.009 ms0.006 ms0.012 ms
2,0000.008 ms0.007 ms0.012 ms
8,0000.005 ms0.005 ms0.012 ms
一回の測定で切り替えたのは、ホバーやフォーカスの対象になる一つの要素です。その要素までの経路にあるコンテナーだけが再評価されるため、ページ全体の要素が増えても時間はほぼ一定です。

コストはページ数とともに増加しません。すべてのアンカーを同時に切り替える場合、コストは増加します:8,000回の同時切り替えはセレクターキーの7msに対して26msかかります。これは形状ユーザーインターフェースが採用する形ではありませんが、もし探してみると違いが生じるのはそこです。

Edit on GitHub