admin-lte 4.0.0-rc6 → 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 (107) hide show
  1. package/CHANGELOG.md +96 -0
  2. package/README.md +44 -18
  3. package/dist/UI/general.html +311 -92
  4. package/dist/UI/icons.html +311 -92
  5. package/dist/UI/timeline.html +311 -92
  6. package/dist/css/adminlte.css +2814 -1138
  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 +2814 -1138
  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 +291 -385
  15. package/dist/docs/color-mode.html +283 -381
  16. package/dist/docs/components/main-header.html +269 -363
  17. package/dist/docs/components/main-sidebar.html +284 -378
  18. package/dist/docs/customization.html +1056 -0
  19. package/dist/docs/deployment.html +1121 -0
  20. package/dist/docs/faq.html +887 -397
  21. package/dist/docs/getting-started.html +967 -0
  22. package/dist/docs/how-to-contribute.html +365 -450
  23. package/dist/docs/index.html +16 -0
  24. package/dist/docs/integrations.html +1207 -0
  25. package/dist/docs/introduction.html +483 -434
  26. package/dist/docs/javascript/accessibility.html +925 -0
  27. package/dist/docs/javascript/card-widget.html +995 -0
  28. package/dist/docs/javascript/direct-chat.html +872 -0
  29. package/dist/docs/javascript/fullscreen.html +881 -0
  30. package/dist/docs/javascript/layout.html +884 -0
  31. package/dist/docs/javascript/plugins-overview.html +1120 -0
  32. package/dist/docs/javascript/pushmenu.html +522 -377
  33. package/dist/docs/javascript/treeview.html +498 -390
  34. package/dist/docs/layout-blueprint.html +1063 -0
  35. package/dist/docs/layout.html +316 -402
  36. package/dist/docs/license.html +282 -375
  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 +66 -2
  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/elements.html +1381 -0
  46. package/dist/forms/{general.html → layout.html} +382 -452
  47. package/dist/forms/validation.html +1251 -0
  48. package/dist/forms/wizard.html +1386 -0
  49. package/dist/generate/theme.html +135 -5
  50. package/dist/index.html +311 -92
  51. package/dist/index2.html +314 -92
  52. package/dist/index3.html +311 -92
  53. package/dist/js/adminlte.js +135 -314
  54. package/dist/js/adminlte.js.map +1 -1
  55. package/dist/js/adminlte.min.js +3 -3
  56. package/dist/js/adminlte.min.js.map +1 -1
  57. package/dist/layout/collapsed-sidebar-without-hover.html +1120 -0
  58. package/dist/layout/collapsed-sidebar.html +311 -92
  59. package/dist/layout/fixed-complete.html +311 -92
  60. package/dist/layout/fixed-footer.html +311 -92
  61. package/dist/layout/fixed-header.html +311 -92
  62. package/dist/layout/fixed-sidebar.html +311 -92
  63. package/dist/layout/layout-custom-area.html +311 -92
  64. package/dist/layout/layout-rtl.html +311 -92
  65. package/dist/layout/logo-switch.html +135 -5
  66. package/dist/layout/sidebar-mini.html +311 -92
  67. package/dist/layout/unfixed-sidebar.html +311 -92
  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 +311 -92
  86. package/dist/widgets/cards.html +311 -92
  87. package/dist/widgets/info-box.html +311 -92
  88. package/dist/widgets/small-box.html +311 -92
  89. package/netlify.toml +16 -0
  90. package/package.json +32 -26
  91. package/src/scss/_accessibility.scss +44 -0
  92. package/src/scss/_app-footer.scss +9 -0
  93. package/src/scss/_app-header.scss +27 -0
  94. package/src/scss/_app-sidebar.scss +73 -74
  95. package/src/scss/_bootstrap-variables.scss +12 -5
  96. package/src/scss/_docs.scss +816 -0
  97. package/src/scss/_table.scss +4 -4
  98. package/src/scss/adminlte.scss +4 -1
  99. package/src/scss/pages/_login_and_register.scss +1 -1
  100. package/src/ts/accessibility.ts +9 -7
  101. package/src/ts/adminlte.ts +2 -14
  102. package/src/ts/fullscreen.ts +8 -4
  103. package/src/ts/layout.ts +34 -16
  104. package/src/ts/push-menu.ts +257 -104
  105. package/src/ts/util/index.ts +10 -0
  106. package/.claude/settings.local.json +0 -33
  107. package/CLAUDE.md +0 -79
@@ -0,0 +1,884 @@
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>Layout Plugin | AdminLTE 4</title>
7
+
8
+ <!--begin::Accessibility Meta Tags-->
9
+ <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes" />
10
+ <meta name="color-scheme" content="light dark" />
11
+ <meta name="theme-color" content="#007bff" media="(prefers-color-scheme: light)" />
12
+ <meta name="theme-color" content="#1a1a1a" media="(prefers-color-scheme: dark)" />
13
+ <!--end::Accessibility Meta Tags-->
14
+
15
+ <!--begin::Primary Meta Tags-->
16
+ <meta name="title" content="Layout Plugin | AdminLTE 4" />
17
+ <meta name="author" content="ColorlibHQ" />
18
+ <meta
19
+ name="description"
20
+ content="AdminLTE is a Free Bootstrap 5 Admin Dashboard, 30 example pages using Vanilla JS. Fully accessible with WCAG 2.1 AA compliance."
21
+ />
22
+ <meta
23
+ name="keywords"
24
+ 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"
25
+ />
26
+ <!--end::Primary Meta Tags-->
27
+
28
+ <!--begin::Accessibility Features-->
29
+ <!-- Skip links will be dynamically added by accessibility.js -->
30
+ <meta name="supported-color-schemes" content="light dark" />
31
+ <link rel="preload" href="../../css/adminlte.css" as="style" />
32
+ <!--end::Accessibility Features-->
33
+
34
+ <!--begin::Fonts-->
35
+ <link
36
+ rel="stylesheet"
37
+ href="https://cdn.jsdelivr.net/npm/@fontsource/source-sans-3@5.0.12/index.css"
38
+ integrity="sha256-tXJfXfp6Ewt1ilPzLDtQnJV4hclT9XuaZUKyUvmyr+Q="
39
+ crossorigin="anonymous"
40
+ media="print"
41
+ onload="this.media = 'all'"
42
+ />
43
+ <!--end::Fonts-->
44
+
45
+ <!--begin::Third Party Plugin(OverlayScrollbars)-->
46
+ <link
47
+ rel="stylesheet"
48
+ href="https://cdn.jsdelivr.net/npm/overlayscrollbars@2.11.0/styles/overlayscrollbars.min.css"
49
+ crossorigin="anonymous"
50
+ />
51
+ <!--end::Third Party Plugin(OverlayScrollbars)-->
52
+
53
+ <!--begin::Third Party Plugin(Bootstrap Icons)-->
54
+ <link
55
+ rel="stylesheet"
56
+ href="https://cdn.jsdelivr.net/npm/bootstrap-icons@1.13.1/font/bootstrap-icons.min.css"
57
+ crossorigin="anonymous"
58
+ />
59
+ <!--end::Third Party Plugin(Bootstrap Icons)-->
60
+
61
+ <!--begin::Required Plugin(AdminLTE)-->
62
+ <link rel="stylesheet" href="../../css/adminlte.css" />
63
+ <!--end::Required Plugin(AdminLTE)-->
64
+ </head>
65
+ <!--end::Head-->
66
+ <!--begin::Body-->
67
+ <body class="layout-fixed sidebar-expand-lg bg-body-tertiary docs-page">
68
+ <!--begin::App Wrapper-->
69
+ <div class="app-wrapper">
70
+ <!--begin::Header-->
71
+ <nav class="app-header navbar navbar-expand bg-body">
72
+ <!--begin::Container-->
73
+ <div class="container-fluid">
74
+ <!--begin::Start Navbar Links-->
75
+ <ul class="navbar-nav">
76
+ <li class="nav-item">
77
+ <a class="nav-link" data-lte-toggle="sidebar" href="#" role="button">
78
+ <i class="bi bi-list"></i>
79
+ </a>
80
+ </li>
81
+
82
+ <li class="nav-item d-none d-md-block">
83
+ <a href="../../docs/introduction.html" class="nav-link">
84
+ <i class="bi bi-book me-1" aria-hidden="true"></i>
85
+ Documentation
86
+ </a>
87
+ </li>
88
+ <li class="nav-item d-none d-md-block">
89
+ <a href="../../index.html" class="nav-link">
90
+ <i class="bi bi-arrow-left me-1" aria-hidden="true"></i>
91
+ Back to live preview
92
+ </a>
93
+ </li>
94
+ </ul>
95
+ <!--end::Start Navbar Links-->
96
+
97
+ <!--begin::End Navbar Links-->
98
+ <ul class="navbar-nav ms-auto">
99
+ <!--begin::Navbar Search-->
100
+ <li class="nav-item">
101
+ <a class="nav-link" data-widget="navbar-search" href="#" role="button">
102
+ <i class="bi bi-search"></i>
103
+ </a>
104
+ </li>
105
+ <!--end::Navbar Search-->
106
+
107
+ <!--begin::Messages Dropdown Menu-->
108
+ <li class="nav-item dropdown">
109
+ <a class="nav-link" data-bs-toggle="dropdown" href="#">
110
+ <i class="bi bi-chat-text"></i>
111
+ <span class="navbar-badge badge text-bg-danger">3</span>
112
+ </a>
113
+ <div class="dropdown-menu dropdown-menu-lg dropdown-menu-end">
114
+ <a href="#" class="dropdown-item">
115
+ <!--begin::Message-->
116
+ <div class="d-flex">
117
+ <div class="flex-shrink-0">
118
+ <img
119
+ src="../../assets/img/user1-128x128.jpg"
120
+ alt="User Avatar"
121
+ class="img-size-50 rounded-circle me-3"
122
+ />
123
+ </div>
124
+ <div class="flex-grow-1">
125
+ <h3 class="dropdown-item-title">
126
+ Brad Diesel
127
+ <span class="float-end fs-7 text-danger"
128
+ ><i class="bi bi-star-fill"></i
129
+ ></span>
130
+ </h3>
131
+ <p class="fs-7">Call me whenever you can...</p>
132
+ <p class="fs-7 text-secondary">
133
+ <i class="bi bi-clock-fill me-1"></i> 4 Hours Ago
134
+ </p>
135
+ </div>
136
+ </div>
137
+ <!--end::Message-->
138
+ </a>
139
+ <div class="dropdown-divider"></div>
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/user8-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
+ John Pierce
153
+ <span class="float-end fs-7 text-secondary">
154
+ <i class="bi bi-star-fill"></i>
155
+ </span>
156
+ </h3>
157
+ <p class="fs-7">I got your message bro</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/user3-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
+ Nora Silvester
179
+ <span class="float-end fs-7 text-warning">
180
+ <i class="bi bi-star-fill"></i>
181
+ </span>
182
+ </h3>
183
+ <p class="fs-7">The subject goes here</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 dropdown-footer">See All Messages</a>
193
+ </div>
194
+ </li>
195
+ <!--end::Messages Dropdown Menu-->
196
+
197
+ <!--begin::Notifications Dropdown Menu-->
198
+ <li class="nav-item dropdown">
199
+ <a class="nav-link" data-bs-toggle="dropdown" href="#">
200
+ <i class="bi bi-bell-fill"></i>
201
+ <span class="navbar-badge badge text-bg-warning">15</span>
202
+ </a>
203
+ <div class="dropdown-menu dropdown-menu-lg dropdown-menu-end">
204
+ <span class="dropdown-item dropdown-header">15 Notifications</span>
205
+ <div class="dropdown-divider"></div>
206
+ <a href="#" class="dropdown-item">
207
+ <i class="bi bi-envelope me-2"></i> 4 new messages
208
+ <span class="float-end text-secondary fs-7">3 mins</span>
209
+ </a>
210
+ <div class="dropdown-divider"></div>
211
+ <a href="#" class="dropdown-item">
212
+ <i class="bi bi-people-fill me-2"></i> 8 friend requests
213
+ <span class="float-end text-secondary fs-7">12 hours</span>
214
+ </a>
215
+ <div class="dropdown-divider"></div>
216
+ <a href="#" class="dropdown-item">
217
+ <i class="bi bi-file-earmark-fill me-2"></i> 3 new reports
218
+ <span class="float-end text-secondary fs-7">2 days</span>
219
+ </a>
220
+ <div class="dropdown-divider"></div>
221
+ <a href="#" class="dropdown-item dropdown-footer"> See All Notifications </a>
222
+ </div>
223
+ </li>
224
+ <!--end::Notifications Dropdown Menu-->
225
+
226
+ <!--begin::Fullscreen Toggle-->
227
+ <li class="nav-item">
228
+ <a class="nav-link" href="#" data-lte-toggle="fullscreen">
229
+ <i data-lte-icon="maximize" class="bi bi-arrows-fullscreen"></i>
230
+ <i data-lte-icon="minimize" class="bi bi-fullscreen-exit d-none"></i>
231
+ </a>
232
+ </li>
233
+ <!--end::Fullscreen Toggle-->
234
+
235
+ <!--begin::Color Mode Toggle (#6010)-->
236
+ <li class="nav-item dropdown">
237
+ <a
238
+ class="nav-link"
239
+ href="#"
240
+ id="bd-theme"
241
+ aria-label="Toggle color scheme"
242
+ data-bs-toggle="dropdown"
243
+ aria-expanded="false"
244
+ >
245
+ <i class="bi bi-sun-fill" data-lte-theme-icon="light"></i>
246
+ <i class="bi bi-moon-fill d-none" data-lte-theme-icon="dark"></i>
247
+ <i class="bi bi-circle-half d-none" data-lte-theme-icon="auto"></i>
248
+ </a>
249
+ <ul
250
+ class="dropdown-menu dropdown-menu-end"
251
+ aria-labelledby="bd-theme"
252
+ style="--bs-dropdown-min-width: 8rem"
253
+ >
254
+ <li>
255
+ <button
256
+ type="button"
257
+ class="dropdown-item d-flex align-items-center"
258
+ data-bs-theme-value="light"
259
+ aria-pressed="false"
260
+ >
261
+ <i class="bi bi-sun-fill me-2"></i>
262
+ Light
263
+ <i class="bi bi-check-lg ms-auto d-none"></i>
264
+ </button>
265
+ </li>
266
+ <li>
267
+ <button
268
+ type="button"
269
+ class="dropdown-item d-flex align-items-center"
270
+ data-bs-theme-value="dark"
271
+ aria-pressed="false"
272
+ >
273
+ <i class="bi bi-moon-fill me-2"></i>
274
+ Dark
275
+ <i class="bi bi-check-lg ms-auto d-none"></i>
276
+ </button>
277
+ </li>
278
+ <li>
279
+ <button
280
+ type="button"
281
+ class="dropdown-item d-flex align-items-center active"
282
+ data-bs-theme-value="auto"
283
+ aria-pressed="true"
284
+ >
285
+ <i class="bi bi-circle-half me-2"></i>
286
+ Auto
287
+ <i class="bi bi-check-lg ms-auto d-none"></i>
288
+ </button>
289
+ </li>
290
+ </ul>
291
+ </li>
292
+ <!--end::Color Mode Toggle-->
293
+
294
+ <!--begin::User Menu Dropdown-->
295
+ <li class="nav-item dropdown user-menu">
296
+ <a href="#" class="nav-link dropdown-toggle" data-bs-toggle="dropdown">
297
+ <img
298
+ src="../../assets/img/user2-160x160.jpg"
299
+ class="user-image rounded-circle shadow"
300
+ alt="User Image"
301
+ />
302
+ <span class="d-none d-md-inline">Alexander Pierce</span>
303
+ </a>
304
+ <ul class="dropdown-menu dropdown-menu-lg dropdown-menu-end">
305
+ <!--begin::User Image-->
306
+ <li class="user-header text-bg-primary">
307
+ <img
308
+ src="../../assets/img/user2-160x160.jpg"
309
+ class="rounded-circle shadow"
310
+ alt="User Image"
311
+ />
312
+ <p>
313
+ Alexander Pierce - Web Developer
314
+ <small>Member since Nov. 2023</small>
315
+ </p>
316
+ </li>
317
+ <!--end::User Image-->
318
+ <!--begin::Menu Body-->
319
+ <li class="user-body">
320
+ <!--begin::Row-->
321
+ <div class="row">
322
+ <div class="col-4 text-center">
323
+ <a href="#">Followers</a>
324
+ </div>
325
+ <div class="col-4 text-center">
326
+ <a href="#">Sales</a>
327
+ </div>
328
+ <div class="col-4 text-center">
329
+ <a href="#">Friends</a>
330
+ </div>
331
+ </div>
332
+ <!--end::Row-->
333
+ </li>
334
+ <!--end::Menu Body-->
335
+ <!--begin::Menu Footer-->
336
+ <li class="user-footer">
337
+ <a href="#" class="btn btn-outline-secondary">Profile</a>
338
+ <a href="#" class="btn btn-outline-danger float-end">Sign out</a>
339
+ </li>
340
+ <!--end::Menu Footer-->
341
+ </ul>
342
+ </li>
343
+ <!--end::User Menu Dropdown-->
344
+ </ul>
345
+ <!--end::End Navbar Links-->
346
+ </div>
347
+ <!--end::Container-->
348
+ </nav>
349
+ <!--end::Header-->
350
+ <!--begin::Sidebar (docs mode)-->
351
+ <aside class="app-sidebar bg-body-secondary shadow" data-bs-theme="dark">
352
+ <!--begin::Sidebar Brand-->
353
+ <div class="sidebar-brand">
354
+ <a href="../../docs/introduction.html" class="brand-link">
355
+ <img
356
+ src="../../assets/img/AdminLTELogo.png"
357
+ alt="AdminLTE Logo"
358
+ class="brand-image opacity-75 shadow"
359
+ />
360
+ <span class="brand-text fw-light">
361
+ AdminLTE 4 <span class="opacity-75">&middot; Docs</span>
362
+ </span>
363
+ </a>
364
+ </div>
365
+ <!--end::Sidebar Brand-->
366
+ <!--begin::Sidebar Wrapper-->
367
+ <div class="sidebar-wrapper">
368
+ <nav class="mt-2">
369
+ <!--begin::Sidebar Menu-->
370
+ <ul
371
+ class="nav sidebar-menu flex-column"
372
+ data-lte-toggle="treeview"
373
+ role="navigation"
374
+ aria-label="Documentation navigation"
375
+ data-accordion="false"
376
+ id="docs-navigation"
377
+ >
378
+ <li class="nav-header">START HERE</li>
379
+ <li class="nav-item">
380
+ <a href="../../docs/introduction.html" class="nav-link">
381
+ <i class="nav-icon bi bi-download"></i>
382
+ <p>Installation</p>
383
+ </a>
384
+ </li>
385
+ <li class="nav-item">
386
+ <a href="../../docs/getting-started.html" class="nav-link">
387
+ <i class="nav-icon bi bi-rocket-takeoff"></i>
388
+ <p>Getting Started</p>
389
+ </a>
390
+ </li>
391
+
392
+ <li class="nav-header">FOUNDATIONS</li>
393
+ <li class="nav-item">
394
+ <a href="../../docs/layout.html" class="nav-link">
395
+ <i class="nav-icon bi bi-grip-horizontal"></i>
396
+ <p>Layout Classes</p>
397
+ </a>
398
+ </li>
399
+ <li class="nav-item">
400
+ <a href="../../docs/layout-blueprint.html" class="nav-link">
401
+ <i class="nav-icon bi bi-diagram-3"></i>
402
+ <p>Layout Blueprint</p>
403
+ </a>
404
+ </li>
405
+ <li class="nav-item">
406
+ <a href="../../docs/customization.html" class="nav-link">
407
+ <i class="nav-icon bi bi-palette"></i>
408
+ <p>Customization</p>
409
+ </a>
410
+ </li>
411
+ <li class="nav-item">
412
+ <a href="../../docs/color-mode.html" class="nav-link">
413
+ <i class="nav-icon bi bi-star-half"></i>
414
+ <p>Color Mode</p>
415
+ </a>
416
+ </li>
417
+ <li class="nav-item">
418
+ <a href="../../docs/rtl.html" class="nav-link">
419
+ <i class="nav-icon bi bi-text-paragraph"></i>
420
+ <p>RTL Support</p>
421
+ </a>
422
+ </li>
423
+
424
+ <li class="nav-header">BUILDING</li>
425
+ <li class="nav-item">
426
+ <a href="../../docs/recipes.html" class="nav-link">
427
+ <i class="nav-icon bi bi-clipboard-check"></i>
428
+ <p>Recipes</p>
429
+ </a>
430
+ </li>
431
+ <li class="nav-item">
432
+ <a href="#" class="nav-link">
433
+ <i class="nav-icon bi bi-ui-checks-grid"></i>
434
+ <p>
435
+ Components
436
+ <i class="nav-arrow bi bi-chevron-right"></i>
437
+ </p>
438
+ </a>
439
+ <ul class="nav nav-treeview">
440
+ <li class="nav-item">
441
+ <a href="../../docs/components/main-header.html" class="nav-link">
442
+ <i class="nav-icon bi bi-circle"></i>
443
+ <p>Main Header</p>
444
+ </a>
445
+ </li>
446
+ <li class="nav-item">
447
+ <a href="../../docs/components/main-sidebar.html" class="nav-link">
448
+ <i class="nav-icon bi bi-circle"></i>
449
+ <p>Main Sidebar</p>
450
+ </a>
451
+ </li>
452
+ </ul>
453
+ </li>
454
+ <li class="nav-item menu-open">
455
+ <a href="#" class="nav-link active">
456
+ <i class="nav-icon bi bi-filetype-js"></i>
457
+ <p>
458
+ JavaScript Plugins
459
+ <i class="nav-arrow bi bi-chevron-right"></i>
460
+ </p>
461
+ </a>
462
+ <ul class="nav nav-treeview">
463
+ <li class="nav-item">
464
+ <a href="../../docs/javascript/plugins-overview.html" class="nav-link">
465
+ <i class="nav-icon bi bi-circle"></i>
466
+ <p>Overview</p>
467
+ </a>
468
+ </li>
469
+ <li class="nav-item">
470
+ <a href="../../docs/javascript/layout.html" class="nav-link active">
471
+ <i class="nav-icon bi bi-circle"></i>
472
+ <p>Layout</p>
473
+ </a>
474
+ </li>
475
+ <li class="nav-item">
476
+ <a href="../../docs/javascript/pushmenu.html" class="nav-link">
477
+ <i class="nav-icon bi bi-circle"></i>
478
+ <p>PushMenu</p>
479
+ </a>
480
+ </li>
481
+ <li class="nav-item">
482
+ <a href="../../docs/javascript/treeview.html" class="nav-link">
483
+ <i class="nav-icon bi bi-circle"></i>
484
+ <p>Treeview</p>
485
+ </a>
486
+ </li>
487
+ <li class="nav-item">
488
+ <a href="../../docs/javascript/card-widget.html" class="nav-link">
489
+ <i class="nav-icon bi bi-circle"></i>
490
+ <p>Card Widget</p>
491
+ </a>
492
+ </li>
493
+ <li class="nav-item">
494
+ <a href="../../docs/javascript/direct-chat.html" class="nav-link">
495
+ <i class="nav-icon bi bi-circle"></i>
496
+ <p>Direct Chat</p>
497
+ </a>
498
+ </li>
499
+ <li class="nav-item">
500
+ <a href="../../docs/javascript/fullscreen.html" class="nav-link">
501
+ <i class="nav-icon bi bi-circle"></i>
502
+ <p>Fullscreen</p>
503
+ </a>
504
+ </li>
505
+ <li class="nav-item">
506
+ <a href="../../docs/javascript/accessibility.html" class="nav-link">
507
+ <i class="nav-icon bi bi-circle"></i>
508
+ <p>Accessibility</p>
509
+ </a>
510
+ </li>
511
+ </ul>
512
+ </li>
513
+ <li class="nav-item">
514
+ <a href="../../docs/integrations.html" class="nav-link">
515
+ <i class="nav-icon bi bi-puzzle"></i>
516
+ <p>Integrations</p>
517
+ </a>
518
+ </li>
519
+
520
+ <li class="nav-header">SHIPPING</li>
521
+ <li class="nav-item">
522
+ <a href="../../docs/migration.html" class="nav-link">
523
+ <i class="nav-icon bi bi-arrow-up-right-square"></i>
524
+ <p>Migration from v3</p>
525
+ </a>
526
+ </li>
527
+ <li class="nav-item">
528
+ <a href="../../docs/deployment.html" class="nav-link">
529
+ <i class="nav-icon bi bi-cloud-upload"></i>
530
+ <p>Deployment</p>
531
+ </a>
532
+ </li>
533
+ <li class="nav-item">
534
+ <a href="../../docs/browser-support.html" class="nav-link">
535
+ <i class="nav-icon bi bi-browser-chrome"></i>
536
+ <p>Browser Support</p>
537
+ </a>
538
+ </li>
539
+
540
+ <li class="nav-header">RESOURCES</li>
541
+ <li class="nav-item">
542
+ <a href="../../docs/faq.html" class="nav-link">
543
+ <i class="nav-icon bi bi-question-circle"></i>
544
+ <p>FAQ</p>
545
+ </a>
546
+ </li>
547
+ <li class="nav-item">
548
+ <a href="../../docs/how-to-contribute.html" class="nav-link">
549
+ <i class="nav-icon bi bi-people"></i>
550
+ <p>Contributing</p>
551
+ </a>
552
+ </li>
553
+ <li class="nav-item">
554
+ <a href="../../docs/license.html" class="nav-link">
555
+ <i class="nav-icon bi bi-patch-check"></i>
556
+ <p>License</p>
557
+ </a>
558
+ </li>
559
+ <li class="nav-item">
560
+ <a
561
+ href="https://github.com/ColorlibHQ/AdminLTE"
562
+ target="_blank"
563
+ rel="noopener"
564
+ class="nav-link"
565
+ >
566
+ <i class="nav-icon bi bi-github"></i>
567
+ <p>
568
+ GitHub
569
+ <i class="bi bi-box-arrow-up-right ms-1" aria-hidden="true"></i>
570
+ </p>
571
+ </a>
572
+ </li>
573
+ </ul>
574
+ <!--end::Sidebar Menu-->
575
+
576
+ <!-- Back to preview CTA (bottom of sidebar) -->
577
+ <div class="p-3 mt-3 border-top border-secondary border-opacity-25">
578
+ <a
579
+ href="../../index.html"
580
+ class="btn btn-sm btn-outline-light w-100 d-flex align-items-center justify-content-center gap-2"
581
+ >
582
+ <i class="bi bi-arrow-left" aria-hidden="true"></i>
583
+ Back to live preview
584
+ </a>
585
+ </div>
586
+ </nav>
587
+ </div>
588
+ <!--end::Sidebar Wrapper-->
589
+ </aside>
590
+ <!--end::Sidebar (docs mode)-->
591
+ <!--begin::App Main-->
592
+ <main class="app-main">
593
+ <!--begin::App Content Header-->
594
+ <div class="app-content-header">
595
+ <!--begin::Container-->
596
+ <div class="container-fluid">
597
+ <!--begin::Row-->
598
+ <div class="row">
599
+ <div class="col-sm-6">
600
+ <h3 class="mb-0">Layout Plugin</h3>
601
+ </div>
602
+ <div class="col-sm-6">
603
+ <ol class="breadcrumb float-sm-end">
604
+ <li class="breadcrumb-item"><a href="#">Docs</a></li>
605
+ <li class="breadcrumb-item active" aria-current="page">Layout Plugin</li>
606
+ </ol>
607
+ </div>
608
+ </div>
609
+ <!--end::Row-->
610
+ </div>
611
+ <!--end::Container-->
612
+ </div>
613
+ <!--end::App Content Header-->
614
+ <!--begin::App Content-->
615
+ <div class="app-content">
616
+ <!--begin::Container-->
617
+ <div class="container-fluid">
618
+ <div class="row">
619
+ <div class="col-12">
620
+ <div class="card">
621
+ <div class="card-body">
622
+ <p>
623
+ The Layout plugin manages CSS transitions during layout changes and signals
624
+ when the app has finished loading.
625
+ </p>
626
+ <h5 id="behavior">Behavior</h5>
627
+ <p>The Layout plugin performs two key tasks automatically:</p>
628
+ <ol>
629
+ <li>
630
+ <p>
631
+ <strong>Hold Transitions</strong> - During window resize, CSS transitions
632
+ on the sidebar, navbar, and content area are temporarily disabled to
633
+ prevent visual glitches. The <code>hold-transition</code> class is added
634
+ to <code>&lt;body&gt;</code> for the duration.
635
+ </p>
636
+ </li>
637
+ <li>
638
+ <p>
639
+ <strong>App Loaded Signal</strong> - After a 400ms delay on
640
+ DOMContentLoaded, the <code>app-loaded</code> class is added to
641
+ <code>&lt;body&gt;</code>. Use this class in CSS to defer animations until
642
+ the app is ready, preventing flicker on initial page load.
643
+ </p>
644
+ </li>
645
+ </ol>
646
+ <h5 id="css-classes">CSS Classes</h5>
647
+
648
+ <table>
649
+ <thead>
650
+ <tr>
651
+ <th>Class</th>
652
+ <th>Description</th>
653
+ </tr>
654
+ </thead>
655
+ <tbody>
656
+ <tr>
657
+ <td><code>hold-transition</code></td>
658
+ <td>
659
+ Temporarily disables CSS transitions on layout elements. Applied during
660
+ window resize.
661
+ </td>
662
+ </tr>
663
+ <tr>
664
+ <td><code>app-loaded</code></td>
665
+ <td>
666
+ Added to <code>&lt;body&gt;</code> after the initial layout is ready.
667
+ Use for entrance animations.
668
+ </td>
669
+ </tr>
670
+ </tbody>
671
+ </table>
672
+ <h5 id="usage-in-css">Usage in CSS</h5>
673
+ <pre
674
+ class="astro-code dark-plus"
675
+ style="background-color: #1e1e1e; color: #d4d4d4; overflow-x: auto"
676
+ tabindex="0"
677
+ data-language="css"
678
+ ><code><span class="line"><span style="color:#6A9955">/* Hide sidebar transitions until the app is loaded */</span></span>
679
+ <span class="line"><span style="color:#D7BA7D">body:not</span><span style="color:#D4D4D4">(</span><span style="color:#D7BA7D">.app-loaded</span><span style="color:#D4D4D4">) </span><span style="color:#D7BA7D">.app-sidebar</span><span style="color:#D4D4D4"> {</span></span>
680
+ <span class="line"><span style="color:#9CDCFE"> transition</span><span style="color:#D4D4D4">: </span><span style="color:#CE9178">none</span><span style="color:#569CD6"> !important</span><span style="color:#D4D4D4">;</span></span>
681
+ <span class="line"><span style="color:#D4D4D4">}</span></span>
682
+ <span class="line"></span>
683
+ <span class="line"><span style="color:#6A9955">/* Only animate after app is loaded */</span></span>
684
+ <span class="line"><span style="color:#D7BA7D">body.app-loaded</span><span style="color:#D7BA7D"> .app-sidebar</span><span style="color:#D4D4D4"> {</span></span>
685
+ <span class="line"><span style="color:#9CDCFE"> transition</span><span style="color:#D4D4D4">: width </span><span style="color:#B5CEA8">0.3s</span><span style="color:#CE9178"> ease</span><span style="color:#D4D4D4">;</span></span>
686
+ <span class="line"><span style="color:#D4D4D4">}</span></span></code></pre>
687
+ <h5 id="programmatic-api">Programmatic API</h5>
688
+ <p>
689
+ The Layout plugin self-initializes on <code>DOMContentLoaded</code> — there’s
690
+ nothing to wire up manually. The only public method is exposed for advanced
691
+ cases where you want to suppress transitions around your own DOM mutations:
692
+ </p>
693
+ <pre
694
+ class="astro-code dark-plus"
695
+ style="background-color: #1e1e1e; color: #d4d4d4; overflow-x: auto"
696
+ tabindex="0"
697
+ data-language="js"
698
+ ><code><span class="line"><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> { </span><span style="color:#9CDCFE">Layout</span><span style="color:#D4D4D4"> } </span><span style="color:#C586C0">from</span><span style="color:#CE9178"> &quot;admin-lte&quot;</span></span>
699
+ <span class="line"></span>
700
+ <span class="line"><span style="color:#569CD6">const</span><span style="color:#4FC1FF"> layout</span><span style="color:#D4D4D4"> = </span><span style="color:#569CD6">new</span><span style="color:#DCDCAA"> Layout</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>
701
+ <span class="line"><span style="color:#9CDCFE">layout</span><span style="color:#D4D4D4">.</span><span style="color:#DCDCAA">holdTransition</span><span style="color:#D4D4D4">(</span><span style="color:#B5CEA8">200</span><span style="color:#D4D4D4">) </span><span style="color:#6A9955">// disable transitions for 200ms</span></span>
702
+ <span class="line"></span>
703
+ <span class="line"><span style="color:#6A9955">// ... do something that would otherwise animate awkwardly</span></span>
704
+ <span class="line"><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:#9CDCFE">classList</span><span style="color:#D4D4D4">.</span><span style="color:#DCDCAA">toggle</span><span style="color:#D4D4D4">(</span><span style="color:#CE9178">&quot;sidebar-mini&quot;</span><span style="color:#D4D4D4">)</span></span></code></pre>
705
+ <h6 id="methods">Methods</h6>
706
+
707
+ <table>
708
+ <thead>
709
+ <tr>
710
+ <th>Method</th>
711
+ <th>Returns</th>
712
+ <th>Description</th>
713
+ </tr>
714
+ </thead>
715
+ <tbody>
716
+ <tr>
717
+ <td><code>holdTransition(time?)</code></td>
718
+ <td><code>void</code></td>
719
+ <td>
720
+ Adds <code>hold-transition</code> to <code>&lt;body&gt;</code>, removes
721
+ it after <code>time</code> milliseconds (default <code>100</code>). Use
722
+ to suppress CSS transitions during programmatic layout changes.
723
+ </td>
724
+ </tr>
725
+ </tbody>
726
+ </table>
727
+ <h5 id="notes">Notes</h5>
728
+ <ul>
729
+ <li>
730
+ The <code>hold-transition</code> class is automatically removed after the
731
+ timeout. You don’t need to clean up.
732
+ </li>
733
+ <li>
734
+ No data attributes — the plugin reads no config and initialises with the
735
+ body element on page load.
736
+ </li>
737
+ <li>
738
+ If you need to detect when the initial page-load animations are done, watch
739
+ for the <code>app-loaded</code> class on <code>&lt;body&gt;</code> or listen
740
+ for the standard <code>load</code> event.
741
+ </li>
742
+ </ul>
743
+ </div>
744
+ </div>
745
+ </div>
746
+ </div>
747
+ </div>
748
+ <!--end::Container-->
749
+ </div>
750
+ <!--end::App Content-->
751
+ </main>
752
+ <!--end::App Main-->
753
+ <!--begin::Footer-->
754
+ <footer class="app-footer">
755
+ <!--begin::To the end-->
756
+ <div class="float-end d-none d-sm-inline">Anything you want</div>
757
+ <!--end::To the end-->
758
+ <!--begin::Copyright-->
759
+ <strong>
760
+ Copyright &copy; 2014-2026&nbsp;
761
+ <a href="https://adminlte.io" class="text-decoration-none">AdminLTE.io</a>.
762
+ </strong>
763
+ All rights reserved.
764
+ <!--end::Copyright-->
765
+ </footer>
766
+ <!--end::Footer-->
767
+ </div>
768
+ <!--end::App Wrapper-->
769
+ <!--begin::Script-->
770
+ <!--begin::Third Party Plugin(OverlayScrollbars)-->
771
+ <script
772
+ src="https://cdn.jsdelivr.net/npm/overlayscrollbars@2.11.0/browser/overlayscrollbars.browser.es6.min.js"
773
+ crossorigin="anonymous"
774
+ ></script>
775
+ <!--end::Third Party Plugin(OverlayScrollbars)--><!--begin::Required Plugin(popperjs for Bootstrap 5)-->
776
+ <script
777
+ src="https://cdn.jsdelivr.net/npm/@popperjs/core@2.11.8/dist/umd/popper.min.js"
778
+ crossorigin="anonymous"
779
+ ></script>
780
+ <!--end::Required Plugin(popperjs for Bootstrap 5)--><!--begin::Required Plugin(Bootstrap 5)-->
781
+ <script
782
+ src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.7/dist/js/bootstrap.min.js"
783
+ crossorigin="anonymous"
784
+ ></script>
785
+ <!--end::Required Plugin(Bootstrap 5)--><!--begin::Required Plugin(AdminLTE)-->
786
+ <script src="../../js/adminlte.js"></script>
787
+ <!--end::Required Plugin(AdminLTE)--><!--begin::OverlayScrollbars Configure-->
788
+ <script>
789
+ const SELECTOR_SIDEBAR_WRAPPER = '.sidebar-wrapper';
790
+ const Default = {
791
+ scrollbarTheme: 'os-theme-light',
792
+ scrollbarAutoHide: 'leave',
793
+ scrollbarClickScroll: true,
794
+ };
795
+ document.addEventListener('DOMContentLoaded', function () {
796
+ const sidebarWrapper = document.querySelector(SELECTOR_SIDEBAR_WRAPPER);
797
+
798
+ // Disable OverlayScrollbars on mobile devices to prevent touch interference
799
+ const isMobile = window.innerWidth <= 992;
800
+
801
+ if (
802
+ sidebarWrapper &&
803
+ OverlayScrollbarsGlobal?.OverlayScrollbars !== undefined &&
804
+ !isMobile
805
+ ) {
806
+ OverlayScrollbarsGlobal.OverlayScrollbars(sidebarWrapper, {
807
+ scrollbars: {
808
+ theme: Default.scrollbarTheme,
809
+ autoHide: Default.scrollbarAutoHide,
810
+ clickScroll: Default.scrollbarClickScroll,
811
+ },
812
+ });
813
+ }
814
+ });
815
+ </script>
816
+ <!--end::OverlayScrollbars Configure--><!--begin::Color Mode Toggle (#6010)-->
817
+ <script>
818
+ (() => {
819
+ 'use strict';
820
+
821
+ const STORAGE_KEY = 'lte-theme';
822
+
823
+ const getStoredTheme = () => localStorage.getItem(STORAGE_KEY);
824
+ const setStoredTheme = (theme) => localStorage.setItem(STORAGE_KEY, theme);
825
+
826
+ const prefersDark = () => globalThis.matchMedia('(prefers-color-scheme: dark)').matches;
827
+
828
+ const getPreferredTheme = () => {
829
+ const stored = getStoredTheme();
830
+ if (stored) return stored;
831
+ return prefersDark() ? 'dark' : 'light';
832
+ };
833
+
834
+ const setTheme = (theme) => {
835
+ const resolved = theme === 'auto' ? (prefersDark() ? 'dark' : 'light') : theme;
836
+ document.documentElement.setAttribute('data-bs-theme', resolved);
837
+ };
838
+
839
+ setTheme(getPreferredTheme());
840
+
841
+ const showActiveTheme = (theme) => {
842
+ // Highlight the active dropdown option
843
+ document.querySelectorAll('[data-bs-theme-value]').forEach((el) => {
844
+ el.classList.remove('active');
845
+ el.setAttribute('aria-pressed', 'false');
846
+ const check = el.querySelector('.bi-check-lg');
847
+ if (check) check.classList.add('d-none');
848
+ });
849
+ const active = document.querySelector(`[data-bs-theme-value="${theme}"]`);
850
+ if (active) {
851
+ active.classList.add('active');
852
+ active.setAttribute('aria-pressed', 'true');
853
+ const check = active.querySelector('.bi-check-lg');
854
+ if (check) check.classList.remove('d-none');
855
+ }
856
+ // Sync the topbar trigger icon
857
+ document.querySelectorAll('[data-lte-theme-icon]').forEach((icon) => {
858
+ icon.classList.toggle('d-none', icon.dataset.lteThemeIcon !== theme);
859
+ });
860
+ };
861
+
862
+ globalThis.matchMedia('(prefers-color-scheme: dark)').addEventListener('change', () => {
863
+ const stored = getStoredTheme();
864
+ if (!stored || stored === 'auto') setTheme(getPreferredTheme());
865
+ });
866
+
867
+ document.addEventListener('DOMContentLoaded', () => {
868
+ showActiveTheme(getPreferredTheme());
869
+ document.querySelectorAll('[data-bs-theme-value]').forEach((toggle) => {
870
+ toggle.addEventListener('click', () => {
871
+ const theme = toggle.getAttribute('data-bs-theme-value');
872
+ setStoredTheme(theme);
873
+ setTheme(theme);
874
+ showActiveTheme(theme);
875
+ });
876
+ });
877
+ });
878
+ })();
879
+ </script>
880
+ <!--end::Color Mode Toggle-->
881
+ <!--end::Script-->
882
+ </body>
883
+ <!--end::Body-->
884
+ </html>