npm - @gkd-kit/docs - Versions diffs - 0.0.1719928845898 → 0.0.1719989757931 - Mend

@gkd-kit/docs 0.0.1719928845898 → 0.0.1719989757931

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 (50) hide show

package/.vitepress/dist/selector/example.html ADDED Viewed

@@ -0,0 +1,25 @@
+<!DOCTYPE html>
+<html lang="en-US" dir="ltr">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width,initial-scale=1">
+    <title>选择示例 | GKD</title>
+    <meta name="description" content="自定义屏幕点击应用">
+    <meta name="generator" content="VitePress v1.1.3">
+    <link rel="preload stylesheet" href="https://registry.npmmirror.com/@gkd-kit/docs/0.0.1719989757931/files/.vitepress/dist/assets/style.BBV4ZUFr.css" as="style">
+    <script type="module" src="https://registry.npmmirror.com/@gkd-kit/docs/0.0.1719989757931/files/.vitepress/dist/assets/app.hVwPPCzY.js"></script>
+    <link rel="preload" href="https://registry.npmmirror.com/@gkd-kit/docs/0.0.1719989757931/files/.vitepress/dist/assets/inter-roman-latin.Di8DUHzh.woff2" as="font" type="font/woff2" crossorigin>
+    <link rel="modulepreload" href="https://registry.npmmirror.com/@gkd-kit/docs/0.0.1719989757931/files/.vitepress/dist/assets/chunks/framework.clGm--7Y.js">
+    <link rel="modulepreload" href="https://registry.npmmirror.com/@gkd-kit/docs/0.0.1719989757931/files/.vitepress/dist/assets/chunks/theme.BzW4AUmb.js">
+    <link rel="modulepreload" href="https://registry.npmmirror.com/@gkd-kit/docs/0.0.1719989757931/files/.vitepress/dist/assets/selector_example.md.DB3O13PI.lean.js">
+    <link rel="icon" type="image/svg+xml" href="https://registry.npmmirror.com/@gkd-kit/docs/0.0.1706371840771/files/.vitepress/dist/logo.svg">
+    <script id="check-dark-mode">(()=>{const e=localStorage.getItem("vitepress-theme-appearance")||"auto",a=window.matchMedia("(prefers-color-scheme: dark)").matches;(!e||e==="auto"?a:e==="dark")&&document.documentElement.classList.add("dark")})();</script>
+    <script id="check-mac-os">document.documentElement.classList.toggle("mac",/Mac|iPhone|iPod|iPad/i.test(navigator.platform));</script>
+  </head>
+  <body>
+    <div id="app"><div class="Layout" data-v-b9d42860><!--[--><!--]--><!--[--><span tabindex="-1" data-v-a4386a08></span><a href="#VPContent" class="VPSkipLink visually-hidden" data-v-a4386a08> Skip to content </a><!--]--><!----><header class="VPNav" data-v-b9d42860 data-v-78f9b908><div class="VPNavBar has-sidebar top" data-v-78f9b908 data-v-edfa0a94><div class="wrapper" data-v-edfa0a94><div class="container" data-v-edfa0a94><div class="title" data-v-edfa0a94><div class="VPNavBarTitle has-sidebar" data-v-edfa0a94 data-v-493f3022><a class="title" href="/" data-v-493f3022><!--[--><!--]--><!--[--><img class="VPImage logo" src="https://registry.npmmirror.com/@gkd-kit/docs/0.0.1706371840771/files/.vitepress/dist/logo.svg" alt data-v-9104fcc7><!--]--><span data-v-493f3022>GKD</span><!--[--><!--]--></a></div></div><div class="content" data-v-edfa0a94><div class="content-body" data-v-edfa0a94><!--[--><!--]--><div class="VPNavBarSearch search" data-v-edfa0a94><!--[--><!----><div id="local-search"><button type="button" class="DocSearch DocSearch-Button" aria-label="Search"><span class="DocSearch-Button-Container"><span class="vp-icon DocSearch-Search-Icon"></span><span class="DocSearch-Button-Placeholder">Search</span></span><span class="DocSearch-Button-Keys"><kbd class="DocSearch-Button-Key"></kbd><kbd class="DocSearch-Button-Key">K</kbd></span></button></div><!--]--></div><nav aria-labelledby="main-nav-aria-label" class="VPNavBarMenu menu" data-v-edfa0a94 data-v-09e675c8><span id="main-nav-aria-label" class="visually-hidden" data-v-09e675c8>Main Navigation</span><!--[--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/" tabindex="0" data-v-09e675c8 data-v-33c36113><!--[--><span data-v-33c36113>首页</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/api/" tabindex="0" data-v-09e675c8 data-v-33c36113><!--[--><span data-v-33c36113>API</span><!--]--></a><!--]--><!--]--></nav><!----><div class="VPNavBarAppearance appearance" data-v-edfa0a94 data-v-3af8e4f3><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title="Switch to dark theme" aria-checked="false" data-v-3af8e4f3 data-v-17b25208 data-v-a847a470><span class="check" data-v-a847a470><span class="icon" data-v-a847a470><!--[--><span class="vpi-sun sun" data-v-17b25208></span><span class="vpi-moon moon" data-v-17b25208></span><!--]--></span></span></button></div><div class="VPSocialLinks VPNavBarSocialLinks social-links" data-v-edfa0a94 data-v-675a8bec data-v-9591a6f4><!--[--><a class="VPSocialLink no-icon" href="https://github.com/gkd-kit" aria-label="github" target="_blank" rel="noopener" data-v-9591a6f4 data-v-4e7cdece><span class="vpi-social-github"></span></a><!--]--></div><div class="VPFlyout VPNavBarExtra extra" data-v-edfa0a94 data-v-31eebaf6 data-v-1c16d6fe><button type="button" class="button" aria-haspopup="true" aria-expanded="false" aria-label="extra navigation" data-v-1c16d6fe><span class="vpi-more-horizontal icon" data-v-1c16d6fe></span></button><div class="menu" data-v-1c16d6fe><div class="VPMenu" data-v-1c16d6fe data-v-3f253781><!----><!--[--><!--[--><!----><div class="group" data-v-31eebaf6><div class="item appearance" data-v-31eebaf6><p class="label" data-v-31eebaf6>外观</p><div class="appearance-action" data-v-31eebaf6><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title="Switch to dark theme" aria-checked="false" data-v-31eebaf6 data-v-17b25208 data-v-a847a470><span class="check" data-v-a847a470><span class="icon" data-v-a847a470><!--[--><span class="vpi-sun sun" data-v-17b25208></span><span class="vpi-moon moon" data-v-17b25208></span><!--]--></span></span></button></div></div></div><div class="group" data-v-31eebaf6><div class="item social-links" data-v-31eebaf6><div class="VPSocialLinks social-links-list" data-v-31eebaf6 data-v-9591a6f4><!--[--><a class="VPSocialLink no-icon" href="https://github.com/gkd-kit" aria-label="github" target="_blank" rel="noopener" data-v-9591a6f4 data-v-4e7cdece><span class="vpi-social-github"></span></a><!--]--></div></div></div><!--]--><!--]--></div></div></div><!--[--><!--]--><button type="button" class="VPNavBarHamburger hamburger" aria-label="mobile navigation" aria-expanded="false" aria-controls="VPNavScreen" data-v-edfa0a94 data-v-c1b6d24b><span class="container" data-v-c1b6d24b><span class="top" data-v-c1b6d24b></span><span class="middle" data-v-c1b6d24b></span><span class="bottom" data-v-c1b6d24b></span></span></button></div></div></div></div><div class="divider" data-v-edfa0a94><div class="divider-line" data-v-edfa0a94></div></div></div><!----></header><div class="VPLocalNav has-sidebar empty" data-v-b9d42860 data-v-2fc12c07><div class="container" data-v-2fc12c07><button class="menu" aria-expanded="false" aria-controls="VPSidebarNav" data-v-2fc12c07><span class="vpi-align-left menu-icon" data-v-2fc12c07></span><span class="menu-text" data-v-2fc12c07>归档</span></button><div class="VPLocalNavOutlineDropdown" style="--vp-vh:0px;" data-v-2fc12c07 data-v-16777068><button data-v-16777068>返回顶部</button><!----></div></div></div><aside class="VPSidebar" data-v-b9d42860 data-v-dd035f77><div class="curtain" data-v-dd035f77></div><nav class="nav" id="VPSidebarNav" aria-labelledby="sidebar-aria-label" tabindex="-1" data-v-dd035f77><span class="visually-hidden" id="sidebar-aria-label" data-v-dd035f77> Sidebar Navigation </span><!--[--><!--]--><!--[--><div class="group" data-v-dd035f77><section class="VPSidebarItem level-0" data-v-dd035f77 data-v-234a6f37><div class="item" role="button" tabindex="0" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><h2 class="text" data-v-234a6f37>指引</h2><!----></div><div class="items" data-v-234a6f37><!--[--><div class="VPSidebarItem level-1 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/guide/" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>开始使用</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/subscription/" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>订阅规则</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/faq/" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>疑难解答</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="group" data-v-dd035f77><section class="VPSidebarItem level-0 has-active" data-v-dd035f77 data-v-234a6f37><div class="item" role="button" tabindex="0" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><h2 class="text" data-v-234a6f37>选择器</h2><!----></div><div class="items" data-v-234a6f37><!--[--><div class="VPSidebarItem level-1 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/selector/" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>语法介绍</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/selector/node.html" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>属性方法</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/selector/example.html" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>选择示例</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="group" data-v-dd035f77><section class="VPSidebarItem level-0 is-link" data-v-dd035f77 data-v-234a6f37><div class="item" tabindex="0" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/api/" data-v-234a6f37><!--[--><h2 class="text" data-v-234a6f37>API</h2><!--]--></a><!----></div><div class="items" data-v-234a6f37><!--[--><section class="VPSidebarItem level-1 collapsible collapsed" data-v-234a6f37><div class="item" role="button" tabindex="0" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><h3 class="text" data-v-234a6f37>Interfaces</h3><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-234a6f37><span class="vpi-chevron-right caret-icon" data-v-234a6f37></span></div></div><div class="items" data-v-234a6f37><!--[--><div class="VPSidebarItem level-2 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/api/interfaces/RawSubscription.html" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>RawSubscription</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/api/interfaces/RawApp.html" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>RawApp</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/api/interfaces/RawGlobalGroup.html" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>RawGlobalGroup</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/api/interfaces/RawCategory.html" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>RawCategory</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/api/interfaces/RawAppRule.html" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>RawAppRule</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/api/interfaces/RawAppGroup.html" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>RawAppGroup</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/api/interfaces/RawGlobalRule.html" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>RawGlobalRule</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/api/interfaces/RawGlobalApp.html" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>RawGlobalApp</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/api/interfaces/RawCommonProps.html" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>RawCommonProps</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/api/interfaces/RawRuleProps.html" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>RawRuleProps</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/api/interfaces/RawGroupProps.html" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>RawGroupProps</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/api/interfaces/RawAppRuleProps.html" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>RawAppRuleProps</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/api/interfaces/RawGlobalRuleProps.html" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>RawGlobalRuleProps</p><!--]--></a><!----></div><!----></div><!--]--></div></section><section class="VPSidebarItem level-1 collapsible collapsed" data-v-234a6f37><div class="item" role="button" tabindex="0" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><h3 class="text" data-v-234a6f37>Type Aliases</h3><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-234a6f37><span class="vpi-chevron-right caret-icon" data-v-234a6f37></span></div></div><div class="items" data-v-234a6f37><!--[--><div class="VPSidebarItem level-2 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/api/type-aliases/Position.html" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>Position</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/api/type-aliases/IArray.html" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>IArray</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/api/type-aliases/Integer.html" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>Integer</p><!--]--></a><!----></div><!----></div><!--]--></div></section><!--]--></div></section></div><!--]--><!--[--><!--]--></nav></aside><div class="VPContent has-sidebar" id="VPContent" data-v-b9d42860 data-v-d11c184b><div class="VPDoc has-sidebar has-aside" data-v-d11c184b data-v-2a2131eb><!--[--><!--]--><div class="container" data-v-2a2131eb><div class="aside" data-v-2a2131eb><div class="aside-curtain" data-v-2a2131eb></div><div class="aside-container" data-v-2a2131eb><div class="aside-content" data-v-2a2131eb><div class="VPDocAside" data-v-2a2131eb data-v-a631cc65><!--[--><!--]--><!--[--><!--]--><div class="VPDocAsideOutline" role="navigation" data-v-a631cc65 data-v-66d76b2e><div class="content" data-v-66d76b2e><div class="outline-marker" data-v-66d76b2e></div><div class="outline-title" role="heading" aria-level="2" data-v-66d76b2e>导航栏</div><nav aria-labelledby="doc-outline-aria-label" data-v-66d76b2e><span class="visually-hidden" id="doc-outline-aria-label" data-v-66d76b2e> Table of Contents for current page </span><ul class="VPDocOutlineItem root" data-v-66d76b2e data-v-00dc6f9f><!--[--><!--]--></ul></nav></div></div><!--[--><!--]--><div class="spacer" data-v-a631cc65></div><!--[--><!--]--><!----><!--[--><!--]--><!--[--><!--]--></div></div></div></div><div class="content" data-v-2a2131eb><div class="content-container" data-v-2a2131eb><!--[--><!--]--><main class="main" data-v-2a2131eb><div style="position:relative;" class="vp-doc _selector_example" data-v-2a2131eb><div><h1 id="title" tabindex="-1">选择示例 <a class="header-anchor" href="#title" aria-label="Permalink to &quot;选择示例 {#title}&quot;"></a></h1><p>懒得写了，欢迎向 <a href="https://github.com/gkd-kit/docs" target="_blank" rel="noreferrer">gkd-kit/docs</a> 提交 pull request</p></div></div></main><footer class="VPDocFooter" data-v-2a2131eb data-v-74c3426e><!--[--><!--]--><div class="edit-info" data-v-74c3426e><div class="edit-link" data-v-74c3426e><a class="VPLink link vp-external-link-icon no-icon edit-link-button" href="https://github.com/gkd-kit/docs/edit/main/docs/selector/example.md" target="_blank" rel="noreferrer" data-v-74c3426e><!--[--><span class="vpi-square-pen edit-link-icon" data-v-74c3426e></span> 为此页提供修改建议<!--]--></a></div><div class="last-updated" data-v-74c3426e><p class="VPLastUpdated" data-v-74c3426e data-v-b9e7ea1d>最后更新于: <time datetime="2024-07-03T06:55:37.000Z" data-v-b9e7ea1d></time></p></div></div><nav class="prev-next" data-v-74c3426e><div class="pager" data-v-74c3426e><a class="VPLink link pager-link prev" href="/selector/node.html" data-v-74c3426e><!--[--><span class="desc" data-v-74c3426e>上一篇</span><span class="title" data-v-74c3426e>属性方法</span><!--]--></a></div><div class="pager" data-v-74c3426e><a class="VPLink link pager-link next" href="/api/" data-v-74c3426e><!--[--><span class="desc" data-v-74c3426e>下一篇</span><span class="title" data-v-74c3426e>API</span><!--]--></a></div></nav></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><footer class="VPFooter has-sidebar" data-v-b9d42860 data-v-3a780ff6><div class="container" data-v-3a780ff6><p class="message" data-v-3a780ff6>Released under the GPL-v3 License.</p><p class="copyright" data-v-3a780ff6>Copyright © 2024 GKD. All rights reserved</p></div></footer><!--[--><!--]--></div></div>
+    <script>window.__VP_HASH_MAP__=JSON.parse("{\"faq_index.md\":\"d1Z8UZui\",\"api_interfaces_rawgroupprops.md\":\"DG4T80Dd\",\"selector_example.md\":\"DB3O13PI\",\"api_interfaces_rawglobalgroup.md\":\"BmaW8-Ss\",\"index.md\":\"yUr0-dxg\",\"subscription_index.md\":\"C0g0gfoU\",\"selector_index.md\":\"CXZu3Zbq\",\"api_interfaces_rawglobalruleprops.md\":\"D-CtCTHV\",\"api_interfaces_rawglobalrule.md\":\"BCMr3k_N\",\"api_interfaces_rawapp.md\":\"JuMOId3h\",\"api_interfaces_rawsubscription.md\":\"Cz9K1wkj\",\"api_type-aliases_iarray.md\":\"CP0181Bu\",\"api_interfaces_rawappruleprops.md\":\"C_Lr7qrT\",\"api_interfaces_rawcommonprops.md\":\"CWJwfhiQ\",\"api_type-aliases_position.md\":\"qJyyaDP6\",\"api_type-aliases_integer.md\":\"scVDRZuk\",\"api_interfaces_rawruleprops.md\":\"CRh5KyPR\",\"api_interfaces_rawglobalapp.md\":\"CCc1R6pz\",\"selector_node.md\":\"BV9tVGi_\",\"guide_index.md\":\"CxNC2DVO\",\"api_interfaces_rawcategory.md\":\"BqxO20ig\",\"api_index.md\":\"4ccPi_ZZ\",\"api_interfaces_rawappgroup.md\":\"C33JkI_D\",\"api_interfaces_rawapprule.md\":\"BtiA0bcN\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"en-US\",\"dir\":\"ltr\",\"title\":\"GKD\",\"description\":\"自定义屏幕点击应用\",\"base\":\"/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"logo\":\"https://registry.npmmirror.com/@gkd-kit/docs/0.0.1706371840771/files/.vitepress/dist/logo.svg\",\"lastUpdatedText\":\"最后更新于\",\"outline\":\"deep\",\"docFooter\":{\"prev\":\"上一篇\",\"next\":\"下一篇\"},\"returnToTopLabel\":\"返回顶部\",\"outlineTitle\":\"导航栏\",\"darkModeSwitchLabel\":\"外观\",\"sidebarMenuLabel\":\"归档\",\"nav\":[{\"text\":\"首页\",\"link\":\"/\"},{\"text\":\"API\",\"link\":\"/api/\"}],\"sidebar\":[{\"text\":\"指引\",\"items\":[{\"text\":\"开始使用\",\"link\":\"/guide/\"},{\"text\":\"订阅规则\",\"link\":\"/subscription/\"},{\"text\":\"疑难解答\",\"link\":\"/faq/\"}]},{\"text\":\"选择器\",\"items\":[{\"text\":\"语法介绍\",\"link\":\"/selector/\"},{\"text\":\"属性方法\",\"link\":\"/selector/node\"},{\"text\":\"选择示例\",\"link\":\"/selector/example\"}]},{\"text\":\"API\",\"link\":\"/api/\",\"items\":[{\"text\":\"Interfaces\",\"collapsed\":true,\"items\":[{\"text\":\"RawSubscription\",\"link\":\"/api/interfaces/RawSubscription.md\"},{\"text\":\"RawApp\",\"link\":\"/api/interfaces/RawApp.md\"},{\"text\":\"RawGlobalGroup\",\"link\":\"/api/interfaces/RawGlobalGroup.md\"},{\"text\":\"RawCategory\",\"link\":\"/api/interfaces/RawCategory.md\"},{\"text\":\"RawAppRule\",\"link\":\"/api/interfaces/RawAppRule.md\"},{\"text\":\"RawAppGroup\",\"link\":\"/api/interfaces/RawAppGroup.md\"},{\"text\":\"RawGlobalRule\",\"link\":\"/api/interfaces/RawGlobalRule.md\"},{\"text\":\"RawGlobalApp\",\"link\":\"/api/interfaces/RawGlobalApp.md\"},{\"text\":\"RawCommonProps\",\"link\":\"/api/interfaces/RawCommonProps.md\"},{\"text\":\"RawRuleProps\",\"link\":\"/api/interfaces/RawRuleProps.md\"},{\"text\":\"RawGroupProps\",\"link\":\"/api/interfaces/RawGroupProps.md\"},{\"text\":\"RawAppRuleProps\",\"link\":\"/api/interfaces/RawAppRuleProps.md\"},{\"text\":\"RawGlobalRuleProps\",\"link\":\"/api/interfaces/RawGlobalRuleProps.md\"}]},{\"text\":\"Type Aliases\",\"collapsed\":true,\"items\":[{\"text\":\"Position\",\"link\":\"/api/type-aliases/Position.md\"},{\"text\":\"IArray\",\"link\":\"/api/type-aliases/IArray.md\"},{\"text\":\"Integer\",\"link\":\"/api/type-aliases/Integer.md\"}]}]}],\"editLink\":{\"pattern\":\"https://github.com/gkd-kit/docs/edit/main/docs/:path\",\"text\":\"为此页提供修改建议\"},\"search\":{\"provider\":\"local\",\"options\":{}},\"socialLinks\":[{\"icon\":\"github\",\"link\":\"https://github.com/gkd-kit\"}],\"footer\":{\"message\":\"Released under the GPL-v3 License.\",\"copyright\":\"Copyright © 2024 GKD. All rights reserved\"}},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":false}");</script>
+  </body>
+</html>

package/.vitepress/dist/selector/index.html CHANGED Viewed

@@ -6,19 +6,19 @@
     <title>选择器 | GKD</title>
     <meta name="description" content="自定义屏幕点击应用">
     <meta name="generator" content="VitePress v1.1.3">
-    <link rel="preload stylesheet" href="https://registry.npmmirror.com/@gkd-kit/docs/0.0.1719928845898/files/.vitepress/dist/assets/style.BBV4ZUFr.css" as="style">
+    <link rel="preload stylesheet" href="https://registry.npmmirror.com/@gkd-kit/docs/0.0.1719989757931/files/.vitepress/dist/assets/style.BBV4ZUFr.css" as="style">
-    <script type="module" src="https://registry.npmmirror.com/@gkd-kit/docs/0.0.1719928845898/files/.vitepress/dist/assets/app.EZTUYKs4.js"></script>
-    <link rel="preload" href="https://registry.npmmirror.com/@gkd-kit/docs/0.0.1719928845898/files/.vitepress/dist/assets/inter-roman-latin.Di8DUHzh.woff2" as="font" type="font/woff2" crossorigin>
-    <link rel="modulepreload" href="https://registry.npmmirror.com/@gkd-kit/docs/0.0.1719928845898/files/.vitepress/dist/assets/chunks/framework.clGm--7Y.js">
-    <link rel="modulepreload" href="https://registry.npmmirror.com/@gkd-kit/docs/0.0.1719928845898/files/.vitepress/dist/assets/chunks/theme.DbvY7W0z.js">
-    <link rel="modulepreload" href="https://registry.npmmirror.com/@gkd-kit/docs/0.0.1719928845898/files/.vitepress/dist/assets/selector_index.md.BGY0jCyS.lean.js">
+    <script type="module" src="https://registry.npmmirror.com/@gkd-kit/docs/0.0.1719989757931/files/.vitepress/dist/assets/app.hVwPPCzY.js"></script>
+    <link rel="preload" href="https://registry.npmmirror.com/@gkd-kit/docs/0.0.1719989757931/files/.vitepress/dist/assets/inter-roman-latin.Di8DUHzh.woff2" as="font" type="font/woff2" crossorigin>
+    <link rel="modulepreload" href="https://registry.npmmirror.com/@gkd-kit/docs/0.0.1719989757931/files/.vitepress/dist/assets/chunks/framework.clGm--7Y.js">
+    <link rel="modulepreload" href="https://registry.npmmirror.com/@gkd-kit/docs/0.0.1719989757931/files/.vitepress/dist/assets/chunks/theme.BzW4AUmb.js">
+    <link rel="modulepreload" href="https://registry.npmmirror.com/@gkd-kit/docs/0.0.1719989757931/files/.vitepress/dist/assets/selector_index.md.CXZu3Zbq.lean.js">
     <link rel="icon" type="image/svg+xml" href="https://registry.npmmirror.com/@gkd-kit/docs/0.0.1706371840771/files/.vitepress/dist/logo.svg">
     <script id="check-dark-mode">(()=>{const e=localStorage.getItem("vitepress-theme-appearance")||"auto",a=window.matchMedia("(prefers-color-scheme: dark)").matches;(!e||e==="auto"?a:e==="dark")&&document.documentElement.classList.add("dark")})();</script>
     <script id="check-mac-os">document.documentElement.classList.toggle("mac",/Mac|iPhone|iPod|iPad/i.test(navigator.platform));</script>
   </head>
   <body>
-    <div id="app"><div class="Layout" data-v-b9d42860><!--[--><!--]--><!--[--><span tabindex="-1" data-v-a4386a08></span><a href="#VPContent" class="VPSkipLink visually-hidden" data-v-a4386a08> Skip to content </a><!--]--><!----><header class="VPNav" data-v-b9d42860 data-v-78f9b908><div class="VPNavBar has-sidebar top" data-v-78f9b908 data-v-edfa0a94><div class="wrapper" data-v-edfa0a94><div class="container" data-v-edfa0a94><div class="title" data-v-edfa0a94><div class="VPNavBarTitle has-sidebar" data-v-edfa0a94 data-v-493f3022><a class="title" href="/" data-v-493f3022><!--[--><!--]--><!--[--><img class="VPImage logo" src="https://registry.npmmirror.com/@gkd-kit/docs/0.0.1706371840771/files/.vitepress/dist/logo.svg" alt data-v-9104fcc7><!--]--><span data-v-493f3022>GKD</span><!--[--><!--]--></a></div></div><div class="content" data-v-edfa0a94><div class="content-body" data-v-edfa0a94><!--[--><!--]--><div class="VPNavBarSearch search" data-v-edfa0a94><!--[--><!----><div id="local-search"><button type="button" class="DocSearch DocSearch-Button" aria-label="Search"><span class="DocSearch-Button-Container"><span class="vp-icon DocSearch-Search-Icon"></span><span class="DocSearch-Button-Placeholder">Search</span></span><span class="DocSearch-Button-Keys"><kbd class="DocSearch-Button-Key"></kbd><kbd class="DocSearch-Button-Key">K</kbd></span></button></div><!--]--></div><nav aria-labelledby="main-nav-aria-label" class="VPNavBarMenu menu" data-v-edfa0a94 data-v-09e675c8><span id="main-nav-aria-label" class="visually-hidden" data-v-09e675c8>Main Navigation</span><!--[--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/" tabindex="0" data-v-09e675c8 data-v-33c36113><!--[--><span data-v-33c36113>首页</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/api/" tabindex="0" data-v-09e675c8 data-v-33c36113><!--[--><span data-v-33c36113>API</span><!--]--></a><!--]--><!--]--></nav><!----><div class="VPNavBarAppearance appearance" data-v-edfa0a94 data-v-3af8e4f3><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title="Switch to dark theme" aria-checked="false" data-v-3af8e4f3 data-v-17b25208 data-v-a847a470><span class="check" data-v-a847a470><span class="icon" data-v-a847a470><!--[--><span class="vpi-sun sun" data-v-17b25208></span><span class="vpi-moon moon" data-v-17b25208></span><!--]--></span></span></button></div><div class="VPSocialLinks VPNavBarSocialLinks social-links" data-v-edfa0a94 data-v-675a8bec data-v-9591a6f4><!--[--><a class="VPSocialLink no-icon" href="https://github.com/gkd-kit" aria-label="github" target="_blank" rel="noopener" data-v-9591a6f4 data-v-4e7cdece><span class="vpi-social-github"></span></a><!--]--></div><div class="VPFlyout VPNavBarExtra extra" data-v-edfa0a94 data-v-31eebaf6 data-v-1c16d6fe><button type="button" class="button" aria-haspopup="true" aria-expanded="false" aria-label="extra navigation" data-v-1c16d6fe><span class="vpi-more-horizontal icon" data-v-1c16d6fe></span></button><div class="menu" data-v-1c16d6fe><div class="VPMenu" data-v-1c16d6fe data-v-3f253781><!----><!--[--><!--[--><!----><div class="group" data-v-31eebaf6><div class="item appearance" data-v-31eebaf6><p class="label" data-v-31eebaf6>外观</p><div class="appearance-action" data-v-31eebaf6><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title="Switch to dark theme" aria-checked="false" data-v-31eebaf6 data-v-17b25208 data-v-a847a470><span class="check" data-v-a847a470><span class="icon" data-v-a847a470><!--[--><span class="vpi-sun sun" data-v-17b25208></span><span class="vpi-moon moon" data-v-17b25208></span><!--]--></span></span></button></div></div></div><div class="group" data-v-31eebaf6><div class="item social-links" data-v-31eebaf6><div class="VPSocialLinks social-links-list" data-v-31eebaf6 data-v-9591a6f4><!--[--><a class="VPSocialLink no-icon" href="https://github.com/gkd-kit" aria-label="github" target="_blank" rel="noopener" data-v-9591a6f4 data-v-4e7cdece><span class="vpi-social-github"></span></a><!--]--></div></div></div><!--]--><!--]--></div></div></div><!--[--><!--]--><button type="button" class="VPNavBarHamburger hamburger" aria-label="mobile navigation" aria-expanded="false" aria-controls="VPNavScreen" data-v-edfa0a94 data-v-c1b6d24b><span class="container" data-v-c1b6d24b><span class="top" data-v-c1b6d24b></span><span class="middle" data-v-c1b6d24b></span><span class="bottom" data-v-c1b6d24b></span></span></button></div></div></div></div><div class="divider" data-v-edfa0a94><div class="divider-line" data-v-edfa0a94></div></div></div><!----></header><div class="VPLocalNav has-sidebar empty" data-v-b9d42860 data-v-2fc12c07><div class="container" data-v-2fc12c07><button class="menu" aria-expanded="false" aria-controls="VPSidebarNav" data-v-2fc12c07><span class="vpi-align-left menu-icon" data-v-2fc12c07></span><span class="menu-text" data-v-2fc12c07>归档</span></button><div class="VPLocalNavOutlineDropdown" style="--vp-vh:0px;" data-v-2fc12c07 data-v-16777068><button data-v-16777068>返回顶部</button><!----></div></div></div><aside class="VPSidebar" data-v-b9d42860 data-v-dd035f77><div class="curtain" data-v-dd035f77></div><nav class="nav" id="VPSidebarNav" aria-labelledby="sidebar-aria-label" tabindex="-1" data-v-dd035f77><span class="visually-hidden" id="sidebar-aria-label" data-v-dd035f77> Sidebar Navigation </span><!--[--><!--]--><!--[--><div class="group" data-v-dd035f77><section class="VPSidebarItem level-0" data-v-dd035f77 data-v-234a6f37><div class="item" role="button" tabindex="0" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><h2 class="text" data-v-234a6f37>指引</h2><!----></div><div class="items" data-v-234a6f37><!--[--><div class="VPSidebarItem level-1 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/guide/" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>开始使用</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/subscription/" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>订阅规则</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/faq/" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>疑难解答</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="group" data-v-dd035f77><section class="VPSidebarItem level-0 has-active" data-v-dd035f77 data-v-234a6f37><div class="item" role="button" tabindex="0" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><h2 class="text" data-v-234a6f37>选择器</h2><!----></div><div class="items" data-v-234a6f37><!--[--><div class="VPSidebarItem level-1 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/selector/" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>语法介绍</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/selector/node.html" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>属性方法</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="group" data-v-dd035f77><section class="VPSidebarItem level-0 is-link" data-v-dd035f77 data-v-234a6f37><div class="item" tabindex="0" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/api/" data-v-234a6f37><!--[--><h2 class="text" data-v-234a6f37>API</h2><!--]--></a><!----></div><div class="items" data-v-234a6f37><!--[--><section class="VPSidebarItem level-1 collapsible collapsed" data-v-234a6f37><div class="item" role="button" tabindex="0" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><h3 class="text" data-v-234a6f37>Interfaces</h3><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-234a6f37><span class="vpi-chevron-right caret-icon" data-v-234a6f37></span></div></div><div class="items" data-v-234a6f37><!--[--><div class="VPSidebarItem level-2 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/api/interfaces/RawSubscription.html" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>RawSubscription</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/api/interfaces/RawApp.html" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>RawApp</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/api/interfaces/RawGlobalGroup.html" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>RawGlobalGroup</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/api/interfaces/RawCategory.html" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>RawCategory</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/api/interfaces/RawAppRule.html" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>RawAppRule</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/api/interfaces/RawAppGroup.html" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>RawAppGroup</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/api/interfaces/RawGlobalRule.html" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>RawGlobalRule</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/api/interfaces/RawGlobalApp.html" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>RawGlobalApp</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/api/interfaces/RawCommonProps.html" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>RawCommonProps</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/api/interfaces/RawRuleProps.html" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>RawRuleProps</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/api/interfaces/RawGroupProps.html" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>RawGroupProps</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/api/interfaces/RawAppRuleProps.html" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>RawAppRuleProps</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/api/interfaces/RawGlobalRuleProps.html" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>RawGlobalRuleProps</p><!--]--></a><!----></div><!----></div><!--]--></div></section><section class="VPSidebarItem level-1 collapsible collapsed" data-v-234a6f37><div class="item" role="button" tabindex="0" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><h3 class="text" data-v-234a6f37>Type Aliases</h3><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-234a6f37><span class="vpi-chevron-right caret-icon" data-v-234a6f37></span></div></div><div class="items" data-v-234a6f37><!--[--><div class="VPSidebarItem level-2 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/api/type-aliases/Position.html" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>Position</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/api/type-aliases/IArray.html" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>IArray</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/api/type-aliases/Integer.html" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>Integer</p><!--]--></a><!----></div><!----></div><!--]--></div></section><!--]--></div></section></div><!--]--><!--[--><!--]--></nav></aside><div class="VPContent has-sidebar" id="VPContent" data-v-b9d42860 data-v-d11c184b><div class="VPDoc has-sidebar has-aside" data-v-d11c184b data-v-2a2131eb><!--[--><!--]--><div class="container" data-v-2a2131eb><div class="aside" data-v-2a2131eb><div class="aside-curtain" data-v-2a2131eb></div><div class="aside-container" data-v-2a2131eb><div class="aside-content" data-v-2a2131eb><div class="VPDocAside" data-v-2a2131eb data-v-a631cc65><!--[--><!--]--><!--[--><!--]--><div class="VPDocAsideOutline" role="navigation" data-v-a631cc65 data-v-66d76b2e><div class="content" data-v-66d76b2e><div class="outline-marker" data-v-66d76b2e></div><div class="outline-title" role="heading" aria-level="2" data-v-66d76b2e>导航栏</div><nav aria-labelledby="doc-outline-aria-label" data-v-66d76b2e><span class="visually-hidden" id="doc-outline-aria-label" data-v-66d76b2e> Table of Contents for current page </span><ul class="VPDocOutlineItem root" data-v-66d76b2e data-v-00dc6f9f><!--[--><!--]--></ul></nav></div></div><!--[--><!--]--><div class="spacer" data-v-a631cc65></div><!--[--><!--]--><!----><!--[--><!--]--><!--[--><!--]--></div></div></div></div><div class="content" data-v-2a2131eb><div class="content-container" data-v-2a2131eb><!--[--><!--]--><main class="main" data-v-2a2131eb><div style="position:relative;" class="vp-doc _selector_" data-v-2a2131eb><div><h1 id="title" tabindex="-1">选择器 <a class="header-anchor" href="#title" aria-label="Permalink to &quot;选择器 {#title}&quot;"></a></h1><p>一个类似 CSS 选择器的选择器, 能联系节点上下文信息, 更容易也更精确找到目标节点</p><h2 id="why" tabindex="-1">为什么需要选择器 <a class="header-anchor" href="#why" aria-label="Permalink to &quot;为什么需要选择器 {#why}&quot;"></a></h2><p>我们的目的是查询获取屏幕上的某个节点, 最简单的情况下, 目标节点已经有唯一的 id/text 标识</p><p>这时只需要配置 id/text 就能简单执行点击, 但实际情况很多节点都缺失了这些信息, 无法简单查询获取</p><p>节点还存在很多额外信息没有被利用到, 节点所有属性可以在 <a href="https://i.gkd.li/i/14045424" target="_blank" rel="noreferrer">快照-14045424</a> 的属性面板看到</p><p>另一种常见的情况是节点没有有效属性, 这时我们需要根据周围的节点去定位</p><p>选择器就是为了解决这些问题而开发的, 下面是对选择器的详细介绍</p><h2 id="syntax" tabindex="-1">语法 <a class="header-anchor" href="#syntax" aria-label="Permalink to &quot;语法 {#syntax}&quot;"></a></h2><p>与 CSS 类似, 一个选择器由 属性选择器 和 关系选择器 交叉组成, 并且开头末尾必须是 属性选择器</p><p>示例 <code>div > img</code> 的结构是 <code>属性选择器 关系选择器 属性选择器</code>, 它表示选择父节点是 <code>div</code> 的 <code>img</code> 节点, 这与 <a href="https://developer.mozilla.org/zh-CN/docs/Web/CSS/Child_combinator" target="_blank" rel="noreferrer">相同 CSS 语法</a> 语义一致</p><p>另外 属性选择器 和 关系选择器 之间必须<strong>强制</strong>用 空白字符(空格/换行/回车/制表) 隔开</p><p>即 <code>div>img</code> 非法, 必须写成 <code>div > img</code></p><p>下面分别介绍 <a href="#attr">属性选择器</a> 和 <a href="#connect">关系选择器</a></p><h2 id="attr" tabindex="-1">属性选择 <a class="header-anchor" href="#attr" aria-label="Permalink to &quot;属性选择 {#attr}&quot;"></a></h2><p>它和 CSS 语法的 属性选择器很相似, 但更强大, 如下是一个示例</p><p><code>@TextView[a=1][b^='2'][c*='a'||d.length>7&&e=false][!(f=true)][g.plus(1)>0]</code></p><p><code>@</code> 表示选择此节点, 一条规则最后属性选择器 <code>@</code> 生效, 如果没有 <code>@</code>, 取最后一个属性选择器</p><p><code>TextView</code> 代表节点的 name 属性, 而且与 CSS 相似, <code>*</code> 表示匹配任意属性</p><p>由于该选择器主要用于 Android 平台, 节点的 name 都是 java 类如 android.text.TextView 这种形式</p><p>为了方便书写规则, 上述 <code>TextView</code> 等价 <code>[name='TextView'||name$='.TextView']</code></p><p><code>[]</code> 内部是一个 逻辑表达式/布尔表达式/取反表达式</p><ul><li>逻辑表达式 -> <code>name='TextView'||name$='.TextView'</code></li><li>布尔表达式 -> <code>name='TextView'</code></li><li>取反表达式 -> <code>!(name$='TextView')</code>, <code>!(name='TextView'||name$='.TextView')</code></li></ul><p>注意 取反表达式 后面必须是 <code>(...)</code>, <code>!!(...)</code> 是非法的</p><p>逻辑表达式 有两个操作符 <code>||</code> 和 <code>&&</code>. <code>&&</code> 优先级更高</p><p>即 <code>[a>1||b>1&&c>1||d>1]</code> 等价于 <code>[a>1||(b>1&&c>1)||d>1]</code></p><p>并列的 <code>[]</code> 视为使用 <code>&&</code> 的逻辑表达式, 即 <code>[a=1][b=1]</code> 等价于 <code>[a=1&&b=1]</code></p><p>布尔表达式 由 <code>左值 操作符 右值</code> 构成, 左值/右值 是一个 值表达式</p><p>下面分别介绍 <a href="#value-exp">值表达式</a> 和 <a href="#attr-operator">操作符</a></p><h2 id="value-exp" tabindex="-1">值表达式 <a class="header-anchor" href="#value-exp" aria-label="Permalink to &quot;值表达式 {#value-exp}&quot;"></a></h2><p>值表达式分两类: 变量 和 字面量, 下图是关系表格</p><table><thead><tr><th colspan="2"><div text-center>值表达式</div></th><th>示例</th></tr></thead><tbody><tr><td rowspan="3">变量</td><td>标识符</td><td><code> a </code></td></tr><tr><td>成员表达式</td><td><code>a.b</code></td></tr><tr><td>调用表达式</td><td><code>a(b,c)</code></td></tr><tr><td rowspan="4">字面量</td><td>null</td><td><code>null</code></td></tr><tr><td>boolean</td><td><code>false</code></td></tr><tr><td>int</td><td><code>114514</code></td></tr><tr><td>string</td><td><code>'ikun'</code></td></tr></tbody></table><p>每个值表达式都有其类型, 可细分为两类</p><p>基础类型: <code>null</code> <code>boolean</code> <code>int</code> <code>string</code></p><p>对象类型: <code>object</code></p><p>对象类型可细分为 <code>context</code> 和 <code>node</code> 两种类型</p><p>比如选择器 <code>[parent=null]</code> 代表选择一个父节点是 null 的节点, 即根节点</p><p>上面的 <code>parent</code> 属于 值表达式/变量/标识符, 类型是 <code>node</code></p><p><code>context</code> 类型指代当前节点的上下文, 当想使用不属于 <code>node</code> 上的属性方法时就需要 <code>context</code></p><h3 id="var" tabindex="-1">变量 <a class="header-anchor" href="#var" aria-label="Permalink to &quot;变量 {#var}&quot;"></a></h3><p>首先需要了解 <strong>标识符</strong>: 正则匹配 <code>^[_a-zA-Z][a-zA-Z0-9_]*$</code> 并且不是 <code>null</code>/<code>true</code>/<code>false</code> 的字符串</p><p>示例合法变量名: <code>a</code> <code>ikun</code> <code>manbaout</code>, 下面可输入字符测试否是合法</p><div class="vp-raw"><div><input placeholder="请输入标识符测试是否合法" type="text" value class="flex h-9 w-full rounded-md border border-input bg-transparent px-3 py-1 text-sm shadow-sm transition-colors file:border-0 file:bg-transparent file:text-sm file:font-medium placeholder:text-muted-foreground focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring disabled:cursor-not-allowed disabled:opacity-50"><div mt-4px class="color-red opacity-0">非法标识符❌</div></div></div><hr><p>接下来了解 <strong>成员表达式</strong> <code>a.b</code>, 它被 <code>.</code> 分为两个部分, 前部分是另一个变量, 后部分是一个标识符作为属性</p><p>同理 <code>a.b.c</code> 也是一个 成员表达式, 其中 <code>a.b</code> 是它的变量部分, <code>c</code> 是一个合法的标识符作为属性</p><p>根据上面标识符的规则, <code>a.1</code>, <code>a.null</code>, <code>a.true</code> 都是非法成员表达式</p><hr><p>最后了解 <strong>调用表达式</strong> <code>a(b,c)</code>, 它由两个部分构成, <code>(</code> 的左侧 <code>a</code> 是一个变量作为 调用者</p><p><code>(c,d)</code> 作为调用参数(值类型), 调用参数数量可以是 0 或任意个, 即 <code>a()</code> 也是合法的</p><p>合法的其它例子: <code>a.b(c,d).e(f).g(1,2,true)</code></p><p>需要注意调用者不能是 调用表达式, 即 <code>a()()</code> 非法</p><h3 id="literal" tabindex="-1">字面量 <a class="header-anchor" href="#literal" aria-label="Permalink to &quot;字面量 {#literal}&quot;"></a></h3><p>根据上面的表格, 字面量有 4 种: <code>null</code>, <code>boolean</code>, <code>int</code>, <code>string</code></p><ul><li>null</li><li>boolean 使用 <code>true</code>/<code>false</code></li><li>int 匹配 <code>^-?[0-9]$</code>, 即10进制自然数, 示例 <code>-1</code>,<code>0</code>,<code>1</code>, 不支持 <code>+1</code> 这种写法</li><li>string 使用 ' ` " 之一成对包裹, 内部字符转义使用 <code>\</code><br> 所有的转义字符示例 <code>\\</code>, <code>\'</code>, <code>\"</code>, <code>\`</code>, <code>\n</code>, <code>\r</code>, <code>\t</code>, <code>\b</code>, <code>\xfF</code>, <code>\uffFF</code><br> 不支持多行字符, 处于 <code>[0, 0x1F]</code> 的控制字符必须使用转义字符表示</li></ul><p>此外使用 string 时需要了解 <a href="#nest-escape">嵌套转义字符</a> 以避免出现错误</p><h2 id="attr-operator" tabindex="-1">操作符 <a class="header-anchor" href="#attr-operator" aria-label="Permalink to &quot;操作符 {#attr-operator}&quot;"></a></h2><p>操作符 用于连接两个 值表达式</p><table><thead><tr><th style="text-align:center;">操作符</th><th style="text-align:center;">名称</th><th style="text-align:center;">说明</th></tr></thead><tbody><tr><td style="text-align:center;">=</td><td style="text-align:center;">equal</td><td style="text-align:center;"></td></tr><tr><td style="text-align:center;">!=</td><td style="text-align:center;">notEqual</td><td style="text-align:center;"></td></tr><tr><td style="text-align:center;">></td><td style="text-align:center;">more</td><td style="text-align:center;"></td></tr><tr><td style="text-align:center;">>=</td><td style="text-align:center;">moreEqual</td><td style="text-align:center;"></td></tr><tr><td style="text-align:center;"><</td><td style="text-align:center;">less</td><td style="text-align:center;"></td></tr><tr><td style="text-align:center;"><=</td><td style="text-align:center;">lessEqual</td><td style="text-align:center;"></td></tr><tr><td style="text-align:center;">^=</td><td style="text-align:center;">startsWith</td><td style="text-align:center;">以...开头</td></tr><tr><td style="text-align:center;">!^=</td><td style="text-align:center;">notStartsWith</td><td style="text-align:center;">不以...开头</td></tr><tr><td style="text-align:center;">*=</td><td style="text-align:center;">contains</td><td style="text-align:center;">包含...</td></tr><tr><td style="text-align:center;">!^=</td><td style="text-align:center;">notContains</td><td style="text-align:center;">不包含...</td></tr><tr><td style="text-align:center;">$=</td><td style="text-align:center;">endsWith</td><td style="text-align:center;">以...结尾</td></tr><tr><td style="text-align:center;">!$=</td><td style="text-align:center;">notEndsWith</td><td style="text-align:center;">不以...结尾</td></tr><tr><td style="text-align:center;">~=</td><td style="text-align:center;">matches</td><td style="text-align:center;">正则匹配...</td></tr><tr><td style="text-align:center;">!~=</td><td style="text-align:center;">notMatches</td><td style="text-align:center;">正则不匹配...</td></tr></tbody></table><p>附加说明: <code>matches</code>/<code>notMatches</code> 要求 值 必须是合法的 <a href="https://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html" target="_blank" rel="noreferrer">Java/Kotlin 正则表达式</a>, 否则提示语法错误</p><p>并且 <code>matches</code>/<code>notMatches</code> 右侧的值只能是 字面量/字符串</p><p>操作符只能使用在对应的类型的值, 比如 <code>a>''</code> 类型不匹配, 将提示 <code>非法类型</code></p><p>下面表格中 <code>-</code> 表示类型不匹配</p><table><thead><tr><th style="text-align:center;"></th><th style="text-align:center;">null</th><th style="text-align:center;">boolean</th><th style="text-align:center;">int</th><th style="text-align:center;">string</th></tr></thead><tbody><tr><td style="text-align:center;">=</td><td style="text-align:center;">✔</td><td style="text-align:center;">✔</td><td style="text-align:center;">✔</td><td style="text-align:center;">✔</td></tr><tr><td style="text-align:center;">!=</td><td style="text-align:center;">✔</td><td style="text-align:center;">✔</td><td style="text-align:center;">✔</td><td style="text-align:center;">✔</td></tr><tr><td style="text-align:center;">></td><td style="text-align:center;">-</td><td style="text-align:center;">-</td><td style="text-align:center;">✔</td><td style="text-align:center;">-</td></tr><tr><td style="text-align:center;">>=</td><td style="text-align:center;">-</td><td style="text-align:center;">-</td><td style="text-align:center;">✔</td><td style="text-align:center;">-</td></tr><tr><td style="text-align:center;"><</td><td style="text-align:center;">-</td><td style="text-align:center;">-</td><td style="text-align:center;">✔</td><td style="text-align:center;">-</td></tr><tr><td style="text-align:center;"><=</td><td style="text-align:center;">-</td><td style="text-align:center;">-</td><td style="text-align:center;">✔</td><td style="text-align:center;">-</td></tr><tr><td style="text-align:center;">^=</td><td style="text-align:center;">-</td><td style="text-align:center;">-</td><td style="text-align:center;">-</td><td style="text-align:center;">✔</td></tr><tr><td style="text-align:center;">!^=</td><td style="text-align:center;">-</td><td style="text-align:center;">-</td><td style="text-align:center;">-</td><td style="text-align:center;">✔</td></tr><tr><td style="text-align:center;">*=</td><td style="text-align:center;">-</td><td style="text-align:center;">-</td><td style="text-align:center;">-</td><td style="text-align:center;">✔</td></tr><tr><td style="text-align:center;">!*=</td><td style="text-align:center;">-</td><td style="text-align:center;">-</td><td style="text-align:center;">-</td><td style="text-align:center;">✔</td></tr><tr><td style="text-align:center;">$=</td><td style="text-align:center;">-</td><td style="text-align:center;">-</td><td style="text-align:center;">-</td><td style="text-align:center;">✔</td></tr><tr><td style="text-align:center;">!$=</td><td style="text-align:center;">-</td><td style="text-align:center;">-</td><td style="text-align:center;">-</td><td style="text-align:center;">✔</td></tr><tr><td style="text-align:center;">~=</td><td style="text-align:center;">-</td><td style="text-align:center;">-</td><td style="text-align:center;">-</td><td style="text-align:center;">✔</td></tr><tr><td style="text-align:center;">!~=</td><td style="text-align:center;">-</td><td style="text-align:center;">-</td><td style="text-align:center;">-</td><td style="text-align:center;">✔</td></tr></tbody></table><p>除 <code>=</code>/<code>!=</code> 以外的操作符, 当节点属性是 null 时表达式为 <code>false</code></p><ul><li>a > 233</li><li>a >= 233</li><li>a < 233</li><li>a <= 233</li><li>a ^= 'xxx'</li><li>a !^= 'xxx'</li><li>a *= 'xxx'</li><li>a !* 'xxx'</li><li>a $= 'xxx'</li><li>a !$= 'xxx'</li><li>a ~= 'xxx'</li><li>a !~= 'xxx'</li></ul><p>即当 a 是 <code>null</code> 时以上表达式为 <code>false</code></p><p>你可能会对 <code>a !$= 'xxx'</code> 在 a 是 <code>null</code> 表达式为 <code>false</code> 感到奇怪</p><p>那你可以换一种写法使用 <code>a=null || a!$='xxx'</code> 或 <code>!(a$='xxx')</code></p><h2 id="connect" tabindex="-1">关系选择 <a class="header-anchor" href="#connect" aria-label="Permalink to &quot;关系选择 {#connect}&quot;"></a></h2><p>关系选择器 由 关系操作符 和 关系表达式 构成, 用于连接两个属性选择器</p><p>简单示例: <code>div > a</code>, 它 表示/约束 两个节点之间的关系, 下面介绍 <a href="#connect-operator">关系操作符</a> 和 <a href="#connect-exp">关系表达式</a></p><h3 id="connect-exp" tabindex="-1">关系表达式 <a class="header-anchor" href="#connect-exp" aria-label="Permalink to &quot;关系表达式 {#connect-exp}&quot;"></a></h3><p>关系表达式 表示查找节点的范围, 有两种</p><ul><li>元组表达式 <code>(a1,a2,a3,a_n)</code>, 其中 a1, a2, a3, a_n 是常量有序递增正整数, 示例 <code>(1)</code>, <code>(2,3,5)</code></li><li>多项式表达式 <code>(an+b)</code>, 其中 a 和 b 是常量整数, 它是元组表达式的另一种表示, 这个元组的数字满足集合 <code>{an+b|an+b>=1,n>=1}</code> 如果集合为空集则表达式非法<br> 当 a<=0 时, 它具有等价的元组表达式<br> 示例 <code>(-n+4)</code> 等价于 <code>(1,2,3)</code><br> 示例 <code>(-3n+10)</code> 等价于 <code>(1,4,7)</code><br> 当 a>0 时, 它表示无限的元组表达式<br> 示例 <code>(n)</code>, 它表示 <code>(1,2,3,...)</code> 一个无限的元组<br> 示例 <code>(2n-1)</code>, 它表示 <code>(1,3,5,...)</code> 一个无限的元组</li></ul><h3 id="connect-operator" tabindex="-1">关系操作符 <a class="header-anchor" href="#connect-operator" aria-label="Permalink to &quot;关系操作符 {#connect-operator}&quot;"></a></h3><p>关系操作符 表示查找节点的方向, 有 5 种关系操作符, <code>+</code>, <code>-</code>, <code>></code>, <code><</code>, <code><<</code></p><table><thead><tr><th style="text-align:center;">操作符</th><th style="text-align:center;">名称</th><th style="text-align:center;">图例</th><th style="text-align:center;">选择器</th></tr></thead><tbody><tr><td style="text-align:center;">+</td><td style="text-align:center;">前置兄弟节点</td><td style="text-align:center;"><img src="https://registry.npmmirror.com/@gkd-kit/assets/0.0.6/files/assets/0020.png" alt="image" width="250"></td><td style="text-align:center;"><a href="https://i.gkd.li/i/14045424?gkd=KiArIFtfaWQ9MzNd" target="_blank" rel="noreferrer">* + [_id=33]</a></td></tr><tr><td style="text-align:center;">-</td><td style="text-align:center;">后置兄弟节点</td><td style="text-align:center;"><img src="https://registry.npmmirror.com/@gkd-kit/assets/0.0.6/files/assets/0021.png" alt="image" width="250"></td><td style="text-align:center;"><a href="https://i.gkd.li/i/14045424?gkd=KiAtIFtfaWQ9MzJd" target="_blank" rel="noreferrer">* - [_id=32]</a></td></tr><tr><td style="text-align:center;">></td><td style="text-align:center;">祖先节点</td><td style="text-align:center;"><img src="https://registry.npmmirror.com/@gkd-kit/assets/0.0.6/files/assets/0022.png" alt="image" width="250"></td><td style="text-align:center;"><a href="https://i.gkd.li/i/14045424?gkd=KiA-IFtfaWQ9OTBd" target="_blank" rel="noreferrer">* > [_id=90]</a></td></tr><tr><td style="text-align:center;"><</td><td style="text-align:center;">直接子节点</td><td style="text-align:center;"><img src="https://registry.npmmirror.com/@gkd-kit/assets/0.0.6/files/assets/0023.png" alt="image" width="250"></td><td style="text-align:center;"><a href="https://i.gkd.li/i/14045424?gkd=KiA8IFtfaWQ9ODld" target="_blank" rel="noreferrer">* < [_id=89]</a></td></tr><tr><td style="text-align:center;"><<</td><td style="text-align:center;">子孙节点(深度先序)</td><td style="text-align:center;"><img src="https://registry.npmmirror.com/@gkd-kit/assets/0.0.6/files/assets/0024.png" alt="image" width="250"></td><td style="text-align:center;"><a href="https://i.gkd.li/i/14045424?gkd=KiA8PDIgW19pZD0yOV0" target="_blank" rel="noreferrer">* <<2 [_id=29]</a></td></tr></tbody></table><p>将 关系操作符 和 关系表达式 连接起来就得到了 关系选择器</p><p><code>A +(a1,a2,a3,a_n) B</code> : A 是 B 的前置兄弟节点, 并且 A.index 满足 B.index-(a_m), 其中 a_m 是元组的任意一个数字</p><p><code>A -(a1,a2,a3,a_n) B</code> : A 是 B 的后置兄弟节点, 并且 A.index 满足 B.index+(a_m)</p><p><code>A >(a1,a2,a3,a_n) B</code> : A 是 B 的祖先节点, 并且 A.depth 满足 B.depth-(a_m), 根节点的 depth=0</p><p><code>A <(a1,a2,a3,a_n) B</code> : A 是 B 的直接子节点, 并且 A.index 满足 a_m-1</p><p><code>A <<(a1,a2,a3,a_n) B</code> : A 是 B 的子孙节点, 并且 A.order 满足 a_m-1, A.order 是深度优先先序遍历的索引</p><h3 id="connect-shortcut" tabindex="-1">表达式简写 <a class="header-anchor" href="#connect-shortcut" aria-label="Permalink to &quot;表达式简写 {#connect-shortcut}&quot;"></a></h3><p>一般情况下, 并不需要写严格完整的表达式, 使用简化写法更方便快捷</p><p>下面是一些特殊情况下的简写表示</p><p>当 a=0 或 b=0 时, 括号可以省略, 以 <code>+</code> 为例</p><ul><li><code>A +(3n+0) B</code> -> <code>A +(3n) B</code> -> <code>A +3n B</code></li><li><code>A +(0n+3) B</code> -> <code>A +(+3) B</code> -> <code>A +3 B</code></li></ul><p>当 a=0 且 b=1 时, an+b 可以省略, 以 <code>+</code> 为例</p><ul><li><code>A +(0n+1) B</code> -> <code>A + B</code></li></ul><p>此外 <code>A + B</code>,<code>A > B</code> 都与等价的 CSS 语法语义相同</p><p>当 a=1 且 b=0 且操作符是 <code>></code>, 可以进一步简写, 比如</p><ul><li><code>A >(1n+0) B</code> -> <code>A >n B</code> -> <code>A B</code></li></ul><p>这与等价的 CSS 语法语义相同</p><h2 id="example" tabindex="-1">示例 <a class="header-anchor" href="#example" aria-label="Permalink to &quot;示例 {#example}&quot;"></a></h2><div class="language-txt vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">txt</span><pre class="shiki shiki-themes github-light github-dark vp-code"><code><span class="line"><span>@LinearLayout > TextView[id=`com.byted.pangle:id/tt_item_tv`][text=`不感兴趣`]</span></span></code></pre></div><p>选择器从末尾开始查找, 首先找到 id=`com.byted.pangle:id/tt_item_tv` 和 text=`不感兴趣` 的 TextView, 并且父节点是 LinearLayout 的节点</p><p>此时我们得到两个节点 [LinearLayout, TextView] 根据 <code>@</code> 知道目标节点是 LinearLayout</p><p>实际上它与</p><div class="language-txt vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">txt</span><pre class="shiki shiki-themes github-light github-dark vp-code"><code><span class="line"><span>TextView[id=`com.byted.pangle:id/tt_item_tv`][text=`不感兴趣`] <n LinearLayout</span></span></code></pre></div><p>的目标匹配节点是等价的, 但是在查询算法时间复杂度上, 后者更慢</p><p>如下是网页无障碍快照审查工具, 使用它的搜索框的选择器查询可以实时测试编写的选择器</p><ul><li><a href="https://i.gkd.li/i/14045424" target="_blank" rel="noreferrer">https://i.gkd.li/i/14045424</a></li><li><a href="https://i.gkd.li/i/14034770" target="_blank" rel="noreferrer">https://i.gkd.li/i/14034770</a></li><li><a href="https://i.gkd.li/i/14031920" target="_blank" rel="noreferrer">https://i.gkd.li/i/14031920</a></li><li><a href="https://i.gkd.li/i/14018243" target="_blank" rel="noreferrer">https://i.gkd.li/i/14018243</a></li><li><a href="https://i.gkd.li/i/14011298" target="_blank" rel="noreferrer">https://i.gkd.li/i/14011298</a></li><li><a href="https://i.gkd.li/i/13999908" target="_blank" rel="noreferrer">https://i.gkd.li/i/13999908</a></li></ul><h2 id="note" tabindex="-1">一些注意 <a class="header-anchor" href="#note" aria-label="Permalink to &quot;一些注意 {#note}&quot;"></a></h2><h3 id="regex-optimization" tabindex="-1">正则表达式优化 <a class="header-anchor" href="#regex-optimization" aria-label="Permalink to &quot;正则表达式优化 {#regex-optimization}&quot;"></a></h3><p>对 <code>matches</code>/<code>notMatches</code> 的优化: 如果正则表达式满足下面的条件, 选择器将使用内置的简单的函数匹配, 而不是真正地去运行一个正则表达式</p><ul><li><code>[text~="(?is)abc.*"]</code> -> <code>startsWith('abc', ignoreCase = true)</code></li><li><code>[text~="(?is).*abc.*"]</code> -> <code>contains('abc', ignoreCase = true)</code></li><li><code>[text~="(?is).*abc"]</code> -> <code>endsWith('abc', ignoreCase = true)</code></li><li><code>[text!~="(?is)abc.*"]</code> -> <code>notStartsWith('abc', ignoreCase = true)</code></li><li><code>[text!~="(?is).*abc.*"]</code> -> <code>notContains('abc', ignoreCase = true)</code></li><li><code>[text!~="(?is).*abc"]</code> -> <code>notEndsWith('abc', ignoreCase = true)</code></li></ul><p>上面的 <code>abc</code> 指代不包含 <code>\^$.?*|+()[]{}</code> 这类特殊正则字符的任意字符串, 如 <code>ikun</code> 符合, <code>ikun?</code> 不符合</p><p>简单来说就是如果你只想忽略大小写去简单匹配或不匹配一些字符, 那么直接使用上面的格式</p><h3 id="regex-multiplatform" tabindex="-1">正则表达式一致性 <a class="header-anchor" href="#regex-multiplatform" aria-label="Permalink to &quot;正则表达式一致性 {#regex-multiplatform}&quot;"></a></h3><p>由于 选择器 需要同时满足 浏览器/Js(审查工具), Android/Java(GKD) 运行, 而这两个平台的正则表达式的底层实现和语法表示略有不同</p><p>因此为了在 Js 端实现和 Java 一致的正则表达式规范, 网页审查工具借助 <a href="https://kotlinlang.org/docs/wasm-overview.html" target="_blank" rel="noreferrer">Kotlin Wasm</a> 将正则表达式的 matches 函数接口编译为 wasm 提供给 Js 调用</p><p>Kotlin Wasm 需要你的浏览器支持 <a href="https://developer.chrome.com/blog/wasmgc?hl=zh-cn" target="_blank" rel="noreferrer">WasmGC</a>, 也就是版本需要满足下列条件</p><p><img src="https://registry.npmmirror.com/@gkd-kit/assets/0.0.6/files/assets/0025.png" alt="image"></p><p>如果你的浏览器版本不满足, 正则表达式将自动回退到 Js 端实现, 以下是在 Js 端使用正则表达式需要注意的地方</p><p>比如上面的正则表达式优化例子中开头的 <code>(?is)</code> 是 Java 正则表达式的 inline flags 语法, 但实际上 Js 并不支持这样写, 只是选择器内部做了一些兼容让它支持</p><p>并且选择器的 Js 端只兼容在开头的 flags, 在内部的 flags 不支持, 此外 Java 和 Js 支持的 flags 也有不同, 某些特殊的表达式也表现也不一致</p><p>总之不要使用太过复杂(多复杂我也不知道)的正则表达式, 某些正则表达式有可能在审查工具上匹配, 但是在 GKD 上不匹配</p><p>如果你能确保正则表达式在 Js 和 Java/Kotlin 的匹配行为一致, 那就没问题</p><p>总之两种情况</p><ul><li>高版本浏览器可以使用 <strong>完整一致</strong> 的正则表达式</li><li>低版本浏览器使用 <strong>小范围不完整不一致</strong> 的正则表达式</li></ul><p>如果你的选择器没有使用正则表达式则不用关心此问题</p><h3 id="nest-escape" tabindex="-1">嵌套转义字符 <a class="header-anchor" href="#nest-escape" aria-label="Permalink to &quot;嵌套转义字符 {#nest-escape}&quot;"></a></h3><p>转义字符一般用于表示不能直接显示具体特殊意义的字符</p><p>对于 GKD 的选择器而言, 转义字符使用示例如下</p><div class="language-txt vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">txt</span><pre class="shiki shiki-themes github-light github-dark vp-code"><code><span class="line"><span>TextView[text="\\\n"]</span></span></code></pre></div><p>这表达选择一个 TextView 它的 text 长度为 2, 开头是 <code>\</code> 末尾是换行</p><p>这和平常写的代码里面的 string 声明用法一模一样</p><p>但是选择器最终放在规则的字段里面, 也就是这个选择器字符串处于 JSON 的 string 内</p><p>如果你想当然地直接手动复制插入到编辑器里出现下面这种规则</p><div class="language-json5 vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">json5</span><pre class="shiki shiki-themes github-light github-dark vp-code"><code><span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">{</span></span>
+    <div id="app"><div class="Layout" data-v-b9d42860><!--[--><!--]--><!--[--><span tabindex="-1" data-v-a4386a08></span><a href="#VPContent" class="VPSkipLink visually-hidden" data-v-a4386a08> Skip to content </a><!--]--><!----><header class="VPNav" data-v-b9d42860 data-v-78f9b908><div class="VPNavBar has-sidebar top" data-v-78f9b908 data-v-edfa0a94><div class="wrapper" data-v-edfa0a94><div class="container" data-v-edfa0a94><div class="title" data-v-edfa0a94><div class="VPNavBarTitle has-sidebar" data-v-edfa0a94 data-v-493f3022><a class="title" href="/" data-v-493f3022><!--[--><!--]--><!--[--><img class="VPImage logo" src="https://registry.npmmirror.com/@gkd-kit/docs/0.0.1706371840771/files/.vitepress/dist/logo.svg" alt data-v-9104fcc7><!--]--><span data-v-493f3022>GKD</span><!--[--><!--]--></a></div></div><div class="content" data-v-edfa0a94><div class="content-body" data-v-edfa0a94><!--[--><!--]--><div class="VPNavBarSearch search" data-v-edfa0a94><!--[--><!----><div id="local-search"><button type="button" class="DocSearch DocSearch-Button" aria-label="Search"><span class="DocSearch-Button-Container"><span class="vp-icon DocSearch-Search-Icon"></span><span class="DocSearch-Button-Placeholder">Search</span></span><span class="DocSearch-Button-Keys"><kbd class="DocSearch-Button-Key"></kbd><kbd class="DocSearch-Button-Key">K</kbd></span></button></div><!--]--></div><nav aria-labelledby="main-nav-aria-label" class="VPNavBarMenu menu" data-v-edfa0a94 data-v-09e675c8><span id="main-nav-aria-label" class="visually-hidden" data-v-09e675c8>Main Navigation</span><!--[--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/" tabindex="0" data-v-09e675c8 data-v-33c36113><!--[--><span data-v-33c36113>首页</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/api/" tabindex="0" data-v-09e675c8 data-v-33c36113><!--[--><span data-v-33c36113>API</span><!--]--></a><!--]--><!--]--></nav><!----><div class="VPNavBarAppearance appearance" data-v-edfa0a94 data-v-3af8e4f3><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title="Switch to dark theme" aria-checked="false" data-v-3af8e4f3 data-v-17b25208 data-v-a847a470><span class="check" data-v-a847a470><span class="icon" data-v-a847a470><!--[--><span class="vpi-sun sun" data-v-17b25208></span><span class="vpi-moon moon" data-v-17b25208></span><!--]--></span></span></button></div><div class="VPSocialLinks VPNavBarSocialLinks social-links" data-v-edfa0a94 data-v-675a8bec data-v-9591a6f4><!--[--><a class="VPSocialLink no-icon" href="https://github.com/gkd-kit" aria-label="github" target="_blank" rel="noopener" data-v-9591a6f4 data-v-4e7cdece><span class="vpi-social-github"></span></a><!--]--></div><div class="VPFlyout VPNavBarExtra extra" data-v-edfa0a94 data-v-31eebaf6 data-v-1c16d6fe><button type="button" class="button" aria-haspopup="true" aria-expanded="false" aria-label="extra navigation" data-v-1c16d6fe><span class="vpi-more-horizontal icon" data-v-1c16d6fe></span></button><div class="menu" data-v-1c16d6fe><div class="VPMenu" data-v-1c16d6fe data-v-3f253781><!----><!--[--><!--[--><!----><div class="group" data-v-31eebaf6><div class="item appearance" data-v-31eebaf6><p class="label" data-v-31eebaf6>外观</p><div class="appearance-action" data-v-31eebaf6><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title="Switch to dark theme" aria-checked="false" data-v-31eebaf6 data-v-17b25208 data-v-a847a470><span class="check" data-v-a847a470><span class="icon" data-v-a847a470><!--[--><span class="vpi-sun sun" data-v-17b25208></span><span class="vpi-moon moon" data-v-17b25208></span><!--]--></span></span></button></div></div></div><div class="group" data-v-31eebaf6><div class="item social-links" data-v-31eebaf6><div class="VPSocialLinks social-links-list" data-v-31eebaf6 data-v-9591a6f4><!--[--><a class="VPSocialLink no-icon" href="https://github.com/gkd-kit" aria-label="github" target="_blank" rel="noopener" data-v-9591a6f4 data-v-4e7cdece><span class="vpi-social-github"></span></a><!--]--></div></div></div><!--]--><!--]--></div></div></div><!--[--><!--]--><button type="button" class="VPNavBarHamburger hamburger" aria-label="mobile navigation" aria-expanded="false" aria-controls="VPNavScreen" data-v-edfa0a94 data-v-c1b6d24b><span class="container" data-v-c1b6d24b><span class="top" data-v-c1b6d24b></span><span class="middle" data-v-c1b6d24b></span><span class="bottom" data-v-c1b6d24b></span></span></button></div></div></div></div><div class="divider" data-v-edfa0a94><div class="divider-line" data-v-edfa0a94></div></div></div><!----></header><div class="VPLocalNav has-sidebar empty" data-v-b9d42860 data-v-2fc12c07><div class="container" data-v-2fc12c07><button class="menu" aria-expanded="false" aria-controls="VPSidebarNav" data-v-2fc12c07><span class="vpi-align-left menu-icon" data-v-2fc12c07></span><span class="menu-text" data-v-2fc12c07>归档</span></button><div class="VPLocalNavOutlineDropdown" style="--vp-vh:0px;" data-v-2fc12c07 data-v-16777068><button data-v-16777068>返回顶部</button><!----></div></div></div><aside class="VPSidebar" data-v-b9d42860 data-v-dd035f77><div class="curtain" data-v-dd035f77></div><nav class="nav" id="VPSidebarNav" aria-labelledby="sidebar-aria-label" tabindex="-1" data-v-dd035f77><span class="visually-hidden" id="sidebar-aria-label" data-v-dd035f77> Sidebar Navigation </span><!--[--><!--]--><!--[--><div class="group" data-v-dd035f77><section class="VPSidebarItem level-0" data-v-dd035f77 data-v-234a6f37><div class="item" role="button" tabindex="0" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><h2 class="text" data-v-234a6f37>指引</h2><!----></div><div class="items" data-v-234a6f37><!--[--><div class="VPSidebarItem level-1 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/guide/" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>开始使用</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/subscription/" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>订阅规则</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/faq/" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>疑难解答</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="group" data-v-dd035f77><section class="VPSidebarItem level-0 has-active" data-v-dd035f77 data-v-234a6f37><div class="item" role="button" tabindex="0" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><h2 class="text" data-v-234a6f37>选择器</h2><!----></div><div class="items" data-v-234a6f37><!--[--><div class="VPSidebarItem level-1 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/selector/" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>语法介绍</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/selector/node.html" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>属性方法</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/selector/example.html" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>选择示例</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="group" data-v-dd035f77><section class="VPSidebarItem level-0 is-link" data-v-dd035f77 data-v-234a6f37><div class="item" tabindex="0" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/api/" data-v-234a6f37><!--[--><h2 class="text" data-v-234a6f37>API</h2><!--]--></a><!----></div><div class="items" data-v-234a6f37><!--[--><section class="VPSidebarItem level-1 collapsible collapsed" data-v-234a6f37><div class="item" role="button" tabindex="0" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><h3 class="text" data-v-234a6f37>Interfaces</h3><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-234a6f37><span class="vpi-chevron-right caret-icon" data-v-234a6f37></span></div></div><div class="items" data-v-234a6f37><!--[--><div class="VPSidebarItem level-2 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/api/interfaces/RawSubscription.html" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>RawSubscription</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/api/interfaces/RawApp.html" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>RawApp</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/api/interfaces/RawGlobalGroup.html" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>RawGlobalGroup</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/api/interfaces/RawCategory.html" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>RawCategory</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/api/interfaces/RawAppRule.html" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>RawAppRule</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/api/interfaces/RawAppGroup.html" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>RawAppGroup</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/api/interfaces/RawGlobalRule.html" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>RawGlobalRule</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/api/interfaces/RawGlobalApp.html" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>RawGlobalApp</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/api/interfaces/RawCommonProps.html" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>RawCommonProps</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/api/interfaces/RawRuleProps.html" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>RawRuleProps</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/api/interfaces/RawGroupProps.html" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>RawGroupProps</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/api/interfaces/RawAppRuleProps.html" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>RawAppRuleProps</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/api/interfaces/RawGlobalRuleProps.html" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>RawGlobalRuleProps</p><!--]--></a><!----></div><!----></div><!--]--></div></section><section class="VPSidebarItem level-1 collapsible collapsed" data-v-234a6f37><div class="item" role="button" tabindex="0" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><h3 class="text" data-v-234a6f37>Type Aliases</h3><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-234a6f37><span class="vpi-chevron-right caret-icon" data-v-234a6f37></span></div></div><div class="items" data-v-234a6f37><!--[--><div class="VPSidebarItem level-2 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/api/type-aliases/Position.html" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>Position</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/api/type-aliases/IArray.html" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>IArray</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-234a6f37><div class="item" data-v-234a6f37><div class="indicator" data-v-234a6f37></div><a class="VPLink link link" href="/api/type-aliases/Integer.html" data-v-234a6f37><!--[--><p class="text" data-v-234a6f37>Integer</p><!--]--></a><!----></div><!----></div><!--]--></div></section><!--]--></div></section></div><!--]--><!--[--><!--]--></nav></aside><div class="VPContent has-sidebar" id="VPContent" data-v-b9d42860 data-v-d11c184b><div class="VPDoc has-sidebar has-aside" data-v-d11c184b data-v-2a2131eb><!--[--><!--]--><div class="container" data-v-2a2131eb><div class="aside" data-v-2a2131eb><div class="aside-curtain" data-v-2a2131eb></div><div class="aside-container" data-v-2a2131eb><div class="aside-content" data-v-2a2131eb><div class="VPDocAside" data-v-2a2131eb data-v-a631cc65><!--[--><!--]--><!--[--><!--]--><div class="VPDocAsideOutline" role="navigation" data-v-a631cc65 data-v-66d76b2e><div class="content" data-v-66d76b2e><div class="outline-marker" data-v-66d76b2e></div><div class="outline-title" role="heading" aria-level="2" data-v-66d76b2e>导航栏</div><nav aria-labelledby="doc-outline-aria-label" data-v-66d76b2e><span class="visually-hidden" id="doc-outline-aria-label" data-v-66d76b2e> Table of Contents for current page </span><ul class="VPDocOutlineItem root" data-v-66d76b2e data-v-00dc6f9f><!--[--><!--]--></ul></nav></div></div><!--[--><!--]--><div class="spacer" data-v-a631cc65></div><!--[--><!--]--><!----><!--[--><!--]--><!--[--><!--]--></div></div></div></div><div class="content" data-v-2a2131eb><div class="content-container" data-v-2a2131eb><!--[--><!--]--><main class="main" data-v-2a2131eb><div style="position:relative;" class="vp-doc _selector_" data-v-2a2131eb><div><h1 id="title" tabindex="-1">选择器 <a class="header-anchor" href="#title" aria-label="Permalink to &quot;选择器 {#title}&quot;"></a></h1><p>一个类似 CSS 选择器的选择器, 能联系节点上下文信息, 更容易也更精确找到目标节点</p><h2 id="why" tabindex="-1">为什么需要选择器 <a class="header-anchor" href="#why" aria-label="Permalink to &quot;为什么需要选择器 {#why}&quot;"></a></h2><p>我们的目的是查询获取屏幕上的某个节点, 最简单的情况下, 目标节点已经有唯一的 id/text 标识</p><p>这时只需要配置 id/text 就能简单执行点击, 但实际情况很多节点都缺失了这些信息, 无法简单查询获取</p><p>节点还存在很多额外信息没有被利用到, 节点所有属性可以在 <a href="https://i.gkd.li/i/14045424" target="_blank" rel="noreferrer">快照-14045424</a> 的属性面板看到</p><p>另一种常见的情况是节点没有有效属性, 这时我们需要根据周围的节点去定位</p><p>选择器就是为了解决这些问题而开发的, 下面是对选择器语法的详细介绍</p><div class="tip custom-block github-alert"><p class="custom-block-title">提示</p><p>本文是从 <strong>抽象语法树(AST)</strong> 的角度去完备地介绍选择器结构<br> 如果你是初学者, 建议你直接看 <a href="./example.html">选择器-示例</a></p></div><h2 id="syntax" tabindex="-1">语法 <a class="header-anchor" href="#syntax" aria-label="Permalink to &quot;语法 {#syntax}&quot;"></a></h2><p>与 CSS 类似, 一个选择器由 属性选择器 和 关系选择器 交叉组成, 并且开头末尾必须是 属性选择器</p><p>示例 <code>div > img</code> 的结构是 <code>属性选择器 关系选择器 属性选择器</code>, 它表示选择父节点是 <code>div</code> 的 <code>img</code> 节点, 这与 <a href="https://developer.mozilla.org/zh-CN/docs/Web/CSS/Child_combinator" target="_blank" rel="noreferrer">相同 CSS 语法</a> 语义一致</p><p>另外 属性选择器 和 关系选择器 之间必须<strong>强制</strong>用 空白字符(空格/换行/回车/制表) 隔开</p><p>即 <code>div>img</code> 非法, 必须写成 <code>div > img</code></p><p>下面分别介绍 <a href="#attr">属性选择器</a> 和 <a href="#connect">关系选择器</a></p><h2 id="attr" tabindex="-1">属性选择 <a class="header-anchor" href="#attr" aria-label="Permalink to &quot;属性选择 {#attr}&quot;"></a></h2><p>它和 CSS 语法的 属性选择器很相似, 但更强大, 如下是一个示例</p><p><code>@TextView[a=1][b^='2'][c*='a'||d.length>7&&e=false][!(f=true)][g.plus(1)>0]</code></p><p><code>@</code> 表示选择此节点, 一条规则最后属性选择器 <code>@</code> 生效, 如果没有 <code>@</code>, 取最后一个属性选择器</p><p><code>TextView</code> 代表节点的 name 属性, 而且与 CSS 相似, <code>*</code> 表示匹配任意属性</p><p>由于该选择器主要用于 Android 平台, 节点的 name 都是 java 类如 android.text.TextView 这种形式</p><p>为了方便书写规则, 上述 <code>TextView</code> 等价 <code>[name='TextView'||name$='.TextView']</code></p><p><code>[]</code> 内部是一个 逻辑表达式/布尔表达式/取反表达式</p><ul><li>逻辑表达式 -> <code>name='TextView'||name$='.TextView'</code></li><li>布尔表达式 -> <code>name='TextView'</code></li><li>取反表达式 -> <code>!(name$='TextView')</code>, <code>!(name='TextView'||name$='.TextView')</code></li></ul><p>注意 取反表达式 后面必须是 <code>(...)</code>, <code>!!(...)</code> 是非法的</p><p>逻辑表达式 有两个操作符 <code>||</code> 和 <code>&&</code>. <code>&&</code> 优先级更高</p><p>即 <code>[a>1||b>1&&c>1||d>1]</code> 等价于 <code>[a>1||(b>1&&c>1)||d>1]</code></p><p>并列的 <code>[]</code> 视为使用 <code>&&</code> 的逻辑表达式, 即 <code>[a=1][b=1]</code> 等价于 <code>[a=1&&b=1]</code></p><p>布尔表达式 由 <code>左值 操作符 右值</code> 构成, 左值/右值 是一个 值表达式</p><p>下面分别介绍 <a href="#value-exp">值表达式</a> 和 <a href="#attr-operator">操作符</a></p><h2 id="value-exp" tabindex="-1">值表达式 <a class="header-anchor" href="#value-exp" aria-label="Permalink to &quot;值表达式 {#value-exp}&quot;"></a></h2><p>值表达式分两类: 变量 和 字面量, 下图是关系表格</p><table><thead><tr><th colspan="2"><div text-center>值表达式</div></th><th>示例</th></tr></thead><tbody><tr><td rowspan="3">变量</td><td>标识符</td><td><code> a </code></td></tr><tr><td>成员表达式</td><td><code>a.b</code></td></tr><tr><td>调用表达式</td><td><code>a(b,c)</code></td></tr><tr><td rowspan="4">字面量</td><td>null</td><td><code>null</code></td></tr><tr><td>boolean</td><td><code>false</code></td></tr><tr><td>int</td><td><code>114514</code></td></tr><tr><td>string</td><td><code>'ikun'</code></td></tr></tbody></table><p>每个值表达式都有其类型, 可细分为两类</p><p>基础类型: <code>null</code> <code>boolean</code> <code>int</code> <code>string</code></p><p>对象类型: <code>object</code></p><p>对象类型可细分为 <code>context</code> 和 <code>node</code> 两种类型</p><p>比如选择器 <code>[parent=null]</code> 代表选择一个父节点是 null 的节点, 即根节点</p><p>上面的 <code>parent</code> 属于 值表达式/变量/标识符, 类型是 <code>node</code></p><p><code>context</code> 类型指代当前节点的上下文, 当想使用不属于 <code>node</code> 上的属性方法时就需要 <code>context</code></p><p>你可以在 <a href="./node.html">选择器-属性方法</a> 查看所有类型和对应属性方法</p><h3 id="var" tabindex="-1">变量 <a class="header-anchor" href="#var" aria-label="Permalink to &quot;变量 {#var}&quot;"></a></h3><p>首先需要了解 <strong>标识符</strong>: 正则匹配 <code>^[_a-zA-Z][a-zA-Z0-9_]*$</code> 并且不是 <code>null</code>/<code>true</code>/<code>false</code> 的字符串</p><p>示例合法变量名: <code>a</code> <code>ikun</code> <code>manbaout</code>, 下面可输入字符测试否是合法</p><div class="vp-raw"><div><input placeholder="请输入标识符测试是否合法" type="text" value class="flex h-9 w-full rounded-md border border-input bg-transparent px-3 py-1 text-sm shadow-sm transition-colors file:border-0 file:bg-transparent file:text-sm file:font-medium placeholder:text-muted-foreground focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring disabled:cursor-not-allowed disabled:opacity-50"><div mt-4px class="color-red opacity-0">非法标识符❌</div></div></div><hr><p>接下来了解 <strong>成员表达式</strong> <code>a.b</code>, 它被 <code>.</code> 分为两个部分, 前部分是另一个变量, 后部分是一个标识符作为属性</p><p>同理 <code>a.b.c</code> 也是一个 成员表达式, 其中 <code>a.b</code> 是它的变量部分, <code>c</code> 是一个合法的标识符作为属性</p><p>根据上面标识符的规则, <code>a.1</code>, <code>a.null</code>, <code>a.true</code> 都是非法成员表达式</p><hr><p>最后了解 <strong>调用表达式</strong> <code>a(b,c)</code>, 它由两个部分构成, <code>(</code> 的左侧 <code>a</code> 是一个变量作为 调用者</p><p><code>(c,d)</code> 作为调用参数(值类型), 调用参数数量可以是 0 或任意个, 即 <code>a()</code> 也是合法的</p><p>合法的其它例子: <code>a.b(c,d).e(f).g(1,2,true)</code></p><p>需要注意调用者不能是 调用表达式, 即 <code>a()()</code> 非法</p><h3 id="literal" tabindex="-1">字面量 <a class="header-anchor" href="#literal" aria-label="Permalink to &quot;字面量 {#literal}&quot;"></a></h3><p>根据上面的表格, 字面量有 4 种: <code>null</code>, <code>boolean</code>, <code>int</code>, <code>string</code></p><ul><li>null</li><li>boolean 使用 <code>true</code>/<code>false</code></li><li>int 匹配 <code>^-?[0-9]$</code>, 即10进制自然数, 示例 <code>-1</code>,<code>0</code>,<code>1</code>, 不支持 <code>+1</code> 这种写法</li><li>string 使用 ' ` " 之一成对包裹, 内部字符转义使用 <code>\</code><br> 所有的转义字符示例 <code>\\</code>, <code>\'</code>, <code>\"</code>, <code>\`</code>, <code>\n</code>, <code>\r</code>, <code>\t</code>, <code>\b</code>, <code>\xfF</code>, <code>\uffFF</code><br> 不支持多行字符, 处于 <code>[0, 0x1F]</code> 的控制字符必须使用转义字符表示</li></ul><p>此外使用 string 时需要了解 <a href="#nest-escape">嵌套转义字符</a> 以避免出现错误</p><h2 id="attr-operator" tabindex="-1">操作符 <a class="header-anchor" href="#attr-operator" aria-label="Permalink to &quot;操作符 {#attr-operator}&quot;"></a></h2><p>操作符 用于连接两个 值表达式</p><table><thead><tr><th style="text-align:center;">操作符</th><th style="text-align:center;">名称</th><th style="text-align:center;">说明</th></tr></thead><tbody><tr><td style="text-align:center;">=</td><td style="text-align:center;">equal</td><td style="text-align:center;"></td></tr><tr><td style="text-align:center;">!=</td><td style="text-align:center;">notEqual</td><td style="text-align:center;"></td></tr><tr><td style="text-align:center;">></td><td style="text-align:center;">more</td><td style="text-align:center;"></td></tr><tr><td style="text-align:center;">>=</td><td style="text-align:center;">moreEqual</td><td style="text-align:center;"></td></tr><tr><td style="text-align:center;"><</td><td style="text-align:center;">less</td><td style="text-align:center;"></td></tr><tr><td style="text-align:center;"><=</td><td style="text-align:center;">lessEqual</td><td style="text-align:center;"></td></tr><tr><td style="text-align:center;">^=</td><td style="text-align:center;">startsWith</td><td style="text-align:center;">以...开头</td></tr><tr><td style="text-align:center;">!^=</td><td style="text-align:center;">notStartsWith</td><td style="text-align:center;">不以...开头</td></tr><tr><td style="text-align:center;">*=</td><td style="text-align:center;">contains</td><td style="text-align:center;">包含...</td></tr><tr><td style="text-align:center;">!^=</td><td style="text-align:center;">notContains</td><td style="text-align:center;">不包含...</td></tr><tr><td style="text-align:center;">$=</td><td style="text-align:center;">endsWith</td><td style="text-align:center;">以...结尾</td></tr><tr><td style="text-align:center;">!$=</td><td style="text-align:center;">notEndsWith</td><td style="text-align:center;">不以...结尾</td></tr><tr><td style="text-align:center;">~=</td><td style="text-align:center;">matches</td><td style="text-align:center;">正则匹配...</td></tr><tr><td style="text-align:center;">!~=</td><td style="text-align:center;">notMatches</td><td style="text-align:center;">正则不匹配...</td></tr></tbody></table><p>附加说明: <code>matches</code>/<code>notMatches</code> 要求 值 必须是合法的 <a href="https://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html" target="_blank" rel="noreferrer">Java/Kotlin 正则表达式</a>, 否则提示语法错误</p><p>并且 <code>matches</code>/<code>notMatches</code> 右侧的值只能是 字面量/字符串</p><p>操作符只能使用在对应的类型的值, 比如 <code>a>''</code> 类型不匹配, 将提示 <code>非法类型</code></p><p>下面表格中 <code>-</code> 表示类型不匹配</p><table><thead><tr><th style="text-align:center;"></th><th style="text-align:center;">null</th><th style="text-align:center;">boolean</th><th style="text-align:center;">int</th><th style="text-align:center;">string</th></tr></thead><tbody><tr><td style="text-align:center;">=</td><td style="text-align:center;">✔</td><td style="text-align:center;">✔</td><td style="text-align:center;">✔</td><td style="text-align:center;">✔</td></tr><tr><td style="text-align:center;">!=</td><td style="text-align:center;">✔</td><td style="text-align:center;">✔</td><td style="text-align:center;">✔</td><td style="text-align:center;">✔</td></tr><tr><td style="text-align:center;">></td><td style="text-align:center;">-</td><td style="text-align:center;">-</td><td style="text-align:center;">✔</td><td style="text-align:center;">-</td></tr><tr><td style="text-align:center;">>=</td><td style="text-align:center;">-</td><td style="text-align:center;">-</td><td style="text-align:center;">✔</td><td style="text-align:center;">-</td></tr><tr><td style="text-align:center;"><</td><td style="text-align:center;">-</td><td style="text-align:center;">-</td><td style="text-align:center;">✔</td><td style="text-align:center;">-</td></tr><tr><td style="text-align:center;"><=</td><td style="text-align:center;">-</td><td style="text-align:center;">-</td><td style="text-align:center;">✔</td><td style="text-align:center;">-</td></tr><tr><td style="text-align:center;">^=</td><td style="text-align:center;">-</td><td style="text-align:center;">-</td><td style="text-align:center;">-</td><td style="text-align:center;">✔</td></tr><tr><td style="text-align:center;">!^=</td><td style="text-align:center;">-</td><td style="text-align:center;">-</td><td style="text-align:center;">-</td><td style="text-align:center;">✔</td></tr><tr><td style="text-align:center;">*=</td><td style="text-align:center;">-</td><td style="text-align:center;">-</td><td style="text-align:center;">-</td><td style="text-align:center;">✔</td></tr><tr><td style="text-align:center;">!*=</td><td style="text-align:center;">-</td><td style="text-align:center;">-</td><td style="text-align:center;">-</td><td style="text-align:center;">✔</td></tr><tr><td style="text-align:center;">$=</td><td style="text-align:center;">-</td><td style="text-align:center;">-</td><td style="text-align:center;">-</td><td style="text-align:center;">✔</td></tr><tr><td style="text-align:center;">!$=</td><td style="text-align:center;">-</td><td style="text-align:center;">-</td><td style="text-align:center;">-</td><td style="text-align:center;">✔</td></tr><tr><td style="text-align:center;">~=</td><td style="text-align:center;">-</td><td style="text-align:center;">-</td><td style="text-align:center;">-</td><td style="text-align:center;">✔</td></tr><tr><td style="text-align:center;">!~=</td><td style="text-align:center;">-</td><td style="text-align:center;">-</td><td style="text-align:center;">-</td><td style="text-align:center;">✔</td></tr></tbody></table><p>除 <code>=</code>/<code>!=</code> 以外的操作符, 当节点属性是 null 时表达式为 <code>false</code></p><ul><li>a > 233</li><li>a >= 233</li><li>a < 233</li><li>a <= 233</li><li>a ^= 'xxx'</li><li>a !^= 'xxx'</li><li>a *= 'xxx'</li><li>a !* 'xxx'</li><li>a $= 'xxx'</li><li>a !$= 'xxx'</li><li>a ~= 'xxx'</li><li>a !~= 'xxx'</li></ul><p>即当 a 是 <code>null</code> 时以上表达式为 <code>false</code></p><p>你可能会对 <code>a !$= 'xxx'</code> 在 a 是 <code>null</code> 表达式为 <code>false</code> 感到奇怪</p><p>那你可以换一种写法使用 <code>a=null || a!$='xxx'</code> 或 <code>!(a$='xxx')</code></p><h2 id="connect" tabindex="-1">关系选择 <a class="header-anchor" href="#connect" aria-label="Permalink to &quot;关系选择 {#connect}&quot;"></a></h2><p>关系选择器 由 关系操作符 和 关系表达式 构成, 用于连接两个属性选择器</p><p>简单示例: <code>div > a</code>, 它 表示/约束 两个节点之间的关系, 下面介绍 <a href="#connect-operator">关系操作符</a> 和 <a href="#connect-exp">关系表达式</a></p><h3 id="connect-exp" tabindex="-1">关系表达式 <a class="header-anchor" href="#connect-exp" aria-label="Permalink to &quot;关系表达式 {#connect-exp}&quot;"></a></h3><p>关系表达式 表示查找节点的范围, 有两种</p><ul><li>元组表达式 <code>(a1,a2,a3,a_n)</code>, 其中 a1, a2, a3, a_n 是常量有序递增正整数, 示例 <code>(1)</code>, <code>(2,3,5)</code></li><li>多项式表达式 <code>(an+b)</code>, 其中 a 和 b 是常量整数, 它是元组表达式的另一种表示, 这个元组的数字满足集合 <code>{an+b|an+b>=1,n>=1}</code> 如果集合为空集则表达式非法<br> 当 a<=0 时, 它具有等价的元组表达式<br> 示例 <code>(-n+4)</code> 等价于 <code>(1,2,3)</code><br> 示例 <code>(-3n+10)</code> 等价于 <code>(1,4,7)</code><br> 当 a>0 时, 它表示无限的元组表达式<br> 示例 <code>(n)</code>, 它表示 <code>(1,2,3,...)</code> 一个无限的元组<br> 示例 <code>(2n-1)</code>, 它表示 <code>(1,3,5,...)</code> 一个无限的元组</li></ul><h3 id="connect-operator" tabindex="-1">关系操作符 <a class="header-anchor" href="#connect-operator" aria-label="Permalink to &quot;关系操作符 {#connect-operator}&quot;"></a></h3><p>关系操作符 表示查找节点的方向, 有 5 种关系操作符, <code>+</code>, <code>-</code>, <code>></code>, <code><</code>, <code><<</code></p><table><thead><tr><th style="text-align:center;">操作符</th><th style="text-align:center;">名称</th><th style="text-align:center;">图例</th><th style="text-align:center;">选择器</th></tr></thead><tbody><tr><td style="text-align:center;">+</td><td style="text-align:center;">前置兄弟节点</td><td style="text-align:center;"><img src="https://registry.npmmirror.com/@gkd-kit/assets/0.0.6/files/assets/0020.png" alt="image" width="250"></td><td style="text-align:center;"><a href="https://i.gkd.li/i/14045424?gkd=KiArIFtfaWQ9MzNd" target="_blank" rel="noreferrer">* + [_id=33]</a></td></tr><tr><td style="text-align:center;">-</td><td style="text-align:center;">后置兄弟节点</td><td style="text-align:center;"><img src="https://registry.npmmirror.com/@gkd-kit/assets/0.0.6/files/assets/0021.png" alt="image" width="250"></td><td style="text-align:center;"><a href="https://i.gkd.li/i/14045424?gkd=KiAtIFtfaWQ9MzJd" target="_blank" rel="noreferrer">* - [_id=32]</a></td></tr><tr><td style="text-align:center;">></td><td style="text-align:center;">祖先节点</td><td style="text-align:center;"><img src="https://registry.npmmirror.com/@gkd-kit/assets/0.0.6/files/assets/0022.png" alt="image" width="250"></td><td style="text-align:center;"><a href="https://i.gkd.li/i/14045424?gkd=KiA-IFtfaWQ9OTBd" target="_blank" rel="noreferrer">* > [_id=90]</a></td></tr><tr><td style="text-align:center;"><</td><td style="text-align:center;">直接子节点</td><td style="text-align:center;"><img src="https://registry.npmmirror.com/@gkd-kit/assets/0.0.6/files/assets/0023.png" alt="image" width="250"></td><td style="text-align:center;"><a href="https://i.gkd.li/i/14045424?gkd=KiA8IFtfaWQ9ODld" target="_blank" rel="noreferrer">* < [_id=89]</a></td></tr><tr><td style="text-align:center;"><<</td><td style="text-align:center;">子孙节点(深度先序)</td><td style="text-align:center;"><img src="https://registry.npmmirror.com/@gkd-kit/assets/0.0.6/files/assets/0024.png" alt="image" width="250"></td><td style="text-align:center;"><a href="https://i.gkd.li/i/14045424?gkd=KiA8PDIgW19pZD0yOV0" target="_blank" rel="noreferrer">* <<2 [_id=29]</a></td></tr></tbody></table><p>将 关系操作符 和 关系表达式 连接起来就得到了 关系选择器</p><p><code>A +(a1,a2,a3,a_n) B</code> : A 是 B 的前置兄弟节点, 并且 A.index 满足 B.index-(a_m), 其中 a_m 是元组的任意一个数字</p><p><code>A -(a1,a2,a3,a_n) B</code> : A 是 B 的后置兄弟节点, 并且 A.index 满足 B.index+(a_m)</p><p><code>A >(a1,a2,a3,a_n) B</code> : A 是 B 的祖先节点, 并且 A.depth 满足 B.depth-(a_m), 根节点的 depth=0</p><p><code>A <(a1,a2,a3,a_n) B</code> : A 是 B 的直接子节点, 并且 A.index 满足 a_m-1</p><p><code>A <<(a1,a2,a3,a_n) B</code> : A 是 B 的子孙节点, 并且 A.order 满足 a_m-1, A.order 是深度优先先序遍历的索引</p><h3 id="connect-shortcut" tabindex="-1">表达式简写 <a class="header-anchor" href="#connect-shortcut" aria-label="Permalink to &quot;表达式简写 {#connect-shortcut}&quot;"></a></h3><p>一般情况下, 并不需要写严格完整的表达式, 使用简化写法更方便快捷</p><p>下面是一些特殊情况下的简写表示</p><p>当 a=0 或 b=0 时, 括号可以省略, 以 <code>+</code> 为例</p><ul><li><code>A +(3n+0) B</code> -> <code>A +(3n) B</code> -> <code>A +3n B</code></li><li><code>A +(0n+3) B</code> -> <code>A +(+3) B</code> -> <code>A +3 B</code></li></ul><p>当 a=0 且 b=1 时, an+b 可以省略, 以 <code>+</code> 为例</p><ul><li><code>A +(0n+1) B</code> -> <code>A + B</code></li></ul><p>此外 <code>A + B</code>,<code>A > B</code> 都与等价的 CSS 语法语义相同</p><p>当 a=1 且 b=0 且操作符是 <code>></code>, 可以进一步简写, 比如</p><ul><li><code>A >(1n+0) B</code> -> <code>A >n B</code> -> <code>A B</code></li></ul><p>这与等价的 CSS 语法语义相同</p><h2 id="example" tabindex="-1">示例 <a class="header-anchor" href="#example" aria-label="Permalink to &quot;示例 {#example}&quot;"></a></h2><div class="language-txt vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">txt</span><pre class="shiki shiki-themes github-light github-dark vp-code"><code><span class="line"><span>@LinearLayout > TextView[id=`com.byted.pangle:id/tt_item_tv`][text=`不感兴趣`]</span></span></code></pre></div><p>选择器从末尾开始查找, 首先找到 id=`com.byted.pangle:id/tt_item_tv` 和 text=`不感兴趣` 的 TextView, 并且父节点是 LinearLayout 的节点</p><p>此时我们得到两个节点 [LinearLayout, TextView] 根据 <code>@</code> 知道目标节点是 LinearLayout</p><p>实际上它与</p><div class="language-txt vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">txt</span><pre class="shiki shiki-themes github-light github-dark vp-code"><code><span class="line"><span>TextView[id=`com.byted.pangle:id/tt_item_tv`][text=`不感兴趣`] <n LinearLayout</span></span></code></pre></div><p>的目标匹配节点是等价的, 但是在查询算法时间复杂度上, 后者更慢</p><p>如下是网页无障碍快照审查工具, 使用它的搜索框的选择器查询可以实时测试编写的选择器</p><ul><li><a href="https://i.gkd.li/i/14045424" target="_blank" rel="noreferrer">https://i.gkd.li/i/14045424</a></li><li><a href="https://i.gkd.li/i/14034770" target="_blank" rel="noreferrer">https://i.gkd.li/i/14034770</a></li><li><a href="https://i.gkd.li/i/14031920" target="_blank" rel="noreferrer">https://i.gkd.li/i/14031920</a></li><li><a href="https://i.gkd.li/i/14018243" target="_blank" rel="noreferrer">https://i.gkd.li/i/14018243</a></li><li><a href="https://i.gkd.li/i/14011298" target="_blank" rel="noreferrer">https://i.gkd.li/i/14011298</a></li><li><a href="https://i.gkd.li/i/13999908" target="_blank" rel="noreferrer">https://i.gkd.li/i/13999908</a></li></ul><h2 id="note" tabindex="-1">一些注意 <a class="header-anchor" href="#note" aria-label="Permalink to &quot;一些注意 {#note}&quot;"></a></h2><h3 id="regex-optimization" tabindex="-1">正则表达式优化 <a class="header-anchor" href="#regex-optimization" aria-label="Permalink to &quot;正则表达式优化 {#regex-optimization}&quot;"></a></h3><p>对 <code>matches</code>/<code>notMatches</code> 的优化: 如果正则表达式满足下面的条件, 选择器将使用内置的简单的函数匹配, 而不是真正地去运行一个正则表达式</p><ul><li><code>[text~="(?is)abc.*"]</code> -> <code>startsWith('abc', ignoreCase = true)</code></li><li><code>[text~="(?is).*abc.*"]</code> -> <code>contains('abc', ignoreCase = true)</code></li><li><code>[text~="(?is).*abc"]</code> -> <code>endsWith('abc', ignoreCase = true)</code></li><li><code>[text!~="(?is)abc.*"]</code> -> <code>notStartsWith('abc', ignoreCase = true)</code></li><li><code>[text!~="(?is).*abc.*"]</code> -> <code>notContains('abc', ignoreCase = true)</code></li><li><code>[text!~="(?is).*abc"]</code> -> <code>notEndsWith('abc', ignoreCase = true)</code></li></ul><p>上面的 <code>abc</code> 指代不包含 <code>\^$.?*|+()[]{}</code> 这类特殊正则字符的任意字符串, 如 <code>ikun</code> 符合, <code>ikun?</code> 不符合</p><p>简单来说就是如果你只想忽略大小写去简单匹配或不匹配一些字符, 那么直接使用上面的格式</p><h3 id="regex-multiplatform" tabindex="-1">正则表达式一致性 <a class="header-anchor" href="#regex-multiplatform" aria-label="Permalink to &quot;正则表达式一致性 {#regex-multiplatform}&quot;"></a></h3><p>由于 选择器 需要同时满足 浏览器/Js(审查工具), Android/Java(GKD) 运行, 而这两个平台的正则表达式的底层实现和语法表示略有不同</p><p>因此为了在 Js 端实现和 Java 一致的正则表达式规范, 网页审查工具借助 <a href="https://kotlinlang.org/docs/wasm-overview.html" target="_blank" rel="noreferrer">Kotlin Wasm</a> 将正则表达式的 matches 函数接口编译为 wasm 提供给 Js 调用</p><p>Kotlin Wasm 需要你的浏览器支持 <a href="https://developer.chrome.com/blog/wasmgc?hl=zh-cn" target="_blank" rel="noreferrer">WasmGC</a>, 也就是版本需要满足下列条件</p><p><img src="https://registry.npmmirror.com/@gkd-kit/assets/0.0.6/files/assets/0025.png" alt="image"></p><p>如果你的 nodejs, 需要 node>=22 版本</p><p>如果你的 浏览器/nodejs 版本不满足, 正则表达式将自动回退到 Js 端实现, 以下是在 Js 端使用正则表达式需要注意的地方</p><p>比如上面的正则表达式优化例子中开头的 <code>(?is)</code> 是 Java 正则表达式的 inline flags 语法, 但实际上 Js 并不支持这样写, 只是选择器内部做了一些兼容让它支持</p><p>并且选择器的 Js 端只兼容在开头的 flags, 在内部的 flags 不支持, 此外 Java 和 Js 支持的 flags 也有不同, 某些特殊的表达式也表现也不一致</p><p>总之不要使用太过复杂(多复杂我也不知道)的正则表达式, 某些正则表达式有可能在审查工具上匹配, 但是在 GKD 上不匹配</p><p>如果你能确保正则表达式在 Js 和 Java/Kotlin 的匹配行为一致, 那就没问题</p><p>总之两种情况</p><ul><li>高版本 浏览器/nodejs 可以使用 <strong>完整一致</strong> 的正则表达式</li><li>低版本 浏览器/nodejs 使用 <strong>小范围不完整不一致</strong> 的正则表达式</li></ul><p>如果你的选择器没有使用正则表达式则不用关心此问题</p><h3 id="nest-escape" tabindex="-1">嵌套转义字符 <a class="header-anchor" href="#nest-escape" aria-label="Permalink to &quot;嵌套转义字符 {#nest-escape}&quot;"></a></h3><p>转义字符一般用于表示不能直接显示具体特殊意义的字符</p><p>对于 GKD 的选择器而言, 转义字符使用示例如下</p><div class="language-txt vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">txt</span><pre class="shiki shiki-themes github-light github-dark vp-code"><code><span class="line"><span>TextView[text="\\\n"]</span></span></code></pre></div><p>这表达选择一个 TextView 它的 text 长度为 2, 开头是 <code>\</code> 末尾是换行</p><p>这和平常写的代码里面的 string 声明用法一模一样</p><p>但是选择器最终放在规则的字段里面, 也就是这个选择器字符串处于 JSON 的 string 内</p><p>如果你想当然地直接手动复制插入到编辑器里出现下面这种规则</p><div class="language-json5 vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">json5</span><pre class="shiki shiki-themes github-light github-dark vp-code"><code><span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">{</span></span>
 <span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">  matches</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'TextView[text="</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">\\\n</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">"]'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
 <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}</span></span></code></pre></div><p>由于 JSON 也有自己的转义, 规则与 GKD 的转义基本一致, 因此你的实际选择器实际变成了</p><div class="language-txt vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">txt</span><pre class="shiki shiki-themes github-light github-dark vp-code"><code><span class="line"><span>TextView[text="\</span></span>
 <span class="line"><span>"]</span></span></code></pre></div><p>这明显是一个非法的选择器</p><p>解决方式也很简单, 手动插入的时候将你的 <code>\</code> 变成 <code>\\</code>, 正确的规则如下</p><div class="language-json5 vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">json5</span><pre class="shiki shiki-themes github-light github-dark vp-code"><code><span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">{</span></span>
@@ -29,8 +29,8 @@
 <span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">  matches</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'TextView[text~="</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">\\\\\\\\</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">"]'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
 <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}</span></span></code></pre></div><p>实现和上面相同的结果, 即用 <code>=</code> 匹配一个 <code>\</code> 字符, 最终规则应该写成</p><div class="language-json5 vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">json5</span><pre class="shiki shiki-themes github-light github-dark vp-code"><code><span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">{</span></span>
 <span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">  matches</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'TextView[text="</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">\\\\</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">"]'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
-<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}</span></span></code></pre></div><p>类似的问题 <a href="https://github.com/gkd-kit/gkd/issues/603" target="_blank" rel="noreferrer">gkd-kit/gkd#603</a></p></div></div></main><footer class="VPDocFooter" data-v-2a2131eb data-v-74c3426e><!--[--><!--]--><div class="edit-info" data-v-74c3426e><div class="edit-link" data-v-74c3426e><a class="VPLink link vp-external-link-icon no-icon edit-link-button" href="https://github.com/gkd-kit/docs/edit/main/docs/selector/index.md" target="_blank" rel="noreferrer" data-v-74c3426e><!--[--><span class="vpi-square-pen edit-link-icon" data-v-74c3426e></span> 为此页提供修改建议<!--]--></a></div><div class="last-updated" data-v-74c3426e><p class="VPLastUpdated" data-v-74c3426e data-v-b9e7ea1d>最后更新于: <time datetime="2024-07-02T14:00:24.000Z" data-v-b9e7ea1d></time></p></div></div><nav class="prev-next" data-v-74c3426e><div class="pager" data-v-74c3426e><a class="VPLink link pager-link prev" href="/faq/" data-v-74c3426e><!--[--><span class="desc" data-v-74c3426e>上一篇</span><span class="title" data-v-74c3426e>疑难解答</span><!--]--></a></div><div class="pager" data-v-74c3426e><a class="VPLink link pager-link next" href="/selector/node.html" data-v-74c3426e><!--[--><span class="desc" data-v-74c3426e>下一篇</span><span class="title" data-v-74c3426e>属性方法</span><!--]--></a></div></nav></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><footer class="VPFooter has-sidebar" data-v-b9d42860 data-v-3a780ff6><div class="container" data-v-3a780ff6><p class="message" data-v-3a780ff6>Released under the GPL-v3 License.</p><p class="copyright" data-v-3a780ff6>Copyright © 2024 GKD. All rights reserved</p></div></footer><!--[--><!--]--></div></div>
-    <script>window.__VP_HASH_MAP__=JSON.parse("{\"api_interfaces_rawglobalruleprops.md\":\"D-CtCTHV\",\"api_interfaces_rawapp.md\":\"JuMOId3h\",\"api_interfaces_rawappruleprops.md\":\"C_Lr7qrT\",\"guide_index.md\":\"nWgIyn8J\",\"api_index.md\":\"4ccPi_ZZ\",\"api_interfaces_rawgroupprops.md\":\"DG4T80Dd\",\"api_interfaces_rawcommonprops.md\":\"CWJwfhiQ\",\"api_type-aliases_position.md\":\"qJyyaDP6\",\"api_type-aliases_integer.md\":\"scVDRZuk\",\"api_type-aliases_iarray.md\":\"CP0181Bu\",\"api_interfaces_rawglobalapp.md\":\"CCc1R6pz\",\"index.md\":\"DX8jmpux\",\"subscription_index.md\":\"DVyKcSsZ\",\"selector_node.md\":\"UgMCzR1F\",\"api_interfaces_rawglobalgroup.md\":\"BmaW8-Ss\",\"api_interfaces_rawcategory.md\":\"BqxO20ig\",\"api_interfaces_rawapprule.md\":\"BtiA0bcN\",\"api_interfaces_rawsubscription.md\":\"Cz9K1wkj\",\"api_interfaces_rawruleprops.md\":\"CRh5KyPR\",\"api_interfaces_rawglobalrule.md\":\"BCMr3k_N\",\"api_interfaces_rawappgroup.md\":\"C33JkI_D\",\"selector_index.md\":\"BGY0jCyS\",\"faq_index.md\":\"Dlz66Fnn\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"en-US\",\"dir\":\"ltr\",\"title\":\"GKD\",\"description\":\"自定义屏幕点击应用\",\"base\":\"/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"logo\":\"https://registry.npmmirror.com/@gkd-kit/docs/0.0.1706371840771/files/.vitepress/dist/logo.svg\",\"lastUpdatedText\":\"最后更新于\",\"outline\":\"deep\",\"docFooter\":{\"prev\":\"上一篇\",\"next\":\"下一篇\"},\"returnToTopLabel\":\"返回顶部\",\"outlineTitle\":\"导航栏\",\"darkModeSwitchLabel\":\"外观\",\"sidebarMenuLabel\":\"归档\",\"nav\":[{\"text\":\"首页\",\"link\":\"/\"},{\"text\":\"API\",\"link\":\"/api/\"}],\"sidebar\":[{\"text\":\"指引\",\"items\":[{\"text\":\"开始使用\",\"link\":\"/guide/\"},{\"text\":\"订阅规则\",\"link\":\"/subscription/\"},{\"text\":\"疑难解答\",\"link\":\"/faq/\"}]},{\"text\":\"选择器\",\"items\":[{\"text\":\"语法介绍\",\"link\":\"/selector/\"},{\"text\":\"属性方法\",\"link\":\"/selector/node\"}]},{\"text\":\"API\",\"link\":\"/api/\",\"items\":[{\"text\":\"Interfaces\",\"collapsed\":true,\"items\":[{\"text\":\"RawSubscription\",\"link\":\"/api/interfaces/RawSubscription.md\"},{\"text\":\"RawApp\",\"link\":\"/api/interfaces/RawApp.md\"},{\"text\":\"RawGlobalGroup\",\"link\":\"/api/interfaces/RawGlobalGroup.md\"},{\"text\":\"RawCategory\",\"link\":\"/api/interfaces/RawCategory.md\"},{\"text\":\"RawAppRule\",\"link\":\"/api/interfaces/RawAppRule.md\"},{\"text\":\"RawAppGroup\",\"link\":\"/api/interfaces/RawAppGroup.md\"},{\"text\":\"RawGlobalRule\",\"link\":\"/api/interfaces/RawGlobalRule.md\"},{\"text\":\"RawGlobalApp\",\"link\":\"/api/interfaces/RawGlobalApp.md\"},{\"text\":\"RawCommonProps\",\"link\":\"/api/interfaces/RawCommonProps.md\"},{\"text\":\"RawRuleProps\",\"link\":\"/api/interfaces/RawRuleProps.md\"},{\"text\":\"RawGroupProps\",\"link\":\"/api/interfaces/RawGroupProps.md\"},{\"text\":\"RawAppRuleProps\",\"link\":\"/api/interfaces/RawAppRuleProps.md\"},{\"text\":\"RawGlobalRuleProps\",\"link\":\"/api/interfaces/RawGlobalRuleProps.md\"}]},{\"text\":\"Type Aliases\",\"collapsed\":true,\"items\":[{\"text\":\"Position\",\"link\":\"/api/type-aliases/Position.md\"},{\"text\":\"IArray\",\"link\":\"/api/type-aliases/IArray.md\"},{\"text\":\"Integer\",\"link\":\"/api/type-aliases/Integer.md\"}]}]}],\"editLink\":{\"pattern\":\"https://github.com/gkd-kit/docs/edit/main/docs/:path\",\"text\":\"为此页提供修改建议\"},\"search\":{\"provider\":\"local\",\"options\":{}},\"socialLinks\":[{\"icon\":\"github\",\"link\":\"https://github.com/gkd-kit\"}],\"footer\":{\"message\":\"Released under the GPL-v3 License.\",\"copyright\":\"Copyright © 2024 GKD. All rights reserved\"}},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":false}");</script>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}</span></span></code></pre></div><p>类似的问题 <a href="https://github.com/gkd-kit/gkd/issues/603" target="_blank" rel="noreferrer">gkd-kit/gkd#603</a></p></div></div></main><footer class="VPDocFooter" data-v-2a2131eb data-v-74c3426e><!--[--><!--]--><div class="edit-info" data-v-74c3426e><div class="edit-link" data-v-74c3426e><a class="VPLink link vp-external-link-icon no-icon edit-link-button" href="https://github.com/gkd-kit/docs/edit/main/docs/selector/index.md" target="_blank" rel="noreferrer" data-v-74c3426e><!--[--><span class="vpi-square-pen edit-link-icon" data-v-74c3426e></span> 为此页提供修改建议<!--]--></a></div><div class="last-updated" data-v-74c3426e><p class="VPLastUpdated" data-v-74c3426e data-v-b9e7ea1d>最后更新于: <time datetime="2024-07-03T06:55:37.000Z" data-v-b9e7ea1d></time></p></div></div><nav class="prev-next" data-v-74c3426e><div class="pager" data-v-74c3426e><a class="VPLink link pager-link prev" href="/faq/" data-v-74c3426e><!--[--><span class="desc" data-v-74c3426e>上一篇</span><span class="title" data-v-74c3426e>疑难解答</span><!--]--></a></div><div class="pager" data-v-74c3426e><a class="VPLink link pager-link next" href="/selector/node.html" data-v-74c3426e><!--[--><span class="desc" data-v-74c3426e>下一篇</span><span class="title" data-v-74c3426e>属性方法</span><!--]--></a></div></nav></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><footer class="VPFooter has-sidebar" data-v-b9d42860 data-v-3a780ff6><div class="container" data-v-3a780ff6><p class="message" data-v-3a780ff6>Released under the GPL-v3 License.</p><p class="copyright" data-v-3a780ff6>Copyright © 2024 GKD. All rights reserved</p></div></footer><!--[--><!--]--></div></div>
+    <script>window.__VP_HASH_MAP__=JSON.parse("{\"faq_index.md\":\"d1Z8UZui\",\"api_interfaces_rawgroupprops.md\":\"DG4T80Dd\",\"selector_example.md\":\"DB3O13PI\",\"api_interfaces_rawglobalgroup.md\":\"BmaW8-Ss\",\"index.md\":\"yUr0-dxg\",\"subscription_index.md\":\"C0g0gfoU\",\"selector_index.md\":\"CXZu3Zbq\",\"api_interfaces_rawglobalruleprops.md\":\"D-CtCTHV\",\"api_interfaces_rawglobalrule.md\":\"BCMr3k_N\",\"api_interfaces_rawapp.md\":\"JuMOId3h\",\"api_interfaces_rawsubscription.md\":\"Cz9K1wkj\",\"api_type-aliases_iarray.md\":\"CP0181Bu\",\"api_interfaces_rawappruleprops.md\":\"C_Lr7qrT\",\"api_interfaces_rawcommonprops.md\":\"CWJwfhiQ\",\"api_type-aliases_position.md\":\"qJyyaDP6\",\"api_type-aliases_integer.md\":\"scVDRZuk\",\"api_interfaces_rawruleprops.md\":\"CRh5KyPR\",\"api_interfaces_rawglobalapp.md\":\"CCc1R6pz\",\"selector_node.md\":\"BV9tVGi_\",\"guide_index.md\":\"CxNC2DVO\",\"api_interfaces_rawcategory.md\":\"BqxO20ig\",\"api_index.md\":\"4ccPi_ZZ\",\"api_interfaces_rawappgroup.md\":\"C33JkI_D\",\"api_interfaces_rawapprule.md\":\"BtiA0bcN\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"en-US\",\"dir\":\"ltr\",\"title\":\"GKD\",\"description\":\"自定义屏幕点击应用\",\"base\":\"/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"logo\":\"https://registry.npmmirror.com/@gkd-kit/docs/0.0.1706371840771/files/.vitepress/dist/logo.svg\",\"lastUpdatedText\":\"最后更新于\",\"outline\":\"deep\",\"docFooter\":{\"prev\":\"上一篇\",\"next\":\"下一篇\"},\"returnToTopLabel\":\"返回顶部\",\"outlineTitle\":\"导航栏\",\"darkModeSwitchLabel\":\"外观\",\"sidebarMenuLabel\":\"归档\",\"nav\":[{\"text\":\"首页\",\"link\":\"/\"},{\"text\":\"API\",\"link\":\"/api/\"}],\"sidebar\":[{\"text\":\"指引\",\"items\":[{\"text\":\"开始使用\",\"link\":\"/guide/\"},{\"text\":\"订阅规则\",\"link\":\"/subscription/\"},{\"text\":\"疑难解答\",\"link\":\"/faq/\"}]},{\"text\":\"选择器\",\"items\":[{\"text\":\"语法介绍\",\"link\":\"/selector/\"},{\"text\":\"属性方法\",\"link\":\"/selector/node\"},{\"text\":\"选择示例\",\"link\":\"/selector/example\"}]},{\"text\":\"API\",\"link\":\"/api/\",\"items\":[{\"text\":\"Interfaces\",\"collapsed\":true,\"items\":[{\"text\":\"RawSubscription\",\"link\":\"/api/interfaces/RawSubscription.md\"},{\"text\":\"RawApp\",\"link\":\"/api/interfaces/RawApp.md\"},{\"text\":\"RawGlobalGroup\",\"link\":\"/api/interfaces/RawGlobalGroup.md\"},{\"text\":\"RawCategory\",\"link\":\"/api/interfaces/RawCategory.md\"},{\"text\":\"RawAppRule\",\"link\":\"/api/interfaces/RawAppRule.md\"},{\"text\":\"RawAppGroup\",\"link\":\"/api/interfaces/RawAppGroup.md\"},{\"text\":\"RawGlobalRule\",\"link\":\"/api/interfaces/RawGlobalRule.md\"},{\"text\":\"RawGlobalApp\",\"link\":\"/api/interfaces/RawGlobalApp.md\"},{\"text\":\"RawCommonProps\",\"link\":\"/api/interfaces/RawCommonProps.md\"},{\"text\":\"RawRuleProps\",\"link\":\"/api/interfaces/RawRuleProps.md\"},{\"text\":\"RawGroupProps\",\"link\":\"/api/interfaces/RawGroupProps.md\"},{\"text\":\"RawAppRuleProps\",\"link\":\"/api/interfaces/RawAppRuleProps.md\"},{\"text\":\"RawGlobalRuleProps\",\"link\":\"/api/interfaces/RawGlobalRuleProps.md\"}]},{\"text\":\"Type Aliases\",\"collapsed\":true,\"items\":[{\"text\":\"Position\",\"link\":\"/api/type-aliases/Position.md\"},{\"text\":\"IArray\",\"link\":\"/api/type-aliases/IArray.md\"},{\"text\":\"Integer\",\"link\":\"/api/type-aliases/Integer.md\"}]}]}],\"editLink\":{\"pattern\":\"https://github.com/gkd-kit/docs/edit/main/docs/:path\",\"text\":\"为此页提供修改建议\"},\"search\":{\"provider\":\"local\",\"options\":{}},\"socialLinks\":[{\"icon\":\"github\",\"link\":\"https://github.com/gkd-kit\"}],\"footer\":{\"message\":\"Released under the GPL-v3 License.\",\"copyright\":\"Copyright © 2024 GKD. All rights reserved\"}},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":false}");</script>
   </body>
 </html>