@splendidlabz/svelte 4.8.4 → 4.9.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/CHANGELOG.md +21 -0
- package/components/Markdown/Markdown.spec.js +1 -0
- package/components/Tabs/Tablist.svelte +3 -26
- package/components/Tabs/TabsExample.svelte +67 -0
- package/components/Tabs/tabs-css.spec.js +44 -0
- package/components/Tabs/tabs.spec.js +553 -0
- package/components/Tabs/tabs.svelte.js +30 -6
- package/package.json +3 -1
- package/utils/loadscripts.js +2 -0
- package/vitest.config.js +3 -0
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,26 @@
|
|
|
1
1
|
# @splendidlabz/svelte
|
|
2
2
|
|
|
3
|
+
## 4.9.0
|
|
4
|
+
|
|
5
|
+
### Minor Changes
|
|
6
|
+
|
|
7
|
+
- c1a3797: Replace JS breakpoint-driven tab placement with CSS-driven placement. Placement classes (tablist-top, tablist-left, tablist-right) now set a --placement CSS custom property that JS reads for keyboard navigation. Removes breakpointObserver from Tablist.
|
|
8
|
+
|
|
9
|
+
### Patch Changes
|
|
10
|
+
|
|
11
|
+
- Updated dependencies [c1a3797]
|
|
12
|
+
- @splendidlabz/styles@4.7.0
|
|
13
|
+
|
|
14
|
+
## 4.8.5
|
|
15
|
+
|
|
16
|
+
### Patch Changes
|
|
17
|
+
|
|
18
|
+
- 7b9b628: Added early return in reloadScripts when no script elements found
|
|
19
|
+
- Updated dependencies [7b9b628]
|
|
20
|
+
- Updated dependencies [7b9b628]
|
|
21
|
+
- @splendidlabz/styles@4.6.8
|
|
22
|
+
- @splendidlabz/utils@1.11.3
|
|
23
|
+
|
|
3
24
|
## 4.8.4
|
|
4
25
|
|
|
5
26
|
### Patch Changes
|
|
@@ -1,15 +1,11 @@
|
|
|
1
1
|
<script>
|
|
2
2
|
import { preferHorizontalScroll as preferHorizontalScrollAction } from '@splendidlabz/utils/dom'
|
|
3
|
-
import { breakpointObserver } from '../../actions/breakpoint-observer.js'
|
|
4
3
|
import { init } from '../../utils'
|
|
5
|
-
import { getTab, tablist
|
|
4
|
+
import { getTab, tablist } from './tabs.svelte.js'
|
|
6
5
|
|
|
7
6
|
let {
|
|
8
7
|
class: klass = '',
|
|
9
8
|
target = null,
|
|
10
|
-
breakpoints,
|
|
11
|
-
breakpointType,
|
|
12
|
-
placement: initialPlacement,
|
|
13
9
|
scrollable = true,
|
|
14
10
|
preferHorizontalScroll = true,
|
|
15
11
|
preserveOutlines = true,
|
|
@@ -20,7 +16,6 @@
|
|
|
20
16
|
...rest
|
|
21
17
|
} = $props()
|
|
22
18
|
|
|
23
|
-
let placement = $state(_ => initialPlacement || 'top')
|
|
24
19
|
let tab = $derived(getTab(target))
|
|
25
20
|
let tablistClasses = $derived(getTablistClasses(tab))
|
|
26
21
|
|
|
@@ -32,13 +27,6 @@
|
|
|
32
27
|
if (!tab) return ''
|
|
33
28
|
const { placement } = tab.state
|
|
34
29
|
|
|
35
|
-
const tablistClass = {
|
|
36
|
-
top: 'tablist-top',
|
|
37
|
-
left: 'tablist-left',
|
|
38
|
-
right: 'tablist-right',
|
|
39
|
-
}[placement]
|
|
40
|
-
|
|
41
|
-
// Gah these need to change according to the placement
|
|
42
30
|
const scrollableClass = [
|
|
43
31
|
placement === 'top' && scrollable && 'scrollable-horizontal',
|
|
44
32
|
placement === 'top' &&
|
|
@@ -47,12 +35,7 @@
|
|
|
47
35
|
placement === 'top' && preserveOutlines && 'preserve-outlines',
|
|
48
36
|
].join(' ')
|
|
49
37
|
|
|
50
|
-
return
|
|
51
|
-
}
|
|
52
|
-
|
|
53
|
-
function breakpointCB({ value }) {
|
|
54
|
-
placement = value.placement
|
|
55
|
-
updatePlacement(tab, value.placement)
|
|
38
|
+
return scrollableClass
|
|
56
39
|
}
|
|
57
40
|
</script>
|
|
58
41
|
|
|
@@ -61,17 +44,11 @@
|
|
|
61
44
|
class="tablist {tablistClasses} {klass}"
|
|
62
45
|
role="tablist"
|
|
63
46
|
{target}
|
|
64
|
-
use:breakpointObserver={{
|
|
65
|
-
breakpoints,
|
|
66
|
-
breakpointType,
|
|
67
|
-
callback: breakpointCB,
|
|
68
|
-
}}
|
|
69
47
|
use:preferHorizontalScrollAction
|
|
70
48
|
use:tablist={{
|
|
71
|
-
state: {
|
|
49
|
+
state: {},
|
|
72
50
|
options: rest,
|
|
73
51
|
}}
|
|
74
52
|
>
|
|
75
|
-
<!-- Need to add callback to breakpoint opts -->
|
|
76
53
|
{@render children?.()}
|
|
77
54
|
</div>
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
<!--
|
|
2
|
+
Example: Responsive tabs — horizontal on mobile, vertical (left) on desktop.
|
|
3
|
+
Copy-paste this as a starting point. Adjust classes and breakpoints as needed.
|
|
4
|
+
|
|
5
|
+
Usage in Astro:
|
|
6
|
+
<TabsExample client:load />
|
|
7
|
+
|
|
8
|
+
The key concept: placement classes (tablist-top, tablist-left, tablist-right)
|
|
9
|
+
control both the CSS layout AND keyboard navigation automatically.
|
|
10
|
+
Use responsive prefixes to change placement at breakpoints.
|
|
11
|
+
-->
|
|
12
|
+
<script>
|
|
13
|
+
import Tab from './Tab.svelte'
|
|
14
|
+
import Tablist from './Tablist.svelte'
|
|
15
|
+
import Tabpanel from './Tabpanel.svelte'
|
|
16
|
+
import Tabpanels from './Tabpanels.svelte'
|
|
17
|
+
</script>
|
|
18
|
+
|
|
19
|
+
<div class="tabs-example" style="display: grid; gap: 1rem;">
|
|
20
|
+
<!--
|
|
21
|
+
Mobile: tablist-top (horizontal tabs)
|
|
22
|
+
Desktop (≥1000px): tablist-left (vertical tabs on the left)
|
|
23
|
+
|
|
24
|
+
Replace "max-bp10:" and "bp10:" with your own responsive prefixes,
|
|
25
|
+
or use standard Tailwind breakpoints like "max-md:" and "md:".
|
|
26
|
+
|
|
27
|
+
If you don't use responsive utility prefixes, use media queries in your CSS:
|
|
28
|
+
@media (max-width: 999px) { .my-tablist { --placement: top; } }
|
|
29
|
+
@media (min-width: 1000px) { .my-tablist { --placement: left; } }
|
|
30
|
+
-->
|
|
31
|
+
<Tablist
|
|
32
|
+
class="tablist-top"
|
|
33
|
+
target="example-panels"
|
|
34
|
+
>
|
|
35
|
+
<Tab active>First Tab</Tab>
|
|
36
|
+
<Tab>Second Tab</Tab>
|
|
37
|
+
<Tab>Third Tab</Tab>
|
|
38
|
+
</Tablist>
|
|
39
|
+
|
|
40
|
+
<Tabpanels id="example-panels">
|
|
41
|
+
<Tabpanel active>
|
|
42
|
+
<p>Content for the first tab.</p>
|
|
43
|
+
</Tabpanel>
|
|
44
|
+
<Tabpanel>
|
|
45
|
+
<p>Content for the second tab.</p>
|
|
46
|
+
</Tabpanel>
|
|
47
|
+
<Tabpanel>
|
|
48
|
+
<p>Content for the third tab.</p>
|
|
49
|
+
</Tabpanel>
|
|
50
|
+
</Tabpanels>
|
|
51
|
+
</div>
|
|
52
|
+
|
|
53
|
+
<style>
|
|
54
|
+
/*
|
|
55
|
+
For responsive placement, add media queries that change the placement class.
|
|
56
|
+
The CSS placement classes (tablist-top, tablist-left, tablist-right) each set
|
|
57
|
+
a --placement CSS custom property that JS reads for keyboard navigation.
|
|
58
|
+
|
|
59
|
+
Example with custom breakpoint:
|
|
60
|
+
@media (min-width: 1000px) {
|
|
61
|
+
:global(.tablist) {
|
|
62
|
+
This would need tablist-left class applied at this breakpoint.
|
|
63
|
+
If using Tailwind/utility CSS, apply via responsive prefix in the class attribute.
|
|
64
|
+
}
|
|
65
|
+
}
|
|
66
|
+
*/
|
|
67
|
+
</style>
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
import { readFile } from 'node:fs/promises'
|
|
2
|
+
import { beforeAll, describe, expect, test } from 'vitest'
|
|
3
|
+
import { fileURLToPath } from 'node:url'
|
|
4
|
+
import path from 'node:path'
|
|
5
|
+
|
|
6
|
+
// Resolve the CSS file relative to this test
|
|
7
|
+
const cssPath = path.resolve(
|
|
8
|
+
fileURLToPath(import.meta.url),
|
|
9
|
+
'../../../../styles/src/components/svelte/tabs.css'
|
|
10
|
+
)
|
|
11
|
+
|
|
12
|
+
describe('tabs.css --placement custom property', () => {
|
|
13
|
+
let css
|
|
14
|
+
|
|
15
|
+
beforeAll(async () => {
|
|
16
|
+
css = await readFile(cssPath, 'utf8')
|
|
17
|
+
})
|
|
18
|
+
|
|
19
|
+
test('tablist-top sets --placement: top', () => {
|
|
20
|
+
// Match the @utility tablist-top block (may contain nested braces)
|
|
21
|
+
const match = css.match(/@utility tablist-top\s*\{[\s\S]*?\n\}/)
|
|
22
|
+
expect(match).toBeTruthy()
|
|
23
|
+
expect(match[0]).toContain('--placement: top')
|
|
24
|
+
})
|
|
25
|
+
|
|
26
|
+
test('.tablist-left sets --placement: left', () => {
|
|
27
|
+
// Should appear somewhere in the file — could be @layer or @utility
|
|
28
|
+
const leftBlock = css.match(/\.tablist-left\s*\{[^}]*\}/)
|
|
29
|
+
expect(leftBlock).toBeTruthy()
|
|
30
|
+
expect(leftBlock[0]).toContain('--placement: left')
|
|
31
|
+
})
|
|
32
|
+
|
|
33
|
+
test('.tablist-right sets --placement: right', () => {
|
|
34
|
+
const rightBlock = css.match(/\.tablist-right\s*\{[^}]*\}/)
|
|
35
|
+
expect(rightBlock).toBeTruthy()
|
|
36
|
+
expect(rightBlock[0]).toContain('--placement: right')
|
|
37
|
+
})
|
|
38
|
+
|
|
39
|
+
test('all three placements are covered', () => {
|
|
40
|
+
expect(css).toContain('--placement: top')
|
|
41
|
+
expect(css).toContain('--placement: left')
|
|
42
|
+
expect(css).toContain('--placement: right')
|
|
43
|
+
})
|
|
44
|
+
})
|
|
@@ -0,0 +1,553 @@
|
|
|
1
|
+
import { afterEach, describe, expect, test } from 'vitest'
|
|
2
|
+
import {
|
|
3
|
+
getTab,
|
|
4
|
+
tablist,
|
|
5
|
+
tabpanels,
|
|
6
|
+
selectTab,
|
|
7
|
+
selectNextTab,
|
|
8
|
+
selectPrevTab,
|
|
9
|
+
} from './tabs.svelte.js'
|
|
10
|
+
|
|
11
|
+
// ============================================
|
|
12
|
+
// Test Helpers
|
|
13
|
+
// ============================================
|
|
14
|
+
|
|
15
|
+
let testCounter = 0
|
|
16
|
+
const cleanupNodes = []
|
|
17
|
+
|
|
18
|
+
function uniqueId() {
|
|
19
|
+
return `test-panels-${++testCounter}`
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
function createTabsDOM({ placement = 'top', tabCount = 3, id } = {}) {
|
|
23
|
+
const panelId = id || uniqueId()
|
|
24
|
+
|
|
25
|
+
// Create tablist
|
|
26
|
+
const tablistNode = document.createElement('div')
|
|
27
|
+
tablistNode.classList.add('tablist')
|
|
28
|
+
tablistNode.setAttribute('role', 'tablist')
|
|
29
|
+
tablistNode.setAttribute('target', panelId)
|
|
30
|
+
if (placement) {
|
|
31
|
+
tablistNode.style.setProperty('--placement', placement)
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
for (let i = 0; i < tabCount; i++) {
|
|
35
|
+
const tab = document.createElement('button')
|
|
36
|
+
tab.setAttribute('role', 'tab')
|
|
37
|
+
tab.classList.add('tab')
|
|
38
|
+
tab.textContent = `Tab ${i}`
|
|
39
|
+
tab.setAttribute('tabindex', i === 0 ? '0' : '-1')
|
|
40
|
+
if (i === 0) tab.setAttribute('aria-selected', 'true')
|
|
41
|
+
tablistNode.appendChild(tab)
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
document.body.appendChild(tablistNode)
|
|
45
|
+
|
|
46
|
+
// Create tabpanels
|
|
47
|
+
const panelsNode = document.createElement('div')
|
|
48
|
+
panelsNode.id = panelId
|
|
49
|
+
panelsNode.classList.add('tabpanels')
|
|
50
|
+
|
|
51
|
+
for (let i = 0; i < tabCount; i++) {
|
|
52
|
+
const panel = document.createElement('div')
|
|
53
|
+
panel.setAttribute('role', 'tabpanel')
|
|
54
|
+
panel.classList.add('tabpanel')
|
|
55
|
+
panel.setAttribute('tabindex', '0')
|
|
56
|
+
panel.textContent = `Panel content ${i}`
|
|
57
|
+
if (i !== 0) panel.setAttribute('hidden', 'true')
|
|
58
|
+
panelsNode.appendChild(panel)
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
document.body.appendChild(panelsNode)
|
|
62
|
+
cleanupNodes.push(tablistNode, panelsNode)
|
|
63
|
+
|
|
64
|
+
return { tablistNode, panelsNode, panelId }
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
function initActions({ tablistNode, panelsNode }) {
|
|
68
|
+
const tablistAction = tablist(tablistNode, { state: {}, options: {} })
|
|
69
|
+
const panelsAction = tabpanels(panelsNode, {})
|
|
70
|
+
return { tablistAction, panelsAction }
|
|
71
|
+
}
|
|
72
|
+
|
|
73
|
+
function pressKey(node, key) {
|
|
74
|
+
node.dispatchEvent(new KeyboardEvent('keydown', { key, bubbles: true }))
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
function clickTab(tab) {
|
|
78
|
+
tab.dispatchEvent(new MouseEvent('click', { bubbles: true }))
|
|
79
|
+
}
|
|
80
|
+
|
|
81
|
+
function getTabElements(tablistNode) {
|
|
82
|
+
return Array.from(tablistNode.querySelectorAll('[role="tab"]'))
|
|
83
|
+
}
|
|
84
|
+
|
|
85
|
+
function getPanelElements(panelsNode) {
|
|
86
|
+
return Array.from(panelsNode.querySelectorAll('[role="tabpanel"]'))
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
afterEach(() => {
|
|
90
|
+
cleanupNodes.forEach(n => n.parentNode?.removeChild(n))
|
|
91
|
+
cleanupNodes.length = 0
|
|
92
|
+
})
|
|
93
|
+
|
|
94
|
+
// ============================================
|
|
95
|
+
// readPlacement
|
|
96
|
+
// ============================================
|
|
97
|
+
|
|
98
|
+
describe('readPlacement', () => {
|
|
99
|
+
test('reads --placement: top from CSS', async () => {
|
|
100
|
+
const { readPlacement } = await import('./tabs.svelte.js')
|
|
101
|
+
const node = document.createElement('div')
|
|
102
|
+
node.style.setProperty('--placement', 'top')
|
|
103
|
+
document.body.appendChild(node)
|
|
104
|
+
cleanupNodes.push(node)
|
|
105
|
+
|
|
106
|
+
expect(readPlacement(node)).toBe('top')
|
|
107
|
+
})
|
|
108
|
+
|
|
109
|
+
test('reads --placement: left from CSS', async () => {
|
|
110
|
+
const { readPlacement } = await import('./tabs.svelte.js')
|
|
111
|
+
const node = document.createElement('div')
|
|
112
|
+
node.style.setProperty('--placement', 'left')
|
|
113
|
+
document.body.appendChild(node)
|
|
114
|
+
cleanupNodes.push(node)
|
|
115
|
+
|
|
116
|
+
expect(readPlacement(node)).toBe('left')
|
|
117
|
+
})
|
|
118
|
+
|
|
119
|
+
test('reads --placement: right from CSS', async () => {
|
|
120
|
+
const { readPlacement } = await import('./tabs.svelte.js')
|
|
121
|
+
const node = document.createElement('div')
|
|
122
|
+
node.style.setProperty('--placement', 'right')
|
|
123
|
+
document.body.appendChild(node)
|
|
124
|
+
cleanupNodes.push(node)
|
|
125
|
+
|
|
126
|
+
expect(readPlacement(node)).toBe('right')
|
|
127
|
+
})
|
|
128
|
+
|
|
129
|
+
test('defaults to "top" when --placement is not set', async () => {
|
|
130
|
+
const { readPlacement } = await import('./tabs.svelte.js')
|
|
131
|
+
const node = document.createElement('div')
|
|
132
|
+
document.body.appendChild(node)
|
|
133
|
+
cleanupNodes.push(node)
|
|
134
|
+
|
|
135
|
+
expect(readPlacement(node)).toBe('top')
|
|
136
|
+
})
|
|
137
|
+
})
|
|
138
|
+
|
|
139
|
+
// ============================================
|
|
140
|
+
// Tab Selection (click)
|
|
141
|
+
// ============================================
|
|
142
|
+
|
|
143
|
+
describe('tab selection via click', () => {
|
|
144
|
+
test('clicking a tab selects it', () => {
|
|
145
|
+
const { tablistNode, panelsNode, panelId } = createTabsDOM()
|
|
146
|
+
const { tablistAction, panelsAction } = initActions({ tablistNode, panelsNode })
|
|
147
|
+
|
|
148
|
+
const tabs = getTabElements(tablistNode)
|
|
149
|
+
const panels = getPanelElements(panelsNode)
|
|
150
|
+
|
|
151
|
+
clickTab(tabs[1])
|
|
152
|
+
|
|
153
|
+
expect(tabs[1].getAttribute('aria-selected')).toBe('true')
|
|
154
|
+
expect(tabs[0].hasAttribute('aria-selected')).toBe(false)
|
|
155
|
+
expect(panels[1].hasAttribute('hidden')).toBe(false)
|
|
156
|
+
expect(panels[0].getAttribute('hidden')).toBe('true')
|
|
157
|
+
|
|
158
|
+
tablistAction.destroy()
|
|
159
|
+
panelsAction.destroy()
|
|
160
|
+
})
|
|
161
|
+
|
|
162
|
+
test('clicking a tab updates tabindex roving', () => {
|
|
163
|
+
const { tablistNode, panelsNode } = createTabsDOM()
|
|
164
|
+
const { tablistAction, panelsAction } = initActions({ tablistNode, panelsNode })
|
|
165
|
+
|
|
166
|
+
const tabs = getTabElements(tablistNode)
|
|
167
|
+
|
|
168
|
+
clickTab(tabs[2])
|
|
169
|
+
|
|
170
|
+
expect(tabs[2].getAttribute('tabindex')).toBe('0')
|
|
171
|
+
expect(tabs[0].getAttribute('tabindex')).toBe('-1')
|
|
172
|
+
expect(tabs[1].getAttribute('tabindex')).toBe('-1')
|
|
173
|
+
|
|
174
|
+
tablistAction.destroy()
|
|
175
|
+
panelsAction.destroy()
|
|
176
|
+
})
|
|
177
|
+
|
|
178
|
+
test('clicking the already-active tab does not break state', () => {
|
|
179
|
+
const { tablistNode, panelsNode } = createTabsDOM()
|
|
180
|
+
const { tablistAction, panelsAction } = initActions({ tablistNode, panelsNode })
|
|
181
|
+
|
|
182
|
+
const tabs = getTabElements(tablistNode)
|
|
183
|
+
|
|
184
|
+
clickTab(tabs[0])
|
|
185
|
+
|
|
186
|
+
expect(tabs[0].getAttribute('aria-selected')).toBe('true')
|
|
187
|
+
|
|
188
|
+
tablistAction.destroy()
|
|
189
|
+
panelsAction.destroy()
|
|
190
|
+
})
|
|
191
|
+
})
|
|
192
|
+
|
|
193
|
+
// ============================================
|
|
194
|
+
// Accessibility: ARIA attributes
|
|
195
|
+
// ============================================
|
|
196
|
+
|
|
197
|
+
describe('accessibility: ARIA attributes', () => {
|
|
198
|
+
test('only one tab has aria-selected at any time', () => {
|
|
199
|
+
const { tablistNode, panelsNode } = createTabsDOM()
|
|
200
|
+
const { tablistAction, panelsAction } = initActions({ tablistNode, panelsNode })
|
|
201
|
+
|
|
202
|
+
const tabs = getTabElements(tablistNode)
|
|
203
|
+
|
|
204
|
+
// Click through each tab
|
|
205
|
+
for (let i = 0; i < tabs.length; i++) {
|
|
206
|
+
clickTab(tabs[i])
|
|
207
|
+
const selected = tabs.filter(t => t.getAttribute('aria-selected') === 'true')
|
|
208
|
+
expect(selected.length).toBe(1)
|
|
209
|
+
expect(selected[0]).toBe(tabs[i])
|
|
210
|
+
}
|
|
211
|
+
|
|
212
|
+
tablistAction.destroy()
|
|
213
|
+
panelsAction.destroy()
|
|
214
|
+
})
|
|
215
|
+
|
|
216
|
+
test('only one panel is visible at any time', () => {
|
|
217
|
+
const { tablistNode, panelsNode } = createTabsDOM()
|
|
218
|
+
const { tablistAction, panelsAction } = initActions({ tablistNode, panelsNode })
|
|
219
|
+
|
|
220
|
+
const tabs = getTabElements(tablistNode)
|
|
221
|
+
const panels = getPanelElements(panelsNode)
|
|
222
|
+
|
|
223
|
+
for (let i = 0; i < tabs.length; i++) {
|
|
224
|
+
clickTab(tabs[i])
|
|
225
|
+
const visible = panels.filter(p => !p.hasAttribute('hidden'))
|
|
226
|
+
expect(visible.length).toBe(1)
|
|
227
|
+
expect(visible[0]).toBe(panels[i])
|
|
228
|
+
}
|
|
229
|
+
|
|
230
|
+
tablistAction.destroy()
|
|
231
|
+
panelsAction.destroy()
|
|
232
|
+
})
|
|
233
|
+
|
|
234
|
+
test('inactive tabs have tabindex="-1", active tab has tabindex="0"', () => {
|
|
235
|
+
const { tablistNode, panelsNode } = createTabsDOM()
|
|
236
|
+
const { tablistAction, panelsAction } = initActions({ tablistNode, panelsNode })
|
|
237
|
+
|
|
238
|
+
const tabs = getTabElements(tablistNode)
|
|
239
|
+
|
|
240
|
+
clickTab(tabs[1])
|
|
241
|
+
|
|
242
|
+
expect(tabs[1].getAttribute('tabindex')).toBe('0')
|
|
243
|
+
tabs.filter((_, i) => i !== 1).forEach(t => {
|
|
244
|
+
expect(t.getAttribute('tabindex')).toBe('-1')
|
|
245
|
+
})
|
|
246
|
+
|
|
247
|
+
tablistAction.destroy()
|
|
248
|
+
panelsAction.destroy()
|
|
249
|
+
})
|
|
250
|
+
})
|
|
251
|
+
|
|
252
|
+
// ============================================
|
|
253
|
+
// Keyboard Navigation: Horizontal (top)
|
|
254
|
+
// ============================================
|
|
255
|
+
|
|
256
|
+
describe('keyboard navigation: horizontal (placement=top)', () => {
|
|
257
|
+
test('ArrowRight selects next tab', () => {
|
|
258
|
+
const { tablistNode, panelsNode } = createTabsDOM({ placement: 'top' })
|
|
259
|
+
const { tablistAction, panelsAction } = initActions({ tablistNode, panelsNode })
|
|
260
|
+
|
|
261
|
+
const tabs = getTabElements(tablistNode)
|
|
262
|
+
tabs[0].focus()
|
|
263
|
+
pressKey(tablistNode, 'ArrowRight')
|
|
264
|
+
|
|
265
|
+
expect(tabs[1].getAttribute('aria-selected')).toBe('true')
|
|
266
|
+
expect(tabs[0].hasAttribute('aria-selected')).toBe(false)
|
|
267
|
+
|
|
268
|
+
tablistAction.destroy()
|
|
269
|
+
panelsAction.destroy()
|
|
270
|
+
})
|
|
271
|
+
|
|
272
|
+
test('ArrowLeft selects previous tab', () => {
|
|
273
|
+
const { tablistNode, panelsNode } = createTabsDOM({ placement: 'top' })
|
|
274
|
+
const { tablistAction, panelsAction } = initActions({ tablistNode, panelsNode })
|
|
275
|
+
|
|
276
|
+
const tabs = getTabElements(tablistNode)
|
|
277
|
+
|
|
278
|
+
// First select tab 1
|
|
279
|
+
clickTab(tabs[1])
|
|
280
|
+
pressKey(tablistNode, 'ArrowLeft')
|
|
281
|
+
|
|
282
|
+
expect(tabs[0].getAttribute('aria-selected')).toBe('true')
|
|
283
|
+
|
|
284
|
+
tablistAction.destroy()
|
|
285
|
+
panelsAction.destroy()
|
|
286
|
+
})
|
|
287
|
+
|
|
288
|
+
test('ArrowRight at last tab does nothing (no loop by default)', () => {
|
|
289
|
+
const { tablistNode, panelsNode } = createTabsDOM({ placement: 'top' })
|
|
290
|
+
const { tablistAction, panelsAction } = initActions({ tablistNode, panelsNode })
|
|
291
|
+
|
|
292
|
+
const tabs = getTabElements(tablistNode)
|
|
293
|
+
|
|
294
|
+
clickTab(tabs[2]) // last tab
|
|
295
|
+
pressKey(tablistNode, 'ArrowRight')
|
|
296
|
+
|
|
297
|
+
expect(tabs[2].getAttribute('aria-selected')).toBe('true')
|
|
298
|
+
|
|
299
|
+
tablistAction.destroy()
|
|
300
|
+
panelsAction.destroy()
|
|
301
|
+
})
|
|
302
|
+
|
|
303
|
+
test('ArrowLeft at first tab does nothing (no loop by default)', () => {
|
|
304
|
+
const { tablistNode, panelsNode } = createTabsDOM({ placement: 'top' })
|
|
305
|
+
const { tablistAction, panelsAction } = initActions({ tablistNode, panelsNode })
|
|
306
|
+
|
|
307
|
+
const tabs = getTabElements(tablistNode)
|
|
308
|
+
tabs[0].focus()
|
|
309
|
+
pressKey(tablistNode, 'ArrowLeft')
|
|
310
|
+
|
|
311
|
+
expect(tabs[0].getAttribute('aria-selected')).toBe('true')
|
|
312
|
+
|
|
313
|
+
tablistAction.destroy()
|
|
314
|
+
panelsAction.destroy()
|
|
315
|
+
})
|
|
316
|
+
|
|
317
|
+
test('ArrowUp/ArrowDown do NOT navigate tabs when placement is top', () => {
|
|
318
|
+
const { tablistNode, panelsNode } = createTabsDOM({ placement: 'top' })
|
|
319
|
+
const { tablistAction, panelsAction } = initActions({ tablistNode, panelsNode })
|
|
320
|
+
|
|
321
|
+
const tabs = getTabElements(tablistNode)
|
|
322
|
+
tabs[0].focus()
|
|
323
|
+
|
|
324
|
+
pressKey(tablistNode, 'ArrowUp')
|
|
325
|
+
expect(tabs[0].getAttribute('aria-selected')).toBe('true')
|
|
326
|
+
|
|
327
|
+
// ArrowDown focuses tabpanel, not next tab
|
|
328
|
+
// We verify tab selection doesn't change
|
|
329
|
+
pressKey(tablistNode, 'ArrowDown')
|
|
330
|
+
expect(tabs[0].getAttribute('aria-selected')).toBe('true')
|
|
331
|
+
|
|
332
|
+
tablistAction.destroy()
|
|
333
|
+
panelsAction.destroy()
|
|
334
|
+
})
|
|
335
|
+
})
|
|
336
|
+
|
|
337
|
+
// ============================================
|
|
338
|
+
// Keyboard Navigation: Vertical (left)
|
|
339
|
+
// ============================================
|
|
340
|
+
|
|
341
|
+
describe('keyboard navigation: vertical (placement=left)', () => {
|
|
342
|
+
test('ArrowDown selects next tab', () => {
|
|
343
|
+
const { tablistNode, panelsNode } = createTabsDOM({ placement: 'left' })
|
|
344
|
+
const { tablistAction, panelsAction } = initActions({ tablistNode, panelsNode })
|
|
345
|
+
|
|
346
|
+
const tabs = getTabElements(tablistNode)
|
|
347
|
+
tabs[0].focus()
|
|
348
|
+
pressKey(tablistNode, 'ArrowDown')
|
|
349
|
+
|
|
350
|
+
expect(tabs[1].getAttribute('aria-selected')).toBe('true')
|
|
351
|
+
expect(tabs[0].hasAttribute('aria-selected')).toBe(false)
|
|
352
|
+
|
|
353
|
+
tablistAction.destroy()
|
|
354
|
+
panelsAction.destroy()
|
|
355
|
+
})
|
|
356
|
+
|
|
357
|
+
test('ArrowUp selects previous tab', () => {
|
|
358
|
+
const { tablistNode, panelsNode } = createTabsDOM({ placement: 'left' })
|
|
359
|
+
const { tablistAction, panelsAction } = initActions({ tablistNode, panelsNode })
|
|
360
|
+
|
|
361
|
+
const tabs = getTabElements(tablistNode)
|
|
362
|
+
|
|
363
|
+
clickTab(tabs[1])
|
|
364
|
+
pressKey(tablistNode, 'ArrowUp')
|
|
365
|
+
|
|
366
|
+
expect(tabs[0].getAttribute('aria-selected')).toBe('true')
|
|
367
|
+
|
|
368
|
+
tablistAction.destroy()
|
|
369
|
+
panelsAction.destroy()
|
|
370
|
+
})
|
|
371
|
+
|
|
372
|
+
test('ArrowLeft/ArrowRight do NOT navigate tabs when placement is left', () => {
|
|
373
|
+
const { tablistNode, panelsNode } = createTabsDOM({ placement: 'left' })
|
|
374
|
+
const { tablistAction, panelsAction } = initActions({ tablistNode, panelsNode })
|
|
375
|
+
|
|
376
|
+
const tabs = getTabElements(tablistNode)
|
|
377
|
+
tabs[0].focus()
|
|
378
|
+
|
|
379
|
+
pressKey(tablistNode, 'ArrowLeft')
|
|
380
|
+
expect(tabs[0].getAttribute('aria-selected')).toBe('true')
|
|
381
|
+
|
|
382
|
+
// ArrowRight focuses tabpanel, not next tab
|
|
383
|
+
pressKey(tablistNode, 'ArrowRight')
|
|
384
|
+
expect(tabs[0].getAttribute('aria-selected')).toBe('true')
|
|
385
|
+
|
|
386
|
+
tablistAction.destroy()
|
|
387
|
+
panelsAction.destroy()
|
|
388
|
+
})
|
|
389
|
+
})
|
|
390
|
+
|
|
391
|
+
// ============================================
|
|
392
|
+
// Keyboard Navigation: Vertical (right)
|
|
393
|
+
// ============================================
|
|
394
|
+
|
|
395
|
+
describe('keyboard navigation: vertical (placement=right)', () => {
|
|
396
|
+
test('ArrowDown selects next tab', () => {
|
|
397
|
+
const { tablistNode, panelsNode } = createTabsDOM({ placement: 'right' })
|
|
398
|
+
const { tablistAction, panelsAction } = initActions({ tablistNode, panelsNode })
|
|
399
|
+
|
|
400
|
+
const tabs = getTabElements(tablistNode)
|
|
401
|
+
tabs[0].focus()
|
|
402
|
+
pressKey(tablistNode, 'ArrowDown')
|
|
403
|
+
|
|
404
|
+
expect(tabs[1].getAttribute('aria-selected')).toBe('true')
|
|
405
|
+
|
|
406
|
+
tablistAction.destroy()
|
|
407
|
+
panelsAction.destroy()
|
|
408
|
+
})
|
|
409
|
+
|
|
410
|
+
test('ArrowUp selects previous tab', () => {
|
|
411
|
+
const { tablistNode, panelsNode } = createTabsDOM({ placement: 'right' })
|
|
412
|
+
const { tablistAction, panelsAction } = initActions({ tablistNode, panelsNode })
|
|
413
|
+
|
|
414
|
+
const tabs = getTabElements(tablistNode)
|
|
415
|
+
|
|
416
|
+
clickTab(tabs[2])
|
|
417
|
+
pressKey(tablistNode, 'ArrowUp')
|
|
418
|
+
|
|
419
|
+
expect(tabs[1].getAttribute('aria-selected')).toBe('true')
|
|
420
|
+
|
|
421
|
+
tablistAction.destroy()
|
|
422
|
+
panelsAction.destroy()
|
|
423
|
+
})
|
|
424
|
+
|
|
425
|
+
test('ArrowLeft focuses tabpanel (does not navigate tabs)', () => {
|
|
426
|
+
const { tablistNode, panelsNode } = createTabsDOM({ placement: 'right' })
|
|
427
|
+
const { tablistAction, panelsAction } = initActions({ tablistNode, panelsNode })
|
|
428
|
+
|
|
429
|
+
const tabs = getTabElements(tablistNode)
|
|
430
|
+
tabs[0].focus()
|
|
431
|
+
|
|
432
|
+
pressKey(tablistNode, 'ArrowLeft')
|
|
433
|
+
// Tab 0 should still be selected (ArrowLeft goes to panel, doesn't change tab)
|
|
434
|
+
expect(tabs[0].getAttribute('aria-selected')).toBe('true')
|
|
435
|
+
|
|
436
|
+
tablistAction.destroy()
|
|
437
|
+
panelsAction.destroy()
|
|
438
|
+
})
|
|
439
|
+
})
|
|
440
|
+
|
|
441
|
+
// ============================================
|
|
442
|
+
// Placement from CSS (the core new behavior)
|
|
443
|
+
// ============================================
|
|
444
|
+
|
|
445
|
+
describe('tablist reads placement from CSS', () => {
|
|
446
|
+
test('reads --placement: left from CSS on mount', () => {
|
|
447
|
+
const { tablistNode, panelsNode, panelId } = createTabsDOM({ placement: 'left' })
|
|
448
|
+
const { tablistAction, panelsAction } = initActions({ tablistNode, panelsNode })
|
|
449
|
+
|
|
450
|
+
const tab = getTab(panelId)
|
|
451
|
+
expect(tab.state.placement).toBe('left')
|
|
452
|
+
|
|
453
|
+
tablistAction.destroy()
|
|
454
|
+
panelsAction.destroy()
|
|
455
|
+
})
|
|
456
|
+
|
|
457
|
+
test('reads --placement: right from CSS on mount', () => {
|
|
458
|
+
const { tablistNode, panelsNode, panelId } = createTabsDOM({ placement: 'right' })
|
|
459
|
+
const { tablistAction, panelsAction } = initActions({ tablistNode, panelsNode })
|
|
460
|
+
|
|
461
|
+
const tab = getTab(panelId)
|
|
462
|
+
expect(tab.state.placement).toBe('right')
|
|
463
|
+
|
|
464
|
+
tablistAction.destroy()
|
|
465
|
+
panelsAction.destroy()
|
|
466
|
+
})
|
|
467
|
+
|
|
468
|
+
test('defaults to "top" when --placement is not set', () => {
|
|
469
|
+
const { tablistNode, panelsNode, panelId } = createTabsDOM({})
|
|
470
|
+
tablistNode.style.removeProperty('--placement')
|
|
471
|
+
const { tablistAction, panelsAction } = initActions({ tablistNode, panelsNode })
|
|
472
|
+
|
|
473
|
+
const tab = getTab(panelId)
|
|
474
|
+
expect(tab.state.placement).toBe('top')
|
|
475
|
+
|
|
476
|
+
tablistAction.destroy()
|
|
477
|
+
panelsAction.destroy()
|
|
478
|
+
})
|
|
479
|
+
})
|
|
480
|
+
|
|
481
|
+
// ============================================
|
|
482
|
+
// CLS prevention: no JS-added placement classes
|
|
483
|
+
// ============================================
|
|
484
|
+
|
|
485
|
+
describe('CLS prevention', () => {
|
|
486
|
+
test('tablist action does NOT add tablist-top/left/right classes to the DOM', () => {
|
|
487
|
+
const { tablistNode, panelsNode } = createTabsDOM({ placement: 'left' })
|
|
488
|
+
const { tablistAction, panelsAction } = initActions({ tablistNode, panelsNode })
|
|
489
|
+
|
|
490
|
+
// The action should not add placement classes — CSS handles that
|
|
491
|
+
// The node should only have what was set during DOM creation
|
|
492
|
+
expect(tablistNode.classList.contains('tablist-left')).toBe(false)
|
|
493
|
+
expect(tablistNode.classList.contains('tablist-top')).toBe(false)
|
|
494
|
+
expect(tablistNode.classList.contains('tablist-right')).toBe(false)
|
|
495
|
+
|
|
496
|
+
tablistAction.destroy()
|
|
497
|
+
panelsAction.destroy()
|
|
498
|
+
})
|
|
499
|
+
})
|
|
500
|
+
|
|
501
|
+
// ============================================
|
|
502
|
+
// selectTab, selectNextTab, selectPrevTab
|
|
503
|
+
// ============================================
|
|
504
|
+
|
|
505
|
+
describe('selectTab API', () => {
|
|
506
|
+
test('selectTab changes active tab and panel', () => {
|
|
507
|
+
const { tablistNode, panelsNode, panelId } = createTabsDOM()
|
|
508
|
+
const { tablistAction, panelsAction } = initActions({ tablistNode, panelsNode })
|
|
509
|
+
|
|
510
|
+
const tab = getTab(panelId)
|
|
511
|
+
const tabs = getTabElements(tablistNode)
|
|
512
|
+
const panels = getPanelElements(panelsNode)
|
|
513
|
+
|
|
514
|
+
selectTab(tab, 2, { shouldFocusOnTab: false })
|
|
515
|
+
|
|
516
|
+
expect(tabs[2].getAttribute('aria-selected')).toBe('true')
|
|
517
|
+
expect(panels[2].hasAttribute('hidden')).toBe(false)
|
|
518
|
+
expect(panels[0].getAttribute('hidden')).toBe('true')
|
|
519
|
+
|
|
520
|
+
tablistAction.destroy()
|
|
521
|
+
panelsAction.destroy()
|
|
522
|
+
})
|
|
523
|
+
|
|
524
|
+
test('selectNextTab advances from current', () => {
|
|
525
|
+
const { tablistNode, panelsNode, panelId } = createTabsDOM()
|
|
526
|
+
const { tablistAction, panelsAction } = initActions({ tablistNode, panelsNode })
|
|
527
|
+
|
|
528
|
+
const tab = getTab(panelId)
|
|
529
|
+
const tabs = getTabElements(tablistNode)
|
|
530
|
+
|
|
531
|
+
selectNextTab(tab)
|
|
532
|
+
|
|
533
|
+
expect(tabs[1].getAttribute('aria-selected')).toBe('true')
|
|
534
|
+
|
|
535
|
+
tablistAction.destroy()
|
|
536
|
+
panelsAction.destroy()
|
|
537
|
+
})
|
|
538
|
+
|
|
539
|
+
test('selectPrevTab does nothing at index 0 without loop', () => {
|
|
540
|
+
const { tablistNode, panelsNode, panelId } = createTabsDOM()
|
|
541
|
+
const { tablistAction, panelsAction } = initActions({ tablistNode, panelsNode })
|
|
542
|
+
|
|
543
|
+
const tab = getTab(panelId)
|
|
544
|
+
const tabs = getTabElements(tablistNode)
|
|
545
|
+
|
|
546
|
+
selectPrevTab(tab)
|
|
547
|
+
|
|
548
|
+
expect(tabs[0].getAttribute('aria-selected')).toBe('true')
|
|
549
|
+
|
|
550
|
+
tablistAction.destroy()
|
|
551
|
+
panelsAction.destroy()
|
|
552
|
+
})
|
|
553
|
+
})
|
|
@@ -7,6 +7,15 @@ import {
|
|
|
7
7
|
removeListeners,
|
|
8
8
|
} from '@splendidlabz/utils/dom'
|
|
9
9
|
|
|
10
|
+
/**
|
|
11
|
+
* Reads the --placement CSS custom property from a node's computed style.
|
|
12
|
+
* Falls back to 'top' if not set.
|
|
13
|
+
*/
|
|
14
|
+
export function readPlacement(node) {
|
|
15
|
+
const value = getComputedStyle(node).getPropertyValue('--placement').trim()
|
|
16
|
+
return value || 'top'
|
|
17
|
+
}
|
|
18
|
+
|
|
10
19
|
// ========================
|
|
11
20
|
// Shared State
|
|
12
21
|
// ========================
|
|
@@ -70,7 +79,7 @@ export function tablist(node, props) {
|
|
|
70
79
|
id: targetId,
|
|
71
80
|
state: {
|
|
72
81
|
...DEFAULT_TABLIST_OPTIONS.state,
|
|
73
|
-
placement:
|
|
82
|
+
placement: readPlacement(node),
|
|
74
83
|
activeTabIndex,
|
|
75
84
|
length: tablistItems.length,
|
|
76
85
|
},
|
|
@@ -101,12 +110,23 @@ export function tablist(node, props) {
|
|
|
101
110
|
|
|
102
111
|
addListeners(listeners)
|
|
103
112
|
|
|
113
|
+
// Re-read placement from CSS on resize (handles responsive breakpoints)
|
|
114
|
+
function handleResize() {
|
|
115
|
+
const newPlacement = readPlacement(node)
|
|
116
|
+
if (newPlacement !== Tab.state.placement) {
|
|
117
|
+
updatePlacement(Tab, newPlacement)
|
|
118
|
+
}
|
|
119
|
+
}
|
|
120
|
+
|
|
121
|
+
window.addEventListener('resize', handleResize)
|
|
122
|
+
|
|
104
123
|
const { autoplay } = Tab.options
|
|
105
124
|
if (autoplay) setAutoplayInterval(Tab)
|
|
106
125
|
|
|
107
126
|
return {
|
|
108
127
|
destroy() {
|
|
109
128
|
removeListeners(listeners)
|
|
129
|
+
window.removeEventListener('resize', handleResize)
|
|
110
130
|
},
|
|
111
131
|
}
|
|
112
132
|
|
|
@@ -154,13 +174,17 @@ export function tabpanels(node, props) {
|
|
|
154
174
|
node.querySelectorAll('[role="tabpanel"]'),
|
|
155
175
|
).filter(tab => tab.closest('.tabpanels') === node)
|
|
156
176
|
|
|
177
|
+
const existingTab = getTab(tabpanelsId)
|
|
157
178
|
let activeTabIndex
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
179
|
+
if (existingTab?.nodes?.tablist != null) {
|
|
180
|
+
activeTabIndex = existingTab.state.activeTabIndex ?? 0
|
|
181
|
+
} else {
|
|
182
|
+
activeTabIndex = tabpanelItems.findIndex(
|
|
183
|
+
tabpanel => !tabpanel.hasAttribute('hidden'),
|
|
184
|
+
)
|
|
185
|
+
if (activeTabIndex === -1) activeTabIndex = 0
|
|
186
|
+
}
|
|
162
187
|
|
|
163
|
-
// Initialize the Tab
|
|
164
188
|
const Tab = initTab({
|
|
165
189
|
id: tabpanelsId,
|
|
166
190
|
state: { activeTabIndex, length: tabpanelItems.length },
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@splendidlabz/svelte",
|
|
3
3
|
"type": "module",
|
|
4
|
-
"version": "4.
|
|
4
|
+
"version": "4.9.0",
|
|
5
5
|
"sideEffects": false,
|
|
6
6
|
"homepage": "https://splendidlabz.com/docs/svelte",
|
|
7
7
|
"scripts": {
|
|
@@ -34,7 +34,9 @@
|
|
|
34
34
|
"devDependencies": {
|
|
35
35
|
"@splendidlabz/eslint-config": "2.1.3",
|
|
36
36
|
"@sveltejs/vite-plugin-svelte": "^6.2.4",
|
|
37
|
+
"@testing-library/svelte": "^5.3.1",
|
|
37
38
|
"@tsconfig/svelte": "^5.0.4",
|
|
39
|
+
"happy-dom": "^20.8.8",
|
|
38
40
|
"svelte": "^5.25.6",
|
|
39
41
|
"svelte-check": "^4.2.1",
|
|
40
42
|
"vitest": "^3.1.1"
|
package/utils/loadscripts.js
CHANGED
|
@@ -2,6 +2,8 @@ export function reloadScripts(node) {
|
|
|
2
2
|
let scripts = []
|
|
3
3
|
const scriptElements = Array.from(node.querySelectorAll('script'))
|
|
4
4
|
|
|
5
|
+
if (scriptElements.length === 0) return
|
|
6
|
+
|
|
5
7
|
scriptElements.forEach(origScript => {
|
|
6
8
|
const script = document.createElement('script')
|
|
7
9
|
Array.from(origScript.attributes).forEach(attr => {
|