accessibility.html 41 KB

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