@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
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @import { Attachment } from 'svelte/attachments';
|
|
3
|
+
*/
|
|
4
|
+
/**
|
|
5
|
+
* Lifecycle shared by the composite widgets: the `Initializing` and `Initialized` events, the
|
|
6
|
+
* delayed activation that gives the child components time to mount, the event listeners that
|
|
7
|
+
* activate the widget before handling an event that comes first, and the clean-up.
|
|
8
|
+
*/
|
|
9
|
+
export class CompositeWidget {
|
|
10
|
+
/**
|
|
11
|
+
* Initialize a new `CompositeWidget` instance, and schedule its activation.
|
|
12
|
+
* @param {HTMLElement} parent Widget root element.
|
|
13
|
+
*/
|
|
14
|
+
constructor(parent: HTMLElement);
|
|
15
|
+
/**
|
|
16
|
+
* Whether {@link activate} has run. Until then, members are left as they are rendered.
|
|
17
|
+
* @type {boolean}
|
|
18
|
+
*/
|
|
19
|
+
activated: boolean;
|
|
20
|
+
/**
|
|
21
|
+
* Whether {@link destroy} has run, so a pending {@link activate} must not run.
|
|
22
|
+
* @type {boolean}
|
|
23
|
+
*/
|
|
24
|
+
destroyed: boolean;
|
|
25
|
+
/**
|
|
26
|
+
* Keystroke buffer for type-ahead.
|
|
27
|
+
* @type {TypeAhead}
|
|
28
|
+
*/
|
|
29
|
+
typeAheadBuffer: TypeAhead;
|
|
30
|
+
parent: HTMLElement;
|
|
31
|
+
/**
|
|
32
|
+
* Listen to an event on the widget root until {@link destroy} is called. The widget is activated
|
|
33
|
+
* before the event is handled, so an event that comes before the delayed activation isn’t lost.
|
|
34
|
+
* @template {keyof HTMLElementEventMap} K
|
|
35
|
+
* @param {K} type Event type.
|
|
36
|
+
* @param {(event: HTMLElementEventMap[K]) => void} handler Event handler.
|
|
37
|
+
*/
|
|
38
|
+
listen<K extends keyof HTMLElementEventMap>(type: K, handler: (event: HTMLElementEventMap[K]) => void): void;
|
|
39
|
+
/**
|
|
40
|
+
* Activate the members, unless they already are.
|
|
41
|
+
*/
|
|
42
|
+
activate(): void;
|
|
43
|
+
/**
|
|
44
|
+
* Set up the members on activation. To be implemented by the subclass.
|
|
45
|
+
*/
|
|
46
|
+
setUp(): void;
|
|
47
|
+
/**
|
|
48
|
+
* Called whenever the params passed to the attachment are updated. To be implemented by the
|
|
49
|
+
* subclass.
|
|
50
|
+
* @param {Record<string, any>} _params Updated params.
|
|
51
|
+
*/
|
|
52
|
+
onUpdate(_params: Record<string, any>): void;
|
|
53
|
+
/**
|
|
54
|
+
* Whether the widget is disabled.
|
|
55
|
+
* @type {boolean}
|
|
56
|
+
*/
|
|
57
|
+
get isDisabled(): boolean;
|
|
58
|
+
/**
|
|
59
|
+
* Whether the widget is read-only.
|
|
60
|
+
* @type {boolean}
|
|
61
|
+
*/
|
|
62
|
+
get isReadOnly(): boolean;
|
|
63
|
+
/**
|
|
64
|
+
* Notify a change of the selection on the widget root.
|
|
65
|
+
* @param {HTMLElement} item Member that triggered the change.
|
|
66
|
+
*/
|
|
67
|
+
dispatchChange(item: HTMLElement): void;
|
|
68
|
+
/**
|
|
69
|
+
* Clean up event listeners.
|
|
70
|
+
*/
|
|
71
|
+
destroy(): void;
|
|
72
|
+
#private;
|
|
73
|
+
}
|
|
74
|
+
export function createWidgetAttachment<W extends CompositeWidget>(Widget: new (parent: HTMLElement, params?: any) => W): (paramsOrGetter?: object | (() => object)) => Attachment;
|
|
75
|
+
import { TypeAhead } from './type-ahead.js';
|
|
76
|
+
import type { Attachment } from 'svelte/attachments';
|
|
@@ -0,0 +1,157 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Base class shared by the composite widgets, `Group` and `Tree`, along with the attachment factory
|
|
3
|
+
* that mounts them.
|
|
4
|
+
*/
|
|
5
|
+
|
|
6
|
+
import { untrack } from 'svelte';
|
|
7
|
+
import { getSelectedItemDetail } from './select.svelte.js';
|
|
8
|
+
import { TypeAhead } from './type-ahead.js';
|
|
9
|
+
import { activateBefore, activateLater } from './widget.js';
|
|
10
|
+
|
|
11
|
+
/**
|
|
12
|
+
* @import { Attachment } from 'svelte/attachments';
|
|
13
|
+
*/
|
|
14
|
+
|
|
15
|
+
/**
|
|
16
|
+
* Lifecycle shared by the composite widgets: the `Initializing` and `Initialized` events, the
|
|
17
|
+
* delayed activation that gives the child components time to mount, the event listeners that
|
|
18
|
+
* activate the widget before handling an event that comes first, and the clean-up.
|
|
19
|
+
*/
|
|
20
|
+
export class CompositeWidget {
|
|
21
|
+
/**
|
|
22
|
+
* Whether {@link activate} has run. Until then, members are left as they are rendered.
|
|
23
|
+
* @type {boolean}
|
|
24
|
+
*/
|
|
25
|
+
activated = false;
|
|
26
|
+
|
|
27
|
+
/**
|
|
28
|
+
* Whether {@link destroy} has run, so a pending {@link activate} must not run.
|
|
29
|
+
* @type {boolean}
|
|
30
|
+
*/
|
|
31
|
+
destroyed = false;
|
|
32
|
+
|
|
33
|
+
/**
|
|
34
|
+
* Keystroke buffer for type-ahead.
|
|
35
|
+
* @type {TypeAhead}
|
|
36
|
+
*/
|
|
37
|
+
typeAheadBuffer = new TypeAhead();
|
|
38
|
+
|
|
39
|
+
/**
|
|
40
|
+
* Controller whose signal removes every listener added with {@link listen} once aborted.
|
|
41
|
+
* @type {AbortController}
|
|
42
|
+
*/
|
|
43
|
+
#controller = new AbortController();
|
|
44
|
+
|
|
45
|
+
/**
|
|
46
|
+
* Initialize a new `CompositeWidget` instance, and schedule its activation.
|
|
47
|
+
* @param {HTMLElement} parent Widget root element.
|
|
48
|
+
*/
|
|
49
|
+
constructor(parent) {
|
|
50
|
+
parent.dispatchEvent(new CustomEvent('Initializing'));
|
|
51
|
+
|
|
52
|
+
this.parent = parent;
|
|
53
|
+
|
|
54
|
+
// Wait a bit before the relevant components, including the `aria-controls` targets, are
|
|
55
|
+
// mounted. If the widget is unmounted in the meantime, nothing is set up.
|
|
56
|
+
activateLater(this, () => this.destroyed);
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
/**
|
|
60
|
+
* Listen to an event on the widget root until {@link destroy} is called. The widget is activated
|
|
61
|
+
* before the event is handled, so an event that comes before the delayed activation isn’t lost.
|
|
62
|
+
* @template {keyof HTMLElementEventMap} K
|
|
63
|
+
* @param {K} type Event type.
|
|
64
|
+
* @param {(event: HTMLElementEventMap[K]) => void} handler Event handler.
|
|
65
|
+
*/
|
|
66
|
+
listen(type, handler) {
|
|
67
|
+
this.parent.addEventListener(type, activateBefore(this, handler), {
|
|
68
|
+
signal: this.#controller.signal,
|
|
69
|
+
});
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
/**
|
|
73
|
+
* Activate the members, unless they already are.
|
|
74
|
+
*/
|
|
75
|
+
activate() {
|
|
76
|
+
if (this.activated) {
|
|
77
|
+
return;
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
this.activated = true;
|
|
81
|
+
this.setUp();
|
|
82
|
+
this.parent.dispatchEvent(new CustomEvent('Initialized'));
|
|
83
|
+
}
|
|
84
|
+
|
|
85
|
+
/**
|
|
86
|
+
* Set up the members on activation. To be implemented by the subclass.
|
|
87
|
+
*/
|
|
88
|
+
setUp() {}
|
|
89
|
+
|
|
90
|
+
/**
|
|
91
|
+
* Called whenever the params passed to the attachment are updated. To be implemented by the
|
|
92
|
+
* subclass.
|
|
93
|
+
* @param {Record<string, any>} _params Updated params.
|
|
94
|
+
*/
|
|
95
|
+
// eslint-disable-next-line no-unused-vars
|
|
96
|
+
onUpdate(_params) {}
|
|
97
|
+
|
|
98
|
+
/**
|
|
99
|
+
* Whether the widget is disabled.
|
|
100
|
+
* @type {boolean}
|
|
101
|
+
*/
|
|
102
|
+
get isDisabled() {
|
|
103
|
+
return this.parent.matches('[aria-disabled="true"]');
|
|
104
|
+
}
|
|
105
|
+
|
|
106
|
+
/**
|
|
107
|
+
* Whether the widget is read-only.
|
|
108
|
+
* @type {boolean}
|
|
109
|
+
*/
|
|
110
|
+
get isReadOnly() {
|
|
111
|
+
return this.parent.matches('[aria-readonly="true"]');
|
|
112
|
+
}
|
|
113
|
+
|
|
114
|
+
/**
|
|
115
|
+
* Notify a change of the selection on the widget root.
|
|
116
|
+
* @param {HTMLElement} item Member that triggered the change.
|
|
117
|
+
*/
|
|
118
|
+
dispatchChange(item) {
|
|
119
|
+
this.parent.dispatchEvent(new CustomEvent('Change', { detail: getSelectedItemDetail(item) }));
|
|
120
|
+
}
|
|
121
|
+
|
|
122
|
+
/**
|
|
123
|
+
* Clean up event listeners.
|
|
124
|
+
*/
|
|
125
|
+
destroy() {
|
|
126
|
+
this.destroyed = true;
|
|
127
|
+
this.#controller.abort();
|
|
128
|
+
this.typeAheadBuffer.reset();
|
|
129
|
+
}
|
|
130
|
+
}
|
|
131
|
+
|
|
132
|
+
/**
|
|
133
|
+
* Create an attachment factory for the given composite widget class.
|
|
134
|
+
* @template {CompositeWidget} W
|
|
135
|
+
* @param {new (parent: HTMLElement, params?: any) => W} Widget Widget class.
|
|
136
|
+
* @returns {(paramsOrGetter?: object | (() => object)) => Attachment} Function that takes a params
|
|
137
|
+
* object, or a getter function for reactive params, and returns an attachment.
|
|
138
|
+
*/
|
|
139
|
+
export const createWidgetAttachment = (Widget) => (paramsOrGetter) => (parent) => {
|
|
140
|
+
const isGetter = typeof paramsOrGetter === 'function';
|
|
141
|
+
// Read the params without tracking them: attachments run in an effect, so a tracked read would
|
|
142
|
+
// destroy and recreate the whole widget whenever they change, e.g. on every search keystroke.
|
|
143
|
+
// Changes are handled by `onUpdate()` below instead.
|
|
144
|
+
const initialParams = isGetter ? untrack(() => paramsOrGetter()) : paramsOrGetter;
|
|
145
|
+
const widget = new Widget(/** @type {HTMLElement} */ (parent), initialParams);
|
|
146
|
+
|
|
147
|
+
/* v8 ignore next 4 */
|
|
148
|
+
if (isGetter) {
|
|
149
|
+
$effect(() => {
|
|
150
|
+
widget.onUpdate(paramsOrGetter());
|
|
151
|
+
});
|
|
152
|
+
}
|
|
153
|
+
|
|
154
|
+
return () => {
|
|
155
|
+
widget.destroy();
|
|
156
|
+
};
|
|
157
|
+
};
|
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Focus management shared by the composite widgets and the overlays.
|
|
3
|
+
*/
|
|
4
|
+
|
|
5
|
+
/**
|
|
6
|
+
* Selector for the elements that can hold focus.
|
|
7
|
+
*/
|
|
8
|
+
const FOCUSABLE_SELECTOR = 'a[href], button, input, select, textarea, summary, [tabindex]';
|
|
9
|
+
|
|
10
|
+
/**
|
|
11
|
+
* Move focus to the tab stop next to the given element in document order. Positive `tabindex`
|
|
12
|
+
* values, which reorder the sequence, are not accounted for; they’re discouraged and absent from
|
|
13
|
+
* this library.
|
|
14
|
+
*
|
|
15
|
+
* The candidates are narrowed by attribute alone before any of them is measured, and the measuring
|
|
16
|
+
* — `getClientRects()`, which forces the browser to lay the page out — then walks outward from the
|
|
17
|
+
* element and stops at the first candidate that is actually rendered. Measuring every focusable
|
|
18
|
+
* element in the document up front is what a menu sitting on a large page cannot afford.
|
|
19
|
+
* @internal
|
|
20
|
+
* @param {HTMLElement} element Element to start from.
|
|
21
|
+
* @param {boolean} backwards Whether to move to the previous tab stop rather than the next.
|
|
22
|
+
*/
|
|
23
|
+
export const focusAdjacentTabStop = (element, backwards) => {
|
|
24
|
+
const candidates = /** @type {HTMLElement[]} */ ([
|
|
25
|
+
...document.querySelectorAll(FOCUSABLE_SELECTOR),
|
|
26
|
+
]).filter(
|
|
27
|
+
(candidate) =>
|
|
28
|
+
candidate === element ||
|
|
29
|
+
(candidate.tabIndex >= 0 &&
|
|
30
|
+
!candidate.matches(':disabled, [aria-disabled="true"], [hidden], [inert], [inert] *')),
|
|
31
|
+
);
|
|
32
|
+
|
|
33
|
+
const index = candidates.indexOf(element);
|
|
34
|
+
|
|
35
|
+
if (index === -1) {
|
|
36
|
+
return;
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
const step = backwards ? -1 : 1;
|
|
40
|
+
|
|
41
|
+
for (let i = index + step; i >= 0 && i < candidates.length; i += step) {
|
|
42
|
+
if (candidates[i].getClientRects().length) {
|
|
43
|
+
candidates[i].focus();
|
|
44
|
+
|
|
45
|
+
return;
|
|
46
|
+
}
|
|
47
|
+
}
|
|
48
|
+
};
|
|
49
|
+
|
|
50
|
+
/**
|
|
51
|
+
* Move focus back to the given element once an overlay has closed — but only if focus is still
|
|
52
|
+
* inside the overlay, or nowhere because the overlay took it down with itself. If it has already
|
|
53
|
+
* moved on — the user tabbed out of a menu, say — pulling it back would undo what they just did.
|
|
54
|
+
* @internal
|
|
55
|
+
* @param {HTMLElement} element Element to move focus to, typically the one that opened the overlay.
|
|
56
|
+
* @param {HTMLElement | null | undefined} container Overlay element.
|
|
57
|
+
*/
|
|
58
|
+
export const restoreFocus = (element, container) => {
|
|
59
|
+
const { activeElement } = document;
|
|
60
|
+
|
|
61
|
+
if (!element.isConnected) {
|
|
62
|
+
return;
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
if (!activeElement || activeElement === document.body || container?.contains(activeElement)) {
|
|
66
|
+
element.focus();
|
|
67
|
+
}
|
|
68
|
+
};
|
|
@@ -1,7 +1,8 @@
|
|
|
1
|
+
export function setFocusedMember(parent: HTMLElement, element: HTMLElement): void;
|
|
1
2
|
/**
|
|
2
3
|
* Implement keyboard and mouse interactions for a grouping composite widget.
|
|
3
4
|
*/
|
|
4
|
-
export class Group {
|
|
5
|
+
export class Group extends CompositeWidget {
|
|
5
6
|
/**
|
|
6
7
|
* Initialize a new `Group` instance.
|
|
7
8
|
* @param {HTMLElement} parent Parent element.
|
|
@@ -11,26 +12,16 @@ export class Group {
|
|
|
11
12
|
constructor(parent: HTMLElement, { clickToSelect }?: {
|
|
12
13
|
clickToSelect?: boolean | undefined;
|
|
13
14
|
});
|
|
14
|
-
/**
|
|
15
|
-
* Whether {@link activate} has run. Until then, members are left as they are rendered.
|
|
16
|
-
* @type {boolean}
|
|
17
|
-
*/
|
|
18
|
-
activated: boolean;
|
|
19
15
|
/**
|
|
20
16
|
* Observer of the members’ selected state, for the widgets whose panels or tab stop follow it.
|
|
21
17
|
* @type {MutationObserver | undefined}
|
|
22
18
|
*/
|
|
23
19
|
selectionObserver: MutationObserver | undefined;
|
|
24
|
-
parent: HTMLElement;
|
|
25
20
|
role: string;
|
|
26
21
|
multi: boolean;
|
|
27
22
|
id: string;
|
|
28
23
|
parentGroupSelector: string;
|
|
29
24
|
clickToSelect: boolean;
|
|
30
|
-
/** @type {(event: MouseEvent) => void} */
|
|
31
|
-
_onClick: (event: MouseEvent) => void;
|
|
32
|
-
/** @type {(event: KeyboardEvent) => void} */
|
|
33
|
-
_onKeyDown: (event: KeyboardEvent) => void;
|
|
34
25
|
orientation: string;
|
|
35
26
|
childRoles: string[];
|
|
36
27
|
childSelectedAttr: "aria-selected" | "aria-checked";
|
|
@@ -55,10 +46,6 @@ export class Group {
|
|
|
55
46
|
*/
|
|
56
47
|
rovingTabStop: "selected" | "first";
|
|
57
48
|
observer: MutationObserver;
|
|
58
|
-
/**
|
|
59
|
-
* Activate the members, unless they already are.
|
|
60
|
-
*/
|
|
61
|
-
activate(): void;
|
|
62
49
|
/**
|
|
63
50
|
* Put exactly one member in the tab sequence, as a composite widget should. Giving every checked
|
|
64
51
|
* member `tabindex="0"` would scatter tab stops through the widget — a menu with two checked
|
|
@@ -92,55 +79,11 @@ export class Group {
|
|
|
92
79
|
* @type {HTMLElement[]}
|
|
93
80
|
*/
|
|
94
81
|
get activeMembers(): HTMLElement[];
|
|
95
|
-
/**
|
|
96
|
-
* The element that opens this menu, either a menu button or a menu item in the menu above.
|
|
97
|
-
* @type {HTMLElement | null}
|
|
98
|
-
*/
|
|
99
|
-
get opener(): HTMLElement | null;
|
|
100
|
-
/**
|
|
101
|
-
* The menu item that opens this menu, when this menu is a submenu. A menu button is deliberately
|
|
102
|
-
* excluded, because closing a top-level menu is not what “back to the parent item” means.
|
|
103
|
-
* @type {HTMLElement | null}
|
|
104
|
-
*/
|
|
105
|
-
get parentMenuItem(): HTMLElement | null;
|
|
106
|
-
/**
|
|
107
|
-
* Close this menu along with every menu above it.
|
|
108
|
-
* @returns {HTMLElement | null} The element that opens the outermost menu, so the caller can
|
|
109
|
-
* hand focus back to it.
|
|
110
|
-
*/
|
|
111
|
-
closeMenuChain(): HTMLElement | null;
|
|
112
|
-
/**
|
|
113
|
-
* Leave the menu the way Tab should: close it along with every menu above it, then carry focus on
|
|
114
|
-
* to whatever follows the outermost opener. The browser can’t be left to do this itself, because
|
|
115
|
-
* a modal `<dialog>` confines Tab to its own contents.
|
|
116
|
-
* @param {boolean} backwards Whether to move to the previous tab stop instead, as Shift+Tab.
|
|
117
|
-
*/
|
|
118
|
-
leaveMenu(backwards: boolean): Promise<void>;
|
|
119
|
-
/**
|
|
120
|
-
* Open the submenu of the given menu item if needed, and move focus onto its first item.
|
|
121
|
-
* @param {HTMLElement} item Menu item with `aria-haspopup="menu"`.
|
|
122
|
-
*/
|
|
123
|
-
enterSubmenu(item: HTMLElement): Promise<void>;
|
|
124
|
-
/**
|
|
125
|
-
* Close this submenu and move focus back onto the menu item that opens it.
|
|
126
|
-
* @param {HTMLElement} item Menu item with `aria-haspopup="menu"`.
|
|
127
|
-
*/
|
|
128
|
-
leaveSubmenu(item: HTMLElement): void;
|
|
129
82
|
/**
|
|
130
83
|
* Get the currently selected member.
|
|
131
84
|
* @type {HTMLElement | undefined}
|
|
132
85
|
*/
|
|
133
86
|
get selected(): HTMLElement | undefined;
|
|
134
|
-
/**
|
|
135
|
-
* Whether the parent is disabled.
|
|
136
|
-
* @type {boolean}
|
|
137
|
-
*/
|
|
138
|
-
get isDisabled(): boolean;
|
|
139
|
-
/**
|
|
140
|
-
* Whether the parent is read-only.
|
|
141
|
-
* @type {boolean}
|
|
142
|
-
*/
|
|
143
|
-
get isReadOnly(): boolean;
|
|
144
87
|
/**
|
|
145
88
|
* Whether the widget is displayed in grid mode.
|
|
146
89
|
* @type {boolean}
|
|
@@ -169,17 +112,22 @@ export class Group {
|
|
|
169
112
|
*/
|
|
170
113
|
onKeyDown(event: KeyboardEvent): void;
|
|
171
114
|
/**
|
|
172
|
-
*
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
*
|
|
177
|
-
* @param {
|
|
115
|
+
* Called whenever the params are updated. Apply `clickToSelect` if given, and filter the items
|
|
116
|
+
* based on the search terms if given.
|
|
117
|
+
* @override
|
|
118
|
+
* @param {object} params Updated params.
|
|
119
|
+
* @param {string} [params.searchTerms] Search terms.
|
|
120
|
+
* @param {boolean} [params.clickToSelect] Whether to select an item by clicking on it.
|
|
178
121
|
*/
|
|
179
|
-
onUpdate(
|
|
180
|
-
searchTerms
|
|
122
|
+
override onUpdate(params: {
|
|
123
|
+
searchTerms?: string | undefined;
|
|
124
|
+
clickToSelect?: boolean | undefined;
|
|
181
125
|
}): void;
|
|
182
126
|
#private;
|
|
183
127
|
}
|
|
184
|
-
|
|
185
|
-
|
|
128
|
+
/**
|
|
129
|
+
* Activate a new group. Takes a params object, or a getter function for reactive params, and
|
|
130
|
+
* returns an attachment.
|
|
131
|
+
*/
|
|
132
|
+
export const activateGroup: (paramsOrGetter?: object | (() => object) | undefined) => import("svelte/attachments").Attachment;
|
|
133
|
+
import { CompositeWidget } from './composite-widget.svelte.js';
|