ux-writing

UX ライティング

インターフェースを通じてユーザーを導く、明確で役立つコピーを書きましょう。

基本原則

1. 気の利いた表現より明確さを優先する

• 簡単でなじみのある言葉を使う
• 専門用語や技術用語は避ける
• 伝えたいことを率直に伝える

2. 簡潔にする

• 不要な言葉を削る
• 1文につき1つの考えを伝える
• 重要な情報を先に伝える

3. 役立つ内容にする

• 起きたことだけでなく、ユーザーがすべきことを伝える
• 次のステップを示す
• 不安や不確実さを軽減する

ボタンのラベル

使う表現

• アクションを表す動詞を使う：「保存」「送信」「作成」
• 具体的にする：「送信」ではなく「カートに追加」
• ユーザーの意図に合わせる：「無料で登録」

避ける表現

• 汎用的な表現：「OK」「送信」「続行」
• あいまいな表現：「ここをクリック」「移動」
• 否定的な言い回し：「キャンセルしない」

例

代わりに	使う表現
送信	メッセージを送信
OK	わかりました
続行	次へ：お支払い
キャンセル	編集を続ける
はい／いいえ	削除／保持

エラーメッセージ

公式

何が起きたか ＋ 理由 ＋ 修正方法

例

❌ 「エラー 404」 ✅ 「ページが見つかりません。検索するか、ホームページに戻ってください。」

❌ 「無効な入力です」 ✅ 「有効なメールアドレスを入力してください（例：[email protected]）」

❌ 「問題が発生しました」 ✅ 「変更を保存できませんでした。接続を確認して、もう一度お試しください。」

ガイドライン

• 問題を具体的に伝える
• 責任を押しつけない（「入力した内容が……」など）
• 解決方法を提案する
• エラーコードではなく、わかりやすい言葉を使う

空の状態

含める内容

1. この場所の用途
2. 空である理由
3. 内容を追加する方法

例

検索結果なし 「『xyz』の検索結果はありません。別のキーワードを試すか、スペルを確認してください。」

受信トレイが空 「メッセージはまだありません。誰かから連絡があると、ここに表示されます。」

初めて利用するユーザー 「プロジェクトがここに表示されます。最初のプロジェクトを作成して始めましょう。」

読み込みと進行状況

短い待ち時間（2秒未満）

スピナーを表示するだけで十分です。テキストは必要ありません。

中程度の待ち時間（2～10秒）

「ダッシュボードを読み込み中……」 「変更を保存中……」

長い待ち時間（10秒超）

「動画を処理しています。通常、1～2分かかります。」 可能であれば進行状況の割合を表示します

成功メッセージ

具体的にする

❌ 「成功しました！」 ✅ 「プロフィールを更新しました。」

実行した操作を確認する

「[email protected] にメッセージを送信しました」 「注文 #12345 が確定しました。2～3日で発送されます。」

次のステップを提案する

「パスワードを変更しました。新しいパスワードでサインインできます。」

ツールチップとヒント

使用する場面

• なじみのない UI 要素を説明する
• 操作の背景を補足する
• キーボードショートカットを示す

短くまとめる

• 150文字以内にする
• 1つのツールチップにつき1つの概念に絞る
• 重要な情報は含めない（ツールチップはデフォルトで非表示です）

オンボーディングのコピー

ウェルカムメッセージ

• 節目を歓迎する
• 今後の流れを伝える
• 最初に行う操作を示す

例： 「Acme へようこそ！3つの簡単なステップでワークスペースを設定しましょう。」

段階的な情報提示

• 最初からすべてを説明しない
• 関連するタイミングで機能を紹介する
• チュートリアルよりインラインヒントを使う

ボイスとトーンのガイドライン

ボイス（一貫性を保つ）

• 親しみやすく、かつプロフェッショナル
• 明確で率直
• 役立ち、相手を支える

トーン（状況に応じて変える）

状況	トーン
成功	祝福する、温かい
エラー	落ち着いた、役立つ
警告	真剣な、明確な
オンボーディング	励ます、辛抱強い
設定	中立的、情報を伝える