routie dev init since i didn't adhere to any proper guidance up until now
This commit is contained in:
+401
@@ -0,0 +1,401 @@
|
||||
import { createVNode as _createVNode, normalizeClass as _normalizeClass, normalizeStyle as _normalizeStyle, createElementVNode as _createElementVNode, Fragment as _Fragment, createTextVNode as _createTextVNode } from "vue";
|
||||
/**
|
||||
* VHotkey Component
|
||||
*
|
||||
* Purpose: Renders keyboard shortcuts in a visually consistent and accessible way.
|
||||
* This component handles the complex logic of displaying keyboard combinations
|
||||
* across different platforms (Mac vs PC) and display modes (icons, symbols, text).
|
||||
*
|
||||
* Why it exists:
|
||||
* - Provides consistent visual representation of keyboard shortcuts
|
||||
* - Handles platform-specific key differences (Cmd vs Ctrl, Option vs Alt)
|
||||
* - Supports multiple display modes for different design needs
|
||||
* - Encapsulates complex key parsing and rendering logic
|
||||
* - Used throughout the command palette for instruction display
|
||||
*
|
||||
* Key Mapping Structure:
|
||||
* The keyMap uses a simple object structure where each key has:
|
||||
* - `default`: Required configuration for all platforms
|
||||
* - `mac`: Optional Mac-specific overrides
|
||||
* Each config can specify `symbol`, `icon`, and `text` representations.
|
||||
*
|
||||
* Example:
|
||||
* ```
|
||||
* ctrl: {
|
||||
* mac: { symbol: '⌃', icon: '$ctrl', text: 'Control' },
|
||||
* default: { text: 'Ctrl', icon: '$ctrl' }
|
||||
* }
|
||||
* ```
|
||||
*/
|
||||
|
||||
// Styles
|
||||
import "./VHotkey.css";
|
||||
|
||||
// Components
|
||||
import { VIcon } from "../VIcon/index.js";
|
||||
import { VKbd } from "../VKbd/index.js"; // Composables
|
||||
import { makeBorderProps, useBorder } from "../../composables/border.js";
|
||||
import { makeComponentProps } from "../../composables/component.js";
|
||||
import { makeElevationProps, useElevation } from "../../composables/elevation.js";
|
||||
import { parseKeyCombination } from "../../composables/hotkey/hotkey-parsing.js";
|
||||
import { useLocale, useRtl } from "../../composables/locale.js";
|
||||
import { makeRoundedProps, useRounded } from "../../composables/rounded.js";
|
||||
import { makeThemeProps, provideTheme } from "../../composables/theme.js";
|
||||
import { useVariant } from "../../composables/variant.js"; // Utilities
|
||||
import { computed } from 'vue';
|
||||
import { genericComponent, mergeDeep, propsFactory, useRender } from "../../util/index.js"; // Types
|
||||
// Display mode types for different visual representations
|
||||
// Extended variant type that includes our custom 'contained' variant
|
||||
// Key display tuple: [mode, content] where content is string or IconValue
|
||||
// Key tuple: [mode, content, keycode] where content is string or IconValue
|
||||
function processKey(config, requestedMode, isMac) {
|
||||
const keyCfg = isMac && config.mac ? config.mac : config.default;
|
||||
|
||||
// 1. Resolve the safest display mode for the current platform
|
||||
const mode = (() => {
|
||||
// If the requested mode lacks an asset, fall back to text
|
||||
if (requestedMode === 'icon' && !keyCfg.icon) return 'text';
|
||||
if (requestedMode === 'symbol' && !keyCfg.symbol) return 'text';
|
||||
return requestedMode;
|
||||
})();
|
||||
|
||||
// 2. Pick value for the chosen mode, defaulting to text representation
|
||||
let value = keyCfg[mode] ?? keyCfg.text;
|
||||
|
||||
// 3. Guard against icon tokens leaking into text mode (e.g. "$ctrl")
|
||||
if (mode === 'text' && typeof value === 'string' && value.startsWith('$') && !value.startsWith('$vuetify.')) {
|
||||
value = value.slice(1).toUpperCase(); // "$ctrl" → "CTRL"
|
||||
}
|
||||
return mode === 'icon' ? ['icon', value] : [mode, value];
|
||||
}
|
||||
export const hotkeyMap = {
|
||||
ctrl: {
|
||||
mac: {
|
||||
symbol: '⌃',
|
||||
icon: '$ctrl',
|
||||
text: '$vuetify.hotkey.ctrl'
|
||||
},
|
||||
default: {
|
||||
text: 'Ctrl'
|
||||
}
|
||||
},
|
||||
meta: {
|
||||
mac: {
|
||||
symbol: '⌘',
|
||||
icon: '$command',
|
||||
text: '$vuetify.hotkey.command'
|
||||
},
|
||||
default: {
|
||||
text: 'Ctrl'
|
||||
}
|
||||
},
|
||||
cmd: {
|
||||
mac: {
|
||||
symbol: '⌘',
|
||||
icon: '$command',
|
||||
text: '$vuetify.hotkey.command'
|
||||
},
|
||||
default: {
|
||||
text: 'Ctrl'
|
||||
}
|
||||
},
|
||||
shift: {
|
||||
mac: {
|
||||
symbol: '⇧',
|
||||
icon: '$shift',
|
||||
text: '$vuetify.hotkey.shift'
|
||||
},
|
||||
default: {
|
||||
text: 'Shift'
|
||||
}
|
||||
},
|
||||
alt: {
|
||||
mac: {
|
||||
symbol: '⌥',
|
||||
icon: '$alt',
|
||||
text: '$vuetify.hotkey.option'
|
||||
},
|
||||
default: {
|
||||
text: 'Alt'
|
||||
}
|
||||
},
|
||||
enter: {
|
||||
default: {
|
||||
symbol: '↵',
|
||||
icon: '$enter',
|
||||
text: '$vuetify.hotkey.enter'
|
||||
}
|
||||
},
|
||||
arrowup: {
|
||||
default: {
|
||||
symbol: '↑',
|
||||
icon: '$arrowup',
|
||||
text: '$vuetify.hotkey.upArrow'
|
||||
}
|
||||
},
|
||||
arrowdown: {
|
||||
default: {
|
||||
symbol: '↓',
|
||||
icon: '$arrowdown',
|
||||
text: '$vuetify.hotkey.downArrow'
|
||||
}
|
||||
},
|
||||
arrowleft: {
|
||||
default: {
|
||||
symbol: '←',
|
||||
icon: '$arrowleft',
|
||||
text: '$vuetify.hotkey.leftArrow'
|
||||
}
|
||||
},
|
||||
arrowright: {
|
||||
default: {
|
||||
symbol: '→',
|
||||
icon: '$arrowright',
|
||||
text: '$vuetify.hotkey.rightArrow'
|
||||
}
|
||||
},
|
||||
backspace: {
|
||||
default: {
|
||||
symbol: '⌫',
|
||||
icon: '$backspace',
|
||||
text: '$vuetify.hotkey.backspace'
|
||||
}
|
||||
},
|
||||
escape: {
|
||||
default: {
|
||||
text: '$vuetify.hotkey.escape'
|
||||
}
|
||||
},
|
||||
' ': {
|
||||
mac: {
|
||||
symbol: '␣',
|
||||
icon: '$space',
|
||||
text: '$vuetify.hotkey.space'
|
||||
},
|
||||
default: {
|
||||
text: '$vuetify.hotkey.space'
|
||||
}
|
||||
},
|
||||
'-': {
|
||||
default: {
|
||||
text: '-'
|
||||
}
|
||||
},
|
||||
'+': {
|
||||
default: {
|
||||
text: '+'
|
||||
}
|
||||
}
|
||||
};
|
||||
export const makeVHotkeyProps = propsFactory({
|
||||
// String representing keyboard shortcuts (e.g., "ctrl+k", "meta+shift+p")
|
||||
keys: String,
|
||||
// How to display keys: 'symbol' uses special characters (⌘, ⌃), 'icon' uses SVG icons, 'text' uses words
|
||||
displayMode: {
|
||||
type: String,
|
||||
default: 'icon'
|
||||
},
|
||||
// Custom key mapping configuration. Users can import and modify the exported hotkeyMap as needed
|
||||
keyMap: {
|
||||
type: Object,
|
||||
default: () => hotkeyMap
|
||||
},
|
||||
platform: {
|
||||
type: String,
|
||||
default: 'auto'
|
||||
},
|
||||
inline: Boolean,
|
||||
disabled: Boolean,
|
||||
prefix: String,
|
||||
suffix: String,
|
||||
variant: {
|
||||
type: String,
|
||||
default: 'elevated',
|
||||
validator: v => ['elevated', 'flat', 'tonal', 'outlined', 'text', 'plain', 'contained'].includes(v)
|
||||
},
|
||||
...makeComponentProps(),
|
||||
...makeThemeProps(),
|
||||
...makeBorderProps(),
|
||||
...makeRoundedProps(),
|
||||
...makeElevationProps(),
|
||||
color: String
|
||||
}, 'VHotkey');
|
||||
const AND_DELINEATOR = Symbol('VHotkey:AND_DELINEATOR'); // For +_ separators
|
||||
const OR_DELINEATOR = Symbol('VHotkey:OR_DELINEATOR'); // For / separators
|
||||
const THEN_DELINEATOR = Symbol('VHotkey:THEN_DELINEATOR'); // For - separators
|
||||
|
||||
function getKeyText(keyMap, key, isMac) {
|
||||
const lowerKey = key.toLowerCase();
|
||||
if (lowerKey in keyMap) {
|
||||
const result = processKey(keyMap[lowerKey], 'text', isMac);
|
||||
return typeof result[1] === 'string' ? result[1] : String(result[1]);
|
||||
}
|
||||
return key.toUpperCase();
|
||||
}
|
||||
function applyDisplayModeToKey(keyMap, mode, key, isMac) {
|
||||
const lowerKey = key.toLowerCase();
|
||||
if (lowerKey in keyMap) {
|
||||
const result = processKey(keyMap[lowerKey], mode, isMac);
|
||||
if (result[0] === 'text' && typeof result[1] === 'string' && result[1].startsWith('$') && !result[1].startsWith('$vuetify.')) {
|
||||
return ['text', result[1].replace('$', '').toUpperCase(), key];
|
||||
}
|
||||
return [...result, key];
|
||||
}
|
||||
return ['text', key.toUpperCase(), key];
|
||||
}
|
||||
export const VHotkey = genericComponent()({
|
||||
name: 'VHotkey',
|
||||
props: makeVHotkeyProps(),
|
||||
setup(props) {
|
||||
const {
|
||||
t
|
||||
} = useLocale();
|
||||
const {
|
||||
themeClasses
|
||||
} = provideTheme(props);
|
||||
const {
|
||||
rtlClasses
|
||||
} = useRtl();
|
||||
const {
|
||||
borderClasses
|
||||
} = useBorder(props);
|
||||
const {
|
||||
roundedClasses
|
||||
} = useRounded(props);
|
||||
const {
|
||||
elevationClasses
|
||||
} = useElevation(props);
|
||||
const {
|
||||
colorClasses,
|
||||
colorStyles,
|
||||
variantClasses
|
||||
} = useVariant(() => ({
|
||||
color: props.color,
|
||||
variant: props.variant === 'contained' ? 'elevated' : props.variant
|
||||
}));
|
||||
const isMac = computed(() => props.platform === 'auto' ? typeof navigator !== 'undefined' && /macintosh/i.test(navigator.userAgent) : props.platform === 'mac');
|
||||
const keyCombinations = computed(() => {
|
||||
if (!props.keys) return [];
|
||||
|
||||
// Split by spaces to handle multiple key combinations
|
||||
// Example: "ctrl+k meta+p" -> ["ctrl+k", "meta+p"]
|
||||
return props.keys.split(/\b \b/).map(combination => {
|
||||
const result = [];
|
||||
function visit(node) {
|
||||
if (typeof node === 'string') {
|
||||
if (node !== '') {
|
||||
result.push(applyDisplayModeToKey(props.keyMap, props.displayMode, node, isMac.value));
|
||||
}
|
||||
} else {
|
||||
for (let i = 0; i < node.parts.length; i++) {
|
||||
if (i > 0) {
|
||||
if (node.type === 'sequence') {
|
||||
result.push(THEN_DELINEATOR);
|
||||
} else if (node.type === 'alternate') {
|
||||
result.push(OR_DELINEATOR);
|
||||
} else if (node.type === 'combo') {
|
||||
result.push(AND_DELINEATOR);
|
||||
} else {
|
||||
void node;
|
||||
}
|
||||
}
|
||||
visit(node.parts[i]);
|
||||
}
|
||||
}
|
||||
}
|
||||
visit(parseKeyCombination(combination));
|
||||
return result;
|
||||
});
|
||||
});
|
||||
const accessibleLabel = computed(() => {
|
||||
if (!props.keys) return '';
|
||||
|
||||
// Convert the parsed key combinations into readable text
|
||||
const readableShortcuts = keyCombinations.value.map(combination => {
|
||||
const readableParts = [];
|
||||
for (const key of combination) {
|
||||
if (Array.isArray(key)) {
|
||||
// Always use text representation for screen readers
|
||||
const textKey = key[0] === 'icon' || key[0] === 'symbol' ? applyDisplayModeToKey(mergeDeep(hotkeyMap, props.keyMap), 'text', String(key[1]), isMac.value)[1] : key[1];
|
||||
readableParts.push(translateKey(textKey));
|
||||
} else {
|
||||
if (key === AND_DELINEATOR) {
|
||||
readableParts.push(t('$vuetify.hotkey.plus'));
|
||||
} else if (key === OR_DELINEATOR) {
|
||||
readableParts.push(t('$vuetify.hotkey.or'));
|
||||
} else if (key === THEN_DELINEATOR) {
|
||||
readableParts.push(t('$vuetify.hotkey.then'));
|
||||
}
|
||||
}
|
||||
}
|
||||
return readableParts.join(' ');
|
||||
});
|
||||
const shortcutText = readableShortcuts.join(', ');
|
||||
return t('$vuetify.hotkey.shortcut', shortcutText);
|
||||
});
|
||||
function translateKey(key) {
|
||||
return key.startsWith('$vuetify.') ? t(key) : key;
|
||||
}
|
||||
function getKeyTooltip(key) {
|
||||
if (props.displayMode === 'text') return undefined;
|
||||
const textKey = getKeyText(props.keyMap, String(key[2]), isMac.value);
|
||||
return translateKey(textKey);
|
||||
}
|
||||
function renderKey(key, keyIndex) {
|
||||
const isContained = props.variant === 'contained';
|
||||
const KeyComponent = isContained ? 'kbd' : VKbd;
|
||||
const keyClasses = ['v-hotkey__key', `v-hotkey__key-${key[0]}`, ...(isContained ? ['v-hotkey__key--nested'] : [borderClasses.value, roundedClasses.value, elevationClasses.value, colorClasses.value])];
|
||||
return _createVNode(KeyComponent, {
|
||||
"key": keyIndex,
|
||||
"class": _normalizeClass(keyClasses),
|
||||
"style": _normalizeStyle(isContained ? undefined : colorStyles.value),
|
||||
"aria-hidden": "true",
|
||||
"title": getKeyTooltip(key)
|
||||
}, {
|
||||
default: () => [key[0] === 'icon' ? _createVNode(VIcon, {
|
||||
"icon": key[1],
|
||||
"aria-hidden": "true"
|
||||
}, null) : translateKey(key[1])]
|
||||
});
|
||||
}
|
||||
function renderDivider(key, keyIndex) {
|
||||
return _createElementVNode("span", {
|
||||
"key": keyIndex,
|
||||
"class": "v-hotkey__divider",
|
||||
"aria-hidden": "true"
|
||||
}, [key === AND_DELINEATOR ? '+' : key === OR_DELINEATOR ? t('$vuetify.hotkey.or') : t('$vuetify.hotkey.then')]);
|
||||
}
|
||||
useRender(() => {
|
||||
const content = _createElementVNode(_Fragment, null, [props.prefix && _createElementVNode("span", {
|
||||
"key": "prefix",
|
||||
"class": "v-hotkey__prefix"
|
||||
}, [props.prefix]), keyCombinations.value.map((combination, comboIndex) => _createElementVNode("span", {
|
||||
"class": "v-hotkey__combination",
|
||||
"key": comboIndex
|
||||
}, [combination.map((key, keyIndex) => Array.isArray(key) ? renderKey(key, keyIndex) : renderDivider(key, keyIndex)), comboIndex < keyCombinations.value.length - 1 && _createElementVNode("span", {
|
||||
"aria-hidden": "true"
|
||||
}, [_createTextVNode("\xA0")])])), props.suffix && _createElementVNode("span", {
|
||||
"key": "suffix",
|
||||
"class": "v-hotkey__suffix"
|
||||
}, [props.suffix])]);
|
||||
return _createElementVNode("div", {
|
||||
"class": _normalizeClass(['v-hotkey', {
|
||||
'v-hotkey--disabled': props.disabled,
|
||||
'v-hotkey--inline': props.inline,
|
||||
'v-hotkey--contained': props.variant === 'contained'
|
||||
}, themeClasses.value, rtlClasses.value, variantClasses.value, props.class]),
|
||||
"style": _normalizeStyle(props.style),
|
||||
"role": "img",
|
||||
"aria-label": accessibleLabel.value
|
||||
}, [props.variant !== 'contained' ? content : _createVNode(VKbd, {
|
||||
"key": "contained",
|
||||
"class": _normalizeClass(['v-hotkey__contained-wrapper', borderClasses.value, roundedClasses.value, elevationClasses.value, colorClasses.value]),
|
||||
"style": _normalizeStyle(colorStyles.value),
|
||||
"aria-hidden": "true"
|
||||
}, {
|
||||
default: () => [content]
|
||||
})]);
|
||||
});
|
||||
}
|
||||
});
|
||||
//# sourceMappingURL=VHotkey.js.map
|
||||
Reference in New Issue
Block a user