構造ルール
コンポーネントのクラスセレクタ(Block / Element)の関係は次のルールに従います。
許可される構造
Block > BlockBlock > Element
禁止される構造
Element > BlockElement > 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) の繰り返しで表現されます。