On this page
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)
value属性または初期テキスト内の+や,区切りショートカットを解析し、常に.valueで正規化文字列、.keysでトークン配列を取得できます。- プラットフォームに応じて修飾キー記号を自動変換します(macでは
cmdおよびmodを⌘、altを⌥、その他ではctrl/altとして表示、shiftは⇧、enterは⏎)。 editableモードではクリックまたはフォーカスで記録を開始し、修飾キー押下中はリアルタイムにプレビュー、通常キー入力で確定してchangeを送出、Escapeでキャンセル、Backspace/Deleteでクリアします。.btn内での表示や.d-key-groupでのグループ化に対応しています。

