migration.html 52 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125
  1. <!doctype html>
  2. <html lang="en">
  3. <head>
  4. <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
  5. <title>Migration from v3 | AdminLTE 4</title>
  6. <!--begin::Accessibility Meta Tags-->
  7. <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes" />
  8. <meta name="color-scheme" content="light dark" />
  9. <meta name="theme-color" content="#007bff" media="(prefers-color-scheme: light)" />
  10. <meta name="theme-color" content="#1a1a1a" media="(prefers-color-scheme: dark)" />
  11. <!--end::Accessibility Meta Tags-->
  12. <!--begin::Primary Meta Tags-->
  13. <meta name="title" content="Migration from v3 | AdminLTE 4" />
  14. <meta name="author" content="ColorlibHQ" />
  15. <meta
  16. name="description"
  17. content="AdminLTE is a Free Bootstrap 5 Admin Dashboard, 30 example pages using Vanilla JS. Fully accessible with WCAG 2.1 AA compliance."
  18. />
  19. <meta
  20. name="keywords"
  21. 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"
  22. />
  23. <!--end::Primary Meta Tags-->
  24. <!--begin::Accessibility Features-->
  25. <!-- Skip links will be dynamically added by accessibility.js -->
  26. <meta name="supported-color-schemes" content="light dark" />
  27. <link rel="preload" href="../css/adminlte.css" as="style" />
  28. <!--end::Accessibility Features-->
  29. <!--begin::Fonts-->
  30. <link
  31. rel="stylesheet"
  32. href="https://cdn.jsdelivr.net/npm/@fontsource/source-sans-3@5.0.12/index.css"
  33. integrity="sha256-tXJfXfp6Ewt1ilPzLDtQnJV4hclT9XuaZUKyUvmyr+Q="
  34. crossorigin="anonymous"
  35. media="print"
  36. onload="this.media = 'all'"
  37. />
  38. <!--end::Fonts-->
  39. <!--begin::Third Party Plugin(OverlayScrollbars)-->
  40. <link
  41. rel="stylesheet"
  42. href="https://cdn.jsdelivr.net/npm/overlayscrollbars@2.11.0/styles/overlayscrollbars.min.css"
  43. crossorigin="anonymous"
  44. />
  45. <!--end::Third Party Plugin(OverlayScrollbars)-->
  46. <!--begin::Third Party Plugin(Bootstrap Icons)-->
  47. <link
  48. rel="stylesheet"
  49. href="https://cdn.jsdelivr.net/npm/bootstrap-icons@1.13.1/font/bootstrap-icons.min.css"
  50. crossorigin="anonymous"
  51. />
  52. <!--end::Third Party Plugin(Bootstrap Icons)-->
  53. <!--begin::Required Plugin(AdminLTE)-->
  54. <link rel="stylesheet" href="../css/adminlte.css" />
  55. <!--end::Required Plugin(AdminLTE)-->
  56. </head>
  57. <body class="layout-fixed sidebar-expand-lg bg-body-tertiary docs-page">
  58. <div class="app-wrapper">
  59. <!--begin::Header-->
  60. <nav class="app-header navbar navbar-expand bg-body">
  61. <!--begin::Container-->
  62. <div class="container-fluid">
  63. <!--begin::Start Navbar Links-->
  64. <ul class="navbar-nav">
  65. <li class="nav-item">
  66. <a class="nav-link" data-lte-toggle="sidebar" href="#" role="button">
  67. <i class="bi bi-list"></i>
  68. </a>
  69. </li>
  70. <li class="nav-item d-none d-md-block">
  71. <a href="../docs/introduction.html" class="nav-link">
  72. <i class="bi bi-book me-1" aria-hidden="true"></i>
  73. Documentation
  74. </a>
  75. </li>
  76. <li class="nav-item d-none d-md-block">
  77. <a href="../index.html" class="nav-link">
  78. <i class="bi bi-arrow-left me-1" aria-hidden="true"></i>
  79. Back to live preview
  80. </a>
  81. </li>
  82. </ul>
  83. <!--end::Start Navbar Links-->
  84. <!--begin::End Navbar Links-->
  85. <ul class="navbar-nav ms-auto">
  86. <!--begin::Navbar Search-->
  87. <li class="nav-item">
  88. <a class="nav-link" data-widget="navbar-search" href="#" role="button">
  89. <i class="bi bi-search"></i>
  90. </a>
  91. </li>
  92. <!--end::Navbar Search-->
  93. <!--begin::Messages Dropdown Menu-->
  94. <li class="nav-item dropdown">
  95. <a class="nav-link" data-bs-toggle="dropdown" href="#">
  96. <i class="bi bi-chat-text"></i>
  97. <span class="navbar-badge badge text-bg-danger">3</span>
  98. </a>
  99. <div class="dropdown-menu dropdown-menu-lg dropdown-menu-end">
  100. <a href="#" class="dropdown-item">
  101. <!--begin::Message-->
  102. <div class="d-flex">
  103. <div class="flex-shrink-0">
  104. <img
  105. src="../assets/img/user1-128x128.jpg"
  106. alt="User Avatar"
  107. class="img-size-50 rounded-circle me-3"
  108. />
  109. </div>
  110. <div class="flex-grow-1">
  111. <h3 class="dropdown-item-title">
  112. Brad Diesel
  113. <span class="float-end fs-7 text-danger"
  114. ><i class="bi bi-star-fill"></i
  115. ></span>
  116. </h3>
  117. <p class="fs-7">Call me whenever you can...</p>
  118. <p class="fs-7 text-secondary">
  119. <i class="bi bi-clock-fill me-1"></i> 4 Hours Ago
  120. </p>
  121. </div>
  122. </div>
  123. <!--end::Message-->
  124. </a>
  125. <div class="dropdown-divider"></div>
  126. <a href="#" class="dropdown-item">
  127. <!--begin::Message-->
  128. <div class="d-flex">
  129. <div class="flex-shrink-0">
  130. <img
  131. src="../assets/img/user8-128x128.jpg"
  132. alt="User Avatar"
  133. class="img-size-50 rounded-circle me-3"
  134. />
  135. </div>
  136. <div class="flex-grow-1">
  137. <h3 class="dropdown-item-title">
  138. John Pierce
  139. <span class="float-end fs-7 text-secondary">
  140. <i class="bi bi-star-fill"></i>
  141. </span>
  142. </h3>
  143. <p class="fs-7">I got your message bro</p>
  144. <p class="fs-7 text-secondary">
  145. <i class="bi bi-clock-fill me-1"></i> 4 Hours Ago
  146. </p>
  147. </div>
  148. </div>
  149. <!--end::Message-->
  150. </a>
  151. <div class="dropdown-divider"></div>
  152. <a href="#" class="dropdown-item">
  153. <!--begin::Message-->
  154. <div class="d-flex">
  155. <div class="flex-shrink-0">
  156. <img
  157. src="../assets/img/user3-128x128.jpg"
  158. alt="User Avatar"
  159. class="img-size-50 rounded-circle me-3"
  160. />
  161. </div>
  162. <div class="flex-grow-1">
  163. <h3 class="dropdown-item-title">
  164. Nora Silvester
  165. <span class="float-end fs-7 text-warning">
  166. <i class="bi bi-star-fill"></i>
  167. </span>
  168. </h3>
  169. <p class="fs-7">The subject goes here</p>
  170. <p class="fs-7 text-secondary">
  171. <i class="bi bi-clock-fill me-1"></i> 4 Hours Ago
  172. </p>
  173. </div>
  174. </div>
  175. <!--end::Message-->
  176. </a>
  177. <div class="dropdown-divider"></div>
  178. <a href="#" class="dropdown-item dropdown-footer">See All Messages</a>
  179. </div>
  180. </li>
  181. <!--end::Messages Dropdown Menu-->
  182. <!--begin::Notifications Dropdown Menu-->
  183. <li class="nav-item dropdown">
  184. <a class="nav-link" data-bs-toggle="dropdown" href="#">
  185. <i class="bi bi-bell-fill"></i>
  186. <span class="navbar-badge badge text-bg-warning">15</span>
  187. </a>
  188. <div class="dropdown-menu dropdown-menu-lg dropdown-menu-end">
  189. <span class="dropdown-item dropdown-header">15 Notifications</span>
  190. <div class="dropdown-divider"></div>
  191. <a href="#" class="dropdown-item">
  192. <i class="bi bi-envelope me-2"></i> 4 new messages
  193. <span class="float-end text-secondary fs-7">3 mins</span>
  194. </a>
  195. <div class="dropdown-divider"></div>
  196. <a href="#" class="dropdown-item">
  197. <i class="bi bi-people-fill me-2"></i> 8 friend requests
  198. <span class="float-end text-secondary fs-7">12 hours</span>
  199. </a>
  200. <div class="dropdown-divider"></div>
  201. <a href="#" class="dropdown-item">
  202. <i class="bi bi-file-earmark-fill me-2"></i> 3 new reports
  203. <span class="float-end text-secondary fs-7">2 days</span>
  204. </a>
  205. <div class="dropdown-divider"></div>
  206. <a href="#" class="dropdown-item dropdown-footer"> See All Notifications </a>
  207. </div>
  208. </li>
  209. <!--end::Notifications Dropdown Menu-->
  210. <!--begin::Fullscreen Toggle-->
  211. <li class="nav-item">
  212. <a class="nav-link" href="#" data-lte-toggle="fullscreen">
  213. <i data-lte-icon="maximize" class="bi bi-arrows-fullscreen"></i>
  214. <i data-lte-icon="minimize" class="bi bi-fullscreen-exit d-none"></i>
  215. </a>
  216. </li>
  217. <!--end::Fullscreen Toggle-->
  218. <!--begin::Color Mode Toggle (#6010)-->
  219. <li class="nav-item dropdown">
  220. <a
  221. class="nav-link"
  222. href="#"
  223. id="bd-theme"
  224. aria-label="Toggle color scheme"
  225. data-bs-toggle="dropdown"
  226. aria-expanded="false"
  227. >
  228. <i class="bi bi-sun-fill" data-lte-theme-icon="light"></i>
  229. <i class="bi bi-moon-fill d-none" data-lte-theme-icon="dark"></i>
  230. <i class="bi bi-circle-half d-none" data-lte-theme-icon="auto"></i>
  231. </a>
  232. <ul
  233. class="dropdown-menu dropdown-menu-end"
  234. aria-labelledby="bd-theme"
  235. style="--bs-dropdown-min-width: 8rem"
  236. >
  237. <li>
  238. <button
  239. type="button"
  240. class="dropdown-item d-flex align-items-center"
  241. data-bs-theme-value="light"
  242. aria-pressed="false"
  243. >
  244. <i class="bi bi-sun-fill me-2"></i>
  245. Light
  246. <i class="bi bi-check-lg ms-auto d-none"></i>
  247. </button>
  248. </li>
  249. <li>
  250. <button
  251. type="button"
  252. class="dropdown-item d-flex align-items-center"
  253. data-bs-theme-value="dark"
  254. aria-pressed="false"
  255. >
  256. <i class="bi bi-moon-fill me-2"></i>
  257. Dark
  258. <i class="bi bi-check-lg ms-auto d-none"></i>
  259. </button>
  260. </li>
  261. <li>
  262. <button
  263. type="button"
  264. class="dropdown-item d-flex align-items-center active"
  265. data-bs-theme-value="auto"
  266. aria-pressed="true"
  267. >
  268. <i class="bi bi-circle-half me-2"></i>
  269. Auto
  270. <i class="bi bi-check-lg ms-auto d-none"></i>
  271. </button>
  272. </li>
  273. </ul>
  274. </li>
  275. <!--end::Color Mode Toggle-->
  276. <!--begin::User Menu Dropdown-->
  277. <li class="nav-item dropdown user-menu">
  278. <a href="#" class="nav-link dropdown-toggle" data-bs-toggle="dropdown">
  279. <img
  280. src="../assets/img/user2-160x160.jpg"
  281. class="user-image rounded-circle shadow"
  282. alt="User Image"
  283. />
  284. <span class="d-none d-md-inline">Alexander Pierce</span>
  285. </a>
  286. <ul class="dropdown-menu dropdown-menu-lg dropdown-menu-end">
  287. <!--begin::User Image-->
  288. <li class="user-header text-bg-primary">
  289. <img
  290. src="../assets/img/user2-160x160.jpg"
  291. class="rounded-circle shadow"
  292. alt="User Image"
  293. />
  294. <p>
  295. Alexander Pierce - Web Developer
  296. <small>Member since Nov. 2023</small>
  297. </p>
  298. </li>
  299. <!--end::User Image-->
  300. <!--begin::Menu Body-->
  301. <li class="user-body">
  302. <!--begin::Row-->
  303. <div class="row">
  304. <div class="col-4 text-center">
  305. <a href="#">Followers</a>
  306. </div>
  307. <div class="col-4 text-center">
  308. <a href="#">Sales</a>
  309. </div>
  310. <div class="col-4 text-center">
  311. <a href="#">Friends</a>
  312. </div>
  313. </div>
  314. <!--end::Row-->
  315. </li>
  316. <!--end::Menu Body-->
  317. <!--begin::Menu Footer-->
  318. <li class="user-footer">
  319. <a href="#" class="btn btn-outline-secondary">Profile</a>
  320. <a href="#" class="btn btn-outline-danger float-end">Sign out</a>
  321. </li>
  322. <!--end::Menu Footer-->
  323. </ul>
  324. </li>
  325. <!--end::User Menu Dropdown-->
  326. </ul>
  327. <!--end::End Navbar Links-->
  328. </div>
  329. <!--end::Container-->
  330. </nav>
  331. <!--end::Header-->
  332. <!--begin::Sidebar (docs mode)-->
  333. <aside class="app-sidebar bg-body-secondary shadow" data-bs-theme="dark">
  334. <!--begin::Sidebar Brand-->
  335. <div class="sidebar-brand">
  336. <a href="../docs/introduction.html" class="brand-link">
  337. <img
  338. src="../assets/img/AdminLTELogo.png"
  339. alt="AdminLTE Logo"
  340. class="brand-image opacity-75 shadow"
  341. />
  342. <span class="brand-text fw-light">
  343. AdminLTE 4 <span class="opacity-75">&middot; Docs</span>
  344. </span>
  345. </a>
  346. </div>
  347. <!--end::Sidebar Brand-->
  348. <!--begin::Sidebar Wrapper-->
  349. <div class="sidebar-wrapper">
  350. <nav class="mt-2">
  351. <!-- Back to preview CTA -->
  352. <div class="px-3 pb-2">
  353. <a
  354. href="../index.html"
  355. class="btn btn-sm btn-outline-light w-100 d-flex align-items-center justify-content-center gap-2"
  356. >
  357. <i class="bi bi-arrow-left" aria-hidden="true"></i>
  358. Back to live preview
  359. </a>
  360. </div>
  361. <!--begin::Sidebar Menu-->
  362. <ul
  363. class="nav sidebar-menu flex-column"
  364. data-lte-toggle="treeview"
  365. role="navigation"
  366. aria-label="Documentation navigation"
  367. data-accordion="false"
  368. id="docs-navigation"
  369. >
  370. <li class="nav-header">START HERE</li>
  371. <li class="nav-item">
  372. <a href="../docs/introduction.html" class="nav-link">
  373. <i class="nav-icon bi bi-download"></i>
  374. <p>Installation</p>
  375. </a>
  376. </li>
  377. <li class="nav-item">
  378. <a href="../docs/getting-started.html" class="nav-link">
  379. <i class="nav-icon bi bi-rocket-takeoff"></i>
  380. <p>Getting Started</p>
  381. </a>
  382. </li>
  383. <li class="nav-header">FOUNDATIONS</li>
  384. <li class="nav-item">
  385. <a href="../docs/layout.html" class="nav-link">
  386. <i class="nav-icon bi bi-grip-horizontal"></i>
  387. <p>Layout Classes</p>
  388. </a>
  389. </li>
  390. <li class="nav-item">
  391. <a href="../docs/layout-blueprint.html" class="nav-link">
  392. <i class="nav-icon bi bi-diagram-3"></i>
  393. <p>Layout Blueprint</p>
  394. </a>
  395. </li>
  396. <li class="nav-item">
  397. <a href="../docs/customization.html" class="nav-link">
  398. <i class="nav-icon bi bi-palette"></i>
  399. <p>Customization</p>
  400. </a>
  401. </li>
  402. <li class="nav-item">
  403. <a href="../docs/color-mode.html" class="nav-link">
  404. <i class="nav-icon bi bi-star-half"></i>
  405. <p>Color Mode</p>
  406. </a>
  407. </li>
  408. <li class="nav-item">
  409. <a href="../docs/rtl.html" class="nav-link">
  410. <i class="nav-icon bi bi-text-paragraph"></i>
  411. <p>RTL Support</p>
  412. </a>
  413. </li>
  414. <li class="nav-header">BUILDING</li>
  415. <li class="nav-item">
  416. <a href="../docs/recipes.html" class="nav-link">
  417. <i class="nav-icon bi bi-clipboard-check"></i>
  418. <p>Recipes</p>
  419. </a>
  420. </li>
  421. <li class="nav-item">
  422. <a href="#" class="nav-link">
  423. <i class="nav-icon bi bi-ui-checks-grid"></i>
  424. <p>
  425. Components
  426. <i class="nav-arrow bi bi-chevron-right"></i>
  427. </p>
  428. </a>
  429. <ul class="nav nav-treeview">
  430. <li class="nav-item">
  431. <a href="../docs/components/main-header.html" class="nav-link">
  432. <i class="nav-icon bi bi-circle"></i>
  433. <p>Main Header</p>
  434. </a>
  435. </li>
  436. <li class="nav-item">
  437. <a href="../docs/components/main-sidebar.html" class="nav-link">
  438. <i class="nav-icon bi bi-circle"></i>
  439. <p>Main Sidebar</p>
  440. </a>
  441. </li>
  442. </ul>
  443. </li>
  444. <li class="nav-item">
  445. <a href="#" class="nav-link">
  446. <i class="nav-icon bi bi-filetype-js"></i>
  447. <p>
  448. JavaScript Plugins
  449. <i class="nav-arrow bi bi-chevron-right"></i>
  450. </p>
  451. </a>
  452. <ul class="nav nav-treeview">
  453. <li class="nav-item">
  454. <a href="../docs/javascript/plugins-overview.html" class="nav-link">
  455. <i class="nav-icon bi bi-circle"></i>
  456. <p>Overview</p>
  457. </a>
  458. </li>
  459. <li class="nav-item">
  460. <a href="../docs/javascript/layout.html" class="nav-link">
  461. <i class="nav-icon bi bi-circle"></i>
  462. <p>Layout</p>
  463. </a>
  464. </li>
  465. <li class="nav-item">
  466. <a href="../docs/javascript/pushmenu.html" class="nav-link">
  467. <i class="nav-icon bi bi-circle"></i>
  468. <p>PushMenu</p>
  469. </a>
  470. </li>
  471. <li class="nav-item">
  472. <a href="../docs/javascript/treeview.html" class="nav-link">
  473. <i class="nav-icon bi bi-circle"></i>
  474. <p>Treeview</p>
  475. </a>
  476. </li>
  477. <li class="nav-item">
  478. <a href="../docs/javascript/card-widget.html" class="nav-link">
  479. <i class="nav-icon bi bi-circle"></i>
  480. <p>Card Widget</p>
  481. </a>
  482. </li>
  483. <li class="nav-item">
  484. <a href="../docs/javascript/direct-chat.html" class="nav-link">
  485. <i class="nav-icon bi bi-circle"></i>
  486. <p>Direct Chat</p>
  487. </a>
  488. </li>
  489. <li class="nav-item">
  490. <a href="../docs/javascript/fullscreen.html" class="nav-link">
  491. <i class="nav-icon bi bi-circle"></i>
  492. <p>Fullscreen</p>
  493. </a>
  494. </li>
  495. <li class="nav-item">
  496. <a href="../docs/javascript/accessibility.html" class="nav-link">
  497. <i class="nav-icon bi bi-circle"></i>
  498. <p>Accessibility</p>
  499. </a>
  500. </li>
  501. </ul>
  502. </li>
  503. <li class="nav-item">
  504. <a href="../docs/integrations.html" class="nav-link">
  505. <i class="nav-icon bi bi-puzzle"></i>
  506. <p>Integrations</p>
  507. </a>
  508. </li>
  509. <li class="nav-header">SHIPPING</li>
  510. <li class="nav-item">
  511. <a href="../docs/migration.html" class="nav-link active">
  512. <i class="nav-icon bi bi-arrow-up-right-square"></i>
  513. <p>Migration from v3</p>
  514. </a>
  515. </li>
  516. <li class="nav-item">
  517. <a href="../docs/deployment.html" class="nav-link">
  518. <i class="nav-icon bi bi-cloud-upload"></i>
  519. <p>Deployment</p>
  520. </a>
  521. </li>
  522. <li class="nav-item">
  523. <a href="../docs/browser-support.html" class="nav-link">
  524. <i class="nav-icon bi bi-browser-chrome"></i>
  525. <p>Browser Support</p>
  526. </a>
  527. </li>
  528. <li class="nav-header">RESOURCES</li>
  529. <li class="nav-item">
  530. <a href="../docs/faq.html" class="nav-link">
  531. <i class="nav-icon bi bi-question-circle"></i>
  532. <p>FAQ</p>
  533. </a>
  534. </li>
  535. <li class="nav-item">
  536. <a href="../docs/how-to-contribute.html" class="nav-link">
  537. <i class="nav-icon bi bi-people"></i>
  538. <p>Contributing</p>
  539. </a>
  540. </li>
  541. <li class="nav-item">
  542. <a href="../docs/license.html" class="nav-link">
  543. <i class="nav-icon bi bi-patch-check"></i>
  544. <p>License</p>
  545. </a>
  546. </li>
  547. <li class="nav-item">
  548. <a
  549. href="https://github.com/ColorlibHQ/AdminLTE"
  550. target="_blank"
  551. rel="noopener"
  552. class="nav-link"
  553. >
  554. <i class="nav-icon bi bi-github"></i>
  555. <p>
  556. GitHub
  557. <i class="bi bi-box-arrow-up-right ms-1" aria-hidden="true"></i>
  558. </p>
  559. </a>
  560. </li>
  561. </ul>
  562. <!--end::Sidebar Menu-->
  563. </nav>
  564. </div>
  565. <!--end::Sidebar Wrapper-->
  566. </aside>
  567. <!--end::Sidebar (docs mode)-->
  568. <main class="app-main">
  569. <div class="app-content-header">
  570. <div class="container-fluid">
  571. <div class="row">
  572. <div class="col-sm-6">
  573. <h3 class="mb-0">Migration from v3</h3>
  574. </div>
  575. <div class="col-sm-6">
  576. <ol class="breadcrumb float-sm-end">
  577. <li class="breadcrumb-item"><a href="#">Docs</a></li>
  578. <li class="breadcrumb-item active" aria-current="page">Migration</li>
  579. </ol>
  580. </div>
  581. </div>
  582. </div>
  583. </div>
  584. <div class="app-content">
  585. <div class="container-fluid">
  586. <div class="row">
  587. <div class="col-12">
  588. <div class="card">
  589. <div class="card-body">
  590. <p>
  591. AdminLTE 4 is a ground-up rewrite. It targets Bootstrap 5.3, drops jQuery,
  592. ships as TypeScript-authored vanilla JS, and reorganises the CSS class
  593. structure. If you’re upgrading an AdminLTE 3 project, the changes below are
  594. the ones most likely to bite.
  595. </p>
  596. <h5 id="the-high-level-summary">The high-level summary</h5>
  597. <table>
  598. <thead>
  599. <tr>
  600. <th></th>
  601. <th>AdminLTE 3</th>
  602. <th>AdminLTE 4</th>
  603. </tr>
  604. </thead>
  605. <tbody>
  606. <tr>
  607. <td>CSS framework</td>
  608. <td>Bootstrap 4.6</td>
  609. <td><strong>Bootstrap 5.3</strong></td>
  610. </tr>
  611. <tr>
  612. <td>JavaScript</td>
  613. <td>jQuery + vanilla</td>
  614. <td><strong>Vanilla TypeScript only</strong></td>
  615. </tr>
  616. <tr>
  617. <td>Dark mode</td>
  618. <td>Manual <code>.dark-mode</code> class</td>
  619. <td>
  620. <strong><code>data-bs-theme</code> attribute (Bootstrap-native)</strong>
  621. </td>
  622. </tr>
  623. <tr>
  624. <td>RTL</td>
  625. <td>Separate <code>rtl.css</code> build</td>
  626. <td><strong>Generated automatically via rtlcss</strong></td>
  627. </tr>
  628. <tr>
  629. <td>Browser support</td>
  630. <td>IE 11 forks available</td>
  631. <td>Modern evergreen browsers only</td>
  632. </tr>
  633. <tr>
  634. <td>Build tooling</td>
  635. <td>Gulp</td>
  636. <td><strong>Rollup + Sass + PostCSS</strong></td>
  637. </tr>
  638. <tr>
  639. <td>Icon library</td>
  640. <td>FontAwesome</td>
  641. <td>
  642. <strong>Bootstrap Icons</strong> (Lucide / Tabler Icons documented as
  643. alternatives)
  644. </td>
  645. </tr>
  646. </tbody>
  647. </table>
  648. <p>
  649. If your project relies on jQuery or IE 11, stay on AdminLTE 3 — those
  650. constraints are not reversible in v4.
  651. </p>
  652. <h5 id="class-renames">Class renames</h5>
  653. <p>The most common find-and-replace work:</p>
  654. <table>
  655. <thead>
  656. <tr>
  657. <th>AdminLTE 3</th>
  658. <th>AdminLTE 4</th>
  659. </tr>
  660. </thead>
  661. <tbody>
  662. <tr>
  663. <td><code>.wrapper</code></td>
  664. <td><code>.app-wrapper</code></td>
  665. </tr>
  666. <tr>
  667. <td><code>.main-header</code></td>
  668. <td><code>.app-header</code></td>
  669. </tr>
  670. <tr>
  671. <td><code>.main-sidebar</code></td>
  672. <td><code>.app-sidebar</code></td>
  673. </tr>
  674. <tr>
  675. <td><code>.content-wrapper</code></td>
  676. <td><code>.app-main</code></td>
  677. </tr>
  678. <tr>
  679. <td><code>.main-footer</code></td>
  680. <td><code>.app-footer</code></td>
  681. </tr>
  682. <tr>
  683. <td><code>.content-header</code></td>
  684. <td><code>.app-content-header</code></td>
  685. </tr>
  686. <tr>
  687. <td><code>.content</code></td>
  688. <td><code>.app-content</code></td>
  689. </tr>
  690. <tr>
  691. <td><code>.brand-link</code> (inside <code>.main-sidebar</code>)</td>
  692. <td><code>.sidebar-brand &gt; .brand-link</code></td>
  693. </tr>
  694. <tr>
  695. <td><code>data-widget=&quot;pushmenu&quot;</code></td>
  696. <td><code>data-lte-toggle=&quot;sidebar&quot;</code></td>
  697. </tr>
  698. <tr>
  699. <td><code>data-widget=&quot;treeview&quot;</code></td>
  700. <td>
  701. <code>data-lte-toggle=&quot;treeview&quot;</code> (on the parent menu)
  702. </td>
  703. </tr>
  704. <tr>
  705. <td><code>data-widget=&quot;card-widget&quot;</code></td>
  706. <td>
  707. <code>data-lte-toggle=&quot;card-collapse&quot;</code>,
  708. <code>card-remove</code>, <code>card-maximize</code>
  709. </td>
  710. </tr>
  711. <tr>
  712. <td><code>data-widget=&quot;fullscreen&quot;</code></td>
  713. <td><code>data-lte-toggle=&quot;fullscreen&quot;</code></td>
  714. </tr>
  715. <tr>
  716. <td><code>data-widget=&quot;control-sidebar&quot;</code></td>
  717. <td>(removed — Bootstrap offcanvas replaces this)</td>
  718. </tr>
  719. <tr>
  720. <td><code>.dark-mode</code> (on <code>&lt;body&gt;</code>)</td>
  721. <td><code>data-bs-theme=&quot;dark&quot;</code> (on any element)</td>
  722. </tr>
  723. </tbody>
  724. </table>
  725. <h5 id="bootstrap-4--5-utility-renames">Bootstrap 4 → 5 utility renames</h5>
  726. <p>
  727. These come from Bootstrap itself, not AdminLTE, but they affect every page:
  728. </p>
  729. <table>
  730. <thead>
  731. <tr>
  732. <th>Bootstrap 4</th>
  733. <th>Bootstrap 5</th>
  734. </tr>
  735. </thead>
  736. <tbody>
  737. <tr>
  738. <td><code>data-toggle</code></td>
  739. <td><code>data-bs-toggle</code></td>
  740. </tr>
  741. <tr>
  742. <td><code>data-target</code></td>
  743. <td><code>data-bs-target</code></td>
  744. </tr>
  745. <tr>
  746. <td><code>data-dismiss</code></td>
  747. <td><code>data-bs-dismiss</code></td>
  748. </tr>
  749. <tr>
  750. <td><code>data-parent</code></td>
  751. <td><code>data-bs-parent</code></td>
  752. </tr>
  753. <tr>
  754. <td><code>data-spy</code></td>
  755. <td><code>data-bs-spy</code></td>
  756. </tr>
  757. <tr>
  758. <td><code>data-ride</code></td>
  759. <td><code>data-bs-ride</code></td>
  760. </tr>
  761. <tr>
  762. <td><code>.ml-*</code>, <code>.mr-*</code></td>
  763. <td><code>.ms-*</code>, <code>.me-*</code></td>
  764. </tr>
  765. <tr>
  766. <td><code>.pl-*</code>, <code>.pr-*</code></td>
  767. <td><code>.ps-*</code>, <code>.pe-*</code></td>
  768. </tr>
  769. <tr>
  770. <td><code>.float-left</code>, <code>.float-right</code></td>
  771. <td><code>.float-start</code>, <code>.float-end</code></td>
  772. </tr>
  773. <tr>
  774. <td><code>.text-left</code>, <code>.text-right</code></td>
  775. <td><code>.text-start</code>, <code>.text-end</code></td>
  776. </tr>
  777. <tr>
  778. <td><code>.border-left</code>, <code>.border-right</code></td>
  779. <td><code>.border-start</code>, <code>.border-end</code></td>
  780. </tr>
  781. <tr>
  782. <td><code>.rounded-left</code>, <code>.rounded-right</code></td>
  783. <td><code>.rounded-start</code>, <code>.rounded-end</code></td>
  784. </tr>
  785. <tr>
  786. <td><code>.font-weight-*</code></td>
  787. <td><code>.fw-*</code></td>
  788. </tr>
  789. <tr>
  790. <td><code>.font-italic</code></td>
  791. <td><code>.fst-italic</code></td>
  792. </tr>
  793. <tr>
  794. <td><code>.text-monospace</code></td>
  795. <td><code>.font-monospace</code></td>
  796. </tr>
  797. </tbody>
  798. </table>
  799. <p>
  800. A regex find-replace handles most of this in a few minutes. The migration tool
  801. <a href="https://github.com/dbtek/bootstrap-5-migration"
  802. ><code>bootstrap-5-migration</code></a
  803. >
  804. automates the bulk.
  805. </p>
  806. <h5 id="jquery-removal">jQuery removal</h5>
  807. <p>
  808. If your app code calls AdminLTE 3 plugins via jQuery
  809. (<code>$(&#39;.sidebar&#39;).PushMenu()</code>, etc.), those calls no longer
  810. work. Replacements:
  811. </p>
  812. <pre
  813. class="astro-code dark-plus"
  814. style="background-color: #1e1e1e; color: #d4d4d4; overflow-x: auto"
  815. tabindex="0"
  816. data-language="js"
  817. ><code><span class="line"><span style="color:#6A9955">// AdminLTE 3</span></span>
  818. <span class="line"><span style="color:#DCDCAA">$</span><span style="color:#D4D4D4">(</span><span style="color:#CE9178">&#39;.sidebar-toggle&#39;</span><span style="color:#D4D4D4">).</span><span style="color:#DCDCAA">on</span><span style="color:#D4D4D4">(</span><span style="color:#CE9178">&#39;click&#39;</span><span style="color:#D4D4D4">, </span><span style="color:#569CD6">function</span><span style="color:#D4D4D4"> () {</span></span>
  819. <span class="line"><span style="color:#DCDCAA"> $</span><span style="color:#D4D4D4">(</span><span style="color:#CE9178">&#39;body&#39;</span><span style="color:#D4D4D4">).</span><span style="color:#DCDCAA">toggleClass</span><span style="color:#D4D4D4">(</span><span style="color:#CE9178">&#39;sidebar-collapse&#39;</span><span style="color:#D4D4D4">)</span></span>
  820. <span class="line"><span style="color:#D4D4D4">})</span></span></code></pre>
  821. <pre
  822. class="astro-code dark-plus"
  823. style="background-color: #1e1e1e; color: #d4d4d4; overflow-x: auto"
  824. tabindex="0"
  825. data-language="js"
  826. ><code><span class="line"><span style="color:#6A9955">// AdminLTE 4 — the data-API does this for you</span></span>
  827. <span class="line"><span style="color:#6A9955">// &lt;a href=&quot;#&quot; data-lte-toggle=&quot;sidebar&quot;&gt;...&lt;/a&gt;</span></span></code></pre>
  828. <p>If you need programmatic control, import the plugin class directly:</p>
  829. <pre
  830. class="astro-code dark-plus"
  831. style="background-color: #1e1e1e; color: #d4d4d4; overflow-x: auto"
  832. tabindex="0"
  833. data-language="js"
  834. ><code><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:#C586C0">from</span><span style="color:#CE9178"> &quot;admin-lte&quot;</span></span>
  835. <span class="line"></span>
  836. <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:#DCDCAA">querySelector</span><span style="color:#D4D4D4">(</span><span style="color:#CE9178">&quot;.sidebar-toggle&quot;</span><span style="color:#D4D4D4">)).</span><span style="color:#DCDCAA">toggle</span><span style="color:#D4D4D4">()</span></span></code></pre>
  837. <p>
  838. All seven JS plugins (<code>Layout</code>, <code>CardWidget</code>,
  839. <code>Treeview</code>, <code>DirectChat</code>, <code>FullScreen</code>,
  840. <code>PushMenu</code>, plus <code>initAccessibility</code>) are exported from
  841. <code>admin-lte</code>.
  842. </p>
  843. <h5 id="dark-mode">Dark mode</h5>
  844. <p>
  845. AdminLTE 3 used a <code>.dark-mode</code> class toggled on the
  846. <code>&lt;body&gt;</code>. AdminLTE 4 uses Bootstrap 5.3’s native
  847. <code>data-bs-theme=&quot;dark&quot;</code> attribute, which can be applied at
  848. any level — <code>&lt;html&gt;</code>, <code>&lt;body&gt;</code>, or a single
  849. component.
  850. </p>
  851. <pre
  852. class="astro-code dark-plus"
  853. style="background-color: #1e1e1e; color: #d4d4d4; overflow-x: auto"
  854. tabindex="0"
  855. data-language="html"
  856. ><code><span class="line"><span style="color:#6A9955">&lt;!-- AdminLTE 3 --&gt;</span></span>
  857. <span class="line"><span style="color:#808080">&lt;</span><span style="color:#569CD6">body</span><span style="color:#9CDCFE"> class</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;dark-mode&quot;</span><span style="color:#808080">&gt;</span></span>
  858. <span class="line"></span>
  859. <span class="line"><span style="color:#6A9955">&lt;!-- AdminLTE 4 --&gt;</span></span>
  860. <span class="line"><span style="color:#808080">&lt;</span><span style="color:#569CD6">html</span><span style="color:#9CDCFE"> data-bs-theme</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;dark&quot;</span><span style="color:#808080">&gt;</span></span></code></pre>
  861. <p>
  862. The included <a href="color-mode.html">Color Mode</a> widget reads/writes this
  863. attribute and persists the user’s choice in <code>localStorage</code>. See the
  864. <a href="color-mode.html">Color Mode</a> docs page for the toggle
  865. implementation.
  866. </p>
  867. <h5 id="css-variables-instead-of-bg--overrides">
  868. CSS variables instead of <code>.bg-*</code> overrides
  869. </h5>
  870. <p>
  871. AdminLTE 3 shipped a lot of one-off colour classes (<code>.bg-navy</code>,
  872. <code>.bg-purple</code>, <code>.bg-fuchsia</code>, etc.). In v4, prefer
  873. Bootstrap 5.3’s CSS-variable model:
  874. </p>
  875. <pre
  876. class="astro-code dark-plus"
  877. style="background-color: #1e1e1e; color: #d4d4d4; overflow-x: auto"
  878. tabindex="0"
  879. data-language="html"
  880. ><code><span class="line"><span style="color:#6A9955">&lt;!-- AdminLTE 3 --&gt;</span></span>
  881. <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 bg-navy&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>
  882. <span class="line"></span>
  883. <span class="line"><span style="color:#6A9955">&lt;!-- AdminLTE 4 — use Bootstrap utilities + CSS variables --&gt;</span></span>
  884. <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 text-bg-primary&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></code></pre>
  885. <p>
  886. For full retheming, override <code>--bs-primary</code> etc. on
  887. <code>:root</code>. See <a href="customization.html">Customization</a>.
  888. </p>
  889. <h5 id="icons">Icons</h5>
  890. <p>
  891. AdminLTE 3 demos used FontAwesome 6 free. AdminLTE 4 standardises on
  892. <a href="https://icons.getbootstrap.com/">Bootstrap Icons</a> — they’re SVG,
  893. lighter, MIT-licensed, and ship with Bootstrap’s ecosystem.
  894. </p>
  895. <pre
  896. class="astro-code dark-plus"
  897. style="background-color: #1e1e1e; color: #d4d4d4; overflow-x: auto"
  898. tabindex="0"
  899. data-language="html"
  900. ><code><span class="line"><span style="color:#6A9955">&lt;!-- AdminLTE 3 --&gt;</span></span>
  901. <span class="line"><span style="color:#808080">&lt;</span><span style="color:#569CD6">i</span><span style="color:#9CDCFE"> class</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;fas fa-home&quot;</span><span style="color:#808080">&gt;&lt;/</span><span style="color:#569CD6">i</span><span style="color:#808080">&gt;</span></span>
  902. <span class="line"></span>
  903. <span class="line"><span style="color:#6A9955">&lt;!-- AdminLTE 4 --&gt;</span></span>
  904. <span class="line"><span style="color:#808080">&lt;</span><span style="color:#569CD6">i</span><span style="color:#9CDCFE"> class</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;bi bi-house&quot;</span><span style="color:#808080">&gt;&lt;/</span><span style="color:#569CD6">i</span><span style="color:#808080">&gt;</span></span></code></pre>
  905. <p>
  906. If you’d rather stick with FontAwesome (or use Lucide, Tabler Icons, Material
  907. Symbols, etc.), nothing in AdminLTE 4 forces Bootstrap Icons — load whichever
  908. icon font you prefer and replace the <code>&lt;i&gt;</code> classes. See
  909. <a href="integrations.html#icon-libraries">Recommended Integrations</a> for
  910. the comparison table.
  911. </p>
  912. <h5 id="pages-we-havent-ported-yet">Pages we haven’t ported yet</h5>
  913. <p>
  914. The v3 demo includes pages that haven’t all been recreated for v4. The v4
  915. release notes cover the current page catalog. If you depend on a specific v3
  916. page that hasn’t been ported, please
  917. <a href="https://github.com/ColorlibHQ/AdminLTE/issues">open an issue</a> —
  918. community contributions for missing pages are very welcome.
  919. </p>
  920. <h5 id="suggested-migration-order">Suggested migration order</h5>
  921. <p>For an existing AdminLTE 3 project:</p>
  922. <ol>
  923. <li>
  924. <strong>Branch first.</strong> This is not a small change — keep
  925. <code>master</code> on v3 until v4 is stable.
  926. </li>
  927. <li>
  928. <strong>Update CSS class names</strong> with a find-replace pass using the
  929. table above. Most layouts compile but look broken until step 3.
  930. </li>
  931. <li>
  932. <strong
  933. >Update <code>data-toggle</code> → <code>data-bs-toggle</code></strong
  934. >
  935. etc. across all your templates.
  936. </li>
  937. <li>
  938. <strong>Replace <code>.dark-mode</code> toggle code</strong> with
  939. <code>data-bs-theme</code> attribute writes.
  940. </li>
  941. <li>
  942. <strong>Audit jQuery calls.</strong> Either remove them (use the data API)
  943. or import plugin classes directly.
  944. </li>
  945. <li>
  946. <strong>Test responsive breakpoints</strong> — Bootstrap 5 added
  947. <code>xxl</code>. If you use breakpoint-specific utilities, double-check the
  948. new scale.
  949. </li>
  950. <li>
  951. <strong>Re-test print views</strong> — AdminLTE 4 fixed a print-layout issue
  952. (#5996); if you had custom print CSS, verify it still works.
  953. </li>
  954. </ol>
  955. <h5 id="help-and-discussion">Help and discussion</h5>
  956. <ul>
  957. <li>
  958. Migration questions:
  959. <a href="https://github.com/ColorlibHQ/AdminLTE/discussions"
  960. >GitHub Discussions</a
  961. >
  962. </li>
  963. <li>
  964. Found something we missed?
  965. <a href="https://github.com/ColorlibHQ/AdminLTE/issues">Open an issue</a>
  966. tagged <code>migration</code>.
  967. </li>
  968. </ul>
  969. </div>
  970. </div>
  971. </div>
  972. </div>
  973. </div>
  974. </div>
  975. </main>
  976. <!--begin::Footer-->
  977. <footer class="app-footer">
  978. <!--begin::To the end-->
  979. <div class="float-end d-none d-sm-inline">Anything you want</div>
  980. <!--end::To the end-->
  981. <!--begin::Copyright-->
  982. <strong>
  983. Copyright &copy; 2014-2026&nbsp;
  984. <a href="https://adminlte.io" class="text-decoration-none">AdminLTE.io</a>.
  985. </strong>
  986. All rights reserved.
  987. <!--end::Copyright-->
  988. </footer>
  989. <!--end::Footer-->
  990. </div>
  991. <!--begin::Third Party Plugin(OverlayScrollbars)-->
  992. <script
  993. src="https://cdn.jsdelivr.net/npm/overlayscrollbars@2.11.0/browser/overlayscrollbars.browser.es6.min.js"
  994. crossorigin="anonymous"
  995. ></script>
  996. <!--end::Third Party Plugin(OverlayScrollbars)--><!--begin::Required Plugin(popperjs for Bootstrap 5)-->
  997. <script
  998. src="https://cdn.jsdelivr.net/npm/@popperjs/core@2.11.8/dist/umd/popper.min.js"
  999. crossorigin="anonymous"
  1000. ></script>
  1001. <!--end::Required Plugin(popperjs for Bootstrap 5)--><!--begin::Required Plugin(Bootstrap 5)-->
  1002. <script
  1003. src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.7/dist/js/bootstrap.min.js"
  1004. crossorigin="anonymous"
  1005. ></script>
  1006. <!--end::Required Plugin(Bootstrap 5)--><!--begin::Required Plugin(AdminLTE)-->
  1007. <script src="../js/adminlte.js"></script>
  1008. <!--end::Required Plugin(AdminLTE)--><!--begin::OverlayScrollbars Configure-->
  1009. <script>
  1010. const SELECTOR_SIDEBAR_WRAPPER = '.sidebar-wrapper';
  1011. const Default = {
  1012. scrollbarTheme: 'os-theme-light',
  1013. scrollbarAutoHide: 'leave',
  1014. scrollbarClickScroll: true,
  1015. };
  1016. document.addEventListener('DOMContentLoaded', function () {
  1017. const sidebarWrapper = document.querySelector(SELECTOR_SIDEBAR_WRAPPER);
  1018. // Disable OverlayScrollbars on mobile devices to prevent touch interference
  1019. const isMobile = window.innerWidth <= 992;
  1020. if (
  1021. sidebarWrapper &&
  1022. OverlayScrollbarsGlobal?.OverlayScrollbars !== undefined &&
  1023. !isMobile
  1024. ) {
  1025. OverlayScrollbarsGlobal.OverlayScrollbars(sidebarWrapper, {
  1026. scrollbars: {
  1027. theme: Default.scrollbarTheme,
  1028. autoHide: Default.scrollbarAutoHide,
  1029. clickScroll: Default.scrollbarClickScroll,
  1030. },
  1031. });
  1032. }
  1033. });
  1034. </script>
  1035. <!--end::OverlayScrollbars Configure--><!--begin::Color Mode Toggle (#6010)-->
  1036. <script>
  1037. (() => {
  1038. 'use strict';
  1039. const STORAGE_KEY = 'lte-theme';
  1040. const getStoredTheme = () => localStorage.getItem(STORAGE_KEY);
  1041. const setStoredTheme = (theme) => localStorage.setItem(STORAGE_KEY, theme);
  1042. const prefersDark = () => globalThis.matchMedia('(prefers-color-scheme: dark)').matches;
  1043. const getPreferredTheme = () => {
  1044. const stored = getStoredTheme();
  1045. if (stored) return stored;
  1046. return prefersDark() ? 'dark' : 'light';
  1047. };
  1048. const setTheme = (theme) => {
  1049. const resolved = theme === 'auto' ? (prefersDark() ? 'dark' : 'light') : theme;
  1050. document.documentElement.setAttribute('data-bs-theme', resolved);
  1051. };
  1052. setTheme(getPreferredTheme());
  1053. const showActiveTheme = (theme) => {
  1054. // Highlight the active dropdown option
  1055. document.querySelectorAll('[data-bs-theme-value]').forEach((el) => {
  1056. el.classList.remove('active');
  1057. el.setAttribute('aria-pressed', 'false');
  1058. const check = el.querySelector('.bi-check-lg');
  1059. if (check) check.classList.add('d-none');
  1060. });
  1061. const active = document.querySelector(`[data-bs-theme-value="${theme}"]`);
  1062. if (active) {
  1063. active.classList.add('active');
  1064. active.setAttribute('aria-pressed', 'true');
  1065. const check = active.querySelector('.bi-check-lg');
  1066. if (check) check.classList.remove('d-none');
  1067. }
  1068. // Sync the topbar trigger icon
  1069. document.querySelectorAll('[data-lte-theme-icon]').forEach((icon) => {
  1070. icon.classList.toggle('d-none', icon.dataset.lteThemeIcon !== theme);
  1071. });
  1072. };
  1073. globalThis.matchMedia('(prefers-color-scheme: dark)').addEventListener('change', () => {
  1074. const stored = getStoredTheme();
  1075. if (!stored || stored === 'auto') setTheme(getPreferredTheme());
  1076. });
  1077. document.addEventListener('DOMContentLoaded', () => {
  1078. showActiveTheme(getPreferredTheme());
  1079. document.querySelectorAll('[data-bs-theme-value]').forEach((toggle) => {
  1080. toggle.addEventListener('click', () => {
  1081. const theme = toggle.getAttribute('data-bs-theme-value');
  1082. setStoredTheme(theme);
  1083. setTheme(theme);
  1084. showActiveTheme(theme);
  1085. });
  1086. });
  1087. });
  1088. })();
  1089. </script>
  1090. <!--end::Color Mode Toggle-->
  1091. </body>
  1092. </html>