@spectrum-web-components/tabs 0.0.0-20241209155954
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/README.md +316 -0
- package/package.json +106 -0
- package/sp-tab-panel.d.ts +6 -0
- package/sp-tab-panel.dev.js +5 -0
- package/sp-tab-panel.dev.js.map +7 -0
- package/sp-tab-panel.js +2 -0
- package/sp-tab-panel.js.map +7 -0
- package/sp-tab.d.ts +6 -0
- package/sp-tab.dev.js +5 -0
- package/sp-tab.dev.js.map +7 -0
- package/sp-tab.js +2 -0
- package/sp-tab.js.map +7 -0
- package/sp-tabs-overflow.d.ts +6 -0
- package/sp-tabs-overflow.dev.js +5 -0
- package/sp-tabs-overflow.dev.js.map +7 -0
- package/sp-tabs-overflow.js +2 -0
- package/sp-tabs-overflow.js.map +7 -0
- package/sp-tabs.d.ts +6 -0
- package/sp-tabs.dev.js +5 -0
- package/sp-tabs.dev.js.map +7 -0
- package/sp-tabs.js +2 -0
- package/sp-tabs.js.map +7 -0
- package/src/Tab.d.ts +28 -0
- package/src/Tab.dev.js +94 -0
- package/src/Tab.dev.js.map +7 -0
- package/src/Tab.js +10 -0
- package/src/Tab.js.map +7 -0
- package/src/TabPanel.d.ts +16 -0
- package/src/TabPanel.dev.js +66 -0
- package/src/TabPanel.dev.js.map +7 -0
- package/src/TabPanel.js +7 -0
- package/src/TabPanel.js.map +7 -0
- package/src/Tabs.d.ts +102 -0
- package/src/Tabs.dev.js +457 -0
- package/src/Tabs.dev.js.map +7 -0
- package/src/Tabs.js +30 -0
- package/src/Tabs.js.map +7 -0
- package/src/TabsOverflow.d.ts +31 -0
- package/src/TabsOverflow.dev.js +165 -0
- package/src/TabsOverflow.dev.js.map +7 -0
- package/src/TabsOverflow.js +36 -0
- package/src/TabsOverflow.js.map +7 -0
- package/src/index.d.ts +4 -0
- package/src/index.dev.js +6 -0
- package/src/index.dev.js.map +7 -0
- package/src/index.js +2 -0
- package/src/index.js.map +7 -0
- package/src/spectrum-config.js +395 -0
- package/src/spectrum-tab.css.d.ts +2 -0
- package/src/spectrum-tab.css.dev.js +7 -0
- package/src/spectrum-tab.css.dev.js.map +7 -0
- package/src/spectrum-tab.css.js +4 -0
- package/src/spectrum-tab.css.js.map +7 -0
- package/src/spectrum-tabs-sizes.css.d.ts +2 -0
- package/src/spectrum-tabs-sizes.css.dev.js +7 -0
- package/src/spectrum-tabs-sizes.css.dev.js.map +7 -0
- package/src/spectrum-tabs-sizes.css.js +4 -0
- package/src/spectrum-tabs-sizes.css.js.map +7 -0
- package/src/spectrum-tabs.css.d.ts +2 -0
- package/src/spectrum-tabs.css.dev.js +7 -0
- package/src/spectrum-tabs.css.dev.js.map +7 -0
- package/src/spectrum-tabs.css.js +4 -0
- package/src/spectrum-tabs.css.js.map +7 -0
- package/src/tab-panel.css.d.ts +2 -0
- package/src/tab-panel.css.dev.js +7 -0
- package/src/tab-panel.css.dev.js.map +7 -0
- package/src/tab-panel.css.js +4 -0
- package/src/tab-panel.css.js.map +7 -0
- package/src/tab.css.d.ts +2 -0
- package/src/tab.css.dev.js +7 -0
- package/src/tab.css.dev.js.map +7 -0
- package/src/tab.css.js +4 -0
- package/src/tab.css.js.map +7 -0
- package/src/tabs-overflow.css.d.ts +2 -0
- package/src/tabs-overflow.css.dev.js +7 -0
- package/src/tabs-overflow.css.dev.js.map +7 -0
- package/src/tabs-overflow.css.js +4 -0
- package/src/tabs-overflow.css.js.map +7 -0
- package/src/tabs-overrides.css.d.ts +2 -0
- package/src/tabs-overrides.css.dev.js +7 -0
- package/src/tabs-overrides.css.dev.js.map +7 -0
- package/src/tabs-overrides.css.js +4 -0
- package/src/tabs-overrides.css.js.map +7 -0
- package/src/tabs-sizes-overrides.css.d.ts +2 -0
- package/src/tabs-sizes-overrides.css.dev.js +7 -0
- package/src/tabs-sizes-overrides.css.dev.js.map +7 -0
- package/src/tabs-sizes-overrides.css.js +4 -0
- package/src/tabs-sizes-overrides.css.js.map +7 -0
- package/src/tabs-sizes.css.d.ts +2 -0
- package/src/tabs-sizes.css.dev.js +7 -0
- package/src/tabs-sizes.css.dev.js.map +7 -0
- package/src/tabs-sizes.css.js +4 -0
- package/src/tabs-sizes.css.js.map +7 -0
- package/src/tabs.css.d.ts +2 -0
- package/src/tabs.css.dev.js +7 -0
- package/src/tabs.css.dev.js.map +7 -0
- package/src/tabs.css.js +4 -0
- package/src/tabs.css.js.map +7 -0
package/README.md
ADDED
|
@@ -0,0 +1,316 @@
|
|
|
1
|
+
## Description
|
|
2
|
+
|
|
3
|
+
The `<sp-tabs>` displays a list of `<sp-tab>` element children as `role="tablist"`. An `<sp-tab>` element is associated with a sibling `<sp-tab-panel>` element via their `value` attribute. When an `<sp-tab>` element is `selected`, the associated `<sp-tab-panel>` will also be selected, showing that panel and hiding the others.
|
|
4
|
+
|
|
5
|
+
### Usage
|
|
6
|
+
|
|
7
|
+
[](https://www.npmjs.com/package/@spectrum-web-components/tabs)
|
|
8
|
+
[](https://bundlephobia.com/result?p=@spectrum-web-components/tabs)
|
|
9
|
+
[](https://webcomponents.dev/edit/collection/fO75441E1Q5ZlI0e9pgq/2JFFTBPXfCZpePD0wk58/src/index.ts)
|
|
10
|
+
|
|
11
|
+
```
|
|
12
|
+
yarn add @spectrum-web-components/tabs
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
Import the side effectful registration of `<sp-tabs>`, `<sp-tab>` or `<sp-tab-panel>` via:
|
|
16
|
+
|
|
17
|
+
```
|
|
18
|
+
import '@spectrum-web-components/tabs/sp-tabs.js';
|
|
19
|
+
import '@spectrum-web-components/tabs/sp-tab.js';
|
|
20
|
+
import '@spectrum-web-components/tabs/sp-tab-panel.js';
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
When looking to leverage the `Tabs`, `Tab`, or `TabPanel` base class as a type and/or for extension purposes, do so via:
|
|
24
|
+
|
|
25
|
+
```
|
|
26
|
+
import {
|
|
27
|
+
Tabs,
|
|
28
|
+
Tab,
|
|
29
|
+
TabPanel
|
|
30
|
+
} from '@spectrum-web-components/tabs';
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
## Sizes
|
|
34
|
+
|
|
35
|
+
<sp-tabs selected="m" auto label="Size Attribute Options">
|
|
36
|
+
<sp-tab value="s">Small</sp-tab>
|
|
37
|
+
<sp-tab-panel value="s">
|
|
38
|
+
|
|
39
|
+
```html demo
|
|
40
|
+
<sp-tabs selected="1" size="s">
|
|
41
|
+
<sp-tab label="Tab 1" value="1"></sp-tab>
|
|
42
|
+
<sp-tab label="Tab 2" value="2"></sp-tab>
|
|
43
|
+
<sp-tab label="Tab 3" value="3"></sp-tab>
|
|
44
|
+
<sp-tab label="Tab 4" value="4"></sp-tab>
|
|
45
|
+
<sp-tab-panel value="1">Content for Tab 1</sp-tab-panel>
|
|
46
|
+
<sp-tab-panel value="2">Content for Tab 2</sp-tab-panel>
|
|
47
|
+
<sp-tab-panel value="3">Content for Tab 3</sp-tab-panel>
|
|
48
|
+
<sp-tab-panel value="4">Content for Tab 4</sp-tab-panel>
|
|
49
|
+
</sp-tabs>
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
</sp-tab-panel>
|
|
53
|
+
<sp-tab value="m">Medium</sp-tab>
|
|
54
|
+
<sp-tab-panel value="m">
|
|
55
|
+
|
|
56
|
+
```html demo
|
|
57
|
+
<sp-tabs selected="1" size="m">
|
|
58
|
+
<sp-tab label="Tab 1" value="1"></sp-tab>
|
|
59
|
+
<sp-tab label="Tab 2" value="2"></sp-tab>
|
|
60
|
+
<sp-tab label="Tab 3" value="3"></sp-tab>
|
|
61
|
+
<sp-tab label="Tab 4" value="4"></sp-tab>
|
|
62
|
+
<sp-tab-panel value="1">Content for Tab 1</sp-tab-panel>
|
|
63
|
+
<sp-tab-panel value="2">Content for Tab 2</sp-tab-panel>
|
|
64
|
+
<sp-tab-panel value="3">Content for Tab 3</sp-tab-panel>
|
|
65
|
+
<sp-tab-panel value="4">Content for Tab 4</sp-tab-panel>
|
|
66
|
+
</sp-tabs>
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
</sp-tab-panel>
|
|
70
|
+
<sp-tab value="l">Large</sp-tab>
|
|
71
|
+
<sp-tab-panel value="l">
|
|
72
|
+
|
|
73
|
+
```html demo
|
|
74
|
+
<sp-tabs selected="1" size="l">
|
|
75
|
+
<sp-tab label="Tab 1" value="1"></sp-tab>
|
|
76
|
+
<sp-tab label="Tab 2" value="2"></sp-tab>
|
|
77
|
+
<sp-tab label="Tab 3" value="3"></sp-tab>
|
|
78
|
+
<sp-tab label="Tab 4" value="4"></sp-tab>
|
|
79
|
+
<sp-tab-panel value="1">Content for Tab 1</sp-tab-panel>
|
|
80
|
+
<sp-tab-panel value="2">Content for Tab 2</sp-tab-panel>
|
|
81
|
+
<sp-tab-panel value="3">Content for Tab 3</sp-tab-panel>
|
|
82
|
+
<sp-tab-panel value="4">Content for Tab 4</sp-tab-panel>
|
|
83
|
+
</sp-tabs>
|
|
84
|
+
```
|
|
85
|
+
|
|
86
|
+
</sp-tab-panel>
|
|
87
|
+
<sp-tab value="xl">Extra Large</sp-tab>
|
|
88
|
+
<sp-tab-panel value="xl">
|
|
89
|
+
|
|
90
|
+
```html demo
|
|
91
|
+
<sp-tabs selected="1" size="xl">
|
|
92
|
+
<sp-tab label="Tab 1" value="1"></sp-tab>
|
|
93
|
+
<sp-tab label="Tab 2" value="2"></sp-tab>
|
|
94
|
+
<sp-tab label="Tab 3" value="3"></sp-tab>
|
|
95
|
+
<sp-tab label="Tab 4" value="4"></sp-tab>
|
|
96
|
+
<sp-tab-panel value="1">Content for Tab 1</sp-tab-panel>
|
|
97
|
+
<sp-tab-panel value="2">Content for Tab 2</sp-tab-panel>
|
|
98
|
+
<sp-tab-panel value="3">Content for Tab 3</sp-tab-panel>
|
|
99
|
+
<sp-tab-panel value="4">Content for Tab 4</sp-tab-panel>
|
|
100
|
+
</sp-tabs>
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
</sp-tab-panel>
|
|
104
|
+
</sp-tabs>
|
|
105
|
+
|
|
106
|
+
## Horizontal Tabs
|
|
107
|
+
|
|
108
|
+
An `<sp-tabs>` element will display horizontally by default. It can be modified with states like `compact`, `disabled`, and `quiet`, or with content like icons, etc.
|
|
109
|
+
|
|
110
|
+
<sp-tabs selected="compact" auto label="Horizontal Tabs variants">
|
|
111
|
+
<sp-tab value="compact">Compact</sp-tab>
|
|
112
|
+
<sp-tab-panel value="compact">
|
|
113
|
+
|
|
114
|
+
Compact tabs should never be used without the quiet variation. Please use Quiet + Compact Tabs instead.
|
|
115
|
+
|
|
116
|
+
```html demo
|
|
117
|
+
<sp-tabs selected="1" compact>
|
|
118
|
+
<sp-tab label="Tab 1" value="1"></sp-tab>
|
|
119
|
+
<sp-tab label="Tab 2" value="2"></sp-tab>
|
|
120
|
+
<sp-tab label="Tab 3" value="3"></sp-tab>
|
|
121
|
+
<sp-tab label="Tab 4" value="4"></sp-tab>
|
|
122
|
+
<sp-tab-panel value="1">Content for Tab 1</sp-tab-panel>
|
|
123
|
+
<sp-tab-panel value="2">Content for Tab 2</sp-tab-panel>
|
|
124
|
+
<sp-tab-panel value="3">Content for Tab 3</sp-tab-panel>
|
|
125
|
+
<sp-tab-panel value="4">Content for Tab 4</sp-tab-panel>
|
|
126
|
+
</sp-tabs>
|
|
127
|
+
```
|
|
128
|
+
|
|
129
|
+
</sp-tab-panel>
|
|
130
|
+
<sp-tab value="disabled">Disabled</sp-tab>
|
|
131
|
+
<sp-tab-panel value="disabled">
|
|
132
|
+
|
|
133
|
+
When an `<sp-tabs>` element is given the `disabled` attribute its `<sp-tab>` children will be disabled as well, preventing a visitor from changing the selected tab. By default, `<sp-tab-panel>` children will not be addressed and the available content of the currently selected tab will be fully visible.
|
|
134
|
+
|
|
135
|
+
```html demo
|
|
136
|
+
<sp-tabs selected="2" disabled>
|
|
137
|
+
<sp-tab label="Tab 1" value="1"></sp-tab>
|
|
138
|
+
<sp-tab label="Tab 2" value="2"></sp-tab>
|
|
139
|
+
<sp-tab label="Tab 3" value="3"></sp-tab>
|
|
140
|
+
<sp-tab label="Tab 4" value="4"></sp-tab>
|
|
141
|
+
<sp-tab-panel value="1">Content for Tab 1 is not selectable</sp-tab-panel>
|
|
142
|
+
<sp-tab-panel value="2">Content for Tab 2 is selected</sp-tab-panel>
|
|
143
|
+
<sp-tab-panel value="3">Content for Tab 3 is not selectable</sp-tab-panel>
|
|
144
|
+
<sp-tab-panel value="4">Content for Tab 4 is not selectable</sp-tab-panel>
|
|
145
|
+
</sp-tabs>
|
|
146
|
+
```
|
|
147
|
+
|
|
148
|
+
</sp-tab-panel>
|
|
149
|
+
<sp-tab value="icons">Icons</sp-tab>
|
|
150
|
+
<sp-tab-panel value="icons">
|
|
151
|
+
|
|
152
|
+
```html demo
|
|
153
|
+
<sp-tabs selected="1">
|
|
154
|
+
<sp-tab label="Tab 1" value="1">
|
|
155
|
+
<sp-icon-checkmark slot="icon"></sp-icon-checkmark>
|
|
156
|
+
</sp-tab>
|
|
157
|
+
<sp-tab label="Tab 2" value="2">
|
|
158
|
+
<sp-icon-close slot="icon"></sp-icon-close>
|
|
159
|
+
</sp-tab>
|
|
160
|
+
<sp-tab label="Tab 3" value="3">
|
|
161
|
+
<sp-icon-chevron-down slot="icon"></sp-icon-chevron-down>
|
|
162
|
+
</sp-tab>
|
|
163
|
+
<sp-tab label="Tab 4" value="4">
|
|
164
|
+
<sp-icon-help slot="icon"></sp-icon-help>
|
|
165
|
+
</sp-tab>
|
|
166
|
+
<sp-tab-panel value="1">Content for Tab 1</sp-tab-panel>
|
|
167
|
+
<sp-tab-panel value="2">Content for Tab 2</sp-tab-panel>
|
|
168
|
+
<sp-tab-panel value="3">Content for Tab 3</sp-tab-panel>
|
|
169
|
+
<sp-tab-panel value="4">Content for Tab 4</sp-tab-panel>
|
|
170
|
+
</sp-tabs>
|
|
171
|
+
```
|
|
172
|
+
|
|
173
|
+
</sp-tab-panel>
|
|
174
|
+
<sp-tab value="quiet">Quiet</sp-tab>
|
|
175
|
+
<sp-tab-panel value="quiet">
|
|
176
|
+
|
|
177
|
+
```html demo
|
|
178
|
+
<sp-tabs selected="1" quiet>
|
|
179
|
+
<sp-tab label="Tab 1" value="1"></sp-tab>
|
|
180
|
+
<sp-tab label="Tab 2" value="2"></sp-tab>
|
|
181
|
+
<sp-tab label="Tab 3" value="3"></sp-tab>
|
|
182
|
+
<sp-tab label="Tab 4" value="4"></sp-tab>
|
|
183
|
+
<sp-tab-panel value="1">Content for Tab 1</sp-tab-panel>
|
|
184
|
+
<sp-tab-panel value="2">Content for Tab 2</sp-tab-panel>
|
|
185
|
+
<sp-tab-panel value="3">Content for Tab 3</sp-tab-panel>
|
|
186
|
+
<sp-tab-panel value="4">Content for Tab 4</sp-tab-panel>
|
|
187
|
+
</sp-tabs>
|
|
188
|
+
```
|
|
189
|
+
|
|
190
|
+
</sp-tab-panel>
|
|
191
|
+
<sp-tab value="quiet+compact">Quiet + Compact</sp-tab>
|
|
192
|
+
<sp-tab-panel value="quiet+compact">
|
|
193
|
+
|
|
194
|
+
```html demo
|
|
195
|
+
<sp-tabs selected="1" quiet compact>
|
|
196
|
+
<sp-tab label="Tab 1" value="1"></sp-tab>
|
|
197
|
+
<sp-tab label="Tab 2" value="2"></sp-tab>
|
|
198
|
+
<sp-tab label="Tab 3" value="3"></sp-tab>
|
|
199
|
+
<sp-tab label="Tab 4" value="4"></sp-tab>
|
|
200
|
+
<sp-tab-panel value="1">Content for Tab 1</sp-tab-panel>
|
|
201
|
+
<sp-tab-panel value="2">Content for Tab 2</sp-tab-panel>
|
|
202
|
+
<sp-tab-panel value="3">Content for Tab 3</sp-tab-panel>
|
|
203
|
+
<sp-tab-panel value="4">Content for Tab 4</sp-tab-panel>
|
|
204
|
+
</sp-tabs>
|
|
205
|
+
```
|
|
206
|
+
|
|
207
|
+
</sp-tab-panel>
|
|
208
|
+
</sp-tabs>
|
|
209
|
+
|
|
210
|
+
## Vertical Tabs
|
|
211
|
+
|
|
212
|
+
An `<sp-tabs>` element will display horizontally by default. It can be modified with states like `compact`, `disabled`, and `quiet`, or with content like icons, etc.
|
|
213
|
+
|
|
214
|
+
<sp-tabs selected="compact" auto label="Horizontal Tabs variants">
|
|
215
|
+
<sp-tab value="compact">Compact</sp-tab>
|
|
216
|
+
<sp-tab-panel value="compact">
|
|
217
|
+
|
|
218
|
+
Compact tabs should never be used without the quiet variation. Please use Quiet + Compact Tabs instead.
|
|
219
|
+
|
|
220
|
+
```html demo
|
|
221
|
+
<sp-tabs selected="1" compact direction="vertical">
|
|
222
|
+
<sp-tab label="Tab 1" value="1"></sp-tab>
|
|
223
|
+
<sp-tab label="Tab 2" value="2"></sp-tab>
|
|
224
|
+
<sp-tab label="Tab 3" value="3"></sp-tab>
|
|
225
|
+
<sp-tab label="Tab 4" value="4"></sp-tab>
|
|
226
|
+
<sp-tab-panel value="1">Content for Tab 1</sp-tab-panel>
|
|
227
|
+
<sp-tab-panel value="2">Content for Tab 2</sp-tab-panel>
|
|
228
|
+
<sp-tab-panel value="3">Content for Tab 3</sp-tab-panel>
|
|
229
|
+
<sp-tab-panel value="4">Content for Tab 4</sp-tab-panel>
|
|
230
|
+
</sp-tabs>
|
|
231
|
+
```
|
|
232
|
+
|
|
233
|
+
</sp-tab-panel>
|
|
234
|
+
<sp-tab value="disabled">Disabled</sp-tab>
|
|
235
|
+
<sp-tab-panel value="disabled">
|
|
236
|
+
|
|
237
|
+
When an `<sp-tabs>` element is given the `disabled` attribute its `<sp-tab>` children will be disabled as well, preventing a visitor from changing the selected tab. By default, `<sp-tab-panel>` children will not be addressed and the available content of the currently selected tab will be fully visible.
|
|
238
|
+
|
|
239
|
+
```html demo
|
|
240
|
+
<sp-tabs selected="2" disabled direction="vertical">
|
|
241
|
+
<sp-tab label="Tab 1" value="1"></sp-tab>
|
|
242
|
+
<sp-tab label="Tab 2" value="2"></sp-tab>
|
|
243
|
+
<sp-tab label="Tab 3" value="3"></sp-tab>
|
|
244
|
+
<sp-tab label="Tab 4" value="4"></sp-tab>
|
|
245
|
+
<sp-tab-panel value="1">Content for Tab 1 is not selectable</sp-tab-panel>
|
|
246
|
+
<sp-tab-panel value="2">Content for Tab 2 is selected</sp-tab-panel>
|
|
247
|
+
<sp-tab-panel value="3">Content for Tab 3 is not selectable</sp-tab-panel>
|
|
248
|
+
<sp-tab-panel value="4">Content for Tab 4 is not selectable</sp-tab-panel>
|
|
249
|
+
</sp-tabs>
|
|
250
|
+
```
|
|
251
|
+
|
|
252
|
+
</sp-tab-panel>
|
|
253
|
+
<sp-tab value="icons">Icons</sp-tab>
|
|
254
|
+
<sp-tab-panel value="icons">
|
|
255
|
+
|
|
256
|
+
```html demo
|
|
257
|
+
<sp-tabs selected="1" direction="vertical">
|
|
258
|
+
<sp-tab label="Tab 1" value="1">
|
|
259
|
+
<sp-icon-checkmark slot="icon"></sp-icon-checkmark>
|
|
260
|
+
</sp-tab>
|
|
261
|
+
<sp-tab label="Tab 2" value="2">
|
|
262
|
+
<sp-icon-close slot="icon"></sp-icon-close>
|
|
263
|
+
</sp-tab>
|
|
264
|
+
<sp-tab label="Tab 3" value="3">
|
|
265
|
+
<sp-icon-chevron-down slot="icon"></sp-icon-chevron-down>
|
|
266
|
+
</sp-tab>
|
|
267
|
+
<sp-tab label="Tab 4" value="4">
|
|
268
|
+
<sp-icon-help slot="icon"></sp-icon-help>
|
|
269
|
+
</sp-tab>
|
|
270
|
+
<sp-tab-panel value="1">Content for Tab 1</sp-tab-panel>
|
|
271
|
+
<sp-tab-panel value="2">Content for Tab 2</sp-tab-panel>
|
|
272
|
+
<sp-tab-panel value="3">Content for Tab 3</sp-tab-panel>
|
|
273
|
+
<sp-tab-panel value="4">Content for Tab 4</sp-tab-panel>
|
|
274
|
+
</sp-tabs>
|
|
275
|
+
```
|
|
276
|
+
|
|
277
|
+
</sp-tab-panel>
|
|
278
|
+
<sp-tab value="quiet">Quiet</sp-tab>
|
|
279
|
+
<sp-tab-panel value="quiet">
|
|
280
|
+
|
|
281
|
+
```html demo
|
|
282
|
+
<sp-tabs selected="1" quiet direction="vertical">
|
|
283
|
+
<sp-tab label="Tab 1" value="1"></sp-tab>
|
|
284
|
+
<sp-tab label="Tab 2" value="2"></sp-tab>
|
|
285
|
+
<sp-tab label="Tab 3" value="3"></sp-tab>
|
|
286
|
+
<sp-tab label="Tab 4" value="4"></sp-tab>
|
|
287
|
+
<sp-tab-panel value="1">Content for Tab 1</sp-tab-panel>
|
|
288
|
+
<sp-tab-panel value="2">Content for Tab 2</sp-tab-panel>
|
|
289
|
+
<sp-tab-panel value="3">Content for Tab 3</sp-tab-panel>
|
|
290
|
+
<sp-tab-panel value="4">Content for Tab 4</sp-tab-panel>
|
|
291
|
+
</sp-tabs>
|
|
292
|
+
```
|
|
293
|
+
|
|
294
|
+
</sp-tab-panel>
|
|
295
|
+
<sp-tab value="quiet+compact">Quiet + Compact</sp-tab>
|
|
296
|
+
<sp-tab-panel value="quiet+compact">
|
|
297
|
+
|
|
298
|
+
```html demo
|
|
299
|
+
<sp-tabs selected="1" quiet compact direction="vertical">
|
|
300
|
+
<sp-tab label="Tab 1" value="1"></sp-tab>
|
|
301
|
+
<sp-tab label="Tab 2" value="2"></sp-tab>
|
|
302
|
+
<sp-tab label="Tab 3" value="3"></sp-tab>
|
|
303
|
+
<sp-tab label="Tab 4" value="4"></sp-tab>
|
|
304
|
+
<sp-tab-panel value="1">Content for Tab 1</sp-tab-panel>
|
|
305
|
+
<sp-tab-panel value="2">Content for Tab 2</sp-tab-panel>
|
|
306
|
+
<sp-tab-panel value="3">Content for Tab 3</sp-tab-panel>
|
|
307
|
+
<sp-tab-panel value="4">Content for Tab 4</sp-tab-panel>
|
|
308
|
+
</sp-tabs>
|
|
309
|
+
```
|
|
310
|
+
|
|
311
|
+
</sp-tab-panel>
|
|
312
|
+
</sp-tabs>
|
|
313
|
+
|
|
314
|
+
## Accessibility
|
|
315
|
+
|
|
316
|
+
When an `<sp-tabs>` has a `selected` value, the `<sp-tab>` child of that `value` will be given `[tabindex="0"]` and will receive initial focus when tabbing into the `<sp-tabs>` element. When no `selected` value is present, the first `<sp-tab>` child will be treated in this way. When focus is currently within the `<sp-tabs>` element, the left and right arrows will move that focus back and forth through the available `<sp-tab>` children.
|
package/package.json
ADDED
|
@@ -0,0 +1,106 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "@spectrum-web-components/tabs",
|
|
3
|
+
"version": "0.0.0-20241209155954",
|
|
4
|
+
"publishConfig": {
|
|
5
|
+
"access": "public"
|
|
6
|
+
},
|
|
7
|
+
"description": "",
|
|
8
|
+
"license": "Apache-2.0",
|
|
9
|
+
"repository": {
|
|
10
|
+
"type": "git",
|
|
11
|
+
"url": "https://github.com/adobe/spectrum-web-components.git",
|
|
12
|
+
"directory": "packages/tabs"
|
|
13
|
+
},
|
|
14
|
+
"author": "",
|
|
15
|
+
"homepage": "https://opensource.adobe.com/spectrum-web-components/components/tabs",
|
|
16
|
+
"bugs": {
|
|
17
|
+
"url": "https://github.com/adobe/spectrum-web-components/issues"
|
|
18
|
+
},
|
|
19
|
+
"main": "./src/index.js",
|
|
20
|
+
"module": "./src/index.js",
|
|
21
|
+
"type": "module",
|
|
22
|
+
"exports": {
|
|
23
|
+
".": {
|
|
24
|
+
"development": "./src/index.dev.js",
|
|
25
|
+
"default": "./src/index.js"
|
|
26
|
+
},
|
|
27
|
+
"./package.json": "./package.json",
|
|
28
|
+
"./src/Tab.js": {
|
|
29
|
+
"development": "./src/Tab.dev.js",
|
|
30
|
+
"default": "./src/Tab.js"
|
|
31
|
+
},
|
|
32
|
+
"./src/TabPanel.js": {
|
|
33
|
+
"development": "./src/TabPanel.dev.js",
|
|
34
|
+
"default": "./src/TabPanel.js"
|
|
35
|
+
},
|
|
36
|
+
"./src/Tabs.js": {
|
|
37
|
+
"development": "./src/Tabs.dev.js",
|
|
38
|
+
"default": "./src/Tabs.js"
|
|
39
|
+
},
|
|
40
|
+
"./src/TabsOverflow.js": {
|
|
41
|
+
"development": "./src/TabsOverflow.dev.js",
|
|
42
|
+
"default": "./src/TabsOverflow.js"
|
|
43
|
+
},
|
|
44
|
+
"./src/index.js": {
|
|
45
|
+
"development": "./src/index.dev.js",
|
|
46
|
+
"default": "./src/index.js"
|
|
47
|
+
},
|
|
48
|
+
"./src/tab-panel.css.js": "./src/tab-panel.css.js",
|
|
49
|
+
"./src/tab.css.js": "./src/tab.css.js",
|
|
50
|
+
"./src/tabs-overflow.css.js": "./src/tabs-overflow.css.js",
|
|
51
|
+
"./src/tabs-overrides.css.js": "./src/tabs-overrides.css.js",
|
|
52
|
+
"./src/tabs-sizes-overrides.css.js": "./src/tabs-sizes-overrides.css.js",
|
|
53
|
+
"./src/tabs-sizes.css.js": "./src/tabs-sizes.css.js",
|
|
54
|
+
"./src/tabs.css.js": "./src/tabs.css.js",
|
|
55
|
+
"./sp-tabs.js": {
|
|
56
|
+
"development": "./sp-tabs.dev.js",
|
|
57
|
+
"default": "./sp-tabs.js"
|
|
58
|
+
},
|
|
59
|
+
"./sp-tab.js": {
|
|
60
|
+
"development": "./sp-tab.dev.js",
|
|
61
|
+
"default": "./sp-tab.js"
|
|
62
|
+
},
|
|
63
|
+
"./sp-tab-panel.js": {
|
|
64
|
+
"development": "./sp-tab-panel.dev.js",
|
|
65
|
+
"default": "./sp-tab-panel.js"
|
|
66
|
+
},
|
|
67
|
+
"./sp-tabs-overflow.js": {
|
|
68
|
+
"development": "./sp-tabs-overflow.dev.js",
|
|
69
|
+
"default": "./sp-tabs-overflow.js"
|
|
70
|
+
}
|
|
71
|
+
},
|
|
72
|
+
"scripts": {
|
|
73
|
+
"test": "echo \"Error: run tests from mono-repo root.\" && exit 1"
|
|
74
|
+
},
|
|
75
|
+
"files": [
|
|
76
|
+
"**/*.d.ts",
|
|
77
|
+
"**/*.js",
|
|
78
|
+
"**/*.js.map",
|
|
79
|
+
"custom-elements.json",
|
|
80
|
+
"!stories/",
|
|
81
|
+
"!test/"
|
|
82
|
+
],
|
|
83
|
+
"keywords": [
|
|
84
|
+
"spectrum css",
|
|
85
|
+
"web components",
|
|
86
|
+
"lit-element",
|
|
87
|
+
"lit-html"
|
|
88
|
+
],
|
|
89
|
+
"dependencies": {
|
|
90
|
+
"@lit-labs/observers": "^2.0.2",
|
|
91
|
+
"@spectrum-web-components/base": "0.0.0-20241209155954",
|
|
92
|
+
"@spectrum-web-components/icon": "0.0.0-20241209155954",
|
|
93
|
+
"@spectrum-web-components/icons-ui": "0.0.0-20241209155954",
|
|
94
|
+
"@spectrum-web-components/reactive-controllers": "0.0.0-20241209155954",
|
|
95
|
+
"@spectrum-web-components/shared": "0.0.0-20241209155954"
|
|
96
|
+
},
|
|
97
|
+
"devDependencies": {
|
|
98
|
+
"@spectrum-css/tabs": "^6.0.0-s2-foundations.16"
|
|
99
|
+
},
|
|
100
|
+
"types": "./src/index.d.ts",
|
|
101
|
+
"customElements": "custom-elements.json",
|
|
102
|
+
"sideEffects": [
|
|
103
|
+
"./sp-*.js",
|
|
104
|
+
"./**/*.dev.js"
|
|
105
|
+
]
|
|
106
|
+
}
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
{
|
|
2
|
+
"version": 3,
|
|
3
|
+
"sources": ["sp-tab-panel.ts"],
|
|
4
|
+
"sourcesContent": ["/*\nCopyright 2020 Adobe. All rights reserved.\nThis file is licensed to you under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License. You may obtain a copy\nof the License at http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software distributed under\nthe License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\nOF ANY KIND, either express or implied. See the License for the specific language\ngoverning permissions and limitations under the License.\n*/\n\nimport { TabPanel } from './src/TabPanel.dev.js'\nimport { defineElement } from '@spectrum-web-components/base/src/define-element.js';\n\ndefineElement('sp-tab-panel', TabPanel);\n\ndeclare global {\n interface HTMLElementTagNameMap {\n 'sp-tab-panel': TabPanel;\n }\n}\n"],
|
|
5
|
+
"mappings": ";AAYA,SAAS,gBAAgB;AACzB,SAAS,qBAAqB;AAE9B,cAAc,gBAAgB,QAAQ;",
|
|
6
|
+
"names": []
|
|
7
|
+
}
|
package/sp-tab-panel.js
ADDED
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
{
|
|
2
|
+
"version": 3,
|
|
3
|
+
"sources": ["sp-tab-panel.ts"],
|
|
4
|
+
"sourcesContent": ["/*\nCopyright 2020 Adobe. All rights reserved.\nThis file is licensed to you under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License. You may obtain a copy\nof the License at http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software distributed under\nthe License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\nOF ANY KIND, either express or implied. See the License for the specific language\ngoverning permissions and limitations under the License.\n*/\n\nimport { TabPanel } from './src/TabPanel.js';\nimport { defineElement } from '@spectrum-web-components/base/src/define-element.js';\n\ndefineElement('sp-tab-panel', TabPanel);\n\ndeclare global {\n interface HTMLElementTagNameMap {\n 'sp-tab-panel': TabPanel;\n }\n}\n"],
|
|
5
|
+
"mappings": "aAYA,OAAS,YAAAA,MAAgB,oBACzB,OAAS,iBAAAC,MAAqB,sDAE9BA,EAAc,eAAgBD,CAAQ",
|
|
6
|
+
"names": ["TabPanel", "defineElement"]
|
|
7
|
+
}
|
package/sp-tab.d.ts
ADDED
package/sp-tab.dev.js
ADDED
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
{
|
|
2
|
+
"version": 3,
|
|
3
|
+
"sources": ["sp-tab.ts"],
|
|
4
|
+
"sourcesContent": ["/*\nCopyright 2020 Adobe. All rights reserved.\nThis file is licensed to you under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License. You may obtain a copy\nof the License at http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software distributed under\nthe License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\nOF ANY KIND, either express or implied. See the License for the specific language\ngoverning permissions and limitations under the License.\n*/\n\nimport { Tab } from './src/Tab.dev.js'\nimport { defineElement } from '@spectrum-web-components/base/src/define-element.js';\n\ndefineElement('sp-tab', Tab);\n\ndeclare global {\n interface HTMLElementTagNameMap {\n 'sp-tab': Tab;\n }\n}\n"],
|
|
5
|
+
"mappings": ";AAYA,SAAS,WAAW;AACpB,SAAS,qBAAqB;AAE9B,cAAc,UAAU,GAAG;",
|
|
6
|
+
"names": []
|
|
7
|
+
}
|
package/sp-tab.js
ADDED
package/sp-tab.js.map
ADDED
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
{
|
|
2
|
+
"version": 3,
|
|
3
|
+
"sources": ["sp-tab.ts"],
|
|
4
|
+
"sourcesContent": ["/*\nCopyright 2020 Adobe. All rights reserved.\nThis file is licensed to you under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License. You may obtain a copy\nof the License at http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software distributed under\nthe License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\nOF ANY KIND, either express or implied. See the License for the specific language\ngoverning permissions and limitations under the License.\n*/\n\nimport { Tab } from './src/Tab.js';\nimport { defineElement } from '@spectrum-web-components/base/src/define-element.js';\n\ndefineElement('sp-tab', Tab);\n\ndeclare global {\n interface HTMLElementTagNameMap {\n 'sp-tab': Tab;\n }\n}\n"],
|
|
5
|
+
"mappings": "aAYA,OAAS,OAAAA,MAAW,eACpB,OAAS,iBAAAC,MAAqB,sDAE9BA,EAAc,SAAUD,CAAG",
|
|
6
|
+
"names": ["Tab", "defineElement"]
|
|
7
|
+
}
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
{
|
|
2
|
+
"version": 3,
|
|
3
|
+
"sources": ["sp-tabs-overflow.ts"],
|
|
4
|
+
"sourcesContent": ["/*\nCopyright 2022 Adobe. All rights reserved.\nThis file is licensed to you under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License. You may obtain a copy\nof the License at http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software distributed under\nthe License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\nOF ANY KIND, either express or implied. See the License for the specific language\ngoverning permissions and limitations under the License.\n*/\nimport { TabsOverflow } from './src/TabsOverflow.dev.js'\nimport { defineElement } from '@spectrum-web-components/base/src/define-element.js';\n\ndefineElement('sp-tabs-overflow', TabsOverflow);\n\ndeclare global {\n interface HTMLElementTagNameMap {\n 'sp-tabs-overflow': TabsOverflow;\n }\n}\n"],
|
|
5
|
+
"mappings": ";AAWA,SAAS,oBAAoB;AAC7B,SAAS,qBAAqB;AAE9B,cAAc,oBAAoB,YAAY;",
|
|
6
|
+
"names": []
|
|
7
|
+
}
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
{
|
|
2
|
+
"version": 3,
|
|
3
|
+
"sources": ["sp-tabs-overflow.ts"],
|
|
4
|
+
"sourcesContent": ["/*\nCopyright 2022 Adobe. All rights reserved.\nThis file is licensed to you under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License. You may obtain a copy\nof the License at http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software distributed under\nthe License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\nOF ANY KIND, either express or implied. See the License for the specific language\ngoverning permissions and limitations under the License.\n*/\nimport { TabsOverflow } from './src/TabsOverflow.js';\nimport { defineElement } from '@spectrum-web-components/base/src/define-element.js';\n\ndefineElement('sp-tabs-overflow', TabsOverflow);\n\ndeclare global {\n interface HTMLElementTagNameMap {\n 'sp-tabs-overflow': TabsOverflow;\n }\n}\n"],
|
|
5
|
+
"mappings": "aAWA,OAAS,gBAAAA,MAAoB,wBAC7B,OAAS,iBAAAC,MAAqB,sDAE9BA,EAAc,mBAAoBD,CAAY",
|
|
6
|
+
"names": ["TabsOverflow", "defineElement"]
|
|
7
|
+
}
|
package/sp-tabs.d.ts
ADDED
package/sp-tabs.dev.js
ADDED
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
{
|
|
2
|
+
"version": 3,
|
|
3
|
+
"sources": ["sp-tabs.ts"],
|
|
4
|
+
"sourcesContent": ["/*\nCopyright 2020 Adobe. All rights reserved.\nThis file is licensed to you under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License. You may obtain a copy\nof the License at http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software distributed under\nthe License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\nOF ANY KIND, either express or implied. See the License for the specific language\ngoverning permissions and limitations under the License.\n*/\n\nimport { Tabs } from './src/Tabs.dev.js'\nimport { defineElement } from '@spectrum-web-components/base/src/define-element.js';\n\ndefineElement('sp-tabs', Tabs);\n\ndeclare global {\n interface HTMLElementTagNameMap {\n 'sp-tabs': Tabs;\n }\n}\n"],
|
|
5
|
+
"mappings": ";AAYA,SAAS,YAAY;AACrB,SAAS,qBAAqB;AAE9B,cAAc,WAAW,IAAI;",
|
|
6
|
+
"names": []
|
|
7
|
+
}
|
package/sp-tabs.js
ADDED
package/sp-tabs.js.map
ADDED
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
{
|
|
2
|
+
"version": 3,
|
|
3
|
+
"sources": ["sp-tabs.ts"],
|
|
4
|
+
"sourcesContent": ["/*\nCopyright 2020 Adobe. All rights reserved.\nThis file is licensed to you under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License. You may obtain a copy\nof the License at http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software distributed under\nthe License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\nOF ANY KIND, either express or implied. See the License for the specific language\ngoverning permissions and limitations under the License.\n*/\n\nimport { Tabs } from './src/Tabs.js';\nimport { defineElement } from '@spectrum-web-components/base/src/define-element.js';\n\ndefineElement('sp-tabs', Tabs);\n\ndeclare global {\n interface HTMLElementTagNameMap {\n 'sp-tabs': Tabs;\n }\n}\n"],
|
|
5
|
+
"mappings": "aAYA,OAAS,QAAAA,MAAY,gBACrB,OAAS,iBAAAC,MAAqB,sDAE9BA,EAAc,UAAWD,CAAI",
|
|
6
|
+
"names": ["Tabs", "defineElement"]
|
|
7
|
+
}
|
package/src/Tab.d.ts
ADDED
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
import { CSSResultArray, PropertyValues, SpectrumElement, TemplateResult } from '@spectrum-web-components/base';
|
|
2
|
+
declare const Tab_base: typeof SpectrumElement & {
|
|
3
|
+
new (...args: any[]): import("@spectrum-web-components/shared/src/observe-slot-presence.js").SlotPresenceObservingInterface;
|
|
4
|
+
prototype: import("@spectrum-web-components/shared/src/observe-slot-presence.js").SlotPresenceObservingInterface;
|
|
5
|
+
} & {
|
|
6
|
+
new (...args: any[]): import("@spectrum-web-components/shared/src/observe-slot-text.js").SlotTextObservingInterface;
|
|
7
|
+
prototype: import("@spectrum-web-components/shared/src/observe-slot-text.js").SlotTextObservingInterface;
|
|
8
|
+
};
|
|
9
|
+
/**
|
|
10
|
+
* @element sp-tab
|
|
11
|
+
*
|
|
12
|
+
* @slot - text label of the Tab
|
|
13
|
+
* @slot icon - The icon that appears on the left of the label
|
|
14
|
+
*/
|
|
15
|
+
export declare class Tab extends Tab_base {
|
|
16
|
+
static get styles(): CSSResultArray;
|
|
17
|
+
protected get hasIcon(): boolean;
|
|
18
|
+
protected get hasLabel(): boolean;
|
|
19
|
+
disabled: boolean;
|
|
20
|
+
label: string;
|
|
21
|
+
selected: boolean;
|
|
22
|
+
vertical: boolean;
|
|
23
|
+
value: string;
|
|
24
|
+
protected render(): TemplateResult;
|
|
25
|
+
protected firstUpdated(changes: PropertyValues): void;
|
|
26
|
+
protected updated(changes: PropertyValues): void;
|
|
27
|
+
}
|
|
28
|
+
export {};
|