On this page
d-questionnaire
進捗バー、ラジオボタン、チェックボックス、テキスト入力、キーボードショートカットを統合した対話型マルチステップアンケートコンポーネントです。
1<d-questionnaire name="survey">2 <div d-step name="role" title="役割を選択してください" type="single" required>3 <div d-option value="dev" text="開発者" description="バックエンドおよびソフトウェア構築"></div>4 <div d-option value="design" text="デザイナー" description="ユーザーインターフェース設計"></div>5 </div>6 <div d-step name="tools" title="使用しているツール" type="multiple" skippable>7 <div d-option value="git" text="git"></div>8 <div d-option value="docker" text="docker"></div>9 </div>10 <div d-step name="notes" title="ご意見・ご要望" type="text" placeholder="自由に入力してください"></div>11</d-questionnaire>
属性とプロパティ(d-questionnaire)
| 属性 | プロパティ | 型 | デフォルト | フォーム | 説明 |
|---|---|---|---|---|---|
name |
name |
string | "" |
いいえ | フォームフィールド名 |
value |
value |
string | "{}" |
はい | 回答データのjsonシリアライズ文字列(フォーム連動) |
current-step |
currentStep |
number | 0 |
いいえ | 現在のアクティブステップ番号 |
auto-advance |
autoAdvance |
boolean | false |
いいえ | 単一選択肢クリック時に自動進行するかどうか |
show-progress |
showProgress |
boolean | true |
いいえ | 上部進捗バーの表示 |
show-shortcuts |
showShortcuts |
boolean | true |
いいえ | 選択肢の数字キーバッジ表示 |
questions |
questions |
string | "" |
いいえ | 子要素の代わりにjson文字列でステップを定義 |
プログラム用api(d-questionnaire)
1const qn = select('d-questionnaire');2 3// ナビゲーション操作4qn.next(); // 入力検証後に次のステップへ進むか送信5qn.prev(); // 前のステップへ戻る6qn.skip(); // 任意項目のステップをスキップ7qn.goTo(1); // 指定のステップインデックスへ移動8qn.reset(); // 回答をクリアして初期ステップへ戻す9 10// 回答データ取得と設定11const ans = qn.answers; // 収集された回答オブジェクトのコピー12qn.setAnswer('role', 'dev'); // プログラムから回答を設定
イベント(d-questionnaire)
| イベント | 詳細 | バブリング | 説明 |
|---|---|---|---|
step |
オブジェクト({ step, index, total, answers }) |
はい | ステップ移動時に送出 |
answer |
オブジェクト({ name, value, answers }) |
はい | 回答が選択・変更されたときに送出 |
submit |
オブジェクト({ answers, json }) |
はい | 最終ステップ完了時に送出 |
動作仕様(d-questionnaire)
- キーボード操作に対応(数字キー
1〜9で該当選択肢を選択、Enterで次へ、BackspaceまたはArrowLeftで戻る)。 - 必須ステップ未回答時はシェイクアニメーションを実行して進行を防止。
- 回答はjson文字列として自動更新され、
<form>や<d-form>の送信データに含まれます。

