このトピックでは、Windows Admin Center のユーザー インターフェイス (UI) テキストを記述する一般的なアプローチに加え、特定の規則やアプローチについて説明します。
Windows Admin Center およびすべての拡張機能は、エクスペリエンスが使いやすく、わかりやすくなるように Microsoft のボイスの原則に従う必要があります。 このスタイル ガイドは、これらのボイスの原則だけでなく Microsoft 記述スタイルに関するガイドに基づいているため、アクセシビリティ、略語、言葉の選択 (please (してください) や sorry (申し訳ありません) など) のような項目について、これらの両方のリソースを必ず確認してください。
ボタン
特に独自のツールをローカライズする場合は、可能な限り、ボタンを 1 語にする必要があります。 2 つまたは 3 つでも問題ありませんが、長くしないようにしてください。 4 つ以上の単語がある場合は、リンク コントロールを使用することをお勧めします。
ボタンのラベルは、簡潔かつ具体的で、一目見ただけでその内容がわかるようにする必要があります。 汎用的な "送信" ボタンの代わりに、"作成"、"削除"、"追加"、"書式設定" など、ユーザーの操作に対応する動詞を使用します。
ボタンが質問に続く場合、そのラベルは質問に明確に対応する必要があります (通常は "はい" または "いいえ")。
作成フローを起動するときは、適切なボタン ラベルを使用します。
ボタン 用途 作成 新しいリソース/オブジェクトなどを作成します。 [追加] ツールに既存のリソースやオブジェクトなどを追加します。 インストール ソフトウェアや拡張機能をインストールします。
[大文字/小文字の設定]
大文字化 に関して Microsoft のスタイルに従っています - ほぼすべてに文スタイルの大文字表記を使用します。
| UI 要素 | [大文字/小文字の設定] | コメント |
|---|---|---|
| バッジ (プレビュー版など) | すべて大文字 | |
| その他すべて | 文スタイル | ただし、Microsoft で管理できない、WMI または PowerShell からのオブジェクトのプロパティを表示するいくつかの例外があります。 |
コロン
リストを示すには、コロンを使用します。 次に例を示します。
次のいずれかを選択します。
- ネコ
- 犬
- クォッカ
ラベルで示すものと異なる行にラベルがある場合や、ラベルで示すものとラベルの間に明確な区別がある場合は、UI テキスト内でコロンを使用しないでください。
ラベルで示すテキストと同じ行にラベルがあり、2 つの要素が混ざらないようにする必要がある場合は、UI テキストでコロンを使用します。
確認メッセージ
確認のダイアログ ボックスは、続行するとデータ損失などの予期しない結果が発生する可能性があるときに役立ちます。 ここには読みやすく有用な情報を含める必要があり、特に元に戻せないイベントの場合は明確な結果を示す必要があります。
- 確認が必要であることを確認します。 提供する新しい情報がない場合 ("よろしいですか?" など)、確認メッセージは必要ない可能性があります。
- 顧客が操作を続行する必要があることを確認します。
- 重要な指示 (見出し) と説明文 (本文) が重複しないようにします。
- 見出しで、次に何が起こるかについて、考えられる結果を質問または一文で定義します。 たとえば、"このドライブのすべてのデータを消去しますか?" または、"すべてのデータを消去しようとしています" と記載します。
- 本文に詳細を追加します。 変数 (変更しようとしている項目の名前など) がある場合は、ここに含めます。
- 2 つのアクション ボタンによる明確な選択を組み立てる簡単な質問を (ヘッダーまたは本文に) 含めます。
- 複雑な選択の場合は、注意深く読むことを促す [はい]/[いいえ] のボタンを使用します。 簡単な選択の場合は、[すべて削除] や [キャンセル] など、アクションに特有のボタンを使用します。
初回実行時のエクスペリエンス
初めてユーザーがページにアクセスしたときに、ツールを使い始めてもらうことができます。 これには、次のことが含まれます。
- 開始方法に関する短い手順を記述した空白ページ内のテキスト文字列 - 例、"[追加] を選択してアプリを追加します"。
- ユーザーが開始できるようにするコントロールへのリンク - 例、"アプリを追加して開始します"。
- 開始する方法をユーザーに示す小さなアニメーションまたは短いビデオ
Microsoft の Windows スタイル ガイドに関するヒントを次に示します。
1. 有用さ
- マーケティングのスタイルと用語は使用しないようにします。
- 何かのデモや提案を行う場合は、最終結果が明確になるようにします。ユーザーに操作の方法を示すだけでは、ユーザーがその操作を行う理由を知らない場合には効果的ではありません。
- ユーザーに必要がない場合は、ヒントを表示しないでください。
2. 簡潔に示す
テキストは可能な限りシンプルにします (小さなアニメーションやビデオを検討してください)。
3. 困惑させない
- ポップアップとヒントは使用セッションごとに合計 4 つに限定します (システム通知やシェル通知を含みます)。
- ポップアップのタイミングが便利であることを確認します。
- ユーザーが操作を行うのを妨げないようにします。
- ポップアップが簡単に閉じることを確認します。
4. 状況依存にする
- 指示の機会は適切なタイミングで提示すると最も効果的です。
- チュートリアルまたはスライドショーを作成する場合は、情報を具体的にします。
- マーケティングの “あいまいな情報” を使用せず、具体的なヒントとコツを中心に説明します。
- 関連する場合は、ユーザーが後でチュートリアルに戻ることができる方法を提供します (ユーザーは多くの場合、初回に情報を記憶しませんが、セットアップ手順では一度しか該当しない場合があります)。
- 空の状態メッセージは、学習および楽しみのための自然な場所です。シンプルで情報が伝わるものにします。
5. 手間のかかるセットアップを最小限にする
ユーザーが最大限の価値を体験できるように別の操作を実行することが必要な場合 (オンライン サービスへのサインイン) は、できる限り容易にします。
- メッセージは簡潔で直接的にする必要があります。
- ユーザーを別の場所に移動させないようにします。 可能であれば、ユーザーがいる場所から接続できる方法を提供します。
- できれば、後で操作を実行するオプションを許可し、ユーザーが後で操作を実行するように通知します。
- ユーザーをエクスペリエンス外に移動する場合は、迅速かつ簡単に戻る方法を提供します。
[ヘルプ] リンク
Microsoft の Windows スタイル ガイドに関するヒントを次に示します。
どのような場合にヘルプ リンクを提供する必要がありますか?
ほぼありません。 次の場合にのみヘルプ リンクを提供します。
- ユーザーが UI を使用中に抱く可能性がある、明白かつ重要な質問があって、その回答が、ユーザーが UI タスクを正しく行うのに役立つ場合。
- ユーザーが UI タスクを正しく行うために必要な情報量を表示するための十分な領域が UI にない場合。
ヘルプ リンクをどこに表示すればよいですか?
- テキスト リンクは可能な限り、ヘルプに導く UI 要素の近くに表示してください。
- UI 画面全体に該当するテキスト リンクを提供する必要がある場合は、画面の左下に配置します。
- ヘルプボタン ([?]) を使用してリンクを示す場合、ツールヒントは "ヘルプ" になります。
どのような URL を使用する必要がありますか?
Web アドレスに直接リンクせず、代わりにリダイレクトサービスを使用してください。
Microsoft の開発者は、FWLink を使用する必要がありますが、ただしユーザーが手動で入力する必要のあるヘルプリンクの場合を除きます。この場合は、aka.ms リンクを使用します (URL のターゲットがブラウザーのロケールを自動的に認識する、learn.microsoft.com などの Web サイトである場合に限ります)。
テキストのガイドライン
- 完全な文を使用します。
- 疑問符を除いて、末尾に句点を付けないでください。
- タスクのタイトルと同じテキストを使用する必要はありません。UI のコンテキストで意味のあるテキストを使用しますが、この 2 つの間に論理的な関係があるようにしてください。 例:
- ヘルプ リンク: 例外を許可する際のリスクは何ですか?
- ヘルプ トピックのタイトル: "Windows ファイアウォール経由の通信をプログラムに許可する"
- ヘルプ トピックの内容について、できるだけ具体的に説明してください。
- Microsoft のスタイル
- Windows ファイアウォールはコンピューターの保護にどのように役立ちますか?
- 強調表示によって画像を改善できる理由
- Microsoft で使用しないスタイル
- Windows ファイアウォールに関する詳細情報
- 色の管理についての詳細情報
- 詳細情報
- Microsoft のスタイル
- 重要な単語だけでなく、文全体にリンク テキストを使用します。
- Microsoft のスタイル
- Microsoft で使用しないスタイル
- 例外を許可する際のリスクは何ですか?
- リンクをクリックしたときにユーザーにどんな情報が表示されるかのコンテキストが明確である場合は、[詳細情報] リンクを使用してかまいません。
エラー メッセージ
Windows スタイル ガイドから書き換えたガイダンスを次に示します。
適切なメッセージを書くには、十分な説明を提供しつつ、あまり技術的なものにしない、あるいは打ち解けた好感の持てるものとしつつ、迷惑で不快なものとしないよう、バランスを取ることが重要です。
一般的なガイドライン
エラー ケースごとに 1 つのメッセージを使用します。
見出し
- 短く保ち、何が問題であるか、理想的には何をすべきかを簡潔に説明します。
UI サーフェイスによっては、見出しが長すぎるときに折り返さずに切り捨てられることがあるため、これらの点については注意してください。 - 単純な手順の場合は、見出しに解決策を含めます。
- ユーザーが本文のテキストを無視する場合があるため、見出しがボタンに直接関連するようにしてください。
- 他に選択肢がない場合を除き、見出しに "問題が発生しました" という文言を使用しないでください。 問題について具体的に記してください。
- 変数 (ファイル、フォルダー、アプリ名など) を見出しに使用しないようにしてください。 これらは本文に配置します。
本文
問題または解決策が見出しに十分に記載されている場合、本文のテキストは必要ありません。
タイトルの言葉づかいをわずかに変えただけの文を、メッセージで繰り返さないようにします。
解決策が何かを明確かつ簡潔に伝えます。
まずは事実の提供に重点を置きます。
エラーについてユーザーを非難しないでください。
エラーに関連付けられているエラー コードがあり、そのエラー コードを含めることが、ユーザーまたは Microsoft サポートによる問題の調査に役立つ可能性があると考えられる場合は、本文のテキストのすぐ下に追加して、次のように記述します。
エラー コード: ####
コードがなくても、エラーを解決するために必要なすべての情報をユーザーが持っている場合、コードを含める必要はありません。
ボタン
- 主な指示に対する具体的な応答となるように、ボタン テキストを記述します。 それが不可能な場合は、([OK] または [完了] ではなく) 無視のボタン テキストを示す [閉じる] を使用します。
- 複数のボタンがある場合は、ユーザーに実行を推奨する操作を左端のボタンにします。 右端のボタンは、[キャンセル] などの控えめな操作にします。
[ヘルプ] リンク
特定のアクションを実行できないエラー メッセージについてのみ、ヘルプリンクを検討してください。
null 状態のテキスト
Windows スタイル ガイドのヘルプを次に示します。
null 状態は、ユーザーのデータまたはコンテンツがアプリや機能にない場合、検索後に結果が返されない場合、または (取引の請求情報など) 必要な情報がフォームにない場合に発生します。
ガイドライン
- 可能であれば、null 状態の状況を、その機能の使い方 (音楽の追加方法や画像の検索場所など) についてユーザーに教育する機会として利用します。
- UI にタイトルがある場合は、null 状態を "修正" する操作について説明します (たとえば、"いくつかの音楽を追加してください" など)。
- テキストを楽しんでください。 このスペースは、おそらく何度も表示されないため、楽しませる機会とすることができます。
- "何もありません" の使用を避けてください。 これは悲しい言い方で、過剰に使用されています。
- "プリンターに接続しましたか?" などの質問を避けてください。 一度は使用してもかまいませんが、この書式は過剰に使用される傾向があり、ユーザーに余分な負担やプレッシャーがかかります。 また、相手を見下すように感じることもあります。
- null 状態のテキストは、多様なものとすることをお勧めします。
例
- "お気に入りとして他のユーザーを追加すると、ここに表示されます。"
- "特に誇りを持っているアチーブメントやゲームのクリップがありますか? それらをショーケースに追加してください。 "
- "パーティにはまだ誰もいません。 1 人加えましょう!"
- "他のユーザーがあなたを友達として追加すると、そのユーザーがここに表示されます。"
- "アチーブメントのロック解除、ゲーム クリップの記録、友達の追加などを行うと、ここにすべてが表示されます。"
- "お気に入りの友達がここに表示されるため、オンラインかどうかや何をする予定があるかを確認できます。"
句読点
- 見出しや不完全な文には終わりに句読点 (ピリオド、疑問符) を使用しません。 見出しが質問形式の確認ダイアログである場合は例外です。
- ピリオドと疑問符に関して Microsoft スタイル ガイドのガイダンスを使用してください。
ステータス メッセージ
状態メッセージは、ポップアップ (トースト) メッセージと通知で構成されます。
| 文字列の種類 | メモ |
|---|---|
| トースト | 末尾に句点を付け文の先頭文字を大文字にする - ユーザーがオブジェクトから移動した場合に、メッセージが適用されるオブジェクトを理解できるように、できればオブジェクト変数を使用します |
| 通知の見出し (タイトル) | 末尾に句点を付けずに文の先頭文字を大文字にする (見出し) - オブジェクト変数を使用するのが理想的です |
| 通知の詳細 | できれば、オブジェクトを表示する UI へのリンクを含む完全文 |
通知メッセージの詳細な推奨事項を次に示します。
| 文字列の種類 | メモ |
|---|---|
| 開始済み | 可能な限り省略する - 通常は進行中メッセージにスキップして中断回数を最小限にすることができます。 |
| 進行中 | 実行している操作の動詞から開始し、省略記号で終了して進行中の操作を示します。 次に例を示します。 ボリューム"顧客データ" の作成中... 複数の変数がある場合は、次のパターンを使用します。 次の仮想マシンを削除します。{0}、ホスト： {1} |
| 成功 | "正常に" で開始し、ソフトウェアが実行した内容で終了します。 次に例を示します。 ボリューム "顧客データ" が正常に作成されました。 |
| 障害 | "できませんでした" で終了し、ソフトウェアで実行できなかった内容を含めます。 次に例を示します。 ボリューム "顧客データ" を正常に作成できませんでした。 |
ツールヒント
優れたツールヒントでは、ラベル付けされていないコントロールを簡単に説明したり、ラベル付けされたコントロールに関する少量の追加情報を (役に立つ場合に) 提供したりします。 また、コントロール ラベル、アイコン、リンクなどに関する追加の (冗長ではない) 情報を提供することで、ユーザーが UI 内を移動するのにも役立ちます。
ツールヒントは、めったに使用しないか、あるいはまったく使用しないようにしてください。 これらはユーザーの妨害となる可能性があるため、単にラベルを繰り返したり、明らかなことに言及したりするツールヒントを含めないようにしてください。 常に貴重な情報を追加する必要があります。
| コンテキスト | ツールヒントを記述する方法 |
|---|---|
| コントロールまたは UI 要素にラベルが付いていない場合... | 単純でわかりやすい名詞句を使用します。 次に例を示します。 ハイライト用のペン |
| UI 要素にラベルが付いているが、その目的を明確化する必要がある場合... |
|
| テキスト ラベルが切り捨てられたり、一部の言語で切り捨てられる可能性がある場合... |
|
| キーボード ショートカットが使用可能な場合... |
|