コンテンツにスキップ

構造ルール

コンポーネントのクラスセレクタ(Block / Element)の関係は次のルールに従います。

許可される構造

  • Block > Block
  • Block > Element

禁止される構造

  • Element > Block
  • Element > Element
  • 親 Block の SCSS 内で、> .child-block > .element のように子 Block 配下の Element まで直接指定する構造

例外

レイアウト目的ではない装飾・意味付けに限り、Element > Element を許可(例: .content > .paragraph > .emphasis)。

ネストの深さ

Block のネスト

  • HTML の Block > Block は設計上の深度上限がありません。孫以降という理由だけで移動・改名を求めず、末端 Block も許可します。
  • 各 Block は自分のスタイルを所有します。親 Block の SCSS は自身と直下の子 Block の配置を扱い、子の内部 Element まで指定しません。
  • SCSS の所有関係・ネスト診断は HTML Block の最大深度規則ではありません。markup tool の MAX_DEPTH_EXCEEDED(256)は実装の安全ガードであり、設計ルールではありません。

Element のネスト

  • Element 連鎖は装飾・意味付けの例外に限り許可
  • 深さの目安は最大 4 段(Block > Element > Element > Element > Element)

component のタグセレクタ推奨設定

SCSS は引き続き Stylelint で検査し、独自の重複ruleではなく標準の selector-max-type を component パスに限定して0にします。既存config / SpiraCSS rulesに次のoverrideを合わせてください。

overrides: [
{
files: ['src/components/**/*.scss'],
rules: { 'selector-max-type': 0 }
}
]

scope内の .body は許可し、> p は検出します。意図したpage / globalのタグ指定はcomponentパスの外(または明示的な案件の例外)に保ち、一律禁止で既存例外を壊さないでください。HTMLの構造や @scope / 子ファイル方針の変更ではありません。

階層構造の例

正しい構造(親 Block)

.search-form {
// Block (2 語)
> .field {
// Element (1 語)
}
> .actions-container {
// 子 Block (2 語)
// 配置だけを指定
}
}

間違った構造(親 Block)

.search-form {
> .actions-container {
> .button {
// ❌ 親が子 Block 配下の Element まで指定している
}
}
}

正しい構造(子 Block)

.actions-container {
// 1 つのコンポーネントとして扱う
> .button {
// Element (1 語)
}
}

コンポーネントは Block > (Block | Element) の繰り返しで表現されます。