Web制作コラム

コーディング指示書の書き方|デザインだけでは伝わらないこと

発注・実務

Hタグの位置、画像のalt、リンク先、ホバー時の動き。デザインデータには写っていない情報を、どうやって渡すかをまとめます。

デザインデータは「見た目」の情報です。そこに写っていない情報がいくつもあり、それを伝えるのが指示書の役目です。

指示書がなくても、経験のある制作者なら妥当な形で組みます。ただし「妥当」の中身は人によって違うので、こだわりがある部分だけでも書いておくと、修正のやり取りが減ります。

よく指定される項目

項目書く内容書かないとどうなるか
見出しタグどの文字が h1 / h2 / h3 か文字の大きさから推測されるので、構造がずれることがある
画像の alt各画像の代替テキスト。装飾なら「空でよい」ファイル名が入る、または空になる
リンク先ボタンやテキストの遷移先URL「#」のまま納品され、あとで一括修正になる
別タブ外部リンクを別タブで開くか同じタブで開き、離脱につながる
ホバーマウスを乗せたときの変化制作側の判断(多くは透明度が変わる程度)
更新範囲WordPressで管理画面から変える箇所全部固定になり、あとから追加費用

※ 横にスクロールできます

見出しタグの指定が一番ずれる

デザイン上は同じ大きさの文字でも、片方は見出し、片方は強調したい本文、ということがあります。逆に、小さい文字でも構造上は見出しであるべき場合があります。

見た目からは判断がつかないので、ここは指示があると確実です。指定の仕方は単純で、デザインデータの上に「h2」と書き込むだけで足ります。

h1 はページに1つが原則です。トップはサイト名かキャッチコピー、下層はそのページのタイトルにするのが一般的です。

alt の指定

alt は、画像が表示されないときや、読み上げソフトを使っているときに読まれる文字です。全部の画像に必要というわけではありません。

  • 内容を伝える画像 … 何が写っているかを短く書く
  • ロゴ … 会社名
  • 文字が画像になっている場合 … その文字をそのまま
  • 背景・飾り … 空でよい(alt="" と指定する)

飾りの画像にまで説明を入れると、読み上げでは邪魔になります。「ここは空でいい」という指示も、立派な指示です。

指示書の形式

専用のフォーマットは要りません。実際に使われているのは次のような形です。

  • Figma のコメント機能で、該当箇所に直接書き込む(一番ずれない)
  • デザイン画像に赤字を入れた PDF
  • ページごとに表にした Excel / スプレッドシート

Figma で渡せるなら、コメントが一番おすすめです。どこの話かが一意に決まるので、「上から3つ目のボタン」といった説明のずれが起きません。

全部書く必要はない

細かい指示書を作ること自体が負担になって、発注が止まってしまうことがあります。それでは本末転倒です。

最低限、次の3つだけ決まっていれば進められます。

  1. リンク先(どのボタンがどこへ行くか)
  2. WordPressで更新したい箇所
  3. 「ここは絶対にこうしたい」というこだわりの部分

残りは制作側の判断に任せ、出てきたものを見て直す。このほうが速く進むケースも多いです。

ワプラボの場合

当社では、指示書が無い場合はこちらから確認事項を一覧にしてお送りします。見出しの階層・altの扱い・リンク先・更新範囲について、埋めていただくだけの形です。

Figma のコメントでのやり取りにも対応しています。デザインデータだけの支給でも進められますので、まずはご相談ください。

「発注・実務」のコラム

この記事と同じカテゴリの記事です。

一覧に戻る

SERVICES

WordPressとECサイトの制作、
まとめてご相談いただけます

WordPress

WordPress制作・構築代行

デザインデータやコーディング済みHTMLを、オリジナルテーマとして構築します。プラグイン開発も対応。

構築基本費用 50,000円

詳しく見る
コーディング

コーディング代行

デザインデータをHTML/CSSに起こします。WordPress化まで通しでも、コーディングだけでも承ります。

1ページ 15,000円〜

詳しく見る
React

Reactコーディング代行

デザインデータをReactのコンポーネントとして実装します。既存アプリへの画面追加・UI改修だけでも承ります。

1ページ 18,000円〜

詳しく見る
Next.js

Next.js制作・コーディング代行

検索エンジンに読まれるHTMLを返せるNext.jsで構築します。静的書き出しでレンタルサーバーでも公開できます。

1ページ 18,000円〜

詳しく見る
EC / WordPress

WelcartでのECサイト構築

WordPress専用のネットショップ構築プラグイン。機能面まで踏み込んだカスタマイズができます。

デザイン制作+構築 一式 120万円〜

詳しく見る
EC / EC-CUBE

EC-CUBEでのECサイト構築

国産オープンソースのECパッケージ。決済・受注・在庫まわりを業務に合わせて作り込めます。

デザイン制作+構築 一式 120万円〜

詳しく見る
EC / ASPカート

ECサイト制作代行

Shopify・MakeShop・カラーミーなどのカートに、オリジナルデザインを組み込みます。

構築基本費用 100,000円

詳しく見る

制作のご相談も承っています

デザインデータと画面数をお知らせいただければ、お見積りと納期をご提示します。