---
title: クラス命名規則（BEM）
sidebar:
  label: クラス命名規則
description: BEM 記法によるクラス命名規則、状態の表し方、クラスセレクタを中心にしたセレクタ・属性の使い方
---

## BEM 記法

クラス名は BEM（Block Element Modifier）記法で記述し、命名の予測可能性と再利用性を高めます。

単語間はハイフン（-）でつなぎ、ブロック名とエレメント名はアンダースコア 2 つ（\_\_）、モディファイアはハイフン 2 つ（--）でつなぎます。

例：`.block-name__element--large`

参考：[BEM 公式サイト](https://en.bem.info/)

:::note[キャメルケースの使用]
プロジェクト内で統一されていれば、キャメルケースで記述しても構いません。Stylelint を使うプロジェクトでは、`selector-class-pattern` ルールをキャメルケースに合わせて変更してください。
:::

## モディファイア

モディファイアは、ブロックやエレメントの見た目やふるまいの違いを表します。

- **見た目**: サイズやテーマの違い（`xs`、`primary` など）
- **ふるまい**: 表示位置や動作の違い（`left`、`sticky` など）

```html
<!-- サイズやテーマを表す例 -->
<a class="button button--xs button--primary" href="/contact/">
  小さいサイズ・プライマリカラーのボタン
</a>

<!-- ふるまいを表す例 -->
<div class="tooltip tooltip--left">左方向に表示されるツールチップ</div>
```

## 状態の表し方

選択中・開閉・無効などの状態は、次の優先順で表します。上にあるものほど、HTML の意味とスタイルが一致し、支援技術にも状態が伝わります。

1. **擬似クラス**: `:disabled`、`:checked`、`:focus-visible` など
2. **ARIA 属性**: `[aria-current="page"]`、`[aria-selected="true"]`、`[aria-expanded="true"]` など
3. **JavaScript が切り替える `data-*` 属性**: ARIA 属性で表せない状態（`[data-state="loading"]` など）
4. **モディファイア**: 上のどれでも表せない場合

```html
<!-- ✅ 良い例：ARIA 属性で状態を表す -->
<button class="tab__item" role="tab" aria-selected="true">選択中のタブ</button>

<!-- ❌ 悪い例：状態をモディファイアだけで表す -->
<li class="tab__item tab__item--current">選択中のタブ</li>
```

```css
.tab__item[aria-selected="true"] {
  border-bottom-color: var(--color-primary);
}
```

## セレクタの使い方

スタイリングにはクラスセレクタ（`.class-name`）を使います。リセット・ベーススタイルを除き、ID セレクタや要素セレクタは避け、影響範囲を明確にします。

原則としてすべての要素にクラスを付与します。クラスを付けずに子セレクタ・子孫セレクタで要素を指定すると、構造を変えたときに意図しない要素にスタイルが当たるためです。

ただし、次の場合は要素セレクタを使って構いません。

- **CMS の本文エリア**: WordPress の投稿本文など、出力される HTML にクラスを付けられない場合（`.post-content h2` など）
- **帰属が明確な単純な子要素**: リストの `li` など、ブロックの直下にあり、どのコンポーネントに属するかが明らかな場合

`id` 属性はスタイルシートの目的では指定しないでください。
`data-*` 属性は、JavaScript で状態を切り替える場合（[状態の表し方](#状態の表し方)）やテーマの切り替えに使います。見た目のバリエーションを表すだけなら、`data-*` 属性ではなくモディファイアを使ってください。

## 省略形

クラス名はできる限り省略せず、意味が明確な名前を付けてください。

| ❌ 悪い例 | ✅ 良い例 |
| :-------- | :-------- |
| ttl       | title     |
| btn       | button    |
| txt       | text      |

## 命名規則の例外

JavaScript ライブラリが付与するクラスなど、命名規則に当てはまらないセレクタにスタイルを当てる必要がある場合は、Stylelint の設定ファイルで `selector-class-pattern` を変更するか、該当箇所でのみルールを無効化してください。

```css
/* stylelint-disable-next-line selector-class-pattern */
.swiper-slide-active {
  /* declaration */
}
```

## Tailwind CSS との併用

Tailwind CSS を使用する場合も BEM 記法の原則は維持します。併用方針は [Tailwind CSS](/frontend/css/tailwind#bem-との併用) を参照してください。
