admin-lte 4.0.0-rc7 → 4.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (102) hide show
  1. package/CHANGELOG.md +48 -0
  2. package/README.md +43 -17
  3. package/dist/UI/general.html +303 -126
  4. package/dist/UI/icons.html +303 -126
  5. package/dist/UI/timeline.html +303 -126
  6. package/dist/css/adminlte.css +2798 -1167
  7. package/dist/css/adminlte.css.map +1 -1
  8. package/dist/css/adminlte.min.css +2 -2
  9. package/dist/css/adminlte.min.css.map +1 -1
  10. package/dist/css/adminlte.rtl.css +2798 -1167
  11. package/dist/css/adminlte.rtl.css.map +1 -1
  12. package/dist/css/adminlte.rtl.min.css +2 -2
  13. package/dist/css/adminlte.rtl.min.css.map +1 -1
  14. package/dist/docs/browser-support.html +261 -397
  15. package/dist/docs/color-mode.html +242 -382
  16. package/dist/docs/components/main-header.html +238 -374
  17. package/dist/docs/components/main-sidebar.html +253 -389
  18. package/dist/docs/customization.html +1056 -0
  19. package/dist/docs/deployment.html +1121 -0
  20. package/dist/docs/faq.html +857 -409
  21. package/dist/docs/getting-started.html +967 -0
  22. package/dist/docs/how-to-contribute.html +335 -462
  23. package/dist/docs/index.html +16 -0
  24. package/dist/docs/integrations.html +1207 -0
  25. package/dist/docs/introduction.html +453 -446
  26. package/dist/docs/javascript/accessibility.html +361 -491
  27. package/dist/docs/javascript/card-widget.html +446 -450
  28. package/dist/docs/javascript/direct-chat.html +324 -421
  29. package/dist/docs/javascript/fullscreen.html +348 -416
  30. package/dist/docs/javascript/layout.html +345 -436
  31. package/dist/docs/javascript/plugins-overview.html +1120 -0
  32. package/dist/docs/javascript/pushmenu.html +485 -492
  33. package/dist/docs/javascript/treeview.html +466 -400
  34. package/dist/docs/layout-blueprint.html +1063 -0
  35. package/dist/docs/layout.html +287 -415
  36. package/dist/docs/license.html +252 -387
  37. package/dist/docs/migration.html +1125 -0
  38. package/dist/docs/recipes.html +1161 -0
  39. package/dist/docs/rtl.html +933 -0
  40. package/dist/examples/lockscreen.html +65 -1
  41. package/dist/examples/login-v2.html +65 -1
  42. package/dist/examples/login.html +65 -1
  43. package/dist/examples/register-v2.html +65 -1
  44. package/dist/examples/register.html +65 -1
  45. package/dist/forms/{general.html → elements.html} +489 -463
  46. package/dist/forms/layout.html +1243 -0
  47. package/dist/forms/validation.html +1251 -0
  48. package/dist/forms/wizard.html +1386 -0
  49. package/dist/generate/theme.html +134 -4
  50. package/dist/index.html +303 -126
  51. package/dist/index2.html +306 -126
  52. package/dist/index3.html +303 -126
  53. package/dist/js/adminlte.js +5 -5
  54. package/dist/js/adminlte.js.map +1 -1
  55. package/dist/js/adminlte.min.js +2 -2
  56. package/dist/js/adminlte.min.js.map +1 -1
  57. package/dist/layout/collapsed-sidebar-without-hover.html +303 -126
  58. package/dist/layout/collapsed-sidebar.html +303 -126
  59. package/dist/layout/fixed-complete.html +303 -126
  60. package/dist/layout/fixed-footer.html +303 -126
  61. package/dist/layout/fixed-header.html +303 -126
  62. package/dist/layout/fixed-sidebar.html +303 -126
  63. package/dist/layout/layout-custom-area.html +303 -126
  64. package/dist/layout/layout-rtl.html +303 -126
  65. package/dist/layout/logo-switch.html +134 -4
  66. package/dist/layout/sidebar-mini.html +303 -126
  67. package/dist/layout/unfixed-sidebar.html +303 -126
  68. package/dist/mailbox/compose.html +1127 -0
  69. package/dist/mailbox/inbox.html +1477 -0
  70. package/dist/mailbox/read.html +1178 -0
  71. package/dist/pages/404.html +213 -0
  72. package/dist/pages/500.html +201 -0
  73. package/dist/pages/calendar.html +1242 -0
  74. package/dist/pages/chat.html +1403 -0
  75. package/dist/pages/faq.html +1359 -0
  76. package/dist/pages/file-manager.html +1811 -0
  77. package/dist/pages/invoice.html +1175 -0
  78. package/dist/pages/kanban.html +1415 -0
  79. package/dist/pages/maintenance.html +204 -0
  80. package/dist/pages/pricing.html +1255 -0
  81. package/dist/pages/profile.html +1358 -0
  82. package/dist/pages/projects.html +1620 -0
  83. package/dist/pages/settings.html +1363 -0
  84. package/dist/tables/data.html +1295 -0
  85. package/dist/tables/simple.html +303 -126
  86. package/dist/widgets/cards.html +303 -126
  87. package/dist/widgets/info-box.html +303 -126
  88. package/dist/widgets/small-box.html +303 -126
  89. package/netlify.toml +16 -0
  90. package/package.json +29 -23
  91. package/src/scss/_app-header.scss +27 -0
  92. package/src/scss/_app-sidebar.scss +24 -30
  93. package/src/scss/_bootstrap-variables.scss +11 -4
  94. package/src/scss/_docs.scss +816 -0
  95. package/src/scss/_table.scss +4 -4
  96. package/src/scss/adminlte.scss +4 -1
  97. package/src/ts/adminlte.ts +1 -1
  98. package/src/ts/fullscreen.ts +8 -4
  99. package/src/ts/push-menu.ts +66 -5
  100. package/.claude/settings.local.json +0 -37
  101. package/CLAUDE.md +0 -79
  102. package/release.md +0 -75
@@ -0,0 +1,1120 @@
1
+ <!doctype html>
2
+ <html lang="en">
3
+ <head>
4
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
5
+ <title>JavaScript Plugins Overview | AdminLTE 4</title>
6
+
7
+ <!--begin::Accessibility Meta Tags-->
8
+ <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes" />
9
+ <meta name="color-scheme" content="light dark" />
10
+ <meta name="theme-color" content="#007bff" media="(prefers-color-scheme: light)" />
11
+ <meta name="theme-color" content="#1a1a1a" media="(prefers-color-scheme: dark)" />
12
+ <!--end::Accessibility Meta Tags-->
13
+
14
+ <!--begin::Primary Meta Tags-->
15
+ <meta name="title" content="JavaScript Plugins Overview | AdminLTE 4" />
16
+ <meta name="author" content="ColorlibHQ" />
17
+ <meta
18
+ name="description"
19
+ content="AdminLTE is a Free Bootstrap 5 Admin Dashboard, 30 example pages using Vanilla JS. Fully accessible with WCAG 2.1 AA compliance."
20
+ />
21
+ <meta
22
+ name="keywords"
23
+ 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"
24
+ />
25
+ <!--end::Primary Meta Tags-->
26
+
27
+ <!--begin::Accessibility Features-->
28
+ <!-- Skip links will be dynamically added by accessibility.js -->
29
+ <meta name="supported-color-schemes" content="light dark" />
30
+ <link rel="preload" href="../../css/adminlte.css" as="style" />
31
+ <!--end::Accessibility Features-->
32
+
33
+ <!--begin::Fonts-->
34
+ <link
35
+ rel="stylesheet"
36
+ href="https://cdn.jsdelivr.net/npm/@fontsource/source-sans-3@5.0.12/index.css"
37
+ integrity="sha256-tXJfXfp6Ewt1ilPzLDtQnJV4hclT9XuaZUKyUvmyr+Q="
38
+ crossorigin="anonymous"
39
+ media="print"
40
+ onload="this.media = 'all'"
41
+ />
42
+ <!--end::Fonts-->
43
+
44
+ <!--begin::Third Party Plugin(OverlayScrollbars)-->
45
+ <link
46
+ rel="stylesheet"
47
+ href="https://cdn.jsdelivr.net/npm/overlayscrollbars@2.11.0/styles/overlayscrollbars.min.css"
48
+ crossorigin="anonymous"
49
+ />
50
+ <!--end::Third Party Plugin(OverlayScrollbars)-->
51
+
52
+ <!--begin::Third Party Plugin(Bootstrap Icons)-->
53
+ <link
54
+ rel="stylesheet"
55
+ href="https://cdn.jsdelivr.net/npm/bootstrap-icons@1.13.1/font/bootstrap-icons.min.css"
56
+ crossorigin="anonymous"
57
+ />
58
+ <!--end::Third Party Plugin(Bootstrap Icons)-->
59
+
60
+ <!--begin::Required Plugin(AdminLTE)-->
61
+ <link rel="stylesheet" href="../../css/adminlte.css" />
62
+ <!--end::Required Plugin(AdminLTE)-->
63
+ </head>
64
+ <body class="layout-fixed sidebar-expand-lg bg-body-tertiary docs-page">
65
+ <div class="app-wrapper">
66
+ <!--begin::Header-->
67
+ <nav class="app-header navbar navbar-expand bg-body">
68
+ <!--begin::Container-->
69
+ <div class="container-fluid">
70
+ <!--begin::Start Navbar Links-->
71
+ <ul class="navbar-nav">
72
+ <li class="nav-item">
73
+ <a class="nav-link" data-lte-toggle="sidebar" href="#" role="button">
74
+ <i class="bi bi-list"></i>
75
+ </a>
76
+ </li>
77
+
78
+ <li class="nav-item d-none d-md-block">
79
+ <a href="../../docs/introduction.html" class="nav-link">
80
+ <i class="bi bi-book me-1" aria-hidden="true"></i>
81
+ Documentation
82
+ </a>
83
+ </li>
84
+ <li class="nav-item d-none d-md-block">
85
+ <a href="../../index.html" class="nav-link">
86
+ <i class="bi bi-arrow-left me-1" aria-hidden="true"></i>
87
+ Back to live preview
88
+ </a>
89
+ </li>
90
+ </ul>
91
+ <!--end::Start Navbar Links-->
92
+
93
+ <!--begin::End Navbar Links-->
94
+ <ul class="navbar-nav ms-auto">
95
+ <!--begin::Navbar Search-->
96
+ <li class="nav-item">
97
+ <a class="nav-link" data-widget="navbar-search" href="#" role="button">
98
+ <i class="bi bi-search"></i>
99
+ </a>
100
+ </li>
101
+ <!--end::Navbar Search-->
102
+
103
+ <!--begin::Messages Dropdown Menu-->
104
+ <li class="nav-item dropdown">
105
+ <a class="nav-link" data-bs-toggle="dropdown" href="#">
106
+ <i class="bi bi-chat-text"></i>
107
+ <span class="navbar-badge badge text-bg-danger">3</span>
108
+ </a>
109
+ <div class="dropdown-menu dropdown-menu-lg dropdown-menu-end">
110
+ <a href="#" class="dropdown-item">
111
+ <!--begin::Message-->
112
+ <div class="d-flex">
113
+ <div class="flex-shrink-0">
114
+ <img
115
+ src="../../assets/img/user1-128x128.jpg"
116
+ alt="User Avatar"
117
+ class="img-size-50 rounded-circle me-3"
118
+ />
119
+ </div>
120
+ <div class="flex-grow-1">
121
+ <h3 class="dropdown-item-title">
122
+ Brad Diesel
123
+ <span class="float-end fs-7 text-danger"
124
+ ><i class="bi bi-star-fill"></i
125
+ ></span>
126
+ </h3>
127
+ <p class="fs-7">Call me whenever you can...</p>
128
+ <p class="fs-7 text-secondary">
129
+ <i class="bi bi-clock-fill me-1"></i> 4 Hours Ago
130
+ </p>
131
+ </div>
132
+ </div>
133
+ <!--end::Message-->
134
+ </a>
135
+ <div class="dropdown-divider"></div>
136
+ <a href="#" class="dropdown-item">
137
+ <!--begin::Message-->
138
+ <div class="d-flex">
139
+ <div class="flex-shrink-0">
140
+ <img
141
+ src="../../assets/img/user8-128x128.jpg"
142
+ alt="User Avatar"
143
+ class="img-size-50 rounded-circle me-3"
144
+ />
145
+ </div>
146
+ <div class="flex-grow-1">
147
+ <h3 class="dropdown-item-title">
148
+ John Pierce
149
+ <span class="float-end fs-7 text-secondary">
150
+ <i class="bi bi-star-fill"></i>
151
+ </span>
152
+ </h3>
153
+ <p class="fs-7">I got your message bro</p>
154
+ <p class="fs-7 text-secondary">
155
+ <i class="bi bi-clock-fill me-1"></i> 4 Hours Ago
156
+ </p>
157
+ </div>
158
+ </div>
159
+ <!--end::Message-->
160
+ </a>
161
+ <div class="dropdown-divider"></div>
162
+ <a href="#" class="dropdown-item">
163
+ <!--begin::Message-->
164
+ <div class="d-flex">
165
+ <div class="flex-shrink-0">
166
+ <img
167
+ src="../../assets/img/user3-128x128.jpg"
168
+ alt="User Avatar"
169
+ class="img-size-50 rounded-circle me-3"
170
+ />
171
+ </div>
172
+ <div class="flex-grow-1">
173
+ <h3 class="dropdown-item-title">
174
+ Nora Silvester
175
+ <span class="float-end fs-7 text-warning">
176
+ <i class="bi bi-star-fill"></i>
177
+ </span>
178
+ </h3>
179
+ <p class="fs-7">The subject goes here</p>
180
+ <p class="fs-7 text-secondary">
181
+ <i class="bi bi-clock-fill me-1"></i> 4 Hours Ago
182
+ </p>
183
+ </div>
184
+ </div>
185
+ <!--end::Message-->
186
+ </a>
187
+ <div class="dropdown-divider"></div>
188
+ <a href="#" class="dropdown-item dropdown-footer">See All Messages</a>
189
+ </div>
190
+ </li>
191
+ <!--end::Messages Dropdown Menu-->
192
+
193
+ <!--begin::Notifications Dropdown Menu-->
194
+ <li class="nav-item dropdown">
195
+ <a class="nav-link" data-bs-toggle="dropdown" href="#">
196
+ <i class="bi bi-bell-fill"></i>
197
+ <span class="navbar-badge badge text-bg-warning">15</span>
198
+ </a>
199
+ <div class="dropdown-menu dropdown-menu-lg dropdown-menu-end">
200
+ <span class="dropdown-item dropdown-header">15 Notifications</span>
201
+ <div class="dropdown-divider"></div>
202
+ <a href="#" class="dropdown-item">
203
+ <i class="bi bi-envelope me-2"></i> 4 new messages
204
+ <span class="float-end text-secondary fs-7">3 mins</span>
205
+ </a>
206
+ <div class="dropdown-divider"></div>
207
+ <a href="#" class="dropdown-item">
208
+ <i class="bi bi-people-fill me-2"></i> 8 friend requests
209
+ <span class="float-end text-secondary fs-7">12 hours</span>
210
+ </a>
211
+ <div class="dropdown-divider"></div>
212
+ <a href="#" class="dropdown-item">
213
+ <i class="bi bi-file-earmark-fill me-2"></i> 3 new reports
214
+ <span class="float-end text-secondary fs-7">2 days</span>
215
+ </a>
216
+ <div class="dropdown-divider"></div>
217
+ <a href="#" class="dropdown-item dropdown-footer"> See All Notifications </a>
218
+ </div>
219
+ </li>
220
+ <!--end::Notifications Dropdown Menu-->
221
+
222
+ <!--begin::Fullscreen Toggle-->
223
+ <li class="nav-item">
224
+ <a class="nav-link" href="#" data-lte-toggle="fullscreen">
225
+ <i data-lte-icon="maximize" class="bi bi-arrows-fullscreen"></i>
226
+ <i data-lte-icon="minimize" class="bi bi-fullscreen-exit d-none"></i>
227
+ </a>
228
+ </li>
229
+ <!--end::Fullscreen Toggle-->
230
+
231
+ <!--begin::Color Mode Toggle (#6010)-->
232
+ <li class="nav-item dropdown">
233
+ <a
234
+ class="nav-link"
235
+ href="#"
236
+ id="bd-theme"
237
+ aria-label="Toggle color scheme"
238
+ data-bs-toggle="dropdown"
239
+ aria-expanded="false"
240
+ >
241
+ <i class="bi bi-sun-fill" data-lte-theme-icon="light"></i>
242
+ <i class="bi bi-moon-fill d-none" data-lte-theme-icon="dark"></i>
243
+ <i class="bi bi-circle-half d-none" data-lte-theme-icon="auto"></i>
244
+ </a>
245
+ <ul
246
+ class="dropdown-menu dropdown-menu-end"
247
+ aria-labelledby="bd-theme"
248
+ style="--bs-dropdown-min-width: 8rem"
249
+ >
250
+ <li>
251
+ <button
252
+ type="button"
253
+ class="dropdown-item d-flex align-items-center"
254
+ data-bs-theme-value="light"
255
+ aria-pressed="false"
256
+ >
257
+ <i class="bi bi-sun-fill me-2"></i>
258
+ Light
259
+ <i class="bi bi-check-lg ms-auto d-none"></i>
260
+ </button>
261
+ </li>
262
+ <li>
263
+ <button
264
+ type="button"
265
+ class="dropdown-item d-flex align-items-center"
266
+ data-bs-theme-value="dark"
267
+ aria-pressed="false"
268
+ >
269
+ <i class="bi bi-moon-fill me-2"></i>
270
+ Dark
271
+ <i class="bi bi-check-lg ms-auto d-none"></i>
272
+ </button>
273
+ </li>
274
+ <li>
275
+ <button
276
+ type="button"
277
+ class="dropdown-item d-flex align-items-center active"
278
+ data-bs-theme-value="auto"
279
+ aria-pressed="true"
280
+ >
281
+ <i class="bi bi-circle-half me-2"></i>
282
+ Auto
283
+ <i class="bi bi-check-lg ms-auto d-none"></i>
284
+ </button>
285
+ </li>
286
+ </ul>
287
+ </li>
288
+ <!--end::Color Mode Toggle-->
289
+
290
+ <!--begin::User Menu Dropdown-->
291
+ <li class="nav-item dropdown user-menu">
292
+ <a href="#" class="nav-link dropdown-toggle" data-bs-toggle="dropdown">
293
+ <img
294
+ src="../../assets/img/user2-160x160.jpg"
295
+ class="user-image rounded-circle shadow"
296
+ alt="User Image"
297
+ />
298
+ <span class="d-none d-md-inline">Alexander Pierce</span>
299
+ </a>
300
+ <ul class="dropdown-menu dropdown-menu-lg dropdown-menu-end">
301
+ <!--begin::User Image-->
302
+ <li class="user-header text-bg-primary">
303
+ <img
304
+ src="../../assets/img/user2-160x160.jpg"
305
+ class="rounded-circle shadow"
306
+ alt="User Image"
307
+ />
308
+ <p>
309
+ Alexander Pierce - Web Developer
310
+ <small>Member since Nov. 2023</small>
311
+ </p>
312
+ </li>
313
+ <!--end::User Image-->
314
+ <!--begin::Menu Body-->
315
+ <li class="user-body">
316
+ <!--begin::Row-->
317
+ <div class="row">
318
+ <div class="col-4 text-center">
319
+ <a href="#">Followers</a>
320
+ </div>
321
+ <div class="col-4 text-center">
322
+ <a href="#">Sales</a>
323
+ </div>
324
+ <div class="col-4 text-center">
325
+ <a href="#">Friends</a>
326
+ </div>
327
+ </div>
328
+ <!--end::Row-->
329
+ </li>
330
+ <!--end::Menu Body-->
331
+ <!--begin::Menu Footer-->
332
+ <li class="user-footer">
333
+ <a href="#" class="btn btn-outline-secondary">Profile</a>
334
+ <a href="#" class="btn btn-outline-danger float-end">Sign out</a>
335
+ </li>
336
+ <!--end::Menu Footer-->
337
+ </ul>
338
+ </li>
339
+ <!--end::User Menu Dropdown-->
340
+ </ul>
341
+ <!--end::End Navbar Links-->
342
+ </div>
343
+ <!--end::Container-->
344
+ </nav>
345
+ <!--end::Header-->
346
+ <!--begin::Sidebar (docs mode)-->
347
+ <aside class="app-sidebar bg-body-secondary shadow" data-bs-theme="dark">
348
+ <!--begin::Sidebar Brand-->
349
+ <div class="sidebar-brand">
350
+ <a href="../../docs/introduction.html" class="brand-link">
351
+ <img
352
+ src="../../assets/img/AdminLTELogo.png"
353
+ alt="AdminLTE Logo"
354
+ class="brand-image opacity-75 shadow"
355
+ />
356
+ <span class="brand-text fw-light">
357
+ AdminLTE 4 <span class="opacity-75">&middot; Docs</span>
358
+ </span>
359
+ </a>
360
+ </div>
361
+ <!--end::Sidebar Brand-->
362
+ <!--begin::Sidebar Wrapper-->
363
+ <div class="sidebar-wrapper">
364
+ <nav class="mt-2">
365
+ <!--begin::Sidebar Menu-->
366
+ <ul
367
+ class="nav sidebar-menu flex-column"
368
+ data-lte-toggle="treeview"
369
+ role="navigation"
370
+ aria-label="Documentation navigation"
371
+ data-accordion="false"
372
+ id="docs-navigation"
373
+ >
374
+ <li class="nav-header">START HERE</li>
375
+ <li class="nav-item">
376
+ <a href="../../docs/introduction.html" class="nav-link">
377
+ <i class="nav-icon bi bi-download"></i>
378
+ <p>Installation</p>
379
+ </a>
380
+ </li>
381
+ <li class="nav-item">
382
+ <a href="../../docs/getting-started.html" class="nav-link">
383
+ <i class="nav-icon bi bi-rocket-takeoff"></i>
384
+ <p>Getting Started</p>
385
+ </a>
386
+ </li>
387
+
388
+ <li class="nav-header">FOUNDATIONS</li>
389
+ <li class="nav-item">
390
+ <a href="../../docs/layout.html" class="nav-link">
391
+ <i class="nav-icon bi bi-grip-horizontal"></i>
392
+ <p>Layout Classes</p>
393
+ </a>
394
+ </li>
395
+ <li class="nav-item">
396
+ <a href="../../docs/layout-blueprint.html" class="nav-link">
397
+ <i class="nav-icon bi bi-diagram-3"></i>
398
+ <p>Layout Blueprint</p>
399
+ </a>
400
+ </li>
401
+ <li class="nav-item">
402
+ <a href="../../docs/customization.html" class="nav-link">
403
+ <i class="nav-icon bi bi-palette"></i>
404
+ <p>Customization</p>
405
+ </a>
406
+ </li>
407
+ <li class="nav-item">
408
+ <a href="../../docs/color-mode.html" class="nav-link">
409
+ <i class="nav-icon bi bi-star-half"></i>
410
+ <p>Color Mode</p>
411
+ </a>
412
+ </li>
413
+ <li class="nav-item">
414
+ <a href="../../docs/rtl.html" class="nav-link">
415
+ <i class="nav-icon bi bi-text-paragraph"></i>
416
+ <p>RTL Support</p>
417
+ </a>
418
+ </li>
419
+
420
+ <li class="nav-header">BUILDING</li>
421
+ <li class="nav-item">
422
+ <a href="../../docs/recipes.html" class="nav-link">
423
+ <i class="nav-icon bi bi-clipboard-check"></i>
424
+ <p>Recipes</p>
425
+ </a>
426
+ </li>
427
+ <li class="nav-item">
428
+ <a href="#" class="nav-link">
429
+ <i class="nav-icon bi bi-ui-checks-grid"></i>
430
+ <p>
431
+ Components
432
+ <i class="nav-arrow bi bi-chevron-right"></i>
433
+ </p>
434
+ </a>
435
+ <ul class="nav nav-treeview">
436
+ <li class="nav-item">
437
+ <a href="../../docs/components/main-header.html" class="nav-link">
438
+ <i class="nav-icon bi bi-circle"></i>
439
+ <p>Main Header</p>
440
+ </a>
441
+ </li>
442
+ <li class="nav-item">
443
+ <a href="../../docs/components/main-sidebar.html" class="nav-link">
444
+ <i class="nav-icon bi bi-circle"></i>
445
+ <p>Main Sidebar</p>
446
+ </a>
447
+ </li>
448
+ </ul>
449
+ </li>
450
+ <li class="nav-item menu-open">
451
+ <a href="#" class="nav-link active">
452
+ <i class="nav-icon bi bi-filetype-js"></i>
453
+ <p>
454
+ JavaScript Plugins
455
+ <i class="nav-arrow bi bi-chevron-right"></i>
456
+ </p>
457
+ </a>
458
+ <ul class="nav nav-treeview">
459
+ <li class="nav-item">
460
+ <a href="../../docs/javascript/plugins-overview.html" class="nav-link active">
461
+ <i class="nav-icon bi bi-circle"></i>
462
+ <p>Overview</p>
463
+ </a>
464
+ </li>
465
+ <li class="nav-item">
466
+ <a href="../../docs/javascript/layout.html" class="nav-link">
467
+ <i class="nav-icon bi bi-circle"></i>
468
+ <p>Layout</p>
469
+ </a>
470
+ </li>
471
+ <li class="nav-item">
472
+ <a href="../../docs/javascript/pushmenu.html" class="nav-link">
473
+ <i class="nav-icon bi bi-circle"></i>
474
+ <p>PushMenu</p>
475
+ </a>
476
+ </li>
477
+ <li class="nav-item">
478
+ <a href="../../docs/javascript/treeview.html" class="nav-link">
479
+ <i class="nav-icon bi bi-circle"></i>
480
+ <p>Treeview</p>
481
+ </a>
482
+ </li>
483
+ <li class="nav-item">
484
+ <a href="../../docs/javascript/card-widget.html" class="nav-link">
485
+ <i class="nav-icon bi bi-circle"></i>
486
+ <p>Card Widget</p>
487
+ </a>
488
+ </li>
489
+ <li class="nav-item">
490
+ <a href="../../docs/javascript/direct-chat.html" class="nav-link">
491
+ <i class="nav-icon bi bi-circle"></i>
492
+ <p>Direct Chat</p>
493
+ </a>
494
+ </li>
495
+ <li class="nav-item">
496
+ <a href="../../docs/javascript/fullscreen.html" class="nav-link">
497
+ <i class="nav-icon bi bi-circle"></i>
498
+ <p>Fullscreen</p>
499
+ </a>
500
+ </li>
501
+ <li class="nav-item">
502
+ <a href="../../docs/javascript/accessibility.html" class="nav-link">
503
+ <i class="nav-icon bi bi-circle"></i>
504
+ <p>Accessibility</p>
505
+ </a>
506
+ </li>
507
+ </ul>
508
+ </li>
509
+ <li class="nav-item">
510
+ <a href="../../docs/integrations.html" class="nav-link">
511
+ <i class="nav-icon bi bi-puzzle"></i>
512
+ <p>Integrations</p>
513
+ </a>
514
+ </li>
515
+
516
+ <li class="nav-header">SHIPPING</li>
517
+ <li class="nav-item">
518
+ <a href="../../docs/migration.html" class="nav-link">
519
+ <i class="nav-icon bi bi-arrow-up-right-square"></i>
520
+ <p>Migration from v3</p>
521
+ </a>
522
+ </li>
523
+ <li class="nav-item">
524
+ <a href="../../docs/deployment.html" class="nav-link">
525
+ <i class="nav-icon bi bi-cloud-upload"></i>
526
+ <p>Deployment</p>
527
+ </a>
528
+ </li>
529
+ <li class="nav-item">
530
+ <a href="../../docs/browser-support.html" class="nav-link">
531
+ <i class="nav-icon bi bi-browser-chrome"></i>
532
+ <p>Browser Support</p>
533
+ </a>
534
+ </li>
535
+
536
+ <li class="nav-header">RESOURCES</li>
537
+ <li class="nav-item">
538
+ <a href="../../docs/faq.html" class="nav-link">
539
+ <i class="nav-icon bi bi-question-circle"></i>
540
+ <p>FAQ</p>
541
+ </a>
542
+ </li>
543
+ <li class="nav-item">
544
+ <a href="../../docs/how-to-contribute.html" class="nav-link">
545
+ <i class="nav-icon bi bi-people"></i>
546
+ <p>Contributing</p>
547
+ </a>
548
+ </li>
549
+ <li class="nav-item">
550
+ <a href="../../docs/license.html" class="nav-link">
551
+ <i class="nav-icon bi bi-patch-check"></i>
552
+ <p>License</p>
553
+ </a>
554
+ </li>
555
+ <li class="nav-item">
556
+ <a
557
+ href="https://github.com/ColorlibHQ/AdminLTE"
558
+ target="_blank"
559
+ rel="noopener"
560
+ class="nav-link"
561
+ >
562
+ <i class="nav-icon bi bi-github"></i>
563
+ <p>
564
+ GitHub
565
+ <i class="bi bi-box-arrow-up-right ms-1" aria-hidden="true"></i>
566
+ </p>
567
+ </a>
568
+ </li>
569
+ </ul>
570
+ <!--end::Sidebar Menu-->
571
+
572
+ <!-- Back to preview CTA (bottom of sidebar) -->
573
+ <div class="p-3 mt-3 border-top border-secondary border-opacity-25">
574
+ <a
575
+ href="../../index.html"
576
+ class="btn btn-sm btn-outline-light w-100 d-flex align-items-center justify-content-center gap-2"
577
+ >
578
+ <i class="bi bi-arrow-left" aria-hidden="true"></i>
579
+ Back to live preview
580
+ </a>
581
+ </div>
582
+ </nav>
583
+ </div>
584
+ <!--end::Sidebar Wrapper-->
585
+ </aside>
586
+ <!--end::Sidebar (docs mode)-->
587
+ <main class="app-main">
588
+ <div class="app-content-header">
589
+ <div class="container-fluid">
590
+ <div class="row">
591
+ <div class="col-sm-6">
592
+ <h3 class="mb-0">JavaScript Plugins Overview</h3>
593
+ </div>
594
+ <div class="col-sm-6">
595
+ <ol class="breadcrumb float-sm-end">
596
+ <li class="breadcrumb-item"><a href="#">Docs</a></li>
597
+ <li class="breadcrumb-item"><a href="#">JavaScript</a></li>
598
+ <li class="breadcrumb-item active" aria-current="page">Overview</li>
599
+ </ol>
600
+ </div>
601
+ </div>
602
+ </div>
603
+ </div>
604
+ <div class="app-content">
605
+ <div class="container-fluid">
606
+ <div class="row">
607
+ <div class="col-12">
608
+ <div class="card">
609
+ <div class="card-body">
610
+ <p>
611
+ AdminLTE ships seven JavaScript plugins as a single bundle
612
+ (<code>adminlte.js</code>). Each one is exported from the package root, can be
613
+ triggered via <code>data-lte-*</code> attributes for declarative use, and
614
+ exposes a programmatic API for code-driven control.
615
+ </p>
616
+ <h5 id="at-a-glance">At a glance</h5>
617
+
618
+ <table>
619
+ <thead>
620
+ <tr>
621
+ <th>Plugin</th>
622
+ <th>Data API</th>
623
+ <th>Programmatic</th>
624
+ <th>Documentation</th>
625
+ </tr>
626
+ </thead>
627
+ <tbody>
628
+ <tr>
629
+ <td><strong>PushMenu</strong></td>
630
+ <td><code>data-lte-toggle=&quot;sidebar&quot;</code></td>
631
+ <td>
632
+ <code>.toggle()</code> / <code>.expand()</code> /
633
+ <code>.collapse()</code>
634
+ </td>
635
+ <td><a href="pushmenu.html">Reference</a></td>
636
+ </tr>
637
+ <tr>
638
+ <td><strong>Treeview</strong></td>
639
+ <td><code>data-lte-toggle=&quot;treeview&quot;</code> on parent menu</td>
640
+ <td>
641
+ <code>.toggle()</code> / <code>.open()</code> / <code>.close()</code>
642
+ </td>
643
+ <td><a href="treeview.html">Reference</a></td>
644
+ </tr>
645
+ <tr>
646
+ <td><strong>CardWidget</strong></td>
647
+ <td>
648
+ <code>data-lte-toggle=&quot;card-collapse&quot;</code>,
649
+ <code>card-remove</code>, <code>card-maximize</code>
650
+ </td>
651
+ <td>
652
+ <code>.toggle()</code> / <code>.collapse()</code> /
653
+ <code>.expand()</code> / <code>.remove()</code> /
654
+ <code>.maximize()</code> / <code>.minimize()</code> /
655
+ <code>.toggleMaximize()</code>
656
+ </td>
657
+ <td><a href="card-widget.html">Reference</a></td>
658
+ </tr>
659
+ <tr>
660
+ <td><strong>DirectChat</strong></td>
661
+ <td><code>data-lte-toggle=&quot;chat-pane&quot;</code></td>
662
+ <td><code>.toggle()</code></td>
663
+ <td><a href="direct-chat.html">Reference</a></td>
664
+ </tr>
665
+ <tr>
666
+ <td><strong>FullScreen</strong></td>
667
+ <td><code>data-lte-toggle=&quot;fullscreen&quot;</code></td>
668
+ <td>
669
+ <code>.toggleFullScreen()</code> / <code>.inFullScreen()</code> /
670
+ <code>.outFullscreen()</code>
671
+ </td>
672
+ <td><a href="fullscreen.html">Reference</a></td>
673
+ </tr>
674
+ <tr>
675
+ <td><strong>Layout</strong></td>
676
+ <td>(auto-applied to <code>&lt;body&gt;</code>)</td>
677
+ <td><code>.holdTransition(time)</code></td>
678
+ <td><a href="layout.html">Reference</a></td>
679
+ </tr>
680
+ <tr>
681
+ <td><strong>AccessibilityManager</strong></td>
682
+ <td>(helper function: <code>initAccessibility()</code>)</td>
683
+ <td>
684
+ <code>.announce()</code> / <code>.focusElement()</code> /
685
+ <code>.trapFocus()</code> / <code>.addLandmarks()</code>
686
+ </td>
687
+ <td><a href="accessibility.html">Reference</a></td>
688
+ </tr>
689
+ </tbody>
690
+ </table>
691
+ <h5 id="two-ways-to-use-them">Two ways to use them</h5>
692
+ <h6 id="1-data-api-declarative">1. Data API (declarative)</h6>
693
+ <p>
694
+ For most pages, the data API is enough — no JavaScript code required. Drop the
695
+ right <code>data-lte-*</code> attribute on the trigger element and the bundle
696
+ wires it up on page load:
697
+ </p>
698
+ <pre
699
+ class="astro-code dark-plus"
700
+ style="background-color: #1e1e1e; color: #d4d4d4; overflow-x: auto"
701
+ tabindex="0"
702
+ data-language="html"
703
+ ><code><span class="line"><span style="color:#6A9955">&lt;!-- Sidebar toggle --&gt;</span></span>
704
+ <span class="line"><span style="color:#808080">&lt;</span><span style="color:#569CD6">button</span><span style="color:#9CDCFE"> data-lte-toggle</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;sidebar&quot;</span><span style="color:#808080">&gt;</span><span style="color:#D4D4D4">☰</span><span style="color:#808080">&lt;/</span><span style="color:#569CD6">button</span><span style="color:#808080">&gt;</span></span>
705
+ <span class="line"></span>
706
+ <span class="line"><span style="color:#6A9955">&lt;!-- Card collapse / remove / maximize --&gt;</span></span>
707
+ <span class="line"><span style="color:#808080">&lt;</span><span style="color:#569CD6">div</span><span style="color:#9CDCFE"> class</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;card&quot;</span><span style="color:#808080">&gt;</span></span>
708
+ <span class="line"><span style="color:#808080"> &lt;</span><span style="color:#569CD6">div</span><span style="color:#9CDCFE"> class</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;card-header&quot;</span><span style="color:#808080">&gt;</span></span>
709
+ <span class="line"><span style="color:#808080"> &lt;</span><span style="color:#569CD6">h3</span><span style="color:#9CDCFE"> class</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;card-title&quot;</span><span style="color:#808080">&gt;</span><span style="color:#D4D4D4">Title</span><span style="color:#808080">&lt;/</span><span style="color:#569CD6">h3</span><span style="color:#808080">&gt;</span></span>
710
+ <span class="line"><span style="color:#808080"> &lt;</span><span style="color:#569CD6">div</span><span style="color:#9CDCFE"> class</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;card-tools&quot;</span><span style="color:#808080">&gt;</span></span>
711
+ <span class="line"><span style="color:#808080"> &lt;</span><span style="color:#569CD6">button</span><span style="color:#9CDCFE"> class</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;btn btn-tool&quot;</span><span style="color:#9CDCFE"> data-lte-toggle</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;card-collapse&quot;</span><span style="color:#808080">&gt;</span></span>
712
+ <span class="line"><span style="color:#808080"> &lt;</span><span style="color:#569CD6">i</span><span style="color:#9CDCFE"> data-lte-icon</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;expand&quot;</span><span style="color:#9CDCFE"> class</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;bi bi-dash-lg&quot;</span><span style="color:#808080">&gt;&lt;/</span><span style="color:#569CD6">i</span><span style="color:#808080">&gt;</span></span>
713
+ <span class="line"><span style="color:#808080"> &lt;</span><span style="color:#569CD6">i</span><span style="color:#9CDCFE"> data-lte-icon</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;collapse&quot;</span><span style="color:#9CDCFE"> class</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;bi bi-plus-lg&quot;</span><span style="color:#808080">&gt;&lt;/</span><span style="color:#569CD6">i</span><span style="color:#808080">&gt;</span></span>
714
+ <span class="line"><span style="color:#808080"> &lt;/</span><span style="color:#569CD6">button</span><span style="color:#808080">&gt;</span></span>
715
+ <span class="line"><span style="color:#808080"> &lt;/</span><span style="color:#569CD6">div</span><span style="color:#808080">&gt;</span></span>
716
+ <span class="line"><span style="color:#808080"> &lt;/</span><span style="color:#569CD6">div</span><span style="color:#808080">&gt;</span></span>
717
+ <span class="line"><span style="color:#808080"> &lt;</span><span style="color:#569CD6">div</span><span style="color:#9CDCFE"> class</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;card-body&quot;</span><span style="color:#808080">&gt;</span><span style="color:#D4D4D4">…</span><span style="color:#808080">&lt;/</span><span style="color:#569CD6">div</span><span style="color:#808080">&gt;</span></span>
718
+ <span class="line"><span style="color:#808080">&lt;/</span><span style="color:#569CD6">div</span><span style="color:#808080">&gt;</span></span></code></pre>
719
+ <p>
720
+ The bundle attaches all data-API listeners on <code>DOMContentLoaded</code>.
721
+ Dynamically-injected elements still work for the
722
+ <a href="pushmenu.html">PushMenu</a>,
723
+ <a href="card-widget.html">CardWidget</a>, and
724
+ <a href="treeview.html">Treeview</a> plugins, which use event delegation.
725
+ </p>
726
+ <h6 id="2-programmatic-imperative">2. Programmatic (imperative)</h6>
727
+ <p>
728
+ When you need to control a plugin from your own code — eg. open the sidebar
729
+ after a successful login, or expand a card on a route change — instantiate the
730
+ class directly:
731
+ </p>
732
+ <pre
733
+ class="astro-code dark-plus"
734
+ style="background-color: #1e1e1e; color: #d4d4d4; overflow-x: auto"
735
+ tabindex="0"
736
+ data-language="js"
737
+ ><code><span class="line"><span style="color:#6A9955">// ESM (bundler import)</span></span>
738
+ <span class="line"><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> { </span><span style="color:#9CDCFE">PushMenu</span><span style="color:#D4D4D4">, </span><span style="color:#9CDCFE">CardWidget</span><span style="color:#D4D4D4">, </span><span style="color:#9CDCFE">Treeview</span><span style="color:#D4D4D4"> } </span><span style="color:#C586C0">from</span><span style="color:#CE9178"> &quot;admin-lte&quot;</span></span>
739
+ <span class="line"></span>
740
+ <span class="line"><span style="color:#6A9955">// Sidebar</span></span>
741
+ <span class="line"><span style="color:#569CD6">new</span><span style="color:#DCDCAA"> PushMenu</span><span style="color:#D4D4D4">(</span><span style="color:#9CDCFE">document</span><span style="color:#D4D4D4">.</span><span style="color:#9CDCFE">body</span><span style="color:#D4D4D4">, {}).</span><span style="color:#DCDCAA">expand</span><span style="color:#D4D4D4">()</span></span>
742
+ <span class="line"></span>
743
+ <span class="line"><span style="color:#6A9955">// Card maximize</span></span>
744
+ <span class="line"><span style="color:#569CD6">const</span><span style="color:#4FC1FF"> card</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">&quot;#chart-card&quot;</span><span style="color:#D4D4D4">)</span></span>
745
+ <span class="line"><span style="color:#569CD6">new</span><span style="color:#DCDCAA"> CardWidget</span><span style="color:#D4D4D4">(</span><span style="color:#9CDCFE">card</span><span style="color:#D4D4D4">, {}).</span><span style="color:#DCDCAA">maximize</span><span style="color:#D4D4D4">()</span></span></code></pre>
746
+ <p>Or use the globals (UMD bundle, no build step):</p>
747
+ <pre
748
+ class="astro-code dark-plus"
749
+ style="background-color: #1e1e1e; color: #d4d4d4; overflow-x: auto"
750
+ tabindex="0"
751
+ data-language="html"
752
+ ><code><span class="line"><span style="color:#808080">&lt;</span><span style="color:#569CD6">script</span><span style="color:#808080">&gt;</span></span>
753
+ <span class="line"><span style="color:#6A9955"> // The bundle assigns to window.adminlte</span></span>
754
+ <span class="line"><span style="color:#569CD6"> new</span><span style="color:#9CDCFE"> adminlte</span><span style="color:#D4D4D4">.</span><span style="color:#DCDCAA">PushMenu</span><span style="color:#D4D4D4">(</span><span style="color:#9CDCFE">document</span><span style="color:#D4D4D4">.</span><span style="color:#9CDCFE">body</span><span style="color:#D4D4D4">, {}).</span><span style="color:#DCDCAA">expand</span><span style="color:#D4D4D4">()</span></span>
755
+ <span class="line"><span style="color:#808080">&lt;/</span><span style="color:#569CD6">script</span><span style="color:#808080">&gt;</span></span></code></pre>
756
+ <h5 id="listening-to-plugin-events">Listening to plugin events</h5>
757
+ <p>
758
+ Every plugin fires a <code>CustomEvent</code> or <code>Event</code> on the
759
+ element it operates on. Listen for these to coordinate with your own code:
760
+ </p>
761
+ <pre
762
+ class="astro-code dark-plus"
763
+ style="background-color: #1e1e1e; color: #d4d4d4; overflow-x: auto"
764
+ tabindex="0"
765
+ data-language="js"
766
+ ><code><span class="line"><span style="color:#9CDCFE">document</span><span style="color:#D4D4D4">.</span><span style="color:#DCDCAA">addEventListener</span><span style="color:#D4D4D4">(</span><span style="color:#CE9178">&quot;expanded.lte.card-widget&quot;</span><span style="color:#D4D4D4">, (</span><span style="color:#9CDCFE">e</span><span style="color:#D4D4D4">) </span><span style="color:#569CD6">=&gt;</span><span style="color:#D4D4D4"> {</span></span>
767
+ <span class="line"><span style="color:#9CDCFE"> console</span><span style="color:#D4D4D4">.</span><span style="color:#DCDCAA">log</span><span style="color:#D4D4D4">(</span><span style="color:#CE9178">&quot;Card expanded:&quot;</span><span style="color:#D4D4D4">, </span><span style="color:#9CDCFE">e</span><span style="color:#D4D4D4">.</span><span style="color:#9CDCFE">target</span><span style="color:#D4D4D4">)</span></span>
768
+ <span class="line"><span style="color:#D4D4D4">})</span></span>
769
+ <span class="line"></span>
770
+ <span class="line"><span style="color:#9CDCFE">document</span><span style="color:#D4D4D4">.</span><span style="color:#DCDCAA">addEventListener</span><span style="color:#D4D4D4">(</span><span style="color:#CE9178">&quot;open.lte.push-menu&quot;</span><span style="color:#D4D4D4">, () </span><span style="color:#569CD6">=&gt;</span><span style="color:#D4D4D4"> {</span></span>
771
+ <span class="line"><span style="color:#6A9955"> // user opened the sidebar — eg. analytics call</span></span>
772
+ <span class="line"><span style="color:#D4D4D4">})</span></span></code></pre>
773
+ <h6 id="event-name-reference">Event name reference</h6>
774
+
775
+ <table>
776
+ <thead>
777
+ <tr>
778
+ <th>Plugin</th>
779
+ <th>Event</th>
780
+ <th>Fired when</th>
781
+ </tr>
782
+ </thead>
783
+ <tbody>
784
+ <tr>
785
+ <td>PushMenu</td>
786
+ <td><code>open.lte.push-menu</code></td>
787
+ <td>Sidebar expanded</td>
788
+ </tr>
789
+ <tr>
790
+ <td>PushMenu</td>
791
+ <td><code>collapse.lte.push-menu</code></td>
792
+ <td>Sidebar collapsed</td>
793
+ </tr>
794
+ <tr>
795
+ <td>Treeview</td>
796
+ <td><code>expanded.lte.treeview</code></td>
797
+ <td>Submenu opened</td>
798
+ </tr>
799
+ <tr>
800
+ <td>Treeview</td>
801
+ <td><code>collapsed.lte.treeview</code></td>
802
+ <td>Submenu closed</td>
803
+ </tr>
804
+ <tr>
805
+ <td>Treeview</td>
806
+ <td><code>load.lte.treeview</code></td>
807
+ <td>Pre-opened submenu detected on page load</td>
808
+ </tr>
809
+ <tr>
810
+ <td>CardWidget</td>
811
+ <td><code>expanded.lte.card-widget</code></td>
812
+ <td>Card expanded</td>
813
+ </tr>
814
+ <tr>
815
+ <td>CardWidget</td>
816
+ <td><code>collapsed.lte.card-widget</code></td>
817
+ <td>Card collapsed</td>
818
+ </tr>
819
+ <tr>
820
+ <td>CardWidget</td>
821
+ <td><code>remove.lte.card-widget</code></td>
822
+ <td>Card removed</td>
823
+ </tr>
824
+ <tr>
825
+ <td>CardWidget</td>
826
+ <td><code>maximized.lte.card-widget</code></td>
827
+ <td>Card maximized</td>
828
+ </tr>
829
+ <tr>
830
+ <td>CardWidget</td>
831
+ <td><code>minimized.lte.card-widget</code></td>
832
+ <td>Card minimized</td>
833
+ </tr>
834
+ <tr>
835
+ <td>DirectChat</td>
836
+ <td><code>expanded.lte.direct-chat</code></td>
837
+ <td>Contacts pane opened</td>
838
+ </tr>
839
+ <tr>
840
+ <td>DirectChat</td>
841
+ <td><code>collapsed.lte.direct-chat</code></td>
842
+ <td>Contacts pane closed</td>
843
+ </tr>
844
+ <tr>
845
+ <td>FullScreen</td>
846
+ <td><code>maximized.lte.fullscreen</code></td>
847
+ <td>Entered fullscreen</td>
848
+ </tr>
849
+ <tr>
850
+ <td>FullScreen</td>
851
+ <td><code>minimized.lte.fullscreen</code></td>
852
+ <td>Exited fullscreen</td>
853
+ </tr>
854
+ </tbody>
855
+ </table>
856
+ <p>
857
+ All events bubble. Attach listeners to <code>document</code> or
858
+ <code>document.body</code> for global hooks, or to a specific card / sidebar
859
+ element for scoped listeners.
860
+ </p>
861
+ <h5 id="configuring-via-data-attributes">Configuring via data attributes</h5>
862
+ <p>
863
+ Some plugins read config from <code>data-*</code> attributes on their target
864
+ element:
865
+ </p>
866
+ <pre
867
+ class="astro-code dark-plus"
868
+ style="background-color: #1e1e1e; color: #d4d4d4; overflow-x: auto"
869
+ tabindex="0"
870
+ data-language="html"
871
+ ><code><span class="line"><span style="color:#6A9955">&lt;!-- Treeview — non-accordion (multiple submenus can be open at once) --&gt;</span></span>
872
+ <span class="line"><span style="color:#808080">&lt;</span><span style="color:#569CD6">ul</span><span style="color:#9CDCFE"> class</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;nav sidebar-menu&quot;</span><span style="color:#9CDCFE"> data-lte-toggle</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;treeview&quot;</span><span style="color:#9CDCFE"> data-accordion</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;false&quot;</span><span style="color:#808080">&gt;</span><span style="color:#D4D4D4">…</span><span style="color:#808080">&lt;/</span><span style="color:#569CD6">ul</span><span style="color:#808080">&gt;</span></span>
873
+ <span class="line"></span>
874
+ <span class="line"><span style="color:#6A9955">&lt;!-- Treeview — custom animation speed --&gt;</span></span>
875
+ <span class="line"><span style="color:#808080">&lt;</span><span style="color:#569CD6">ul</span><span style="color:#9CDCFE"> class</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;nav sidebar-menu&quot;</span><span style="color:#9CDCFE"> data-lte-toggle</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;treeview&quot;</span><span style="color:#9CDCFE"> data-animation-speed</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;500&quot;</span><span style="color:#808080">&gt;</span><span style="color:#D4D4D4">…</span><span style="color:#808080">&lt;/</span><span style="color:#569CD6">ul</span><span style="color:#808080">&gt;</span></span>
876
+ <span class="line"></span>
877
+ <span class="line"><span style="color:#6A9955">&lt;!-- Sidebar — opt into localStorage persistence (default: off) --&gt;</span></span>
878
+ <span class="line"><span style="color:#808080">&lt;</span><span style="color:#569CD6">aside</span><span style="color:#9CDCFE"> class</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;app-sidebar&quot;</span><span style="color:#9CDCFE"> data-enable-persistence</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;true&quot;</span><span style="color:#808080">&gt;</span><span style="color:#D4D4D4">…</span><span style="color:#808080">&lt;/</span><span style="color:#569CD6">aside</span><span style="color:#808080">&gt;</span></span>
879
+ <span class="line"></span>
880
+ <span class="line"><span style="color:#6A9955">&lt;!-- Sidebar — override the mobile breakpoint --&gt;</span></span>
881
+ <span class="line"><span style="color:#808080">&lt;</span><span style="color:#569CD6">aside</span><span style="color:#9CDCFE"> class</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;app-sidebar&quot;</span><span style="color:#9CDCFE"> data-sidebar-breakpoint</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;768&quot;</span><span style="color:#808080">&gt;</span><span style="color:#D4D4D4">…</span><span style="color:#808080">&lt;/</span><span style="color:#569CD6">aside</span><span style="color:#808080">&gt;</span></span></code></pre>
882
+ <p>Each plugin’s reference page documents which attributes it supports.</p>
883
+ <h5 id="css-classes-the-plugins-manage">CSS classes the plugins manage</h5>
884
+ <p>
885
+ The plugins toggle a small set of CSS classes that you can also style or react
886
+ to:
887
+ </p>
888
+
889
+ <table>
890
+ <thead>
891
+ <tr>
892
+ <th>Class</th>
893
+ <th>Set by</th>
894
+ <th>Where</th>
895
+ <th>Meaning</th>
896
+ </tr>
897
+ </thead>
898
+ <tbody>
899
+ <tr>
900
+ <td><code>sidebar-collapse</code></td>
901
+ <td>PushMenu</td>
902
+ <td><code>&lt;body&gt;</code></td>
903
+ <td>Sidebar collapsed (desktop mini state, or mobile-closed)</td>
904
+ </tr>
905
+ <tr>
906
+ <td><code>sidebar-open</code></td>
907
+ <td>PushMenu</td>
908
+ <td><code>&lt;body&gt;</code></td>
909
+ <td>Mobile sidebar explicitly opened by user</td>
910
+ </tr>
911
+ <tr>
912
+ <td><code>sidebar-mini</code></td>
913
+ <td>PushMenu</td>
914
+ <td><code>&lt;body&gt;</code></td>
915
+ <td>Mini-sidebar mode active</td>
916
+ </tr>
917
+ <tr>
918
+ <td><code>menu-open</code></td>
919
+ <td>Treeview</td>
920
+ <td><code>.nav-item</code></td>
921
+ <td>Submenu is currently expanded</td>
922
+ </tr>
923
+ <tr>
924
+ <td><code>collapsed-card</code></td>
925
+ <td>CardWidget</td>
926
+ <td><code>.card</code></td>
927
+ <td>Card body/footer are collapsed</td>
928
+ </tr>
929
+ <tr>
930
+ <td><code>maximized-card</code></td>
931
+ <td>CardWidget</td>
932
+ <td><code>&lt;html&gt;</code> and <code>.card</code></td>
933
+ <td>Card is in fullscreen mode</td>
934
+ </tr>
935
+ <tr>
936
+ <td><code>direct-chat-contacts-open</code></td>
937
+ <td>DirectChat</td>
938
+ <td><code>.direct-chat</code></td>
939
+ <td>Contacts pane visible</td>
940
+ </tr>
941
+ <tr>
942
+ <td><code>hold-transition</code></td>
943
+ <td>Layout</td>
944
+ <td><code>&lt;body&gt;</code></td>
945
+ <td>Transitions disabled briefly (during resize, etc.)</td>
946
+ </tr>
947
+ <tr>
948
+ <td><code>app-loaded</code></td>
949
+ <td>Layout</td>
950
+ <td><code>&lt;body&gt;</code></td>
951
+ <td>Initial page-load animation finished</td>
952
+ </tr>
953
+ <tr>
954
+ <td><code>reduce-motion</code></td>
955
+ <td>AccessibilityManager</td>
956
+ <td><code>&lt;body&gt;</code></td>
957
+ <td>OS <code>prefers-reduced-motion</code> detected</td>
958
+ </tr>
959
+ </tbody>
960
+ </table>
961
+ <h5 id="production-vs-source">Production vs source</h5>
962
+ <p>
963
+ The plugins live in
964
+ <a href="https://github.com/ColorlibHQ/master/src/ts"><code>src/ts/</code></a>
965
+ as TypeScript modules. The published <code>dist/js/adminlte.js</code> is a
966
+ Rollup bundle of all seven, exporting them under a single
967
+ <code>adminlte</code> namespace (UMD) or named imports (ESM).
968
+ </p>
969
+ <p>
970
+ If you only need one or two plugins and care about bundle size, importing
971
+ individual modules from <code>node_modules/admin-lte/src/ts/</code> will
972
+ tree-shake — but you’ll need TypeScript in your toolchain.
973
+ </p>
974
+ <h5 id="where-to-next">Where to next</h5>
975
+ <ul>
976
+ <li>Detailed reference for each plugin (links in the table above)</li>
977
+ <li>
978
+ <a href="../layout-blueprint.html">Layout Blueprint</a> — the structural
979
+ classes the plugins operate on
980
+ </li>
981
+ <li>
982
+ <a href="accessibility.html">Accessibility</a> — keyboard navigation, focus
983
+ trapping, ARIA helpers
984
+ </li>
985
+ </ul>
986
+ </div>
987
+ </div>
988
+ </div>
989
+ </div>
990
+ </div>
991
+ </div>
992
+ </main>
993
+ <!--begin::Footer-->
994
+ <footer class="app-footer">
995
+ <!--begin::To the end-->
996
+ <div class="float-end d-none d-sm-inline">Anything you want</div>
997
+ <!--end::To the end-->
998
+ <!--begin::Copyright-->
999
+ <strong>
1000
+ Copyright &copy; 2014-2026&nbsp;
1001
+ <a href="https://adminlte.io" class="text-decoration-none">AdminLTE.io</a>.
1002
+ </strong>
1003
+ All rights reserved.
1004
+ <!--end::Copyright-->
1005
+ </footer>
1006
+ <!--end::Footer-->
1007
+ </div>
1008
+ <!--begin::Third Party Plugin(OverlayScrollbars)-->
1009
+ <script
1010
+ src="https://cdn.jsdelivr.net/npm/overlayscrollbars@2.11.0/browser/overlayscrollbars.browser.es6.min.js"
1011
+ crossorigin="anonymous"
1012
+ ></script>
1013
+ <!--end::Third Party Plugin(OverlayScrollbars)--><!--begin::Required Plugin(popperjs for Bootstrap 5)-->
1014
+ <script
1015
+ src="https://cdn.jsdelivr.net/npm/@popperjs/core@2.11.8/dist/umd/popper.min.js"
1016
+ crossorigin="anonymous"
1017
+ ></script>
1018
+ <!--end::Required Plugin(popperjs for Bootstrap 5)--><!--begin::Required Plugin(Bootstrap 5)-->
1019
+ <script
1020
+ src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.7/dist/js/bootstrap.min.js"
1021
+ crossorigin="anonymous"
1022
+ ></script>
1023
+ <!--end::Required Plugin(Bootstrap 5)--><!--begin::Required Plugin(AdminLTE)-->
1024
+ <script src="../../js/adminlte.js"></script>
1025
+ <!--end::Required Plugin(AdminLTE)--><!--begin::OverlayScrollbars Configure-->
1026
+ <script>
1027
+ const SELECTOR_SIDEBAR_WRAPPER = '.sidebar-wrapper';
1028
+ const Default = {
1029
+ scrollbarTheme: 'os-theme-light',
1030
+ scrollbarAutoHide: 'leave',
1031
+ scrollbarClickScroll: true,
1032
+ };
1033
+ document.addEventListener('DOMContentLoaded', function () {
1034
+ const sidebarWrapper = document.querySelector(SELECTOR_SIDEBAR_WRAPPER);
1035
+
1036
+ // Disable OverlayScrollbars on mobile devices to prevent touch interference
1037
+ const isMobile = window.innerWidth <= 992;
1038
+
1039
+ if (
1040
+ sidebarWrapper &&
1041
+ OverlayScrollbarsGlobal?.OverlayScrollbars !== undefined &&
1042
+ !isMobile
1043
+ ) {
1044
+ OverlayScrollbarsGlobal.OverlayScrollbars(sidebarWrapper, {
1045
+ scrollbars: {
1046
+ theme: Default.scrollbarTheme,
1047
+ autoHide: Default.scrollbarAutoHide,
1048
+ clickScroll: Default.scrollbarClickScroll,
1049
+ },
1050
+ });
1051
+ }
1052
+ });
1053
+ </script>
1054
+ <!--end::OverlayScrollbars Configure--><!--begin::Color Mode Toggle (#6010)-->
1055
+ <script>
1056
+ (() => {
1057
+ 'use strict';
1058
+
1059
+ const STORAGE_KEY = 'lte-theme';
1060
+
1061
+ const getStoredTheme = () => localStorage.getItem(STORAGE_KEY);
1062
+ const setStoredTheme = (theme) => localStorage.setItem(STORAGE_KEY, theme);
1063
+
1064
+ const prefersDark = () => globalThis.matchMedia('(prefers-color-scheme: dark)').matches;
1065
+
1066
+ const getPreferredTheme = () => {
1067
+ const stored = getStoredTheme();
1068
+ if (stored) return stored;
1069
+ return prefersDark() ? 'dark' : 'light';
1070
+ };
1071
+
1072
+ const setTheme = (theme) => {
1073
+ const resolved = theme === 'auto' ? (prefersDark() ? 'dark' : 'light') : theme;
1074
+ document.documentElement.setAttribute('data-bs-theme', resolved);
1075
+ };
1076
+
1077
+ setTheme(getPreferredTheme());
1078
+
1079
+ const showActiveTheme = (theme) => {
1080
+ // Highlight the active dropdown option
1081
+ document.querySelectorAll('[data-bs-theme-value]').forEach((el) => {
1082
+ el.classList.remove('active');
1083
+ el.setAttribute('aria-pressed', 'false');
1084
+ const check = el.querySelector('.bi-check-lg');
1085
+ if (check) check.classList.add('d-none');
1086
+ });
1087
+ const active = document.querySelector(`[data-bs-theme-value="${theme}"]`);
1088
+ if (active) {
1089
+ active.classList.add('active');
1090
+ active.setAttribute('aria-pressed', 'true');
1091
+ const check = active.querySelector('.bi-check-lg');
1092
+ if (check) check.classList.remove('d-none');
1093
+ }
1094
+ // Sync the topbar trigger icon
1095
+ document.querySelectorAll('[data-lte-theme-icon]').forEach((icon) => {
1096
+ icon.classList.toggle('d-none', icon.dataset.lteThemeIcon !== theme);
1097
+ });
1098
+ };
1099
+
1100
+ globalThis.matchMedia('(prefers-color-scheme: dark)').addEventListener('change', () => {
1101
+ const stored = getStoredTheme();
1102
+ if (!stored || stored === 'auto') setTheme(getPreferredTheme());
1103
+ });
1104
+
1105
+ document.addEventListener('DOMContentLoaded', () => {
1106
+ showActiveTheme(getPreferredTheme());
1107
+ document.querySelectorAll('[data-bs-theme-value]').forEach((toggle) => {
1108
+ toggle.addEventListener('click', () => {
1109
+ const theme = toggle.getAttribute('data-bs-theme-value');
1110
+ setStoredTheme(theme);
1111
+ setTheme(theme);
1112
+ showActiveTheme(theme);
1113
+ });
1114
+ });
1115
+ });
1116
+ })();
1117
+ </script>
1118
+ <!--end::Color Mode Toggle-->
1119
+ </body>
1120
+ </html>