コンテンツにスキップ

命名規則

SpiraCSS では、構造(Block / Element)Variant / State を明確に分離します。

Block / Element / Utility

種別命名ルール
Blockケバブケース 2 語(デフォルト).hero-container, .feature-list
Element1 語のみ.title, .body
Utilityu- 接頭辞.u-hidden, .u-sr-only

用語: 本ドキュメントでは「語」は命名セグメントを指します。ケバブケース(既定)の場合はハイフン区切りです(例: hero-container は 2 語)。

  • Block は 1 つの UI コンポーネントやセクション(意味のある塊)
  • Element は Block 内だけで意味を持つ要素(他の Block から単体では使わない)
  • Utility は構造(Block / Element)ではなく、単機能の補助クラス

注意: Element は 常に 1 語です。elementCase=camel/pascal でも内部大文字で語分割しません。

命名は意味が明確であることを最優先し、短さよりも可読性を優先します。