From a1e70e663d24f41301ffef25cc05ec0426ce101d Mon Sep 17 00:00:00 2001
From: Simon <10131203+gaomeng1900@users.noreply.github.com>
Date: Wed, 14 Jan 2026 18:04:31 +0800
Subject: [PATCH] feat(PageController): exclude `aria-hidden` elements

---
 packages/page-controller/src/dom/dom_tree/index.js | 10 +++++++++-
 packages/website/src/components/Header.tsx         |  4 ++--
 2 files changed, 11 insertions(+), 3 deletions(-)

diff --git a/packages/page-controller/src/dom/dom_tree/index.js b/packages/page-controller/src/dom/dom_tree/index.js
index 43e9c73..6050419 100644
--- a/packages/page-controller/src/dom/dom_tree/index.js
+++ b/packages/page-controller/src/dom/dom_tree/index.js
@@ -16,6 +16,7 @@
  * @edit scrollable element detection
  * @edit add `data-browser-use-ignore` attribute
  * @edit improve `sampleRect`, filter out rects with 0 area
+ * @edit exclude aria-hidden elements
  */
 
 export default (
@@ -1446,7 +1447,14 @@ export default (
 		 * @edit add `data-browser-use-ignore` attribute
 		 */
 		if (node.dataset?.browserUseIgnore === 'true') {
-			return true // Skip this node and its children
+			return null // Skip this node and its children
+		}
+
+		/**
+		 * @edit exclude aria-hidden elements
+		 */
+		if (node.getAttribute && node.getAttribute('aria-hidden') === 'true') {
+			return null // Skip this node and its children
 		}
 
 		// Special handling for root node (body)
diff --git a/packages/website/src/components/Header.tsx b/packages/website/src/components/Header.tsx
index cd8f903..ae5e8cc 100644
--- a/packages/website/src/components/Header.tsx
+++ b/packages/website/src/components/Header.tsx
@@ -85,8 +85,8 @@ export default function Header() {
 							role="navigation"
 							aria-label={t('header.nav_docs')}
 						>
-							<span className="text-xs font-mono text-gray-400 dark:text-gray-500 tabular-nums">
-								v{import.meta.env.VERSION}
+							<span className="text-xs font-mono text-gray-400 dark:text-gray-500 tabular-nums before:content-['v']">
+								{import.meta.env.VERSION}
 							</span>
 							<Link
 								href="/docs/introduction/overview"