@sveltia/ui 0.91.0 → 0.92.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/components/bottom-navigation/bottom-navigation.svelte +3 -9
- package/dist/components/bottom-navigation/bottom-navigation.svelte.d.ts +4 -39
- package/dist/components/button/button-group.svelte +2 -4
- package/dist/components/button/button-group.svelte.d.ts +3 -19
- package/dist/components/button/select-button-group.svelte +2 -13
- package/dist/components/button/select-button-group.svelte.d.ts +5 -67
- package/dist/components/calendar/calendar.d.ts +9 -0
- package/dist/components/calendar/calendar.js +43 -0
- package/dist/components/calendar/calendar.svelte +26 -27
- package/dist/components/checkbox/checkbox-group.svelte +2 -8
- package/dist/components/checkbox/checkbox-group.svelte.d.ts +4 -39
- package/dist/components/dialog/alert-dialog.svelte.d.ts +2 -3
- package/dist/components/dialog/confirmation-dialog.svelte.d.ts +2 -3
- package/dist/components/dialog/dialog.svelte +6 -7
- package/dist/components/dialog/dialog.svelte.d.ts +2 -3
- package/dist/components/dialog/prompt-dialog.svelte +2 -2
- package/dist/components/dialog/prompt-dialog.svelte.d.ts +2 -3
- package/dist/components/disclosure/disclosure.svelte +14 -16
- package/dist/components/disclosure/disclosure.svelte.d.ts +4 -38
- package/dist/components/drawer/drawer.svelte +22 -39
- package/dist/components/drawer/drawer.svelte.d.ts +3 -24
- package/dist/components/grid/grid-body.svelte +2 -3
- package/dist/components/grid/grid-body.svelte.d.ts +3 -18
- package/dist/components/grid/grid-cell.svelte +2 -8
- package/dist/components/grid/grid-cell.svelte.d.ts +3 -22
- package/dist/components/grid/grid-col-header.svelte +2 -4
- package/dist/components/grid/grid-col-header.svelte.d.ts +3 -19
- package/dist/components/grid/grid-foot.svelte +4 -9
- package/dist/components/grid/grid-foot.svelte.d.ts +3 -22
- package/dist/components/grid/grid-head.svelte +4 -9
- package/dist/components/grid/grid-head.svelte.d.ts +3 -22
- package/dist/components/grid/grid-row-header.svelte +2 -8
- package/dist/components/grid/grid-row-header.svelte.d.ts +3 -22
- package/dist/components/grid/grid-row.svelte +4 -5
- package/dist/components/grid/grid-row.svelte.d.ts +3 -19
- package/dist/components/grid/grid.d.ts +10 -0
- package/dist/components/grid/grid.js +11 -0
- package/dist/components/grid/grid.svelte +6 -7
- package/dist/components/grid/grid.svelte.d.ts +5 -21
- package/dist/components/listbox/listbox.svelte +34 -15
- package/dist/components/listbox/listbox.svelte.d.ts +5 -69
- package/dist/components/listbox/option-group.svelte +2 -8
- package/dist/components/listbox/option-group.svelte.d.ts +4 -39
- package/dist/components/listbox/option.svelte +2 -1
- package/dist/components/menu/menu-item-group.svelte +2 -6
- package/dist/components/menu/menu-item-group.svelte.d.ts +3 -22
- package/dist/components/menu/menu-item.svelte +5 -1
- package/dist/components/menu/menu.svelte +2 -8
- package/dist/components/menu/menu.svelte.d.ts +4 -39
- package/dist/components/radio/radio-group.svelte +2 -17
- package/dist/components/radio/radio-group.svelte.d.ts +5 -67
- package/dist/components/radio/radio.svelte +19 -22
- package/dist/components/radio/radio.svelte.d.ts +10 -40
- package/dist/components/resizable-pane/resizable-handle.svelte +42 -49
- package/dist/components/resizable-pane/resizable-pane-group.svelte +44 -58
- package/dist/components/resizable-pane/resizable-pane-group.svelte.d.ts +3 -19
- package/dist/components/resizable-pane/resizable-pane.svelte +2 -5
- package/dist/components/resizable-pane/resizable-pane.svelte.d.ts +3 -19
- package/dist/components/resizable-pane/sizing.d.ts +24 -0
- package/dist/components/resizable-pane/sizing.js +83 -0
- package/dist/components/select/combobox.svelte +35 -39
- package/dist/components/select/select-tags.svelte +3 -13
- package/dist/components/select/select-tags.svelte.d.ts +5 -67
- package/dist/components/slider/slider.d.ts +5 -4
- package/dist/components/slider/slider.js +28 -23
- package/dist/components/slider/slider.svelte +64 -62
- package/dist/components/slider/slider.svelte.d.ts +4 -37
- package/dist/components/switch/switch.svelte +2 -13
- package/dist/components/switch/switch.svelte.d.ts +5 -67
- package/dist/components/table/table-body.svelte +2 -4
- package/dist/components/table/table-body.svelte.d.ts +3 -19
- package/dist/components/table/table-cell.svelte +2 -8
- package/dist/components/table/table-cell.svelte.d.ts +3 -22
- package/dist/components/table/table-col-header.svelte +2 -8
- package/dist/components/table/table-col-header.svelte.d.ts +3 -22
- package/dist/components/table/table-foot.svelte +2 -8
- package/dist/components/table/table-foot.svelte.d.ts +3 -22
- package/dist/components/table/table-head.svelte +2 -8
- package/dist/components/table/table-head.svelte.d.ts +3 -22
- package/dist/components/table/table-part.svelte +2 -4
- package/dist/components/table/table-part.svelte.d.ts +3 -19
- package/dist/components/table/table-row-header.svelte +2 -8
- package/dist/components/table/table-row-header.svelte.d.ts +3 -22
- package/dist/components/table/table-row.svelte +2 -8
- package/dist/components/table/table-row.svelte.d.ts +3 -22
- package/dist/components/table/table.svelte +2 -4
- package/dist/components/table/table.svelte.d.ts +3 -19
- package/dist/components/tabs/tab-box.svelte +2 -4
- package/dist/components/tabs/tab-box.svelte.d.ts +3 -19
- package/dist/components/tabs/tab-list.svelte +2 -7
- package/dist/components/tabs/tab-list.svelte.d.ts +4 -37
- package/dist/components/tabs/tab-panel.svelte +2 -8
- package/dist/components/tabs/tab-panel.svelte.d.ts +3 -22
- package/dist/components/tabs/tab-panels.svelte +2 -8
- package/dist/components/tabs/tab-panels.svelte.d.ts +3 -22
- package/dist/components/text-editor/code-editor.js +14 -7
- package/dist/components/text-editor/code-editor.svelte +14 -22
- package/dist/components/text-editor/code-editor.svelte.d.ts +5 -103
- package/dist/components/text-editor/config.d.ts +73 -0
- package/dist/components/text-editor/config.js +110 -0
- package/dist/components/text-editor/conversion/editor-components.js +4 -4
- package/dist/components/text-editor/conversion/html/export.js +1 -1
- package/dist/components/text-editor/conversion/import.js +32 -26
- package/dist/components/text-editor/conversion/markdown/block-conversion.d.ts +4 -0
- package/dist/components/text-editor/conversion/markdown/block-conversion.js +154 -0
- package/dist/components/text-editor/conversion/markdown/block-structure.d.ts +16 -0
- package/dist/components/text-editor/conversion/markdown/block-structure.js +254 -0
- package/dist/components/text-editor/conversion/markdown/code-blocks.d.ts +57 -0
- package/dist/components/text-editor/conversion/markdown/code-blocks.js +279 -0
- package/dist/components/text-editor/conversion/markdown/code-spans.d.ts +19 -0
- package/dist/components/text-editor/conversion/markdown/code-spans.js +71 -0
- package/dist/components/text-editor/conversion/markdown/formatting.d.ts +22 -0
- package/dist/components/text-editor/conversion/markdown/formatting.js +451 -0
- package/dist/components/text-editor/conversion/markdown/index.d.ts +10 -0
- package/dist/components/text-editor/conversion/markdown/index.js +55 -0
- package/dist/components/text-editor/conversion/markdown/placeholders.d.ts +2 -0
- package/dist/components/text-editor/conversion/markdown/placeholders.js +229 -0
- package/dist/components/text-editor/conversion/markdown/syntax.d.ts +99 -0
- package/dist/components/text-editor/conversion/markdown/syntax.js +206 -0
- package/dist/components/text-editor/conversion/placeholder-chars.d.ts +43 -0
- package/dist/components/text-editor/conversion/placeholder-chars.js +51 -0
- package/dist/components/text-editor/conversion/transformers/block-escape.d.ts +1 -0
- package/dist/components/text-editor/conversion/transformers/block-escape.js +53 -26
- package/dist/components/text-editor/conversion/transformers/code.d.ts +3 -14
- package/dist/components/text-editor/conversion/transformers/code.js +78 -16
- package/dist/components/text-editor/conversion/transformers/formatted-code.js +3 -18
- package/dist/components/text-editor/conversion/transformers/inline-code.js +3 -1
- package/dist/components/text-editor/conversion/transformers/link.js +3 -1
- package/dist/components/text-editor/conversion/transformers/raw-syntax.d.ts +0 -19
- package/dist/components/text-editor/conversion/transformers/raw-syntax.js +22 -93
- package/dist/components/text-editor/conversion/transformers/table.js +57 -16
- package/dist/components/text-editor/conversion/update.d.ts +19 -2
- package/dist/components/text-editor/conversion/update.js +63 -39
- package/dist/components/text-editor/core.d.ts +12 -51
- package/dist/components/text-editor/core.js +44 -66
- package/dist/components/text-editor/editing/raw-markdown.d.ts +3 -0
- package/dist/components/text-editor/editing/raw-markdown.js +46 -2
- package/dist/components/text-editor/lexical-root.svelte +49 -47
- package/dist/components/text-editor/lexical-root.svelte.d.ts +4 -67
- package/dist/components/text-editor/shiki/{facade.d.ts → engine.d.ts} +8 -8
- package/dist/components/text-editor/shiki/{facade.js → engine.js} +53 -156
- package/dist/components/text-editor/shiki/highlighter.js +5 -5
- package/dist/components/text-editor/shiki/lexical.d.ts +6 -0
- package/dist/components/text-editor/shiki/lexical.js +165 -0
- package/dist/components/text-editor/shiki/preload.js +1 -1
- package/dist/components/text-editor/shiki/source-highlight.svelte.d.ts +15 -0
- package/dist/components/text-editor/shiki/source-highlight.svelte.js +120 -0
- package/dist/components/text-editor/shiki/version.d.ts +1 -1
- package/dist/components/text-editor/shiki/version.js +1 -1
- package/dist/components/text-editor/store.svelte.js +65 -16
- package/dist/components/text-editor/text-editor.svelte +53 -145
- package/dist/components/text-editor/text-editor.svelte.d.ts +5 -103
- package/dist/components/text-editor/toolbar/actions.d.ts +25 -0
- package/dist/components/text-editor/toolbar/actions.js +107 -0
- package/dist/components/text-editor/toolbar/align-menu-button.svelte +16 -14
- package/dist/components/text-editor/toolbar/format-text-button.svelte +26 -24
- package/dist/components/text-editor/toolbar/insert-horizontal-rule-button.svelte +23 -23
- package/dist/components/text-editor/toolbar/insert-item-button.svelte +1 -1
- package/dist/components/text-editor/toolbar/insert-link-button.svelte +47 -51
- package/dist/components/text-editor/toolbar/insert-menu-button.svelte +1 -1
- package/dist/components/text-editor/toolbar/insert-table-button.svelte +35 -52
- package/dist/components/text-editor/toolbar/table-action-menu.svelte +19 -17
- package/dist/components/text-editor/toolbar/text-editor-toolbar.svelte +16 -4
- package/dist/components/text-editor/toolbar/text-editor-toolbar.svelte.d.ts +0 -8
- package/dist/components/text-editor/toolbar/toggle-block-menu-item.svelte +34 -33
- package/dist/components/text-editor/widgets/emoji-autocomplete.svelte +7 -6
- package/dist/components/text-editor/widgets/floating-link-editor.svelte +19 -32
- package/dist/components/text-editor/widgets/table-cell-menu-button.svelte +28 -32
- package/dist/components/text-field/date-time-input.svelte +7 -8
- package/dist/components/text-field/date-time-input.svelte.d.ts +3 -32
- package/dist/components/text-field/number-input.d.ts +0 -2
- package/dist/components/text-field/number-input.js +25 -25
- package/dist/components/text-field/number-input.svelte +18 -9
- package/dist/components/text-field/number-input.svelte.d.ts +1 -1
- package/dist/components/text-field/text-area.d.ts +2 -0
- package/dist/components/text-field/text-area.js +31 -0
- package/dist/components/text-field/text-area.svelte +12 -25
- package/dist/components/text-field/text-area.svelte.d.ts +5 -67
- package/dist/components/toast/toast.svelte +31 -8
- package/dist/components/toast/toast.svelte.d.ts +6 -6
- package/dist/components/toolbar/toolbar.svelte +2 -7
- package/dist/components/toolbar/toolbar.svelte.d.ts +4 -37
- package/dist/components/tree/tree-item.svelte +2 -6
- package/dist/components/tree/tree-item.svelte.d.ts +3 -22
- package/dist/components/tree/tree.svelte +3 -10
- package/dist/components/tree/tree.svelte.d.ts +4 -39
- package/dist/components/util/group.svelte +2 -7
- package/dist/components/util/group.svelte.d.ts +4 -37
- package/dist/components/util/modal.d.ts +9 -0
- package/dist/components/util/modal.js +30 -0
- package/dist/components/util/modal.svelte +33 -14
- package/dist/index.d.ts +1 -1
- package/dist/index.js +1 -1
- package/dist/locales/hu.yaml +176 -0
- package/dist/services/composite-widget.svelte.d.ts +76 -0
- package/dist/services/composite-widget.svelte.js +157 -0
- package/dist/services/focus.d.ts +2 -0
- package/dist/services/focus.js +68 -0
- package/dist/services/group.svelte.d.ts +17 -69
- package/dist/services/group.svelte.js +128 -391
- package/dist/services/label.d.ts +9 -0
- package/dist/services/label.js +22 -0
- package/dist/services/menu.d.ts +8 -0
- package/dist/services/menu.js +237 -0
- package/dist/services/navigation.d.ts +9 -0
- package/dist/services/navigation.js +13 -0
- package/dist/services/number.d.ts +2 -0
- package/dist/services/number.js +27 -0
- package/dist/services/pointer-drag.d.ts +14 -0
- package/dist/services/pointer-drag.js +89 -0
- package/dist/services/popup.svelte.js +123 -103
- package/dist/services/text.d.ts +3 -0
- package/dist/services/text.js +17 -0
- package/dist/services/tree.svelte.d.ts +29 -43
- package/dist/services/tree.svelte.js +58 -105
- package/dist/services/type-ahead.d.ts +10 -1
- package/dist/services/type-ahead.js +56 -34
- package/dist/typedefs.d.ts +103 -4
- package/dist/typedefs.js +60 -4
- package/package.json +2 -2
- package/dist/components/text-editor/conversion/markdown.d.ts +0 -56
- package/dist/components/text-editor/conversion/markdown.js +0 -949
- package/dist/components/text-editor/toolbar/code-editor-toolbar.svelte +0 -28
- package/dist/components/text-editor/toolbar/code-editor-toolbar.svelte.d.ts +0 -37
- package/dist/components/text-editor/toolbar/insert-component.d.ts +0 -3
- package/dist/components/text-editor/toolbar/insert-component.js +0 -37
package/dist/services/label.d.ts
CHANGED
|
@@ -6,3 +6,12 @@ export function getToggleLabelAttrs({ id, ariaLabel, hasVisibleLabel }: {
|
|
|
6
6
|
"aria-label": string | undefined;
|
|
7
7
|
"aria-labelledby": string | undefined;
|
|
8
8
|
};
|
|
9
|
+
export function getModalLabelAttrs({ id, title, ariaLabelledby, hasCustomHeader }: {
|
|
10
|
+
id: string;
|
|
11
|
+
title: string | undefined;
|
|
12
|
+
ariaLabelledby: string | undefined;
|
|
13
|
+
hasCustomHeader: boolean;
|
|
14
|
+
}): {
|
|
15
|
+
"aria-label": string | undefined;
|
|
16
|
+
"aria-labelledby": string | undefined;
|
|
17
|
+
};
|
package/dist/services/label.js
CHANGED
|
@@ -13,3 +13,25 @@ export const getToggleLabelAttrs = ({ id, ariaLabel, hasVisibleLabel }) => ({
|
|
|
13
13
|
'aria-label': ariaLabel || undefined,
|
|
14
14
|
'aria-labelledby': !ariaLabel && hasVisibleLabel ? `${id}-label` : undefined,
|
|
15
15
|
});
|
|
16
|
+
|
|
17
|
+
/**
|
|
18
|
+
* Get the labelling attributes of the `<dialog>` in a `<Dialog>` or `<Drawer>`. The built-in header
|
|
19
|
+
* renders the title in an element the dialog can point at; with a custom header the title is only
|
|
20
|
+
* text, so it becomes `aria-label` unless the consumer names the labelling element.
|
|
21
|
+
* @param {object} args Arguments.
|
|
22
|
+
* @param {string} args.id Component ID. The title has the `${id}-title` ID.
|
|
23
|
+
* @param {string | undefined} args.title Title, if any.
|
|
24
|
+
* @param {string | undefined} args.ariaLabelledby ID of the labelling element named by the
|
|
25
|
+
* consumer, if any.
|
|
26
|
+
* @param {boolean} args.hasCustomHeader Whether the component has a custom header.
|
|
27
|
+
* @returns {{ 'aria-label': string | undefined, 'aria-labelledby': string | undefined }}
|
|
28
|
+
* Attributes.
|
|
29
|
+
*/
|
|
30
|
+
export const getModalLabelAttrs = ({ id, title, ariaLabelledby, hasCustomHeader }) => {
|
|
31
|
+
const labelledby = ariaLabelledby ?? (!hasCustomHeader && title ? `${id}-title` : undefined);
|
|
32
|
+
|
|
33
|
+
return {
|
|
34
|
+
'aria-label': labelledby ? undefined : title || undefined,
|
|
35
|
+
'aria-labelledby': labelledby,
|
|
36
|
+
};
|
|
37
|
+
};
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
export function getMenuOpener(element: HTMLElement): HTMLElement | null;
|
|
2
|
+
export function getParentMenuItem(menu: HTMLElement): HTMLElement | null;
|
|
3
|
+
export function closeMenuChain(menu: HTMLElement): HTMLElement | null;
|
|
4
|
+
export function leaveMenu(menu: HTMLElement, backwards: boolean): Promise<void>;
|
|
5
|
+
export function enterSubmenu(item: HTMLElement, selector: string): Promise<void>;
|
|
6
|
+
export function leaveSubmenu(item: HTMLElement): void;
|
|
7
|
+
export function handleMenuKey(group: Group, event: KeyboardEvent, currentTarget: HTMLElement | undefined): boolean;
|
|
8
|
+
import type { Group } from './group.svelte.js';
|
|
@@ -0,0 +1,237 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Menu behavior on top of the `Group` composite widget: leaving a menu with Tab, and stepping into
|
|
3
|
+
* and out of submenus with the inline arrows and Escape, per the ARIA Menu pattern.
|
|
4
|
+
* @see https://www.w3.org/WAI/ARIA/apg/patterns/menubar/
|
|
5
|
+
*/
|
|
6
|
+
|
|
7
|
+
import { isRTL } from '@sveltia/i18n';
|
|
8
|
+
import { sleep } from '@sveltia/utils/misc';
|
|
9
|
+
import { focusAdjacentTabStop } from './focus.js';
|
|
10
|
+
import { getArrowKeys, hasModifier, INACTIVE_MEMBER_SELECTOR } from './navigation.js';
|
|
11
|
+
|
|
12
|
+
/**
|
|
13
|
+
* @import { Group } from './group.svelte.js';
|
|
14
|
+
*/
|
|
15
|
+
|
|
16
|
+
/**
|
|
17
|
+
* Find the element that opens the menu the given element belongs to. A menu lives outside its
|
|
18
|
+
* opener in the DOM tree, so the link runs the other way: the opener points at the menu’s container
|
|
19
|
+
* with `aria-controls`.
|
|
20
|
+
* @internal
|
|
21
|
+
* @param {HTMLElement} element Element within the menu.
|
|
22
|
+
* @returns {HTMLElement | null} Menu button or parent menu item, if any.
|
|
23
|
+
*/
|
|
24
|
+
export const getMenuOpener = (element) => {
|
|
25
|
+
/** @type {HTMLElement | null} */
|
|
26
|
+
let current = element;
|
|
27
|
+
|
|
28
|
+
while (current) {
|
|
29
|
+
if (current.id) {
|
|
30
|
+
const opener = /** @type {HTMLElement | null} */ (
|
|
31
|
+
document.querySelector(`[aria-haspopup="menu"][aria-controls="${CSS.escape(current.id)}"]`)
|
|
32
|
+
);
|
|
33
|
+
|
|
34
|
+
if (opener) {
|
|
35
|
+
return opener;
|
|
36
|
+
}
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
current = current.parentElement;
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
return null;
|
|
43
|
+
};
|
|
44
|
+
|
|
45
|
+
/**
|
|
46
|
+
* Find the menu item that opens the given menu, when it’s a submenu. A menu button is deliberately
|
|
47
|
+
* excluded, because closing a top-level menu is not what “back to the parent item” means.
|
|
48
|
+
* @internal
|
|
49
|
+
* @param {HTMLElement} menu Menu element.
|
|
50
|
+
* @returns {HTMLElement | null} Parent menu item, if any.
|
|
51
|
+
*/
|
|
52
|
+
export const getParentMenuItem = (menu) => {
|
|
53
|
+
const opener = getMenuOpener(menu);
|
|
54
|
+
|
|
55
|
+
return opener?.matches('[role^="menuitem"]') ? opener : null;
|
|
56
|
+
};
|
|
57
|
+
|
|
58
|
+
/**
|
|
59
|
+
* Close the given menu along with every menu above it.
|
|
60
|
+
* @internal
|
|
61
|
+
* @param {HTMLElement} menu Menu element.
|
|
62
|
+
* @returns {HTMLElement | null} The element that opens the outermost menu, so the caller can hand
|
|
63
|
+
* focus back to it.
|
|
64
|
+
*/
|
|
65
|
+
export const closeMenuChain = (menu) => {
|
|
66
|
+
/** @type {HTMLElement | null} */
|
|
67
|
+
let opener = getMenuOpener(menu);
|
|
68
|
+
/** @type {HTMLElement | null} */
|
|
69
|
+
let outermost = null;
|
|
70
|
+
|
|
71
|
+
// Bounded, so a malformed `aria-controls` cycle can’t hang the page
|
|
72
|
+
for (let i = 0; i < 10 && opener; i += 1) {
|
|
73
|
+
outermost = opener;
|
|
74
|
+
|
|
75
|
+
if (opener.getAttribute('aria-expanded') === 'true') {
|
|
76
|
+
opener.click();
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
const parentMenu = /** @type {HTMLElement | null} */ (
|
|
80
|
+
opener.closest('[role="menu"], [role="menubar"]')
|
|
81
|
+
);
|
|
82
|
+
|
|
83
|
+
opener = parentMenu ? getMenuOpener(parentMenu) : null;
|
|
84
|
+
}
|
|
85
|
+
|
|
86
|
+
return outermost;
|
|
87
|
+
};
|
|
88
|
+
|
|
89
|
+
/**
|
|
90
|
+
* Leave the menu the way Tab should: close it along with every menu above it, then carry focus on
|
|
91
|
+
* to whatever follows the outermost opener. The browser can’t be left to do this itself, because a
|
|
92
|
+
* modal `<dialog>` confines Tab to its own contents.
|
|
93
|
+
* @internal
|
|
94
|
+
* @param {HTMLElement} menu Menu element.
|
|
95
|
+
* @param {boolean} backwards Whether to move to the previous tab stop instead, as Shift+Tab.
|
|
96
|
+
*/
|
|
97
|
+
export const leaveMenu = async (menu, backwards) => {
|
|
98
|
+
const opener = closeMenuChain(menu);
|
|
99
|
+
|
|
100
|
+
if (!opener) {
|
|
101
|
+
return;
|
|
102
|
+
}
|
|
103
|
+
|
|
104
|
+
// Somewhere to stand while the menu is torn down, and the fallback if there’s nothing beyond
|
|
105
|
+
opener.focus();
|
|
106
|
+
await sleep(50);
|
|
107
|
+
focusAdjacentTabStop(opener, backwards);
|
|
108
|
+
};
|
|
109
|
+
|
|
110
|
+
/**
|
|
111
|
+
* Open the submenu of the given menu item if needed, and move focus onto its first item.
|
|
112
|
+
* @internal
|
|
113
|
+
* @param {HTMLElement} item Menu item with `aria-haspopup="menu"`.
|
|
114
|
+
* @param {string} selector CSS selector matching the menu items.
|
|
115
|
+
*/
|
|
116
|
+
export const enterSubmenu = async (item, selector) => {
|
|
117
|
+
const submenuId = item.getAttribute('aria-controls');
|
|
118
|
+
|
|
119
|
+
if (!submenuId) {
|
|
120
|
+
return;
|
|
121
|
+
}
|
|
122
|
+
|
|
123
|
+
if (item.getAttribute('aria-expanded') !== 'true') {
|
|
124
|
+
item.click();
|
|
125
|
+
}
|
|
126
|
+
|
|
127
|
+
const submenu = document.getElementById(submenuId);
|
|
128
|
+
|
|
129
|
+
// The submenu is revealed and positioned asynchronously, and an element that is still hidden or
|
|
130
|
+
// invisible cannot take focus, so keep trying for a few frames
|
|
131
|
+
for (let i = 0; i < 20; i += 1) {
|
|
132
|
+
const first = /** @type {HTMLElement | undefined} */ (
|
|
133
|
+
[...(submenu?.querySelectorAll(selector) ?? [])].find(
|
|
134
|
+
(element) => !element.matches(INACTIVE_MEMBER_SELECTOR),
|
|
135
|
+
)
|
|
136
|
+
);
|
|
137
|
+
|
|
138
|
+
first?.focus();
|
|
139
|
+
|
|
140
|
+
if (first && document.activeElement === first) {
|
|
141
|
+
return;
|
|
142
|
+
}
|
|
143
|
+
|
|
144
|
+
// eslint-disable-next-line no-await-in-loop
|
|
145
|
+
await sleep(20);
|
|
146
|
+
}
|
|
147
|
+
};
|
|
148
|
+
|
|
149
|
+
/**
|
|
150
|
+
* Close a submenu and move focus back onto the menu item that opens it.
|
|
151
|
+
* @internal
|
|
152
|
+
* @param {HTMLElement} item Menu item with `aria-haspopup="menu"`.
|
|
153
|
+
*/
|
|
154
|
+
export const leaveSubmenu = (item) => {
|
|
155
|
+
if (item.getAttribute('aria-expanded') === 'true') {
|
|
156
|
+
item.click();
|
|
157
|
+
}
|
|
158
|
+
|
|
159
|
+
item.focus();
|
|
160
|
+
};
|
|
161
|
+
|
|
162
|
+
/**
|
|
163
|
+
* Handle the keys that only a menu responds to: Tab, which leaves the menu entirely rather than
|
|
164
|
+
* stepping through it, Escape, which dismisses just a submenu, and the inline arrows, which step
|
|
165
|
+
* into a submenu and back out again. Called by the group before its own handling, once it has left
|
|
166
|
+
* the keys pressed in a text field to that field.
|
|
167
|
+
* @internal
|
|
168
|
+
* @param {Group} group Menu or menubar group.
|
|
169
|
+
* @param {KeyboardEvent} event `keydown` event.
|
|
170
|
+
* @param {HTMLElement | undefined} currentTarget Member the key was pressed on, if any.
|
|
171
|
+
* @returns {boolean} Whether the key has been dealt with, so the group must leave it alone.
|
|
172
|
+
*/
|
|
173
|
+
export const handleMenuKey = (group, event, currentTarget) => {
|
|
174
|
+
const { key, ctrlKey, metaKey, shiftKey, altKey } = event;
|
|
175
|
+
const { parent } = group;
|
|
176
|
+
|
|
177
|
+
// Shift is allowed through here, unlike the keys below, because Shift+Tab leaves the menu just
|
|
178
|
+
// the same. A menu rendered inline, with no opener to return to, leaves Tab to the browser to
|
|
179
|
+
// move focus on as usual.
|
|
180
|
+
if (key === 'Tab' && !ctrlKey && !metaKey && !altKey) {
|
|
181
|
+
if (getMenuOpener(parent)) {
|
|
182
|
+
event.preventDefault();
|
|
183
|
+
leaveMenu(parent, shiftKey);
|
|
184
|
+
}
|
|
185
|
+
|
|
186
|
+
return true;
|
|
187
|
+
}
|
|
188
|
+
|
|
189
|
+
if (hasModifier(event)) {
|
|
190
|
+
return false;
|
|
191
|
+
}
|
|
192
|
+
|
|
193
|
+
// Escape in a submenu dismisses just that submenu. Propagation is stopped so the popup, whose own
|
|
194
|
+
// Escape handler sits on the `<dialog>` this submenu shares with its parent, doesn’t go on to
|
|
195
|
+
// close the whole stack.
|
|
196
|
+
if (key === 'Escape') {
|
|
197
|
+
const parentMenuItem = getParentMenuItem(parent);
|
|
198
|
+
|
|
199
|
+
if (parentMenuItem) {
|
|
200
|
+
event.preventDefault();
|
|
201
|
+
event.stopPropagation();
|
|
202
|
+
leaveSubmenu(parentMenuItem);
|
|
203
|
+
|
|
204
|
+
return true;
|
|
205
|
+
}
|
|
206
|
+
|
|
207
|
+
return false;
|
|
208
|
+
}
|
|
209
|
+
|
|
210
|
+
// Submenu traversal. In a vertical menu the inline arrows are free, so they step into a submenu
|
|
211
|
+
// and back out again, as the Menu pattern expects. Mirrored for RTL.
|
|
212
|
+
if (group.orientation !== 'vertical') {
|
|
213
|
+
return false;
|
|
214
|
+
}
|
|
215
|
+
|
|
216
|
+
const { prevKey: outOfSubmenuKey, nextKey: intoSubmenuKey } = getArrowKeys('horizontal', isRTL());
|
|
217
|
+
|
|
218
|
+
if (key === intoSubmenuKey && currentTarget?.getAttribute('aria-haspopup') === 'menu') {
|
|
219
|
+
event.preventDefault();
|
|
220
|
+
enterSubmenu(currentTarget, group.selector);
|
|
221
|
+
|
|
222
|
+
return true;
|
|
223
|
+
}
|
|
224
|
+
|
|
225
|
+
if (key === outOfSubmenuKey) {
|
|
226
|
+
const parentMenuItem = getParentMenuItem(parent);
|
|
227
|
+
|
|
228
|
+
if (parentMenuItem) {
|
|
229
|
+
event.preventDefault();
|
|
230
|
+
leaveSubmenu(parentMenuItem);
|
|
231
|
+
|
|
232
|
+
return true;
|
|
233
|
+
}
|
|
234
|
+
}
|
|
235
|
+
|
|
236
|
+
return false;
|
|
237
|
+
};
|
|
@@ -1,3 +1,12 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Arrow key navigation shared by the composite widgets. These functions only map a key and the
|
|
3
|
+
* current position to a new position; finding the members and moving focus is up to the caller.
|
|
4
|
+
*/
|
|
5
|
+
/**
|
|
6
|
+
* CSS selector matching the members that are disabled or hidden, which are left out of navigation.
|
|
7
|
+
*/
|
|
8
|
+
export const INACTIVE_MEMBER_SELECTOR: "[aria-disabled=\"true\"], [aria-hidden=\"true\"]";
|
|
9
|
+
export function hasModifier({ shiftKey, altKey, ctrlKey, metaKey }: KeyboardEvent): boolean;
|
|
1
10
|
export function getArrowKeys(orientation: string, rtl: boolean): {
|
|
2
11
|
prevKey: string;
|
|
3
12
|
nextKey: string;
|
|
@@ -3,6 +3,19 @@
|
|
|
3
3
|
* current position to a new position; finding the members and moving focus is up to the caller.
|
|
4
4
|
*/
|
|
5
5
|
|
|
6
|
+
/**
|
|
7
|
+
* CSS selector matching the members that are disabled or hidden, which are left out of navigation.
|
|
8
|
+
*/
|
|
9
|
+
export const INACTIVE_MEMBER_SELECTOR = '[aria-disabled="true"], [aria-hidden="true"]';
|
|
10
|
+
|
|
11
|
+
/**
|
|
12
|
+
* Check whether any modifier key — Shift, Alt, Control or Meta — is held down with a key press.
|
|
13
|
+
* @param {KeyboardEvent} event `keydown` event.
|
|
14
|
+
* @returns {boolean} Result.
|
|
15
|
+
*/
|
|
16
|
+
export const hasModifier = ({ shiftKey, altKey, ctrlKey, metaKey }) =>
|
|
17
|
+
shiftKey || altKey || ctrlKey || metaKey;
|
|
18
|
+
|
|
6
19
|
/**
|
|
7
20
|
* Get the arrow keys that move to the previous and next member along the given orientation. In a
|
|
8
21
|
* right-to-left layout, the inline arrows are mirrored: ArrowLeft moves forward, ArrowRight back.
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Number helpers shared by the components that step through a range of numbers, like
|
|
3
|
+
* `<NumberInput>` and `<Slider>`.
|
|
4
|
+
*/
|
|
5
|
+
|
|
6
|
+
/**
|
|
7
|
+
* Get the step to use, falling back to `1` for a value that isn’t a positive number, like `0`,
|
|
8
|
+
* `null` or `NaN`, which would leave the spin buttons and the arrow keys with nowhere to go.
|
|
9
|
+
* @param {number | null | undefined} step Step value.
|
|
10
|
+
* @returns {number} Positive step.
|
|
11
|
+
*/
|
|
12
|
+
export const normalizeStep = (step) =>
|
|
13
|
+
typeof step === 'number' && Number.isFinite(step) && step > 0 ? step : 1;
|
|
14
|
+
|
|
15
|
+
/**
|
|
16
|
+
* Count the fraction digits of a number, including one written in exponent notation, such as
|
|
17
|
+
* `1e-7`, so a value stepped by `0.1` can be rounded to `0.3` rather than `0.30000000000000004`.
|
|
18
|
+
* @param {number} num Number.
|
|
19
|
+
* @returns {number} Number of fraction digits, `0` for an integer.
|
|
20
|
+
*/
|
|
21
|
+
export const getMaximumFractionDigits = (num) => {
|
|
22
|
+
// A small number like `0.0000001` is stringified in exponent notation as `1e-7`
|
|
23
|
+
const [mantissa, exponent = '0'] = String(num).toLowerCase().split('e');
|
|
24
|
+
const digits = (mantissa.split('.')[1]?.length ?? 0) - Number(exponent);
|
|
25
|
+
|
|
26
|
+
return Math.max(digits, 0);
|
|
27
|
+
};
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
export function startPointerDrag(element: HTMLElement, { pointerId }: PointerEvent, { onMove, onEnd }: PointerDragHandlers): () => void;
|
|
2
|
+
export type PointerDragHandlers = {
|
|
3
|
+
/**
|
|
4
|
+
* Called with each `pointermove` event of the
|
|
5
|
+
* dragging pointer while the drag goes on.
|
|
6
|
+
*/
|
|
7
|
+
onMove?: ((event: PointerEvent) => void) | undefined;
|
|
8
|
+
/**
|
|
9
|
+
* Called once when the drag ends, with the
|
|
10
|
+
* `pointerup` or `pointercancel` event, or with the `pointermove` event of a mouse that no longer
|
|
11
|
+
* has the primary button held down.
|
|
12
|
+
*/
|
|
13
|
+
onEnd?: ((event: PointerEvent) => void) | undefined;
|
|
14
|
+
};
|
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Pointer drag lifecycle shared by the widgets that can be dragged, such as `<ResizableHandle>` and
|
|
3
|
+
* `<Slider>`.
|
|
4
|
+
*/
|
|
5
|
+
|
|
6
|
+
/**
|
|
7
|
+
* @typedef {object} PointerDragHandlers
|
|
8
|
+
* @property {(event: PointerEvent) => void} [onMove] Called with each `pointermove` event of the
|
|
9
|
+
* dragging pointer while the drag goes on.
|
|
10
|
+
* @property {(event: PointerEvent) => void} [onEnd] Called once when the drag ends, with the
|
|
11
|
+
* `pointerup` or `pointercancel` event, or with the `pointermove` event of a mouse that no longer
|
|
12
|
+
* has the primary button held down.
|
|
13
|
+
*/
|
|
14
|
+
|
|
15
|
+
/**
|
|
16
|
+
* Start dragging with the pointer that has just been pressed. The pointer is captured by the given
|
|
17
|
+
* element, and its moves and release are followed on the `document` until the drag ends. Events of
|
|
18
|
+
* other pointers are ignored.
|
|
19
|
+
* @internal
|
|
20
|
+
* @param {HTMLElement} element Element to capture the pointer.
|
|
21
|
+
* @param {PointerEvent} event `pointerdown` event that starts the drag.
|
|
22
|
+
* @param {PointerDragHandlers} handlers Event handlers.
|
|
23
|
+
* @returns {() => void} Function to stop following the pointer without calling `onEnd`, for example
|
|
24
|
+
* when the element is removed in the middle of a drag. It does nothing once the drag has ended.
|
|
25
|
+
*/
|
|
26
|
+
export const startPointerDrag = (element, { pointerId }, { onMove, onEnd }) => {
|
|
27
|
+
/**
|
|
28
|
+
* Stop following the pointer, and release it.
|
|
29
|
+
*/
|
|
30
|
+
const stop = () => {
|
|
31
|
+
// eslint-disable-next-line no-use-before-define
|
|
32
|
+
document.removeEventListener('pointermove', onPointerMove);
|
|
33
|
+
// eslint-disable-next-line no-use-before-define
|
|
34
|
+
document.removeEventListener('pointerup', onPointerUp);
|
|
35
|
+
// eslint-disable-next-line no-use-before-define
|
|
36
|
+
document.removeEventListener('pointercancel', onPointerUp);
|
|
37
|
+
|
|
38
|
+
if (element.hasPointerCapture(pointerId)) {
|
|
39
|
+
element.releasePointerCapture(pointerId);
|
|
40
|
+
}
|
|
41
|
+
};
|
|
42
|
+
|
|
43
|
+
/**
|
|
44
|
+
* End the drag.
|
|
45
|
+
* @param {PointerEvent} event Event that ends the drag.
|
|
46
|
+
*/
|
|
47
|
+
const end = (event) => {
|
|
48
|
+
stop();
|
|
49
|
+
onEnd?.(event);
|
|
50
|
+
};
|
|
51
|
+
|
|
52
|
+
/**
|
|
53
|
+
* Handle the `pointermove` event fired anywhere on the page.
|
|
54
|
+
* @param {PointerEvent} event `pointermove` event.
|
|
55
|
+
*/
|
|
56
|
+
const onPointerMove = (event) => {
|
|
57
|
+
if (event.pointerId !== pointerId) {
|
|
58
|
+
return;
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
// The `pointerup` event may never come, for example when a context menu opened during the drag
|
|
62
|
+
// swallowed it, so a mouse moved without the primary button held down ends the drag instead of
|
|
63
|
+
// carrying on. The primary button is the lowest bit of `buttons`.
|
|
64
|
+
if (event.pointerType === 'mouse' && event.buttons % 2 === 0) {
|
|
65
|
+
end(event);
|
|
66
|
+
|
|
67
|
+
return;
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
onMove?.(event);
|
|
71
|
+
};
|
|
72
|
+
|
|
73
|
+
/**
|
|
74
|
+
* Handle the `pointerup` and `pointercancel` events fired anywhere on the page.
|
|
75
|
+
* @param {PointerEvent} event `pointerup` or `pointercancel` event.
|
|
76
|
+
*/
|
|
77
|
+
const onPointerUp = (event) => {
|
|
78
|
+
if (event.pointerId === pointerId) {
|
|
79
|
+
end(event);
|
|
80
|
+
}
|
|
81
|
+
};
|
|
82
|
+
|
|
83
|
+
element.setPointerCapture(pointerId);
|
|
84
|
+
document.addEventListener('pointermove', onPointerMove);
|
|
85
|
+
document.addEventListener('pointerup', onPointerUp);
|
|
86
|
+
document.addEventListener('pointercancel', onPointerUp);
|
|
87
|
+
|
|
88
|
+
return stop;
|
|
89
|
+
};
|