feat: <Isolate />

.clinerules-code

@@ -0,0 +1,5 @@
+# 项目指导
+
+## UnoCSS 使用规范
+1. **优先使用 UnoCSS 原子类**，避免手写 CSS：
+- 例如：`text-red-500`、`p-4`、`flex items-center`。

.github/copilot-instructions.md

@@ -0,0 +1,5 @@
+# 项目指导
+
+## UnoCSS 使用规范
+1. **优先使用 UnoCSS 原子类**，避免手写 CSS：
+   - 例如：`text-red-500`、`p-4`、`flex items-center`。

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>
 

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;
 }

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>

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>

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>>,