「このクラス名は何にしよう」「カードの見た目を変えたら、別の場所まで変わってしまった」。Webページを作っていると、CSSの書き方だけでなく、名前や整理の仕方に迷うことがあります。

こうした問題を考えるときに参考になるのが、OOCSS・BEM・SMACSSです。ただし、3つとも同じ種類の命名規則というわけではありません。再利用の考え方、部品の構造と命名、CSSの役割の分類という違いがあります。

この記事では、それぞれの特徴を整理し、カードの実装例を使ってクラス名の付け方を説明します。既存のCSSを見直す手順も確認し、後から変更しやすいコードを目指しましょう。

目次

1.CSSの命名規則と設計手法は何が違う?

命名規則は、クラス名などをどのように付けるかを決めるルールです。一方、設計手法は、どこを共通化し、どの部品にどのスタイルを持たせ、変更の影響をどう管理するかという考え方を含みます。

名前をそろえるだけでは、CSSの重複や意図しない上書きがなくなるわけではありません。名前から役割がわかることと、実際の指定範囲が適切であることを、両方確認する必要があります。

手法主に整理するもの考える際の問い
OOCSS共通部分の再利用と、配置場所への依存同じ部品を別の場所でも使えるか
BEM部品・内部要素・バリエーションの関係と命名この要素はどの部品に属するか
SMACSSCSSルールの役割による分類この指定は基本設定・配置・部品・状態などのどれか

3つは、必ず一つだけを選ぶものではありません。例えば、部品の命名にはBEMを使い、CSSの整理にはSMACSSの分類を参考にする方法も考えられます。

ただし、組み合わせるほどよいという意味ではありません。まず困っていることを一つ挙げ、その問題を解決するために必要なルールから取り入れましょう。

2.OOCSS|共通部分を再利用しやすくする

OOCSSは、Object Oriented CSSの略です。基本となる考え方は、「構造と見た目を分けること」と「配置する場所と部品の内容を分けること」です。

例えば、ボタンの余白や配置は共通にし、用途によって配色を変える設計が考えられます。ページごとに似たボタンのCSSを書き直す前に、何が共通で、何が異なるのかを整理します。

構造と見た目を分ける

次の例では、ボタンの基本的な形をaction-buttonに持たせ、強調する配色をaction-button-primaryに分けています。クラス名は説明用の例であり、OOCSSで決められた固有の命名ではありません。

<button type=”button” class=”action-button action-button-primary”> 内容を確認する </button>

CSSでは、共通部分と配色を次のように分けられます。実際にクリックしたときの処理は、この例には含めていません。

.action-button { display: inline-flex; align-items: center; justify-content: center; padding: 0.75rem 1rem; border: 1px solid; border-radius: 0.5rem; font: inherit; } .action-button-primary { color: #ffffff; background-color: #1d4ed8; border-color: #1d4ed8; }

配置場所だけで部品の見た目を決めない

例えば、「サイドバー内のすべてのボタン」に配色を指定すると、同じボタンを本文に移した際に見た目が変わることがあります。部品自身のクラスで基本の見た目を指定すれば、場所への依存を減らせます。

一方、ページ内での配置や周囲との間隔は、親側のレイアウトが担当しても構いません。すべての指定を部品に詰め込むのではなく、部品自身の特徴と、置く場所の都合を分けて考えます。

共通化する際は、見た目が一時的に似ているだけなのか、今後も同じ役割として変更するのかを確認してください。用途が違う部品までまとめると、一方の変更がもう一方の制約になることがあります。

3.BEM|部品・内部要素・バリエーションを名前で表す

BEMでは、独立した部品をBlock、その内部の要素をElement、状態や種類の違いをModifierとして考えます。ここでは、Elementを「__」、Modifierを「–」で区切る書き方を使います。

BEMには命名の流儀が複数あるため、既存のプロジェクトでは採用済みの表記に合わせてください。同じ役割に異なる区切り方を混在させないことが大切です。

分類役割この記事の例
Block独立した部品study-card
Element部品に属する内部要素study-card__title
Modifier部品や内部要素のバリエーションstudy-card–featured

カードのHTMLで確認する

次の例では、学習内容を紹介するカードを一つのBlockとして扱います。タイトルと説明文は内部要素、強調表示はカードのバリエーションです。

<article class=”study-card study-card–featured”> <h2 class=”study-card__title”>HTMLの基礎</h2> <p class=”study-card__description”> 見出しと段落を使い、ページの構造を学びます。 </p> </article>

Modifierは、基本のクラスと一緒に付けています。study-card–featuredだけに置き換えると、study-cardに書いた共通の指定は、そのクラスを持たない要素には適用されません。

基本の見た目と変更部分をCSSに分ける

.study-card { padding: 1.25rem; color: #1e293b; background-color: #ffffff; border: 1px solid #cbd5e1; border-radius: 0.75rem; } .study-card__title { margin: 0 0 0.75rem; font-size: 1.25rem; } .study-card__description { margin: 0; line-height: 1.8; } .study-card–featured { background-color: #eff6ff; border-color: #2563eb; }

この例では、基本のカードを定義した後に、強調表示の背景色と枠線の色を指定しています。説明用の断片なので、試す場合はHTMLをページのbody内に、CSSを読み込んでいるスタイルシートに追加してください。

掲載例の実際のブラウザ表示は未確認です。既存ページに組み込む場合は、テーマや他のCSSによる上書きも含めて確認してください。

HTMLの階層をすべてクラス名につなげない

Elementの名前は、Blockへの所属を表します。HTMLの入れ子が増えたからといって、study-card__body__textのように、親子関係をすべて名前に含める必要はありません。

例えば、説明文を囲む要素を追加しても、説明文の役割が変わらなければstudy-card__descriptionを使い続けられます。HTMLの構造変更と、クラス名の変更を必要以上に結び付けないようにしましょう。

💡 あわせて読みたい関連記事

HTMLとCSSを別ファイルで管理する方法や、読み込み先の指定が曖昧な場合は、ファイル構成から確認すると実装を進めやすくなります。

Webページのファイル構成入門|HTML・CSS・JavaScriptの役割と相対パス 記事を読む →

4.SMACSS|CSSを役割ごとに整理する

SMACSSは、CSSルールを5つのカテゴリに分類する設計手法です。どの指定が何を担当しているかを整理し、変更する場所を探しやすくする考え方として利用できます。

カテゴリ主な役割例
Baseページ全体の基本設定bodyの文字設定、要素の初期スタイル
Layoutページの大きな配置本文とサイドバーの並び方
Module再利用する部品カード、ナビゲーション、ボタン
State特定の状態での見た目展開中、選択中、非表示
Themeテーマによる見た目の違い配色や背景の切り替え

分類したからといって、必ず5つのファイルを作る必要はありません。小さなページでは、一つのCSSファイル内をコメントで区切る方法もあります。

また、接頭辞として使われるl-やis-は、役割を読み取りやすくするための約束です。m-をすべての部品に付けることが、SMACSS共通の必須ルールというわけではありません。

状態の名前だけで、機能まで実装したことにはならない

例えばis-openというクラスは、開いている状態を表す名前として使えます。しかし、クラスを付けるだけで開閉処理やキーボード操作が実装されるわけではありません。

折りたたみ部品などを作る場合は、表示の切り替えに加え、操作に適したHTML要素や、必要な属性の更新も確認します。見た目の状態と、実際の機能・操作性を分けて考えましょう。

5.命名規則だけでは、CSSの干渉を防げない

BEMのように部品名をクラス名に含めると、名前の衝突を減らし、所属を読み取りやすくできます。ただし、そのクラスにブラウザが特別な保護を付けるわけではありません。

ページ全体に適用される指定や、より優先される指定があれば、BEMで書いた部品にも影響します。表示が変わったときは、クラス名だけでなく、実際に適用されたCSSを調べる必要があります。

クラス名の長さと詳細度は関係しない

CSSの詳細度は、名前の文字数ではなく、セレクターに含まれるID・クラス・要素などの種類と数から計算されます。.cardと.study-card__descriptionは、どちらも単独のクラスセレクターです。

一方、.page .study-card__descriptionのようにクラスを組み合わせると、単独のクラスとは詳細度が変わります。名前を長くすることと、セレクターを複雑にすることを混同しないようにしましょう。

上書きの原因を確認してから修正する

CSSの適用は、重要度、カスケードレイヤー、詳細度、記述順などのルールに基づいて決まります。「後ろに書けば必ず勝つ」「詳細度だけで決まる」という理解では、説明できない場合があります。

表示が意図と違う場合は、ブラウザの開発者ツールで対象要素を調べ、どの指定が採用されているか確認してください。原因を見ずに!importantを追加し続けると、後の変更を難しくする場合があります。

6.どの手法を選ぶ?規模よりも困りごとから考える

「小規模ならOOCSS、大規模ならBEM」と機械的に決める必要はありません。既存のルール、使っている技術、担当者が理解できること、変更の頻度などを踏まえて選びます。

現在の困りごと見直す方向
似た部品のCSSを何度も書いている共通部分と差分を整理する
クラス名から所属や役割がわからない部品単位の命名をそろえる
配置・部品・状態の指定が混在している役割ごとにCSSを分類する
既存CSSとの上書き競争が起きているセレクターと適用順序を調査する
人によって書き方が変わる短いルールと具体例を共有する

組み合わせる場合も、担当する範囲を決めます。例えば「部品名はBEM、ページの配置はl-で始める」と決めれば、それぞれの役割を説明できます。

同じ状態をis-activeと–activeの両方で表すなど、理由のない重複は避けましょう。別の目的で使い分けるなら、その違いをルールに残してください。

7.既存のCSSを見直すときの手順

既存サイトでは、クラス名を変更するとCSS以外にも影響する場合があります。JavaScript、テンプレート、自動テストなどが、その名前を参照している可能性があるためです。

最初から全ページを一度に変更せず、カードやボタンなど一つの部品を選び、利用箇所を確認してから進めましょう。

  1. 対象を選ぶ:変更する部品と、その部品を使うページを確認する。
  2. 参照を探す:HTML・CSS・JavaScript・テンプレート・テストを検索する。
  3. 役割を整理する:共通部分、バリエーション、配置側の指定を分ける。
  4. 名前を変更する:関連する参照をそろえて更新する。
  5. 表示と操作を確認する:通常時だけでなく、状態の変化や画面幅の違いも確認する。
  6. 不要な指定を整理する:未使用であることを確認してから削除する。

確認する画面と状態を先に決める

見た目を確認するときは、短い文章だけでなく、長い見出しや複数行の説明でも試してみてください。画面幅を変えた際の折り返しや、同じ部品を並べた場合も確認します。

操作できる部品では、キーボードでフォーカスした状態や、無効状態なども対象に含めます。クラス名の整理によって、フォーカス表示などの必要な見た目を失っていないか確かめましょう。

💡 あわせて読みたい関連記事

命名やコメントのルールは、CSS以外のコードを読みやすくする際にも役立ちます。チームで共有する開発ルールと、見直し方を紹介しています。

コードの可読性・保守性を高める6つの習慣|命名・コメント・開発ルールの基本 記事を読む →

8.CSSの命名と設計でよくある質問

BEMを使えば、CSSの干渉はなくなりますか?

なくなるわけではありません。所属がわかる名前を付けることで衝突や読み違いを減らせますが、グローバルな指定やカスケードの影響は受けます。表示が崩れたときは、適用されているルールを確認してください。

個人制作でも、ルールを決める必要がありますか?

後から変更する可能性があるなら、部品名やバリエーションの表し方をそろえておくと役立ちます。最初から大きな規約を作るより、「カードはこの名前にする」といった具体例から始めてみましょう。

CSSの入れ子は3階層までにするべきですか?

3階層という数字は、すべてのプロジェクトに共通する必須ルールではありません。深さだけでなく、どの範囲に適用されるか、HTMLの構造変更で壊れないか、上書きしにくくなっていないかを確認します。

ユーティリティクラスは使わない方がよいですか?

使うこと自体が問題なのではありません。部品を表すクラスと、単一の調整を行うクラスの役割を整理し、どの場面で使うかを決めます。すでに採用している設計やフレームワークがある場合は、その方針との整合性も確認してください。

既存のWordPressテーマのクラス名も変えるべきですか?

記事や見た目を整えるために、テーマが使っているクラス名を一律に変更する必要はありません。テーマやプラグインがその名前を前提としている場合もあるため、まず既存の仕組みを確認し、自作部分の命名から整理しましょう。

9.まずは一つの部品でルールを試す

CSSの設計では、手法の名前を覚えるだけでなく、何を共通化し、何を別に変更できるようにするかを考えることが大切です。OOCSS・BEM・SMACSSは、その判断を整理するための手がかりになります。

まずは一つのカードやボタンを選び、基本の形・内部要素・バリエーションを説明してみてください。名前から役割がわかり、変更する場所を見つけられることを確かめながら、必要な範囲へルールを広げていきましょう。

参考資料

Learning Tools

記事を検索したい方はここから!

辞書から探す

本文中で気になった概念やキーワードを、辞書ページで一覧から確認できます。

辞書を見る