NAOQ Design Note

デザインとコードの学習ノート

コンポーネントの命名規則とは?役割で名前を付けるルールと決め方

コンポーネントの命名規則とは?役割で名前を付けるルールと決め方

PR記事内に広告が含まれています。

デザインファイルの中に「ボタン」「btn2」「赤いボタン」「ボタン(新)」のような名前の部品が混ざっていて、どれを使えばいいのか分からなくなったことはありませんか。

部品が増えるほど、名前の付け方がそろっていないことが、探しにくさや作り直しの原因になります。

この記事では、コンポーネントの命名規則とは何か、見た目ではなく役割で名前を付ける理由、分類・状態・サイズの書き方、Figmaや開発側との名前の合わせ方を、見本を使って初心者向けに解説します。

この記事の見本は、サイトの配色ではなく、架空のサービスの配色(青系)で描いています。見本の部品は押しても動きません。

コンポーネントの命名規則の基本

まずは、コンポーネントの命名規則とは何か、なぜ名前の付け方をそろえる必要があるのかを押さえましょう。

コンポーネントの命名規則とは

コンポーネントの命名規則とは、コンポーネントに付ける名前を、作る人の好みに任せず、チームで決めた共通のルールに沿って付けることです。

コンポーネントとは、ボタンや入力欄、カードのように、画面の中で何度も使い回すUIの部品のことです。

部品は一度作ったら終わりではなく、あとから探して使い、直し、増やしていくものなので、名前は「あとで自分やほかの人が見つけるための目印」になります。

命名規則として決めることは、大きく分けて「何を基準に名づけるか」「どの順番で並べるか」「どう区切るか」「状態やサイズをどう書くか」の4つです。

名前がそろっていないと起きること

名前の付け方がバラバラだと、同じ役割の部品が別々の名前で重複して作られ、どれが正しいのか分からなくなります。

名前で検索しても見つからないので、似た部品をもう一度作ってしまい、さらに部品が増えるという悪循環が起きやすいためです。

同じボタンの部品一覧を、名前の付け方だけ変えて比べてみましょう。

◇ ボタン
◇ btn2
◇ 赤いボタン
◇ ボタン(新)
◇ Button copy
◇ 小さいボタン_最終
NG:名前の付け方がバラバラで、どれが何のボタンか分からない
◇ Button/Primary/Medium
◇ Button/Primary/Small
◇ Button/Secondary/Medium
◇ Button/Secondary/Small
◇ Button/Danger/Medium
◇ Button/Danger/Small
OK:「種類/役割/サイズ」の順に同じルールで名づけている

NGの見本では、日本語と英語、番号、「新」「最終」のような作業中のメモが混ざっていて、同じ役割のボタンが何個あるのかも分かりません。

OKの見本では、すべての名前が「種類/役割/サイズ」の順に並んでいるので、名前を見るだけでどのボタンか分かり、足りない組み合わせにも気づけます。

見た目ではなく役割で名づける

コンポーネントの名前は、「青いボタン」「大きい角丸のカード」のような見た目ではなく、「メインの操作用」「注意が必要な操作用」のような役割で付けるのが基本です。

見た目はブランドカラーの変更やリニューアルで変わることがありますが、役割は変わりにくいためです。

たとえば「青ボタン」と名づけた部品の色をあとから緑に変えると、名前と見た目が食い違い、名前を全部付け直すか、食い違ったまま使い続けることになります。

部品の名前は、デザイナー・開発者・ディレクターがやりとりするときの共通の呼び名にもなります。「このボタンをオレンジに変えたい」という話が出たとき、名前が「青ボタン」だと話がかみ合わなくなりますが、「Primary(いちばん押してほしいボタン)」なら色が変わっても同じ部品を指せるので、チームの全員が迷わずに作業を進められます。

◇ 青ボタン

申し込む
NG:色を緑に変えたのに、名前は「青ボタン」のまま

◇ Button/Primary

申し込む
OK:役割で名づけたので、色が変わっても名前はそのまま使える

NGの見本では、名前から「青いボタン」を探した人が、緑のボタンにたどり着けません。

OKの見本の「Primary(プライマリー)」は「いちばん押してほしい主要な操作」という役割を表す名前なので、色が青でも緑でも意味が通ります。

役割の名前としては、主要な操作の「Primary」、補助的な操作の「Secondary(セカンダリー)」、削除のように注意が必要な操作の「Danger(デンジャー)」などがよく使われます。

ボタンの種類ごとの色の決め方は、リンクやボタンの色の決め方で解説しています。

コンポーネントの名前の付け方

ここからは、実際にコンポーネントの命名規則を決めるときの手順を見ていきます。

「大きい分類から順に並べる」「区切り方を決める」「状態とサイズの書き方をそろえる」「開発側と名前を合わせる」の4つがポイントです。

大きい分類から小さい分類へ順に並べる

名前は、「部品の種類→役割→サイズ→状態」のように、大きい分類から小さい分類へ順に並べます。

住所を「都道府県→市区町村→番地」の順に書くと場所を絞り込みやすいのと同じで、名前の先頭が同じ部品同士が自然に並び、探しやすくなるためです。

ボタンを例にすると、次のような並びになります。

順番決めることボタンでの例
1部品の種類Button(ボタン)
2役割Primary(主要)/Secondary(補助)/Danger(注意)
3サイズSmall/Medium/Large
4状態Default(通常)/Hover(マウスを重ねたとき)/Disabled(押せないとき)

この順に並べると、「Button/Primary/Medium/Hover」のような名前になります。

すべての部品で4段階を使う必要はなく、サイズが1種類しかない部品ならサイズの段は省いてかまいません。

大切なのは段の数ではなく、同じ段には同じ種類の情報を入れることです。

Figmaではスラッシュで区切って分類する

デザインツールのFigmaでは、名前の区切りにスラッシュ(/)を使うと、部品を分類ごとにまとめて扱えます。

パソコンのフォルダが「書類/2026年/請求書」のように階層になっているのと同じで、Figmaはスラッシュの前を大きな分類、後ろを細かい分類として扱います。

Figmaの公式ヘルプでは、Component/State(部品/状態)やIcon/Name(アイコン/名前)のように、スラッシュで区切る命名をすすめています(Name and organize components – Figma Learn(英語))。

同じヘルプでは、たとえば「UI/Button/Active」「UI/Button/Hover」「UI/Button/Inactive」のように先頭が共通する部品は、インスタンスを別の部品に入れ替えるメニューの中でまとめて表示される、と説明されています。

インスタンスとは、元になる部品から作って画面に置いた「分身」のことで、元の部品を直すと、置いてあるインスタンスにも変更が反映されます(詳しくはFigmaのコンポーネントとは?で解説しています)。

区切りの記号をスラッシュに統一しておけば、Figmaを使わない場面でも「どこまでが分類で、どこからが細かい違いか」がひと目で分かります。

なお、Figmaには状態やサイズの違いを1つの部品にまとめる「バリアント」という機能もあり、これを使うと状態やサイズは名前ではなく、部品の設定項目として切り替えられるようになります。1つのボタンに「役割」や「サイズ」の切り替えスイッチが付くようなイメージです(作り方はFigmaのバリアントとは?で解説しています)。

その場合も、設定項目の名前と値(「State」と「Hover」など)の書き方は、この記事で紹介するルールに合わせてそろえておきましょう。

状態とサイズの書き方をそろえる

状態やサイズを表す言葉は、使う単語・言語・大文字と小文字の使い方まで、あらかじめ1つに決めておきます。

「Small」と「S」と「小」が混ざっていると、人によって探す言葉が変わり、同じ意味なのに別の部品のように見えてしまうためです。

◇ Button/Primary/S
◇ Button/primary/Large
◇ Input/通常
◇ Input/error
◇ Checkbox/On
◇ Checkbox/選択済み
NG:略語・日本語・小文字が混ざり、同じ意味の言葉が何通りもある
◇ Button/Primary/Small
◇ Button/Primary/Large
◇ Input/Default
◇ Input/Error
◇ Checkbox/Selected
◇ Checkbox/Unselected
OK:英語・先頭だけ大文字・省略しない、と書き方を統一

NGの見本では、チェックボックスの「On」と「選択済み」が同じ意味なのか、別の状態なのかが名前から判断できません。

OKの見本では、状態を表す言葉を「Default」「Error」「Selected」のように1つずつ決めているので、どの部品でも同じ言葉で探せます。

決めた言葉は、次のような一覧表にしてチームで共有しておくと、新しい部品を作るときに迷いません。

意味使う言葉使わない言葉
通常の状態DefaultNormal、通常、Base
押せない状態DisabledInactive、Off、グレー
選ばれている状態SelectedOn、Checked、選択済み
サイズSmall/Medium/LargeS/M/L、小/中/大

表の言葉はあくまで一例で、どの言葉を選ぶかよりも、1つに決めて全員が同じ言葉を使うことのほうが大切です。

開発側と名前を合わせる

デザインの部品名は、できるだけ開発者がコードの中で使う名前と合わせておきましょう(開発者へのデザインの渡し方は、デザイナーと開発者の連携とは?で解説しています)。

Webサイトやアプリを作るときは、デザインの部品とほぼ同じ単位で、コードの中にも部品(プログラミングでのコンポーネント)が作られることが多いためです。

デザインでは「メインボタン」、コードでは「Button primary」、会議では「青いやつ」と呼び方が3つあると、伝え間違いや確認の手間が増えます。

反対に名前がそろっていれば、「Button/Primaryのホバーの色を変えたい」と伝えるだけで、デザイナーも開発者も同じ部品を思い浮かべられます。

ここからは、コーディングする人向けの補足です。デザインだけを担当する人は、読み飛ばして「実践のポイント」へ進んでもかまいません。

CSS(Webページの見た目を指定する言語)のクラス名にも命名ルールがあり、よく知られているものに「BEM(ベム)」があります。BEMはBlock(部品)・Element(部品の中の要素)・Modifier(種類や状態の違い)の頭文字で、名前をこの3つに分けて付ける考え方です。

BEMでは、部品の名前に--(ハイフン2つ)でつないで種類や状態の違いを表すので、次のようにデザインの部品名とほぼ1対1で対応させられます。

<!-- デザインの「Button/Primary」にあたるボタン -->
<button class="button button--primary">申し込む</button>

<!-- デザインの「Button/Secondary」にあたるボタン -->
<button class="button button--secondary">資料を見る</button>

デザインツールだけで作る人は、「部品の名前を決めるときは、開発者に一度見てもらう」という手順だけ覚えておけば十分です。

プログラミングでのコンポーネントの考え方は、React入門 #05で紹介しています。

実践のポイント

コンポーネントの命名規則で陥りやすい失敗と、よくある疑問をまとめます。

注意点・よくある間違い

  • 「赤ボタン」「大きいカード」のように、見た目で名前を付けてしまうことがあります。
    デザインを変えたときに名前と実態がずれるので、役割で名づけましょう。
  • 「Button2」「ボタン(新)」「最終版」のような番号や作業メモを名前に入れてしまうことがあります。
    どれが正しいのか分からなくなるので、不要になった部品は消すか、使わない場所に移しましょう。
  • ルールを決めたあと、新しい部品にだけ適用して、以前からある部品の名前を直さないことがあります。
    新旧のルールが混ざると結局探しにくいままなので、決めた時点で既存の部品もまとめて付け直しましょう。
  • 自分だけが分かる略語(「PrmBtn」「Lg」など)を使ってしまうことがあります。
    初めて見た人でも読めるよう、省略しない言葉を使いましょう。

よくある質問

  • Q. 名前は英語と日本語のどちらで付けるべき?
    A. どちらでもかまいませんが、1つのファイルの中ではどちらかに統一しましょう。
    開発者とやりとりする場合は、コードの名前と合わせやすい英語を選ぶことが多いです。
    英語にする場合も、チームで意味が伝わる簡単な単語を選びましょう。
  • Q. 一人で作っている小さなサイトでも命名規則は必要?
    A. 決めておくと役に立ちます。
    数か月後に見返す自分は、ほぼ「別の人」と同じで、作ったときの意図を覚えていないことが多いためです。
    「btn2_final」「btn2_final2」のような名前が並んで、どれが最新か分からなくなるのを、最初のルールが防いでくれます。
    最初は「種類/役割」の2段階だけでも十分です。
  • Q. 作ったあとで名前を変えても大丈夫?
    A. 変えてかまいませんが、開発側がすでにその名前を使っている場合は、変える前に知らせましょう。
    デザインだけ名前が変わると、デザインとコードの対応が分からなくなるためです。

まとめ

コンポーネントの命名規則とは、部品の名前を共通のルールで付けることで、見た目ではなく役割で名づけると、デザインが変わっても名前が使い続けられます。

名前は「種類/役割/サイズ/状態」のように大きい分類から並べ、状態やサイズの言葉を1つに決め、開発側の名前ともそろえることがポイントです。

まずは手元のデザインファイルを開き、ボタンの部品だけでも「Button/役割」の形に名前を付け直してみてください。