admin-lte 4.0.2 → 4.0.4

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.
Files changed (110) hide show
  1. package/ACCESSIBILITY-COMPLIANCE.md +60 -339
  2. package/CHANGELOG.md +43 -0
  3. package/README.md +15 -2
  4. package/dist/css/adminlte.css +24 -786
  5. package/dist/css/adminlte.css.map +1 -1
  6. package/dist/css/adminlte.min.css +2 -2
  7. package/dist/css/adminlte.min.css.map +1 -1
  8. package/dist/css/adminlte.rtl.css +24 -786
  9. package/dist/css/adminlte.rtl.css.map +1 -1
  10. package/dist/css/adminlte.rtl.min.css +2 -2
  11. package/dist/css/adminlte.rtl.min.css.map +1 -1
  12. package/dist/js/adminlte.js +233 -128
  13. package/dist/js/adminlte.js.map +1 -1
  14. package/dist/js/adminlte.min.js +2 -2
  15. package/dist/js/adminlte.min.js.map +1 -1
  16. package/package.json +30 -17
  17. package/src/scss/_callouts.scss +13 -3
  18. package/src/scss/_dropdown.scss +3 -1
  19. package/src/scss/adminlte.scss +1 -1
  20. package/src/scss/parts/_core.scss +0 -1
  21. package/src/ts/accessibility.ts +129 -69
  22. package/src/ts/adminlte.ts +1 -1
  23. package/src/ts/card-widget.ts +33 -8
  24. package/src/ts/fullscreen.ts +48 -42
  25. package/src/ts/layout.ts +2 -1
  26. package/src/ts/push-menu.ts +24 -8
  27. package/src/ts/treeview.ts +27 -1
  28. package/src/ts/util/index.ts +114 -29
  29. package/.browserslistrc +0 -17
  30. package/.prettierrc +0 -6
  31. package/CODE_OF_CONDUCT.md +0 -43
  32. package/SECURITY.md +0 -99
  33. package/dist/UI/general.html +0 -2317
  34. package/dist/UI/icons.html +0 -1126
  35. package/dist/UI/timeline.html +0 -1212
  36. package/dist/docs/browser-support.html +0 -826
  37. package/dist/docs/color-mode.html +0 -1142
  38. package/dist/docs/components/main-header.html +0 -1209
  39. package/dist/docs/components/main-sidebar.html +0 -924
  40. package/dist/docs/customization.html +0 -1080
  41. package/dist/docs/deployment.html +0 -1145
  42. package/dist/docs/faq.html +0 -1392
  43. package/dist/docs/getting-started.html +0 -991
  44. package/dist/docs/how-to-contribute.html +0 -890
  45. package/dist/docs/index.html +0 -16
  46. package/dist/docs/integrations.html +0 -1231
  47. package/dist/docs/introduction.html +0 -1008
  48. package/dist/docs/javascript/accessibility.html +0 -949
  49. package/dist/docs/javascript/card-widget.html +0 -1019
  50. package/dist/docs/javascript/direct-chat.html +0 -896
  51. package/dist/docs/javascript/fullscreen.html +0 -905
  52. package/dist/docs/javascript/layout.html +0 -908
  53. package/dist/docs/javascript/plugins-overview.html +0 -1144
  54. package/dist/docs/javascript/pushmenu.html +0 -1045
  55. package/dist/docs/javascript/treeview.html +0 -1024
  56. package/dist/docs/layout-blueprint.html +0 -1087
  57. package/dist/docs/layout.html +0 -842
  58. package/dist/docs/license.html +0 -807
  59. package/dist/docs/migration.html +0 -1149
  60. package/dist/docs/recipes.html +0 -1185
  61. package/dist/docs/rtl.html +0 -957
  62. package/dist/examples/lockscreen.html +0 -249
  63. package/dist/examples/login-v2.html +0 -282
  64. package/dist/examples/login.html +0 -272
  65. package/dist/examples/register-v2.html +0 -291
  66. package/dist/examples/register.html +0 -277
  67. package/dist/forms/elements.html +0 -1405
  68. package/dist/forms/layout.html +0 -1267
  69. package/dist/forms/validation.html +0 -1275
  70. package/dist/forms/wizard.html +0 -1410
  71. package/dist/generate/theme.html +0 -1082
  72. package/dist/index.html +0 -1745
  73. package/dist/index2.html +0 -2277
  74. package/dist/index3.html +0 -1532
  75. package/dist/layout/collapsed-sidebar-without-hover.html +0 -1144
  76. package/dist/layout/collapsed-sidebar.html +0 -1137
  77. package/dist/layout/fixed-complete.html +0 -1138
  78. package/dist/layout/fixed-footer.html +0 -1136
  79. package/dist/layout/fixed-header.html +0 -1136
  80. package/dist/layout/fixed-sidebar.html +0 -1138
  81. package/dist/layout/layout-custom-area.html +0 -1177
  82. package/dist/layout/layout-rtl.html +0 -1137
  83. package/dist/layout/logo-switch.html +0 -683
  84. package/dist/layout/sidebar-mini.html +0 -1137
  85. package/dist/layout/unfixed-sidebar.html +0 -1136
  86. package/dist/mailbox/compose.html +0 -1151
  87. package/dist/mailbox/inbox.html +0 -1509
  88. package/dist/mailbox/read.html +0 -1202
  89. package/dist/pages/404.html +0 -239
  90. package/dist/pages/500.html +0 -227
  91. package/dist/pages/calendar.html +0 -1266
  92. package/dist/pages/chat.html +0 -1427
  93. package/dist/pages/faq.html +0 -1383
  94. package/dist/pages/file-manager.html +0 -1835
  95. package/dist/pages/invoice.html +0 -1199
  96. package/dist/pages/kanban.html +0 -1439
  97. package/dist/pages/maintenance.html +0 -230
  98. package/dist/pages/pricing.html +0 -1279
  99. package/dist/pages/profile.html +0 -1382
  100. package/dist/pages/projects.html +0 -1644
  101. package/dist/pages/settings.html +0 -1387
  102. package/dist/tables/data.html +0 -1319
  103. package/dist/tables/simple.html +0 -1435
  104. package/dist/widgets/cards.html +0 -1356
  105. package/dist/widgets/info-box.html +0 -1429
  106. package/dist/widgets/small-box.html +0 -1225
  107. package/eslint.config.js +0 -82
  108. package/github-issue-response.md +0 -40
  109. package/index.html +0 -12
  110. package/netlify.toml +0 -16
package/dist/docs/javascript/accessibility.html DELETED
@@ -1,949 +0,0 @@
1
- <!doctype html>
2
- <html lang="en">
3
- <!--begin::Head-->
4
- <head>
5
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
6
- <title>Accessibility Module | AdminLTE 4</title>
7
-
8
- <!--begin::Theme Init (prevents flash of incorrect theme on load, #6043)-->
9
- <script>
10
- (() => {
11
- 'use strict';
12
- const STORAGE_KEY = 'lte-theme';
13
- let stored = null;
14
- try {
15
- stored = localStorage.getItem(STORAGE_KEY);
16
- } catch {
17
- // localStorage may be unavailable (private mode, sandboxed iframe).
18
- }
19
- const prefersDark = globalThis.matchMedia('(prefers-color-scheme: dark)').matches;
20
- // Mirror the resolution in _scripts.astro: explicit "dark"/"light" win,
21
- // otherwise ("auto" or unset) fall back to the OS preference.
22
- let resolved = 'light';
23
- if (stored === 'dark' || stored === 'light') {
24
- resolved = stored;
25
- } else if (prefersDark) {
26
- resolved = 'dark';
27
- }
28
- document.documentElement.setAttribute('data-bs-theme', resolved);
29
- document.documentElement.style.colorScheme = resolved;
30
- })();
31
- </script>
32
- <!--end::Theme Init-->
33
-
34
- <!--begin::Accessibility Meta Tags-->
35
- <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes" />
36
- <meta name="color-scheme" content="light dark" />
37
- <meta name="theme-color" content="#007bff" media="(prefers-color-scheme: light)" />
38
- <meta name="theme-color" content="#1a1a1a" media="(prefers-color-scheme: dark)" />
39
- <!--end::Accessibility Meta Tags-->
40
-
41
- <!--begin::Primary Meta Tags-->
42
- <meta name="title" content="Accessibility Module | AdminLTE 4" />
43
- <meta name="author" content="ColorlibHQ" />
44
- <meta
45
- name="description"
46
- content="AdminLTE is a Free Bootstrap 5 Admin Dashboard, 30 example pages using Vanilla JS. Fully accessible with WCAG 2.1 AA compliance."
47
- />
48
- <meta
49
- name="keywords"
50
- content="bootstrap 5, bootstrap, bootstrap 5 admin dashboard, bootstrap 5 dashboard, bootstrap 5 charts, bootstrap 5 calendar, bootstrap 5 datepicker, bootstrap 5 tables, bootstrap 5 datatable, vanilla js datatable, colorlibhq, colorlibhq dashboard, colorlibhq admin dashboard, accessible admin panel, WCAG compliant"
51
- />
52
- <!--end::Primary Meta Tags-->
53
-
54
- <!--begin::Accessibility Features-->
55
- <!-- Skip links will be dynamically added by accessibility.js -->
56
- <meta name="supported-color-schemes" content="light dark" />
57
- <link rel="preload" href="../../css/adminlte.css" as="style" />
58
- <!--end::Accessibility Features-->
59
-
60
- <!--begin::Fonts-->
61
- <link
62
- rel="stylesheet"
63
- href="https://cdn.jsdelivr.net/npm/@fontsource/source-sans-3@5.0.12/index.css"
64
- integrity="sha256-tXJfXfp6Ewt1ilPzLDtQnJV4hclT9XuaZUKyUvmyr+Q="
65
- crossorigin="anonymous"
66
- media="print"
67
- onload="this.media = 'all'"
68
- />
69
- <!--end::Fonts-->
70
-
71
- <!--begin::Third Party Plugin(OverlayScrollbars)-->
72
- <link
73
- rel="stylesheet"
74
- href="https://cdn.jsdelivr.net/npm/overlayscrollbars@2.11.0/styles/overlayscrollbars.min.css"
75
- crossorigin="anonymous"
76
- />
77
- <!--end::Third Party Plugin(OverlayScrollbars)-->
78
-
79
- <!--begin::Third Party Plugin(Bootstrap Icons)-->
80
- <link
81
- rel="stylesheet"
82
- href="https://cdn.jsdelivr.net/npm/bootstrap-icons@1.13.1/font/bootstrap-icons.min.css"
83
- crossorigin="anonymous"
84
- />
85
- <!--end::Third Party Plugin(Bootstrap Icons)-->
86
-
87
- <!--begin::Required Plugin(AdminLTE)-->
88
- <link rel="stylesheet" href="../../css/adminlte.css" />
89
- <!--end::Required Plugin(AdminLTE)-->
90
- </head>
91
- <!--end::Head-->
92
- <!--begin::Body-->
93
- <body class="layout-fixed sidebar-expand-lg bg-body-tertiary docs-page">
94
- <!--begin::App Wrapper-->
95
- <div class="app-wrapper">
96
- <!--begin::Header-->
97
- <nav class="app-header navbar navbar-expand bg-body">
98
- <!--begin::Container-->
99
- <div class="container-fluid">
100
- <!--begin::Start Navbar Links-->
101
- <ul class="navbar-nav">
102
- <li class="nav-item">
103
- <a class="nav-link" data-lte-toggle="sidebar" href="#" role="button">
104
- <i class="bi bi-list"></i>
105
- </a>
106
- </li>
107
-
108
- <li class="nav-item d-none d-md-block">
109
- <a href="../../docs/introduction.html" class="nav-link">
110
- <i class="bi bi-book me-1" aria-hidden="true"></i>
111
- Documentation
112
- </a>
113
- </li>
114
- <li class="nav-item d-none d-md-block">
115
- <a href="../../index.html" class="nav-link">
116
- <i class="bi bi-arrow-left me-1" aria-hidden="true"></i>
117
- Back to live preview
118
- </a>
119
- </li>
120
- </ul>
121
- <!--end::Start Navbar Links-->
122
-
123
- <!--begin::End Navbar Links-->
124
- <ul class="navbar-nav ms-auto">
125
- <!--begin::Navbar Search-->
126
- <li class="nav-item">
127
- <a class="nav-link" data-widget="navbar-search" href="#" role="button">
128
- <i class="bi bi-search"></i>
129
- </a>
130
- </li>
131
- <!--end::Navbar Search-->
132
-
133
- <!--begin::Messages Dropdown Menu-->
134
- <li class="nav-item dropdown">
135
- <a class="nav-link" data-bs-toggle="dropdown" href="#">
136
- <i class="bi bi-chat-text"></i>
137
- <span class="navbar-badge badge text-bg-danger">3</span>
138
- </a>
139
- <div class="dropdown-menu dropdown-menu-lg dropdown-menu-end">
140
- <a href="#" class="dropdown-item">
141
- <!--begin::Message-->
142
- <div class="d-flex">
143
- <div class="flex-shrink-0">
144
- <img
145
- src="../../assets/img/user1-128x128.jpg"
146
- alt="User Avatar"
147
- class="img-size-50 rounded-circle me-3"
148
- />
149
- </div>
150
- <div class="flex-grow-1">
151
- <h3 class="dropdown-item-title">
152
- Brad Diesel
153
- <span class="float-end fs-7 text-danger"
154
- ><i class="bi bi-star-fill"></i
155
- ></span>
156
- </h3>
157
- <p class="fs-7">Call me whenever you can...</p>
158
- <p class="fs-7 text-secondary">
159
- <i class="bi bi-clock-fill me-1"></i> 4 Hours Ago
160
- </p>
161
- </div>
162
- </div>
163
- <!--end::Message-->
164
- </a>
165
- <div class="dropdown-divider"></div>
166
- <a href="#" class="dropdown-item">
167
- <!--begin::Message-->
168
- <div class="d-flex">
169
- <div class="flex-shrink-0">
170
- <img
171
- src="../../assets/img/user8-128x128.jpg"
172
- alt="User Avatar"
173
- class="img-size-50 rounded-circle me-3"
174
- />
175
- </div>
176
- <div class="flex-grow-1">
177
- <h3 class="dropdown-item-title">
178
- John Pierce
179
- <span class="float-end fs-7 text-secondary">
180
- <i class="bi bi-star-fill"></i>
181
- </span>
182
- </h3>
183
- <p class="fs-7">I got your message bro</p>
184
- <p class="fs-7 text-secondary">
185
- <i class="bi bi-clock-fill me-1"></i> 4 Hours Ago
186
- </p>
187
- </div>
188
- </div>
189
- <!--end::Message-->
190
- </a>
191
- <div class="dropdown-divider"></div>
192
- <a href="#" class="dropdown-item">
193
- <!--begin::Message-->
194
- <div class="d-flex">
195
- <div class="flex-shrink-0">
196
- <img
197
- src="../../assets/img/user3-128x128.jpg"
198
- alt="User Avatar"
199
- class="img-size-50 rounded-circle me-3"
200
- />
201
- </div>
202
- <div class="flex-grow-1">
203
- <h3 class="dropdown-item-title">
204
- Nora Silvester
205
- <span class="float-end fs-7 text-warning">
206
- <i class="bi bi-star-fill"></i>
207
- </span>
208
- </h3>
209
- <p class="fs-7">The subject goes here</p>
210
- <p class="fs-7 text-secondary">
211
- <i class="bi bi-clock-fill me-1"></i> 4 Hours Ago
212
- </p>
213
- </div>
214
- </div>
215
- <!--end::Message-->
216
- </a>
217
- <div class="dropdown-divider"></div>
218
- <a href="#" class="dropdown-item dropdown-footer">See All Messages</a>
219
- </div>
220
- </li>
221
- <!--end::Messages Dropdown Menu-->
222
-
223
- <!--begin::Notifications Dropdown Menu-->
224
- <li class="nav-item dropdown">
225
- <a class="nav-link" data-bs-toggle="dropdown" href="#">
226
- <i class="bi bi-bell-fill"></i>
227
- <span class="navbar-badge badge text-bg-warning">15</span>
228
- </a>
229
- <div class="dropdown-menu dropdown-menu-lg dropdown-menu-end">
230
- <span class="dropdown-item dropdown-header">15 Notifications</span>
231
- <div class="dropdown-divider"></div>
232
- <a href="#" class="dropdown-item">
233
- <i class="bi bi-envelope me-2"></i> 4 new messages
234
- <span class="float-end text-secondary fs-7">3 mins</span>
235
- </a>
236
- <div class="dropdown-divider"></div>
237
- <a href="#" class="dropdown-item">
238
- <i class="bi bi-people-fill me-2"></i> 8 friend requests
239
- <span class="float-end text-secondary fs-7">12 hours</span>
240
- </a>
241
- <div class="dropdown-divider"></div>
242
- <a href="#" class="dropdown-item">
243
- <i class="bi bi-file-earmark-fill me-2"></i> 3 new reports
244
- <span class="float-end text-secondary fs-7">2 days</span>
245
- </a>
246
- <div class="dropdown-divider"></div>
247
- <a href="#" class="dropdown-item dropdown-footer"> See All Notifications </a>
248
- </div>
249
- </li>
250
- <!--end::Notifications Dropdown Menu-->
251
-
252
- <!--begin::Fullscreen Toggle-->
253
- <li class="nav-item">
254
- <a class="nav-link" href="#" data-lte-toggle="fullscreen">
255
- <i data-lte-icon="maximize" class="bi bi-arrows-fullscreen"></i>
256
- <i data-lte-icon="minimize" class="bi bi-fullscreen-exit d-none"></i>
257
- </a>
258
- </li>
259
- <!--end::Fullscreen Toggle-->
260
-
261
- <!--begin::Color Mode Toggle (#6010)-->
262
- <li class="nav-item dropdown">
263
- <a
264
- class="nav-link"
265
- href="#"
266
- id="bd-theme"
267
- aria-label="Toggle color scheme"
268
- data-bs-toggle="dropdown"
269
- aria-expanded="false"
270
- >
271
- <i class="bi bi-sun-fill" data-lte-theme-icon="light"></i>
272
- <i class="bi bi-moon-fill d-none" data-lte-theme-icon="dark"></i>
273
- <i class="bi bi-circle-half d-none" data-lte-theme-icon="auto"></i>
274
- </a>
275
- <ul
276
- class="dropdown-menu dropdown-menu-end"
277
- aria-labelledby="bd-theme"
278
- style="--bs-dropdown-min-width: 8rem"
279
- >
280
- <li>
281
- <button
282
- type="button"
283
- class="dropdown-item d-flex align-items-center"
284
- data-bs-theme-value="light"
285
- aria-pressed="false"
286
- >
287
- <i class="bi bi-sun-fill me-2"></i>
288
- Light
289
- <i class="bi bi-check-lg ms-auto d-none"></i>
290
- </button>
291
- </li>
292
- <li>
293
- <button
294
- type="button"
295
- class="dropdown-item d-flex align-items-center"
296
- data-bs-theme-value="dark"
297
- aria-pressed="false"
298
- >
299
- <i class="bi bi-moon-fill me-2"></i>
300
- Dark
301
- <i class="bi bi-check-lg ms-auto d-none"></i>
302
- </button>
303
- </li>
304
- <li>
305
- <button
306
- type="button"
307
- class="dropdown-item d-flex align-items-center active"
308
- data-bs-theme-value="auto"
309
- aria-pressed="true"
310
- >
311
- <i class="bi bi-circle-half me-2"></i>
312
- Auto
313
- <i class="bi bi-check-lg ms-auto d-none"></i>
314
- </button>
315
- </li>
316
- </ul>
317
- </li>
318
- <!--end::Color Mode Toggle-->
319
-
320
- <!--begin::User Menu Dropdown-->
321
- <li class="nav-item dropdown user-menu">
322
- <a href="#" class="nav-link dropdown-toggle" data-bs-toggle="dropdown">
323
- <img
324
- src="../../assets/img/user2-160x160.jpg"
325
- class="user-image rounded-circle shadow"
326
- alt="User Image"
327
- />
328
- <span class="d-none d-md-inline">Alexander Pierce</span>
329
- </a>
330
- <ul class="dropdown-menu dropdown-menu-lg dropdown-menu-end">
331
- <!--begin::User Image-->
332
- <li class="user-header text-bg-primary">
333
- <img
334
- src="../../assets/img/user2-160x160.jpg"
335
- class="rounded-circle shadow"
336
- alt="User Image"
337
- />
338
- <p>
339
- Alexander Pierce - Web Developer
340
- <small>Member since Nov. 2023</small>
341
- </p>
342
- </li>
343
- <!--end::User Image-->
344
- <!--begin::Menu Body-->
345
- <li class="user-body">
346
- <!--begin::Row-->
347
- <div class="row">
348
- <div class="col-4 text-center">
349
- <a href="#">Followers</a>
350
- </div>
351
- <div class="col-4 text-center">
352
- <a href="#">Sales</a>
353
- </div>
354
- <div class="col-4 text-center">
355
- <a href="#">Friends</a>
356
- </div>
357
- </div>
358
- <!--end::Row-->
359
- </li>
360
- <!--end::Menu Body-->
361
- <!--begin::Menu Footer-->
362
- <li class="user-footer">
363
- <a href="#" class="btn btn-outline-secondary">Profile</a>
364
- <a href="#" class="btn btn-outline-danger float-end">Sign out</a>
365
- </li>
366
- <!--end::Menu Footer-->
367
- </ul>
368
- </li>
369
- <!--end::User Menu Dropdown-->
370
- </ul>
371
- <!--end::End Navbar Links-->
372
- </div>
373
- <!--end::Container-->
374
- </nav>
375
- <!--end::Header-->
376
- <!--begin::Sidebar (docs mode)-->
377
- <aside class="app-sidebar bg-body-secondary shadow" data-bs-theme="dark">
378
- <!--begin::Sidebar Brand-->
379
- <div class="sidebar-brand">
380
- <a href="../../docs/introduction.html" class="brand-link">
381
- <img
382
- src="../../assets/img/AdminLTELogo.png"
383
- alt="AdminLTE Logo"
384
- class="brand-image opacity-75 shadow"
385
- />
386
- <span class="brand-text fw-light">
387
- AdminLTE 4 <span class="opacity-75">&middot; Docs</span>
388
- </span>
389
- </a>
390
- </div>
391
- <!--end::Sidebar Brand-->
392
- <!--begin::Sidebar Wrapper-->
393
- <div class="sidebar-wrapper">
394
- <nav class="mt-2" aria-label="Documentation navigation">
395
- <!--begin::Sidebar Menu-->
396
- <ul
397
- class="nav sidebar-menu flex-column"
398
- data-lte-toggle="treeview"
399
- data-accordion="false"
400
- id="docs-navigation"
401
- >
402
- <li class="nav-header">START HERE</li>
403
- <li class="nav-item">
404
- <a href="../../docs/introduction.html" class="nav-link">
405
- <i class="nav-icon bi bi-download"></i>
406
- <p>Installation</p>
407
- </a>
408
- </li>
409
- <li class="nav-item">
410
- <a href="../../docs/getting-started.html" class="nav-link">
411
- <i class="nav-icon bi bi-rocket-takeoff"></i>
412
- <p>Getting Started</p>
413
- </a>
414
- </li>
415
-
416
- <li class="nav-header">FOUNDATIONS</li>
417
- <li class="nav-item">
418
- <a href="../../docs/layout.html" class="nav-link">
419
- <i class="nav-icon bi bi-grip-horizontal"></i>
420
- <p>Layout Classes</p>
421
- </a>
422
- </li>
423
- <li class="nav-item">
424
- <a href="../../docs/layout-blueprint.html" class="nav-link">
425
- <i class="nav-icon bi bi-diagram-3"></i>
426
- <p>Layout Blueprint</p>
427
- </a>
428
- </li>
429
- <li class="nav-item">
430
- <a href="../../docs/customization.html" class="nav-link">
431
- <i class="nav-icon bi bi-palette"></i>
432
- <p>Customization</p>
433
- </a>
434
- </li>
435
- <li class="nav-item">
436
- <a href="../../docs/color-mode.html" class="nav-link">
437
- <i class="nav-icon bi bi-star-half"></i>
438
- <p>Color Mode</p>
439
- </a>
440
- </li>
441
- <li class="nav-item">
442
- <a href="../../docs/rtl.html" class="nav-link">
443
- <i class="nav-icon bi bi-text-paragraph"></i>
444
- <p>RTL Support</p>
445
- </a>
446
- </li>
447
-
448
- <li class="nav-header">BUILDING</li>
449
- <li class="nav-item">
450
- <a href="../../docs/recipes.html" class="nav-link">
451
- <i class="nav-icon bi bi-clipboard-check"></i>
452
- <p>Recipes</p>
453
- </a>
454
- </li>
455
- <li class="nav-item">
456
- <a href="#" class="nav-link">
457
- <i class="nav-icon bi bi-ui-checks-grid"></i>
458
- <p>
459
- Components
460
- <i class="nav-arrow bi bi-chevron-right"></i>
461
- </p>
462
- </a>
463
- <ul class="nav nav-treeview">
464
- <li class="nav-item">
465
- <a href="../../docs/components/main-header.html" class="nav-link">
466
- <i class="nav-icon bi bi-circle"></i>
467
- <p>Main Header</p>
468
- </a>
469
- </li>
470
- <li class="nav-item">
471
- <a href="../../docs/components/main-sidebar.html" class="nav-link">
472
- <i class="nav-icon bi bi-circle"></i>
473
- <p>Main Sidebar</p>
474
- </a>
475
- </li>
476
- </ul>
477
- </li>
478
- <li class="nav-item menu-open">
479
- <a href="#" class="nav-link active">
480
- <i class="nav-icon bi bi-filetype-js"></i>
481
- <p>
482
- JavaScript Plugins
483
- <i class="nav-arrow bi bi-chevron-right"></i>
484
- </p>
485
- </a>
486
- <ul class="nav nav-treeview">
487
- <li class="nav-item">
488
- <a href="../../docs/javascript/plugins-overview.html" class="nav-link">
489
- <i class="nav-icon bi bi-circle"></i>
490
- <p>Overview</p>
491
- </a>
492
- </li>
493
- <li class="nav-item">
494
- <a href="../../docs/javascript/layout.html" class="nav-link">
495
- <i class="nav-icon bi bi-circle"></i>
496
- <p>Layout</p>
497
- </a>
498
- </li>
499
- <li class="nav-item">
500
- <a href="../../docs/javascript/pushmenu.html" class="nav-link">
501
- <i class="nav-icon bi bi-circle"></i>
502
- <p>PushMenu</p>
503
- </a>
504
- </li>
505
- <li class="nav-item">
506
- <a href="../../docs/javascript/treeview.html" class="nav-link">
507
- <i class="nav-icon bi bi-circle"></i>
508
- <p>Treeview</p>
509
- </a>
510
- </li>
511
- <li class="nav-item">
512
- <a href="../../docs/javascript/card-widget.html" class="nav-link">
513
- <i class="nav-icon bi bi-circle"></i>
514
- <p>Card Widget</p>
515
- </a>
516
- </li>
517
- <li class="nav-item">
518
- <a href="../../docs/javascript/direct-chat.html" class="nav-link">
519
- <i class="nav-icon bi bi-circle"></i>
520
- <p>Direct Chat</p>
521
- </a>
522
- </li>
523
- <li class="nav-item">
524
- <a href="../../docs/javascript/fullscreen.html" class="nav-link">
525
- <i class="nav-icon bi bi-circle"></i>
526
- <p>Fullscreen</p>
527
- </a>
528
- </li>
529
- <li class="nav-item">
530
- <a href="../../docs/javascript/accessibility.html" class="nav-link active">
531
- <i class="nav-icon bi bi-circle"></i>
532
- <p>Accessibility</p>
533
- </a>
534
- </li>
535
- </ul>
536
- </li>
537
- <li class="nav-item">
538
- <a href="../../docs/integrations.html" class="nav-link">
539
- <i class="nav-icon bi bi-puzzle"></i>
540
- <p>Integrations</p>
541
- </a>
542
- </li>
543
-
544
- <li class="nav-header">SHIPPING</li>
545
- <li class="nav-item">
546
- <a href="../../docs/migration.html" class="nav-link">
547
- <i class="nav-icon bi bi-arrow-up-right-square"></i>
548
- <p>Migration from v3</p>
549
- </a>
550
- </li>
551
- <li class="nav-item">
552
- <a href="../../docs/deployment.html" class="nav-link">
553
- <i class="nav-icon bi bi-cloud-upload"></i>
554
- <p>Deployment</p>
555
- </a>
556
- </li>
557
- <li class="nav-item">
558
- <a href="../../docs/browser-support.html" class="nav-link">
559
- <i class="nav-icon bi bi-browser-chrome"></i>
560
- <p>Browser Support</p>
561
- </a>
562
- </li>
563
-
564
- <li class="nav-header">RESOURCES</li>
565
- <li class="nav-item">
566
- <a href="../../docs/faq.html" class="nav-link">
567
- <i class="nav-icon bi bi-question-circle"></i>
568
- <p>FAQ</p>
569
- </a>
570
- </li>
571
- <li class="nav-item">
572
- <a href="../../docs/how-to-contribute.html" class="nav-link">
573
- <i class="nav-icon bi bi-people"></i>
574
- <p>Contributing</p>
575
- </a>
576
- </li>
577
- <li class="nav-item">
578
- <a href="../../docs/license.html" class="nav-link">
579
- <i class="nav-icon bi bi-patch-check"></i>
580
- <p>License</p>
581
- </a>
582
- </li>
583
- <li class="nav-item">
584
- <a
585
- href="https://github.com/ColorlibHQ/AdminLTE"
586
- target="_blank"
587
- rel="noopener"
588
- class="nav-link"
589
- >
590
- <i class="nav-icon bi bi-github"></i>
591
- <p>
592
- GitHub
593
- <i class="bi bi-box-arrow-up-right ms-1" aria-hidden="true"></i>
594
- </p>
595
- </a>
596
- </li>
597
- </ul>
598
- <!--end::Sidebar Menu-->
599
-
600
- <!-- Back to preview CTA (bottom of sidebar) -->
601
- <div class="p-3 mt-3 border-top border-secondary border-opacity-25">
602
- <a
603
- href="../../index.html"
604
- class="btn btn-sm btn-outline-light w-100 d-flex align-items-center justify-content-center gap-2"
605
- >
606
- <i class="bi bi-arrow-left" aria-hidden="true"></i>
607
- Back to live preview
608
- </a>
609
- </div>
610
- </nav>
611
- </div>
612
- <!--end::Sidebar Wrapper-->
613
- </aside>
614
- <!--end::Sidebar (docs mode)-->
615
- <!--begin::App Main-->
616
- <main class="app-main">
617
- <!--begin::App Content Header-->
618
- <div class="app-content-header">
619
- <!--begin::Container-->
620
- <div class="container-fluid">
621
- <!--begin::Row-->
622
- <div class="row">
623
- <div class="col-sm-6">
624
- <h3 class="mb-0">Accessibility Module</h3>
625
- </div>
626
- <div class="col-sm-6">
627
- <ol class="breadcrumb float-sm-end">
628
- <li class="breadcrumb-item"><a href="#">Docs</a></li>
629
- <li class="breadcrumb-item active" aria-current="page">Accessibility Module</li>
630
- </ol>
631
- </div>
632
- </div>
633
- <!--end::Row-->
634
- </div>
635
- <!--end::Container-->
636
- </div>
637
- <!--end::App Content Header-->
638
- <!--begin::App Content-->
639
- <div class="app-content">
640
- <!--begin::Container-->
641
- <div class="container-fluid">
642
- <div class="row">
643
- <div class="col-12">
644
- <div class="card">
645
- <div class="card-body">
646
- <p>
647
- The Accessibility module provides WCAG 2.1 AA compliance features that are
648
- automatically initialized when AdminLTE loads.
649
- </p>
650
- <h5 id="features">Features</h5>
651
-
652
- <table>
653
- <thead>
654
- <tr>
655
- <th>Feature</th>
656
- <th>WCAG Criterion</th>
657
- <th>Description</th>
658
- </tr>
659
- </thead>
660
- <tbody>
661
- <tr>
662
- <td>Skip Links</td>
663
- <td>2.4.1 Bypass Blocks</td>
664
- <td>Adds “Skip to main content” and “Skip to navigation” links.</td>
665
- </tr>
666
- <tr>
667
- <td>Focus Management</td>
668
- <td>2.4.3 &amp; 2.4.7</td>
669
- <td>Tab cycling, focus trapping in modals, and focus restoration.</td>
670
- </tr>
671
- <tr>
672
- <td>Keyboard Navigation</td>
673
- <td>2.1.1 Keyboard</td>
674
- <td>Arrow key navigation in menus, Enter/Space for custom buttons.</td>
675
- </tr>
676
- <tr>
677
- <td>Reduced Motion</td>
678
- <td>2.3.3 Animation</td>
679
- <td>
680
- Respects <code>prefers-reduced-motion</code> by disabling animations.
681
- </td>
682
- </tr>
683
- <tr>
684
- <td>Live Announcements</td>
685
- <td>4.1.3 Status Messages</td>
686
- <td>Announces errors and success messages to screen readers.</td>
687
- </tr>
688
- <tr>
689
- <td>Error Identification</td>
690
- <td>3.3.1 &amp; 3.3.2</td>
691
- <td>Auto-labels unlabelled inputs, announces form validation errors.</td>
692
- </tr>
693
- <tr>
694
- <td>Table Accessibility</td>
695
- <td>1.3.1 Info &amp; Relationships</td>
696
- <td>
697
- Adds <code>scope</code> attributes to table headers automatically.
698
- </td>
699
- </tr>
700
- </tbody>
701
- </table>
702
- <h5 id="configuration">Configuration</h5>
703
- <p>
704
- The module is initialized in <code>adminlte.ts</code> with all features
705
- enabled by default:
706
- </p>
707
- <pre
708
- class="astro-code dark-plus"
709
- style="background-color: #1e1e1e; color: #d4d4d4; overflow-x: auto"
710
- tabindex="0"
711
- data-language="js"
712
- ><code><span class="line"><span style="color:#DCDCAA">initAccessibility</span><span style="color:#D4D4D4">({</span></span>
713
- <span class="line"><span style="color:#9CDCFE"> announcements:</span><span style="color:#569CD6"> true</span><span style="color:#D4D4D4">,</span></span>
714
- <span class="line"><span style="color:#9CDCFE"> skipLinks:</span><span style="color:#569CD6"> true</span><span style="color:#D4D4D4">,</span></span>
715
- <span class="line"><span style="color:#9CDCFE"> focusManagement:</span><span style="color:#569CD6"> true</span><span style="color:#D4D4D4">,</span></span>
716
- <span class="line"><span style="color:#9CDCFE"> keyboardNavigation:</span><span style="color:#569CD6"> true</span><span style="color:#D4D4D4">,</span></span>
717
- <span class="line"><span style="color:#9CDCFE"> reducedMotion:</span><span style="color:#569CD6"> true</span></span>
718
- <span class="line"><span style="color:#D4D4D4">})</span></span></code></pre>
719
- <p>Set any option to <code>false</code> to disable that feature.</p>
720
- <h5 id="public-api">Public API</h5>
721
- <pre
722
- class="astro-code dark-plus"
723
- style="background-color: #1e1e1e; color: #d4d4d4; overflow-x: auto"
724
- tabindex="0"
725
- data-language="js"
726
- ><code><span class="line"><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> { </span><span style="color:#9CDCFE">initAccessibility</span><span style="color:#D4D4D4"> } </span><span style="color:#C586C0">from</span><span style="color:#CE9178"> &#39;admin-lte&#39;</span></span>
727
- <span class="line"></span>
728
- <span class="line"><span style="color:#569CD6">const</span><span style="color:#4FC1FF"> a11y</span><span style="color:#D4D4D4"> = </span><span style="color:#DCDCAA">initAccessibility</span><span style="color:#D4D4D4">()</span></span>
729
- <span class="line"></span>
730
- <span class="line"><span style="color:#6A9955">// Announce a message to screen readers</span></span>
731
- <span class="line"><span style="color:#9CDCFE">a11y</span><span style="color:#D4D4D4">.</span><span style="color:#DCDCAA">announce</span><span style="color:#D4D4D4">(</span><span style="color:#CE9178">&#39;Item saved successfully&#39;</span><span style="color:#D4D4D4">, </span><span style="color:#CE9178">&#39;polite&#39;</span><span style="color:#D4D4D4">)</span></span>
732
- <span class="line"><span style="color:#9CDCFE">a11y</span><span style="color:#D4D4D4">.</span><span style="color:#DCDCAA">announce</span><span style="color:#D4D4D4">(</span><span style="color:#CE9178">&#39;Form has errors&#39;</span><span style="color:#D4D4D4">, </span><span style="color:#CE9178">&#39;assertive&#39;</span><span style="color:#D4D4D4">)</span></span>
733
- <span class="line"></span>
734
- <span class="line"><span style="color:#6A9955">// Focus a specific element</span></span>
735
- <span class="line"><span style="color:#9CDCFE">a11y</span><span style="color:#D4D4D4">.</span><span style="color:#DCDCAA">focusElement</span><span style="color:#D4D4D4">(</span><span style="color:#CE9178">&#39;#my-input&#39;</span><span style="color:#D4D4D4">)</span></span>
736
- <span class="line"></span>
737
- <span class="line"><span style="color:#6A9955">// Trap focus inside a container (useful for custom modals/dialogs)</span></span>
738
- <span class="line"><span style="color:#9CDCFE">a11y</span><span style="color:#D4D4D4">.</span><span style="color:#DCDCAA">trapFocus</span><span style="color:#D4D4D4">(</span><span style="color:#9CDCFE">document</span><span style="color:#D4D4D4">.</span><span style="color:#DCDCAA">querySelector</span><span style="color:#D4D4D4">(</span><span style="color:#CE9178">&#39;.my-dialog&#39;</span><span style="color:#D4D4D4">))</span></span>
739
- <span class="line"></span>
740
- <span class="line"><span style="color:#6A9955">// Add semantic landmarks to the page</span></span>
741
- <span class="line"><span style="color:#9CDCFE">a11y</span><span style="color:#D4D4D4">.</span><span style="color:#DCDCAA">addLandmarks</span><span style="color:#D4D4D4">()</span></span></code></pre>
742
- <h5 id="utility-functions">Utility Functions</h5>
743
- <pre
744
- class="astro-code dark-plus"
745
- style="background-color: #1e1e1e; color: #d4d4d4; overflow-x: auto"
746
- tabindex="0"
747
- data-language="js"
748
- ><code><span class="line"><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> { </span><span style="color:#9CDCFE">accessibilityUtils</span><span style="color:#D4D4D4"> } </span><span style="color:#C586C0">from</span><span style="color:#CE9178"> &#39;admin-lte&#39;</span></span>
749
- <span class="line"></span>
750
- <span class="line"><span style="color:#6A9955">// Check color contrast ratio (WCAG 1.4.3)</span></span>
751
- <span class="line"><span style="color:#569CD6">const</span><span style="color:#4FC1FF"> result</span><span style="color:#D4D4D4"> = </span><span style="color:#9CDCFE">accessibilityUtils</span><span style="color:#D4D4D4">.</span><span style="color:#DCDCAA">checkColorContrast</span><span style="color:#D4D4D4">(</span><span style="color:#CE9178">&#39;rgb(0,0,0)&#39;</span><span style="color:#D4D4D4">, </span><span style="color:#CE9178">&#39;rgb(255,255,255)&#39;</span><span style="color:#D4D4D4">)</span></span>
752
- <span class="line"><span style="color:#6A9955">// { ratio: 21, passes: true }</span></span>
753
- <span class="line"></span>
754
- <span class="line"><span style="color:#6A9955">// Check if an element is focusable</span></span>
755
- <span class="line"><span style="color:#9CDCFE">accessibilityUtils</span><span style="color:#D4D4D4">.</span><span style="color:#DCDCAA">isFocusable</span><span style="color:#D4D4D4">(</span><span style="color:#9CDCFE">element</span><span style="color:#D4D4D4">)</span></span>
756
- <span class="line"></span>
757
- <span class="line"><span style="color:#6A9955">// Generate a unique ID for ARIA attributes</span></span>
758
- <span class="line"><span style="color:#9CDCFE">accessibilityUtils</span><span style="color:#D4D4D4">.</span><span style="color:#DCDCAA">generateId</span><span style="color:#D4D4D4">(</span><span style="color:#CE9178">&#39;modal&#39;</span><span style="color:#D4D4D4">) </span><span style="color:#6A9955">// &quot;modal-x7k2m9p4q&quot;</span></span></code></pre>
759
- <h5 id="css-classes">CSS Classes</h5>
760
-
761
- <table>
762
- <thead>
763
- <tr>
764
- <th>Class</th>
765
- <th>Description</th>
766
- </tr>
767
- </thead>
768
- <tbody>
769
- <tr>
770
- <td><code>skip-links</code></td>
771
- <td>Container for skip navigation links.</td>
772
- </tr>
773
- <tr>
774
- <td><code>skip-link</code></td>
775
- <td>Individual skip link, visible only on focus.</td>
776
- </tr>
777
- <tr>
778
- <td><code>reduce-motion</code></td>
779
- <td>
780
- Added to <code>&lt;body&gt;</code> when user prefers reduced motion.
781
- </td>
782
- </tr>
783
- <tr>
784
- <td><code>sr-only</code></td>
785
- <td>Screen reader only content (visually hidden).</td>
786
- </tr>
787
- <tr>
788
- <td><code>live-region</code></td>
789
- <td>ARIA live region for dynamic announcements.</td>
790
- </tr>
791
- </tbody>
792
- </table>
793
- <h5 id="notes">Notes</h5>
794
- <ul>
795
- <li>
796
- The module integrates with Bootstrap’s modal and dropdown events for focus
797
- management.
798
- </li>
799
- <li>
800
- Modal Escape key handling is deferred to Bootstrap to respect
801
- <code>keyboard: false</code> and stacked modals.
802
- </li>
803
- <li>
804
- Form validation announcements work automatically for any input with HTML5
805
- validation attributes.
806
- </li>
807
- </ul>
808
- </div>
809
- </div>
810
- </div>
811
- </div>
812
- </div>
813
- <!--end::Container-->
814
- </div>
815
- <!--end::App Content-->
816
- </main>
817
- <!--end::App Main-->
818
- <!--begin::Footer-->
819
- <footer class="app-footer">
820
- <!--begin::To the end-->
821
- <div class="float-end d-none d-sm-inline">Anything you want</div>
822
- <!--end::To the end-->
823
- <!--begin::Copyright-->
824
- <strong>
825
- Copyright &copy; 2014-2026&nbsp;
826
- <a href="https://adminlte.io" class="text-decoration-none">AdminLTE.io</a>.
827
- </strong>
828
- All rights reserved.
829
- <!--end::Copyright-->
830
- </footer>
831
- <!--end::Footer-->
832
- </div>
833
- <!--end::App Wrapper-->
834
- <!--begin::Script-->
835
- <!--begin::Third Party Plugin(OverlayScrollbars)-->
836
- <script
837
- src="https://cdn.jsdelivr.net/npm/overlayscrollbars@2.11.0/browser/overlayscrollbars.browser.es6.min.js"
838
- crossorigin="anonymous"
839
- ></script>
840
- <!--end::Third Party Plugin(OverlayScrollbars)--><!--begin::Required Plugin(popperjs for Bootstrap 5)-->
841
- <script
842
- src="https://cdn.jsdelivr.net/npm/@popperjs/core@2.11.8/dist/umd/popper.min.js"
843
- crossorigin="anonymous"
844
- ></script>
845
- <!--end::Required Plugin(popperjs for Bootstrap 5)--><!--begin::Required Plugin(Bootstrap 5)-->
846
- <script
847
- src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.7/dist/js/bootstrap.min.js"
848
- crossorigin="anonymous"
849
- ></script>
850
- <!--end::Required Plugin(Bootstrap 5)--><!--begin::Required Plugin(AdminLTE)-->
851
- <script src="../../js/adminlte.js"></script>
852
- <!--end::Required Plugin(AdminLTE)--><!--begin::OverlayScrollbars Configure-->
853
- <script>
854
- const SELECTOR_SIDEBAR_WRAPPER = '.sidebar-wrapper';
855
- const Default = {
856
- scrollbarTheme: 'os-theme-light',
857
- scrollbarAutoHide: 'leave',
858
- scrollbarClickScroll: true,
859
- };
860
- document.addEventListener('DOMContentLoaded', function () {
861
- const sidebarWrapper = document.querySelector(SELECTOR_SIDEBAR_WRAPPER);
862
-
863
- // Disable OverlayScrollbars on mobile devices to prevent touch interference
864
- const isMobile = window.innerWidth <= 992;
865
-
866
- if (
867
- sidebarWrapper &&
868
- OverlayScrollbarsGlobal?.OverlayScrollbars !== undefined &&
869
- !isMobile
870
- ) {
871
- OverlayScrollbarsGlobal.OverlayScrollbars(sidebarWrapper, {
872
- scrollbars: {
873
- theme: Default.scrollbarTheme,
874
- autoHide: Default.scrollbarAutoHide,
875
- clickScroll: Default.scrollbarClickScroll,
876
- },
877
- });
878
- }
879
- });
880
- </script>
881
- <!--end::OverlayScrollbars Configure--><!--begin::Color Mode Toggle (#6010)-->
882
- <script>
883
- (() => {
884
- 'use strict';
885
-
886
- const STORAGE_KEY = 'lte-theme';
887
-
888
- const getStoredTheme = () => localStorage.getItem(STORAGE_KEY);
889
- const setStoredTheme = (theme) => localStorage.setItem(STORAGE_KEY, theme);
890
-
891
- const prefersDark = () => globalThis.matchMedia('(prefers-color-scheme: dark)').matches;
892
-
893
- const getPreferredTheme = () => {
894
- const stored = getStoredTheme();
895
- if (stored) return stored;
896
- return prefersDark() ? 'dark' : 'light';
897
- };
898
-
899
- const setTheme = (theme) => {
900
- const resolved = theme === 'auto' ? (prefersDark() ? 'dark' : 'light') : theme;
901
- document.documentElement.setAttribute('data-bs-theme', resolved);
902
- };
903
-
904
- setTheme(getPreferredTheme());
905
-
906
- const showActiveTheme = (theme) => {
907
- // Highlight the active dropdown option
908
- document.querySelectorAll('[data-bs-theme-value]').forEach((el) => {
909
- el.classList.remove('active');
910
- el.setAttribute('aria-pressed', 'false');
911
- const check = el.querySelector('.bi-check-lg');
912
- if (check) check.classList.add('d-none');
913
- });
914
- const active = document.querySelector(`[data-bs-theme-value="${theme}"]`);
915
- if (active) {
916
- active.classList.add('active');
917
- active.setAttribute('aria-pressed', 'true');
918
- const check = active.querySelector('.bi-check-lg');
919
- if (check) check.classList.remove('d-none');
920
- }
921
- // Sync the topbar trigger icon
922
- document.querySelectorAll('[data-lte-theme-icon]').forEach((icon) => {
923
- icon.classList.toggle('d-none', icon.dataset.lteThemeIcon !== theme);
924
- });
925
- };
926
-
927
- globalThis.matchMedia('(prefers-color-scheme: dark)').addEventListener('change', () => {
928
- const stored = getStoredTheme();
929
- if (!stored || stored === 'auto') setTheme(getPreferredTheme());
930
- });
931
-
932
- document.addEventListener('DOMContentLoaded', () => {
933
- showActiveTheme(getPreferredTheme());
934
- document.querySelectorAll('[data-bs-theme-value]').forEach((toggle) => {
935
- toggle.addEventListener('click', () => {
936
- const theme = toggle.getAttribute('data-bs-theme-value');
937
- setStoredTheme(theme);
938
- setTheme(theme);
939
- showActiveTheme(theme);
940
- });
941
- });
942
- });
943
- })();
944
- </script>
945
- <!--end::Color Mode Toggle-->
946
- <!--end::Script-->
947
- </body>
948
- <!--end::Body-->
949
- </html>