From 05d6a71da83a3674c64b4a9e1bf50ada465ea172 Mon Sep 17 00:00:00 2001
From: mini2024 <mini2024@oo1.dev>
Date: Sun, 30 Mar 2025 22:57:42 +0800
Subject: [PATCH] feat: <Isolate />

---
 .clinerules-code                              |  5 ++
 .github/copilot-instructions.md               |  5 ++
 .../API/index.page.vue => Page/API.page.vue}  |  0
 src/pages/{Tool => Page}/Icons.page.vue       |  0
 .../Page/Style}/StyleLayer.vue                |  2 +-
 .../Style/css-modules.vue}                    |  7 +-
 src/pages/Page/Style/index.page.vue           | 11 +++
 src/pages/Page/Style/isolate.vue              | 73 +++++++++++++++++++
 src/pages/{Tool => Page}/fonts.page.vue       |  0
 src/pages/{Tool => PkgsUsage}/I18n.page.vue   |  0
 .../{Tool => PkgsUsage}/ts-enum-util.page.vue |  0
 typed-router.d.ts                             | 12 +--
 12 files changed, 103 insertions(+), 12 deletions(-)
 create mode 100644 .clinerules-code
 create mode 100644 .github/copilot-instructions.md
 rename src/pages/{Tool/API/index.page.vue => Page/API.page.vue} (100%)
 rename src/pages/{Tool => Page}/Icons.page.vue (100%)
 rename src/{components => pages/Page/Style}/StyleLayer.vue (97%)
 rename src/pages/{Tool/style.page.vue => Page/Style/css-modules.vue} (62%)
 create mode 100644 src/pages/Page/Style/index.page.vue
 create mode 100644 src/pages/Page/Style/isolate.vue
 rename src/pages/{Tool => Page}/fonts.page.vue (100%)
 rename src/pages/{Tool => PkgsUsage}/I18n.page.vue (100%)
 rename src/pages/{Tool => PkgsUsage}/ts-enum-util.page.vue (100%)

diff --git a/.clinerules-code b/.clinerules-code
new file mode 100644
index 0000000..3ad4bb4
--- /dev/null
+++ b/.clinerules-code
@@ -0,0 +1,5 @@
+# 项目指导
+
+## UnoCSS 使用规范
+1. **优先使用 UnoCSS 原子类**，避免手写 CSS：
+- 例如：`text-red-500`、`p-4`、`flex items-center`。
diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md
new file mode 100644
index 0000000..fe5dbba
--- /dev/null
+++ b/.github/copilot-instructions.md
@@ -0,0 +1,5 @@
+# 项目指导
+
+## UnoCSS 使用规范
+1. **优先使用 UnoCSS 原子类**，避免手写 CSS：
+   - 例如：`text-red-500`、`p-4`、`flex items-center`。
diff --git a/src/pages/Tool/API/index.page.vue b/src/pages/Page/API.page.vue
similarity index 100%
rename from src/pages/Tool/API/index.page.vue
rename to src/pages/Page/API.page.vue
diff --git a/src/pages/Tool/Icons.page.vue b/src/pages/Page/Icons.page.vue
similarity index 100%
rename from src/pages/Tool/Icons.page.vue
rename to src/pages/Page/Icons.page.vue
diff --git a/src/components/StyleLayer.vue b/src/pages/Page/Style/StyleLayer.vue
similarity index 97%
rename from src/components/StyleLayer.vue
rename to src/pages/Page/Style/StyleLayer.vue
index cdbb34a..4357e4b 100644
--- a/src/components/StyleLayer.vue
+++ b/src/pages/Page/Style/StyleLayer.vue
@@ -1,5 +1,5 @@
 <template>
-  <div b="1px solid #ccc" p="10px" mt="10px">
+  <div b="1px solid #ccc" p-4 mt-4>
     <div class="layer-demo">这是一个测试@layer的元素</div>
     <div class="layer-nested">这是测试嵌套layer的元素</div>
 
diff --git a/src/pages/Tool/style.page.vue b/src/pages/Page/Style/css-modules.vue
similarity index 62%
rename from src/pages/Tool/style.page.vue
rename to src/pages/Page/Style/css-modules.vue
index 02a77c3..801135b 100644
--- a/src/pages/Tool/style.page.vue
+++ b/src/pages/Page/Style/css-modules.vue
@@ -1,15 +1,12 @@
-<script setup lang="ts"></script>
-
 <template>
   <div :class="$style.hero" mt-2>
+    <div>CSS Modules:</div>
+    <div>https://cn.vuejs.org/api/sfc-css-features#css-modules</div>
     <pre>{{ JSON.stringify({ $style }, null, 2) }}</pre>
   </div>
-  <StyleLayer />
 </template>
 
 <style module>
-/* https://cn.vuejs.org/api/sfc-css-features#css-modules */
-
 .hero {
   border: 1px solid #42b983;
 }
diff --git a/src/pages/Page/Style/index.page.vue b/src/pages/Page/Style/index.page.vue
new file mode 100644
index 0000000..571bf17
--- /dev/null
+++ b/src/pages/Page/Style/index.page.vue
@@ -0,0 +1,11 @@
+<script setup lang="ts">
+import CSSModules from './css-modules.vue';
+import Isolate from './isolate.vue';
+import StyleLayer from './StyleLayer.vue';
+</script>
+
+<template>
+  <CSSModules />
+  <StyleLayer />
+  <Isolate />
+</template>
diff --git a/src/pages/Page/Style/isolate.vue b/src/pages/Page/Style/isolate.vue
new file mode 100644
index 0000000..187eb1d
--- /dev/null
+++ b/src/pages/Page/Style/isolate.vue
@@ -0,0 +1,73 @@
+<script setup lang="ts">
+const description =
+  'CSS isolation: isolate 用于创建独立的层叠上下文，使元素内部的 z-index 值只在内部比较，不会影响外部元素的堆叠顺序';
+</script>
+
+<template>
+  <div class="p-8 space-y-8" b="1px solid #e5e7eb" mt-4>
+    <h1 class="text-2xl font-bold">CSS Isolation 演示</h1>
+    <p class="mb-6">{{ description }}</p>
+
+    <!-- 实际应用场景示例 -->
+    <div class="mt-10 border rounded p-4 bg-gray-50">
+      <h2 class="text-lg font-semibold mb-4">实际应用：模态框和下拉菜单</h2>
+
+      <div class="grid grid-cols-2 gap-8">
+        <!-- 左侧：问题演示 -->
+        <div>
+          <h3 class="font-medium mb-2">没有使用 isolate 的问题</h3>
+          <div class="relative h-60 border border-dashed border-gray-300 bg-gray-100">
+            <!-- 网站内容 -->
+            <div class="p-2">
+              <div class="bg-white p-2 mb-2">网站内容</div>
+
+              <!-- 假设这是导航栏的下拉菜单 -->
+              <div class="relative">
+                <button class="bg-blue-500 text-white px-2 py-1 rounded">导航 ▼</button>
+                <div class="absolute mt-1 bg-white shadow rounded p-2 border border-gray-200 z-50">下拉菜单 (z-50)</div>
+              </div>
+            </div>
+
+            <!-- 假设这是模态框 -->
+            <div class="absolute inset-0 bg-black bg-opacity-50 flex items-center justify-center z-40">
+              <div class="bg-white p-4 rounded shadow-lg w-36">
+                模态框 (z-40)<br />
+                <span class="text-red-500 text-xs">被下拉菜单覆盖了!</span>
+              </div>
+            </div>
+          </div>
+        </div>
+
+        <!-- 右侧：解决方案 -->
+        <div>
+          <h3 class="font-medium mb-2">使用 isolate 解决问题</h3>
+          <div class="relative h-60 border border-dashed border-gray-300 bg-gray-100">
+            <!-- 网站内容 -->
+            <div class="p-2">
+              <div class="bg-white p-2 mb-2">网站内容</div>
+
+              <!-- 使用 isolate 的下拉菜单 -->
+              <div class="relative isolate">
+                <button class="bg-blue-500 text-white px-2 py-1 rounded">导航 ▼</button>
+                <div class="absolute mt-1 bg-white shadow rounded p-2 border border-gray-200 z-50">下拉菜单 (z-50)</div>
+              </div>
+            </div>
+
+            <!-- 模态框 -->
+            <div class="absolute inset-0 bg-black bg-opacity-50 flex items-center justify-center z-40">
+              <div class="bg-white p-4 rounded shadow-lg w-36">
+                模态框 (z-40)<br />
+                <span class="text-green-500 text-xs">正确显示在顶层!</span>
+              </div>
+            </div>
+          </div>
+        </div>
+      </div>
+
+      <p class="mt-4 text-sm">
+        使用 isolate 后，导航菜单的 z-index 只在其容器内部起作用，
+        不再与页面上的模态框比较。这样模态框可以正确显示在最上层， 而不需要使用极大的 z-index 值。
+      </p>
+    </div>
+  </div>
+</template>
diff --git a/src/pages/Tool/fonts.page.vue b/src/pages/Page/fonts.page.vue
similarity index 100%
rename from src/pages/Tool/fonts.page.vue
rename to src/pages/Page/fonts.page.vue
diff --git a/src/pages/Tool/I18n.page.vue b/src/pages/PkgsUsage/I18n.page.vue
similarity index 100%
rename from src/pages/Tool/I18n.page.vue
rename to src/pages/PkgsUsage/I18n.page.vue
diff --git a/src/pages/Tool/ts-enum-util.page.vue b/src/pages/PkgsUsage/ts-enum-util.page.vue
similarity index 100%
rename from src/pages/Tool/ts-enum-util.page.vue
rename to src/pages/PkgsUsage/ts-enum-util.page.vue
diff --git a/typed-router.d.ts b/typed-router.d.ts
index c5bae95..b0185be 100644
--- a/typed-router.d.ts
+++ b/typed-router.d.ts
@@ -23,16 +23,16 @@ declare module 'vue-router/auto-routes' {
     'DataLoadersId': RouteRecordInfo<'DataLoadersId', '/data-loaders/:id', { id: ParamValue<true> }, { id: ParamValue<false> }>,
     'DataLoadersIdSub1UserId': RouteRecordInfo<'DataLoadersIdSub1UserId', '/data-loaders/:id/sub-1/:userId', { id: ParamValue<true>, userId: ParamValue<true> }, { id: ParamValue<false>, userId: ParamValue<false> }>,
     'FlowbiteSidebar': RouteRecordInfo<'FlowbiteSidebar', '/FlowbiteSidebar', Record<never, never>, Record<never, never>>,
+    'PageAPI': RouteRecordInfo<'PageAPI', '/Page/API', Record<never, never>, Record<never, never>>,
+    'PageFonts': RouteRecordInfo<'PageFonts', '/Page/fonts', Record<never, never>, Record<never, never>>,
+    'PageIcons': RouteRecordInfo<'PageIcons', '/Page/Icons', Record<never, never>, Record<never, never>>,
     'PageJSPage': RouteRecordInfo<'PageJSPage', '/Page/JSPage', Record<never, never>, Record<never, never>>,
     'PageMDPage': RouteRecordInfo<'PageMDPage', '/Page/MDPage', Record<never, never>, Record<never, never>>,
+    'PageStyle': RouteRecordInfo<'PageStyle', '/Page/Style', Record<never, never>, Record<never, never>>,
+    'PkgsUsageI18n': RouteRecordInfo<'PkgsUsageI18n', '/PkgsUsage/I18n', Record<never, never>, Record<never, never>>,
+    'PkgsUsageTsEnumUtil': RouteRecordInfo<'PkgsUsageTsEnumUtil', '/PkgsUsage/ts-enum-util', Record<never, never>, Record<never, never>>,
     'SatelliteCesium': RouteRecordInfo<'SatelliteCesium', '/Satellite/Cesium', Record<never, never>, Record<never, never>>,
     'SatelliteOrbPro': RouteRecordInfo<'SatelliteOrbPro', '/Satellite/OrbPro', Record<never, never>, Record<never, never>>,
-    'ToolAPI': RouteRecordInfo<'ToolAPI', '/Tool/API', Record<never, never>, Record<never, never>>,
-    'ToolFonts': RouteRecordInfo<'ToolFonts', '/Tool/fonts', Record<never, never>, Record<never, never>>,
-    'ToolI18n': RouteRecordInfo<'ToolI18n', '/Tool/I18n', Record<never, never>, Record<never, never>>,
-    'ToolIcons': RouteRecordInfo<'ToolIcons', '/Tool/Icons', Record<never, never>, Record<never, never>>,
-    'ToolStyle': RouteRecordInfo<'ToolStyle', '/Tool/style', Record<never, never>, Record<never, never>>,
-    'ToolTsEnumUtil': RouteRecordInfo<'ToolTsEnumUtil', '/Tool/ts-enum-util', Record<never, never>, Record<never, never>>,
     'UIComponentsAntdV': RouteRecordInfo<'UIComponentsAntdV', '/UI-components/AntdV', Record<never, never>, Record<never, never>>,
     'UIComponentsComponents': RouteRecordInfo<'UIComponentsComponents', '/UI-components/Components', Record<never, never>, Record<never, never>>,
     'UIComponentsInfiniteLoading': RouteRecordInfo<'UIComponentsInfiniteLoading', '/UI-components/infinite-loading', Record<never, never>, Record<never, never>>,