@instructure/ui-tabs 11.0.1-snapshot-0 → 11.0.1-snapshot-2

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.
@@ -4,179 +4,94 @@ describes: Tabs
4
4
 
5
5
  `<Tabs />` is an accessible tabbed navigation component. Use the TAB key to focus the component and arrow keys to navigate between panels of content. To set a default panel that should be selected on initial render, set the `selected` prop on that `<Tabs.Panel>`.
6
6
 
7
- - ```js
8
- class Example extends React.Component {
9
- state = {
10
- selectedIndex: 0
11
- }
12
- handleTabChange = (event, { index }) => {
13
- this.setState({
14
- selectedIndex: index
15
- })
16
- }
17
- render() {
18
- const { selectedIndex } = this.state
19
- return (
20
- <Tabs
21
- margin="large auto"
22
- padding="medium"
23
- onRequestTabChange={this.handleTabChange}
24
- >
25
- <Tabs.Panel
26
- id="tabA"
27
- renderTitle="Tab A"
28
- textAlign="center"
29
- padding="large"
30
- isSelected={selectedIndex === 0}
31
- >
32
- <Button>Focus Me</Button>
33
- </Tabs.Panel>
34
- <Tabs.Panel id="tabB" renderTitle="Disabled Tab" isDisabled>
35
- {lorem.paragraphs()}
36
- </Tabs.Panel>
37
- <Tabs.Panel
38
- id="tabC"
39
- renderTitle="Tab C"
40
- isSelected={selectedIndex === 2}
41
- >
42
- {lorem.paragraphs()}
43
- </Tabs.Panel>
44
- <Tabs.Panel
45
- id="tabD"
46
- renderTitle="Tab D"
47
- isSelected={selectedIndex === 3}
48
- >
49
- {lorem.paragraphs()}
50
- </Tabs.Panel>
51
- </Tabs>
52
- )
53
- }
54
- }
55
-
56
- render(<Example />)
57
- ```
58
-
59
- - ```js
60
- const Example = () => {
61
- const [selectedIndex, setSelectedIndex] = useState(0)
7
+ ```js
8
+ ---
9
+ type: example
10
+ ---
11
+ const Example = () => {
12
+ const [selectedIndex, setSelectedIndex] = useState(0)
62
13
 
63
- const handleTabChange = (event, { index }) => {
64
- setSelectedIndex(index)
65
- }
14
+ const handleTabChange = (event, { index }) => {
15
+ setSelectedIndex(index)
16
+ }
66
17
 
67
- return (
68
- <Tabs
69
- margin="large auto"
70
- padding="medium"
71
- onRequestTabChange={handleTabChange}
18
+ return (
19
+ <Tabs
20
+ margin="large auto"
21
+ padding="medium"
22
+ onRequestTabChange={handleTabChange}
23
+ >
24
+ <Tabs.Panel
25
+ id="tabA"
26
+ renderTitle="Tab A"
27
+ textAlign="center"
28
+ padding="large"
29
+ isSelected={selectedIndex === 0}
72
30
  >
73
- <Tabs.Panel
74
- id="tabA"
75
- renderTitle="Tab A"
76
- textAlign="center"
77
- padding="large"
78
- isSelected={selectedIndex === 0}
79
- >
80
- <Button>Focus Me</Button>
81
- </Tabs.Panel>
82
- <Tabs.Panel id="tabB" renderTitle="Disabled Tab" isDisabled>
83
- {lorem.paragraphs()}
84
- </Tabs.Panel>
85
- <Tabs.Panel
86
- id="tabC"
87
- renderTitle="Tab C"
88
- isSelected={selectedIndex === 2}
89
- >
90
- {lorem.paragraphs()}
91
- </Tabs.Panel>
92
- <Tabs.Panel
93
- id="tabD"
94
- renderTitle="Tab D"
95
- isSelected={selectedIndex === 3}
96
- >
97
- {lorem.paragraphs()}
98
- </Tabs.Panel>
99
- </Tabs>
100
- )
101
- }
31
+ <Button>Focus Me</Button>
32
+ </Tabs.Panel>
33
+ <Tabs.Panel id="tabB" renderTitle="Disabled Tab" isDisabled>
34
+ {lorem.paragraphs()}
35
+ </Tabs.Panel>
36
+ <Tabs.Panel
37
+ id="tabC"
38
+ renderTitle="Tab C"
39
+ isSelected={selectedIndex === 2}
40
+ >
41
+ {lorem.paragraphs()}
42
+ </Tabs.Panel>
43
+ <Tabs.Panel
44
+ id="tabD"
45
+ renderTitle="Tab D"
46
+ isSelected={selectedIndex === 3}
47
+ >
48
+ {lorem.paragraphs()}
49
+ </Tabs.Panel>
50
+ </Tabs>
51
+ )
52
+ }
102
53
 
103
- render(<Example />)
104
- ```
54
+ render(<Example />)
55
+ ```
105
56
 
106
57
  ### Secondary Tabs
107
58
 
108
- - ```js
109
- class Example extends React.Component {
110
- state = {
111
- selectedIndex: 2
112
- }
113
- handleTabChange = (event, { index }) => {
114
- this.setState({
115
- selectedIndex: index
116
- })
117
- }
118
- render() {
119
- const { selectedIndex } = this.state
120
- return (
121
- <Tabs
122
- variant="secondary"
123
- onRequestTabChange={this.handleTabChange}
124
- minHeight="10rem"
125
- maxHeight="10rem"
126
- >
127
- <Tabs.Panel renderTitle="First Tab" isSelected={selectedIndex === 0}>
128
- Hello World
129
- </Tabs.Panel>
130
- <Tabs.Panel renderTitle="Disabled Tab" isDisabled>
131
- {lorem.paragraphs()}
132
- </Tabs.Panel>
133
- <Tabs.Panel renderTitle="Third Tab" isSelected={selectedIndex === 2}>
134
- {lorem.paragraphs()}
135
- </Tabs.Panel>
136
- <Tabs.Panel renderTitle="Fourth Tab" isSelected={selectedIndex === 3}>
137
- {lorem.paragraphs()}
138
- </Tabs.Panel>
139
- </Tabs>
140
- )
141
- }
142
- }
143
-
144
- render(<Example />)
145
- ```
146
-
147
- - ```js
148
- const Example = () => {
149
- const [selectedIndex, setSelectedIndex] = useState(2)
150
-
151
- const handleTabChange = (event, { index }) => {
152
- setSelectedIndex(index)
153
- }
59
+ ```js
60
+ ---
61
+ type: example
62
+ ---
63
+ const Example = () => {
64
+ const [selectedIndex, setSelectedIndex] = useState(2)
154
65
 
155
- return (
156
- <Tabs
157
- variant="secondary"
158
- onRequestTabChange={handleTabChange}
159
- minHeight="10rem"
160
- maxHeight="10rem"
161
- >
162
- <Tabs.Panel renderTitle="First Tab" isSelected={selectedIndex === 0}>
163
- Hello World
164
- </Tabs.Panel>
165
- <Tabs.Panel renderTitle="Disabled Tab" isDisabled>
166
- {lorem.paragraphs()}
167
- </Tabs.Panel>
168
- <Tabs.Panel renderTitle="Third Tab" isSelected={selectedIndex === 2}>
169
- {lorem.paragraphs()}
170
- </Tabs.Panel>
171
- <Tabs.Panel renderTitle="Fourth Tab" isSelected={selectedIndex === 3}>
172
- {lorem.paragraphs()}
173
- </Tabs.Panel>
174
- </Tabs>
175
- )
66
+ const handleTabChange = (event, { index }) => {
67
+ setSelectedIndex(index)
176
68
  }
177
69
 
178
- render(<Example />)
179
- ```
70
+ return (
71
+ <Tabs
72
+ variant="secondary"
73
+ onRequestTabChange={handleTabChange}
74
+ minHeight="10rem"
75
+ maxHeight="10rem"
76
+ >
77
+ <Tabs.Panel renderTitle="First Tab" isSelected={selectedIndex === 0}>
78
+ Hello World
79
+ </Tabs.Panel>
80
+ <Tabs.Panel renderTitle="Disabled Tab" isDisabled>
81
+ {lorem.paragraphs()}
82
+ </Tabs.Panel>
83
+ <Tabs.Panel renderTitle="Third Tab" isSelected={selectedIndex === 2}>
84
+ {lorem.paragraphs()}
85
+ </Tabs.Panel>
86
+ <Tabs.Panel renderTitle="Fourth Tab" isSelected={selectedIndex === 3}>
87
+ {lorem.paragraphs()}
88
+ </Tabs.Panel>
89
+ </Tabs>
90
+ )
91
+ }
92
+
93
+ render(<Example />)
94
+ ```
180
95
 
181
96
  ### Handling Tab overflow
182
97
 
@@ -184,154 +99,80 @@ By default, `<Tabs />` will stack each individual `<Tab />` if there isn't enoug
184
99
  space to display them all inline. For a more compact tab navigation, set `tabOverflow` to
185
100
  `scroll`, which allows the Tabs to scroll horizontally.
186
101
 
187
- - ```js
188
- class Example extends React.Component {
189
- state = {
190
- selectedIndex: 4
191
- }
192
- handleTabChange = (event, { index }) => {
193
- this.setState({
194
- selectedIndex: index
195
- })
196
- }
197
- render() {
198
- const { selectedIndex } = this.state
199
- return (
200
- <Tabs
201
- margin="large auto"
202
- padding="medium"
203
- onRequestTabChange={this.handleTabChange}
204
- tabOverflow="scroll"
205
- maxWidth="20rem"
206
- >
207
- <Tabs.Panel
208
- id="tabA"
209
- renderTitle="Tab A"
210
- isSelected={selectedIndex === 0}
211
- >
212
- {lorem.sentence()}
213
- </Tabs.Panel>
214
- <Tabs.Panel
215
- id="tabB"
216
- renderTitle="Tab B"
217
- isSelected={selectedIndex === 1}
218
- >
219
- {lorem.sentence()}
220
- </Tabs.Panel>
221
- <Tabs.Panel
222
- id="tabC"
223
- renderTitle="Tab C"
224
- isSelected={selectedIndex === 2}
225
- >
226
- {lorem.sentence()}
227
- </Tabs.Panel>
228
- <Tabs.Panel
229
- id="tabD"
230
- renderTitle="Tab D"
231
- isSelected={selectedIndex === 3}
232
- >
233
- {lorem.sentence()}
234
- </Tabs.Panel>
235
- <Tabs.Panel
236
- id="tabE"
237
- renderTitle="Tab E"
238
- isSelected={selectedIndex === 4}
239
- >
240
- {lorem.sentence()}
241
- </Tabs.Panel>
242
- <Tabs.Panel
243
- id="tabF"
244
- renderTitle="Tab F"
245
- isSelected={selectedIndex === 5}
246
- >
247
- {lorem.sentence()}
248
- </Tabs.Panel>
249
- <Tabs.Panel
250
- id="tabG"
251
- renderTitle="Tab G"
252
- isSelected={selectedIndex === 6}
253
- >
254
- {lorem.sentence()}
255
- </Tabs.Panel>
256
- </Tabs>
257
- )
258
- }
259
- }
260
-
261
- render(<Example />)
262
- ```
263
-
264
- - ```js
265
- const Example = () => {
266
- const [selectedIndex, setSelectedIndex] = useState(4)
102
+ ```js
103
+ ---
104
+ type: example
105
+ ---
106
+ const Example = () => {
107
+ const [selectedIndex, setSelectedIndex] = useState(4)
267
108
 
268
- const handleTabChange = (event, { index }) => {
269
- setSelectedIndex(index)
270
- }
109
+ const handleTabChange = (event, { index }) => {
110
+ setSelectedIndex(index)
111
+ }
271
112
 
272
- return (
273
- <Tabs
274
- margin="large auto"
275
- padding="medium"
276
- onRequestTabChange={handleTabChange}
277
- tabOverflow="scroll"
278
- maxWidth="20rem"
113
+ return (
114
+ <Tabs
115
+ margin="large auto"
116
+ padding="medium"
117
+ onRequestTabChange={handleTabChange}
118
+ tabOverflow="scroll"
119
+ maxWidth="20rem"
120
+ >
121
+ <Tabs.Panel
122
+ id="tabA"
123
+ renderTitle="Tab A"
124
+ isSelected={selectedIndex === 0}
279
125
  >
280
- <Tabs.Panel
281
- id="tabA"
282
- renderTitle="Tab A"
283
- isSelected={selectedIndex === 0}
284
- >
285
- {lorem.sentence()}
286
- </Tabs.Panel>
287
- <Tabs.Panel
288
- id="tabB"
289
- renderTitle="Tab B"
290
- isSelected={selectedIndex === 1}
291
- >
292
- {lorem.sentence()}
293
- </Tabs.Panel>
294
- <Tabs.Panel
295
- id="tabC"
296
- renderTitle="Tab C"
297
- isSelected={selectedIndex === 2}
298
- >
299
- {lorem.sentence()}
300
- </Tabs.Panel>
301
- <Tabs.Panel
302
- id="tabD"
303
- renderTitle="Tab D"
304
- isSelected={selectedIndex === 3}
305
- >
306
- {lorem.sentence()}
307
- </Tabs.Panel>
308
- <Tabs.Panel
309
- id="tabE"
310
- renderTitle="Tab E"
311
- isSelected={selectedIndex === 4}
312
- >
313
- {lorem.sentence()}
314
- </Tabs.Panel>
315
- <Tabs.Panel
316
- id="tabF"
317
- renderTitle="Tab F"
318
- isSelected={selectedIndex === 5}
319
- >
320
- {lorem.sentence()}
321
- </Tabs.Panel>
322
- <Tabs.Panel
323
- id="tabG"
324
- renderTitle="Tab G"
325
- isSelected={selectedIndex === 6}
326
- >
327
- {lorem.sentence()}
328
- </Tabs.Panel>
329
- </Tabs>
330
- )
331
- }
126
+ {lorem.sentence()}
127
+ </Tabs.Panel>
128
+ <Tabs.Panel
129
+ id="tabB"
130
+ renderTitle="Tab B"
131
+ isSelected={selectedIndex === 1}
132
+ >
133
+ {lorem.sentence()}
134
+ </Tabs.Panel>
135
+ <Tabs.Panel
136
+ id="tabC"
137
+ renderTitle="Tab C"
138
+ isSelected={selectedIndex === 2}
139
+ >
140
+ {lorem.sentence()}
141
+ </Tabs.Panel>
142
+ <Tabs.Panel
143
+ id="tabD"
144
+ renderTitle="Tab D"
145
+ isSelected={selectedIndex === 3}
146
+ >
147
+ {lorem.sentence()}
148
+ </Tabs.Panel>
149
+ <Tabs.Panel
150
+ id="tabE"
151
+ renderTitle="Tab E"
152
+ isSelected={selectedIndex === 4}
153
+ >
154
+ {lorem.sentence()}
155
+ </Tabs.Panel>
156
+ <Tabs.Panel
157
+ id="tabF"
158
+ renderTitle="Tab F"
159
+ isSelected={selectedIndex === 5}
160
+ >
161
+ {lorem.sentence()}
162
+ </Tabs.Panel>
163
+ <Tabs.Panel
164
+ id="tabG"
165
+ renderTitle="Tab G"
166
+ isSelected={selectedIndex === 6}
167
+ >
168
+ {lorem.sentence()}
169
+ </Tabs.Panel>
170
+ </Tabs>
171
+ )
172
+ }
332
173
 
333
- render(<Example />)
334
- ```
174
+ render(<Example />)
175
+ ```
335
176
 
336
177
  ### Controlling the size and the spacing
337
178
 
@@ -341,249 +182,65 @@ Set the height of the Tabs component with the `fixHeight` property (set to '100%
341
182
 
342
183
  Finally, switch the text alignment of the panel content with `textAlign`.
343
184
 
344
- - ```js
345
- class Example extends React.Component {
346
- constructor(props) {
347
- super(props)
348
- this.state = {
349
- selectedIndex: 0,
350
- heightOption: 'fixHeight: 100%'
351
- }
352
-
353
- this.heightOptions = {
354
- ['fixHeight: 100%']: { fixHeight: '100%' },
355
- ['fixHeight: 15rem']: { fixHeight: '15rem' },
356
- ['minHeight: 17rem']: { minHeight: '17rem' },
357
- ['maxHeight: 10rem']: { maxHeight: '10rem' }
358
- }
359
- }
360
-
361
- handleTabChange = (event, { index }) => {
362
- this.setState({
363
- selectedIndex: index
364
- })
365
- }
366
-
367
- handleHeightOptionSelect = (e, heightOption) => {
368
- this.setState({ heightOption })
369
- }
370
-
371
- render() {
372
- const { selectedIndex, heightOption } = this.state
373
- const { heightOptions } = this
374
-
375
- const containerProps = {
376
- as: 'div',
377
- ...(heightOption.includes('fixHeight') && {
378
- height: '22rem',
379
- withVisualDebug: true
380
- })
381
- }
382
-
383
- return (
384
- <>
385
- <View display="block" margin="none none medium">
386
- <RadioInputGroup
387
- name="tabsHeightOptions"
388
- defaultValue="fixHeight: 100%"
389
- description={
390
- <ScreenReaderContent>Tabs height selector</ScreenReaderContent>
391
- }
392
- variant="toggle"
393
- onChange={this.handleHeightOptionSelect}
394
- >
395
- {Object.keys(heightOptions).map((heightOption) => (
396
- <RadioInput
397
- key={heightOption}
398
- label={heightOption}
399
- value={heightOption}
400
- />
401
- ))}
402
- </RadioInputGroup>
403
- </View>
404
-
405
- <View {...containerProps}>
406
- <Tabs
407
- margin="large auto"
408
- padding="medium"
409
- onRequestTabChange={this.handleTabChange}
410
- {...heightOptions[heightOption]}
411
- >
412
- <Tabs.Panel
413
- id="tabA"
414
- renderTitle="Tab A"
415
- textAlign="center"
416
- padding="large"
417
- iSelected={selectedIndex === 0}
418
- >
419
- <Button>Focus Me</Button>
420
- </Tabs.Panel>
421
- <Tabs.Panel id="tabB" renderTitle="Disabled Tab" isDisabled>
422
- {lorem.paragraphs()}
423
- </Tabs.Panel>
424
- <Tabs.Panel
425
- id="tabC"
426
- renderTitle="Tab C"
427
- isSelected={selectedIndex === 2}
428
- >
429
- {lorem.paragraphs()}
430
- </Tabs.Panel>
431
- <Tabs.Panel
432
- id="tabD"
433
- renderTitle="Tab D"
434
- isSelected={selectedIndex === 3}
435
- >
436
- {lorem.paragraphs()}
437
- </Tabs.Panel>
438
- </Tabs>
439
- </View>
440
- </>
441
- )
442
- }
185
+ ```js
186
+ ---
187
+ type: example
188
+ ---
189
+ const Example = () => {
190
+ const [selectedIndex, setSelectedIndex] = useState(0)
191
+ const [heightOption, setHeightOption] = useState('fixHeight: 100%')
192
+
193
+ const heightOptions = {
194
+ ['fixHeight: 100%']: { fixHeight: '100%' },
195
+ ['fixHeight: 15rem']: { fixHeight: '15rem' },
196
+ ['minHeight: 17rem']: { minHeight: '17rem' },
197
+ ['maxHeight: 10rem']: { maxHeight: '10rem' }
443
198
  }
444
199
 
445
- render(<Example />)
446
- ```
447
-
448
- - ```js
449
- const Example = () => {
450
- const [selectedIndex, setSelectedIndex] = useState(0)
451
- const [heightOption, setHeightOption] = useState('fixHeight: 100%')
452
-
453
- const heightOptions = {
454
- ['fixHeight: 100%']: { fixHeight: '100%' },
455
- ['fixHeight: 15rem']: { fixHeight: '15rem' },
456
- ['minHeight: 17rem']: { minHeight: '17rem' },
457
- ['maxHeight: 10rem']: { maxHeight: '10rem' }
458
- }
459
-
460
- const handleTabChange = (event, { index }) => {
461
- setSelectedIndex(index)
462
- }
463
-
464
- const handleHeightOptionSelect = (e, heightOption) => {
465
- setHeightOption(heightOption)
466
- }
467
-
468
- const containerProps = {
469
- as: 'div',
470
- ...(heightOption.includes('fixHeight') && {
471
- height: '22rem',
472
- withVisualDebug: true
473
- })
474
- }
475
-
476
- return (
477
- <>
478
- <View display="block" margin="none none medium">
479
- <RadioInputGroup
480
- name="tabsHeightOptions"
481
- defaultValue="fixHeight: 100%"
482
- description={
483
- <ScreenReaderContent>Tabs height selector</ScreenReaderContent>
484
- }
485
- variant="toggle"
486
- onChange={handleHeightOptionSelect}
487
- >
488
- {Object.keys(heightOptions).map((heightOption) => (
489
- <RadioInput
490
- key={heightOption}
491
- label={heightOption}
492
- value={heightOption}
493
- />
494
- ))}
495
- </RadioInputGroup>
496
- </View>
497
-
498
- <View {...containerProps}>
499
- <Tabs
500
- margin="large auto"
501
- padding="medium"
502
- onRequestTabChange={handleTabChange}
503
- {...heightOptions[heightOption]}
504
- >
505
- <Tabs.Panel
506
- id="tabA"
507
- renderTitle="Tab A"
508
- textAlign="center"
509
- padding="large"
510
- isSelected={selectedIndex === 0}
511
- >
512
- <Button>Focus Me</Button>
513
- </Tabs.Panel>
514
- <Tabs.Panel id="tabB" renderTitle="Disabled Tab" isDisabled>
515
- {lorem.paragraphs()}
516
- </Tabs.Panel>
517
- <Tabs.Panel
518
- id="tabC"
519
- renderTitle="Tab C"
520
- isSelected={selectedIndex === 2}
521
- >
522
- {lorem.paragraphs()}
523
- </Tabs.Panel>
524
- <Tabs.Panel
525
- id="tabD"
526
- renderTitle="Tab D"
527
- isSelected={selectedIndex === 3}
528
- >
529
- {lorem.paragraphs()}
530
- </Tabs.Panel>
531
- </Tabs>
532
- </View>
533
- </>
534
- )
200
+ const handleTabChange = (event, { index }) => {
201
+ setSelectedIndex(index)
535
202
  }
536
203
 
537
- render(<Example />)
538
- ```
539
-
540
- ### Support for dynamic content with active panel
541
-
542
- Marking one of the `<Tabs.Panel>` as `active` will render that panel's content in all the panels. This is useful for dynamic content rendering: the panel area can be used as a container, what routing libraries, such as React Router, can use to render their children elements into.
204
+ const handleHeightOptionSelect = (e, heightOption) => {
205
+ setHeightOption(heightOption)
206
+ }
543
207
 
544
- - ```js
545
- class Outlet extends React.Component {
546
- state = {
547
- show: false
548
- }
549
-
550
- componentDidMount() {
551
- setTimeout(() => this.setState({ show: true }), 2000)
552
- }
553
-
554
- render() {
555
- return (
556
- <div>
557
- <Heading level="h1" as="h1" margin="0 0 x-small">
558
- {this.state.show ? 'Hello Developer' : 'Simulating network call...'}
559
- </Heading>
560
- {this.state.show ? (
561
- lorem.paragraphs()
562
- ) : (
563
- <Spinner renderTitle="Loading" size="medium" />
564
- )}
565
- </div>
566
- )
567
- }
208
+ const containerProps = {
209
+ as: 'div',
210
+ ...(heightOption.includes('fixHeight') && {
211
+ height: '22rem',
212
+ withVisualDebug: true
213
+ })
568
214
  }
569
215
 
570
- class Example extends React.Component {
571
- state = {
572
- selectedIndex: 0
573
- }
574
- handleTabChange = (event, { index }) => {
575
- this.setState({
576
- selectedIndex: index
577
- })
578
- }
579
-
580
- render() {
581
- const { selectedIndex } = this.state
582
- return (
216
+ return (
217
+ <>
218
+ <View display="block" margin="none none medium">
219
+ <RadioInputGroup
220
+ name="tabsHeightOptions"
221
+ defaultValue="fixHeight: 100%"
222
+ description={
223
+ <ScreenReaderContent>Tabs height selector</ScreenReaderContent>
224
+ }
225
+ variant="toggle"
226
+ onChange={handleHeightOptionSelect}
227
+ >
228
+ {Object.keys(heightOptions).map((heightOption) => (
229
+ <RadioInput
230
+ key={heightOption}
231
+ label={heightOption}
232
+ value={heightOption}
233
+ />
234
+ ))}
235
+ </RadioInputGroup>
236
+ </View>
237
+
238
+ <View {...containerProps}>
583
239
  <Tabs
584
240
  margin="large auto"
585
241
  padding="medium"
586
- onRequestTabChange={this.handleTabChange}
242
+ onRequestTabChange={handleTabChange}
243
+ {...heightOptions[heightOption]}
587
244
  >
588
245
  <Tabs.Panel
589
246
  id="tabA"
@@ -591,245 +248,182 @@ Marking one of the `<Tabs.Panel>` as `active` will render that panel's content i
591
248
  textAlign="center"
592
249
  padding="large"
593
250
  isSelected={selectedIndex === 0}
594
- active
595
251
  >
596
- <Outlet />
252
+ <Button>Focus Me</Button>
253
+ </Tabs.Panel>
254
+ <Tabs.Panel id="tabB" renderTitle="Disabled Tab" isDisabled>
255
+ {lorem.paragraphs()}
597
256
  </Tabs.Panel>
598
- <Tabs.Panel id="tabB" renderTitle="Disabled Tab" isDisabled />
599
257
  <Tabs.Panel
600
258
  id="tabC"
601
259
  renderTitle="Tab C"
602
260
  isSelected={selectedIndex === 2}
603
- />
261
+ >
262
+ {lorem.paragraphs()}
263
+ </Tabs.Panel>
604
264
  <Tabs.Panel
605
265
  id="tabD"
606
266
  renderTitle="Tab D"
607
267
  isSelected={selectedIndex === 3}
608
- />
268
+ >
269
+ {lorem.paragraphs()}
270
+ </Tabs.Panel>
609
271
  </Tabs>
610
- )
611
- }
612
- }
272
+ </View>
273
+ </>
274
+ )
275
+ }
613
276
 
614
- render(<Example />)
615
- ```
616
-
617
- - ```js
618
- const Outlet = () => {
619
- const [show, setShow] = useState(false)
620
-
621
- useEffect(() => {
622
- const timer = setTimeout(() => setShow(true), 2000)
623
- return () => clearTimeout(timer)
624
- }, [])
625
-
626
- return (
627
- <div>
628
- <Heading level="h1" as="h1" margin="0 0 x-small">
629
- {show ? 'Hello Developer' : 'Simulating network call...'}
630
- </Heading>
631
- {show ? (
632
- lorem.paragraphs()
633
- ) : (
634
- <Spinner renderTitle="Loading" size="medium" />
635
- )}
636
- </div>
637
- )
638
- }
277
+ render(<Example />)
278
+ ```
639
279
 
640
- const Example = () => {
641
- const [selectedIndex, setSelectedIndex] = useState(0)
280
+ ### Support for dynamic content with active panel
642
281
 
643
- const handleTabChange = (event, { index }) => {
644
- setSelectedIndex(index)
645
- }
282
+ Marking one of the `<Tabs.Panel>` as `active` will render that panel's content in all the panels. This is useful for dynamic content rendering: the panel area can be used as a container, what routing libraries, such as React Router, can use to render their children elements into.
646
283
 
647
- return (
648
- <Tabs
649
- margin="large auto"
650
- padding="medium"
651
- onRequestTabChange={handleTabChange}
652
- >
653
- <Tabs.Panel
654
- id="tabA"
655
- renderTitle="Tab A"
656
- textAlign="center"
657
- padding="large"
658
- isSelected={selectedIndex === 0}
659
- active
660
- >
661
- <Outlet />
662
- </Tabs.Panel>
663
- <Tabs.Panel id="tabB" renderTitle="Disabled Tab" isDisabled />
664
- <Tabs.Panel
665
- id="tabC"
666
- renderTitle="Tab C"
667
- isSelected={selectedIndex === 2}
668
- />
669
- <Tabs.Panel
670
- id="tabD"
671
- renderTitle="Tab D"
672
- isSelected={selectedIndex === 3}
673
- />
674
- </Tabs>
675
- )
284
+ ```js
285
+ ---
286
+ type: example
287
+ ---
288
+ const Outlet = () => {
289
+ const [show, setShow] = useState(false)
290
+
291
+ useEffect(() => {
292
+ const timer = setTimeout(() => setShow(true), 2000)
293
+ return () => clearTimeout(timer)
294
+ }, [])
295
+
296
+ return (
297
+ <div>
298
+ <Heading level="h1" as="h1" margin="0 0 x-small">
299
+ {show ? 'Hello Developer' : 'Simulating network call...'}
300
+ </Heading>
301
+ {show ? (
302
+ lorem.paragraphs()
303
+ ) : (
304
+ <Spinner renderTitle="Loading" size="medium" />
305
+ )}
306
+ </div>
307
+ )
308
+ }
309
+
310
+ const Example = () => {
311
+ const [selectedIndex, setSelectedIndex] = useState(0)
312
+
313
+ const handleTabChange = (event, { index }) => {
314
+ setSelectedIndex(index)
676
315
  }
677
316
 
678
- render(<Example />)
679
- ```
317
+ return (
318
+ <Tabs
319
+ margin="large auto"
320
+ padding="medium"
321
+ onRequestTabChange={handleTabChange}
322
+ >
323
+ <Tabs.Panel
324
+ id="tabA"
325
+ renderTitle="Tab A"
326
+ textAlign="center"
327
+ padding="large"
328
+ isSelected={selectedIndex === 0}
329
+ active
330
+ >
331
+ <Outlet />
332
+ </Tabs.Panel>
333
+ <Tabs.Panel id="tabB" renderTitle="Disabled Tab" isDisabled />
334
+ <Tabs.Panel
335
+ id="tabC"
336
+ renderTitle="Tab C"
337
+ isSelected={selectedIndex === 2}
338
+ />
339
+ <Tabs.Panel
340
+ id="tabD"
341
+ renderTitle="Tab D"
342
+ isSelected={selectedIndex === 3}
343
+ />
344
+ </Tabs>
345
+ )
346
+ }
347
+
348
+ render(<Example />)
349
+ ```
680
350
 
681
351
  ### Persisting the selected tab
682
352
 
683
353
  If you need to persist the rendered content of the tabpanels between tabbing, you can set the `unmountOnExit` prop to `false` on the `<Tabs.Panel>` component. It works case by case, so you can set it to `false` only on the tabpanels you want to persist.
684
354
 
685
- - ```js
686
- class Counter extends React.Component {
687
- state = {
688
- counter: 0
689
- }
690
- handleIncrement = () => {
691
- this.setState({
692
- counter: this.state.counter + 1
693
- })
694
- }
695
-
696
- render() {
697
- return (
698
- <div>
699
- <Button onClick={this.handleIncrement}>Increment</Button>
700
- <hr />
701
- <Text>{this.state.counter}</Text>
702
- </div>
703
- )
704
- }
705
- }
706
- class Example extends React.Component {
707
- state = {
708
- selectedIndex: 0
709
- }
710
- handleTabChange = (event, { index }) => {
711
- this.setState({
712
- selectedIndex: index
713
- })
714
- }
715
- render() {
716
- const { selectedIndex } = this.state
717
- return (
718
- <Tabs
719
- margin="large auto"
720
- padding="medium"
721
- onRequestTabChange={this.handleTabChange}
722
- >
723
- <Tabs.Panel
724
- id="tabA"
725
- renderTitle="I will persist"
726
- textAlign="center"
727
- padding="large"
728
- isSelected={selectedIndex === 0}
729
- unmountOnExit={false}
730
- >
731
- <Counter />
732
- </Tabs.Panel>
733
- <Tabs.Panel
734
- id="tabB"
735
- renderTitle="I will unmount"
736
- isSelected={selectedIndex === 1}
737
- textAlign="center"
738
- padding="large"
739
- >
740
- <Counter />
741
- </Tabs.Panel>
742
- <Tabs.Panel
743
- id="tabC"
744
- renderTitle="Tab C"
745
- isSelected={selectedIndex === 2}
746
- >
747
- Tab C
748
- </Tabs.Panel>
749
- <Tabs.Panel
750
- id="tabD"
751
- renderTitle="Tab D"
752
- isSelected={selectedIndex === 3}
753
- >
754
- Tab D
755
- </Tabs.Panel>
756
- </Tabs>
757
- )
758
- }
759
- }
355
+ ```js
356
+ ---
357
+ type: example
358
+ ---
359
+ const Counter = () => {
360
+ const [counter, setCounter] = useState(0)
760
361
 
761
- render(<Example />)
762
- ```
362
+ const handleIncrement = () => {
363
+ setCounter(counter + 1)
364
+ }
763
365
 
764
- - ```js
765
- const Counter = () => {
766
- const [counter, setCounter] = useState(0)
366
+ return (
367
+ <div>
368
+ <Button onClick={handleIncrement}>Increment</Button>
369
+ <hr />
370
+ <Text>{counter}</Text>
371
+ </div>
372
+ )
373
+ }
767
374
 
768
- const handleIncrement = () => {
769
- setCounter(counter + 1)
770
- }
375
+ const Example = () => {
376
+ const [selectedIndex, setSelectedIndex] = useState(0)
771
377
 
772
- return (
773
- <div>
774
- <Button onClick={handleIncrement}>Increment</Button>
775
- <hr />
776
- <Text>{counter}</Text>
777
- </div>
778
- )
378
+ const handleTabChange = (event, { index }) => {
379
+ setSelectedIndex(index)
779
380
  }
780
381
 
781
- const Example = () => {
782
- const [selectedIndex, setSelectedIndex] = useState(0)
783
-
784
- const handleTabChange = (event, { index }) => {
785
- setSelectedIndex(index)
786
- }
787
-
788
- return (
789
- <Tabs
790
- margin="large auto"
791
- padding="medium"
792
- onRequestTabChange={handleTabChange}
382
+ return (
383
+ <Tabs
384
+ margin="large auto"
385
+ padding="medium"
386
+ onRequestTabChange={handleTabChange}
387
+ >
388
+ <Tabs.Panel
389
+ id="tabA"
390
+ renderTitle="I will persist"
391
+ textAlign="center"
392
+ padding="large"
393
+ isSelected={selectedIndex === 0}
394
+ unmountOnExit={false}
793
395
  >
794
- <Tabs.Panel
795
- id="tabA"
796
- renderTitle="I will persist"
797
- textAlign="center"
798
- padding="large"
799
- isSelected={selectedIndex === 0}
800
- unmountOnExit={false}
801
- >
802
- <Counter />
803
- </Tabs.Panel>
804
- <Tabs.Panel
805
- id="tabB"
806
- renderTitle="I will unmount"
807
- isSelected={selectedIndex === 1}
808
- textAlign="center"
809
- padding="large"
810
- >
811
- <Counter />
812
- </Tabs.Panel>
813
- <Tabs.Panel
814
- id="tabC"
815
- renderTitle="Tab C"
816
- isSelected={selectedIndex === 2}
817
- >
818
- Tab C
819
- </Tabs.Panel>
820
- <Tabs.Panel
821
- id="tabD"
822
- renderTitle="Tab D"
823
- isSelected={selectedIndex === 3}
824
- >
825
- Tab D
826
- </Tabs.Panel>
827
- </Tabs>
828
- )
829
- }
396
+ <Counter />
397
+ </Tabs.Panel>
398
+ <Tabs.Panel
399
+ id="tabB"
400
+ renderTitle="I will unmount"
401
+ isSelected={selectedIndex === 1}
402
+ textAlign="center"
403
+ padding="large"
404
+ >
405
+ <Counter />
406
+ </Tabs.Panel>
407
+ <Tabs.Panel
408
+ id="tabC"
409
+ renderTitle="Tab C"
410
+ isSelected={selectedIndex === 2}
411
+ >
412
+ Tab C
413
+ </Tabs.Panel>
414
+ <Tabs.Panel
415
+ id="tabD"
416
+ renderTitle="Tab D"
417
+ isSelected={selectedIndex === 3}
418
+ >
419
+ Tab D
420
+ </Tabs.Panel>
421
+ </Tabs>
422
+ )
423
+ }
830
424
 
831
- render(<Example />)
832
- ```
425
+ render(<Example />)
426
+ ```
833
427
 
834
428
  ### Guidelines
835
429