@firstprateek/vastu 0.0.0-stage → 1.1.0
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/LICENSE +15 -0
- package/README.md +52 -2
- package/custom-elements.json +3737 -0
- package/dist/dev/all.d.ts +12 -0
- package/dist/dev/all.d.ts.map +1 -0
- package/dist/dev/all.js +13 -0
- package/dist/dev/all.js.map +1 -0
- package/dist/dev/bar-chart/bar-chart.d.ts +63 -0
- package/dist/dev/bar-chart/bar-chart.d.ts.map +1 -0
- package/dist/dev/bar-chart/bar-chart.js +316 -0
- package/dist/dev/bar-chart/bar-chart.js.map +1 -0
- package/dist/dev/bar-chart/index.d.ts +3 -0
- package/dist/dev/bar-chart/index.d.ts.map +1 -0
- package/dist/dev/bar-chart/index.js +5 -0
- package/dist/dev/bar-chart/index.js.map +1 -0
- package/dist/dev/button/button.d.ts +98 -0
- package/dist/dev/button/button.d.ts.map +1 -0
- package/dist/dev/button/button.js +292 -0
- package/dist/dev/button/button.js.map +1 -0
- package/dist/dev/button/index.d.ts +4 -0
- package/dist/dev/button/index.d.ts.map +1 -0
- package/dist/dev/button/index.js +5 -0
- package/dist/dev/button/index.js.map +1 -0
- package/dist/dev/checkbox/checkbox.d.ts +71 -0
- package/dist/dev/checkbox/checkbox.d.ts.map +1 -0
- package/dist/dev/checkbox/checkbox.js +232 -0
- package/dist/dev/checkbox/checkbox.js.map +1 -0
- package/dist/dev/checkbox/index.d.ts +3 -0
- package/dist/dev/checkbox/index.d.ts.map +1 -0
- package/dist/dev/checkbox/index.js +5 -0
- package/dist/dev/checkbox/index.js.map +1 -0
- package/dist/dev/core/cssom.d.ts +15 -0
- package/dist/dev/core/cssom.d.ts.map +1 -0
- package/dist/dev/core/cssom.js +30 -0
- package/dist/dev/core/cssom.js.map +1 -0
- package/dist/dev/core/define.d.ts +3 -0
- package/dist/dev/core/define.d.ts.map +1 -0
- package/dist/dev/core/define.js +6 -0
- package/dist/dev/core/define.js.map +1 -0
- package/dist/dev/core/dev-mode.d.ts +6 -0
- package/dist/dev/core/dev-mode.d.ts.map +1 -0
- package/dist/dev/core/dev-mode.js +6 -0
- package/dist/dev/core/dev-mode.js.map +1 -0
- package/dist/dev/core/focus-ring.d.ts +3 -0
- package/dist/dev/core/focus-ring.d.ts.map +1 -0
- package/dist/dev/core/focus-ring.js +14 -0
- package/dist/dev/core/focus-ring.js.map +1 -0
- package/dist/dev/core/form-control.d.ts +47 -0
- package/dist/dev/core/form-control.d.ts.map +1 -0
- package/dist/dev/core/form-control.js +75 -0
- package/dist/dev/core/form-control.js.map +1 -0
- package/dist/dev/core/warn.d.ts +12 -0
- package/dist/dev/core/warn.d.ts.map +1 -0
- package/dist/dev/core/warn.js +35 -0
- package/dist/dev/core/warn.js.map +1 -0
- package/dist/dev/dialog/dialog.d.ts +77 -0
- package/dist/dev/dialog/dialog.d.ts.map +1 -0
- package/dist/dev/dialog/dialog.js +253 -0
- package/dist/dev/dialog/dialog.js.map +1 -0
- package/dist/dev/dialog/index.d.ts +4 -0
- package/dist/dev/dialog/index.d.ts.map +1 -0
- package/dist/dev/dialog/index.js +5 -0
- package/dist/dev/dialog/index.js.map +1 -0
- package/dist/dev/menu/index.d.ts +3 -0
- package/dist/dev/menu/index.d.ts.map +1 -0
- package/dist/dev/menu/index.js +5 -0
- package/dist/dev/menu/index.js.map +1 -0
- package/dist/dev/menu/menu.d.ts +71 -0
- package/dist/dev/menu/menu.d.ts.map +1 -0
- package/dist/dev/menu/menu.js +330 -0
- package/dist/dev/menu/menu.js.map +1 -0
- package/dist/dev/navbar/index.d.ts +3 -0
- package/dist/dev/navbar/index.d.ts.map +1 -0
- package/dist/dev/navbar/index.js +5 -0
- package/dist/dev/navbar/index.js.map +1 -0
- package/dist/dev/navbar/navbar.d.ts +69 -0
- package/dist/dev/navbar/navbar.d.ts.map +1 -0
- package/dist/dev/navbar/navbar.js +353 -0
- package/dist/dev/navbar/navbar.js.map +1 -0
- package/dist/dev/poll/index.d.ts +3 -0
- package/dist/dev/poll/index.d.ts.map +1 -0
- package/dist/dev/poll/index.js +5 -0
- package/dist/dev/poll/index.js.map +1 -0
- package/dist/dev/poll/poll.d.ts +67 -0
- package/dist/dev/poll/poll.d.ts.map +1 -0
- package/dist/dev/poll/poll.js +301 -0
- package/dist/dev/poll/poll.js.map +1 -0
- package/dist/dev/switch/index.d.ts +3 -0
- package/dist/dev/switch/index.d.ts.map +1 -0
- package/dist/dev/switch/index.js +5 -0
- package/dist/dev/switch/index.js.map +1 -0
- package/dist/dev/switch/switch.d.ts +69 -0
- package/dist/dev/switch/switch.d.ts.map +1 -0
- package/dist/dev/switch/switch.js +213 -0
- package/dist/dev/switch/switch.js.map +1 -0
- package/dist/dev/tabs/index.d.ts +3 -0
- package/dist/dev/tabs/index.d.ts.map +1 -0
- package/dist/dev/tabs/index.js +5 -0
- package/dist/dev/tabs/index.js.map +1 -0
- package/dist/dev/tabs/tabs.d.ts +64 -0
- package/dist/dev/tabs/tabs.d.ts.map +1 -0
- package/dist/dev/tabs/tabs.js +212 -0
- package/dist/dev/tabs/tabs.js.map +1 -0
- package/dist/dev/text-field/index.d.ts +3 -0
- package/dist/dev/text-field/index.d.ts.map +1 -0
- package/dist/dev/text-field/index.js +5 -0
- package/dist/dev/text-field/index.js.map +1 -0
- package/dist/dev/text-field/text-field.d.ts +91 -0
- package/dist/dev/text-field/text-field.d.ts.map +1 -0
- package/dist/dev/text-field/text-field.js +267 -0
- package/dist/dev/text-field/text-field.js.map +1 -0
- package/dist/dev/toast/index.d.ts +4 -0
- package/dist/dev/toast/index.d.ts.map +1 -0
- package/dist/dev/toast/index.js +5 -0
- package/dist/dev/toast/index.js.map +1 -0
- package/dist/dev/toast/toast.d.ts +71 -0
- package/dist/dev/toast/toast.d.ts.map +1 -0
- package/dist/dev/toast/toast.js +258 -0
- package/dist/dev/toast/toast.js.map +1 -0
- package/dist/prod/all.js +13 -0
- package/dist/prod/bar-chart/bar-chart.js +316 -0
- package/dist/prod/bar-chart/index.js +5 -0
- package/dist/prod/button/button.js +292 -0
- package/dist/prod/button/index.js +5 -0
- package/dist/prod/checkbox/checkbox.js +232 -0
- package/dist/prod/checkbox/index.js +5 -0
- package/dist/prod/core/cssom.js +30 -0
- package/dist/prod/core/define.js +6 -0
- package/dist/prod/core/dev-mode.js +1 -0
- package/dist/prod/core/focus-ring.js +14 -0
- package/dist/prod/core/form-control.js +75 -0
- package/dist/prod/core/warn.js +2 -0
- package/dist/prod/dialog/dialog.js +253 -0
- package/dist/prod/dialog/index.js +5 -0
- package/dist/prod/menu/index.js +5 -0
- package/dist/prod/menu/menu.js +330 -0
- package/dist/prod/navbar/index.js +5 -0
- package/dist/prod/navbar/navbar.js +353 -0
- package/dist/prod/poll/index.js +5 -0
- package/dist/prod/poll/poll.js +301 -0
- package/dist/prod/switch/index.js +5 -0
- package/dist/prod/switch/switch.js +213 -0
- package/dist/prod/tabs/index.js +5 -0
- package/dist/prod/tabs/tabs.js +212 -0
- package/dist/prod/text-field/index.js +5 -0
- package/dist/prod/text-field/text-field.js +267 -0
- package/dist/prod/toast/index.js +5 -0
- package/dist/prod/toast/toast.js +258 -0
- package/package.json +110 -3
|
@@ -0,0 +1,330 @@
|
|
|
1
|
+
import { LitElement, css, html } from 'lit';
|
|
2
|
+
import { focusRing } from '../core/focus-ring.js';
|
|
3
|
+
import { checkTokensLoaded, devWarn } from '../core/warn.js';
|
|
4
|
+
/**
|
|
5
|
+
* A button that opens a menu of actions, following the WAI-ARIA menu button pattern.
|
|
6
|
+
*
|
|
7
|
+
* @tag va-menu
|
|
8
|
+
* @summary Opens a short list of actions from a button, such as Edit, Duplicate and Delete.
|
|
9
|
+
*
|
|
10
|
+
* @slot - The menu items, as `<button value="…">` elements.
|
|
11
|
+
*
|
|
12
|
+
* @csspart trigger - The button that opens the menu.
|
|
13
|
+
* @csspart menu - The popup list.
|
|
14
|
+
*
|
|
15
|
+
* @cssprop {<color>} --va-menu-bg - Background colour of the menu.
|
|
16
|
+
* @cssprop {<length>} --va-menu-radius - Corner radius of the menu.
|
|
17
|
+
* @cssprop {<color>} --va-menu-item-bg-hover - Background colour of the focused or hovered item.
|
|
18
|
+
*
|
|
19
|
+
* @cssprop-applies --va-menu-bg menu:open background-color
|
|
20
|
+
* @cssprop-applies --va-menu-radius menu:open border-top-left-radius
|
|
21
|
+
* @cssprop-applies --va-menu-item-bg-hover light([role="menuitem"]):focus background-color
|
|
22
|
+
*
|
|
23
|
+
* @keyboard-items [role="menuitem"]
|
|
24
|
+
* @keyboard Enter | opens | Opens the menu and focuses the first item.
|
|
25
|
+
* @keyboard Space | opens | Opens the menu and focuses the first item.
|
|
26
|
+
* @keyboard ArrowDown | opens | Opens the menu and focuses the first item.
|
|
27
|
+
* @keyboard open: ArrowDown | next | Moves to the next item, wrapping round.
|
|
28
|
+
* @keyboard open: ArrowUp | previous | Moves to the previous item, wrapping round.
|
|
29
|
+
* @keyboard open: Home | first | Moves to the first item.
|
|
30
|
+
* @keyboard open: End | last | Moves to the last item.
|
|
31
|
+
* @keyboard open: Enter | selects | Chooses the focused item and closes the menu.
|
|
32
|
+
* @keyboard open: Escape | closes | Closes the menu and returns focus to the button.
|
|
33
|
+
*
|
|
34
|
+
* @a11y-role menu
|
|
35
|
+
* @a11y-name-from label
|
|
36
|
+
* @replaces [role="menu"]
|
|
37
|
+
* @a11y-name The `label`, which is also the button's text.
|
|
38
|
+
* @a11y-note The button has `aria-haspopup="menu"` and `aria-expanded`. Items get `role="menuitem"`.
|
|
39
|
+
* @a11y-note Typing a letter moves to the next item that starts with it.
|
|
40
|
+
*
|
|
41
|
+
* @guidance-use For a few actions on one thing, when there isn't room to show them as buttons.
|
|
42
|
+
* @guidance-avoid For navigation, for choosing a value in a form, or for one or two actions.
|
|
43
|
+
* @guidance-instead Links for navigation; a select or radio group for form values; plain buttons for one or two actions.
|
|
44
|
+
*
|
|
45
|
+
* @fires {CustomEvent<{ value: string, item: HTMLElement }>} va-select - When the user chooses an item. `event.detail.value` is the item's `value`, or its text when it has none; `event.detail.item` is the item.
|
|
46
|
+
* @event-trigger va-select | press Enter | open
|
|
47
|
+
*/
|
|
48
|
+
export class VaMenu extends LitElement {
|
|
49
|
+
static { this.shadowRootOptions = { ...LitElement.shadowRootOptions, delegatesFocus: true }; }
|
|
50
|
+
static { this.properties = {
|
|
51
|
+
open: { type: Boolean, reflect: true },
|
|
52
|
+
label: {},
|
|
53
|
+
variant: { reflect: true },
|
|
54
|
+
placement: { reflect: true },
|
|
55
|
+
}; }
|
|
56
|
+
#focusLast = false;
|
|
57
|
+
constructor() {
|
|
58
|
+
super();
|
|
59
|
+
this.open = false;
|
|
60
|
+
this.label = '';
|
|
61
|
+
this.variant = 'secondary';
|
|
62
|
+
this.placement = 'bottom-start';
|
|
63
|
+
}
|
|
64
|
+
connectedCallback() {
|
|
65
|
+
super.connectedCallback();
|
|
66
|
+
checkTokensLoaded(this);
|
|
67
|
+
window.addEventListener('resize', this.#position);
|
|
68
|
+
}
|
|
69
|
+
disconnectedCallback() {
|
|
70
|
+
super.disconnectedCallback();
|
|
71
|
+
window.removeEventListener('resize', this.#position);
|
|
72
|
+
}
|
|
73
|
+
get #items() {
|
|
74
|
+
return [...this.querySelectorAll(':scope > button, :scope > [role="menuitem"]')].filter((i) => !i.hasAttribute('disabled'));
|
|
75
|
+
}
|
|
76
|
+
get #menu() {
|
|
77
|
+
return this.shadowRoot?.querySelector('[part="menu"]') ?? null;
|
|
78
|
+
}
|
|
79
|
+
get #trigger() {
|
|
80
|
+
return this.shadowRoot?.querySelector('[part="trigger"]') ?? null;
|
|
81
|
+
}
|
|
82
|
+
firstUpdated() {
|
|
83
|
+
if (!this.label)
|
|
84
|
+
devWarn('va-menu', 'This menu has no label, so its button is empty.', 'Add label="…" that names the actions (e.g. label="Actions").');
|
|
85
|
+
}
|
|
86
|
+
updated(changed) {
|
|
87
|
+
if (!changed.has('open'))
|
|
88
|
+
return;
|
|
89
|
+
const menu = this.#menu;
|
|
90
|
+
if (!menu)
|
|
91
|
+
return;
|
|
92
|
+
if (this.open && !menu.matches(':popover-open')) {
|
|
93
|
+
menu.showPopover();
|
|
94
|
+
this.#position();
|
|
95
|
+
const items = this.#items;
|
|
96
|
+
items[this.#focusLast ? items.length - 1 : 0]?.focus();
|
|
97
|
+
this.#focusLast = false;
|
|
98
|
+
}
|
|
99
|
+
else if (!this.open && menu.matches(':popover-open')) {
|
|
100
|
+
menu.hidePopover();
|
|
101
|
+
}
|
|
102
|
+
}
|
|
103
|
+
#syncItems = () => {
|
|
104
|
+
for (const item of this.querySelectorAll(':scope > button')) {
|
|
105
|
+
item.setAttribute('role', 'menuitem');
|
|
106
|
+
item.tabIndex = -1;
|
|
107
|
+
item.type = 'button';
|
|
108
|
+
}
|
|
109
|
+
if ([...this.children].some((c) => c.localName !== 'button' && c.getAttribute('role') !== 'menuitem')) {
|
|
110
|
+
devWarn('va-menu', 'A menu item is not a <button>.', 'Use <button value="…">Label</button> for each item.');
|
|
111
|
+
}
|
|
112
|
+
};
|
|
113
|
+
/** Places the menu under the button, flipping above it near the bottom of the window. */
|
|
114
|
+
#position = () => {
|
|
115
|
+
const menu = this.#menu;
|
|
116
|
+
const trigger = this.#trigger;
|
|
117
|
+
if (!menu || !trigger || !this.open)
|
|
118
|
+
return;
|
|
119
|
+
const t = trigger.getBoundingClientRect();
|
|
120
|
+
const m = menu.getBoundingClientRect();
|
|
121
|
+
const gap = 4;
|
|
122
|
+
const below = t.bottom + gap + m.height <= window.innerHeight || t.top < m.height + gap;
|
|
123
|
+
const top = below ? t.bottom + gap : t.top - gap - m.height;
|
|
124
|
+
let left = this.placement === 'bottom-end' ? t.right - m.width : t.left;
|
|
125
|
+
left = Math.max(8, Math.min(left, window.innerWidth - m.width - 8));
|
|
126
|
+
// CSSOM writes, not a style attribute, so a strict CSP allows them.
|
|
127
|
+
menu.style.top = `${Math.round(top)}px`;
|
|
128
|
+
menu.style.left = `${Math.round(left)}px`;
|
|
129
|
+
};
|
|
130
|
+
#onToggle(event) {
|
|
131
|
+
// The popover closes itself on Escape or an outside click: keep `open` in step and return focus.
|
|
132
|
+
if (event.newState === 'closed' && this.open) {
|
|
133
|
+
this.open = false;
|
|
134
|
+
if (this.matches(':focus-within') || document.activeElement === document.body)
|
|
135
|
+
this.#trigger?.focus();
|
|
136
|
+
}
|
|
137
|
+
}
|
|
138
|
+
#onTriggerKeydown(event) {
|
|
139
|
+
if (['ArrowDown', 'ArrowUp'].includes(event.key)) {
|
|
140
|
+
event.preventDefault();
|
|
141
|
+
this.#focusLast = event.key === 'ArrowUp';
|
|
142
|
+
this.open = true;
|
|
143
|
+
}
|
|
144
|
+
}
|
|
145
|
+
#onTriggerClick() {
|
|
146
|
+
this.open = !this.open;
|
|
147
|
+
}
|
|
148
|
+
#onMenuKeydown(event) {
|
|
149
|
+
const items = this.#items;
|
|
150
|
+
const current = items.indexOf(event.target);
|
|
151
|
+
const go = (i) => items[(i + items.length) % items.length]?.focus();
|
|
152
|
+
switch (event.key) {
|
|
153
|
+
case 'ArrowDown':
|
|
154
|
+
event.preventDefault();
|
|
155
|
+
go(current + 1);
|
|
156
|
+
break;
|
|
157
|
+
case 'ArrowUp':
|
|
158
|
+
event.preventDefault();
|
|
159
|
+
go(current - 1);
|
|
160
|
+
break;
|
|
161
|
+
case 'Home':
|
|
162
|
+
event.preventDefault();
|
|
163
|
+
go(0);
|
|
164
|
+
break;
|
|
165
|
+
case 'End':
|
|
166
|
+
event.preventDefault();
|
|
167
|
+
go(items.length - 1);
|
|
168
|
+
break;
|
|
169
|
+
case 'Escape':
|
|
170
|
+
event.preventDefault();
|
|
171
|
+
this.open = false;
|
|
172
|
+
this.#trigger?.focus();
|
|
173
|
+
break;
|
|
174
|
+
case 'Tab':
|
|
175
|
+
this.open = false;
|
|
176
|
+
break;
|
|
177
|
+
default:
|
|
178
|
+
if (event.key.length === 1 && /\S/.test(event.key)) {
|
|
179
|
+
// Typeahead: the next item whose text starts with the typed letter.
|
|
180
|
+
const k = event.key.toLowerCase();
|
|
181
|
+
const order = [...items.slice(current + 1), ...items.slice(0, current + 1)];
|
|
182
|
+
order.find((i) => i.textContent?.trim().toLowerCase().startsWith(k))?.focus();
|
|
183
|
+
}
|
|
184
|
+
}
|
|
185
|
+
}
|
|
186
|
+
#onMenuClick(event) {
|
|
187
|
+
const item = this.#items.find((i) => event.composedPath().includes(i));
|
|
188
|
+
if (!item)
|
|
189
|
+
return;
|
|
190
|
+
this.dispatchEvent(new CustomEvent('va-select', {
|
|
191
|
+
// An item without a value reports its text, so every choice can be told apart.
|
|
192
|
+
detail: { value: item.value || item.textContent?.trim() || '', item },
|
|
193
|
+
bubbles: true,
|
|
194
|
+
composed: true,
|
|
195
|
+
}));
|
|
196
|
+
this.open = false;
|
|
197
|
+
this.#trigger?.focus();
|
|
198
|
+
}
|
|
199
|
+
render() {
|
|
200
|
+
return html `
|
|
201
|
+
<button
|
|
202
|
+
part="trigger"
|
|
203
|
+
class="trigger"
|
|
204
|
+
type="button"
|
|
205
|
+
aria-haspopup="menu"
|
|
206
|
+
aria-expanded=${this.open ? 'true' : 'false'}
|
|
207
|
+
aria-controls="menu"
|
|
208
|
+
@click=${this.#onTriggerClick}
|
|
209
|
+
@keydown=${this.#onTriggerKeydown}
|
|
210
|
+
>
|
|
211
|
+
${this.label}
|
|
212
|
+
<svg viewBox="0 0 16 16" aria-hidden="true" fill="none" stroke="currentColor" stroke-width="1.75"><path d="M4 6l4 4 4-4" /></svg>
|
|
213
|
+
</button>
|
|
214
|
+
<div
|
|
215
|
+
part="menu"
|
|
216
|
+
id="menu"
|
|
217
|
+
class="menu"
|
|
218
|
+
role="menu"
|
|
219
|
+
aria-label=${this.label}
|
|
220
|
+
popover="auto"
|
|
221
|
+
@toggle=${this.#onToggle}
|
|
222
|
+
@keydown=${this.#onMenuKeydown}
|
|
223
|
+
@click=${this.#onMenuClick}
|
|
224
|
+
>
|
|
225
|
+
<slot @slotchange=${this.#syncItems}></slot>
|
|
226
|
+
</div>
|
|
227
|
+
`;
|
|
228
|
+
}
|
|
229
|
+
static { this.styles = [
|
|
230
|
+
focusRing,
|
|
231
|
+
css `
|
|
232
|
+
:host {
|
|
233
|
+
display: inline-block;
|
|
234
|
+
vertical-align: middle;
|
|
235
|
+
font-family: var(--va-font-family-ui);
|
|
236
|
+
}
|
|
237
|
+
:host([hidden]) {
|
|
238
|
+
display: none;
|
|
239
|
+
}
|
|
240
|
+
.trigger {
|
|
241
|
+
display: inline-flex;
|
|
242
|
+
align-items: center;
|
|
243
|
+
gap: var(--va-space-gap-md);
|
|
244
|
+
min-height: var(--va-size-control-md);
|
|
245
|
+
margin: 0;
|
|
246
|
+
padding: 0 var(--va-space-inline-md) 0 var(--va-space-inline-lg);
|
|
247
|
+
border: 1px solid var(--va-color-border-control);
|
|
248
|
+
border-radius: var(--va-radius-control);
|
|
249
|
+
background: transparent;
|
|
250
|
+
color: var(--va-color-text-default);
|
|
251
|
+
font: inherit;
|
|
252
|
+
font-size: var(--va-font-size-md);
|
|
253
|
+
font-weight: var(--va-font-weight-medium);
|
|
254
|
+
cursor: pointer;
|
|
255
|
+
}
|
|
256
|
+
:host([variant='ghost']) .trigger {
|
|
257
|
+
border-color: transparent;
|
|
258
|
+
color: var(--va-color-accent-default);
|
|
259
|
+
}
|
|
260
|
+
.trigger:hover {
|
|
261
|
+
background: var(--va-color-surface-subtle);
|
|
262
|
+
}
|
|
263
|
+
.trigger svg {
|
|
264
|
+
width: 1rem;
|
|
265
|
+
height: 1rem;
|
|
266
|
+
transition: transform var(--va-motion-duration-fast) ease-out;
|
|
267
|
+
}
|
|
268
|
+
:host([open]) .trigger svg {
|
|
269
|
+
transform: rotate(180deg);
|
|
270
|
+
}
|
|
271
|
+
.menu {
|
|
272
|
+
position: fixed;
|
|
273
|
+
inset: auto;
|
|
274
|
+
margin: 0;
|
|
275
|
+
min-width: 10rem;
|
|
276
|
+
max-width: calc(100vw - 16px);
|
|
277
|
+
padding: var(--va-space-gap-sm);
|
|
278
|
+
border: 1px solid var(--va-color-border-subtle);
|
|
279
|
+
border-radius: var(--va-menu-radius, var(--va-radius-surface));
|
|
280
|
+
background-color: var(--va-menu-bg, var(--va-color-surface-default));
|
|
281
|
+
color: var(--va-color-text-default);
|
|
282
|
+
box-shadow: 0 8px 24px rgb(0 0 0 / 0.18);
|
|
283
|
+
}
|
|
284
|
+
.menu:popover-open {
|
|
285
|
+
display: flex;
|
|
286
|
+
flex-direction: column;
|
|
287
|
+
}
|
|
288
|
+
::slotted(button) {
|
|
289
|
+
display: block;
|
|
290
|
+
width: 100%;
|
|
291
|
+
min-height: var(--va-size-control-sm);
|
|
292
|
+
margin: 0;
|
|
293
|
+
padding: 0 var(--va-space-inline-md);
|
|
294
|
+
border: none;
|
|
295
|
+
border-radius: var(--va-radius-control);
|
|
296
|
+
background: transparent;
|
|
297
|
+
color: inherit;
|
|
298
|
+
font: inherit;
|
|
299
|
+
font-size: var(--va-font-size-md);
|
|
300
|
+
text-align: left;
|
|
301
|
+
cursor: pointer;
|
|
302
|
+
}
|
|
303
|
+
::slotted(button:hover),
|
|
304
|
+
::slotted(button:focus) {
|
|
305
|
+
background-color: var(--va-menu-item-bg-hover, var(--va-color-surface-subtle));
|
|
306
|
+
outline: none;
|
|
307
|
+
}
|
|
308
|
+
::slotted(button:focus-visible) {
|
|
309
|
+
outline: var(--va-size-focus-ring, 2px) solid var(--va-color-focus);
|
|
310
|
+
outline-offset: -2px;
|
|
311
|
+
}
|
|
312
|
+
@media (prefers-reduced-motion: reduce) {
|
|
313
|
+
.trigger svg {
|
|
314
|
+
transition: none;
|
|
315
|
+
}
|
|
316
|
+
}
|
|
317
|
+
@media (forced-colors: active) {
|
|
318
|
+
.menu {
|
|
319
|
+
border: 1px solid CanvasText;
|
|
320
|
+
}
|
|
321
|
+
::slotted(button:focus) {
|
|
322
|
+
background-color: Highlight;
|
|
323
|
+
color: HighlightText;
|
|
324
|
+
forced-color-adjust: none;
|
|
325
|
+
}
|
|
326
|
+
}
|
|
327
|
+
`,
|
|
328
|
+
]; }
|
|
329
|
+
}
|
|
330
|
+
//# sourceMappingURL=menu.js.map
|
|
@@ -0,0 +1,353 @@
|
|
|
1
|
+
import { LitElement, css, html, nothing } from 'lit';
|
|
2
|
+
import { focusRing } from '../core/focus-ring.js';
|
|
3
|
+
import { checkTokensLoaded, devWarn } from '../core/warn.js';
|
|
4
|
+
/**
|
|
5
|
+
* A site's main navigation bar: a brand link and links to pages. On narrow screens the links fold
|
|
6
|
+
* behind a Menu button, following the WAI-ARIA disclosure navigation pattern.
|
|
7
|
+
*
|
|
8
|
+
* @tag va-navbar
|
|
9
|
+
* @summary Shows a site's brand and main links in a bar that folds behind a Menu button on narrow screens.
|
|
10
|
+
*
|
|
11
|
+
* @slot - The links, as `<a href="…">` elements. Mark the current page's link with `aria-current="page"`.
|
|
12
|
+
* @slot brand - The site's name or logo, as an `<a href="…">` to the home page.
|
|
13
|
+
*
|
|
14
|
+
* @cssstate collapsed - The links are folded behind the Menu button.
|
|
15
|
+
*
|
|
16
|
+
* @csspart bar - The bar, which is the `<nav>` element.
|
|
17
|
+
* @csspart toggle - The Menu button shown on narrow screens.
|
|
18
|
+
* @csspart links - The wrapper around the links. On narrow screens it is the panel that opens.
|
|
19
|
+
*
|
|
20
|
+
* @cssprop {<color>} --va-navbar-bg - Background colour of the bar and of the open panel.
|
|
21
|
+
* @cssprop {<color>} --va-navbar-border - Colour of the line under the bar.
|
|
22
|
+
* @cssprop {<length>} --va-navbar-size - Minimum height of the bar.
|
|
23
|
+
* @cssprop {<color>} --va-navbar-link-fg - Text colour of the links.
|
|
24
|
+
* @cssprop {<color>} --va-navbar-indicator-border - Colour of the line that marks the current page's link.
|
|
25
|
+
*
|
|
26
|
+
* @cssprop-applies --va-navbar-bg bar background-color
|
|
27
|
+
* @cssprop-applies --va-navbar-border bar border-bottom-color
|
|
28
|
+
* @cssprop-applies --va-navbar-size bar min-height
|
|
29
|
+
* @cssprop-applies --va-navbar-link-fg light(a:not([slot]):not([aria-current])) color
|
|
30
|
+
* @cssprop-applies --va-navbar-indicator-border light([aria-current="page"]) border-bottom-color
|
|
31
|
+
*
|
|
32
|
+
* @keyboard open: Escape | closes | Closes the open panel of links and returns focus to the Menu button.
|
|
33
|
+
*
|
|
34
|
+
* @a11y-role navigation
|
|
35
|
+
* @a11y-name-from accessible-label
|
|
36
|
+
* @a11y-name The `accessible-label` attribute, such as "Main" (not shown). Needed when a page has more than one navigation landmark.
|
|
37
|
+
* @a11y-note The bar is a `<nav>` landmark. The links keep their own names; mark the current page with `aria-current="page"`.
|
|
38
|
+
* @a11y-note Style the folded layout with `va-navbar:state(collapsed)`.
|
|
39
|
+
* @a11y-note On narrow screens the Menu button has a visible label, `aria-expanded` and `aria-controls`. Escape, a click outside or moving focus away closes the panel.
|
|
40
|
+
*
|
|
41
|
+
* @guidance-use For a site's or app's main navigation: a brand link and up to about seven links to pages.
|
|
42
|
+
* @guidance-avoid For actions that do something on the page, for switching views in one place, or for deep hierarchies of pages.
|
|
43
|
+
* @guidance-instead `va-menu` for actions; `va-tabs` for views in one place; nested lists in a sidebar for deep navigation.
|
|
44
|
+
*/
|
|
45
|
+
export class VaNavbar extends LitElement {
|
|
46
|
+
static { this.properties = {
|
|
47
|
+
open: { type: Boolean, reflect: true },
|
|
48
|
+
collapseBelow: { type: Number, attribute: 'collapse-below' },
|
|
49
|
+
toggleLabel: { attribute: 'toggle-label' },
|
|
50
|
+
accessibleLabel: { attribute: 'accessible-label' },
|
|
51
|
+
_collapsed: { state: true },
|
|
52
|
+
}; }
|
|
53
|
+
#internals;
|
|
54
|
+
#width = 0;
|
|
55
|
+
#resize = new ResizeObserver(([entry]) => {
|
|
56
|
+
this.#width = entry.contentRect.width;
|
|
57
|
+
this.#measure();
|
|
58
|
+
});
|
|
59
|
+
constructor() {
|
|
60
|
+
super();
|
|
61
|
+
this.open = false;
|
|
62
|
+
this.collapseBelow = 600;
|
|
63
|
+
this.toggleLabel = 'Menu';
|
|
64
|
+
this.accessibleLabel = '';
|
|
65
|
+
this._collapsed = false;
|
|
66
|
+
this.#internals = this.attachInternals();
|
|
67
|
+
}
|
|
68
|
+
connectedCallback() {
|
|
69
|
+
super.connectedCallback();
|
|
70
|
+
checkTokensLoaded(this);
|
|
71
|
+
this.#resize.observe(this);
|
|
72
|
+
// Moved while open: disconnectedCallback removed the document listeners, and open hasn't changed.
|
|
73
|
+
if (this.open)
|
|
74
|
+
this.#listen(true);
|
|
75
|
+
}
|
|
76
|
+
disconnectedCallback() {
|
|
77
|
+
super.disconnectedCallback();
|
|
78
|
+
this.#resize.disconnect();
|
|
79
|
+
this.#listen(false);
|
|
80
|
+
}
|
|
81
|
+
firstUpdated() {
|
|
82
|
+
// Measure before the first paint, so a phone never sees the wide layout flash.
|
|
83
|
+
this.#width = this.getBoundingClientRect().width;
|
|
84
|
+
this.#measure();
|
|
85
|
+
}
|
|
86
|
+
willUpdate(changed) {
|
|
87
|
+
if (changed.has('collapseBelow'))
|
|
88
|
+
this.#measure();
|
|
89
|
+
// Unfolding closes the panel, so it isn't open next time the navbar folds.
|
|
90
|
+
if (changed.has('_collapsed') && !this._collapsed && changed.get('_collapsed') === true)
|
|
91
|
+
this.open = false;
|
|
92
|
+
}
|
|
93
|
+
updated(changed) {
|
|
94
|
+
if (changed.has('open'))
|
|
95
|
+
this.#listen(this.open);
|
|
96
|
+
if (changed.has('_collapsed')) {
|
|
97
|
+
try {
|
|
98
|
+
if (this._collapsed)
|
|
99
|
+
this.#internals.states.add('collapsed');
|
|
100
|
+
else
|
|
101
|
+
this.#internals.states.delete('collapsed');
|
|
102
|
+
}
|
|
103
|
+
catch {
|
|
104
|
+
// Browsers without CustomStateSet: the state is only for authors' styling.
|
|
105
|
+
}
|
|
106
|
+
}
|
|
107
|
+
}
|
|
108
|
+
#measure() {
|
|
109
|
+
if (this.#width)
|
|
110
|
+
this._collapsed = this.#width < this.collapseBelow;
|
|
111
|
+
}
|
|
112
|
+
#listen(on) {
|
|
113
|
+
if (on) {
|
|
114
|
+
document.addEventListener('keydown', this.#onDocumentKeydown);
|
|
115
|
+
document.addEventListener('pointerdown', this.#onDocumentPointerdown);
|
|
116
|
+
}
|
|
117
|
+
else {
|
|
118
|
+
document.removeEventListener('keydown', this.#onDocumentKeydown);
|
|
119
|
+
document.removeEventListener('pointerdown', this.#onDocumentPointerdown);
|
|
120
|
+
}
|
|
121
|
+
}
|
|
122
|
+
get #toggle() {
|
|
123
|
+
return this.shadowRoot?.querySelector('[part="toggle"]') ?? null;
|
|
124
|
+
}
|
|
125
|
+
#onDocumentKeydown = (event) => {
|
|
126
|
+
if (event.key !== 'Escape' || !this.open)
|
|
127
|
+
return;
|
|
128
|
+
const hadFocus = this.matches(':focus-within');
|
|
129
|
+
this.open = false;
|
|
130
|
+
if (hadFocus && this._collapsed)
|
|
131
|
+
this.#toggle?.focus();
|
|
132
|
+
};
|
|
133
|
+
#onDocumentPointerdown = (event) => {
|
|
134
|
+
if (!event.composedPath().includes(this))
|
|
135
|
+
this.open = false;
|
|
136
|
+
};
|
|
137
|
+
#onFocusout(event) {
|
|
138
|
+
const next = event.relatedTarget;
|
|
139
|
+
if (this._collapsed && this.open && next && !this.contains(next) && !this.shadowRoot.contains(next))
|
|
140
|
+
this.open = false;
|
|
141
|
+
}
|
|
142
|
+
#onLinksClick(event) {
|
|
143
|
+
// Following a link closes the panel, so it isn't left open over the page that loads.
|
|
144
|
+
if (this._collapsed && event.composedPath().some((n) => n.localName === 'a'))
|
|
145
|
+
this.open = false;
|
|
146
|
+
}
|
|
147
|
+
#onSlotchange = () => {
|
|
148
|
+
for (const link of this.querySelectorAll(':scope > a:not([href])')) {
|
|
149
|
+
devWarn('va-navbar', `The link "${link.textContent?.trim()}" has no href, so it can't be reached with the keyboard.`, 'Give every link an href (e.g. <a href="/work">Work</a>).');
|
|
150
|
+
}
|
|
151
|
+
if ([...this.children].some((c) => !c.slot && c.localName !== 'a')) {
|
|
152
|
+
devWarn('va-navbar', 'Something other than a link is in the navbar.', 'Put only <a href="…"> elements in va-navbar; use va-menu or va-button for actions.');
|
|
153
|
+
}
|
|
154
|
+
};
|
|
155
|
+
render() {
|
|
156
|
+
const folded = this._collapsed;
|
|
157
|
+
return html `
|
|
158
|
+
<nav part="bar" class=${folded ? 'bar collapsed' : 'bar'} aria-label=${this.accessibleLabel || nothing} @focusout=${this.#onFocusout}>
|
|
159
|
+
<div class="brand"><slot name="brand"></slot></div>
|
|
160
|
+
<button
|
|
161
|
+
part="toggle"
|
|
162
|
+
class="toggle"
|
|
163
|
+
type="button"
|
|
164
|
+
?hidden=${!folded}
|
|
165
|
+
aria-expanded=${this.open ? 'true' : 'false'}
|
|
166
|
+
aria-controls="links"
|
|
167
|
+
@click=${() => (this.open = !this.open)}
|
|
168
|
+
>
|
|
169
|
+
<span class="icon" aria-hidden="true"><span></span><span></span><span></span></span>
|
|
170
|
+
${this.toggleLabel}
|
|
171
|
+
</button>
|
|
172
|
+
<div part="links" id="links" class=${this.open ? 'links open' : 'links'} @click=${this.#onLinksClick}>
|
|
173
|
+
<slot @slotchange=${this.#onSlotchange}></slot>
|
|
174
|
+
</div>
|
|
175
|
+
</nav>
|
|
176
|
+
`;
|
|
177
|
+
}
|
|
178
|
+
static { this.styles = [
|
|
179
|
+
focusRing,
|
|
180
|
+
css `
|
|
181
|
+
:host {
|
|
182
|
+
display: block;
|
|
183
|
+
box-sizing: border-box;
|
|
184
|
+
width: 100%;
|
|
185
|
+
position: relative;
|
|
186
|
+
z-index: 1;
|
|
187
|
+
font-family: var(--va-font-family-ui);
|
|
188
|
+
font-size: var(--va-font-size-md);
|
|
189
|
+
}
|
|
190
|
+
:host([hidden]) {
|
|
191
|
+
display: none;
|
|
192
|
+
}
|
|
193
|
+
.bar {
|
|
194
|
+
position: relative;
|
|
195
|
+
box-sizing: border-box;
|
|
196
|
+
display: flex;
|
|
197
|
+
align-items: center;
|
|
198
|
+
gap: var(--va-space-inline-lg);
|
|
199
|
+
min-height: var(--va-navbar-size, 3.5rem);
|
|
200
|
+
padding: 0 var(--va-space-inline-lg);
|
|
201
|
+
border-bottom: 1px solid var(--va-navbar-border, var(--va-color-border-subtle));
|
|
202
|
+
background-color: var(--va-navbar-bg, var(--va-color-surface-default));
|
|
203
|
+
color: var(--va-color-text-default);
|
|
204
|
+
}
|
|
205
|
+
.brand {
|
|
206
|
+
flex: none;
|
|
207
|
+
margin-inline-end: auto;
|
|
208
|
+
}
|
|
209
|
+
::slotted([slot='brand']) {
|
|
210
|
+
color: inherit;
|
|
211
|
+
font-size: var(--va-font-size-lg);
|
|
212
|
+
font-weight: var(--va-font-weight-bold);
|
|
213
|
+
text-decoration: none;
|
|
214
|
+
}
|
|
215
|
+
.links {
|
|
216
|
+
display: flex;
|
|
217
|
+
align-items: stretch;
|
|
218
|
+
align-self: stretch;
|
|
219
|
+
gap: var(--va-space-gap-sm);
|
|
220
|
+
}
|
|
221
|
+
slot:not([name])::slotted(a) {
|
|
222
|
+
display: flex;
|
|
223
|
+
align-items: center;
|
|
224
|
+
padding: 0 var(--va-space-inline-sm);
|
|
225
|
+
border-top: 2px solid transparent;
|
|
226
|
+
border-bottom: 2px solid transparent;
|
|
227
|
+
color: var(--va-navbar-link-fg, var(--va-color-text-muted));
|
|
228
|
+
font-weight: var(--va-font-weight-medium);
|
|
229
|
+
text-decoration: none;
|
|
230
|
+
}
|
|
231
|
+
slot:not([name])::slotted(a:hover) {
|
|
232
|
+
color: var(--va-color-text-default);
|
|
233
|
+
}
|
|
234
|
+
slot:not([name])::slotted([aria-current='page']) {
|
|
235
|
+
border-bottom-color: var(--va-navbar-indicator-border, var(--va-color-accent-default));
|
|
236
|
+
color: var(--va-color-text-default);
|
|
237
|
+
}
|
|
238
|
+
::slotted(a:focus-visible) {
|
|
239
|
+
outline: var(--va-size-focus-ring, 2px) solid var(--va-color-focus);
|
|
240
|
+
outline-offset: -2px;
|
|
241
|
+
border-radius: var(--va-radius-control);
|
|
242
|
+
}
|
|
243
|
+
|
|
244
|
+
/* Folded: brand and Menu button in the bar, the links in a panel under it. */
|
|
245
|
+
.toggle {
|
|
246
|
+
display: inline-flex;
|
|
247
|
+
align-items: center;
|
|
248
|
+
gap: var(--va-space-gap-md);
|
|
249
|
+
min-height: var(--va-size-control-md);
|
|
250
|
+
margin: 0 calc(-1 * var(--va-space-inline-sm));
|
|
251
|
+
padding: 0 var(--va-space-inline-sm);
|
|
252
|
+
border: none;
|
|
253
|
+
border-radius: var(--va-radius-control);
|
|
254
|
+
background: transparent;
|
|
255
|
+
color: inherit;
|
|
256
|
+
font: inherit;
|
|
257
|
+
font-weight: var(--va-font-weight-medium);
|
|
258
|
+
cursor: pointer;
|
|
259
|
+
}
|
|
260
|
+
.toggle[hidden] {
|
|
261
|
+
display: none;
|
|
262
|
+
}
|
|
263
|
+
.toggle:hover {
|
|
264
|
+
background: var(--va-color-surface-subtle);
|
|
265
|
+
}
|
|
266
|
+
.icon {
|
|
267
|
+
position: relative;
|
|
268
|
+
width: 1.125rem;
|
|
269
|
+
height: 0.875rem;
|
|
270
|
+
}
|
|
271
|
+
.icon span {
|
|
272
|
+
position: absolute;
|
|
273
|
+
left: 0;
|
|
274
|
+
width: 100%;
|
|
275
|
+
height: 2px;
|
|
276
|
+
border-radius: 1px;
|
|
277
|
+
background: currentColor;
|
|
278
|
+
transition:
|
|
279
|
+
transform var(--va-motion-duration-fast) ease-out,
|
|
280
|
+
opacity var(--va-motion-duration-fast) ease-out;
|
|
281
|
+
}
|
|
282
|
+
.icon span:nth-child(1) {
|
|
283
|
+
top: 0;
|
|
284
|
+
}
|
|
285
|
+
.icon span:nth-child(2) {
|
|
286
|
+
top: calc(50% - 1px);
|
|
287
|
+
}
|
|
288
|
+
.icon span:nth-child(3) {
|
|
289
|
+
bottom: 0;
|
|
290
|
+
}
|
|
291
|
+
[aria-expanded='true'] .icon span:nth-child(1) {
|
|
292
|
+
transform: translateY(0.375rem) rotate(45deg);
|
|
293
|
+
}
|
|
294
|
+
[aria-expanded='true'] .icon span:nth-child(2) {
|
|
295
|
+
opacity: 0;
|
|
296
|
+
}
|
|
297
|
+
[aria-expanded='true'] .icon span:nth-child(3) {
|
|
298
|
+
transform: translateY(-0.375rem) rotate(-45deg);
|
|
299
|
+
}
|
|
300
|
+
.collapsed .links {
|
|
301
|
+
position: absolute;
|
|
302
|
+
top: 100%;
|
|
303
|
+
left: 0;
|
|
304
|
+
right: 0;
|
|
305
|
+
display: none;
|
|
306
|
+
flex-direction: column;
|
|
307
|
+
gap: 0;
|
|
308
|
+
padding: var(--va-space-gap-sm) 0;
|
|
309
|
+
border-bottom: 1px solid var(--va-navbar-border, var(--va-color-border-subtle));
|
|
310
|
+
background-color: var(--va-navbar-bg, var(--va-color-surface-default));
|
|
311
|
+
box-shadow: 0 12px 24px rgb(0 0 0 / 0.12);
|
|
312
|
+
}
|
|
313
|
+
.collapsed .links.open {
|
|
314
|
+
display: flex;
|
|
315
|
+
animation: va-navbar-open var(--va-motion-duration-fast) ease-out;
|
|
316
|
+
}
|
|
317
|
+
.collapsed slot:not([name])::slotted(a) {
|
|
318
|
+
min-height: var(--va-size-control-lg);
|
|
319
|
+
padding: 0 var(--va-space-inline-lg);
|
|
320
|
+
border-top: none;
|
|
321
|
+
border-bottom: none;
|
|
322
|
+
border-inline-start: 3px solid transparent;
|
|
323
|
+
}
|
|
324
|
+
.collapsed slot:not([name])::slotted([aria-current='page']) {
|
|
325
|
+
border-inline-start-color: var(--va-navbar-indicator-border, var(--va-color-accent-default));
|
|
326
|
+
}
|
|
327
|
+
@keyframes va-navbar-open {
|
|
328
|
+
from {
|
|
329
|
+
opacity: 0;
|
|
330
|
+
transform: translateY(-4px);
|
|
331
|
+
}
|
|
332
|
+
}
|
|
333
|
+
@media (prefers-reduced-motion: reduce) {
|
|
334
|
+
.icon span {
|
|
335
|
+
transition: none;
|
|
336
|
+
}
|
|
337
|
+
.collapsed .links.open {
|
|
338
|
+
animation: none;
|
|
339
|
+
}
|
|
340
|
+
}
|
|
341
|
+
@media (forced-colors: active) {
|
|
342
|
+
.bar,
|
|
343
|
+
.collapsed .links {
|
|
344
|
+
border-bottom-color: CanvasText;
|
|
345
|
+
}
|
|
346
|
+
slot:not([name])::slotted([aria-current='page']) {
|
|
347
|
+
border-color: Highlight;
|
|
348
|
+
}
|
|
349
|
+
}
|
|
350
|
+
`,
|
|
351
|
+
]; }
|
|
352
|
+
}
|
|
353
|
+
//# sourceMappingURL=navbar.js.map
|