x
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
<div class="tw:p-6 tw:max-w-7xl tw:mx-auto tw:space-y-8"> <!-- Introductory callout --> <div class="tw-callout"> <p class="tw:mb-1 tw:text-sm tw:font-mono"> <strong>DRAWER:</strong> Side panel overlay for sub-level content<br> <strong>CLASSES:</strong> .drawer | .drawer-header | .drawer-title | .drawer-body | .drawer-footer | .drawer-backdrop<br> <strong>VARIANTS:</strong> Default (right) | .drawer-start (left) | .drawer-sm | .drawer-lg | .drawer-wide<br> <strong>COMPOSES:</strong> Button (.btn, .btn-icon, .btn-tertiary, .btn-primary, .btn-secondary) | Form controls </p> <p class="tw:mb-0 tw:text-sm"> Drawer slides in from the edge of the screen to display secondary content such as filters, settings, or forms. It overlays the page content and can optionally include a backdrop. Uses existing button components for the close icon and footer actions. </p> </div> <!-- ============================================ Section 1: Default Drawer (Right Side) ============================================ --> <div class="tw:border-t tw:pt-6"> <h2 class="tw-h4 tw:mb-4">Default Drawer (Right Side)</h2> <div class="tw-callout tw:mb-4"> <p class="tw:mb-0 tw:text-sm"> <strong>Default:</strong> Slides in from the right edge. 480px wide with header, scrollable body, and footer. The close button reuses <code>.tw-btn .tw-btn-icon .tw-btn-tertiary</code>. Footer buttons reuse <code>.tw-btn .tw-btn-secondary</code> and <code>.tw-btn .tw-btn-primary</code>. </p> </div> <div data-controller="drawer"> <button class="tw-btn tw-btn-primary" type="button" data-action="click->drawer#open"> Open Default Drawer </button> <div class="tw-drawer-backdrop" data-drawer-target="backdrop" data-action="click->drawer#close" aria-hidden="true"></div> <div class="tw-drawer" data-drawer-target="panel" role="dialog" aria-modal="true" aria-labelledby="drawer-default-title" aria-hidden="true"> <div class="tw-drawer-header"> <h2 class="tw-drawer-title" id="drawer-default-title">Edit Filter</h2> <button class="tw-btn tw-btn-icon tw-btn-tertiary" type="button" data-action="click->drawer#close" aria-label="Close drawer"> <i class="fa-solid fa-xmark"></i> </button> </div> <div class="tw-drawer-body"> <div class="tw:mb-4"> <label class="tw-form-label" for="drawer-filter-name">Filter name</label> <input type="text" class="tw-form-control" id="drawer-filter-name" value="Outstanding students"> </div> <div class="tw:mb-4"> <label class="tw-form-label" for="drawer-filter-status">Application status</label> <select class="tw-form-select" id="drawer-filter-status"> <option>Any of</option> <option>Is</option> <option>Is not</option> </select> </div> <div class="tw:mb-4"> <label class="tw-form-label" for="drawer-filter-year">Year group</label> <select class="tw-form-select" id="drawer-filter-year"> <option>Year 7</option> <option>Year 8</option> <option>Year 9</option> </select> </div> </div> <div class="tw-drawer-footer"> <button class="tw-btn tw-btn-secondary" type="button" data-action="click->drawer#close">Cancel</button> <button class="tw-btn tw-btn-primary" type="button">Apply</button> </div> </div> </div> <div class="tw:mt-4 tw:text-sm tw:text-neutral-600"> <code><div class="tw-drawer"><div class="tw-drawer-header">...</div><div class="tw-drawer-body">...</div><div class="tw-drawer-footer">...</div></div></code> </div> </div> <!-- ============================================ Section 2: Left Side Drawer ============================================ --> <div class="tw:border-t tw:pt-6"> <h2 class="tw-h4 tw:mb-4">Left Side Drawer</h2> <div class="tw-callout tw:mb-4"> <p class="tw:mb-0 tw:text-sm"> <strong>.tw-drawer-start:</strong> Slides in from the left edge instead of the right. Shadow is mirrored to the right side. </p> </div> <div data-controller="drawer"> <button class="tw-btn tw-btn-primary" type="button" data-action="click->drawer#open"> Open Left Drawer </button> <div class="tw-drawer-backdrop" data-drawer-target="backdrop" data-action="click->drawer#close" aria-hidden="true"></div> <div class="tw-drawer tw-drawer-start" data-drawer-target="panel" role="dialog" aria-modal="true" aria-labelledby="drawer-left-title" aria-hidden="true"> <div class="tw-drawer-header"> <h2 class="tw-drawer-title" id="drawer-left-title">Navigation</h2> <button class="tw-btn tw-btn-icon tw-btn-tertiary" type="button" data-action="click->drawer#close" aria-label="Close drawer"> <i class="fa-solid fa-xmark"></i> </button> </div> <div class="tw-drawer-body"> <p class="tw:text-neutral-600">Left-side drawer content. Useful for navigation panels or supplementary controls.</p> </div> <div class="tw-drawer-footer"> <button class="tw-btn tw-btn-secondary" type="button" data-action="click->drawer#close">Close</button> </div> </div> </div> <div class="tw:mt-4 tw:text-sm tw:text-neutral-600"> <code><div class="tw-drawer tw-drawer-start">...</div></code> </div> </div> <!-- ============================================ Section 3: Size Variants ============================================ --> <div class="tw:border-t tw:pt-6"> <h2 class="tw-h4 tw:mb-4">Size Variants</h2> <div class="tw-callout tw:mb-4"> <p class="tw:mb-0 tw:text-sm"> <strong>Sizes:</strong> <code>.tw-drawer-sm</code> (360px) | default (480px) | <code>.tw-drawer-lg</code> (600px) | <code>.tw-drawer-wide</code> (720px). All sizes become full-width on mobile screens (< 640px). </p> </div> <div class="tw:flex tw:flex-wrap tw:gap-3"> <!-- Small --> <div data-controller="drawer"> <button class="tw-btn tw-btn-outline-primary" type="button" data-action="click->drawer#open"> Small (360px) </button> <div class="tw-drawer-backdrop" data-drawer-target="backdrop" data-action="click->drawer#close" aria-hidden="true"></div> <div class="tw-drawer tw-drawer-sm" data-drawer-target="panel" role="dialog" aria-modal="true" aria-labelledby="drawer-sm-title" aria-hidden="true"> <div class="tw-drawer-header"> <h2 class="tw-drawer-title" id="drawer-sm-title">Small Drawer</h2> <button class="tw-btn tw-btn-icon tw-btn-tertiary" type="button" data-action="click->drawer#close" aria-label="Close drawer"> <i class="fa-solid fa-xmark"></i> </button> </div> <div class="tw-drawer-body"> <p class="tw:text-neutral-600">This drawer is 360px wide. Suitable for compact content like quick settings or filters.</p> </div> <div class="tw-drawer-footer"> <button class="tw-btn tw-btn-secondary" type="button" data-action="click->drawer#close">Cancel</button> <button class="tw-btn tw-btn-primary" type="button">Apply</button> </div> </div> </div> <!-- Large --> <div data-controller="drawer"> <button class="tw-btn tw-btn-outline-primary" type="button" data-action="click->drawer#open"> Large (600px) </button> <div class="tw-drawer-backdrop" data-drawer-target="backdrop" data-action="click->drawer#close" aria-hidden="true"></div> <div class="tw-drawer tw-drawer-lg" data-drawer-target="panel" role="dialog" aria-modal="true" aria-labelledby="drawer-lg-title" aria-hidden="true"> <div class="tw-drawer-header"> <h2 class="tw-drawer-title" id="drawer-lg-title">Large Drawer</h2> <button class="tw-btn tw-btn-icon tw-btn-tertiary" type="button" data-action="click->drawer#close" aria-label="Close drawer"> <i class="fa-solid fa-xmark"></i> </button> </div> <div class="tw-drawer-body"> <p class="tw:text-neutral-600">This drawer is 600px wide. Suitable for forms with more fields or detailed content.</p> </div> <div class="tw-drawer-footer"> <button class="tw-btn tw-btn-secondary" type="button" data-action="click->drawer#close">Cancel</button> <button class="tw-btn tw-btn-primary" type="button">Apply</button> </div> </div> </div> <!-- Wide --> <div data-controller="drawer"> <button class="tw-btn tw-btn-outline-primary" type="button" data-action="click->drawer#open"> Wide (720px) </button> <div class="tw-drawer-backdrop" data-drawer-target="backdrop" data-action="click->drawer#close" aria-hidden="true"></div> <div class="tw-drawer tw-drawer-wide" data-drawer-target="panel" role="dialog" aria-modal="true" aria-labelledby="drawer-wide-title" aria-hidden="true"> <div class="tw-drawer-header"> <h2 class="tw-drawer-title" id="drawer-wide-title">Wide Drawer</h2> <button class="tw-btn tw-btn-icon tw-btn-tertiary" type="button" data-action="click->drawer#close" aria-label="Close drawer"> <i class="fa-solid fa-xmark"></i> </button> </div> <div class="tw-drawer-body"> <p class="tw:text-neutral-600">This drawer is 720px wide. Suitable for complex forms, data tables, or split-pane layouts.</p> </div> <div class="tw-drawer-footer"> <button class="tw-btn tw-btn-secondary" type="button" data-action="click->drawer#close">Cancel</button> <button class="tw-btn tw-btn-primary" type="button">Apply</button> </div> </div> </div> </div> <div class="tw:mt-4 tw:text-sm tw:text-neutral-600"> <code><div class="tw-drawer tw-drawer-sm"></code> | <code><div class="tw-drawer tw-drawer-lg"></code> | <code><div class="tw-drawer tw-drawer-wide"></code> </div> </div> <!-- ============================================ Section 4: Without Footer ============================================ --> <div class="tw:border-t tw:pt-6"> <h2 class="tw-h4 tw:mb-4">Without Footer</h2> <div class="tw-callout tw:mb-4"> <p class="tw:mb-0 tw:text-sm"> <strong>No footer:</strong> Omit the <code>.tw-drawer-footer</code> section for informational or read-only drawers. The body expands to fill the remaining space. </p> </div> <div data-controller="drawer"> <button class="tw-btn tw-btn-primary" type="button" data-action="click->drawer#open"> Open Info Drawer </button> <div class="tw-drawer-backdrop" data-drawer-target="backdrop" data-action="click->drawer#close" aria-hidden="true"></div> <div class="tw-drawer" data-drawer-target="panel" role="dialog" aria-modal="true" aria-labelledby="drawer-info-title" aria-hidden="true"> <div class="tw-drawer-header"> <h2 class="tw-drawer-title" id="drawer-info-title">Application Details</h2> <button class="tw-btn tw-btn-icon tw-btn-tertiary" type="button" data-action="click->drawer#close" aria-label="Close drawer"> <i class="fa-solid fa-xmark"></i> </button> </div> <div class="tw-drawer-body"> <h3 class="tw-h5 tw:mb-3">Applicant Information</h3> <div class="tw:mb-3"> <span class="tw-small tw:text-neutral-500">Full Name</span> <p class="tw:mb-0">Sarah Johnson</p> </div> <div class="tw:mb-3"> <span class="tw-small tw:text-neutral-500">Date of Birth</span> <p class="tw:mb-0">15 March 2014</p> </div> <div class="tw:mb-3"> <span class="tw-small tw:text-neutral-500">Current School</span> <p class="tw:mb-0">Oakwood Primary School</p> </div> <div class="tw:mb-3"> <span class="tw-small tw:text-neutral-500">Year Group Applied</span> <p class="tw:mb-0">Year 7 Entry 2026</p> </div> <div class="tw:mb-3"> <span class="tw-small tw:text-neutral-500">Status</span> <p class="tw:mb-0"><span class="tw-badge tw-badge-success-subtle">Completed</span></p> </div> </div> </div> </div> <div class="tw:mt-4 tw:text-sm tw:text-neutral-600"> <code><div class="tw-drawer"><div class="tw-drawer-header">...</div><div class="tw-drawer-body">...</div></div></code> </div> </div> <!-- ============================================ Section 5: Scrollable Content ============================================ --> <div class="tw:border-t tw:pt-6"> <h2 class="tw-h4 tw:mb-4">Scrollable Content</h2> <div class="tw-callout tw:mb-4"> <p class="tw:mb-0 tw:text-sm"> <strong>Overflow:</strong> When body content exceeds the available height, the <code>.tw-drawer-body</code> scrolls independently while the header and footer remain fixed. </p> </div> <div data-controller="drawer"> <button class="tw-btn tw-btn-primary" type="button" data-action="click->drawer#open"> Open Scrollable Drawer </button> <div class="tw-drawer-backdrop" data-drawer-target="backdrop" data-action="click->drawer#close" aria-hidden="true"></div> <div class="tw-drawer" data-drawer-target="panel" role="dialog" aria-modal="true" aria-labelledby="drawer-scroll-title" aria-hidden="true"> <div class="tw-drawer-header"> <h2 class="tw-drawer-title" id="drawer-scroll-title">Application Form</h2> <button class="tw-btn tw-btn-icon tw-btn-tertiary" type="button" data-action="click->drawer#close" aria-label="Close drawer"> <i class="fa-solid fa-xmark"></i> </button> </div> <div class="tw-drawer-body"> <div class="tw:mb-4"> <label class="tw-form-label" for="drawer-scroll-first">First name</label> <input type="text" class="tw-form-control" id="drawer-scroll-first" value="Sarah"> </div> <div class="tw:mb-4"> <label class="tw-form-label" for="drawer-scroll-last">Last name</label> <input type="text" class="tw-form-control" id="drawer-scroll-last" value="Johnson"> </div> <div class="tw:mb-4"> <label class="tw-form-label" for="drawer-scroll-email">Email address</label> <input type="email" class="tw-form-control" id="drawer-scroll-email" value="sarah.johnson@email.com"> </div> <div class="tw:mb-4"> <label class="tw-form-label" for="drawer-scroll-phone">Phone number</label> <input type="tel" class="tw-form-control" id="drawer-scroll-phone" value="+44 7700 900123"> </div> <div class="tw:mb-4"> <label class="tw-form-label" for="drawer-scroll-address1">Address line 1</label> <input type="text" class="tw-form-control" id="drawer-scroll-address1" value="42 Elm Street"> </div> <div class="tw:mb-4"> <label class="tw-form-label" for="drawer-scroll-address2">Address line 2</label> <input type="text" class="tw-form-control" id="drawer-scroll-address2" value="Kensington"> </div> <div class="tw:mb-4"> <label class="tw-form-label" for="drawer-scroll-city">City</label> <input type="text" class="tw-form-control" id="drawer-scroll-city" value="London"> </div> <div class="tw:mb-4"> <label class="tw-form-label" for="drawer-scroll-postcode">Postcode</label> <input type="text" class="tw-form-control" id="drawer-scroll-postcode" value="W8 5QR"> </div> <div class="tw:mb-4"> <label class="tw-form-label" for="drawer-scroll-country">Country</label> <select class="tw-form-select" id="drawer-scroll-country"> <option selected>United Kingdom</option> <option>United States</option> <option>France</option> <option>Germany</option> </select> </div> <div class="tw:mb-4"> <label class="tw-form-label" for="drawer-scroll-notes">Additional notes</label> <textarea class="tw-form-control" id="drawer-scroll-notes" rows="4">Sibling already enrolled in Year 9. Please consider for bursary programme.</textarea> </div> </div> <div class="tw-drawer-footer"> <button class="tw-btn tw-btn-secondary" type="button" data-action="click->drawer#close">Cancel</button> <button class="tw-btn tw-btn-primary" type="button">Save Changes</button> </div> </div> </div> </div> <!-- ============================================ Section 6: Without Backdrop ============================================ --> <div class="tw:border-t tw:pt-6"> <h2 class="tw-h4 tw:mb-4">Without Backdrop</h2> <div class="tw-callout tw:mb-4"> <p class="tw:mb-0 tw:text-sm"> <strong>No backdrop:</strong> Omit the <code>.tw-drawer-backdrop</code> element for drawers that don't need to dim the background. The drawer still supports Escape key to close. </p> </div> <div data-controller="drawer"> <button class="tw-btn tw-btn-primary" type="button" data-action="click->drawer#open"> Open Without Backdrop </button> <div class="tw-drawer" data-drawer-target="panel" role="dialog" aria-modal="true" aria-labelledby="drawer-nobg-title" aria-hidden="true"> <div class="tw-drawer-header"> <h2 class="tw-drawer-title" id="drawer-nobg-title">Quick Settings</h2> <button class="tw-btn tw-btn-icon tw-btn-tertiary" type="button" data-action="click->drawer#close" aria-label="Close drawer"> <i class="fa-solid fa-xmark"></i> </button> </div> <div class="tw-drawer-body"> <p class="tw:text-neutral-600">This drawer has no backdrop overlay. The page behind remains fully visible and interactive areas outside the drawer are not dimmed.</p> </div> <div class="tw-drawer-footer"> <button class="tw-btn tw-btn-secondary" type="button" data-action="click->drawer#close">Close</button> </div> </div> </div> <div class="tw:mt-4 tw:text-sm tw:text-neutral-600"> <code><!-- Simply omit .tw-drawer-backdrop element --></code> </div> </div> <!-- ============================================ Section 7: Keyboard Navigation ============================================ --> <div class="tw:border-t tw:pt-6"> <h2 class="tw-h4 tw:mb-4">Keyboard Navigation</h2> <div class="tw-callout tw:mb-4"> <p class="tw:mb-0 tw:text-sm"> <strong>Accessibility:</strong> The drawer traps focus while open, supports Escape to close, and returns focus to the trigger element on close. </p> </div> <table class="tw-table tw-table-sm"> <thead> <tr> <th>Key</th> <th>Action</th> </tr> </thead> <tbody> <tr> <td><code>Escape</code></td> <td>Close the drawer and return focus to trigger</td> </tr> <tr> <td><code>Tab</code></td> <td>Move focus to next focusable element (trapped within drawer)</td> </tr> <tr> <td><code>Shift + Tab</code></td> <td>Move focus to previous focusable element (trapped within drawer)</td> </tr> </tbody> </table> </div> <!-- ============================================ Section 8: Quick Reference ============================================ --> <div class="tw:border-t tw:pt-6"> <h2 class="tw-h4 tw:mb-4">Quick Reference</h2> <div class="tw-callout"> <p class="tw:mb-1 tw:text-sm tw:font-mono"> <strong>Container:</strong> .tw-drawer | .tw-drawer.tw-show | .tw-drawer-start | .tw-drawer-sm | .tw-drawer-lg | .tw-drawer-wide<br> <strong>Sections:</strong> .tw-drawer-header | .tw-drawer-title | .tw-drawer-body | .tw-drawer-footer<br> <strong>Overlay:</strong> .tw-drawer-backdrop | .tw-drawer-backdrop.tw-show<br> <strong>Close button:</strong> .tw-btn .tw-btn-icon .tw-btn-tertiary (existing component)<br> <strong>Footer buttons:</strong> .tw-btn .tw-btn-secondary | .tw-btn .tw-btn-primary (existing components)<br> <strong>Controller:</strong> data-controller="drawer" | data-action="click->drawer#open" | data-action="click->drawer#close" </p> </div> </div></div>1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
<div class="tw:p-6 tw:max-w-7xl tw:mx-auto tw:space-y-8"> <!-- Introductory callout --> <div class="tw-callout"> <p class="tw:mb-1 tw:text-sm tw:font-mono"> <strong>DRAWER:</strong> Side panel overlay for sub-level content<br> <strong>CLASSES:</strong> .drawer | .drawer-header | .drawer-title | .drawer-body | .drawer-footer | .drawer-backdrop<br> <strong>VARIANTS:</strong> Default (right) | .drawer-start (left) | .drawer-sm | .drawer-lg | .drawer-wide<br> <strong>COMPOSES:</strong> Button (.btn, .btn-icon, .btn-tertiary, .btn-primary, .btn-secondary) | Form controls </p> <p class="tw:mb-0 tw:text-sm"> Drawer slides in from the edge of the screen to display secondary content such as filters, settings, or forms. It overlays the page content and can optionally include a backdrop. Uses existing button components for the close icon and footer actions. </p> </div> <!-- ============================================ Section 1: Default Drawer (Right Side) ============================================ --> <div class="tw:border-t tw:pt-6"> <h2 class="tw-h4 tw:mb-4">Default Drawer (Right Side)</h2> <div class="tw-callout tw:mb-4"> <p class="tw:mb-0 tw:text-sm"> <strong>Default:</strong> Slides in from the right edge. 480px wide with header, scrollable body, and footer. The close button reuses <code>.tw-btn .tw-btn-icon .tw-btn-tertiary</code>. Footer buttons reuse <code>.tw-btn .tw-btn-secondary</code> and <code>.tw-btn .tw-btn-primary</code>. </p> </div> <div data-controller="drawer"> <button class="tw-btn tw-btn-primary" type="button" data-action="click->drawer#open"> Open Default Drawer </button> <div class="tw-drawer-backdrop" data-drawer-target="backdrop" data-action="click->drawer#close" aria-hidden="true"></div> <div class="tw-drawer" data-drawer-target="panel" role="dialog" aria-modal="true" aria-labelledby="drawer-default-title" aria-hidden="true"> <div class="tw-drawer-header"> <h2 class="tw-drawer-title" id="drawer-default-title">Edit Filter</h2> <button class="tw-btn tw-btn-icon tw-btn-tertiary" type="button" data-action="click->drawer#close" aria-label="Close drawer"> <i class="fa-solid fa-xmark"></i> </button> </div> <div class="tw-drawer-body"> <div class="tw:mb-4"> <label class="tw-form-label" for="drawer-filter-name">Filter name</label> <input type="text" class="tw-form-control" id="drawer-filter-name" value="Outstanding students"> </div> <div class="tw:mb-4"> <label class="tw-form-label" for="drawer-filter-status">Application status</label> <select class="tw-form-select" id="drawer-filter-status"> <option>Any of</option> <option>Is</option> <option>Is not</option> </select> </div> <div class="tw:mb-4"> <label class="tw-form-label" for="drawer-filter-year">Year group</label> <select class="tw-form-select" id="drawer-filter-year"> <option>Year 7</option> <option>Year 8</option> <option>Year 9</option> </select> </div> </div> <div class="tw-drawer-footer"> <button class="tw-btn tw-btn-secondary" type="button" data-action="click->drawer#close">Cancel</button> <button class="tw-btn tw-btn-primary" type="button">Apply</button> </div> </div> </div> <div class="tw:mt-4 tw:text-sm tw:text-neutral-600"> <code><div class="tw-drawer"><div class="tw-drawer-header">...</div><div class="tw-drawer-body">...</div><div class="tw-drawer-footer">...</div></div></code> </div> </div> <!-- ============================================ Section 2: Left Side Drawer ============================================ --> <div class="tw:border-t tw:pt-6"> <h2 class="tw-h4 tw:mb-4">Left Side Drawer</h2> <div class="tw-callout tw:mb-4"> <p class="tw:mb-0 tw:text-sm"> <strong>.tw-drawer-start:</strong> Slides in from the left edge instead of the right. Shadow is mirrored to the right side. </p> </div> <div data-controller="drawer"> <button class="tw-btn tw-btn-primary" type="button" data-action="click->drawer#open"> Open Left Drawer </button> <div class="tw-drawer-backdrop" data-drawer-target="backdrop" data-action="click->drawer#close" aria-hidden="true"></div> <div class="tw-drawer tw-drawer-start" data-drawer-target="panel" role="dialog" aria-modal="true" aria-labelledby="drawer-left-title" aria-hidden="true"> <div class="tw-drawer-header"> <h2 class="tw-drawer-title" id="drawer-left-title">Navigation</h2> <button class="tw-btn tw-btn-icon tw-btn-tertiary" type="button" data-action="click->drawer#close" aria-label="Close drawer"> <i class="fa-solid fa-xmark"></i> </button> </div> <div class="tw-drawer-body"> <p class="tw:text-neutral-600">Left-side drawer content. Useful for navigation panels or supplementary controls.</p> </div> <div class="tw-drawer-footer"> <button class="tw-btn tw-btn-secondary" type="button" data-action="click->drawer#close">Close</button> </div> </div> </div> <div class="tw:mt-4 tw:text-sm tw:text-neutral-600"> <code><div class="tw-drawer tw-drawer-start">...</div></code> </div> </div> <!-- ============================================ Section 3: Size Variants ============================================ --> <div class="tw:border-t tw:pt-6"> <h2 class="tw-h4 tw:mb-4">Size Variants</h2> <div class="tw-callout tw:mb-4"> <p class="tw:mb-0 tw:text-sm"> <strong>Sizes:</strong> <code>.tw-drawer-sm</code> (360px) | default (480px) | <code>.tw-drawer-lg</code> (600px) | <code>.tw-drawer-wide</code> (720px). All sizes become full-width on mobile screens (< 640px). </p> </div> <div class="tw:flex tw:flex-wrap tw:gap-3"> <!-- Small --> <div data-controller="drawer"> <button class="tw-btn tw-btn-outline-primary" type="button" data-action="click->drawer#open"> Small (360px) </button> <div class="tw-drawer-backdrop" data-drawer-target="backdrop" data-action="click->drawer#close" aria-hidden="true"></div> <div class="tw-drawer tw-drawer-sm" data-drawer-target="panel" role="dialog" aria-modal="true" aria-labelledby="drawer-sm-title" aria-hidden="true"> <div class="tw-drawer-header"> <h2 class="tw-drawer-title" id="drawer-sm-title">Small Drawer</h2> <button class="tw-btn tw-btn-icon tw-btn-tertiary" type="button" data-action="click->drawer#close" aria-label="Close drawer"> <i class="fa-solid fa-xmark"></i> </button> </div> <div class="tw-drawer-body"> <p class="tw:text-neutral-600">This drawer is 360px wide. Suitable for compact content like quick settings or filters.</p> </div> <div class="tw-drawer-footer"> <button class="tw-btn tw-btn-secondary" type="button" data-action="click->drawer#close">Cancel</button> <button class="tw-btn tw-btn-primary" type="button">Apply</button> </div> </div> </div> <!-- Large --> <div data-controller="drawer"> <button class="tw-btn tw-btn-outline-primary" type="button" data-action="click->drawer#open"> Large (600px) </button> <div class="tw-drawer-backdrop" data-drawer-target="backdrop" data-action="click->drawer#close" aria-hidden="true"></div> <div class="tw-drawer tw-drawer-lg" data-drawer-target="panel" role="dialog" aria-modal="true" aria-labelledby="drawer-lg-title" aria-hidden="true"> <div class="tw-drawer-header"> <h2 class="tw-drawer-title" id="drawer-lg-title">Large Drawer</h2> <button class="tw-btn tw-btn-icon tw-btn-tertiary" type="button" data-action="click->drawer#close" aria-label="Close drawer"> <i class="fa-solid fa-xmark"></i> </button> </div> <div class="tw-drawer-body"> <p class="tw:text-neutral-600">This drawer is 600px wide. Suitable for forms with more fields or detailed content.</p> </div> <div class="tw-drawer-footer"> <button class="tw-btn tw-btn-secondary" type="button" data-action="click->drawer#close">Cancel</button> <button class="tw-btn tw-btn-primary" type="button">Apply</button> </div> </div> </div> <!-- Wide --> <div data-controller="drawer"> <button class="tw-btn tw-btn-outline-primary" type="button" data-action="click->drawer#open"> Wide (720px) </button> <div class="tw-drawer-backdrop" data-drawer-target="backdrop" data-action="click->drawer#close" aria-hidden="true"></div> <div class="tw-drawer tw-drawer-wide" data-drawer-target="panel" role="dialog" aria-modal="true" aria-labelledby="drawer-wide-title" aria-hidden="true"> <div class="tw-drawer-header"> <h2 class="tw-drawer-title" id="drawer-wide-title">Wide Drawer</h2> <button class="tw-btn tw-btn-icon tw-btn-tertiary" type="button" data-action="click->drawer#close" aria-label="Close drawer"> <i class="fa-solid fa-xmark"></i> </button> </div> <div class="tw-drawer-body"> <p class="tw:text-neutral-600">This drawer is 720px wide. Suitable for complex forms, data tables, or split-pane layouts.</p> </div> <div class="tw-drawer-footer"> <button class="tw-btn tw-btn-secondary" type="button" data-action="click->drawer#close">Cancel</button> <button class="tw-btn tw-btn-primary" type="button">Apply</button> </div> </div> </div> </div> <div class="tw:mt-4 tw:text-sm tw:text-neutral-600"> <code><div class="tw-drawer tw-drawer-sm"></code> | <code><div class="tw-drawer tw-drawer-lg"></code> | <code><div class="tw-drawer tw-drawer-wide"></code> </div> </div> <!-- ============================================ Section 4: Without Footer ============================================ --> <div class="tw:border-t tw:pt-6"> <h2 class="tw-h4 tw:mb-4">Without Footer</h2> <div class="tw-callout tw:mb-4"> <p class="tw:mb-0 tw:text-sm"> <strong>No footer:</strong> Omit the <code>.tw-drawer-footer</code> section for informational or read-only drawers. The body expands to fill the remaining space. </p> </div> <div data-controller="drawer"> <button class="tw-btn tw-btn-primary" type="button" data-action="click->drawer#open"> Open Info Drawer </button> <div class="tw-drawer-backdrop" data-drawer-target="backdrop" data-action="click->drawer#close" aria-hidden="true"></div> <div class="tw-drawer" data-drawer-target="panel" role="dialog" aria-modal="true" aria-labelledby="drawer-info-title" aria-hidden="true"> <div class="tw-drawer-header"> <h2 class="tw-drawer-title" id="drawer-info-title">Application Details</h2> <button class="tw-btn tw-btn-icon tw-btn-tertiary" type="button" data-action="click->drawer#close" aria-label="Close drawer"> <i class="fa-solid fa-xmark"></i> </button> </div> <div class="tw-drawer-body"> <h3 class="tw-h5 tw:mb-3">Applicant Information</h3> <div class="tw:mb-3"> <span class="tw-small tw:text-neutral-500">Full Name</span> <p class="tw:mb-0">Sarah Johnson</p> </div> <div class="tw:mb-3"> <span class="tw-small tw:text-neutral-500">Date of Birth</span> <p class="tw:mb-0">15 March 2014</p> </div> <div class="tw:mb-3"> <span class="tw-small tw:text-neutral-500">Current School</span> <p class="tw:mb-0">Oakwood Primary School</p> </div> <div class="tw:mb-3"> <span class="tw-small tw:text-neutral-500">Year Group Applied</span> <p class="tw:mb-0">Year 7 Entry 2026</p> </div> <div class="tw:mb-3"> <span class="tw-small tw:text-neutral-500">Status</span> <p class="tw:mb-0"><span class="tw-badge tw-badge-success-subtle">Completed</span></p> </div> </div> </div> </div> <div class="tw:mt-4 tw:text-sm tw:text-neutral-600"> <code><div class="tw-drawer"><div class="tw-drawer-header">...</div><div class="tw-drawer-body">...</div></div></code> </div> </div> <!-- ============================================ Section 5: Scrollable Content ============================================ --> <div class="tw:border-t tw:pt-6"> <h2 class="tw-h4 tw:mb-4">Scrollable Content</h2> <div class="tw-callout tw:mb-4"> <p class="tw:mb-0 tw:text-sm"> <strong>Overflow:</strong> When body content exceeds the available height, the <code>.tw-drawer-body</code> scrolls independently while the header and footer remain fixed. </p> </div> <div data-controller="drawer"> <button class="tw-btn tw-btn-primary" type="button" data-action="click->drawer#open"> Open Scrollable Drawer </button> <div class="tw-drawer-backdrop" data-drawer-target="backdrop" data-action="click->drawer#close" aria-hidden="true"></div> <div class="tw-drawer" data-drawer-target="panel" role="dialog" aria-modal="true" aria-labelledby="drawer-scroll-title" aria-hidden="true"> <div class="tw-drawer-header"> <h2 class="tw-drawer-title" id="drawer-scroll-title">Application Form</h2> <button class="tw-btn tw-btn-icon tw-btn-tertiary" type="button" data-action="click->drawer#close" aria-label="Close drawer"> <i class="fa-solid fa-xmark"></i> </button> </div> <div class="tw-drawer-body"> <div class="tw:mb-4"> <label class="tw-form-label" for="drawer-scroll-first">First name</label> <input type="text" class="tw-form-control" id="drawer-scroll-first" value="Sarah"> </div> <div class="tw:mb-4"> <label class="tw-form-label" for="drawer-scroll-last">Last name</label> <input type="text" class="tw-form-control" id="drawer-scroll-last" value="Johnson"> </div> <div class="tw:mb-4"> <label class="tw-form-label" for="drawer-scroll-email">Email address</label> <input type="email" class="tw-form-control" id="drawer-scroll-email" value="sarah.johnson@email.com"> </div> <div class="tw:mb-4"> <label class="tw-form-label" for="drawer-scroll-phone">Phone number</label> <input type="tel" class="tw-form-control" id="drawer-scroll-phone" value="+44 7700 900123"> </div> <div class="tw:mb-4"> <label class="tw-form-label" for="drawer-scroll-address1">Address line 1</label> <input type="text" class="tw-form-control" id="drawer-scroll-address1" value="42 Elm Street"> </div> <div class="tw:mb-4"> <label class="tw-form-label" for="drawer-scroll-address2">Address line 2</label> <input type="text" class="tw-form-control" id="drawer-scroll-address2" value="Kensington"> </div> <div class="tw:mb-4"> <label class="tw-form-label" for="drawer-scroll-city">City</label> <input type="text" class="tw-form-control" id="drawer-scroll-city" value="London"> </div> <div class="tw:mb-4"> <label class="tw-form-label" for="drawer-scroll-postcode">Postcode</label> <input type="text" class="tw-form-control" id="drawer-scroll-postcode" value="W8 5QR"> </div> <div class="tw:mb-4"> <label class="tw-form-label" for="drawer-scroll-country">Country</label> <select class="tw-form-select" id="drawer-scroll-country"> <option selected>United Kingdom</option> <option>United States</option> <option>France</option> <option>Germany</option> </select> </div> <div class="tw:mb-4"> <label class="tw-form-label" for="drawer-scroll-notes">Additional notes</label> <textarea class="tw-form-control" id="drawer-scroll-notes" rows="4">Sibling already enrolled in Year 9. Please consider for bursary programme.</textarea> </div> </div> <div class="tw-drawer-footer"> <button class="tw-btn tw-btn-secondary" type="button" data-action="click->drawer#close">Cancel</button> <button class="tw-btn tw-btn-primary" type="button">Save Changes</button> </div> </div> </div> </div> <!-- ============================================ Section 6: Without Backdrop ============================================ --> <div class="tw:border-t tw:pt-6"> <h2 class="tw-h4 tw:mb-4">Without Backdrop</h2> <div class="tw-callout tw:mb-4"> <p class="tw:mb-0 tw:text-sm"> <strong>No backdrop:</strong> Omit the <code>.tw-drawer-backdrop</code> element for drawers that don't need to dim the background. The drawer still supports Escape key to close. </p> </div> <div data-controller="drawer"> <button class="tw-btn tw-btn-primary" type="button" data-action="click->drawer#open"> Open Without Backdrop </button> <div class="tw-drawer" data-drawer-target="panel" role="dialog" aria-modal="true" aria-labelledby="drawer-nobg-title" aria-hidden="true"> <div class="tw-drawer-header"> <h2 class="tw-drawer-title" id="drawer-nobg-title">Quick Settings</h2> <button class="tw-btn tw-btn-icon tw-btn-tertiary" type="button" data-action="click->drawer#close" aria-label="Close drawer"> <i class="fa-solid fa-xmark"></i> </button> </div> <div class="tw-drawer-body"> <p class="tw:text-neutral-600">This drawer has no backdrop overlay. The page behind remains fully visible and interactive areas outside the drawer are not dimmed.</p> </div> <div class="tw-drawer-footer"> <button class="tw-btn tw-btn-secondary" type="button" data-action="click->drawer#close">Close</button> </div> </div> </div> <div class="tw:mt-4 tw:text-sm tw:text-neutral-600"> <code><!-- Simply omit .tw-drawer-backdrop element --></code> </div> </div> <!-- ============================================ Section 7: Keyboard Navigation ============================================ --> <div class="tw:border-t tw:pt-6"> <h2 class="tw-h4 tw:mb-4">Keyboard Navigation</h2> <div class="tw-callout tw:mb-4"> <p class="tw:mb-0 tw:text-sm"> <strong>Accessibility:</strong> The drawer traps focus while open, supports Escape to close, and returns focus to the trigger element on close. </p> </div> <table class="tw-table tw-table-sm"> <thead> <tr> <th>Key</th> <th>Action</th> </tr> </thead> <tbody> <tr> <td><code>Escape</code></td> <td>Close the drawer and return focus to trigger</td> </tr> <tr> <td><code>Tab</code></td> <td>Move focus to next focusable element (trapped within drawer)</td> </tr> <tr> <td><code>Shift + Tab</code></td> <td>Move focus to previous focusable element (trapped within drawer)</td> </tr> </tbody> </table> </div> <!-- ============================================ Section 8: Quick Reference ============================================ --> <div class="tw:border-t tw:pt-6"> <h2 class="tw-h4 tw:mb-4">Quick Reference</h2> <div class="tw-callout"> <p class="tw:mb-1 tw:text-sm tw:font-mono"> <strong>Container:</strong> .tw-drawer | .tw-drawer.tw-show | .tw-drawer-start | .tw-drawer-sm | .tw-drawer-lg | .tw-drawer-wide<br> <strong>Sections:</strong> .tw-drawer-header | .tw-drawer-title | .tw-drawer-body | .tw-drawer-footer<br> <strong>Overlay:</strong> .tw-drawer-backdrop | .tw-drawer-backdrop.tw-show<br> <strong>Close button:</strong> .tw-btn .tw-btn-icon .tw-btn-tertiary (existing component)<br> <strong>Footer buttons:</strong> .tw-btn .tw-btn-secondary | .tw-btn .tw-btn-primary (existing components)<br> <strong>Controller:</strong> data-controller="drawer" | data-action="click->drawer#open" | data-action="click->drawer#close" </p> </div> </div></div>No notes provided.
No params configured.