v0.21

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)