2026-10-24約5分
Markdown デザイン仕様書テンプレート:UI 状態と受け入れ基準
設定画面の仕様書をダウンロードして編集し、開発へ渡す前に記述の不足を確認します。

01
画像だけでなく決定事項を書く
画面の画像だけでは保存を無効にする条件や、失敗時に下書きを残すかは分かりません。DiagramPreview の独立テンプレートはこれらを設計者、開発者、アシスタントへ伝えます。Figma の公式テンプレート、自動インポート形式、同じ表示の保証ではありません。
02
開く・編集する・フォームで作成する
プレビューとダウンロードは同じ言語の同一 Markdown を使います。タイトル、目的、トークン、状態、基準を変更してください。ジェネレーターではフォームと直接編集、原文行または補足例を表示するローカルチェックを使えます。文字の一致は実装の正しさを証明しません。プレビュー URL のフラグメントには原文が含まれるため、共有前に非公開情報を除いてください。
markdownコピーできるサンプル
# ワークスペース設定 — デザイン仕様書
> DiagramPreview の独立したサンプルです。製品に合わせて変更してください。Figma の公式テンプレートやインポート形式ではありません。
## 目的と範囲
所有者がワークスペース名と通知設定を変更できるようにする。
請求、招待、権限管理は対象外。架空データを使い、本番サーバーに接続しない。
## デザイントークン
- 主操作:#1D4ED8、白文字。
- 本文:#0F172A、背景 #FFFFFF。補助文字:#475569。エラー:#B91C1C。
- フォント:system-ui。本文 16px / 24px、見出し 24px / 32px。
- 余白:4、8、12、16、24、32px。カード角丸:8px。
- 名前付きトークンを使い、任意の色や余白を追加しない。
## コンポーネントと状態
### 保存ボタン
- 通常:「変更を保存」、主操作の背景色。
- ホバー:#1E40AF、白文字の読みやすさを保つ。
- フォーカス:2px の輪郭、2px の間隔。
- 未変更または無効な入力では無効化し、入力欄の横で理由を説明する。
- 保存中はメッセージを表示し、重複送信を防止する。
- 成功:「変更を保存しました」を live region で通知する。
- エラー時は入力を保持し、再試行を提供する。
### ワークスペース名
- 必須。前後の空白除去後、2〜60 文字。
- ラベルと補足を常に表示し、プレースホルダーで代替しない。
- フォーカスが外れた時と保存前に検証し、エラーを入力欄に関連付ける。
- 検証失敗時は保存しない。
## 操作とデータ
1. 現在の名前と通知設定を読み込む。
2. 有効な変更がある場合だけ保存を有効にする。
3. 送信時は模擬リクエストを実行し、読み込み状態を表示する。
4. 成功時は確定値を保持し、完了を通知する。
5. 失敗時は下書きを保持し、再試行を提供する。
- 初期読み込みは説明付きプレースホルダーを表示する。
- 初期取得の失敗時は再試行を提供し、保存済みデータを捏造しない。
- 名前が空欄の場合は必須メッセージを表示する。
## レスポンシブ配置
- 768px 未満:1 列、余白 16px、保存ボタンは全幅。
- 768px 以上:中央配置、最大幅 640px、余白 24px。
- 幅 320px で水平スクロールが発生しない。
## アクセシビリティ
- 各入力にプログラムで認識できるラベルを付け、Tab は表示順序に従う。
- キーボードで全操作ができ、フォーカスが見える。
- 成功と失敗は色だけでなく文字で伝える。
- 通常文字と実際の背景とのコントラスト比を 4.5:1 以上にする。
## 受け入れチェックリスト
- [ ] 空欄ではエラーを表示し、送信できない。
- [ ] 2〜60 文字の範囲外では具体的なエラーを表示する。
- [ ] 保存中に何度クリックしてもリクエストは 1 回だけ。
- [ ] 失敗時は入力を保持し、再試行できる。
- [ ] フォーカスを移動せずに完了を通知する。
- [ ] キーボード操作と幅 320px の表示を確認する。
- [ ] 実装した全状態を仕様書と比較する。
## 本番公開前の決定事項
- TODO:API、認可、エラーレスポンスを開発担当と確認する。
- TODO:通知動作と最終文言を製品担当と確認する。
- データ契約の承認後に模擬リクエストを置き換える。
03
未決事項を分けて管理
既存のトークンとコンポーネントを再利用し、用途も記載します。API、認可、未承認ルールは未決として残してください。試作依頼は一画面、架空データ、模擬リクエストに限定します。不正入力、連打、通信失敗、成功、フォーカス、モバイル幅を自分で確認し、結果を記録してください。生成された報告書は実際の観察の代わりにはなりません。
04
必要な場合に図を追加
単純なフォームなら番号付きの操作手順だけで十分な場合があります。分岐があるときは独立した Mermaid 図を追加します。ジェネレーターの保存フロー例は編集して既存の SVG/PNG 出力へ渡せますが、仕様書から自動推論しません。DiagramPreview の Mermaid 対応は Figma Specs のネイティブ対応を証明しません。受け入れ可能な埋め込み方式を確認し、変更に備えて図のソースも保管してください。