v0.21

d-key

キーボードのキーキャップバッジおよびフォーム関連のショートカット記録入力コンポーネントです。ショートカット文字列をキーキャップに自動分割し、プラットフォームに応じた記号表示、物理キー押下のライブ反映、クリックによるショートカット入力に対応しています。

1<d-key>cmd+k</d-key>
2<d-key separator="">cmd,shift,p</d-key>
3<d-key live>cmd+s</d-key>
4<d-key editable name="shortcut" value="cmd+b"></d-key>
5
6<span class="d-key-group">
7 <d-key>cmd+b</d-key>
8 <d-key>cmd+k</d-key>
9</span>

属性とプロパティ(d-key)

属性 プロパティ 型 デフォルト値 フォーム 説明
value value string "" はい 正規化されたショートカット文字列(テキスト指定時も.valueで取得可)
name name string "" いいえ フォーム送信時に使用される入力フィールド名
separator separator string "+" いいえ キーキャップ間の区切り文字(""で区切りなし)
editable editable boolean false いいえ クリックでショートカットを記録する入力モードを有効化
live live boolean false いいえ 対応する物理キー押下時にキーキャップをアニメーション表示
placeholder placeholder string "press key" いいえ 編集可能モードで値が空のときに表示するプレースホルダー
disabled disabled boolean false いいえ 入力を無効化しフォーム送信から除外する
clearable clearable boolean true いいえ 記録中にBackspaceまたはDeleteでショートカットをクリア可能にする

プログラム用api(d-key)

1const key = select('d-key');
2
3console.log(key.value);
4console.log(key.keys);
5
6key.value = 'ctrl+shift+p';
7key.clear();

イベント(d-key)

イベント 詳細 バブリング 説明
change string(正規化されたキー配列) はい 入力モードでショートカットが記録またはクリアされたときに送出

動作仕様(d-key)