命名規則
SpiraCSS では、構造(Block / Element) と Variant / State を明確に分離します。
Block / Element / Utility
| 種別 | 命名ルール | 例 |
|---|---|---|
| Block | ケバブケース 2 語(デフォルト) | .hero-container, .feature-list |
| Element | 1 語のみ | .title, .body |
| Utility | u- 接頭辞 | .u-hidden, .u-sr-only |
用語: 本ドキュメントでは「語」は命名セグメントを指します。ケバブケース(既定)の場合はハイフン区切りです(例: hero-container は 2 語)。
- Block は 1 つの UI コンポーネントやセクション(意味のある塊)
- Element は Block 内だけで意味を持つ要素(他の Block から単体では使わない)
- Utility は構造(Block / Element)ではなく、単機能の補助クラス
注意: Element は 常に 1 語です。elementCase=camel/pascal でも内部大文字で語分割しません。
命名は意味が明確であることを最優先し、短さよりも可読性を優先します。