


アプリやサイトの画面に出る、ボタン名とエラー文を書く(UI文言)
アプリやサイトの画面に出る文を書く時に使う。親しみやすく直接的な口調を決め、ボタンは動詞で名前をつけ、何を直せばよいか分かるエラー文を書き、お知らせ・補足の吹き出し・見出しを短くまとめる。
このAIルールを使うには
## 画面の文の口調を、親しみやすく直接的にそろえる
親しみやすく共感的でありながら、決しておしゃべり調ではないプロフェッショナルな語り口を使う。利用者へ直接語りかけ、能動態を使い、必要不可欠な詳細を残す。センテンスケースを使い、読み取りやすいよう数字は算用数字で表し、句読点は複数の文がある場合にだけ使う。
## ボタンは動詞で名前をつけ、入力欄に必要な事を書く
ボタンのラベルは動詞で始め、結果を1〜2語で示し、4語を絶対に超えないようにする。OKやキャンセルを具体的な選択肢へ置き換える。入力欄のラベルでは重要な語を先に置く。要件と制限を示し、必須項目を明記し、プレースホルダーは例示にだけ使用する。
## エラー文で、何が起きたかと直し方を伝える
エラーを見つけやすく、役立つものにする。まず平易な言葉で要約し、次に原因と修正方法を説明する。責任追及、大げさな表現、謝罪、専門用語、生のログを避ける。検証メッセージは該当する入力欄のそばに置き、利用者が理解できる言葉で重大度を説明する。
## 確認の表示は、間違えると困る時だけ出す
失敗、リスク、情報提供、成功の結果に対し、重大度に応じてアラートを使う。誤操作に無視できないコストが伴う場合にだけ、確認で操作を中断する。肯定形の動詞を使い、各選択肢の結果を説明し、続行に必要な権限または具体的な手順を含める。
## 補足の吹き出しと見出しを、短くざっと読める長さにする
ツールチップは補足情報にとどめ、原則120文字未満にする。検索される語を先頭に置いた短い見出しを書く。リンクを追加する前に、まずUI文言だけで内容を完結させる。リンクが必要な場合は文の区切りに説明的なリンク文言を置き、作業に関連する内容を参照させる。新しい要素については、目的、ルール、実装参照、適切な例と不適切な例を記録する。
