NAOQ Design Note

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

デザイナーと開発者の連携とは?デザインデータの渡し方と伝えること

デザイナーと開発者の連携とは?デザインデータの渡し方と伝えること

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

デザインを渡して開発者に実装(コードを書いて、実際に見たり操作したりできる画面にすること)してもらったら、ボタンの色や余白が微妙に違っていたり、エラーのときの見た目が作られていなかったりして、何度もやり直しになったことはありませんか。

その原因の多くは、デザイナーと開発者のあいだで、データの渡し方や伝える内容が足りていないことにあります。

この記事では、デザイナーと開発者の連携とは何か、デザインデータの渡し方、FigmaのDev Modeでできること、名前や状態・例外ケースの伝え方を、見本を使って初心者向けに解説します。

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

デザイナーと開発者の連携の基本

まずは、デザイナーと開発者の連携とは何を指すのか、うまくいかないと何が起きるのかを押さえましょう。

デザイナーと開発者の連携とは

デザイナーと開発者の連携とは、デザイナーが作った画面のデザインを、開発者が意図どおりにWebサイトやアプリとして形にできるよう、情報を受け渡し、確認し合うことです。

デザインを開発者に引き渡す作業は、英語で「引き渡し」を意味する「ハンドオフ(handoff)」と呼ばれることもあります。

ただし連携は、完成したデザインを一度渡して終わりではありません。

作り始める前の相談、渡すときの説明、実装されたあとの確認まで、何度もやりとりを重ねる作業だと考えましょう。

連携がうまくいかないと起きること

連携がうまくいかないと、デザインと実際の画面がずれたり、確認と修正の往復が増えたりします。

デザイナーにとっては当たり前のことでも、デザインデータに書かれていなければ、開発者には伝わらないためです。

  • 数値のずれ
    画像だけを渡すと、開発者は色や余白を目で見て推測するしかなく、少しずつずれていきます。
  • 状態の作り忘れ
    通常の見た目しか渡していないと、マウスを重ねたとき・押せないとき・エラーのときの見た目を、開発者がその場で決めることになります。
  • 呼び方の食い違い
    同じ部品をデザイナーと開発者が違う名前で呼んでいると、「どの部品の話か」の確認だけで時間がかかります。

この記事では、これらを防ぐための「渡し方」と「伝えること」を順に見ていきます。

デザインデータの渡し方

ここでは、デザインツールFigmaを使っている場合を例に、デザインデータの渡し方を見ていきます。

画像ではなくデザインファイルを共有する

デザインは、書き出した画像ではなく、デザインファイルそのものを開発者と共有するのが基本です。

デザインファイルなら、開発者が要素を選ぶだけで色・文字サイズ・余白などの正確な値を確認できますが、画像からは見た目しか分からないためです。

Figmaでは、ボタンなどの要素をクリックすると、画面右側のパネルに幅や高さ、色の値(#3E5BD8 など)が表示されるので、開発者は目で見て推測しなくて済みます。

Figmaのようにブラウザで開けるツールなら、ファイルのリンクを共有するだけで、開発者は常に最新のデザインを見られます。

画像を別に送ると「どれが最新版か」が分からなくなりやすいので、渡す場所はファイル1か所にまとめておきましょう。

FigmaのDev Modeで値やコードを確認してもらう

Figmaには、開発者がデザインを確認するための「Dev Mode」という表示モードがあります(Dev Modeのガイド – Figma Learn)。

Dev Modeは、デザインを編集する画面とは別の、開発者向けに情報を整理した画面で、ツールバーのDev Modeのトグルボタンか、ショートカットのShift+Dで切り替えられます。

公式ヘルプによると、Dev Modeでは主に次のことができます。

機能できること
インスペクトパネル選んだ要素の寸法・色・文字などの仕様や、使われている部品の情報を確認できる
コードスニペット選んだ要素のCSSなどのコードの例が自動で表示される
スタイルとバリアブル色や余白に付けた名前(スタイル・バリアブル)を、値と一緒に確認できる
Ready for devデザインの完成した部分に「Ready for dev(開発の準備ができた)」の印を付けられる
アノテーションデザインに補足の説明や寸法を書き添えられる(付箋のように、デザインの上にメモを貼っておけるイメージ)
変更内容の比較フレーム(画面の枠)の以前の版と比べて、どこが変わったかを確認できる

コードスニペットは、デザインの値をコードの形に書き直した参考情報です。そのまま貼り付ければ画面が完成するわけではなく、どう組み込むかは開発者が判断します。

ただしDev Modeは、Figmaの有料プランで、編集もできる「フルシート」か開発者向けの「Devシート」を持つ人が使える機能です(シートとは、有料プランで1人ずつに割り当てる利用枠のことです)。

無料プランで作業している場合は、デザインファイルの共有に加えて、以下で紹介する「伝えること」を説明用のページや文章で補うようにしましょう(使い方のまとめ方はデザインシステムのドキュメントとは?で解説しています)。

プランやシートの内容は変わることがあるので、利用前に公式ヘルプで最新の情報を確認してください。

どこが完成しているかを分かるようにする

デザインファイルの中では、作業中のデザインと、作ってよい完成版のデザインをはっきり分けておきましょう。

検討中の案まで同じ場所に並んでいると、開発者が古い案や没になった案を実装してしまうことがあるためです。

Dev Modeが使える場合は、完成した画面に「Ready for dev」の印を付けておくと、開発者はどこから作り始めればよいかがすぐに分かります。

Dev Modeを使わない場合も、「完成版」「検討中」のようにページやフレームを分けて名前を付けるだけで、取り違えはぐっと減ります。

開発者に伝えること・合わせること

デザインファイルを共有するだけでは、伝わらないことがあります。

ここでは、デザイナーから開発者に意識して伝えたいこと、両者で合わせておきたいことを見ていきます。

部品の名前と値の名前をそろえる

部品の名前と、色・余白などの値に付けた名前は、デザインとコードでできるだけ同じものを使いましょう。

名前がそろっていれば、デザインの指示がそのままコードのどこを直せばよいかに結びつき、確認の手間が減るためです。

色や余白などの値に「メインの色」「小さい余白」のような名前を付けて共有する仕組みは、「デザイントークン」と呼ばれます。

Figmaでは、こうした名前付きの値をスタイルやバリアブルとして登録でき、Dev Modeの表にある「スタイルとバリアブル」は、それを開発者が確認するための機能です(詳しくはデザイントークンとは?、Figmaのバリアブル(変数)とは?で解説しています)。

たとえばボタンの指示書を、値だけで書いた場合と、名前を添えた場合で比べてみましょう。

申し込む
背景:#3E5BD8
文字:#FFFFFF
内側の余白:上下12px・左右24px
NG:値だけなので、ほかの画面の青と同じ色なのか、たまたま近い色なのか分からない
申し込む
部品:Button/Primary
背景:color/primary(#3E5BD8)
文字:color/on-primary(#FFFFFF)
内側の余白:space/12・space/24
OK:部品名と値の名前を添え、コードのどこと対応するかが分かる

NGの見本では、開発者は「#3E5BD8」をこのボタンのためだけに新しく書くべきか、すでにある「メインの色」を使うべきかを判断できません。

OKの見本では、「color/primary」という名前が添えてあるので、コードの中の同じ名前の値を使えばよいとすぐに分かり、あとでメインの色を変えたときもまとめて反映されます。

名前を英語にしているのは、コードの中でも値や部品を英語の名前(たとえば color-primary)で管理することが多く、対応がひと目で分かるためです。「/」は、color(色)・space(余白)のような分類と、その中の名前を区切る印です(名前の付け方はコンポーネントの命名規則とは?で解説しています)。

部品名の付け方は、余白の値をルール化する考え方とあわせて押さえておくと役立ちます(余白の段階を決める方法は余白の間隔のルールとは?で解説しています)。

状態と例外のケースも伝える

通常の見た目だけでなく、部品の状態ごとの見た目と、「うまくいかないとき」「データが想定と違うとき」の見た目も、デザインとして渡しましょう。

デザインはきれいな見本の文章や画像で作ることが多い一方、実際の画面では文字が長すぎたり、データが1件もなかったりと、さまざまな場面が起こるためです。

伝えておきたい主なケースは、次のとおりです。

ケース伝えること
状態マウスを重ねたとき・キーボードで選んだとき(Tabキーで移動して選ばれたとき)・押せないとき・読み込み中の見た目
エラー入力が間違っているときや、通信に失敗したとき(「接続できませんでした。もう一度お試しください」など)の見せ方とメッセージ
文字が長いとき見出しやボタンの文字が想定より長いときに、折り返すのか省略するのか
データがないとき一覧に表示するものが1件もないとき(検索結果が0件のときの「一致する商品が見つかりませんでした」など)に何を表示するか
画面幅が違うときスマホ・タブレット・PCで部品の並びや大きさがどう変わるか

たとえば「文字が長いとき」を伝えていないと、次のような食い違いが起こります。

初心者向けオンライン講座の申し込み方法と…

2026年11月1日

NG:長いタイトルの扱いを伝えておらず、開発者の判断で途中から省略された

初心者向けオンライン講座の申し込み方法と注意点

2026年11月1日

OK:「2行まで折り返す」と決めて、長いタイトルの見本も渡した

NGの見本では、タイトルの大事な後半が「…」で隠れてしまい、記事の内容が分からなくなっています。

OKの見本のように、「長い文字のときはこうする」という見本と一言のルールを渡しておけば、開発者は迷わず意図どおりに作れます。

部品の状態ごとの見た目も、同じように1つずつ並べて渡しましょう。

メールアドレス

name@example.com
見本A:通常

メールアドレス

naoq@
見本B:入力中(フォーカス)

メールアドレス

naoq@

⚠ @のあとまで入力してください

見本C:エラー

見本A〜Cのように、同じ入力欄でも状態によって枠の色やメッセージが変わります。

見本Cのエラーでは、枠の色だけでなく、記号とメッセージでも間違いを伝えています。

色の見え方には個人差があるため、色だけに頼らない見せ方をデザインの段階で決めておくことも大切です(詳しくは色だけに頼らないデザインで解説しています)。

動きや振る舞いは言葉で添える

ボタンを押したあとに何が起こるか、メニューがどう開くかといった「動き」は、止まった画面のデザインだけでは伝わらないので、言葉で添えましょう。

「送信ボタンを押したら、ボタンを読み込み中の表示にして、2回押せないようにする」のように、きっかけと結果をセットで書くと伝わりやすくなります。

FigmaのDev Modeが使えるなら、アノテーションでデザインのすぐそばに書いておくと、開発者が見落としにくくなります。

作り始める前に相談する

新しい部品や複雑な動きを考えたときは、デザインを仕上げる前に、開発者に「作れそうか」「すでにある部品で代用できないか」を相談しましょう。

仕上げたあとで「実装が難しい」「似た部品がもうある」と分かると、デザインのやり直しが大きくなるためです。

早めに相談すると、開発者から「この部品は既存のものを少し変えれば使える」といった提案をもらえることもあり、デザインと開発の両方の手間を減らせます。

実践のポイント

デザイナーと開発者の連携で陥りやすい失敗と、よくある疑問をまとめます。

注意点・よくある間違い

  • 画面を画像で書き出して渡してしまうことがあります。
    開発者が正確な値を確認できないので、デザインファイルそのものを共有しましょう。
  • 通常の見た目だけを作り、エラーや押せない状態、データがないときの見た目を渡し忘れることがあります。
    渡す前に、状態・エラー・文字が長いとき・データがないとき・画面幅が違うときの見た目がそろっているかを確認しましょう。
  • デザインを渡したあとに黙って修正し、開発者が古い版で作り続けてしまうことがあります。
    変更したときは、どこを変えたかを必ず知らせましょう。
  • 同じ色や余白なのに、画面ごとにわずかに違う値を使ってしまうことがあります。
    値には名前を付けて使い回し、開発者にもその名前で伝えましょう。

よくある質問

  • Q. Dev Modeが使えないと、開発者は値を確認できない?
    A. 確認できます。閲覧の権限でファイルを共有すれば、Dev Modeがなくても、要素を選んで画面右側のパネルで色や大きさなどの基本的な値を見られます。
    ただし、部品の詳しい情報や「Ready for dev」の印などはDev Modeの機能で、ファイルの設定によっては値のコピーが制限されていることもあります。
    渡す前に、開発者の画面でどこまで見られるかを一緒に確かめておきましょう。
    見られない情報は、説明用のページや文章で補います。
  • Q. デザインはどのタイミングで開発者に見せればいい?
    A. 完成してからではなく、構成やおおまかな見た目が決まった段階で一度見せるのがおすすめです。
    早い段階で実装の難しさや既存の部品について意見をもらえるので、あとからの大きなやり直しを防げます。
  • Q. デザイナーもコードを書けたほうがいい?
    A. 書けなくても連携はできますが、HTMLやCSSの基本を知っていると、「これは作りやすい」「これは手間がかかる」の見当がつき、相談がスムーズになります。
    まずは、余白がCSSでどう指定されるかを知るところから始めてみましょう(CSSのmarginとpaddingの違いとは?で解説しています)。

まとめ

デザイナーと開発者の連携とは、デザインを意図どおりに形にするために情報を受け渡し、確認し合うことで、画像ではなくデザインファイルを共有することが出発点です。

部品や値の名前をデザインとコードでそろえ、状態や例外のケース、動きまで伝え、作り始める前から相談することが、やり直しを減らすポイントです。

まずは自分のデザインの中から入力欄やボタンを1つ選び、エラーのときと押せないときの見た目が作られているかを確かめてみてください。