From 3014945e4d677d24124a3a01fe88ec82951ebfa7 Mon Sep 17 00:00:00 2001
From: Luffy <lufei@docsifyjs.org>
Date: Thu, 18 Sep 2025 10:39:35 +0800
Subject: [PATCH] fix: enhance accessibility for sidebar toggle button (#2604)

---
 src/core/event/index.js | 6 ++++--
 src/core/render/tpl.js  | 2 +-
 2 files changed, 5 insertions(+), 3 deletions(-)

diff --git a/src/core/event/index.js b/src/core/event/index.js
index e14ecf365..12fa3c78c 100644
--- a/src/core/event/index.js
+++ b/src/core/event/index.js
@@ -548,9 +548,11 @@ export function Events(Base) {
 
       // Set aria-expanded attribute
       ariaElms.forEach(toggleElm => {
+        const expanded = force ?? sidebarElm.classList.contains('show');
+        toggleElm.setAttribute('aria-expanded', expanded);
         toggleElm.setAttribute(
-          'aria-expanded',
-          force ?? sidebarElm.classList.contains('show'),
+          'aria-label',
+          expanded ? 'Hide primary navigation' : 'Show primary navigation',
         );
       });
 
diff --git a/src/core/render/tpl.js b/src/core/render/tpl.js
index eb208dde0..88b732a78 100644
--- a/src/core/render/tpl.js
+++ b/src/core/render/tpl.js
@@ -43,7 +43,7 @@ export function main(config) {
     ? ''
     : `
     <button class="sidebar-toggle" tabindex="-1" title="Press \\ to toggle">
-      <div class="sidebar-toggle-button" tabindex="0" aria-label="Toggle primary navigation" aria-keyshortcuts="\\" aria-controls="__sidebar">
+      <div class="sidebar-toggle-button" tabindex="0" aria-label="Hide primary navigation" aria-keyshortcuts="Use shortcut key \\" aria-controls="__sidebar" role="button">
         <span></span><span></span><span></span>
       </div>
     </button>