s.expects),"|"),async:!1,options:i,message:e,"~run"(s,a){let n,r,t;for(const h of this.options){const l=h["~run"]({value:s.value},a);if(l.typed)if(l.issues)r?r.push(l):r=[l];else{n=l;break}else t?t.push(l):t=[l]}if(n)return n;if(r){if(r.length===1)return r[0];u(this,"type",s,a,{issues:gs(r)}),s.typed=!0}else{if((t==null?void 0:t.length)===1)return t[0];u(this,"type",s,a,{issues:gs(t)})}return s}})}function Ss(){return m({kind:"schema",type:"unknown",reference:Ss,expects:"unknown",async:!1,"~run"(i){return i.typed=!0,i}})}function p(...i){return m({...i[0],pipe:i,"~run"(e,s){for(const a of i)if(a.kind!=="metadata"){if(e.issues&&(a.kind==="schema"||a.kind==="transformation")){e.typed=!1;break}(!e.issues||!s.abortEarly&&!s.abortPipeEarly)&&(e=a["~run"](e,s))}return e}})}function ii(i,e,s){const a=i["~run"]({value:e},bs());return{typed:a.typed,success:!a.issues,output:a.value,issues:a.issues}}const _=p(ss(),Q(1),P(256)),Ns=p(Ps(),As()),ls=G([_,Ns]),fs=p(_,j(/^[\w-]+\/[\w-]+$/)),Y="(?:[\\w~.-]+|:[A-Za-z_]\\w*\\??)",rs=p(_,j(new RegExp(`^/${Y}(?:/${Y})*$`))),ms=/^(?:[oO][nN]|innerHTML$|outerHTML$|srcdoc$|__proto__$|constructor$|prototype$)/,ei=p(Os(ss(),Ss()),ws(i=>Object.keys(i).every(e=>!ms.test(e)),"Unsafe view prop."),Bs({propertyNames:{not:{pattern:ms.source}}})),ai={path:p(_,j(new RegExp(`^/?${Y}(?:/${Y})*$`)),E("Absolute or relative child path. Supports named and optional parameters.")),name:k(p(_,j(/^[A-Za-z_][\w.-]*$/),E("Unique Vue Router name. Required for keepAlive."))),component:k(p(_,E("Registered view ID. Use layout for a menu group."))),alias:k(p(G([rs,p(V(rs),Q(1),P(16))]),E("Absolute alternative path(s) for a leaf."))),redirect:k(p(rs,E("Absolute path of another configured page."))),props:k(p(G([S(),ei]),E("Pass route params (true) or a JSON object to the view."))),meta:H({i18nKey:k(p(_,E("Translation key for the menu title."))),noLocalTitle:k(p(ls,E("Literal title if i18nKey is absent."))),icon:k(p(fs,E("IconName from src/icons/manifest.ts."))),role:k(p(V(ls),P(32),E("Allowed roles. Omitted or empty means any authenticated role."))),hidden:k(p(S(),E("Hide from the menu. Direct navigation still uses the role guard."))),sameLevel:k(p(S(),E("Append a breadcrumb without replacing the current tab."))),order:k(p(Ns,E("Menu sort order at the top level."))),env:k(p(G([_,p(V(_),P(16))]),E("Vite mode(s) in which the menu item is visible."))),windowOpen:k(p(ss(),P(2048),j(/^[Hh][Tt][Tt][Pp][Ss]?:\/\//),E("Open this HTTP(S) URL in a new tab."))),ignoreAutoResetScroll:k(p(S(),E("Keep the content scroll position on navigation."))),keepAlive:k(p(S(),E("Keep the view mounted. name must match the registered view name."))),extra:k(p(H({label:k(ls),i18nLabel:k(_),icon:k(fs),show:k(S()),type:k(qs(["default","primary","info","success","warning","error"]))}),E("Optional menu badge.")))})},Ts=H({...ai,children:k(p(V(xs(()=>Ts)),Q(1),P(300)))}),ni=p(H({version:Rs(1),routes:p(V(Ts),P(300))}),Ds("Ray Template route configuration")),ti=(i,e)=>e.startsWith("/")?e:`${i.replace(/\/$/,"")}/${e}`;function li(i){var C;const{layout:e,findRouteView:s,findRouteViewId:a,managementPath:n,homePath:r}=i,t=c=>c==="/"||c===n||c.startsWith(`${n}/`),h=new Set((C=i.reservedNames)==null?void 0:C.map(c=>c.toLowerCase())),l=256*1024,d=c=>typeof c=="string"?[c]:c??[];function o(c){if(c.length>l)throw new Error("Route configuration exceeds 256 KiB.");const w=JSON.parse(c);let A=0;const x=(B,$)=>{if(Array.isArray(B)){if(A+=B.length,A>300||$>8)throw new Error("Use at most 300 routes and 8 menu levels.");for(const f of B)x(f==null?void 0:f.children,$+1)}};x(w==null?void 0:w.routes,1);const q=ii(ni,w);if(!q.success)throw new Error(q.issues.slice(0,20).map(B=>`${Qs(B)??"config"}: ${B.message}`).join(`
+`));const R=q.output,v=new Map,z=new Set(h),J=new Set,T=new Set,U=(B,$="",f=!1)=>{var M,L,hs;for(const is of B){const{name:X,component:O,children:Z,alias:ks,redirect:os,props:Es,meta:b}=is,D=ti($,is.path),y=g=>{throw new Error(`${D}: ${g}`)},es=D.toLowerCase();if((J.has(es)||t(es))&&y("Duplicate or reserved menu path."),J.add(es),b.windowOpen&&!URL.canParse(b.windowOpen)&&y("Invalid external URL."),X){const g=X.toLowerCase();z.has(g)&&y(`Duplicate or reserved name "${X}".`),z.add(g)}for(const g of[b.icon,(M=b.extra)==null?void 0:M.icon])g&&!Hs(g)&&y(`Unknown icon "${g}".`);if(Z!=null&&Z.length){(O&&O!=="layout"||ks||os||Es!==void 0||b.windowOpen)&&y("Groups accept layout, children and menu metadata."),D.includes(":")&&y("Use static paths for menu groups."),U(Z,D,f||!!((L=b.role)!=null&&L.length));continue}const K=O&&s(O);O&&!K&&y(`Unknown view "${O}".`),+!!O+ +!!os+ +!!b.windowOpen!=1&&y("Specify exactly one view, redirect or external URL."),Es!==void 0&&!K&&y("Props require a view."),b.keepAlive&&(!K||X!==K.name)&&y("keepAlive requires the registered component name."),D.includes(":")&&!b.hidden&&!b.sameLevel&&y("Parameterized paths must be hidden or sameLevel.");for(const g of[D,...d(ks)]){const I=g.toLowerCase();I.split("/").some(us=>us==="."||us==="..")&&y(`Invalid path "${g}".`),(t(I)||v.has(I))&&y(`Duplicate or reserved path "${g}".`),I===r&&(g!==D||D!==r||!K||f||(hs=b.role)!=null&&hs.length)&&y("/dashboard must be a view accessible to all authenticated roles."),g!==D&&(g.includes(":")||D.includes(":"))&&y("Aliases require a static page path.");const ds=I.replace(/:[a-z_]\w*/g,":param");T.has(ds)&&y(`Conflicting parameter pattern "${g}".`),T.add(ds),v.set(I,is)}}};U(R.routes);for(const[B,$]of v){let f=$;const M=new Set;for(;f.redirect;){const L=v.get(f.redirect.toLowerCase());if(M.has(f)||!L||L.meta.windowOpen||f.redirect.includes(":"))throw new Error(`${B}: Redirects must reach a configured page without a cycle.`);M.add(f),f=L}}return R}function F(c){const w=({component:A,children:x,meta:q,...R})=>{var v;return{...R,meta:q,component:A==="layout"?e:A?(v=s(A))==null?void 0:v.load:void 0,children:x==null?void 0:x.map(w)}};return c.routes.map(w)}function N(c){const w=({path:A,name:x,meta:q,component:R,children:v,props:z,alias:J,redirect:T})=>{const U=R===e?"layout":a(R);if(R&&!U)throw new Error(`${A}: Register the view in router/config/views.ts before exporting.`);if(T&&typeof T!="string")throw new Error(`${A}: Export requires a string redirect.`);return{path:A,name:x,meta:q,component:U,alias:J,redirect:T,props:z,children:v==null?void 0:v.map(w)}};return o(JSON.stringify({version:1,routes:c.map(w)}))}return{parseRouteConfig:o,toRuntimeRoutes:F,exportRouteConfig:N}}const ri={class:"ray-demo ray-demo-fields"},pi=["for"],hi=["id","aria-invalid"],ki={class:"ray-demo-result"},oi=$s({__name:"RouteConfigDemo",setup(i){const e=async()=>({}),{parseRouteConfig:s}=li({layout:e,homePath:"/overview",managementPath:"/route-management",findRouteView:t=>t==="overview"?{name:"Overview",load:e}:void 0,findRouteViewId:t=>t===e?"overview":void 0}),a=Ls(),n=Is(JSON.stringify({version:1,routes:[{path:"/overview",component:"overview",name:"Overview",meta:{}}]},null,2)),r=Ms(()=>{try{const{routes:t}=s(n.value);return{invalid:!1,message:`有效路由 / Valid routes: ${t.length}`}}catch(t){return{invalid:!0,message:t instanceof Error?t.message:String(t)}}});return(t,h)=>(Fs(),vs("div",ri,[W("div",null,[W("label",{for:cs(a)},"路由配置 / Route configuration",8,pi),js(W("textarea",{id:cs(a),"onUpdate:modelValue":h[0]||(h[0]=l=>n.value=l),rows:"8",spellcheck:"false","aria-invalid":r.value.invalid},null,8,hi),[[Vs,n.value]]),W("output",ki,Us(r.value.message),1)])]))}}),Ei=Ks(oi,[["__scopeId","data-v-e6a3014a"]]),yi=JSON.parse('{"title":"路由、菜单与权限","description":"","frontmatter":{},"headers":[],"relativePath":"guide/routing.md","filePath":"guide/routing.md"}'),di={name:"guide/routing.md"},gi=Object.assign(di,{setup(i){return(e,s)=>(Fs(),vs("div",null,[s[0]||(s[0]=ys("",4)),Gs(Ei),s[1]||(s[1]=ys("",9))]))}});export{yi as __pageData,gi as default};
diff --git a/docs/assets/guide_start.md.B6oCR027.js b/docs/assets/guide_start.md.B6oCR027.js
new file mode 100644
index 00000000..56b817f9
--- /dev/null
+++ b/docs/assets/guide_start.md.B6oCR027.js
@@ -0,0 +1,8 @@
+import{_ as s,o as i,c as e,a3 as t}from"./chunks/framework.BNdm2jZV.js";const c=JSON.parse('{"title":"快速开始","description":"","frontmatter":{},"headers":[],"relativePath":"guide/start.md","filePath":"guide/start.md"}'),n={name:"guide/start.md"};function l(p,a,h,r,d,k){return i(),e("div",null,[...a[0]||(a[0]=[t(`快速开始
本文使用 Ray Template v6。v5 项目请先查看版本分界。
启动工作台
准备 Node.js 26.13.0 和 pnpm 12.16.1。以下以 nvm 为例:
shgit clone https://github.com/XiaoDaiGua-Ray/ray-template.git
+cd ray-template
+nvm install
+nvm use
+npm install --global pnpm@12.16.1
+pnpm install --frozen-lockfile
+pnpm env:check
+pnpm dev
打开 http://127.0.0.1:9527/ray-template/,如果端口被占用,以 Vite 输出的地址为准。使用预填表单登录,再打开「表格 → 远端查询与分页」或「布局实验室」。也可直接体验在线演示。
演示与真实业务
预填表单、会话和 Mock 用于展示前端工作流。对外部署真实业务前,接入自己的认证、服务端权限校验和 API。
启动文档
在同一个工作区运行 pnpm docs:dev。按终端地址打开 /ray-template/docs/,可以直接操作 TablePro、条码和布局示例。
相关文档
第一个业务页面 · v5 与 v6 的版本分界 · 工程检查与部署
运行时与依赖清单 · 项目目录与启动链路
`,12)])])}const F=s(n,[["render",l]]);export{c as __pageData,F as default};
diff --git a/docs/assets/guide_start.md.B6oCR027.lean.js b/docs/assets/guide_start.md.B6oCR027.lean.js
new file mode 100644
index 00000000..81678429
--- /dev/null
+++ b/docs/assets/guide_start.md.B6oCR027.lean.js
@@ -0,0 +1 @@
+import{_ as s,o as i,c as e,a3 as t}from"./chunks/framework.BNdm2jZV.js";const c=JSON.parse('{"title":"快速开始","description":"","frontmatter":{},"headers":[],"relativePath":"guide/start.md","filePath":"guide/start.md"}'),n={name:"guide/start.md"};function l(p,a,h,r,d,k){return i(),e("div",null,[...a[0]||(a[0]=[t("",12)])])}const F=s(n,[["render",l]]);export{c as __pageData,F as default};
diff --git a/docs/assets/guide_tooling.md.CkJoP04H.js b/docs/assets/guide_tooling.md.CkJoP04H.js
new file mode 100644
index 00000000..15dcf3f0
--- /dev/null
+++ b/docs/assets/guide_tooling.md.CkJoP04H.js
@@ -0,0 +1 @@
+import{_ as t,o as d,c as o,a3 as a}from"./chunks/framework.BNdm2jZV.js";const m=JSON.parse('{"title":"工程检查与部署","description":"","frontmatter":{},"headers":[],"relativePath":"guide/tooling.md","filePath":"guide/tooling.md"}'),c={name:"guide/tooling.md"};function r(i,e,p,n,s,l){return d(),o("div",null,[...e[0]||(e[0]=[a('工程检查与部署
常用命令
| 命令 | 用途 |
|---|
pnpm env:check | 校验 Node、pnpm 与依赖安装 |
pnpm dev | 同步图标清单并启动 Vite |
pnpm harness context | 查任务域;追加 routing、ui、api 等可看实现入口和回归 |
pnpm harness verify ui | 按域运行定向测试 |
pnpm harness verify | 运行全量检查并生成本地报告 |
pnpm typecheck | 验证图标清单,检查应用、Node 配置和测试类型 |
pnpm dev-build / pnpm report | 构建开发版,或输出静态打包报告 |
pnpm build / pnpm preview | 构建并在本机验收产物 |
pnpm packages:check | 检查公开入口、依赖声明和循环依赖 |
pnpm pages:build | 将后台与文档组装到 dist/pages |
pnpm docs:dev | 启动文档开发站 |
pnpm docs:check | 验证文档示例类型、站内链接与生产构建 |
pnpm docs:preview | 预览已构建的文档站 |
全量检查包含环境、Harness、图标同步、类型、ESLint、Prettier、Vitest 和生产构建。Harness 在 .harness-local/runs/ 写结果;Chrome 验收单独记录。改动交互或布局时,额外验收中英文、明暗主题和窄屏。
部署到子路径
pnpm build 输出 dist/production。将产物部署到与 vite.custom.config.ts 中 base 对应的路径。默认应用为 /ray-template/,域名根目录部署改为 /。Vite 默认打包本地依赖;可选 CDN 模式需另外确认目标环境能访问 CDN。
组合部署使用 pnpm pages:build,将 dist/pages 作为同一个站点的产物。官方地址为 /ray-template/,其下 docs/ 目录提供 v6 官网。CI 传入 RAY_TEMPLATE_SOURCE_REF,把文档的当前源码链接固定到发布提交。
公开生产部署可在构建环境设置 RAY_TEMPLATE_SITE_ORIGIN 为实际站点源地址(例如 https://example.com),由 base 补足路径。未配置时应用产物使用 noindex。公开 sitemap 列出入口页,登录后的 hash 路由用于应用交互。
二次开发约定
- 新页面遵循 Vue 3 Composition API + TSX 或现有 SFC 模式。复用现有组件,声明按职责归档。
- Vue、Router、Pinia 的自动导入声明由生成器维护;类型使用
import type。应用、测试、Node 配置的 TS 边界不同。 - 格式由 Prettier 管理,ESLint 使用 flat config。提交约定和注释写法以应用仓库当前规则为准。
工程与部署入口 · AI Harness · 注释规范
',11)])])}const b=t(c,[["render",r]]);export{m as __pageData,b as default};
diff --git a/docs/assets/guide_tooling.md.CkJoP04H.lean.js b/docs/assets/guide_tooling.md.CkJoP04H.lean.js
new file mode 100644
index 00000000..9061b6cb
--- /dev/null
+++ b/docs/assets/guide_tooling.md.CkJoP04H.lean.js
@@ -0,0 +1 @@
+import{_ as t,o as d,c as o,a3 as a}from"./chunks/framework.BNdm2jZV.js";const m=JSON.parse('{"title":"工程检查与部署","description":"","frontmatter":{},"headers":[],"relativePath":"guide/tooling.md","filePath":"guide/tooling.md"}'),c={name:"guide/tooling.md"};function r(i,e,p,n,s,l){return d(),o("div",null,[...e[0]||(e[0]=[a("",11)])])}const b=t(c,[["render",r]]);export{m as __pageData,b as default};
diff --git a/docs/assets/index.md.nUYT09g4.js b/docs/assets/index.md.nUYT09g4.js
new file mode 100644
index 00000000..b245e7fb
--- /dev/null
+++ b/docs/assets/index.md.nUYT09g4.js
@@ -0,0 +1 @@
+import{d as y,o as i,c as o,j as e,t as l,k as s,g as r,a3 as p,F as d,B as _,E as u}from"./chunks/framework.BNdm2jZV.js";import{v as f,d as v}from"./chunks/theme.C9yy6i4V.js";const g={class:"ray-home"},b={class:"ray-hero"},M={class:"ray-lead"},w={class:"ray-actions"},k=["href"],T=["href"],x={class:"ray-map","aria-labelledby":"ray-map-title"},B=["href"],z={class:"ray-paths","aria-labelledby":"ray-paths-title"},P=["href","aria-labelledby","aria-describedby"],S={class:"ray-path-icon",viewBox:"0 0 24 24","aria-hidden":"true"},A=["d"],N=["id"],R=["id"],V={class:"ray-showcase","aria-labelledby":"ray-showcase-title"},$={class:"ray-showcase-links"},C=["href"],H=["href"],D=["src"],E=y({__name:"RayHome",setup(m){const n=[{title:"Ray Admin",name:"apps/admin",href:"/guide/layout.html"},{title:"共享包",name:"packages",href:"/guide/architecture.html"},{title:"页内交互",name:"apps/docs",href:"/reference/table-pro.html"}],c=[{title:"第一个业务页面",summary:"添加订单列表、路由和菜单。",href:"/guide/first-page.html",icon:"M6 3.5h8l4 4v13H6z M14 3.5v4h4 M9 12h6 M9 16h6"},{title:"组件与 Hooks",summary:"查找表单、弹窗和常用组合式函数。",href:"/reference/components.html",icon:"M3.5 3.5h7v7h-7z M13.5 3.5h7v7h-7z M3.5 13.5h7v7h-7z M13.5 13.5h7v7h-7z"},{title:"构建与部署",summary:"检查项目并部署到站点子路径。",href:"/guide/tooling.html",icon:"M4 8.5h16v11H4z M4 8.5l3-4h10l3 4 M12 16v-4 M10 14l2-2 2 2"}];return(F,t)=>(i(),o("main",g,[e("header",b,[e("div",null,[t[0]||(t[0]=e("h1",null,"Ray Template",-1)),e("p",M," v"+l(s(f))+" 将 Ray Admin、官网文档和共享包放在同一个工作区。可在文档里直接体验真实组件。 ",1),e("div",w,[e("a",{class:"ray-start",href:s(r)("/guide/start.html")},"快速开始",8,k),e("a",{class:"ray-migrate",href:s(r)("/migration.html")},"v5 与 v6 的版本分界",8,T)])]),e("section",x,[t[1]||(t[1]=p('v6 工作区
',2)),e("ul",null,[(i(),o(d,null,_(n,a=>e("li",{key:a.href},[e("a",{href:s(r)(a.href)},[e("span",null,l(a.title),1),e("code",null,l(a.name),1)],8,B)])),64))])])]),e("section",z,[t[3]||(t[3]=e("h2",{id:"ray-paths-title"},"常用文档",-1)),e("ul",null,[(i(),o(d,null,_(c,(a,h)=>e("li",{key:a.href},[e("a",{class:"ray-path",href:s(r)(a.href),"aria-labelledby":`ray-path-title-${h}`,"aria-describedby":`ray-path-summary-${h}`},[e("article",null,[(i(),o("svg",S,[e("path",{d:a.icon},null,8,A)])),e("h3",{id:`ray-path-title-${h}`},l(a.title),9,N),e("p",{id:`ray-path-summary-${h}`},l(a.summary),9,R),t[2]||(t[2]=e("svg",{class:"ray-path-arrow",viewBox:"0 0 24 24","aria-hidden":"true"},[e("path",{d:"M5 12h13m-5-5 5 5-5 5"})],-1))])],8,P)])),64))])]),e("section",V,[e("div",null,[t[4]||(t[4]=e("h2",{id:"ray-showcase-title"},"TablePro 自适应高度",-1)),t[5]||(t[5]=e("p",null,"表格填满可用高度,数据在表内滚动。",-1)),e("div",$,[e("a",{href:s(r)("/reference/table-pro.html")},"TablePro 用法",8,C),e("a",{href:s(v)+"#/tables/auto-height"},"在线演示",8,H)])]),e("img",{src:s(r)("/assets/tablepro-auto-height.png"),width:"1440",height:"820",loading:"lazy",alt:"TablePro 自适应高度示例,虚拟滚动已开启,分页位于表格底部"},null,8,D)])]))}}),O=JSON.parse('{"title":"开发者文档","description":"","frontmatter":{"title":"开发者文档","layout":"home","markdownStyles":false},"headers":[],"relativePath":"index.md","filePath":"index.md"}'),j={name:"index.md"},J=Object.assign(j,{setup(m){return(n,c)=>(i(),o("div",null,[u(E)]))}});export{O as __pageData,J as default};
diff --git a/docs/assets/index.md.nUYT09g4.lean.js b/docs/assets/index.md.nUYT09g4.lean.js
new file mode 100644
index 00000000..117604a2
--- /dev/null
+++ b/docs/assets/index.md.nUYT09g4.lean.js
@@ -0,0 +1 @@
+import{d as y,o as i,c as o,j as e,t as l,k as s,g as r,a3 as p,F as d,B as _,E as u}from"./chunks/framework.BNdm2jZV.js";import{v as f,d as v}from"./chunks/theme.C9yy6i4V.js";const g={class:"ray-home"},b={class:"ray-hero"},M={class:"ray-lead"},w={class:"ray-actions"},k=["href"],T=["href"],x={class:"ray-map","aria-labelledby":"ray-map-title"},B=["href"],z={class:"ray-paths","aria-labelledby":"ray-paths-title"},P=["href","aria-labelledby","aria-describedby"],S={class:"ray-path-icon",viewBox:"0 0 24 24","aria-hidden":"true"},A=["d"],N=["id"],R=["id"],V={class:"ray-showcase","aria-labelledby":"ray-showcase-title"},$={class:"ray-showcase-links"},C=["href"],H=["href"],D=["src"],E=y({__name:"RayHome",setup(m){const n=[{title:"Ray Admin",name:"apps/admin",href:"/guide/layout.html"},{title:"共享包",name:"packages",href:"/guide/architecture.html"},{title:"页内交互",name:"apps/docs",href:"/reference/table-pro.html"}],c=[{title:"第一个业务页面",summary:"添加订单列表、路由和菜单。",href:"/guide/first-page.html",icon:"M6 3.5h8l4 4v13H6z M14 3.5v4h4 M9 12h6 M9 16h6"},{title:"组件与 Hooks",summary:"查找表单、弹窗和常用组合式函数。",href:"/reference/components.html",icon:"M3.5 3.5h7v7h-7z M13.5 3.5h7v7h-7z M3.5 13.5h7v7h-7z M13.5 13.5h7v7h-7z"},{title:"构建与部署",summary:"检查项目并部署到站点子路径。",href:"/guide/tooling.html",icon:"M4 8.5h16v11H4z M4 8.5l3-4h10l3 4 M12 16v-4 M10 14l2-2 2 2"}];return(F,t)=>(i(),o("main",g,[e("header",b,[e("div",null,[t[0]||(t[0]=e("h1",null,"Ray Template",-1)),e("p",M," v"+l(s(f))+" 将 Ray Admin、官网文档和共享包放在同一个工作区。可在文档里直接体验真实组件。 ",1),e("div",w,[e("a",{class:"ray-start",href:s(r)("/guide/start.html")},"快速开始",8,k),e("a",{class:"ray-migrate",href:s(r)("/migration.html")},"v5 与 v6 的版本分界",8,T)])]),e("section",x,[t[1]||(t[1]=p("",2)),e("ul",null,[(i(),o(d,null,_(n,a=>e("li",{key:a.href},[e("a",{href:s(r)(a.href)},[e("span",null,l(a.title),1),e("code",null,l(a.name),1)],8,B)])),64))])])]),e("section",z,[t[3]||(t[3]=e("h2",{id:"ray-paths-title"},"常用文档",-1)),e("ul",null,[(i(),o(d,null,_(c,(a,h)=>e("li",{key:a.href},[e("a",{class:"ray-path",href:s(r)(a.href),"aria-labelledby":`ray-path-title-${h}`,"aria-describedby":`ray-path-summary-${h}`},[e("article",null,[(i(),o("svg",S,[e("path",{d:a.icon},null,8,A)])),e("h3",{id:`ray-path-title-${h}`},l(a.title),9,N),e("p",{id:`ray-path-summary-${h}`},l(a.summary),9,R),t[2]||(t[2]=e("svg",{class:"ray-path-arrow",viewBox:"0 0 24 24","aria-hidden":"true"},[e("path",{d:"M5 12h13m-5-5 5 5-5 5"})],-1))])],8,P)])),64))])]),e("section",V,[e("div",null,[t[4]||(t[4]=e("h2",{id:"ray-showcase-title"},"TablePro 自适应高度",-1)),t[5]||(t[5]=e("p",null,"表格填满可用高度,数据在表内滚动。",-1)),e("div",$,[e("a",{href:s(r)("/reference/table-pro.html")},"TablePro 用法",8,C),e("a",{href:s(v)+"#/tables/auto-height"},"在线演示",8,H)])]),e("img",{src:s(r)("/assets/tablepro-auto-height.png"),width:"1440",height:"820",loading:"lazy",alt:"TablePro 自适应高度示例,虚拟滚动已开启,分页位于表格底部"},null,8,D)])]))}}),O=JSON.parse('{"title":"开发者文档","description":"","frontmatter":{"title":"开发者文档","layout":"home","markdownStyles":false},"headers":[],"relativePath":"index.md","filePath":"index.md"}'),j={name:"index.md"},J=Object.assign(j,{setup(m){return(n,c)=>(i(),o("div",null,[u(E)]))}});export{O as __pageData,J as default};
diff --git a/docs/assets/inter-italic-cyrillic-ext.r48I6akx.woff2 b/docs/assets/inter-italic-cyrillic-ext.r48I6akx.woff2
new file mode 100644
index 00000000..b6b603d5
Binary files /dev/null and b/docs/assets/inter-italic-cyrillic-ext.r48I6akx.woff2 differ
diff --git a/docs/assets/inter-italic-cyrillic.By2_1cv3.woff2 b/docs/assets/inter-italic-cyrillic.By2_1cv3.woff2
new file mode 100644
index 00000000..def40a4f
Binary files /dev/null and b/docs/assets/inter-italic-cyrillic.By2_1cv3.woff2 differ
diff --git a/docs/assets/inter-italic-greek-ext.1u6EdAuj.woff2 b/docs/assets/inter-italic-greek-ext.1u6EdAuj.woff2
new file mode 100644
index 00000000..e070c3d3
Binary files /dev/null and b/docs/assets/inter-italic-greek-ext.1u6EdAuj.woff2 differ
diff --git a/docs/assets/inter-italic-greek.DJ8dCoTZ.woff2 b/docs/assets/inter-italic-greek.DJ8dCoTZ.woff2
new file mode 100644
index 00000000..a3c16ca4
Binary files /dev/null and b/docs/assets/inter-italic-greek.DJ8dCoTZ.woff2 differ
diff --git a/docs/assets/inter-italic-latin-ext.CN1xVJS-.woff2 b/docs/assets/inter-italic-latin-ext.CN1xVJS-.woff2
new file mode 100644
index 00000000..2210a899
Binary files /dev/null and b/docs/assets/inter-italic-latin-ext.CN1xVJS-.woff2 differ
diff --git a/docs/assets/inter-italic-latin.C2AdPX0b.woff2 b/docs/assets/inter-italic-latin.C2AdPX0b.woff2
new file mode 100644
index 00000000..790d62dc
Binary files /dev/null and b/docs/assets/inter-italic-latin.C2AdPX0b.woff2 differ
diff --git a/docs/assets/inter-italic-vietnamese.BSbpV94h.woff2 b/docs/assets/inter-italic-vietnamese.BSbpV94h.woff2
new file mode 100644
index 00000000..1eec0775
Binary files /dev/null and b/docs/assets/inter-italic-vietnamese.BSbpV94h.woff2 differ
diff --git a/docs/assets/inter-roman-cyrillic-ext.BBPuwvHQ.woff2 b/docs/assets/inter-roman-cyrillic-ext.BBPuwvHQ.woff2
new file mode 100644
index 00000000..2cfe6153
Binary files /dev/null and b/docs/assets/inter-roman-cyrillic-ext.BBPuwvHQ.woff2 differ
diff --git a/docs/assets/inter-roman-cyrillic.C5lxZ8CY.woff2 b/docs/assets/inter-roman-cyrillic.C5lxZ8CY.woff2
new file mode 100644
index 00000000..e3886dd1
Binary files /dev/null and b/docs/assets/inter-roman-cyrillic.C5lxZ8CY.woff2 differ
diff --git a/docs/assets/inter-roman-greek-ext.CqjqNYQ-.woff2 b/docs/assets/inter-roman-greek-ext.CqjqNYQ-.woff2
new file mode 100644
index 00000000..36d67487
Binary files /dev/null and b/docs/assets/inter-roman-greek-ext.CqjqNYQ-.woff2 differ
diff --git a/docs/assets/inter-roman-greek.BBVDIX6e.woff2 b/docs/assets/inter-roman-greek.BBVDIX6e.woff2
new file mode 100644
index 00000000..2bed1e85
Binary files /dev/null and b/docs/assets/inter-roman-greek.BBVDIX6e.woff2 differ
diff --git a/docs/assets/inter-roman-latin-ext.4ZJIpNVo.woff2 b/docs/assets/inter-roman-latin-ext.4ZJIpNVo.woff2
new file mode 100644
index 00000000..9a8d1e2b
Binary files /dev/null and b/docs/assets/inter-roman-latin-ext.4ZJIpNVo.woff2 differ
diff --git a/docs/assets/inter-roman-latin.Di8DUHzh.woff2 b/docs/assets/inter-roman-latin.Di8DUHzh.woff2
new file mode 100644
index 00000000..07d3c53a
Binary files /dev/null and b/docs/assets/inter-roman-latin.Di8DUHzh.woff2 differ
diff --git a/docs/assets/inter-roman-vietnamese.BjW4sHH5.woff2 b/docs/assets/inter-roman-vietnamese.BjW4sHH5.woff2
new file mode 100644
index 00000000..57bdc22a
Binary files /dev/null and b/docs/assets/inter-roman-vietnamese.BjW4sHH5.woff2 differ
diff --git a/docs/assets/menu.webp b/docs/assets/menu.webp
new file mode 100644
index 00000000..93649082
Binary files /dev/null and b/docs/assets/menu.webp differ
diff --git a/docs/assets/migration.md.CIZms3hv.js b/docs/assets/migration.md.CIZms3hv.js
new file mode 100644
index 00000000..d4ec58b1
--- /dev/null
+++ b/docs/assets/migration.md.CIZms3hv.js
@@ -0,0 +1 @@
+import{_ as t,o as a,c as d,a3 as o}from"./chunks/framework.BNdm2jZV.js";const m=JSON.parse('{"title":"v5 与 v6 的版本分界","description":"","frontmatter":{},"headers":[],"relativePath":"migration.md","filePath":"migration.md"}'),r={name:"migration.md"};function c(i,e,l,n,s,h){return a(),d("div",null,[...e[0]||(e[0]=[o('v5 与 v6 的版本分界
Ray Template 6.0.0 是新的主版本,与 v5 分线。 v6 以 Monorepo 重新组织后台、官网文档和共享包,不提供 v5 的原地升级,也不承诺兼容 v5 的内部路径、接口、配置或本地数据。v5 项目可以继续使用原版本。
v6 的变更
| 领域 | v6 的入口与约定 |
|---|
| 应用结构 | 原来根目录的 src/、mock/、public/、应用环境文件和 index.html 归入 apps/admin/。环境变量、容器配置和构建脚本应按 v6 入口重新核对。 |
| 组件与工具 | 从各包的公开入口导入共享能力,例如 @ray-template/ui/table-pro、@ray-template/composables/useDevice 和 @ray-template/utils/precision。Ray Admin 内部的 @/ 指向自己的 src/。 |
| 组件接入 | v6 的 TablePro 统一使用 RTablePro,可传 data 或 request(params, signal)。按现行 API 接入搜索、分页、列设置、CSV 和打印。 |
| 路由、权限与请求 | 路由校验、请求客户端和布局由共享包提供。Ray Admin 在应用侧提供页面注册表、会话和鉴权、请求头、主题和语言。 |
| 文档与演示 | VitePress 位于 apps/docs/,通过公共包运行示例。官方发布中后台位于 /ray-template/,v6 文档位于 /ray-template/docs/。 |
现有项目采用 v6
- 从新的工作区或分支起步,保留现有 v5 代码与部署的回退入口。重新配置依赖、环境变量、接口地址和 CI。
- 按业务逐项迁入页面、接口及菜单配置,以 v6 的页面示例、路由约定和 TablePro API为准。旧的深层导入、路由 JSON 和自定义拦截器需要逐项检查。
- 使用独立浏览器配置或部署源验证 v6。
localStorage 按站点源隔离,放在同域不同路径不足以隔离 v5 和 v6 的会话与偏好。旧的设置、锁屏、缓存和登录状态没有通用迁移流程。 - 验证登录、权限、路由直达、接口、缓存和部署路径,再切换业务入口。运行
pnpm harness verify,需要组合部署时用 pnpm pages:build。工程检查与部署
',7)])])}const p=t(r,[["render",c]]);export{m as __pageData,p as default};
diff --git a/docs/assets/migration.md.CIZms3hv.lean.js b/docs/assets/migration.md.CIZms3hv.lean.js
new file mode 100644
index 00000000..4a15c5b7
--- /dev/null
+++ b/docs/assets/migration.md.CIZms3hv.lean.js
@@ -0,0 +1 @@
+import{_ as t,o as a,c as d,a3 as o}from"./chunks/framework.BNdm2jZV.js";const m=JSON.parse('{"title":"v5 与 v6 的版本分界","description":"","frontmatter":{},"headers":[],"relativePath":"migration.md","filePath":"migration.md"}'),r={name:"migration.md"};function c(i,e,l,n,s,h){return a(),d("div",null,[...e[0]||(e[0]=[o("",7)])])}const p=t(r,[["render",c]]);export{m as __pageData,p as default};
diff --git a/docs/assets/playground_shell.md.CH48frZN.js b/docs/assets/playground_shell.md.CH48frZN.js
new file mode 100644
index 00000000..2e0cb894
--- /dev/null
+++ b/docs/assets/playground_shell.md.CH48frZN.js
@@ -0,0 +1,2 @@
+const __vite__mapDeps=(i,m=__vite__mapDeps,d=(m.f||(m.f=["assets/chunks/ShellDemo.VK1xIRwa.js","assets/chunks/Icon.DgnQbY0f.js","assets/chunks/Loading.CYk0ZDH9.js","assets/chunks/framework.BNdm2jZV.js","assets/chunks/Button.B5dXaugh.js","assets/chunks/call.Cml8M0xk.js","assets/chunks/isSymbol.BJY0fdHu.js","assets/chunks/index.CRUCD9CF.js","assets/chunks/manifest.BPHdGMSY.js"])))=>i.map(i=>d[i]);
+import{o as a,c as t,E as l,k as o,a7 as r,V as s}from"./chunks/framework.BNdm2jZV.js";const p=JSON.parse('{"title":"","description":"","frontmatter":{"layout":"page","navbar":false,"sidebar":false,"footer":false},"headers":[],"relativePath":"playground/shell.md","filePath":"playground/shell.md"}'),n={name:"playground/shell.md"},f=Object.assign(n,{setup(_){const e=r(()=>s(()=>import("./chunks/ShellDemo.VK1xIRwa.js"),__vite__mapDeps([0,1,2,3,4,5,6,7,8])));return(d,c)=>(a(),t("div",null,[l(o(e))]))}});export{p as __pageData,f as default};
diff --git a/docs/assets/playground_shell.md.CH48frZN.lean.js b/docs/assets/playground_shell.md.CH48frZN.lean.js
new file mode 100644
index 00000000..2e0cb894
--- /dev/null
+++ b/docs/assets/playground_shell.md.CH48frZN.lean.js
@@ -0,0 +1,2 @@
+const __vite__mapDeps=(i,m=__vite__mapDeps,d=(m.f||(m.f=["assets/chunks/ShellDemo.VK1xIRwa.js","assets/chunks/Icon.DgnQbY0f.js","assets/chunks/Loading.CYk0ZDH9.js","assets/chunks/framework.BNdm2jZV.js","assets/chunks/Button.B5dXaugh.js","assets/chunks/call.Cml8M0xk.js","assets/chunks/isSymbol.BJY0fdHu.js","assets/chunks/index.CRUCD9CF.js","assets/chunks/manifest.BPHdGMSY.js"])))=>i.map(i=>d[i]);
+import{o as a,c as t,E as l,k as o,a7 as r,V as s}from"./chunks/framework.BNdm2jZV.js";const p=JSON.parse('{"title":"","description":"","frontmatter":{"layout":"page","navbar":false,"sidebar":false,"footer":false},"headers":[],"relativePath":"playground/shell.md","filePath":"playground/shell.md"}'),n={name:"playground/shell.md"},f=Object.assign(n,{setup(_){const e=r(()=>s(()=>import("./chunks/ShellDemo.VK1xIRwa.js"),__vite__mapDeps([0,1,2,3,4,5,6,7,8])));return(d,c)=>(a(),t("div",null,[l(o(e))]))}});export{p as __pageData,f as default};
diff --git a/docs/assets/reference_components.md.iMZjSjdU.js b/docs/assets/reference_components.md.iMZjSjdU.js
new file mode 100644
index 00000000..0b5fc6e7
--- /dev/null
+++ b/docs/assets/reference_components.md.iMZjSjdU.js
@@ -0,0 +1 @@
+import{_ as e,o,c as d,a3 as r}from"./chunks/framework.BNdm2jZV.js";const i=JSON.parse('{"title":"组件","description":"","frontmatter":{},"headers":[],"relativePath":"reference/components.md","filePath":"reference/components.md"}'),a={name:"reference/components.md"};function c(n,t,p,s,m,l){return o(),d("div",null,[...t[0]||(t[0]=[r('组件
通用组件从 @ray-template/ui 导入,也可用 /table-pro、/barcode 等子路径按需加载。Ray Admin 内可以使用 @/components。路由过渡位于 @ray-template/admin-shell,由应用接入当前路由和缓存状态。许多组件包装 Naive UI:本文列出模板添加、改写或消费的属性、插槽和事件,原始控件的其余能力以锁定依赖的类型为准。
应用组件与 Provider 使用模板的状态、主题或路由,按文件导入。二维码 使用 vue3-next-qrcode,不属于 @/components 的导出。
组件实现、样式和类型放在同一个组件目录。组件属性对象也有具名导出,例如 formProps、modalProps、chartProps;业务代码通常直接使用组件和公开 Props 类型。TablePro 统一使用组件 ref 获取实例,RForm、RChart、RFlow 使用各自的 onRegister 契约。
公开导出 · 组件约定 · 示例源码
',6)])])}const f=e(a,[["render",c]]);export{i as __pageData,f as default};
diff --git a/docs/assets/reference_components.md.iMZjSjdU.lean.js b/docs/assets/reference_components.md.iMZjSjdU.lean.js
new file mode 100644
index 00000000..e8154d12
--- /dev/null
+++ b/docs/assets/reference_components.md.iMZjSjdU.lean.js
@@ -0,0 +1 @@
+import{_ as e,o,c as d,a3 as r}from"./chunks/framework.BNdm2jZV.js";const i=JSON.parse('{"title":"组件","description":"","frontmatter":{},"headers":[],"relativePath":"reference/components.md","filePath":"reference/components.md"}'),a={name:"reference/components.md"};function c(n,t,p,s,m,l){return o(),d("div",null,[...t[0]||(t[0]=[r("",6)])])}const f=e(a,[["render",c]]);export{i as __pageData,f as default};
diff --git a/docs/assets/reference_components_app.md.Q6aQiDRo.js b/docs/assets/reference_components_app.md.Q6aQiDRo.js
new file mode 100644
index 00000000..2edc53dd
--- /dev/null
+++ b/docs/assets/reference_components_app.md.Q6aQiDRo.js
@@ -0,0 +1,10 @@
+import{_ as s,o as a,c as e,a3 as t}from"./chunks/framework.BNdm2jZV.js";const c=JSON.parse('{"title":"应用组件与 Provider","description":"","frontmatter":{},"headers":[],"relativePath":"reference/components/app.md","filePath":"reference/components/app.md"}'),d={name:"reference/components/app.md"};function p(n,i,r,h,o,l){return a(),e("div",null,[...i[0]||(i[0]=[t(`应用组件与 Provider
这些组件按文件默认导入,例如 import AppPageHeader from '@/app-components/app/AppPageHeader'。它们依赖应用 Store、路由或 DOM,按默认 App 挂载顺序集成。
页面组件
| 组件 | 配置和注意事项 |
|---|
AppPageHeader | title 必填,description 默认空,eyebrow 默认 RAY TEMPLATE。默认插槽是右侧操作区,页面内容放在组件之外。 |
AppShareLink | variant: 'compact' | 'cards',默认 compact,从 dashboard 语言包读文案。链接由组件内配置,不接收任意链接列表。 |
AppAvatar | 从 Signing Store 读头像与名字。avatarSize、spaceSize 默认 medium,vertical 默认 false;头像使用圆形、cover,空头像用名称首字。src 和 size 会被内部读取的值覆盖。 |
AppGlobalSpin | 接收 NSpin 属性与插槽。显隐以 Runtime Store 的 globalSpinning 为准,传入 show 会被覆盖;和布局内容区 Spin 独立。 |
AppLockScreen | 由 setting.lockScreenSwitch 控制锁屏设置弹窗,不允许点遮罩或 Esc 关闭。锁定后由布局读取 Lock Screen Store 呈现解锁界面。 |
tsximport AppPageHeader from '@/app-components/app/AppPageHeader'
+import { NButton } from 'naive-ui'
+
+export const renderOrdersHeader = (create: () => void) => (
+ <AppPageHeader eyebrow="库存" title="订单" description="查看和维护销售订单">
+ <NButton type="primary" onClick={create}>
+ 新建订单
+ </NButton>
+ </AppPageHeader>
+)
Provider
| Provider | 职责与调用时机 |
|---|
AppNaiveGlobalProvider | 包裹默认插槽并同步明暗、主题覆盖、UI locale 和日期 locale。提供 Message、Dialog、Modal、Notification、LoadingBar 等上下文,并建立 window.$message、$dialog、$notification、$loadingBar。离散 API 在 Provider 初始化后可用,卸载时释放;不要在模块顶层提前调用。 |
AppStyleProvider | 同步 HTML 明暗类、CSS 主色和窗口尺寸变量,结束首屏加载动画。应用主题应通过设置方法更新。 |
AppVersionProvider | 启动时比较构建版本与本地版本。第一次写入缓存,变化时提示,确认会走退出并刷新;取消关闭提示。 |
AppWatermarkProvider | 按设置渲染全屏 Naive UI 水印;独立页面如需局部水印可自行在目标区域使用 NWatermark。 |
AppRequestCancelerProvider | 默认布局内容的路由更新钩子会取消模板管理的请求。替换内容插槽时,根据实际导航方式保留取消行为。 |
应用组件说明 · 布局配置 · Store · 请求取消
`,8)])])}const g=s(d,[["render",p]]);export{c as __pageData,g as default};
diff --git a/docs/assets/reference_components_app.md.Q6aQiDRo.lean.js b/docs/assets/reference_components_app.md.Q6aQiDRo.lean.js
new file mode 100644
index 00000000..7075a5a0
--- /dev/null
+++ b/docs/assets/reference_components_app.md.Q6aQiDRo.lean.js
@@ -0,0 +1 @@
+import{_ as s,o as a,c as e,a3 as t}from"./chunks/framework.BNdm2jZV.js";const c=JSON.parse('{"title":"应用组件与 Provider","description":"","frontmatter":{},"headers":[],"relativePath":"reference/components/app.md","filePath":"reference/components/app.md"}'),d={name:"reference/components/app.md"};function p(n,i,r,h,o,l){return a(),e("div",null,[...i[0]||(i[0]=[t("",8)])])}const g=s(d,[["render",p]]);export{c as __pageData,g as default};
diff --git a/docs/assets/reference_components_barcode.md.BbJVFbEo.js b/docs/assets/reference_components_barcode.md.BbJVFbEo.js
new file mode 100644
index 00000000..90d8996e
--- /dev/null
+++ b/docs/assets/reference_components_barcode.md.BbJVFbEo.js
@@ -0,0 +1,105 @@
+const __vite__mapDeps=(i,m=__vite__mapDeps,d=(m.f||(m.f=["assets/chunks/RBarcodeDemo.B49kedD5.js","assets/chunks/framework.BNdm2jZV.js","assets/chunks/call.Cml8M0xk.js","assets/chunks/Loading.CYk0ZDH9.js","assets/chunks/index.CRUCD9CF.js","assets/chunks/commonjsHelpers.CqkleIqs.js"])))=>i.map(i=>d[i]);
+import{o as n,c as h,a3 as i,E as k,k as t,a7 as l,V as p}from"./chunks/framework.BNdm2jZV.js";const g=JSON.parse('{"title":"RBarcode","description":"","frontmatter":{},"headers":[],"relativePath":"reference/components/barcode.md","filePath":"reference/components/barcode.md"}'),E={name:"reference/components/barcode.md"},y=Object.assign(E,{setup(e){const a=l(()=>p(()=>import("./chunks/RBarcodeDemo.B49kedD5.js"),__vite__mapDeps([0,1,2,3,4,5])));return(d,s)=>(n(),h("div",null,[s[0]||(s[0]=i('RBarcode
RBarcode 使用 JsBarcode 将字符串绘成条码。二维码使用二维码组件。
交互示例
编辑文本或切换制式,观察条码和校验提示。示例直接加载模板的 RBarcode。
',4)),k(t(a)),s[1]||(s[1]=i(`查看示例源码
vue<template>
+ <div class="ray-demo" :lang="locale ?? 'zh-CN'">
+ <div class="ray-demo-fields">
+ <div>
+ <label :for="textId">{{ copy.text }}</label>
+ <input
+ :id="textId"
+ v-model="text"
+ maxlength="24"
+ :inputmode="format === 'EAN13' ? 'numeric' : 'text'"
+ :aria-describedby="hintId"
+ :aria-invalid="Boolean(text && failed)"
+ />
+ </div>
+ <fieldset>
+ <legend>{{ copy.format }}</legend>
+ <div class="ray-demo-options">
+ <label
+ v-for="item in formats"
+ :key="item"
+ :for="\`\${formatName}-\${item}\`"
+ >
+ <input
+ :id="\`\${formatName}-\${item}\`"
+ v-model="format"
+ type="radio"
+ :name="formatName"
+ :value="item"
+ />
+ {{ item }}
+ </label>
+ </div>
+ </fieldset>
+ </div>
+ <p :id="hintId" class="ray-demo-hint" aria-live="polite">
+ {{ !text ? copy.empty : failed ? copy.invalid : '' }}
+ {{ format === 'EAN13' ? copy.ean : '' }}
+ </p>
+ <div
+ v-if="text"
+ v-show="!failed"
+ class="ray-demo-barcode"
+ role="img"
+ :aria-label="\`\${format}: \${text}\`"
+ >
+ <RBarcode
+ :key="format"
+ :text="text"
+ :format="format"
+ :options="options"
+ barcodeRender="svg"
+ @success="failed = false"
+ @error="failed = true"
+ />
+ </div>
+ </div>
+</template>
+
+<script setup lang="ts">
+import { RBarcode } from '@ray-template/ui/barcode'
+import { computed, ref, useId } from 'vue'
+
+const props = defineProps<{ locale?: 'zh-CN' | 'en' }>()
+const copy = computed(() =>
+ props.locale === 'en'
+ ? {
+ text: 'Barcode text',
+ format: 'Format',
+ empty: 'Enter text to generate a barcode.',
+ invalid: 'This text is invalid for the selected format.',
+ ean: 'Try 590123412345: EAN-13 takes 12 digits or 13 with a valid check digit.',
+ }
+ : {
+ text: '条码文本',
+ format: '条码制式',
+ empty: '输入文本后生成条码。',
+ invalid: '这段文本不符合当前制式。',
+ ean: '可试试 590123412345:EAN-13 接受 12 位数字,或附带正确校验位的 13 位数字。',
+ },
+)
+const textId = useId()
+const hintId = useId()
+const formatName = useId()
+const formats = ['CODE128', 'CODE39', 'EAN13'] as const
+const format = ref<(typeof formats)[number]>('CODE128')
+const text = ref('RAY-2026')
+const failed = ref(false)
+const options = {
+ width: 1.5,
+ height: 52,
+ background: '#fff',
+ lineColor: '#111',
+}
+</script>
用法
tsximport { RBarcode } from '@/components'
+
+export const renderOrderBarcode = (orderNo: string) => (
+ <RBarcode
+ text={orderNo}
+ format="CODE128"
+ barcodeRender="svg"
+ options={{ displayValue: true, height: 60 }}
+ onError={(error) => console.error('条码格式无效', error)}
+ />
+)
| 属性 | 默认 | 说明 |
|---|
text | 无 | 条码文本。留空或传入不符合格式的值时可能渲染失败。 |
format | 'CODE128' | 条码制式,覆盖 options.format。 |
barcodeRender | 'canvas' | canvas 或 svg。 |
options | {} | JsBarcode options,如 displayValue、lineColor、margin、条宽和条高。 |
width / height | 'auto' | 显示尺寸,数字按像素。与 options 中条码自身的条宽、条高不同。 |
responsive | false | 监听容器尺寸;用 width="responsive" 或 height="responsive" 让对应尺寸随容器调整。 |
watchText | true | 文本变化时重绘。独立改变 format、options 或渲染介质时不要依赖文本 watcher,可以按配置更换组件 key。 |
loading | false | 控制 Spin;调用方负责开关。 |
onSuccess(text, format, options)、onError(error)、onFinally() 支持函数或回调数组。成功回调收到原始 options;组件响应式调整的条宽和条高不写回该对象。绘制异常通过 onError 通知,业务代码可据此提示或清理旧预览。
支持 CODE39、CODE128 及 A/B/C 变体、EAN13/EAN8/EAN5/EAN2、UPC、ITF14/ITF、MSI/MSI10/MSI11/MSI1010/MSI1110、pharmacode、codabar。使用 EAN 或 UPC 前验证输入长度和校验位。打印后是否可扫取决于设备和成品尺寸。
组件实现 · 制式和选项类型
`,7))]))}});export{g as __pageData,y as default};
diff --git a/docs/assets/reference_components_barcode.md.BbJVFbEo.lean.js b/docs/assets/reference_components_barcode.md.BbJVFbEo.lean.js
new file mode 100644
index 00000000..37786c4c
--- /dev/null
+++ b/docs/assets/reference_components_barcode.md.BbJVFbEo.lean.js
@@ -0,0 +1,2 @@
+const __vite__mapDeps=(i,m=__vite__mapDeps,d=(m.f||(m.f=["assets/chunks/RBarcodeDemo.B49kedD5.js","assets/chunks/framework.BNdm2jZV.js","assets/chunks/call.Cml8M0xk.js","assets/chunks/Loading.CYk0ZDH9.js","assets/chunks/index.CRUCD9CF.js","assets/chunks/commonjsHelpers.CqkleIqs.js"])))=>i.map(i=>d[i]);
+import{o as n,c as h,a3 as i,E as k,k as t,a7 as l,V as p}from"./chunks/framework.BNdm2jZV.js";const g=JSON.parse('{"title":"RBarcode","description":"","frontmatter":{},"headers":[],"relativePath":"reference/components/barcode.md","filePath":"reference/components/barcode.md"}'),E={name:"reference/components/barcode.md"},y=Object.assign(E,{setup(e){const a=l(()=>p(()=>import("./chunks/RBarcodeDemo.B49kedD5.js"),__vite__mapDeps([0,1,2,3,4,5])));return(d,s)=>(n(),h("div",null,[s[0]||(s[0]=i("",4)),k(t(a)),s[1]||(s[1]=i("",7))]))}});export{g as __pageData,y as default};
diff --git a/docs/assets/reference_components_chart.md.JthpvMcl.js b/docs/assets/reference_components_chart.md.JthpvMcl.js
new file mode 100644
index 00000000..f565ce45
--- /dev/null
+++ b/docs/assets/reference_components_chart.md.JthpvMcl.js
@@ -0,0 +1,21 @@
+import{_ as i,o as e,c as t,a3 as a}from"./chunks/framework.BNdm2jZV.js";const k=JSON.parse('{"title":"RChart 与 useChart","description":"","frontmatter":{},"headers":[],"relativePath":"reference/components/chart.md","filePath":"reference/components/chart.md"}'),d={name:"reference/components/chart.md"};function n(h,s,r,o,p,l){return e(),t("div",null,[...s[0]||(s[0]=[a(`RChart 与 useChart
RChart 接收 ECharts options,负责创建实例、更新主题、监听尺寸与清理。需要确定的容器高度;height="100%" 依赖父元素的高度。图表数据和 series 配置由页面管理。
tsximport { RChart, useChart } from '@/components'
+import { defineComponent } from 'vue'
+
+export default defineComponent({
+ setup() {
+ const [register] = useChart()
+ return () => (
+ <RChart
+ onRegister={register}
+ preset="card"
+ title="周订单量"
+ height={300}
+ options={{
+ xAxis: { type: 'category', data: ['周一', '周二', '周三'] },
+ yAxis: { type: 'value' },
+ series: [{ type: 'bar', data: [12, 19, 14] }],
+ }}
+ />
+ )
+ },
+})
渲染、主题与更新
| 属性 | 默认 | 说明 |
|---|
options | {} | ECharts 配置。showAria 默认 false,模板会写入 aria.enabled 和 aria.decal.show。 |
width / height | '100%' | CSS 尺寸,数字按像素。 |
use | [] | 额外 ECharts 注册项。内置柱、线、饼、K 线、散点、象形柱、Canvas,以及标题、提示、网格、数据集、图例等基础模块。 |
intersectionObserver | true | 进入观察范围后挂载图表;隐藏区域的实例可能尚不可用。 |
intersectionObserverTarget / intersectionOptions | 容器 / { threshold: 0.1 } | 自定义观察目标与参数。 |
autoResize / autoResizeObserverTarget | true / 外层容器 | 容器尺寸变化后节流 resize。 |
watchOptions / watchDeep | true / true | 是否订阅 options,是否深层观察。 |
watchOptionsThrottleWait | 500 | options 更新节流间隔(毫秒)。 |
nextTick | true | 初始化前等待 Vue 更新。 |
setChartOptions | { notMerge: true, lazyUpdate: true, silent: false, replaceMerge: [] } | ECharts setOption 的控制参数。 |
theme / autoChangeTheme | null / true | 默认用应用的 ECharts 主题及暗色变体。固定主题请传注册后的主题名。 |
loading / loadingOptions | false / 模板加载样式 | 是否显示 ECharts 加载层及参数。 |
Provider 指定主题时优先。当前实现中 theme="default" 在 autoChangeTheme=true 时会传内建 dark,设为 false 才使用空主题名;需要明确的渲染效果时建议传实际主题名。切换主题可能重建实例,持有实例引用的代码应重新读取或注册。
卡片预设和回调
preset="card" 使用 Naive UI Card,支持 title(字符串或渲染函数)、bordered(默认 true)、contentStyle。cardExtra 插槽可替换右上角。- 默认菜单含图片下载;
downloadOptions 接受 ECharts getDataURL 参数和可选 filename。传入 dropdownOptions 会替换菜单,选择项通过 onDropdownSelect(key, option) 通知。 onSuccess(instance)、onError()、onFinally() 对应初始化结果;错误仍可能向调用侧抛出。onRegister(instance, render, dispose) 在可用实例建立后调用。
useChart() 返回 [register, actions]。getChartInstance() 返回 { echartInst, render, dispose },注册前会抛错。isDisposed() 检查底层实例,dispose() 释放图表和监听,render() 调用组件挂载逻辑;已存在实例时不要用它替代更新 options 或 setOption。图表随组件卸载清理。
Props · 组件实现 · useChart
`,10)])])}const E=i(d,[["render",n]]);export{k as __pageData,E as default};
diff --git a/docs/assets/reference_components_chart.md.JthpvMcl.lean.js b/docs/assets/reference_components_chart.md.JthpvMcl.lean.js
new file mode 100644
index 00000000..7e96006e
--- /dev/null
+++ b/docs/assets/reference_components_chart.md.JthpvMcl.lean.js
@@ -0,0 +1 @@
+import{_ as i,o as e,c as t,a3 as a}from"./chunks/framework.BNdm2jZV.js";const k=JSON.parse('{"title":"RChart 与 useChart","description":"","frontmatter":{},"headers":[],"relativePath":"reference/components/chart.md","filePath":"reference/components/chart.md"}'),d={name:"reference/components/chart.md"};function n(h,s,r,o,p,l){return e(),t("div",null,[...s[0]||(s[0]=[a("",10)])])}const E=i(d,[["render",n]]);export{k as __pageData,E as default};
diff --git a/docs/assets/reference_components_collapse-grid.md._8SHiB6D.js b/docs/assets/reference_components_collapse-grid.md._8SHiB6D.js
new file mode 100644
index 00000000..e475d00c
--- /dev/null
+++ b/docs/assets/reference_components_collapse-grid.md._8SHiB6D.js
@@ -0,0 +1,34 @@
+import{_ as i,o as a,c as n,a3 as t}from"./chunks/framework.BNdm2jZV.js";const o=JSON.parse('{"title":"RCollapseGrid","description":"","frontmatter":{},"headers":[],"relativePath":"reference/components/collapse-grid.md","filePath":"reference/components/collapse-grid.md"}'),l={name:"reference/components/collapse-grid.md"};function p(e,s,h,k,d,r){return a(),n("div",null,[...s[0]||(s[0]=[t(`RCollapseGrid
适合有多个条件的搜索表单。底层用 NGrid 渲染,子项必须是 NGridItem。使用 cols、responsive、collapsedRows、xGap 和 yGap 配置网格;未指定间距或传 0 时当前实现回退到 12。
| 属性 | 默认 | 说明 |
|---|
open | false | 展开状态,true 表示展开,false 表示收起。 |
actionSpan | 1 | 操作区占用的网格列数。 |
actionAlign | 'end' | 操作区 CSS 对齐值,可用 auto、end、center、start。 |
collapseToggleText | ['展开', '收起'] | 两个位置依次对应收起时和展开时显示的按钮文案。 |
bordered | true | 外层卡片边框。 |
default 渲染筛选项,action 渲染查询按钮,collapse(collapsed) 可替换展开按钮。自定义折叠插槽只收到布尔值,需要自行绑定按钮并修改 open。
受控状态与更新事件
onUpdateOpen 和 onUpdate:open 回传的是内部 collapsed,与 open 相反。当前基线使用受控模式时手动取反,避免直接双向绑定把语义接反。两个监听器同时绑定会各调用一次。
tsximport { RCollapseGrid } from '@/components'
+import { NButton, NGridItem, NInput } from 'naive-ui'
+import { defineComponent, ref } from 'vue'
+
+export default defineComponent({
+ setup() {
+ const open = ref(false)
+ return () => (
+ <RCollapseGrid
+ open={open.value}
+ cols={3}
+ collapsedRows={1}
+ onUpdateOpen={(collapsed) => {
+ open.value = !collapsed
+ }}
+ >
+ {{
+ default: () => [
+ <NGridItem>
+ <NInput placeholder="订单号" />
+ </NGridItem>,
+ <NGridItem>
+ <NInput placeholder="客户" />
+ </NGridItem>,
+ <NGridItem>
+ <NInput placeholder="城市" />
+ </NGridItem>,
+ ],
+ action: () => <NButton type="primary">查询</NButton>,
+ }}
+ </RCollapseGrid>
+ )
+ },
+})
组件实现 · Props
`,7)])])}const c=i(l,[["render",p]]);export{o as __pageData,c as default};
diff --git a/docs/assets/reference_components_collapse-grid.md._8SHiB6D.lean.js b/docs/assets/reference_components_collapse-grid.md._8SHiB6D.lean.js
new file mode 100644
index 00000000..c77e11c7
--- /dev/null
+++ b/docs/assets/reference_components_collapse-grid.md._8SHiB6D.lean.js
@@ -0,0 +1 @@
+import{_ as i,o as a,c as n,a3 as t}from"./chunks/framework.BNdm2jZV.js";const o=JSON.parse('{"title":"RCollapseGrid","description":"","frontmatter":{},"headers":[],"relativePath":"reference/components/collapse-grid.md","filePath":"reference/components/collapse-grid.md"}'),l={name:"reference/components/collapse-grid.md"};function p(e,s,h,k,d,r){return a(),n("div",null,[...s[0]||(s[0]=[t("",7)])])}const c=i(l,[["render",p]]);export{o as __pageData,c as default};
diff --git a/docs/assets/reference_components_draggable-card.md.4XemeqwB.js b/docs/assets/reference_components_draggable-card.md.4XemeqwB.js
new file mode 100644
index 00000000..76e81e9e
--- /dev/null
+++ b/docs/assets/reference_components_draggable-card.md.4XemeqwB.js
@@ -0,0 +1,12 @@
+import{_ as a,o as t,c as i,a3 as e}from"./chunks/framework.BNdm2jZV.js";const c=JSON.parse('{"title":"RDraggableCard","description":"","frontmatter":{},"headers":[],"relativePath":"reference/components/draggable-card.md","filePath":"reference/components/draggable-card.md"}'),d={name:"reference/components/draggable-card.md"};function n(l,s,r,h,p,o){return t(),i("div",null,[...s[0]||(s[0]=[e(`RDraggableCard
基于 Naive UI Card 和 Interact.js。卡片 Teleport 到应用创建的容器,不参加原父节点的普通布局流。设置标题后可拖动卡片头部,否则拖动内容区;组件没有开放改变尺寸的交互。
| 属性 | 默认 | 说明 |
|---|
dad | true | 是否启用拖拽。 |
restrictionElement | 'body' | 拖动边界,支持 CSS 选择器、元素或可解包的目标;选择器取第一个匹配。 |
restrictRectOptions | 默认边界,endOnly: true | 覆盖 Interact.js 边界限制。 |
defaultPosition | { x: 0, y: 0 } | 相对限制容器的偏移,或预设位置。 |
padding | 无 | 初次定位时相对边界的 { x, y } 间距。 |
width / zIndex | 600 / 无 | 卡片宽度与层级。 |
animation | false | 启用进场过渡。 |
位置可用 top-left、top-right、bottom-left、bottom-right、center、top-center、bottom-center。替换 defaultPosition 引用会触发重定位;没有公开拖拽事件或位置持久化。选择器需要在布局中真实存在,容器应有明确尺寸。组件初始化会访问 document,仅在浏览器侧渲染。继承 Card 属性和插槽。
tsximport { RDraggableCard } from '@/components'
+
+export const renderFloatingHelp = () => (
+ <RDraggableCard
+ title="帮助"
+ width={320}
+ defaultPosition="bottom-right"
+ padding={{ x: 24, y: 24 }}
+ >
+ 拖动标题可移动此卡片
+ </RDraggableCard>
+)
组件源码
`,6)])])}const g=a(d,[["render",n]]);export{c as __pageData,g as default};
diff --git a/docs/assets/reference_components_draggable-card.md.4XemeqwB.lean.js b/docs/assets/reference_components_draggable-card.md.4XemeqwB.lean.js
new file mode 100644
index 00000000..5a93d25a
--- /dev/null
+++ b/docs/assets/reference_components_draggable-card.md.4XemeqwB.lean.js
@@ -0,0 +1 @@
+import{_ as a,o as t,c as i,a3 as e}from"./chunks/framework.BNdm2jZV.js";const c=JSON.parse('{"title":"RDraggableCard","description":"","frontmatter":{},"headers":[],"relativePath":"reference/components/draggable-card.md","filePath":"reference/components/draggable-card.md"}'),d={name:"reference/components/draggable-card.md"};function n(l,s,r,h,p,o){return t(),i("div",null,[...s[0]||(s[0]=[e("",6)])])}const g=a(d,[["render",n]]);export{c as __pageData,g as default};
diff --git a/docs/assets/reference_components_flow.md.s-rnj-8X.js b/docs/assets/reference_components_flow.md.s-rnj-8X.js
new file mode 100644
index 00000000..02fe3d2e
--- /dev/null
+++ b/docs/assets/reference_components_flow.md.s-rnj-8X.js
@@ -0,0 +1,28 @@
+import{_ as i,o as a,c as e,a3 as t}from"./chunks/framework.BNdm2jZV.js";const c=JSON.parse('{"title":"RFlow 与 useFlow","description":"","frontmatter":{},"headers":[],"relativePath":"reference/components/flow.md","filePath":"reference/components/flow.md"}'),n={name:"reference/components/flow.md"};function l(d,s,h,p,k,o){return a(),e("div",null,[...s[0]||(s[0]=[t(`RFlow 与 useFlow
RFlow 在自己的 DOM 容器中建立 LogicFlow。图数据用 FlowGraphData 表示,nodes 和 edges 为可选数组;NodeConfig、EdgeConfig 都要求稳定的 id,边的源和目标需指向存在的节点。
tsximport { RFlow } from '@/components'
+import type LogicFlow from '@logicflow/core'
+import { defineComponent } from 'vue'
+
+const graph = {
+ nodes: [
+ { id: 'start', type: 'rect', x: 100, y: 90, text: '发起' },
+ { id: 'review', type: 'rect', x: 300, y: 90, text: '审核' },
+ ],
+ edges: [
+ {
+ id: 'start-review',
+ type: 'polyline',
+ sourceNodeId: 'start',
+ targetNodeId: 'review',
+ },
+ ],
+} satisfies Parameters<LogicFlow['render']>[0]
+
+export default defineComponent({
+ setup: () => () => (
+ <RFlow
+ height={240}
+ readonly
+ onRegister={(instance) => instance.render(graph)}
+ />
+ ),
+})
| 属性 | 默认 | 说明 |
|---|
width / height | '100%' | 容器尺寸,需要可计算的高度。 |
data | 无 | 后续引用变化时重绘,嵌套原地修改不触发。当前挂载分支先渲染空图,首屏请在 onRegister 里主动渲染。 |
watchData | true | 是否监听传入数据。关闭后可从实例控制重绘。 |
readonly | false | 同步 LogicFlow 静默模式和节点、边文本编辑状态。 |
options | 网格开、partial: false、键盘开 | LogicFlow 初始化配置,包括尺寸、背景、键盘、边、交互、历史和插件等。container 由组件管理。 |
use | 无 | LogicFlow 全局插件列表,组件只在首次初始化时注册一次。需要实例级插件时检查 options.plugins。 |
onRegister(instance) | 无 | 挂载后取得 LogicFlow,支持回调数组。 |
FlowOptions 支持的字段按用途分组:
- 画布与布局:
width、height、background、grid、partial、style、overlapMode。 - 交互:
keyboard、adjustEdge、allowRotate、allowResize、isSilentMode、stopScrollGraph、stopZoomGraph、stopMoveGraph、textEdit、textMode、edgeTextMode、nodeTextMode、guards。 - 边和渲染:
edgeType、customTrajectory、animation、history、outline、snapline。 - 扩展:
plugins、pluginsOptions、disabledPlugins、disabledTools、idGenerator、edgeGenerator。
FlowGraphData 用于包装组件的 Props。直接调用底层 instance.render 时,使用 Parameters<LogicFlow['render']>[0] 保留 LogicFlow 所要求的节点类型、坐标和连线字段。
useFlow() 返回 [register, { getFlowInstance }]。若首屏要填图,可在同一 onRegister 回调里先调用 register(instance) 再 instance.render(graph)。注册之前调用 getFlowInstance() 会抛错。程序化编辑、导入和事件监听走 LogicFlow 实例;组件目前没有公开销毁方法或卸载时的显式实例清理,频繁重挂载或绑定自定义监听时,请由接入方处理对应资源释放。
组件实现 · 图和选项类型 · 实例 Hook
`,9)])])}const E=i(n,[["render",l]]);export{c as __pageData,E as default};
diff --git a/docs/assets/reference_components_flow.md.s-rnj-8X.lean.js b/docs/assets/reference_components_flow.md.s-rnj-8X.lean.js
new file mode 100644
index 00000000..c4ce3124
--- /dev/null
+++ b/docs/assets/reference_components_flow.md.s-rnj-8X.lean.js
@@ -0,0 +1 @@
+import{_ as i,o as a,c as e,a3 as t}from"./chunks/framework.BNdm2jZV.js";const c=JSON.parse('{"title":"RFlow 与 useFlow","description":"","frontmatter":{},"headers":[],"relativePath":"reference/components/flow.md","filePath":"reference/components/flow.md"}'),n={name:"reference/components/flow.md"};function l(d,s,h,p,k,o){return a(),e("div",null,[...s[0]||(s[0]=[t("",9)])])}const E=i(n,[["render",l]]);export{c as __pageData,E as default};
diff --git a/docs/assets/reference_components_form.md.BrB2cmbN.js b/docs/assets/reference_components_form.md.BrB2cmbN.js
new file mode 100644
index 00000000..874b5e53
--- /dev/null
+++ b/docs/assets/reference_components_form.md.BrB2cmbN.js
@@ -0,0 +1,42 @@
+import{_ as i,o as a,c as t,a3 as n}from"./chunks/framework.BNdm2jZV.js";const o=JSON.parse('{"title":"RForm 与 useForm","description":"","frontmatter":{},"headers":[],"relativePath":"reference/components/form.md","filePath":"reference/components/form.md"}'),e={name:"reference/components/form.md"};function h(l,s,k,p,d,r){return a(),t("div",null,[...s[0]||(s[0]=[n(`RForm 包装 Naive UI Form,并用 Spin 显示提交或查询状态。用 NFormItem.path 匹配 model 的字段,在输入组件上更新值。
tsximport { RForm, useForm } from '@/components'
+import { NButton, NFormItem, NInput } from 'naive-ui'
+import { defineComponent } from 'vue'
+
+export default defineComponent({
+ setup() {
+ const [register, form] = useForm(
+ { name: '' },
+ {
+ name: {
+ key: 'name',
+ required: true,
+ message: '请输入姓名',
+ trigger: 'blur',
+ },
+ },
+ )
+ const rules = form.formRules()
+ const submit = async () => {
+ await form.validate()
+ console.log(form.formConditionRef.value.name)
+ }
+ return () => (
+ <RForm
+ onRegister={register}
+ model={form.formConditionRef.value}
+ rules={rules}
+ >
+ <NFormItem label="姓名" path="name">
+ <NInput
+ value={form.formConditionRef.value.name}
+ onUpdateValue={(name) => form.updateFormCondition({ name })}
+ />
+ </NFormItem>
+ <NButton onClick={() => void submit().catch(() => {})}>
+ 校验并提交
+ </NButton>
+ <NButton onClick={() => form.reset()}>重置</NButton>
+ </RForm>
+ )
+ },
+})
属性与事件
除 onSubmit 外,继承 NForm 的公开属性。默认插槽传给 NForm。
| 属性 | 默认 | 说明 |
|---|
loading | false | 外层 Spin 状态,由调用方开关。 |
loadingDescription | 无 | 加载说明。 |
autocomplete | 'off' | 挂载时写到表单 DOM。 |
submitWhenEnter | false | 创建时启用 Enter 捕获,阻止默认行为,校验成功后调用 onFinish。 |
onFinish | 无 | Enter 校验完成回调。自定义提交按钮要自行调用 validate() 并执行提交。 |
onRegister(inst) | 无 | 挂载后传出 Naive UI Form 实例。接受单函数或回调数组。 |
含多行输入、搜索选择器或嵌套表单时,先确认 Enter 是否应被捕获。组件没有把 Form 方法直接暴露为模板 ref。
useForm(model?, rules?) 返回 [register, actions],把 register 绑定给 onRegister。初始化值和规则可用对象或工厂;对象会深拷贝,工厂结果直接使用,建议每次创建新对象。
| 返回项 | 行为 |
|---|
formConditionRef | 响应式模型,传给 RForm.model 并用于输入绑定。 |
formModel() / formRules() | 重新取得初始模型和规则。 |
getFormInstance() | 获取已注册实例,未注册时抛错。 |
validate(callback?, shouldRuleBeApplied?) | 透传 Naive UI 校验;失败要处理 Promise 拒绝。 |
validateTargetField(key) | 按规则对象的唯一 key 筛选规则,key 不等同于 NFormItem.path。 |
restoreValidation() | 清除当前校验状态,保留输入。 |
updateFormCondition(values) | 浅合并当前模型,不改初始值。 |
reset(values?) | 合并初始值和覆盖值,然后清除校验。动态新增字段不会被自动删除。 |
实例相关方法要在表单挂载并注册后调用。可空字段应在初始模型中显式声明,并为所用输入选用合适的空值。修改嵌套字段时注意更新是浅合并。
组件源码 · useForm 源码 · 表单示例
`,12)])])}const g=i(e,[["render",h]]);export{o as __pageData,g as default};
diff --git a/docs/assets/reference_components_form.md.BrB2cmbN.lean.js b/docs/assets/reference_components_form.md.BrB2cmbN.lean.js
new file mode 100644
index 00000000..9305bd24
--- /dev/null
+++ b/docs/assets/reference_components_form.md.BrB2cmbN.lean.js
@@ -0,0 +1 @@
+import{_ as i,o as a,c as t,a3 as n}from"./chunks/framework.BNdm2jZV.js";const o=JSON.parse('{"title":"RForm 与 useForm","description":"","frontmatter":{},"headers":[],"relativePath":"reference/components/form.md","filePath":"reference/components/form.md"}'),e={name:"reference/components/form.md"};function h(l,s,k,p,d,r){return a(),t("div",null,[...s[0]||(s[0]=[n("",12)])])}const g=i(e,[["render",h]]);export{o as __pageData,g as default};
diff --git a/docs/assets/reference_components_iframe.md.CZP63QsN.js b/docs/assets/reference_components_iframe.md.CZP63QsN.js
new file mode 100644
index 00000000..6b02a30b
--- /dev/null
+++ b/docs/assets/reference_components_iframe.md.CZP63QsN.js
@@ -0,0 +1,5 @@
+import{_ as e,o as a,c as i,a3 as t}from"./chunks/framework.BNdm2jZV.js";const k=JSON.parse('{"title":"RIframe","description":"","frontmatter":{},"headers":[],"relativePath":"reference/components/iframe.md","filePath":"reference/components/iframe.md"}'),d={name:"reference/components/iframe.md"};function r(n,s,o,h,p,l){return a(),i("div",null,[...s[0]||(s[0]=[t(`RIframe
RIframe 封装原生 iframe 和 Naive UI Spin。它适合嵌入允许被加载的页面,页面自身的 CSP、嵌入授权和同源策略仍生效。load 事件并不能证明业务内容加载成功。
tsximport { RIframe } from '@/components'
+
+export const renderReport = (url: string) => (
+ <RIframe src={url} title="库存报表" height={460} lazy="eager" />
+)
| 属性 | 默认 | 说明 |
|---|
src | 必填 | iframe 地址。接收用户输入时应由业务限制可嵌入来源。 |
width / height | '100%' | CSS 尺寸。百分比高度依赖父级。 |
frameborder | 0 | 模板边框样式变量。 |
iframeWrapperClass / iframeClass | 无 | 外层容器与原生 iframe 的类名。 |
title / name / allow | 无 | 原生 iframe 属性。title 用于辅助技术识别。 |
lazy | true | 字符串 'lazy' 或 'eager'。当前实现把布尔 true 和 false 都映射为 'lazy',主动加载请写 'eager'。 |
customSpinProps | {} | NSpin 配置,show 由组件内状态覆盖。 |
onSuccess(iframe, event) 和 onError 支持函数或回调数组。当前错误分支只传 event,与 Props 类型声明的双参数有差异;需要处理错误时不要假定有元素参数。首次 load / error 后关闭 Spin,当前实现不在 src 变更时重置加载状态;每次切换地址都要显示加载时可给组件不同的 key。iframeInst 是组件实际暴露的 DOM 引用。额外插槽交给 Spin,但默认内容始终为 iframe。
组件实现 · Props
`,6)])])}const g=e(d,[["render",r]]);export{k as __pageData,g as default};
diff --git a/docs/assets/reference_components_iframe.md.CZP63QsN.lean.js b/docs/assets/reference_components_iframe.md.CZP63QsN.lean.js
new file mode 100644
index 00000000..d3d19b01
--- /dev/null
+++ b/docs/assets/reference_components_iframe.md.CZP63QsN.lean.js
@@ -0,0 +1 @@
+import{_ as e,o as a,c as i,a3 as t}from"./chunks/framework.BNdm2jZV.js";const k=JSON.parse('{"title":"RIframe","description":"","frontmatter":{},"headers":[],"relativePath":"reference/components/iframe.md","filePath":"reference/components/iframe.md"}'),d={name:"reference/components/iframe.md"};function r(n,s,o,h,p,l){return a(),i("div",null,[...s[0]||(s[0]=[t("",6)])])}const g=e(d,[["render",r]]);export{k as __pageData,g as default};
diff --git a/docs/assets/reference_components_modal.md.bQ_aJsj-.js b/docs/assets/reference_components_modal.md.bQ_aJsj-.js
new file mode 100644
index 00000000..7adfd9fa
--- /dev/null
+++ b/docs/assets/reference_components_modal.md.bQ_aJsj-.js
@@ -0,0 +1,31 @@
+import{_ as i,o as a,c as n,a3 as t}from"./chunks/framework.BNdm2jZV.js";const c=JSON.parse('{"title":"RModal 与弹窗","description":"","frontmatter":{},"headers":[],"relativePath":"reference/components/modal.md","filePath":"reference/components/modal.md"}'),e={name:"reference/components/modal.md"};function l(h,s,p,d,k,o){return a(),n("div",null,[...s[0]||(s[0]=[t(`RModal 与弹窗
RModal 继承 Naive UI Modal 的 show、preset、关闭事件和插槽,增加预设宽度和全屏卡片。声明式弹窗通过 show / onUpdateShow 或 v-model:show 控制。
tsximport { RModal } from '@/components'
+import { NButton } from 'naive-ui'
+import { defineComponent, ref } from 'vue'
+
+export default defineComponent({
+ setup() {
+ const show = ref(false)
+ return () => (
+ <>
+ <NButton
+ onClick={() => {
+ show.value = true
+ }}
+ >
+ 查看报表
+ </NButton>
+ <RModal
+ show={show.value}
+ onUpdateShow={(value) => {
+ show.value = value
+ }}
+ preset="card"
+ title="库存报表"
+ cardWidth={960}
+ >
+ 报表内容
+ </RModal>
+ </>
+ )
+ },
+})
| 属性 | 默认 | 作用范围 |
|---|
width | 600 | 未指定预设时的宽度。 |
cardWidth | 600 | preset="card" 的宽度。 |
dialogWidth | 446 | preset="dialog" 的宽度。 |
fullscreen | false | 仅 card 预设生效。 |
宽度接受数字或 CSS 尺寸。fullscreen 让卡片占满窗口,正文在溢出时滚动;它不调用浏览器全屏。default、header、footer 等插槽依 Naive UI 预设处理,组件原样转发。
命令式弹窗
@/components 的 useModal() 已弃用,兼容代码仍可通过 create(options) 和 destroyAll() 调用。create 返回 Naive UI 弹窗句柄,支持 fullscreen、width、cardWidth、dialogWidth 等兼容配置。新代码从 naive-ui 导入 useModal,在 NModalProvider 的后代调用;需要模板专用全屏样式时用声明式 RModal。提示用户确认危险操作时也可以用全局 Dialog Provider。
组件源码 · 兼容 Hook · 回归用例
`,8)])])}const E=i(e,[["render",l]]);export{c as __pageData,E as default};
diff --git a/docs/assets/reference_components_modal.md.bQ_aJsj-.lean.js b/docs/assets/reference_components_modal.md.bQ_aJsj-.lean.js
new file mode 100644
index 00000000..987f4c17
--- /dev/null
+++ b/docs/assets/reference_components_modal.md.bQ_aJsj-.lean.js
@@ -0,0 +1 @@
+import{_ as i,o as a,c as n,a3 as t}from"./chunks/framework.BNdm2jZV.js";const c=JSON.parse('{"title":"RModal 与弹窗","description":"","frontmatter":{},"headers":[],"relativePath":"reference/components/modal.md","filePath":"reference/components/modal.md"}'),e={name:"reference/components/modal.md"};function l(h,s,p,d,k,o){return a(),n("div",null,[...s[0]||(s[0]=[t("",8)])])}const E=i(e,[["render",l]]);export{c as __pageData,E as default};
diff --git a/docs/assets/reference_components_more-dropdown.md.BubiDbuv.js b/docs/assets/reference_components_more-dropdown.md.BubiDbuv.js
new file mode 100644
index 00000000..1fcde072
--- /dev/null
+++ b/docs/assets/reference_components_more-dropdown.md.BubiDbuv.js
@@ -0,0 +1,21 @@
+import{_ as i,o as a,c as n,a3 as t}from"./chunks/framework.BNdm2jZV.js";const E=JSON.parse('{"title":"RMoreDropdown","description":"","frontmatter":{},"headers":[],"relativePath":"reference/components/more-dropdown.md","filePath":"reference/components/more-dropdown.md"}'),e={name:"reference/components/more-dropdown.md"};function h(p,s,k,l,d,r){return a(),n("div",null,[...s[0]||(s[0]=[t(`RMoreDropdown
包装 NDropdown,为行操作提供默认的更多图标。options、trigger、placement、onSelect(key, option)、受控显隐等沿用 Naive UI Dropdown。
| 属性 | 默认 | 说明 |
|---|
icon | 'action/more' | 类型为 IconName,使用完整分包路径。 |
iconSize | 14 | 默认触发图标大小。 |
cursor | 'default' | 默认图标指针样式。 |
default 插槽替换图标触发器。只有图标时建议用具有可访问名称的原生按钮或 NButton,方便键盘进入。列表行中根据业务需要阻止触发器的点击冒泡,避免同时触发行导航。
tsximport { RIcon, RMoreDropdown } from '@/components'
+import { NButton } from 'naive-ui'
+
+export const renderRowActions = (edit: () => void) => (
+ <RMoreDropdown
+ trigger="click"
+ placement="bottom-end"
+ options={[{ key: 'edit', label: '编辑' }]}
+ onSelect={(key) => {
+ if (key === 'edit') edit()
+ }}
+ >
+ <NButton
+ text
+ aria-label="更多操作"
+ onClick={(event) => event.stopPropagation()}
+ >
+ <RIcon name="action/more" />
+ </NButton>
+ </RMoreDropdown>
+)
组件实现 · Props
`,6)])])}const g=i(e,[["render",h]]);export{E as __pageData,g as default};
diff --git a/docs/assets/reference_components_more-dropdown.md.BubiDbuv.lean.js b/docs/assets/reference_components_more-dropdown.md.BubiDbuv.lean.js
new file mode 100644
index 00000000..1739156e
--- /dev/null
+++ b/docs/assets/reference_components_more-dropdown.md.BubiDbuv.lean.js
@@ -0,0 +1 @@
+import{_ as i,o as a,c as n,a3 as t}from"./chunks/framework.BNdm2jZV.js";const E=JSON.parse('{"title":"RMoreDropdown","description":"","frontmatter":{},"headers":[],"relativePath":"reference/components/more-dropdown.md","filePath":"reference/components/more-dropdown.md"}'),e={name:"reference/components/more-dropdown.md"};function h(p,s,k,l,d,r){return a(),n("div",null,[...s[0]||(s[0]=[t("",6)])])}const g=i(e,[["render",h]]);export{E as __pageData,g as default};
diff --git a/docs/assets/reference_components_qr-code.md.BtXSFJtd.js b/docs/assets/reference_components_qr-code.md.BtXSFJtd.js
new file mode 100644
index 00000000..2c0cce57
--- /dev/null
+++ b/docs/assets/reference_components_qr-code.md.BtXSFJtd.js
@@ -0,0 +1,15 @@
+import{_ as i,o as a,c as n,a3 as e}from"./chunks/framework.BNdm2jZV.js";const E=JSON.parse('{"title":"二维码","description":"","frontmatter":{},"headers":[],"relativePath":"reference/components/qr-code.md","filePath":"reference/components/qr-code.md"}'),t={name:"reference/components/qr-code.md"};function p(l,s,h,k,d,r){return a(),n("div",null,[...s[0]||(s[0]=[e(`二维码
Ray Template 直接使用 vue3-next-qrcode 的 Vue3NextQrcode,公开实例类型为 QRCodeInst。组件演示和登录扫码占位页分别使用它。
tsximport { NButton } from 'naive-ui'
+import { defineComponent, ref } from 'vue'
+import { Vue3NextQrcode, type QRCodeInst } from 'vue3-next-qrcode'
+
+export default defineComponent({
+ setup() {
+ const qr = ref<QRCodeInst>()
+ return () => (
+ <>
+ <Vue3NextQrcode ref={qr} text="https://example.com/report" />
+ <NButton onClick={() => qr.value?.downloadQRCode()}>下载</NButton>
+ </>
+ )
+ },
+})
text 设置内容,默认可随内容变化重绘。logoImage、backgroundImage、gifBackgroundURL、dotScale、colorDark 可调整样式。带背景的二维码要实际扫码检查清晰度,远程素材还受跨域和浏览器加载限制。
status 可显示 loading、error 等状态,onReload 在重试时通知调用方。downloadQRCode() 等到实例挂载后调用。二维码只表达数据,生成成功与扫码认证成功是两回事;登录需要业务后端签发和验证对应凭据。
二维码示例 · 登录页扫码入口
`,6)])])}const c=i(t,[["render",p]]);export{E as __pageData,c as default};
diff --git a/docs/assets/reference_components_qr-code.md.BtXSFJtd.lean.js b/docs/assets/reference_components_qr-code.md.BtXSFJtd.lean.js
new file mode 100644
index 00000000..4b0f87b5
--- /dev/null
+++ b/docs/assets/reference_components_qr-code.md.BtXSFJtd.lean.js
@@ -0,0 +1 @@
+import{_ as i,o as a,c as n,a3 as e}from"./chunks/framework.BNdm2jZV.js";const E=JSON.parse('{"title":"二维码","description":"","frontmatter":{},"headers":[],"relativePath":"reference/components/qr-code.md","filePath":"reference/components/qr-code.md"}'),t={name:"reference/components/qr-code.md"};function p(l,s,h,k,d,r){return a(),n("div",null,[...s[0]||(s[0]=[e("",6)])])}const c=i(t,[["render",p]]);export{E as __pageData,c as default};
diff --git a/docs/assets/reference_components_route-transition.md.Dg7dX5PR.js b/docs/assets/reference_components_route-transition.md.Dg7dX5PR.js
new file mode 100644
index 00000000..12ea4fe7
--- /dev/null
+++ b/docs/assets/reference_components_route-transition.md.Dg7dX5PR.js
@@ -0,0 +1,5 @@
+import{_ as i,o as s,c as e,a3 as a}from"./chunks/framework.BNdm2jZV.js";const c=JSON.parse('{"title":"RTransitionComponent","description":"","frontmatter":{},"headers":[],"relativePath":"reference/components/route-transition.md","filePath":"reference/components/route-transition.md"}'),n={name:"reference/components/route-transition.md"};function o(r,t,p,d,h,l){return s(),e("div",null,[...t[0]||(t[0]=[a(`RTransitionComponent
RTransitionComponent 是模板的路由出口,组合 RouterView、Transition、Suspense 与 KeepAlive。它直接渲染匹配的路由组件,按 route.fullPath 标识实例;query 或 hash 的变化也可能换用不同实例。
| 属性 | 默认 | 说明 |
|---|
transitionPropName | 'fade' | Vue Transition 类名前缀,应与应用已有样式匹配。 |
transitionMode | 'out-in' | Vue Transition 模式。 |
transitionAppear | true | 首次挂载也应用过渡。 |
setting.keepAliveConfig 控制全局启用、最大数量和排除名称。KeepAlive.include 来自 KeepAlive Store,加入队列的页面必须有与路由名一致的组件名。缓存队列的名称会保存到当前标签的 Session Storage,浏览器刷新仍会创建新组件实例。自定义布局插槽时,只在期望的路由层级放一个出口,避免重复渲染;过渡页面使用单根节点。
tsximport { RTransitionComponent } from '@/components'
+
+export const renderPageOutlet = () => (
+ <RTransitionComponent transitionPropName="fade" transitionAppear={false} />
+)
组件源码 · 缓存 Store · 路由缓存排查
`,6)])])}const g=i(n,[["render",o]]);export{c as __pageData,g as default};
diff --git a/docs/assets/reference_components_route-transition.md.Dg7dX5PR.lean.js b/docs/assets/reference_components_route-transition.md.Dg7dX5PR.lean.js
new file mode 100644
index 00000000..943d620c
--- /dev/null
+++ b/docs/assets/reference_components_route-transition.md.Dg7dX5PR.lean.js
@@ -0,0 +1 @@
+import{_ as i,o as s,c as e,a3 as a}from"./chunks/framework.BNdm2jZV.js";const c=JSON.parse('{"title":"RTransitionComponent","description":"","frontmatter":{},"headers":[],"relativePath":"reference/components/route-transition.md","filePath":"reference/components/route-transition.md"}'),n={name:"reference/components/route-transition.md"};function o(r,t,p,d,h,l){return s(),e("div",null,[...t[0]||(t[0]=[a("",6)])])}const g=i(n,[["render",o]]);export{c as __pageData,g as default};
diff --git a/docs/assets/reference_components_segment.md.BrQOf2XY.js b/docs/assets/reference_components_segment.md.BrQOf2XY.js
new file mode 100644
index 00000000..045b7d4b
--- /dev/null
+++ b/docs/assets/reference_components_segment.md.BrQOf2XY.js
@@ -0,0 +1,21 @@
+import{_ as i,o as a,c as e,a3 as t}from"./chunks/framework.BNdm2jZV.js";const o=JSON.parse('{"title":"RSegment","description":"","frontmatter":{},"headers":[],"relativePath":"reference/components/segment.md","filePath":"reference/components/segment.md"}'),n={name:"reference/components/segment.md"};function l(h,s,p,k,d,r){return a(),e("div",null,[...s[0]||(s[0]=[t(`RSegment
RSegment 用 Naive UI Tabs 的 segment 模式渲染选项。通过 value 和 onUpdateValue(或 v-model:value)切换业务状态,defaultValue 可提供非受控初值。页面内容由调用方根据值渲染。
| 属性 | 默认 | 说明 |
|---|
options | [] | RSegmentOptions[],每个选项的 key 需唯一。 |
width | 'fitContent' | 'block' 占满、'fitContent' 按内容、数字按像素。 |
themeOverrides | 内置分段间距 | 业务覆盖与内置配置浅合并。 |
每项必填 key: string \\| number、label(文本、VNode 或渲染类型)。可用 disabled、icon(VNode 或函数)、popover(文本或含 label 的 Naive UI Popover 配置)、slots.default。虽然类型提供 displayDirective,当前实现没有把该字段传给选项,不能用它控制面板挂载。组件固定 type="segment" 与动画,不支持 Tabs 的增删页签、位置、Pane 样式等被排除字段。
tsximport { RSegment, type RSegmentOptions } from '@/components'
+import { defineComponent, ref } from 'vue'
+
+export default defineComponent({
+ setup() {
+ const selected = ref<string | number>('day')
+ const options: RSegmentOptions[] = [
+ { key: 'day', label: '日', popover: '按日查看' },
+ { key: 'week', label: '周' },
+ ]
+ return () => (
+ <RSegment
+ options={options}
+ value={selected.value}
+ onUpdateValue={(value) => {
+ selected.value = value
+ }}
+ />
+ )
+ },
+})
组件实现 · 选项类型 · 不支持的 Tabs 属性
`,6)])])}const c=i(n,[["render",l]]);export{o as __pageData,c as default};
diff --git a/docs/assets/reference_components_segment.md.BrQOf2XY.lean.js b/docs/assets/reference_components_segment.md.BrQOf2XY.lean.js
new file mode 100644
index 00000000..551d913b
--- /dev/null
+++ b/docs/assets/reference_components_segment.md.BrQOf2XY.lean.js
@@ -0,0 +1 @@
+import{_ as i,o as a,c as e,a3 as t}from"./chunks/framework.BNdm2jZV.js";const o=JSON.parse('{"title":"RSegment","description":"","frontmatter":{},"headers":[],"relativePath":"reference/components/segment.md","filePath":"reference/components/segment.md"}'),n={name:"reference/components/segment.md"};function l(h,s,p,k,d,r){return a(),e("div",null,[...s[0]||(s[0]=[t("",6)])])}const c=i(n,[["render",l]]);export{o as __pageData,c as default};
diff --git a/docs/assets/reference_configuration.md.BeYwV4AY.js b/docs/assets/reference_configuration.md.BeYwV4AY.js
new file mode 100644
index 00000000..4f5e3e35
--- /dev/null
+++ b/docs/assets/reference_configuration.md.BeYwV4AY.js
@@ -0,0 +1 @@
+import{_ as d,o,c as t,a3 as c}from"./chunks/framework.BNdm2jZV.js";const f=JSON.parse('{"title":"应用配置","description":"","frontmatter":{},"headers":[],"relativePath":"reference/configuration.md","filePath":"reference/configuration.md"}'),a={name:"reference/configuration.md"};function r(i,e,n,s,_,p){return o(),t("div",null,[...e[0]||(e[0]=[c('应用配置
应用配置与站外文档配置分属两个仓库。这里说明 Ray Template 应用中的 @/app-config、Vite 配置和运行期设置。运行期保存的用户偏好可能覆盖源码默认值,验证默认设置时使用干净的浏览器存储。
| 文件 | 配置 |
|---|
apps/admin/src/app-config/app-config.ts | GLOBAL_CLASS_NAMES(明暗类与 CSS 变量)、MESSAGE_PROVIDER(上下文消息,默认最多 5 条、不可关闭)、LAYOUT_CONTENT_SPIN_WHEN_ROUTE_CHANGE(默认关)、APP_GLOBAL_LOADING、PRE_LOADING_CONFIG、APP_CATCH_KEY / APP_CATCH_KEY_PREFIX、CONTENT_TRANSITION_OPTIONS。 |
apps/admin/src/app-config/design-config.ts | APP_THEME 的候选色、默认蓝 #3b63d9、Naive UI 明暗覆盖、ECharts 默认主题。 |
apps/admin/src/app-config/local-config.ts | LOCAL_OPTIONS、SYSTEM_DEFAULT_LOCAL、SYSTEM_FALLBACK_LOCALE、DAYJS_LOCAL_MAP、DEFAULT_DAYJS_LOCAL。默认与回退语言为 zh-CN。 |
apps/admin/src/app-config/request-config.ts | AXIOS_CONFIG。默认同源相对地址、5 秒超时、withCredentials: false、JSON Content-Type。 |
apps/admin/src/app-config/router-config.ts | SETUP_ROUTER_ACTION(加载条与守卫默认开)、WHITE_ROUTES(路由名白名单)、SUPER_ADMIN(默认空)、LAYOUT_CONTENT_REF / LAYOUT_SIDER_REF。 |
apps/admin/src/app-config/regex-config.ts | APP_REGEX,模板 CSS 尺寸规则。 |
vite.custom.config.ts | base、server、buildOptions(mode)、alias、cdn、copyright、Sass 注入和首屏加载配置。 |
选择改动入口
- 修改默认用户偏好(布局、菜单、标签、缓存)时看 Setting Store 与
apps/admin/src/store/modules/setting/constant.ts。已有用户可在应用设置里恢复默认后检查效果。 - 修改主题或语言时看主题和国际化。新增语言同时维护翻译资源与 Day.js、Naive UI 对应关系。
- 修改访问控制时看路由指南。白名单按区分大小写的字符串路由名判断,守卫先处理 token,再按白名单和角色处理导航。
- 修改 API 地址、认证头和失败策略时看接口与 Mock。应用不会自动把任意
VITE_* 环境变量绑定到 Axios;需在配置中明确读取。 - 应用默认部署子路径
/ray-template/。部署子路径改变后重新构建并验证图标、代理和直达链接,见工程与部署。
__APP_CFG__ 由 Vite 在构建时注入,用于应用包信息、版权与默认主色。任何注入到客户端的字段都可被浏览器读取。用于页面交互的运行态偏好走 Store,构建参数留在 Vite 配置。
应用配置源码 · Vite 自定义配置
',7)])])}const A=d(a,[["render",r]]);export{f as __pageData,A as default};
diff --git a/docs/assets/reference_configuration.md.BeYwV4AY.lean.js b/docs/assets/reference_configuration.md.BeYwV4AY.lean.js
new file mode 100644
index 00000000..55e3db2f
--- /dev/null
+++ b/docs/assets/reference_configuration.md.BeYwV4AY.lean.js
@@ -0,0 +1 @@
+import{_ as d,o,c as t,a3 as c}from"./chunks/framework.BNdm2jZV.js";const f=JSON.parse('{"title":"应用配置","description":"","frontmatter":{},"headers":[],"relativePath":"reference/configuration.md","filePath":"reference/configuration.md"}'),a={name:"reference/configuration.md"};function r(i,e,n,s,_,p){return o(),t("div",null,[...e[0]||(e[0]=[c("",7)])])}const A=d(a,[["render",r]]);export{f as __pageData,A as default};
diff --git a/docs/assets/reference_directives.md.DZcDGixq.js b/docs/assets/reference_directives.md.DZcDGixq.js
new file mode 100644
index 00000000..be7778a3
--- /dev/null
+++ b/docs/assets/reference_directives.md.DZcDGixq.js
@@ -0,0 +1,63 @@
+import{u as R}from"./chunks/index.CRUCD9CF.js";import{i as b,r as N}from"./chunks/Loading.CYk0ZDH9.js";import{i as P}from"./chunks/isSymbol.BJY0fdHu.js";import{B as V}from"./chunks/Button.B5dXaugh.js";import{d as W,o as f,c as x,a5 as M,k as B,b as X,w as G,a as L,j as O,t as H,p as U,a3 as A,E as $}from"./chunks/framework.BNdm2jZV.js";var j=/\s/;function K(s){for(var i=s.length;i--&&j.test(s.charAt(i)););return i}var J=/^\s+/;function z(s){return s&&s.slice(0,K(s)+1).replace(J,"")}var _=NaN,Q=/^[-+]0x[0-9a-f]+$/i,Y=/^0b[01]+$/i,Z=/^0o[0-7]+$/i,ss=parseInt;function q(s){if(typeof s=="number")return s;if(P(s))return _;if(b(s)){var i=typeof s.valueOf=="function"?s.valueOf():s;s=b(i)?i+"":i}if(typeof s!="string")return s===0?s:+s;s=z(s);var a=Y.test(s);return a||Z.test(s)?ss(s.slice(2),a?2:8):Q.test(s)?_:+s}var F=function(){return N.Date.now()},is="Expected a function",as=Math.max,ts=Math.min;function ns(s,i,a){var e,p,l,k,n,h,d=0,m=!1,E=!1,c=!0;if(typeof s!="function")throw new TypeError(is);i=q(i)||0,b(a)&&(m=!!a.leading,E="maxWait"in a,l=E?as(q(a.maxWait)||0,i):l,c="trailing"in a?!!a.trailing:c);function y(t){var r=e,o=p;return e=p=void 0,d=t,k=s.apply(o,r),k}function T(t){return d=t,n=setTimeout(g,i),m?y(t):k}function w(t){var r=t-h,o=t-d,D=i-r;return E?ts(D,l-o):D}function v(t){var r=t-h,o=t-d;return h===void 0||r>=i||r<0||E&&o>=l}function g(){var t=F();if(v(t))return C(t);n=setTimeout(g,w(t))}function C(t){return n=void 0,c&&e?y(t):(e=p=void 0,k)}function S(){n!==void 0&&clearTimeout(n),d=0,e=h=p=n=void 0}function I(){return n===void 0?k:C(F())}function u(){var t=F(),r=v(t);if(e=arguments,p=this,h=t,r){if(n===void 0)return T(h);if(E)return clearTimeout(n),n=setTimeout(g,i),y(h)}return n===void 0&&(n=setTimeout(g,i)),k}return u.cancel=S,u.flush=I,u}const es=()=>{const s=new WeakMap;return{beforeMount:(i,{value:a})=>{const{func:e,trigger:p="click",wait:l=500,options:k}=a;if(typeof e!="function")throw new TypeError("debounce directive value must be a function");const n=ns(e,l,k),h=R(i,p,n);s.set(i,()=>{n.cancel(),h()})},beforeUnmount(i){var a;(a=s.get(i))==null||a(),s.delete(i)}}},ls={class:"ray-demo"},hs={class:"ray-demo-result"},ps=W({__name:"DebounceDemo",setup(s){const i=es(),a=U(0),e=()=>{a.value+=1};return(p,l)=>(f(),x("div",ls,[M((f(),X(B(V),null,{default:G(()=>[...l[0]||(l[0]=[L(" 连续点击 / Click repeatedly ",-1)])]),_:1})),[[B(i),{wait:500,func:e}]]),O("output",hs,"执行次数 / Calls: "+H(a.value),1)]))}}),cs=JSON.parse('{"title":"指令","description":"","frontmatter":{},"headers":[],"relativePath":"reference/directives.md","filePath":"reference/directives.md"}'),ks={name:"reference/directives.md"},ys=Object.assign(ks,{setup(s){return(i,a)=>(f(),x("div",null,[a[0]||(a[0]=A(`指令
应用在 main.ts 调用 setupDirectives(app)。注册器查找 packages/directives/src/modules/<name>/index.ts,调用默认导出的工厂,将返回的 Vue Directive 以目录名注册。SFC 中可直接用 v-<name>;从文件名和源码进入可查各指令的绑定类型。
v-copy
绑定要复制的字符串;绑定值改变时销毁并重建 ClipboardJS 实例,卸载时销毁。Ray Admin 注册时接入消息提示。独立使用 createCopyDirective 时可提供自己的结果回调。复制应由用户点击触发。数字等值请先显式转为字符串。
vue<template>
+ <button type="button" v-copy="'ORD-001'">复制订单号</button>
+</template>
源码
v-debounce 与 v-throttle
连续点击按钮,停止 500ms 后,防抖只执行一次。
`,8)),$(ps),a[1]||(a[1]=A(`查看示例源码
vue<template>
+ <div class="ray-demo">
+ <NButton v-debounce="{ wait: 500, func: increment }">
+ 连续点击 / Click repeatedly
+ </NButton>
+ <output class="ray-demo-result">执行次数 / Calls: {{ calls }}</output>
+ </div>
+</template>
+
+<script setup lang="ts">
+import debounce from '@ray-template/directives/debounce'
+import { NButton } from 'naive-ui'
+import { ref } from 'vue'
+
+const vDebounce = debounce()
+const calls = ref(0)
+const increment = () => {
+ calls.value += 1
+}
+</script>
两者都接收 { func, trigger?, wait?, options? }。func 必须是函数并可接收原生事件;trigger 默认 'click',wait 默认 500 毫秒,options 转给 Lodash 的对应方法。防抖适合在连续输入停止后处理,节流适合限制持续触发的频率。
vue<script setup lang="ts">
+import { ref } from 'vue'
+
+const keyword = ref('')
+const requestedKeyword = ref('')
+const clicks = ref(0)
+
+const applySearch = () => {
+ requestedKeyword.value = keyword.value
+}
+const countClick = () => {
+ clicks.value += 1
+}
+</script>
+
+<template>
+ <input
+ v-model="keyword"
+ v-debounce="{ func: applySearch, trigger: 'input', wait: 300 }"
+ />
+ <p>已提交的查询词:{{ requestedKeyword }}</p>
+ <button type="button" v-throttle="{ func: countClick, wait: 1000 }">
+ 点击次数 {{ clicks }}
+ </button>
+</template>
options.leading / trailing 决定在等待周期首尾是否执行;防抖还可设 maxWait。挂载时读取绑定值,更新不会重绑。若回调依赖变动数据,让原函数在执行时读取响应式值。- 当前实现将监听器句柄保存在指令工厂闭包,多个绑定实例共用同一清理位置。需要同一指令同时绑多个元素或动态修改间隔时,在组件里单独创建防抖或节流函数并清理。
- 防抖和节流只约束事件触发,异步请求仍需独立处理取消、并发或幂等。
防抖源码 · 节流源码
v-ellipsis
width 必填,数字按像素;字符串可传 CSS 尺寸。type: 'block' 做单行省略,type: 'line' 使用 line 行截断,默认按单行处理。popoverText: true 把当前文本写入原生 title,不创建 Popover。挂载和更新时写入样式;切换模式或关掉悬浮文本不会自动删除上一次写入的样式或 title。经常切换的场景可以改用组件库的省略组件,或切换节点 key。
vue<template>
+ <p v-ellipsis="{ type: 'line', line: 2, width: 240, popoverText: true }">
+ 这里放较长的说明文字,超出两行后会被省略。
+ </p>
+</template>
源码
v-ripple
省略绑定值或传 true 启用,false 关闭。绑定对象 { class: '...' } 可指定波纹样式。.center 从中心扩散,.circle 使用圆形计算。通过 pointer 事件渲染,属于视觉反馈,交互语义仍由外层按钮负责。
vue<template>
+ <button type="button" v-ripple.center.circle>查看详情</button>
+</template>
源码 · 绑定与清理
v-disabled
接收布尔值并修改原生 disabled 属性和模板禁用样式。当前实现关闭禁用时仍会写入空的 disabled 属性,HTML 原生按钮将继续视为禁用。因此原生控件使用 :disabled="busy",Naive UI 使用对应 disabled prop。对自定义控件,要同时处理指针、键盘与可访问状态;样式不能取代业务权限检查。
源码
新增指令
每个指令放在单独目录,工厂默认导出。可用 CustomDirectiveFC<HTMLElement, T> 标注绑定值。在 mounted 取得元素,在 updated 处理值更新,在 beforeUnmount 释放事件、计时器和第三方实例。多个元素需要独立数据时,把状态放在元素关联的 WeakMap,避免用单个变量保存全部实例的资源。
tsimport type { CustomDirectiveFC } from '@/directives/types'
+
+const focusWhen: CustomDirectiveFC<HTMLElement, boolean> = () => ({
+ mounted(el, { value }) {
+ if (value) el.focus()
+ },
+ updated(el, { value, oldValue }) {
+ if (value && !oldValue) el.focus()
+ },
+})
+
+export default focusWhen
将示例保存为 packages/directives/src/modules/focus-when/index.ts,在组件中用 v-focus-when。目录名按现有约定用单段小写 kebab-case。注册器要求默认导出函数,缺失会抛错。
注册入口 · 指令类型
`,21))]))}});export{cs as __pageData,ys as default};
diff --git a/docs/assets/reference_directives.md.DZcDGixq.lean.js b/docs/assets/reference_directives.md.DZcDGixq.lean.js
new file mode 100644
index 00000000..b2fb0275
--- /dev/null
+++ b/docs/assets/reference_directives.md.DZcDGixq.lean.js
@@ -0,0 +1 @@
+import{u as R}from"./chunks/index.CRUCD9CF.js";import{i as b,r as N}from"./chunks/Loading.CYk0ZDH9.js";import{i as P}from"./chunks/isSymbol.BJY0fdHu.js";import{B as V}from"./chunks/Button.B5dXaugh.js";import{d as W,o as f,c as x,a5 as M,k as B,b as X,w as G,a as L,j as O,t as H,p as U,a3 as A,E as $}from"./chunks/framework.BNdm2jZV.js";var j=/\s/;function K(s){for(var i=s.length;i--&&j.test(s.charAt(i)););return i}var J=/^\s+/;function z(s){return s&&s.slice(0,K(s)+1).replace(J,"")}var _=NaN,Q=/^[-+]0x[0-9a-f]+$/i,Y=/^0b[01]+$/i,Z=/^0o[0-7]+$/i,ss=parseInt;function q(s){if(typeof s=="number")return s;if(P(s))return _;if(b(s)){var i=typeof s.valueOf=="function"?s.valueOf():s;s=b(i)?i+"":i}if(typeof s!="string")return s===0?s:+s;s=z(s);var a=Y.test(s);return a||Z.test(s)?ss(s.slice(2),a?2:8):Q.test(s)?_:+s}var F=function(){return N.Date.now()},is="Expected a function",as=Math.max,ts=Math.min;function ns(s,i,a){var e,p,l,k,n,h,d=0,m=!1,E=!1,c=!0;if(typeof s!="function")throw new TypeError(is);i=q(i)||0,b(a)&&(m=!!a.leading,E="maxWait"in a,l=E?as(q(a.maxWait)||0,i):l,c="trailing"in a?!!a.trailing:c);function y(t){var r=e,o=p;return e=p=void 0,d=t,k=s.apply(o,r),k}function T(t){return d=t,n=setTimeout(g,i),m?y(t):k}function w(t){var r=t-h,o=t-d,D=i-r;return E?ts(D,l-o):D}function v(t){var r=t-h,o=t-d;return h===void 0||r>=i||r<0||E&&o>=l}function g(){var t=F();if(v(t))return C(t);n=setTimeout(g,w(t))}function C(t){return n=void 0,c&&e?y(t):(e=p=void 0,k)}function S(){n!==void 0&&clearTimeout(n),d=0,e=h=p=n=void 0}function I(){return n===void 0?k:C(F())}function u(){var t=F(),r=v(t);if(e=arguments,p=this,h=t,r){if(n===void 0)return T(h);if(E)return clearTimeout(n),n=setTimeout(g,i),y(h)}return n===void 0&&(n=setTimeout(g,i)),k}return u.cancel=S,u.flush=I,u}const es=()=>{const s=new WeakMap;return{beforeMount:(i,{value:a})=>{const{func:e,trigger:p="click",wait:l=500,options:k}=a;if(typeof e!="function")throw new TypeError("debounce directive value must be a function");const n=ns(e,l,k),h=R(i,p,n);s.set(i,()=>{n.cancel(),h()})},beforeUnmount(i){var a;(a=s.get(i))==null||a(),s.delete(i)}}},ls={class:"ray-demo"},hs={class:"ray-demo-result"},ps=W({__name:"DebounceDemo",setup(s){const i=es(),a=U(0),e=()=>{a.value+=1};return(p,l)=>(f(),x("div",ls,[M((f(),X(B(V),null,{default:G(()=>[...l[0]||(l[0]=[L(" 连续点击 / Click repeatedly ",-1)])]),_:1})),[[B(i),{wait:500,func:e}]]),O("output",hs,"执行次数 / Calls: "+H(a.value),1)]))}}),cs=JSON.parse('{"title":"指令","description":"","frontmatter":{},"headers":[],"relativePath":"reference/directives.md","filePath":"reference/directives.md"}'),ks={name:"reference/directives.md"},ys=Object.assign(ks,{setup(s){return(i,a)=>(f(),x("div",null,[a[0]||(a[0]=A("",8)),$(ps),a[1]||(a[1]=A("",21))]))}});export{cs as __pageData,ys as default};
diff --git a/docs/assets/reference_hooks.md.fkz_ntnz.js b/docs/assets/reference_hooks.md.fkz_ntnz.js
new file mode 100644
index 00000000..92a966b9
--- /dev/null
+++ b/docs/assets/reference_hooks.md.fkz_ntnz.js
@@ -0,0 +1 @@
+import{_ as o,o as t,c as a,a3 as d}from"./chunks/framework.BNdm2jZV.js";const u=JSON.parse('{"title":"Hooks","description":"","frontmatter":{},"headers":[],"relativePath":"reference/hooks.md","filePath":"reference/hooks.md"}'),r={name:"reference/hooks.md"};function s(c,e,h,n,l,i){return t(),a("div",null,[...e[0]||(e[0]=[d('Hooks
模板的公开 Hooks 从 @/hooks 导入。与具体组件一起使用的 useForm、useModal、useChart、useFlow 从 @/components 导入,请看对应组件页。useRequest 从 @/axios 导入。
需要订阅、事件或清理的 Hook 在 setup() 或有效的 Vue effect scope 中创建。在 DOM 挂载后或用户操作时执行截图、打印和全屏。BasicTarget 接受元素、ref 或 getter,解析规则和可用元素类型见Vue 与 DOM 目标。
项目保留 @/hooks/web/useI18n、@/hooks/web/useVueRouter、@/hooks/web/usePagination 作为兼容导入。新代码统一从 @/hooks 导入。实现和测试入口见源码 Hooks 索引。
',5)])])}const f=o(r,[["render",s]]);export{u as __pageData,f as default};
diff --git a/docs/assets/reference_hooks.md.fkz_ntnz.lean.js b/docs/assets/reference_hooks.md.fkz_ntnz.lean.js
new file mode 100644
index 00000000..39949bef
--- /dev/null
+++ b/docs/assets/reference_hooks.md.fkz_ntnz.lean.js
@@ -0,0 +1 @@
+import{_ as o,o as t,c as a,a3 as d}from"./chunks/framework.BNdm2jZV.js";const u=JSON.parse('{"title":"Hooks","description":"","frontmatter":{},"headers":[],"relativePath":"reference/hooks.md","filePath":"reference/hooks.md"}'),r={name:"reference/hooks.md"};function s(c,e,h,n,l,i){return t(),a("div",null,[...e[0]||(e[0]=[d("",5)])])}const f=o(r,[["render",s]]);export{u as __pageData,f as default};
diff --git a/docs/assets/reference_hooks_appearance.md.JMrRj834.js b/docs/assets/reference_hooks_appearance.md.JMrRj834.js
new file mode 100644
index 00000000..880bc086
--- /dev/null
+++ b/docs/assets/reference_hooks_appearance.md.JMrRj834.js
@@ -0,0 +1,26 @@
+import{_ as a,o as i,c as e,a3 as t}from"./chunks/framework.BNdm2jZV.js";const E=JSON.parse('{"title":"主题、语言和水印 Hooks","description":"","frontmatter":{},"headers":[],"relativePath":"reference/hooks/appearance.md","filePath":"reference/hooks/appearance.md"}'),n={name:"reference/hooks/appearance.md"};function h(k,s,p,l,r,d){return i(),e("div",null,[...s[0]||(s[0]=[t(`主题、语言和水印 Hooks
useTheme
useTheme() 返回下列方法。颜色覆盖由设置 Store 和全局 Provider 一起管理。
| 方法 | 行为 |
|---|
lightTheme() / darkTheme() | 切换为手动浅色或深色,更新 Naive UI 的主题覆盖。 |
toggleTheme() | 根据当前实际明暗状态切换到相反的手动主题。 |
syncSystemTheme() | 读取浏览器偏好并切换到 auto,之后由设置 Store 跟随系统变化。 |
getAppTheme() | 返回 { theme, themeLabel, themeI18nLabel };theme 为 true 表示深色,themeLabel 是固定的 Dark / Light。 |
getAppTheme() 返回一次读取的对象。界面要跟随语言或主题变化时,在 computed 或渲染中调用。自定义主色请使用 Setting Store 的 changePrimaryColor。
useI18n
useI18n(namespace?) 返回 t(key, ...args)、locale(lang) 和初始化时可用的 Vue I18n 全局能力。useI18n('menu').t('Dashboard') 与 useI18n('menu').t('menu.Dashboard') 指向同一翻译键。未指定命名空间时,裸字符串原样返回。初始化前,t 返回解析后的键;初始化后同一个翻译函数会读取最新实例。
@/hooks 还导出独立的 t(key),它只返回原始键,可供路由元数据和翻译工具静态识别。切换整个应用语言用 useSettingActions().updateLocale(lang),以同步 Day.js、组件库和持久化语言;直接调用 useI18n().locale 只操作 Vue I18n 和 HTML 语言属性。
tsimport { useI18n, useTheme } from '@/hooks'
+import { useSettingActions } from '@/store'
+import { computed } from 'vue'
+
+export function useAppearanceSettings() {
+ const { t } = useI18n('menu')
+ const theme = useTheme()
+ const { updateLocale } = useSettingActions()
+ const title = computed(() => t('Dashboard'))
+ return {
+ title,
+ followSystem: theme.syncSystemTheme,
+ switchToEnglish: () => updateLocale('en-US'),
+ }
+}
useWatermark
setWatermarkContent(content) 合并水印文字;空字符串直接忽略。showWatermark()、hiddenWatermark()、toggleWatermark() 修改共享显隐状态。要清除显示,请调用 hiddenWatermark()。字体、旋转和间距从 Setting Store 的 watermarkConfig 修改,显示范围由 AppWatermarkProvider 所在位置决定。
tsimport { useWatermark } from '@/hooks'
+
+export function useReportWatermark() {
+ const { setWatermarkContent, showWatermark, hiddenWatermark } = useWatermark()
+ return {
+ enable() {
+ setWatermarkContent('内部报表')
+ showWatermark()
+ },
+ disable: hiddenWatermark,
+ }
+}
源码:useTheme · useI18n · useWatermark
`,13)])])}const c=a(n,[["render",h]]);export{E as __pageData,c as default};
diff --git a/docs/assets/reference_hooks_appearance.md.JMrRj834.lean.js b/docs/assets/reference_hooks_appearance.md.JMrRj834.lean.js
new file mode 100644
index 00000000..18566668
--- /dev/null
+++ b/docs/assets/reference_hooks_appearance.md.JMrRj834.lean.js
@@ -0,0 +1 @@
+import{_ as a,o as i,c as e,a3 as t}from"./chunks/framework.BNdm2jZV.js";const E=JSON.parse('{"title":"主题、语言和水印 Hooks","description":"","frontmatter":{},"headers":[],"relativePath":"reference/hooks/appearance.md","filePath":"reference/hooks/appearance.md"}'),n={name:"reference/hooks/appearance.md"};function h(k,s,p,l,r,d){return i(),e("div",null,[...s[0]||(s[0]=[t("",13)])])}const c=a(n,[["render",h]]);export{E as __pageData,c as default};
diff --git a/docs/assets/reference_hooks_browser.md.D5n_xtb0.js b/docs/assets/reference_hooks_browser.md.D5n_xtb0.js
new file mode 100644
index 00000000..f729a517
--- /dev/null
+++ b/docs/assets/reference_hooks_browser.md.D5n_xtb0.js
@@ -0,0 +1,45 @@
+import{a8 as P,a9 as j,S as O,p as I,d as R,aa as N,o as C,c as D,E as b,k as c,w as V,a as Y,t as M,_ as z,a3 as f}from"./chunks/framework.BNdm2jZV.js";import{u as H}from"./chunks/unref-element.DLBcf5mH.js";import{B as $}from"./chunks/Button.B5dXaugh.js";import"./chunks/Loading.CYk0ZDH9.js";function G(n){return P()?(j(n),!0):!1}let L=999;const r="data-element-fullscreen",g=new WeakSet,X=(n,d)=>{const{beforeEnter:i,beforeExit:h,enter:p,exit:t,backgroundColor:y,zIndex:A,transition:B="all 0.3s cubic-bezier(0.4, 0, 0.2, 1)"}={},k=I(!1);let l,a;const E=()=>{a&&(h==null||h(),a(),t==null||t())},F=()=>{const s=H(n);if(!(s instanceof HTMLElement)||g.has(s))return;a&&E(),i==null||i();const{top:_,left:x,width:S,height:T}=s.getBoundingClientRect(),u={position:"fixed","box-sizing":"border-box",top:`${_}px`,left:`${x}px`,width:`${S}px`,height:`${T}px`,transform:"translate(0, 0)","z-index":String(A??++L),transition:"none",...y?{"background-color":y}:{}},w=Object.keys(u).map(e=>[e,s.style.getPropertyValue(e),s.style.getPropertyPriority(e)]),m=s.getAttribute(r);g.add(s),a=()=>{l!==void 0&&cancelAnimationFrame(l),l=void 0;for(const[e,o,q]of w)s.style.setProperty(e,o,q);m===null?s.removeAttribute(r):s.setAttribute(r,m),a=void 0,g.delete(s),k.value=!1},s.setAttribute(r,"true");for(const[e,o]of Object.entries(u))s.style.setProperty(e,o);s.offsetHeight,s.style.transition=B,l=requestAnimationFrame(()=>{Object.assign(s.style,{top:"0px",left:"0px",width:"100dvw",height:"100dvh"}),l=void 0}),k.value=!0,p==null||p()},v=()=>{k.value?E():F()};return G(()=>{a&&(a(),t==null||t())}),{enter:F,exit:E,toggleFullscreen:v,isFullscreen:O(k)}},W={ref:"preview",class:"ray-demo fullscreen-demo"},J=R({__name:"FullscreenDemo",setup(n){const{isFullscreen:d,toggleFullscreen:i}=X(N("preview"));return(h,p)=>(C(),D("div",W,[b(c($),{onClick:c(i)},{default:V(()=>[Y(M(c(d)?"退出全屏 / Exit full screen":"元素全屏 / Full screen"),1)]),_:1},8,["onClick"])],512))}}),U=z(J,[["__scopeId","data-v-0d48cce2"]]),as=JSON.parse('{"title":"窗口、全屏和日期","description":"","frontmatter":{},"headers":[],"relativePath":"reference/hooks/browser.md","filePath":"reference/hooks/browser.md"}'),Z={name:"reference/hooks/browser.md"},es=Object.assign(Z,{setup(n){return(d,i)=>(C(),D("div",null,[i[0]||(i[0]=f(`窗口、全屏和日期
useDevice
useDevice(options?) 返回 width、height 引用及 isTabletOrSmaller 计算引用。默认条件为 width <= 768。options.media 自定义断点,其他窗口尺寸选项传给 VueUse useWindowSize。observer(isSmaller, { width, height }) 会立即执行一次,此后窗口尺寸或断点判断变化时再次执行。它检测窗口宽度,无法识别设备型号;组件容器宽度请另用 CSS 或容器观察。
tsimport { useDevice } from '@/hooks'
+import { computed } from 'vue'
+
+export function useListDensity() {
+ const { isTabletOrSmaller } = useDevice({ media: 900 })
+ return computed(() => (isTabletOrSmaller.value ? 'small' : 'medium'))
+}
useElementFullscreen
点击按钮,查看元素撑满视口及恢复原位置的效果。
`,6)),b(U),i[1]||(i[1]=f(`查看示例源码
vue<template>
+ <div ref="preview" class="ray-demo fullscreen-demo">
+ <NButton @click="toggleFullscreen">
+ {{
+ isFullscreen ? '退出全屏 / Exit full screen' : '元素全屏 / Full screen'
+ }}
+ </NButton>
+ </div>
+</template>
+
+<script setup lang="ts">
+import { useElementFullscreen } from '@ray-template/composables/useElementFullscreen'
+import { NButton } from 'naive-ui'
+import { useTemplateRef } from 'vue'
+
+const { isFullscreen, toggleFullscreen } = useElementFullscreen(
+ useTemplateRef('preview'),
+)
+</script>
+
+<style scoped>
+.fullscreen-demo {
+ display: grid;
+ place-items: center;
+ margin: 0;
+ background: var(--vp-c-bg-soft);
+}
+</style>
useElementFullscreen(target, options?) 返回 enter()、exit()、toggleFullscreen() 和只读 isFullscreen。目标需能解包为 HTMLElement。它用 CSS 固定定位撑满视口;同一个元素一次只能由一个实例控制,也不会调用原生 Fullscreen API。
| 选项 | 行为 |
|---|
beforeEnter / beforeExit | 在覆盖或恢复样式之前执行;手动切换时抛错会中止操作。 |
enter / exit | 状态变化或样式恢复后执行,enter 不代表动画结束。 |
zIndex | 指定层级;省略时随进入顺序分配。 |
backgroundColor / transition | 指定背景与过渡。传 'none' 关闭过渡。 |
退出和卸载都会恢复原行内样式并取消待处理动画帧。作用域销毁会直接恢复,随后执行 exit 回调。若交互需要 Esc 或按钮关闭,页面应绑定 exit()。
tsimport { useElementFullscreen } from '@/hooks'
+import { ref } from 'vue'
+
+export function usePanelFullscreen() {
+ const panel = ref<HTMLElement>()
+ const controls = useElementFullscreen(panel, { transition: 'none' })
+ return { panel, ...controls }
+}
useDayjs
| 方法 | 行为 |
|---|
locale(key) | 从应用语言映射设置 Day.js 全局 locale,未知键回退到默认语言。 |
isDayjs(value) | 判断是否为 Day.js 对象。 |
format(date, { format }?) | 格式化,默认 YYYY-MM-DD HH:mm:ss。 |
getStartAndEndOfDay({ format }?) | 返回 today、startOfDay、endOfDay 及对应三个 format… 字符串。 |
daysDiff(date1, date2) | 计算 date2 - date1 的整数天差,可为负数。 |
isDateInRange(date, { start, end }) | 检查严格开区间 start < date < end,不含两端。 |
日界线按当前 Day.js 环境计算。后端按固定时区统计时,传统一时区的时间并在业务层处理区间边界。切换界面语言时优先使用 Setting Store,它会一并同步日期语言。
tsimport { useDayjs } from '@/hooks'
+
+const day = useDayjs()
+export const exportDate = day.format('2026-11-03', { format: 'YYYY-MM-DD' })
+export const dayRange = day.getStartAndEndOfDay()
源码:useDevice · useElementFullscreen · useDayjs
`,10))]))}});export{as as __pageData,es as default};
diff --git a/docs/assets/reference_hooks_browser.md.D5n_xtb0.lean.js b/docs/assets/reference_hooks_browser.md.D5n_xtb0.lean.js
new file mode 100644
index 00000000..fd5571da
--- /dev/null
+++ b/docs/assets/reference_hooks_browser.md.D5n_xtb0.lean.js
@@ -0,0 +1 @@
+import{a8 as P,a9 as j,S as O,p as I,d as R,aa as N,o as C,c as D,E as b,k as c,w as V,a as Y,t as M,_ as z,a3 as f}from"./chunks/framework.BNdm2jZV.js";import{u as H}from"./chunks/unref-element.DLBcf5mH.js";import{B as $}from"./chunks/Button.B5dXaugh.js";import"./chunks/Loading.CYk0ZDH9.js";function G(n){return P()?(j(n),!0):!1}let L=999;const r="data-element-fullscreen",g=new WeakSet,X=(n,d)=>{const{beforeEnter:i,beforeExit:h,enter:p,exit:t,backgroundColor:y,zIndex:A,transition:B="all 0.3s cubic-bezier(0.4, 0, 0.2, 1)"}={},k=I(!1);let l,a;const E=()=>{a&&(h==null||h(),a(),t==null||t())},F=()=>{const s=H(n);if(!(s instanceof HTMLElement)||g.has(s))return;a&&E(),i==null||i();const{top:_,left:x,width:S,height:T}=s.getBoundingClientRect(),u={position:"fixed","box-sizing":"border-box",top:`${_}px`,left:`${x}px`,width:`${S}px`,height:`${T}px`,transform:"translate(0, 0)","z-index":String(A??++L),transition:"none",...y?{"background-color":y}:{}},w=Object.keys(u).map(e=>[e,s.style.getPropertyValue(e),s.style.getPropertyPriority(e)]),m=s.getAttribute(r);g.add(s),a=()=>{l!==void 0&&cancelAnimationFrame(l),l=void 0;for(const[e,o,q]of w)s.style.setProperty(e,o,q);m===null?s.removeAttribute(r):s.setAttribute(r,m),a=void 0,g.delete(s),k.value=!1},s.setAttribute(r,"true");for(const[e,o]of Object.entries(u))s.style.setProperty(e,o);s.offsetHeight,s.style.transition=B,l=requestAnimationFrame(()=>{Object.assign(s.style,{top:"0px",left:"0px",width:"100dvw",height:"100dvh"}),l=void 0}),k.value=!0,p==null||p()},v=()=>{k.value?E():F()};return G(()=>{a&&(a(),t==null||t())}),{enter:F,exit:E,toggleFullscreen:v,isFullscreen:O(k)}},W={ref:"preview",class:"ray-demo fullscreen-demo"},J=R({__name:"FullscreenDemo",setup(n){const{isFullscreen:d,toggleFullscreen:i}=X(N("preview"));return(h,p)=>(C(),D("div",W,[b(c($),{onClick:c(i)},{default:V(()=>[Y(M(c(d)?"退出全屏 / Exit full screen":"元素全屏 / Full screen"),1)]),_:1},8,["onClick"])],512))}}),U=z(J,[["__scopeId","data-v-0d48cce2"]]),as=JSON.parse('{"title":"窗口、全屏和日期","description":"","frontmatter":{},"headers":[],"relativePath":"reference/hooks/browser.md","filePath":"reference/hooks/browser.md"}'),Z={name:"reference/hooks/browser.md"},es=Object.assign(Z,{setup(n){return(d,i)=>(C(),D("div",null,[i[0]||(i[0]=f("",6)),b(U),i[1]||(i[1]=f("",10))]))}});export{as as __pageData,es as default};
diff --git a/docs/assets/reference_hooks_interaction.md.Big820ZZ.js b/docs/assets/reference_hooks_interaction.md.Big820ZZ.js
new file mode 100644
index 00000000..2d972b31
--- /dev/null
+++ b/docs/assets/reference_hooks_interaction.md.Big820ZZ.js
@@ -0,0 +1,34 @@
+import{_ as i,o as a,c as n,a3 as t}from"./chunks/framework.BNdm2jZV.js";const o=JSON.parse('{"title":"分页与右键菜单","description":"","frontmatter":{},"headers":[],"relativePath":"reference/hooks/interaction.md","filePath":"reference/hooks/interaction.md"}'),e={name:"reference/hooks/interaction.md"};function h(k,s,l,p,d,r){return a(),n("div",null,[...s[0]||(s[0]=[t(`分页与右键菜单
usePagination(callback?, options?) 返回只读元组 [pagination, actions]。pagination 是可传给 NPagination 或 NDataTable 的响应式配置。缺省页码 1、每页 10 条、开启页大小选择器,候选 [10, 20, 50, 100]。options 接受除主题和原更新回调之外的 Pagination props,另提供 pageChange(page)、pageSizeChange(size)。
| 方法 | 行为 |
|---|
getPage() / setPage(page) | 读取页码,或更新页码并通知。 |
getPageSize() / setPageSize(size) | 更新每页条数后先回到第 1 页,再通知。 |
getItemCount() / setItemCount(count) | 读取或写入条数,无值时读取为 0;写条数不触发请求回调。 |
getPagination() | 读取当前配置对象。 |
getCallback() / setCallback(callback?) | 读取、替换或移除通用回调。 |
resetPagination() | 页码回到 1,每页条数取第一个 pageSizes 的数字或对象 value,没有候选则用 10。 |
页码和页大小更新先改状态,再调用通用 callback,然后通知对应事件。重置同时调用两个专用事件。远端查询建议只在通用回调发请求,避免两次加载。Hook 不会自动请求或裁剪数据,初始加载由页面负责。RTablePro 的 request 已管理分页,通常无需再套一层本 Hook。
tsimport { usePagination } from '@/hooks'
+
+export function useOrdersPagination(
+ load: (page: number, size: number) => void,
+) {
+ const [pagination, actions] = usePagination(
+ () => load(actions.getPage(), actions.getPageSize()),
+ { pageSizes: [10, 20, 50], itemCount: 0 },
+ )
+ return { pagination, actions, loadFirstPage: () => actions.setPage(1) }
+}
useContextmenuCoordinate(target, options?) 接收元素、ref 或 getter。options 可以是捕获布尔值、事件监听选项(含 clickOutside(event)),或这些值的 ref / getter。内部强制使用 passive: false,防止浏览器原生菜单和自定义菜单同时打开。
返回只读 x、y(视口坐标)、show 和 updateShow(value)、stop()。右键发生后,先关闭旧菜单,再在下一次 Vue 更新写入坐标并打开。普通点击、外部点击会关闭菜单;外部点击回调在关闭后执行。菜单项选择后调用 updateShow(false)。stop() 停止所有监听并阻止尚未执行的打开操作,作用域销毁时也会清理。
tsximport { useContextmenuCoordinate } from '@/hooks'
+import { NDropdown } from 'naive-ui'
+import { defineComponent, ref } from 'vue'
+
+export default defineComponent({
+ setup() {
+ const area = ref<HTMLElement>()
+ const { x, y, show, updateShow } = useContextmenuCoordinate(area)
+ return () => (
+ <div ref={area}>
+ 在这里点击鼠标右键
+ <NDropdown
+ trigger="manual"
+ x={x.value}
+ y={y.value}
+ show={show.value}
+ options={[{ key: 'details', label: '详情' }]}
+ onSelect={() => updateShow(false)}
+ onClickoutside={() => updateShow(false)}
+ />
+ </div>
+ )
+ },
+})
源码:usePagination · useContextmenuCoordinate
`,11)])])}const g=i(e,[["render",h]]);export{o as __pageData,g as default};
diff --git a/docs/assets/reference_hooks_interaction.md.Big820ZZ.lean.js b/docs/assets/reference_hooks_interaction.md.Big820ZZ.lean.js
new file mode 100644
index 00000000..fd22c0cd
--- /dev/null
+++ b/docs/assets/reference_hooks_interaction.md.Big820ZZ.lean.js
@@ -0,0 +1 @@
+import{_ as i,o as a,c as n,a3 as t}from"./chunks/framework.BNdm2jZV.js";const o=JSON.parse('{"title":"分页与右键菜单","description":"","frontmatter":{},"headers":[],"relativePath":"reference/hooks/interaction.md","filePath":"reference/hooks/interaction.md"}'),e={name:"reference/hooks/interaction.md"};function h(k,s,l,p,d,r){return a(),n("div",null,[...s[0]||(s[0]=[t("",11)])])}const g=i(e,[["render",h]]);export{o as __pageData,g as default};
diff --git a/docs/assets/reference_hooks_layout.md.BcnUJtrr.js b/docs/assets/reference_hooks_layout.md.BcnUJtrr.js
new file mode 100644
index 00000000..4c61be6c
--- /dev/null
+++ b/docs/assets/reference_hooks_layout.md.BcnUJtrr.js
@@ -0,0 +1,28 @@
+import{_ as i,o as a,c as n,a3 as e}from"./chunks/framework.BNdm2jZV.js";const E=JSON.parse('{"title":"布局与滚动 Hooks","description":"","frontmatter":{},"headers":[],"relativePath":"reference/hooks/layout.md","filePath":"reference/hooks/layout.md"}'),t={name:"reference/hooks/layout.md"};function l(h,s,p,k,r,d){return a(),n("div",null,[...s[0]||(s[0]=[e(`布局与滚动 Hooks
本页 API 操作模板默认布局。替换布局内容或侧栏前,先确认插槽和布局实例仍在预期位置。
useMaximize
useMaximize(defaults?) 返回 isLayoutContentMaximized(isFullscreen 是同一状态的别名)、maximize(full, options?)、toggleFullscreen()。页面、标签菜单和退出按钮共享同一个 Pinia 状态。需要单独放大一个 DOM 元素时,使用 useElementFullscreen。
每次调用的 options 覆盖 defaults。支持 zIndex(默认 999)、backgroundColor、transition、scrollToOptions: { left?, top?, behavior? },以及 beforeEnter、enter、beforeExit、exit。前置回调先执行,完成回调在下一次 Vue 更新后执行,并非 CSS 动画完成事件。进入时可以调整滚动位置。连续切换只执行最新状态的完成回调;切到当前状态时直接返回。
tsimport { useMaximize } from '@/hooks'
+
+export function useReportLayout() {
+ const { isLayoutContentMaximized, maximize } = useMaximize()
+ const expand = () => maximize(true, { scrollToOptions: { top: 0 } })
+ return { expand, collapse: () => maximize(false), isLayoutContentMaximized }
+}
useSpinning
| 返回方法 | 用途 |
|---|
openSpin() / closeSpin() | 开关布局内容区的加载动画,不改变应用全局 Spin。 |
reload(wait?) | 卸载当前内容后重新挂载,缺省等待 800ms。 |
只想表示请求未完成时使用 Spin,并在 finally 关闭。reload 会丢失当前页面未持久化的本地状态;多次重载时,Runtime Store 只保留最后一次恢复计时。
tsimport { useSpinning } from '@/hooks'
+
+export function useLoadWithSpinner() {
+ const { openSpin, closeSpin } = useSpinning()
+ return async <T>(load: () => Promise<T>) => {
+ openSpin()
+ try {
+ return await load()
+ } finally {
+ closeSpin()
+ }
+ }
+}
useContentScroll
useContentScroll() 直接返回 scrollTo 函数。可传 (x, y?) 或 { top, left, behavior },例如 scrollContent({ top: 0, behavior: 'smooth' })。调用时读取 LAYOUT_CONTENT_REF,所以可以在 setup 创建,在事件触发时使用。没有挂载布局实例时不执行。
useSiderScroll() 返回同签名的函数,操作 LAYOUT_SIDER_REF。顶部模式、未挂载或侧栏已卸载时安全忽略。它滚动侧栏容器,不改变菜单选中项。
tsimport { useContentScroll, useSiderScroll } from '@/hooks'
+
+export function useScrollShortcuts() {
+ const scrollContent = useContentScroll()
+ const scrollSider = useSiderScroll()
+ return {
+ toTop: () => scrollContent(0, 0),
+ toMenuTop: () => scrollSider(0, 0),
+ }
+}
源码:useMaximize · useSpinning · useContentScroll · useSiderScroll
`,16)])])}const c=i(t,[["render",l]]);export{E as __pageData,c as default};
diff --git a/docs/assets/reference_hooks_layout.md.BcnUJtrr.lean.js b/docs/assets/reference_hooks_layout.md.BcnUJtrr.lean.js
new file mode 100644
index 00000000..f03d30d7
--- /dev/null
+++ b/docs/assets/reference_hooks_layout.md.BcnUJtrr.lean.js
@@ -0,0 +1 @@
+import{_ as i,o as a,c as n,a3 as e}from"./chunks/framework.BNdm2jZV.js";const E=JSON.parse('{"title":"布局与滚动 Hooks","description":"","frontmatter":{},"headers":[],"relativePath":"reference/hooks/layout.md","filePath":"reference/hooks/layout.md"}'),t={name:"reference/hooks/layout.md"};function l(h,s,p,k,r,d){return a(),n("div",null,[...s[0]||(s[0]=[e("",16)])])}const c=i(t,[["render",l]]);export{E as __pageData,c as default};
diff --git a/docs/assets/reference_hooks_navigation.md.CGGlTsKj.js b/docs/assets/reference_hooks_navigation.md.CGGlTsKj.js
new file mode 100644
index 00000000..80f6e95e
--- /dev/null
+++ b/docs/assets/reference_hooks_navigation.md.CGGlTsKj.js
@@ -0,0 +1,33 @@
+import{_ as i,o as a,c as t,a3 as e}from"./chunks/framework.BNdm2jZV.js";const g=JSON.parse('{"title":"导航与菜单","description":"","frontmatter":{},"headers":[],"relativePath":"reference/hooks/navigation.md","filePath":"reference/hooks/navigation.md"}'),n={name:"reference/hooks/navigation.md"};function h(p,s,l,k,d,r){return a(),t("div",null,[...s[0]||(s[0]=[e(`导航与菜单
从 @/hooks 导入本页 API。菜单来源、权限和路由记录见路由指南。
useVueRouter
useVueRouter() 返回 { router },指向模板的共享 Vue Router 实例。当前路由用 router.currentRoute.value 读取,push、replace、back 等行为由 Vue Router 提供。它可在 setup 外取得实例。初始化后再访问依赖实际路由匹配的状态。
tsimport { useVueRouter } from '@/hooks'
+
+export const readQuery = () => useVueRouter().router.currentRoute.value.query
useAppNavigation
useAppNavigation().navigationTo(target, options?) 支持三类目标:
| target | 行为 |
|---|
| 完整路径字符串 | 先用 Router 解析,保留动态路径、query 和 hash。未匹配或只匹配兜底路由时返回 undefined。 |
AppMenuOption | 按 fullPath 导航。 |
| 从 0 开始的整数 | 从当前菜单取项,遇到父菜单沿第一个子项查到叶子。菜单需要先初始化。 |
NavigationToOptions.isPush 默认 true;设为 false 使用 router.replace。query 可覆盖字符串路径中的同名查询参数。成功发起时返回 Router Promise。负数、小数、非有限数和越界索引不会导航;实际结果仍受路由守卫影响。
tsimport { useAppNavigation } from '@/hooks'
+
+export function useTableNavigation() {
+ const { navigationTo } = useAppNavigation()
+ return () =>
+ navigationTo('/tables/remote?tab=people', {
+ isPush: false,
+ query: { tab: 'orders' },
+ })
+}
useAppRoot
getRootRoute、getRootPath、getRootName 是计算引用。setRootRoute({ name?, path? }) 与当前首页信息合并并更新设置,不会当场导航。给首页使用已注册的完整路径,路径和名称一起更新,确保目标页有访问权限。启动时校验首页路径是否在 Router 中。
tsimport { useAppRoot } from '@/hooks'
+
+export function useResetHome() {
+ const { getRootPath, setRootRoute } = useAppRoot()
+ const reset = () => setRootRoute({ name: 'Dashboard', path: '/dashboard' })
+ return { getRootPath, reset }
+}
useSiderBar
操作工作区的标签页。接受 CloseMenuTag 的方法可传从 0 开始的索引、与标签 fullPath 匹配的字符串或标签对象。
| 方法 | 行为 |
|---|
getCurrentTagIndex() | 当前标签索引;找不到返回 -1。 |
checkCloseLeft(target) / checkCloseRight(target) | 检查目标对应方向是否有标签可关。 |
close(target) | 关闭一个标签。最后一个标签保留。关闭激活项时切到相邻项。 |
closeLeft(target) / closeRight(target) | 关闭目标左侧或右侧标签。需要时切换至目标。 |
closeOther(target) | 只保留目标并激活。 |
closeAll() | 在首页路由存在时清空标签并重新激活首页。 |
不要在存在未保存表单的工作流里直接调用批量关闭;这些方法不会替业务处理未保存确认。
tsimport { useSiderBar } from '@/hooks'
+
+export function useCloseActiveTag() {
+ const { close, getCurrentTagIndex } = useSiderBar()
+ return () => {
+ const index = getCurrentTagIndex()
+ if (index >= 0) close(index)
+ }
+}
useBadge
目标接受菜单的 fullPath 或 AppMenuOption。show(target, options?) 合并配置并显示,hidden(target) 保留原配置并隐藏,update(target, options) 只更新给出的字段。菜单未加载或未找到时不会添加标记。
AppMenuExtraOptions 支持 label(字符串或数字)、i18nLabel(翻译键)、icon(VNode)、type(Naive UI Tag 类型)、show(显隐)。使用翻译键时同步维护语言包。
tsimport { useBadge } from '@/hooks'
+
+export function useUnreadBadge() {
+ const { show, hidden } = useBadge()
+ const path = '/tables/remote'
+ return (count: number) =>
+ count > 0 ? show(path, { label: count, type: 'info' }) : hidden(path)
+}
源码:useAppNavigation · useAppRoot · useSiderBar · useBadge · useVueRouter
`,23)])])}const E=i(n,[["render",h]]);export{g as __pageData,E as default};
diff --git a/docs/assets/reference_hooks_navigation.md.CGGlTsKj.lean.js b/docs/assets/reference_hooks_navigation.md.CGGlTsKj.lean.js
new file mode 100644
index 00000000..84eeec5b
--- /dev/null
+++ b/docs/assets/reference_hooks_navigation.md.CGGlTsKj.lean.js
@@ -0,0 +1 @@
+import{_ as i,o as a,c as t,a3 as e}from"./chunks/framework.BNdm2jZV.js";const g=JSON.parse('{"title":"导航与菜单","description":"","frontmatter":{},"headers":[],"relativePath":"reference/hooks/navigation.md","filePath":"reference/hooks/navigation.md"}'),n={name:"reference/hooks/navigation.md"};function h(p,s,l,k,d,r){return a(),t("div",null,[...s[0]||(s[0]=[e("",23)])])}const E=i(n,[["render",h]]);export{g as __pageData,E as default};
diff --git a/docs/assets/reference_hooks_output.md.B8QXZTOo.js b/docs/assets/reference_hooks_output.md.B8QXZTOo.js
new file mode 100644
index 00000000..9f099210
--- /dev/null
+++ b/docs/assets/reference_hooks_output.md.B8QXZTOo.js
@@ -0,0 +1,22 @@
+import{_ as i,o as a,c as e,a3 as t}from"./chunks/framework.BNdm2jZV.js";const c=JSON.parse('{"title":"DOM 截图与打印","description":"","frontmatter":{},"headers":[],"relativePath":"reference/hooks/output.md","filePath":"reference/hooks/output.md"}'),n={name:"reference/hooks/output.md"};function p(l,s,h,k,r,d){return a(),e("div",null,[...s[0]||(s[0]=[t(`DOM 截图与打印
useDomToImage
useDomToImage(target, options?) 返回 create(format?)。调用时从元素、ref 或 getter 解析目标,缺省格式为 jpeg,options.imageType 设置默认值,单次 create(format) 优先。Promise 按格式推断返回值:
| 格式 | 返回 |
|---|
jpeg、png、svg | 数据 URL 字符串。 |
blob | Blob | null。 |
canvas | HTMLCanvasElement。 |
pixelData | Uint8ClampedArray。 |
options 也可传 html-to-image 的选项,如 backgroundColor、pixelRatio、filter。beforeCreate(element) 在目标检查前调用,created(result, element) 在成功后调用;回调的结果类型涵盖全部格式,应先检查类型。createdError(error) 接收错误,Promise 仍以 Error 拒绝;finally(element) 每次都会调用,目标未解析时可能为空。截图要在目标挂载后执行,跨域图片和字体需满足浏览器加载限制。
tsimport { useDomToImage } from '@/hooks'
+import { ref } from 'vue'
+
+export function useReportImage() {
+ const report = ref<HTMLElement>()
+ const { create } = useDomToImage(report, { imageType: 'png', pixelRatio: 2 })
+ return {
+ report,
+ exportPng: () => create(),
+ exportCanvas: () => create('canvas'),
+ }
+}
usePrint
usePrint(target, options?) 返回 print(),调用时解包目标。接受 DOM 目标、URL 或字符串、Blob、Uint8ClampedArray、对象数组。UsePrintOptions 是 print-js 配置中除 printable 外的字段。
- DOM 默认以
html 打印。字符串默认按 pdf 处理;图片 URL、JSON 数组请分别指定 type: 'image'、type: 'json'(JSON 同时传 properties)。 - 图片 MIME 的 Blob 默认以
image 处理,其他 Blob 和字节数组默认以 pdf 处理。二进制目标会先异步转为数据 URL,PDF 会去掉数据 URL 前缀。 - 空目标或空字符串直接返回。DOM 等同步分支返回
void,二进制转换分支返回 Promise;统一使用 await print() 可以捕获转换错误。成功发起打印流程无法确认纸张输出。
tsimport { usePrint } from '@/hooks'
+import { ref } from 'vue'
+
+export function useReportPrint() {
+ const report = ref<HTMLElement>()
+ const { print } = usePrint(report, {
+ type: 'html',
+ documentTitle: '库存报表',
+ })
+ return { report, print }
+}
TablePro 内置打印按当前页和可见列生成报表。要保留自定义业务排版,参考 TablePro 打印。
源码:useDomToImage · usePrint
`,12)])])}const E=i(n,[["render",p]]);export{c as __pageData,E as default};
diff --git a/docs/assets/reference_hooks_output.md.B8QXZTOo.lean.js b/docs/assets/reference_hooks_output.md.B8QXZTOo.lean.js
new file mode 100644
index 00000000..326ea2f6
--- /dev/null
+++ b/docs/assets/reference_hooks_output.md.B8QXZTOo.lean.js
@@ -0,0 +1 @@
+import{_ as i,o as a,c as e,a3 as t}from"./chunks/framework.BNdm2jZV.js";const c=JSON.parse('{"title":"DOM 截图与打印","description":"","frontmatter":{},"headers":[],"relativePath":"reference/hooks/output.md","filePath":"reference/hooks/output.md"}'),n={name:"reference/hooks/output.md"};function p(l,s,h,k,r,d){return a(),e("div",null,[...s[0]||(s[0]=[t("",12)])])}const E=i(n,[["render",p]]);export{c as __pageData,E as default};
diff --git a/docs/assets/reference_icons.md.lwCUuJHp.js b/docs/assets/reference_icons.md.lwCUuJHp.js
new file mode 100644
index 00000000..2e1eadbf
--- /dev/null
+++ b/docs/assets/reference_icons.md.lwCUuJHp.js
@@ -0,0 +1,6 @@
+import{_ as e,o as a,c as t,a3 as i}from"./chunks/framework.BNdm2jZV.js";const k=JSON.parse('{"title":"SVG 图标","description":"","frontmatter":{},"headers":[],"relativePath":"reference/icons.md","filePath":"reference/icons.md"}'),d={name:"reference/icons.md"};function o(n,s,c,r,h,p){return a(),t("div",null,[...s[0]||(s[0]=[i(`SVG 图标
tsximport type { IconName } from '@ray-template/icons'
+import { RIcon } from '@ray-template/ui/icon'
+
+const name: IconName = 'directional/resize_h'
+
+const renderIcon = () => <RIcon name={name} size={24} />
RIcon.name 和路由 meta.icon 使用同一套完整分包名。将 SVG 加入 packages/icons/src/<分包>,例如 packages/icons/src/business/orders/approved.svg 对应 business/orders/approved。可在演示的 SVG 图标页面查找并复制用法。
添加和生成
- 选择现有分包(如
action、navigation、system),或按业务新建分包。路径段使用小写字母、数字、下划线或连字符,且以字母开头。 - 单色图标用
currentColor,留白用 none。品牌和插画保留原色。 - 开发服务或
pnpm icons:generate 更新 packages/icons/src/manifest.ts;检查 pnpm icons:check,与 SVG 一起提交。不要手改联合类型。
生产时每个顶层分包生成独立、带 hash 的雪碧图,资源随部署 base 加载。迁移时直接改旧代码的裸名称;旧缓存仅当文件名唯一时自动转换。
图标流程与分包表
RIcon API
RIcon、IconProps、iconProps、IconName 和 IconPackage 从 @/components 导出。也可从 @/icons 导入图标类型。
| 属性 | 默认 | 说明 |
|---|
name | 必填 | 完整的分包路径,首段用于选择雪碧图。 |
size | 14 | 基础宽高,数字按像素,也可传 CSS 尺寸。 |
width / height | 0 / 0 | 分别覆盖基础尺寸,0 回退到 size。 |
color | 'currentColor' | SVG 填充色;带原色的品牌和插画不会全部被覆盖。 |
prefix | 'icon' | symbol 前缀,须与生成配置一致。 |
customClassName | 无 | 根元素的额外类名。 |
depth | 1 | 图标透明层级。 |
cursor | 'default' | 指针样式。 |
onClick(event) | 无 | 支持函数或回调数组。 |
图标内部 SVG 对读屏隐藏。如果用图标触发操作,把它放进具有可访问名称的按钮内,保留键盘操作和焦点。
RIcon Props · 雪碧图引用实现
`,12)])])}const g=e(d,[["render",o]]);export{k as __pageData,g as default};
diff --git a/docs/assets/reference_icons.md.lwCUuJHp.lean.js b/docs/assets/reference_icons.md.lwCUuJHp.lean.js
new file mode 100644
index 00000000..461df0bd
--- /dev/null
+++ b/docs/assets/reference_icons.md.lwCUuJHp.lean.js
@@ -0,0 +1 @@
+import{_ as e,o as a,c as t,a3 as i}from"./chunks/framework.BNdm2jZV.js";const k=JSON.parse('{"title":"SVG 图标","description":"","frontmatter":{},"headers":[],"relativePath":"reference/icons.md","filePath":"reference/icons.md"}'),d={name:"reference/icons.md"};function o(n,s,c,r,h,p){return a(),t("div",null,[...s[0]||(s[0]=[i("",12)])])}const g=e(d,[["render",o]]);export{k as __pageData,g as default};
diff --git a/docs/assets/reference_index.md.DRoeAVBG.js b/docs/assets/reference_index.md.DRoeAVBG.js
new file mode 100644
index 00000000..bddf4608
--- /dev/null
+++ b/docs/assets/reference_index.md.DRoeAVBG.js
@@ -0,0 +1 @@
+import{_ as e,o as r,c as a,a3 as d}from"./chunks/framework.BNdm2jZV.js";const m=JSON.parse('{"title":"API 参考","description":"","frontmatter":{},"headers":[],"relativePath":"reference/index.md","filePath":"reference/index.md"}'),o={name:"reference/index.md"};function n(h,t,i,c,s,l){return r(),a("div",null,[...t[0]||(t[0]=[d('API 参考
这里按调用入口组织。首次开发页面可以从开发指南走一遍,查具体 API 时从下列索引进入。
| 领域 | 内容 |
|---|
| 组件 | 通用组件、属性、事件、插槽、实例方法和 Provider |
| Hooks | 导航、状态、分页、浏览器能力及副作用边界 |
| 指令 | 绑定值、修饰符、更新和卸载规则 |
| Store | 状态字段、Getter、Action 和持久化契约 |
| 工具函数 | 类型、数值、DOM、文件和缓存 |
| SVG 图标 | 图标路径、类型生成和 RIcon |
| 应用配置 | 主题、路由、国际化、请求和构建入口 |
各页以文档标明的源码版本为准。示例假设已在 Ray Template 项目中使用 @ 别名和默认应用上下文。
',4)])])}const _=e(o,[["render",n]]);export{m as __pageData,_ as default};
diff --git a/docs/assets/reference_index.md.DRoeAVBG.lean.js b/docs/assets/reference_index.md.DRoeAVBG.lean.js
new file mode 100644
index 00000000..4fb6a5ec
--- /dev/null
+++ b/docs/assets/reference_index.md.DRoeAVBG.lean.js
@@ -0,0 +1 @@
+import{_ as e,o as r,c as a,a3 as d}from"./chunks/framework.BNdm2jZV.js";const m=JSON.parse('{"title":"API 参考","description":"","frontmatter":{},"headers":[],"relativePath":"reference/index.md","filePath":"reference/index.md"}'),o={name:"reference/index.md"};function n(h,t,i,c,s,l){return r(),a("div",null,[...t[0]||(t[0]=[d("",4)])])}const _=e(o,[["render",n]]);export{m as __pageData,_ as default};
diff --git a/docs/assets/reference_source.md.M6GWIIfO.js b/docs/assets/reference_source.md.M6GWIIfO.js
new file mode 100644
index 00000000..3eca4233
--- /dev/null
+++ b/docs/assets/reference_source.md.M6GWIIfO.js
@@ -0,0 +1 @@
+import{_ as t,o as a,c as r,a3 as o}from"./chunks/framework.BNdm2jZV.js";const p=JSON.parse('{"title":"文档与源码版本","description":"","frontmatter":{},"headers":[],"relativePath":"reference/source.md","filePath":"reference/source.md"}'),n={name:"reference/source.md"};function d(i,e,s,l,c,h){return a(),r("div",null,[...e[0]||(e[0]=[o('文档与源码版本
本站面向 Ray Template 6.0.0。Ray Admin、文档示例和共享包位于同一仓库。页内示例使用构建时同一工作区的包,发布构建的源码链接指向对应提交。
源码版本号、Git 标签和网站部署各有进度。需要重现行为时,请记录具体标签或提交。报告问题时请注明使用的是 v5 还是 v6,并附上页面或模块入口。问题反馈
',4)])])}const m=t(n,[["render",d]]);export{p as __pageData,m as default};
diff --git a/docs/assets/reference_source.md.M6GWIIfO.lean.js b/docs/assets/reference_source.md.M6GWIIfO.lean.js
new file mode 100644
index 00000000..0edbb146
--- /dev/null
+++ b/docs/assets/reference_source.md.M6GWIIfO.lean.js
@@ -0,0 +1 @@
+import{_ as t,o as a,c as r,a3 as o}from"./chunks/framework.BNdm2jZV.js";const p=JSON.parse('{"title":"文档与源码版本","description":"","frontmatter":{},"headers":[],"relativePath":"reference/source.md","filePath":"reference/source.md"}'),n={name:"reference/source.md"};function d(i,e,s,l,c,h){return a(),r("div",null,[...e[0]||(e[0]=[o("",4)])])}const m=t(n,[["render",d]]);export{p as __pageData,m as default};
diff --git a/docs/assets/reference_store.md.BykMC8BP.js b/docs/assets/reference_store.md.BykMC8BP.js
new file mode 100644
index 00000000..e25d0e80
--- /dev/null
+++ b/docs/assets/reference_store.md.BykMC8BP.js
@@ -0,0 +1 @@
+import{_ as t,o,c as r,a3 as d}from"./chunks/framework.BNdm2jZV.js";const h=JSON.parse('{"title":"Store","description":"","frontmatter":{},"headers":[],"relativePath":"reference/store.md","filePath":"reference/store.md"}'),a={name:"reference/store.md"};function s(c,e,n,i,p,l){return o(),r("div",null,[...e[0]||(e[0]=[d('Store
模板使用 Pinia 管理跨页面状态。业务代码从 @/store 导入相应的 Getters / Actions,读取引用用 .value,修改走动作。只属于一个组件或页面的状态可以继续用本地 ref。
| Store | 访问入口 | 持久化 |
|---|
| Setting | useSettingGetters / useSettingActions | Local Storage piniaSettingStore,排除锁屏设置弹窗显隐;当前语言另外保存。 |
| Menu | useMenuGetters / useMenuActions | Local Storage 保存当前菜单和折叠状态;标签列表另存 Session Storage。 |
| KeepAlive | useKeepAliveGetters / useKeepAliveActions | Session Storage 保存可缓存组件名。 |
| Runtime | useRuntimeGetters / useRuntimeActions | 无;随当前 Pinia 实例释放。 |
| Lock Screen | useLockScreenGetters / useLockScreenActions | Local Storage 的历史布尔值,支持跨标签同步。 |
| Signing | useSigningGetters / useSigningActions | Local Storage 持久化账号显示信息,路由守卫另读 token。 |
初始化与扩展
setupStore(app) 安装 Pinia 与持久化插件,应用卸载时释放 Pinia 实例及作用域。模板入口已调用,业务代码无需再次注册。Menu 与 Signing 依赖 Router 注入,请在应用组件的有效 setup 中访问。
新增 Store 在 apps/admin/src/store/modules 按领域建目录并指定唯一 ID。需要持久化时使用 pick 或 omit,选定存储范围和稳定的 key,只保存可序列化的值。调用接口放到 apps/admin/src/store/hooks,再由 apps/admin/src/store/index.ts 导出。原始 pinia…Store 同样公开给模板内部,但页面使用 hooks 可以减少对实现字段的直接依赖。
缓存键和 JSON 结构是已有数据契约。换 key、拆字段或改变序列化格式时,要考虑旧数据的读取、迁移和回退。浏览器缓存不应保存服务端密钥。
初始化与公开导出 · Store 源码约定
',8)])])}const m=t(a,[["render",s]]);export{h as __pageData,m as default};
diff --git a/docs/assets/reference_store.md.BykMC8BP.lean.js b/docs/assets/reference_store.md.BykMC8BP.lean.js
new file mode 100644
index 00000000..c7e6eca7
--- /dev/null
+++ b/docs/assets/reference_store.md.BykMC8BP.lean.js
@@ -0,0 +1 @@
+import{_ as t,o,c as r,a3 as d}from"./chunks/framework.BNdm2jZV.js";const h=JSON.parse('{"title":"Store","description":"","frontmatter":{},"headers":[],"relativePath":"reference/store.md","filePath":"reference/store.md"}'),a={name:"reference/store.md"};function s(c,e,n,i,p,l){return o(),r("div",null,[...e[0]||(e[0]=[d("",8)])])}const m=t(a,[["render",s]]);export{h as __pageData,m as default};
diff --git a/docs/assets/reference_store_navigation.md.BBSrn9C3.js b/docs/assets/reference_store_navigation.md.BBSrn9C3.js
new file mode 100644
index 00000000..613311ef
--- /dev/null
+++ b/docs/assets/reference_store_navigation.md.BBSrn9C3.js
@@ -0,0 +1,7 @@
+import{_ as t,o as a,c as s,a3 as i}from"./chunks/framework.BNdm2jZV.js";const k=JSON.parse('{"title":"Menu 与 KeepAlive Store","description":"","frontmatter":{},"headers":[],"relativePath":"reference/store/navigation.md","filePath":"reference/store/navigation.md"}'),n={name:"reference/store/navigation.md"};function d(o,e,r,l,p,h){return a(),s("div",null,[...e[0]||(e[0]=[i(`路由模块转换成菜单树。Menu Store 负责选中项、标签、面包屑和导航联动,业务页面通常使用 useAppNavigation 或 useSiderBar。
| Getter | 返回的计算引用 |
|---|
getMenuOptions | 应用菜单树,包含子项。显示逻辑还会使用路由元数据。 |
getBreadcrumbOptions | 当前面包屑项。 |
getMenuKey | 当前菜单 key,通常取完整路径。 |
getMenuTagOptions | 工作区标签列表。 |
getCurrentMenuOption | 当前激活菜单项,初始可能为空。 |
getCollapsed | 侧栏是否折叠。 |
| Action | 行为 |
|---|
setupAppMenu() | 从已知路由重建菜单、标签与标题,返回 Promise<void>。模板会在路由联动首次运行时初始化。 |
resolveOption(option) | 把路由形状转成菜单项。调用方须提供正确的 fullPath,用于 key 和查找。 |
changeMenuModelValue(key, option, query?) | 导航并同步状态;meta.windowOpen 分支打开外部页面。sameLevel 会保留原菜单标签并补面包屑。 |
collapsedMenu(collapsed) | 更新折叠状态。 |
setMenuTagOptions(options, isAppend = true) | 追加或替换标签,参数可为单项或数组。 |
spliceMenTagOptions(idx, length = 1) | 按索引删除标签,拼写保留历史契约。 |
updateMenuState(key, value, callback?) | 更新已有状态字段,普通对象浅合并。需要跨字段联动时使用上述动作。 |
depthSearchAppMenu(options, key) 从菜单树按完整路径查找菜单项。changeMenuModelValue 不返回 Router 的导航 Promise;需要等待守卫结果时使用 Router 或 navigationTo。更新角色后还要同步服务端授权及直接路由校验,菜单过滤本身不能授权。
piniaMenuStore 在 Local Storage 只持久化 menuKey、collapsed。标签列表单独使用 Session Storage 的 appMenuTagOptions。当前路由变化会重新同步菜单与面包屑,避免手工写缓存制造冲突。
KeepAlive Store
useKeepAliveGetters().getKeepAliveInclude 是缓存名称数组的计算引用。useKeepAliveActions() 提供 getKeepAliveInclude() 读队列、setKeepAliveInclude(option) 按路由选项加入名称。仅处理 meta.keepAlive 的页面,达到上限时先移除最早的名称再追加当前名称。实际缓存由 RTransitionComponent 渲染。
- 路由
name 必须和页面组件名一致,否则 include 无法匹配。 - Store 只在当前浏览器标签的 Session Storage 持久化名称。刷新后组件实例与表单状态重新创建。
- 开关、排除名称和数量在 Setting Store 的
keepAliveConfig 配置。确认嵌套路由和 query 变化后,测试切回标签的结果。
tsimport { useKeepAliveGetters, useMenuGetters } from '@/store'
+
+export function useNavigationSummary() {
+ const { getMenuKey, getMenuTagOptions } = useMenuGetters()
+ const { getKeepAliveInclude } = useKeepAliveGetters()
+ return { getMenuKey, getMenuTagOptions, getKeepAliveInclude }
+}
Menu 实现 · Menu Hooks · KeepAlive 实现
`,12)])])}const u=t(n,[["render",d]]);export{k as __pageData,u as default};
diff --git a/docs/assets/reference_store_navigation.md.BBSrn9C3.lean.js b/docs/assets/reference_store_navigation.md.BBSrn9C3.lean.js
new file mode 100644
index 00000000..877285c2
--- /dev/null
+++ b/docs/assets/reference_store_navigation.md.BBSrn9C3.lean.js
@@ -0,0 +1 @@
+import{_ as t,o as a,c as s,a3 as i}from"./chunks/framework.BNdm2jZV.js";const k=JSON.parse('{"title":"Menu 与 KeepAlive Store","description":"","frontmatter":{},"headers":[],"relativePath":"reference/store/navigation.md","filePath":"reference/store/navigation.md"}'),n={name:"reference/store/navigation.md"};function d(o,e,r,l,p,h){return a(),s("div",null,[...e[0]||(e[0]=[i("",12)])])}const u=t(n,[["render",d]]);export{k as __pageData,u as default};
diff --git a/docs/assets/reference_store_runtime.md.DN1nqjBy.js b/docs/assets/reference_store_runtime.md.DN1nqjBy.js
new file mode 100644
index 00000000..17f89419
--- /dev/null
+++ b/docs/assets/reference_store_runtime.md.DN1nqjBy.js
@@ -0,0 +1,13 @@
+import{_ as i,o as e,c as t,a3 as a}from"./chunks/framework.BNdm2jZV.js";const c=JSON.parse('{"title":"Runtime 与 Lock Screen Store","description":"","frontmatter":{},"headers":[],"relativePath":"reference/store/runtime.md","filePath":"reference/store/runtime.md"}'),n={name:"reference/store/runtime.md"};function l(d,s,r,h,p,k){return e(),t("div",null,[...s[0]||(s[0]=[a(`Runtime 与 Lock Screen Store
Runtime Store
useRuntimeGetters() 提供只读 ref;useRuntimeActions() 返回 setRuntimeState(key, value)、reloadContent(wait = 800)。这些 UI 状态不持久化。
| 字段 | 默认 | 用途 |
|---|
globalSpinning | false | 全局 Spin。 |
globalDrawerValue | false | 窄屏菜单抽屉。 |
globalMainLayoutLoad | true | 默认布局是否挂载页面内容。 |
layoutContentMaximize | false | 工作区最大化。 |
layoutContentMaximizeVersion | 0 | 最大化状态变动序号,用于过滤过期回调,业务代码不直接更新。 |
layoutContentSpinning | false | 布局内容区 Spin。 |
layoutContentMaximizeStyle | { zIndex: 999 } | 最大化的层级、背景、过渡样式。 |
reloadContent 暂时卸载当前内容并等待恢复;多次调用只保留最后一个计时,Store 卸载时清理计时。useSpinning().reload() 是同一动作。控制最大化时用 useMaximize 来保留回调和退出逻辑。全局 Spin 和内容 Spin 互相独立。
tsimport { useRuntimeActions } from '@/store'
+
+export function useGlobalLoading() {
+ const { setRuntimeState } = useRuntimeActions()
+ return async <T>(task: () => Promise<T>) => {
+ setRuntimeState('globalSpinning', true)
+ try {
+ return await task()
+ } finally {
+ setRuntimeState('globalSpinning', false)
+ }
+ }
+}
全局状态是布尔值,不对并发任务计数。如果多个独立请求同时使用,先由调用方统一协调开关。
Lock Screen Store
useLockScreenGetters().getLocked 是实际锁屏状态。useLockScreenActions().setLocked(value) 写入同一个状态,默认 false,通过 isAppLockScreen 在 Local Storage 保存历史布尔格式并跨标签同步。
实际锁定与 setting.lockScreenSwitch 分开,后者只控制锁屏设置弹窗。默认锁屏组件处理本地口令和解锁逻辑;业务按钮应打开设置弹窗,直接写锁定布尔值不会为用户建立口令。它是本机界面遮挡,与服务端会话和授权独立。
Runtime 实现 · Lock Screen 实现 · 锁屏流程
`,11)])])}const E=i(n,[["render",l]]);export{c as __pageData,E as default};
diff --git a/docs/assets/reference_store_runtime.md.DN1nqjBy.lean.js b/docs/assets/reference_store_runtime.md.DN1nqjBy.lean.js
new file mode 100644
index 00000000..cdf98f13
--- /dev/null
+++ b/docs/assets/reference_store_runtime.md.DN1nqjBy.lean.js
@@ -0,0 +1 @@
+import{_ as i,o as e,c as t,a3 as a}from"./chunks/framework.BNdm2jZV.js";const c=JSON.parse('{"title":"Runtime 与 Lock Screen Store","description":"","frontmatter":{},"headers":[],"relativePath":"reference/store/runtime.md","filePath":"reference/store/runtime.md"}'),n={name:"reference/store/runtime.md"};function l(d,s,r,h,p,k){return e(),t("div",null,[...s[0]||(s[0]=[a("",11)])])}const E=i(n,[["render",l]]);export{c as __pageData,E as default};
diff --git a/docs/assets/reference_store_setting.md.CB2Icw7k.js b/docs/assets/reference_store_setting.md.CB2Icw7k.js
new file mode 100644
index 00000000..b554f098
--- /dev/null
+++ b/docs/assets/reference_store_setting.md.CB2Icw7k.js
@@ -0,0 +1,13 @@
+import{_ as t,o as s,c as a,a3 as i}from"./chunks/framework.BNdm2jZV.js";const k=JSON.parse('{"title":"Setting Store","description":"","frontmatter":{},"headers":[],"relativePath":"reference/store/setting.md","filePath":"reference/store/setting.md"}'),d={name:"reference/store/setting.md"};function o(n,e,c,r,h,l){return s(),a("div",null,[...e[0]||(e[0]=[i(`Setting Store
useSettingGetters() 返回计算引用,useSettingActions() 修改偏好及相关副作用。设置会在刷新后恢复。运行中切换时优先用已提供的动作,避免 UI、日期语言或 HTML 样式不同步。
Getters
| Getter | 字段与默认行为 |
|---|
getLayoutConfig | layoutConfig,布局模式和工作区尺寸,见下表。 |
getDrawerPlacement | drawerPlacement,设置抽屉方向,默认 right。 |
getPrimaryColorOverride | primaryColorOverride,Naive UI 主题覆盖;默认主色 #3b63d9。 |
getAppTheme / getAppThemeStr | _appTheme 为实际深色布尔值,appTheme 为 light/dark/auto 模式,初始 light。 |
getLocaleLanguage | localeLanguage,应用语言,默认读取历史值或系统默认配置。 |
getMenuTagSwitch / getBreadcrumbSwitch | menuTagSwitch / breadcrumbSwitch,默认显示标签和面包屑。 |
getLockScreenSwitch | lockScreenSwitch,锁屏设置弹窗显隐,默认关,不持久化。 |
getCopyrightSwitch | copyrightSwitch,默认显示版权区。 |
getContentTransition | contentTransition,路由切换动画,默认 scale。 |
getWatermarkSwitch / getWatermarkConfig | watermarkSwitch 默认关;配置包含文字、字体大小、行高、宽高、偏移、间隔、旋转和 cross。 |
getAppRootRoute | appRootRoute,默认 { name: 'Dashboard', path: '/dashboard' }。 |
getSideBarLogo | sideBarLogo,icon、title、url、jumpType。默认 logo/ray,站内跳转到仪表盘。 |
getKeepAliveConfig | keepAliveConfig,默认开启、最多 10 个、排除列表为空。 |
getMenuConfig | menuConfig,侧栏、折叠、图标、手风琴与滚动配置。 |
getColorWeakness / getDynamicDocumentTitle | colorWeakness 默认关,dynamicDocumentTitle 默认开。 |
layoutConfig 的 mode 为 side(默认)、top、mixed。contentWidth 默认 fluid,也可取 fixed。contentMaxWidth 默认 1200,限制在 640–2560;contentPadding 默认 16,限制在 0–48;fixedHeader、fixedFooter 默认开启。旧缓存水合时补齐字段并规范化范围。
menuConfig 默认菜单宽 272、折叠宽 64、普通和折叠图标均为 16、缩进 24。collapsedMode 默认 width,transform 模式改变位置;accordion、inverted、nativeScrollbar 默认关,menuSiderBarLogo 默认开。sideBarLogo.jumpType 用 station 站内跳转或 outsideStation 打开外部地址,未传 url 时不跳转。缓存中的旧裸图标名会尝试映射成完整名称;需要持久化的 Logo 建议用图标名字符串,VNode 不适合作为缓存值。
Actions
| 方法 | 行为 |
|---|
updateSettingState(key, value, callback?) | 更新已有字段。普通对象浅合并;layoutConfig 额外做格式与范围校验。成功后调用可选回调。 |
updateLocale(key) | 更新 Vue I18n、Day.js、语言缓存和 Store,Naive UI 从 Store 同步语言。 |
changePrimaryColor(value, alpha = 0.85) | 更新 Naive UI 主色、hover/pressed/supplement 和 HTML CSS 变量。 |
toggleColorWeakness(bool) | 更新设置并切换 HTML 反色滤镜。 |
切换主题使用 useTheme,切换首页使用 useAppRoot。修改嵌套配置时传入完整的下一级对象,浅合并不会递归保存更深层字段。
tsimport { useSettingActions, useSettingGetters } from '@/store'
+
+export function useCompactWorkspace() {
+ const { getLayoutConfig } = useSettingGetters()
+ const { updateSettingState } = useSettingActions()
+ const apply = () =>
+ updateSettingState('layoutConfig', {
+ mode: 'mixed',
+ contentWidth: 'fixed',
+ contentMaxWidth: 1200,
+ })
+ return { config: getLayoutConfig, apply }
+}
Getters 与 Actions · 状态类型 · 默认配置 · 持久化实现
`,11)])])}const g=t(d,[["render",o]]);export{k as __pageData,g as default};
diff --git a/docs/assets/reference_store_setting.md.CB2Icw7k.lean.js b/docs/assets/reference_store_setting.md.CB2Icw7k.lean.js
new file mode 100644
index 00000000..da2e1889
--- /dev/null
+++ b/docs/assets/reference_store_setting.md.CB2Icw7k.lean.js
@@ -0,0 +1 @@
+import{_ as t,o as s,c as a,a3 as i}from"./chunks/framework.BNdm2jZV.js";const k=JSON.parse('{"title":"Setting Store","description":"","frontmatter":{},"headers":[],"relativePath":"reference/store/setting.md","filePath":"reference/store/setting.md"}'),d={name:"reference/store/setting.md"};function o(n,e,c,r,h,l){return s(),a("div",null,[...e[0]||(e[0]=[i("",11)])])}const g=t(d,[["render",o]]);export{k as __pageData,g as default};
diff --git a/docs/assets/reference_store_signing.md.453f7xx-.js b/docs/assets/reference_store_signing.md.453f7xx-.js
new file mode 100644
index 00000000..00c07432
--- /dev/null
+++ b/docs/assets/reference_store_signing.md.453f7xx-.js
@@ -0,0 +1,8 @@
+import{_ as i,o as a,c as e,a3 as t}from"./chunks/framework.BNdm2jZV.js";const g=JSON.parse('{"title":"Signing Store","description":"","frontmatter":{},"headers":[],"relativePath":"reference/store/signing.md","filePath":"reference/store/signing.md"}'),n={name:"reference/store/signing.md"};function l(r,s,d,p,h,o){return a(),e("div",null,[...s[0]||(s[0]=[t(`Signing Store
useSigningGetters().getSigningCallback 返回账号信息引用。登录前可能为空对象,成功后主要字段为 name、role、avatar?。角色用于客户端路由判断,后端仍需对每次请求校验会话和权限。
| 方法 | 行为 |
|---|
signing(form) | 接收 { name, pwd }。模板演示对非空表单返回固定的 admin 角色,不校验密码。成功解析为 { code: 0, data, message };空表单拒绝,包含 code: 1 和 data: null。 |
clearSigningCallback(toSigning) | 清理当前应用登录和菜单缓存、Session Storage,并尝试关闭标签。true 时还会清路由、回到登录页并安排刷新。 |
logout() | 调用 clearSigningCallback(true)。 |
登录演示页面在 signing 成功后写入演示 token 和签入信息;Store 的 signing 动作自身不签发 token。请求插件从 Local Storage 读取 token,Pinia 另外持久化 signingCallback。对接实际身份系统时,把 token 写入、角色刷新与退出清理视为同一条流程。
tsimport { useSigningActions, useSigningGetters } from '@/store'
+import { computed } from 'vue'
+
+export function useAccountMenu() {
+ const { getSigningCallback } = useSigningGetters()
+ const { logout } = useSigningActions()
+ return { name: computed(() => getSigningCallback.value?.name ?? ''), logout }
+}
退出会清理当前来源的 Session Storage。多个业务共用同一来源时,接入方应明确其清理范围。动作还依赖已经挂载的消息 Provider 和 Router;从用户操作或已初始化的应用流程触发。
Signing 实现 · 类型 · 演示登录 · 权限守卫
`,7)])])}const c=i(n,[["render",l]]);export{g as __pageData,c as default};
diff --git a/docs/assets/reference_store_signing.md.453f7xx-.lean.js b/docs/assets/reference_store_signing.md.453f7xx-.lean.js
new file mode 100644
index 00000000..d015a300
--- /dev/null
+++ b/docs/assets/reference_store_signing.md.453f7xx-.lean.js
@@ -0,0 +1 @@
+import{_ as i,o as a,c as e,a3 as t}from"./chunks/framework.BNdm2jZV.js";const g=JSON.parse('{"title":"Signing Store","description":"","frontmatter":{},"headers":[],"relativePath":"reference/store/signing.md","filePath":"reference/store/signing.md"}'),n={name:"reference/store/signing.md"};function l(r,s,d,p,h,o){return a(),e("div",null,[...s[0]||(s[0]=[t("",7)])])}const c=i(n,[["render",l]]);export{g as __pageData,c as default};
diff --git a/docs/assets/reference_table-pro.md.DW6Gztpq.js b/docs/assets/reference_table-pro.md.DW6Gztpq.js
new file mode 100644
index 00000000..2977dd4c
--- /dev/null
+++ b/docs/assets/reference_table-pro.md.DW6Gztpq.js
@@ -0,0 +1,213 @@
+const __vite__mapDeps=(i,m=__vite__mapDeps,d=(m.f||(m.f=["assets/chunks/TableProDemo.BMwK48NC.js","assets/chunks/framework.BNdm2jZV.js","assets/chunks/Icon.DgnQbY0f.js","assets/chunks/Loading.CYk0ZDH9.js","assets/chunks/Button.B5dXaugh.js","assets/chunks/call.Cml8M0xk.js","assets/chunks/isSymbol.BJY0fdHu.js","assets/chunks/index.CRUCD9CF.js","assets/chunks/commonjsHelpers.CqkleIqs.js","assets/chunks/unref-element.DLBcf5mH.js"])))=>i.map(i=>d[i]);
+import{u as t,C as p,o as e,c as E,a3 as i,E as a,w as d,k as n,U as r,V as g}from"./chunks/framework.BNdm2jZV.js";const y="/ray-template/docs/assets/tablepro-preview.jpg",B=JSON.parse('{"title":"TablePro","description":"","frontmatter":{},"headers":[],"relativePath":"reference/table-pro.md","filePath":"reference/table-pro.md"}'),F={name:"reference/table-pro.md"},u=Object.assign(F,{setup(o){const{isDark:h}=t(),k=r(()=>g(()=>import("./chunks/TableProDemo.BMwK48NC.js"),__vite__mapDeps([0,1,2,3,4,5,6,7,8,9])));return(c,s)=>{const l=p("ClientOnly");return e(),E("div",null,[s[0]||(s[0]=i('TablePro
RTablePro 从 @ray-template/ui/table-pro 导入。Ray Admin 内也可以继续从 @/components 导入。列、选择、排序、固定和虚拟滚动沿用 Naive UI DataTable。使用 bare 只渲染表格,或按业务需要加上搜索、分页和工具栏。

交互示例
试试切换数据来源、筛选和分页。远端模式下,快速切换页码或重复提交筛选可以中止前一次查询。触发模拟失败后,可以用表格内的按钮重试。
',5)),a(l,null,{default:d(()=>[a(n(k),{dark:n(h)},null,8,["dark"])]),_:1}),s[1]||(s[1]=i(`查看示例源码
vue<template>
+ <NConfigProvider :theme="dark ? darkTheme : undefined">
+ <div
+ class="ray-demo table-demo"
+ :class="{ 'r-template--dark': dark }"
+ :lang="locale"
+ >
+ <fieldset>
+ <legend>{{ copy.source }}</legend>
+ <div class="ray-demo-options">
+ <label :for="\`\${id}-local\`">
+ <input
+ :id="\`\${id}-local\`"
+ v-model="source"
+ type="radio"
+ :name="id"
+ value="local"
+ />
+ {{ copy.local }}
+ </label>
+ <label :for="\`\${id}-remote\`">
+ <input
+ :id="\`\${id}-remote\`"
+ v-model="source"
+ type="radio"
+ :name="id"
+ value="remote"
+ />
+ {{ copy.remote }}
+ </label>
+ <label :for="\`\${id}-virtual\`">
+ <input :id="\`\${id}-virtual\`" v-model="virtual" type="checkbox" />
+ {{ copy.virtual }}
+ </label>
+ </div>
+ </fieldset>
+ <NButton v-if="source === 'remote'" size="small" @click="failRequest">
+ {{ copy.fail }}
+ </NButton>
+ <p v-if="source === 'remote'" role="status">
+ {{ copy.cancelled }} {{ cancelled }}
+ </p>
+ <RTablePro
+ :key="source"
+ ref="table"
+ :columns="columns"
+ :data="source === 'local' ? rows : []"
+ :request="source === 'remote' ? request : undefined"
+ :virtualScroll="virtual"
+ :search="[{ key: 'name', label: copy.name }]"
+ columnStateKey="docs-demo"
+ autoHeight
+ />
+ </div>
+ </NConfigProvider>
+</template>
+
+<script setup lang="ts">
+import '@ray-template/ui/theme.css'
+import { provideUiServices } from '@ray-template/ui/services'
+import { RTablePro } from '@ray-template/ui/table-pro'
+import type { TableProInst, TableProRequest } from '@ray-template/ui/table-pro'
+import { createStorage } from '@ray-template/utils/storage'
+import { darkTheme, NButton, NConfigProvider } from 'naive-ui'
+import { computed, ref, shallowRef, useId } from 'vue'
+
+const props = withDefaults(
+ defineProps<{ dark?: boolean; locale?: 'zh-CN' | 'en' }>(),
+ { locale: 'zh-CN' },
+)
+const copy = computed(() =>
+ props.locale === 'en'
+ ? {
+ source: 'Data source',
+ local: 'Local',
+ remote: 'Simulated request',
+ virtual: 'Virtual scroll',
+ fail: 'Simulate a request failure',
+ cancelled: 'Cancelled requests:',
+ name: 'Name',
+ score: 'Score',
+ entry: 'Member',
+ }
+ : {
+ source: '数据来源',
+ local: '本地数据',
+ remote: '模拟远端查询',
+ virtual: '虚拟滚动',
+ fail: '模拟请求失败',
+ cancelled: '已取消请求:',
+ name: '姓名',
+ score: '分数',
+ entry: '成员',
+ },
+)
+const id = useId()
+const source = ref<'local' | 'remote'>('local')
+const virtual = ref(false)
+const cancelled = ref(0)
+const table = shallowRef<TableProInst>()
+const values = new Map<string, string>()
+
+provideUiServices({
+ locale: () => props.locale,
+ dark: () => props.dark,
+ columnStorage: createStorage({
+ getItem: (key) => values.get(key) ?? null,
+ setItem: (key, value) => {
+ values.set(key, value)
+ },
+ removeItem: (key) => {
+ values.delete(key)
+ },
+ }),
+})
+const rows = computed(() =>
+ Array.from({ length: 96 }, (_, index) => ({
+ id: index + 1,
+ name: \`\${copy.value.entry} \${index + 1}\`,
+ score: 60 + (index % 41),
+ })),
+)
+const columns = computed(() => [
+ { title: 'ID', key: 'id', width: 64 },
+ { title: copy.value.name, key: 'name' },
+ { title: copy.value.score, key: 'score', width: 76 },
+])
+let failNext = false
+const request: TableProRequest = (
+ { page = 1, pageSize = 10, name },
+ signal,
+) => {
+ const shouldFail = failNext
+
+ failNext = false
+
+ return new Promise((resolve, reject) => {
+ signal.throwIfAborted()
+ const onAbort = () => {
+ clearTimeout(timer)
+ cancelled.value += 1
+ reject(signal.reason)
+ }
+ const timer = setTimeout(() => {
+ signal.removeEventListener('abort', onAbort)
+
+ if (shouldFail) {
+ reject(new Error('Simulated request failure'))
+
+ return
+ }
+
+ const matching = rows.value.filter((row) =>
+ row.name.includes(String(name ?? '')),
+ )
+
+ resolve({
+ data: matching.slice((page - 1) * pageSize, page * pageSize),
+ total: matching.length,
+ })
+ }, 650)
+
+ signal.addEventListener('abort', onAbort, { once: true })
+ })
+}
+const failRequest = () => {
+ failNext = true
+ void table.value?.reload()
+}
+</script>
+
+<style scoped>
+.table-demo {
+ --r-table-height: 460px;
+}
+
+.table-demo :deep(.n-data-table-table) {
+ display: table;
+ margin: 0;
+ overflow: visible;
+}
+
+.table-demo :deep(.n-data-table-tr) {
+ background: transparent;
+ border: 0;
+}
+</style>
纯表格与远端查询
tsximport { getPersonList } from '@/api/demo/mock/person'
+import { RTablePro } from '@/components'
+
+const columns = [
+ { title: '姓名', key: 'name' },
+ { title: '邮箱', key: 'email' },
+]
+
+const renderBare = () => <RTablePro bare columns={columns} data={[]} />
+
+const renderRemote = () => (
+ <RTablePro
+ columns={columns}
+ request={getPersonList}
+ search={[{ key: 'name', label: '姓名' }]}
+ columnStateKey="demo:people"
+ />
+)
- 远端
request(params, signal) 返回 Promise<{ data, total }>。组件只采用最新请求结果;失败保留旧数据并提供重试。要中止底层 HTTP,请把 signal 交给请求客户端。 - 搜索提交回到第 1 页。外部筛选用
params,复杂表单可从 filters 插槽调用 submit(values)。服务端排序和过滤由调用方将事件值映射进 params。 - 默认每页 10 条;用
pageSize、pagination.pageSizes 调整,或传 pagination={false} 关闭。关闭时不添加分页字段;bare pagination 可单独开启分页。 - 初始页用
pagination.defaultPage。远端模式下组件管理当前页、每页条数和总数;调用方已有自己的远端控制时可传 remote + data + pagination。
布局、工具与实例
autoHeight 让表格填充当前工作区;嵌入自定义区域时可用 --r-table-height 设定可用高度。宽表设置列宽与 scrollX,使横向滚动留在表格内。
tsximport { RTablePro, type TableProInst } from '@/components'
+import { shallowRef } from 'vue'
+
+const table = shallowRef<TableProInst>()
+const reloadFromFirstPage = () => table.value?.reload(true)
+
+const renderTable = () => (
+ <RTablePro ref={table} columns={[{ title: '姓名', key: 'name' }]} data={[]} />
+)
实例还提供 setPage、setPageSize、downloadCsv、print 和 getTableInstance。扩展表格区域可用 title、toolbar、tableFooter、tableAction;错误区域用 error 插槽。
列设置与缓存
每张表使用稳定且唯一的列 key。列设置可以勾选显示、调整根列顺序、固定或启用列宽调整;分组子列跟随根列。使用 columnStateKey 跨刷新保留隐藏列,按账户或租户隔离时将标识纳入 key。缓存不存数据、列定义、顺序、固定位置或列宽。调用方接管列配置可用 v-model:columns,返回包含隐藏列的完整定义。
打印与 CSV
默认取当前页可见数据列。打印按当前筛选和排序输出独立表格,不复刻 Vue 单元格、操作区、展开区或合并布局。报表等专用版式通过 printTableOptions.target 指定元素、ref 或 getter;单次调用可传 title 和专用 style。真实纸张输出由浏览器负责。
CSV 的 keepOriginalData 使用当前传给表格的整批数据,远端模式不会自动抓取全部页。列级 allowExport: false 可排除数据;getCsvCell / getCsvHeader 返回原始文本,由组件做 CSV 转义。
TablePro 完整契约 · 六种可运行示例 · v6 的变更
Props、事件和插槽
Naive UI DataTable 的列定义、选择、展开、加载、空态和虚拟滚动继续使用。下面列出模板层的配置与覆盖行为。
| 配置 | 默认 / 行为 |
|---|
bare | 默认关。隐藏标题及工具栏,省略 pagination 时不分页;显式搜索、底部插槽仍可使用。 |
autoHeight | 默认关;开启时让内部 DataTable 使用 flexHeight,适合有可用高度的布局。 |
tool | 默认开,控制打印、密度、全屏、列设置和外观等内置工具。关掉仍可用自定义 toolbar。 |
title | 字符串或 VNode。存在 title 插槽时优先渲染插槽。 |
pagination | 普通模式缺省开,false 关闭;对象透传 Naive UI Pagination。容器小于 600px 时默认简洁模式,显式 simple 优先。 |
pageSize | 默认 10;pagination.pageSize、pagination.defaultPageSize 依次优先。远端初始页读 pagination.defaultPage。 |
request / params | 配置 request 时组件管理远端数据。params 深层变化会从第 1 页重查。 |
search | { key, label, placeholder?, options? }[]。输入只更新草稿,提交才生效。 |
rowKey | 默认 row.id ?? row.key,业务数据缺少两者时必须提供稳定键。 |
columnStateKey | 缺省不持久化。传稳定标识可记住隐藏列。 |
downloadCsvTableOptions | 内置导出默认配置,模板实现使用 fileName、keepOriginalData。 |
printTableOptions | 打印配置,支持 target、title、style、formatHeader、formatCell。 |
contextMenuOptions / onContextMenuClick | 行右键菜单选项及选择回调 (key, option);回调不直接收到行。先调用业务 rowProps.onContextmenu,可用 preventDefault() 阻止打开。 |
常用事件有 onRequestError(error)(或 SFC @request-error)、onUpdatePage、onUpdatePageSize、onUpdate:columns。内部分页先变更,再触发外部事件。行选择、排序等依然沿用 DataTable 事件;需要服务端排序时,将条件写入 params。
| 插槽 | 参数与位置 |
|---|
filters | 表格上方;接收 { submit(values) },传入字符串或数字键值,提交后回第一页。优先于内置 search。 |
title / toolbar | 标题区左侧 / 操作区右侧;bare 下两者隐藏。 |
notice | 正常情况下显示自定义提示。 |
error | 请求失败时替换 notice,接收 { reload }。未提供则显示错误和重试按钮。 |
tableFooter / tableAction | DataTable 之后的额外区域。 |
| 其余插槽 | 转给 Naive UI DataTable,例如空态和加载。 |
TableProInst 的 reload(resetPage?)、setPage(page)、setPageSize(size) 返回 Promise<void>。请求错误由事件报告并保留旧数据;该 Promise 的完成不能用作业务成功判据。getTableInstance() 可能为 null;print(options?) 返回 Promise<boolean> 表示是否发起预览;downloadCsv(options?) 发起浏览器下载。
远端请求将 params 与已提交筛选合并,后者覆盖同名项,页码字段最后由表格写入。关闭分页时也会删除传入的 page 和 pageSize。total 需要是非负安全整数,data 必须是数组。若筛选或删除数据后当前页超出范围,会收敛到最后一页,并在有结果时重查。
TablePro Props · 远端与分页实现 · 表格面板实现
`,22))])}}});export{B as __pageData,u as default};
diff --git a/docs/assets/reference_table-pro.md.DW6Gztpq.lean.js b/docs/assets/reference_table-pro.md.DW6Gztpq.lean.js
new file mode 100644
index 00000000..a046aca4
--- /dev/null
+++ b/docs/assets/reference_table-pro.md.DW6Gztpq.lean.js
@@ -0,0 +1,2 @@
+const __vite__mapDeps=(i,m=__vite__mapDeps,d=(m.f||(m.f=["assets/chunks/TableProDemo.BMwK48NC.js","assets/chunks/framework.BNdm2jZV.js","assets/chunks/Icon.DgnQbY0f.js","assets/chunks/Loading.CYk0ZDH9.js","assets/chunks/Button.B5dXaugh.js","assets/chunks/call.Cml8M0xk.js","assets/chunks/isSymbol.BJY0fdHu.js","assets/chunks/index.CRUCD9CF.js","assets/chunks/commonjsHelpers.CqkleIqs.js","assets/chunks/unref-element.DLBcf5mH.js"])))=>i.map(i=>d[i]);
+import{u as t,C as p,o as e,c as E,a3 as i,E as a,w as d,k as n,U as r,V as g}from"./chunks/framework.BNdm2jZV.js";const y="/ray-template/docs/assets/tablepro-preview.jpg",B=JSON.parse('{"title":"TablePro","description":"","frontmatter":{},"headers":[],"relativePath":"reference/table-pro.md","filePath":"reference/table-pro.md"}'),F={name:"reference/table-pro.md"},u=Object.assign(F,{setup(o){const{isDark:h}=t(),k=r(()=>g(()=>import("./chunks/TableProDemo.BMwK48NC.js"),__vite__mapDeps([0,1,2,3,4,5,6,7,8,9])));return(c,s)=>{const l=p("ClientOnly");return e(),E("div",null,[s[0]||(s[0]=i("",5)),a(l,null,{default:d(()=>[a(n(k),{dark:n(h)},null,8,["dark"])]),_:1}),s[1]||(s[1]=i("",22))])}}});export{B as __pageData,u as default};
diff --git a/docs/assets/reference_utils.md.CPo2FGYU.js b/docs/assets/reference_utils.md.CPo2FGYU.js
new file mode 100644
index 00000000..b1ef5ed8
--- /dev/null
+++ b/docs/assets/reference_utils.md.CPo2FGYU.js
@@ -0,0 +1 @@
+import{_ as t,o as a,c as r,a3 as d}from"./chunks/framework.BNdm2jZV.js";const u=JSON.parse('{"title":"工具函数","description":"","frontmatter":{},"headers":[],"relativePath":"reference/utils.md","filePath":"reference/utils.md"}'),o={name:"reference/utils.md"};function s(i,e,c,l,n,f){return a(),r("div",null,[...e[0]||(e[0]=[d('工具函数
@/utils 汇总模板公开工具。应用初始化或底层模块可以按职责从 @/utils/core、@/utils/cache、@/utils/files 等入口导入,避免加载无关依赖。历史 basic.ts 和 c/ 仍作为转发入口。
| 主题 | API |
|---|
| 基础、日期与数值 | 类型判断、PromiseLike、随机标识、错误处理、对象更新、日期范围、定点运算 |
| 缓存与兼容加密 | Local / Session Storage、前缀、历史 AES JSON |
| Vue 与浏览器 | ref / DOM 解包、样式、查询、下载、截图打印、侧栏定位 |
下载和打印需要在浏览器执行,响应式 DOM 工具应在 Vue 作用域内创建。缓存和文件 API 的泛型不校验外部数据结构;跨信任边界时先验证输入。
公开导出 · 实现与回归索引
',5)])])}const p=t(o,[["render",s]]);export{u as __pageData,p as default};
diff --git a/docs/assets/reference_utils.md.CPo2FGYU.lean.js b/docs/assets/reference_utils.md.CPo2FGYU.lean.js
new file mode 100644
index 00000000..05e5a0a9
--- /dev/null
+++ b/docs/assets/reference_utils.md.CPo2FGYU.lean.js
@@ -0,0 +1 @@
+import{_ as t,o as a,c as r,a3 as d}from"./chunks/framework.BNdm2jZV.js";const u=JSON.parse('{"title":"工具函数","description":"","frontmatter":{},"headers":[],"relativePath":"reference/utils.md","filePath":"reference/utils.md"}'),o={name:"reference/utils.md"};function s(i,e,c,l,n,f){return a(),r("div",null,[...e[0]||(e[0]=[d("",5)])])}const p=t(o,[["render",s]]);export{u as __pageData,p as default};
diff --git a/docs/assets/reference_utils_browser.md.mqqbsAE7.js b/docs/assets/reference_utils_browser.md.mqqbsAE7.js
new file mode 100644
index 00000000..f4745d98
--- /dev/null
+++ b/docs/assets/reference_utils_browser.md.mqqbsAE7.js
@@ -0,0 +1,4 @@
+import{_ as t,o as a,c as s,a3 as d}from"./chunks/framework.BNdm2jZV.js";const k=JSON.parse('{"title":"Vue 与浏览器工具","description":"","frontmatter":{},"headers":[],"relativePath":"reference/utils/browser.md","filePath":"reference/utils/browser.md"}'),i={name:"reference/utils/browser.md"};function r(o,e,l,n,h,c){return a(),s("div",null,[...e[0]||(e[0]=[d(`Vue 与浏览器工具
Vue 目标解析
BasicTarget<T> 可为元素、组件实例、ref、getter 或空值,unrefElement(target, fallback?) 在调用时解包;组件优先返回 $el。多根组件的 $el 未必是可操作的元素。截图、全屏、样式操作请优先绑定明确的原生 DOM ref。
| 工具 | 行为 |
|---|
call(fnOrFns, ...args) | 调用一个函数或按顺序调用回调数组,透传参数。 |
renderNode(value, { defaultElement }?) | 规范化成渲染函数。仅 null 或 undefined 用回退,0 和空字符串保留。 |
effectDispose(cleanup) | 有当前 effect scope 时登记清理并返回 true,否则返回 false,需调用方自行释放。 |
watchEffectWithTarget(effect, options?) | 对 Vue watchEffect 的兼容入口,返回停止句柄;在有效作用域创建时会随作用域停止。 |
DOM、样式和尺寸
| API | 行为 |
|---|
setClass(target, names) / removeClass(target, names) | 作用于当前和后续替换的目标。支持空白分隔字符串或数组;移除时 removeAllClass 清空 class。 |
hasClass(target, names) | 返回响应式布尔值,任一完整类名匹配即为真。只随目标引用更新,外部改 class 属性本身不会触发重算。 |
setStyle(target, styles) | 支持样式对象、声明字符串或字符串数组,保留其他行内样式。支持 camelCase、CSS 自定义属性与 !important。 |
removeStyle(target, names) | 按 CSS 名称或 camelCase 删除行内样式。 |
autoPrefixStyle(name) | 返回原属性和历史前缀名的兼容映射,不执行 DOM 操作。 |
completeSize(value, unit = 'px') | 数字、纯数字字符串补单位,保留百分比、CSS 关键字和表达式。 |
colorToRgba(color, alpha = 1, fallback?) | 支持逗号形式 RGB/HSL 与常见 Hex。带透明度的 Hex 保留其透明度,未知格式回退到指定值或原字符串。 |
queryElements(selector, { defaultElement }?) | 返回 DOM 元素数组。attr:data-id 等同于属性选择器。无匹配返回空数组,空或非法选择器无回退时返回 null。 |
positionSelectedMenuItem() | 将已渲染且超出可视区的当前菜单滚入视野。调用前展开父级并等待 DOM 渲染。 |
类名与样式函数内部监听目标变化,在组件 setup 或 effect scope 内创建。SSR 下访问 document、window 的方法应推迟到挂载后。
文件、下载和打印
| API | 行为 |
|---|
fileToBase64(file) | 返回带 MIME 的 Data URL Promise,读取错误或中止会拒绝。 |
arrayBufferToBase64Image(buffer) | 把 PNG 字节加上 PNG Data URL 前缀,不转换其他图像格式。 |
downloadBase64File(url, fileName) | 以临时链接触发下载,清理链接。 |
downloadAnyFile(data, fileName) | 接收 Data URL、Blob、File、ArrayBuffer。二进制使用临时对象 URL;Promise 完成表示已发起下载。 |
printDom(target, { printOptions?, domToImageOptions? }) | 先将 DOM 截成 JPEG,再发起打印预览。返回 Promise<boolean>;失败记录错误并返回 false,若存在全局 Loading Bar 会同步状态。 |
tsimport { downloadAnyFile, fileToBase64 } from '@/utils'
+
+export const previewFile = (file: File) => fileToBase64(file)
+export const downloadReport = (pdf: Blob) => downloadAnyFile(pdf, 'report.pdf')
DOM 工具 · 文件工具 · Vue 工具 · 截图与打印 Hooks
`,11)])])}const f=t(i,[["render",r]]);export{k as __pageData,f as default};
diff --git a/docs/assets/reference_utils_browser.md.mqqbsAE7.lean.js b/docs/assets/reference_utils_browser.md.mqqbsAE7.lean.js
new file mode 100644
index 00000000..38f8e7a5
--- /dev/null
+++ b/docs/assets/reference_utils_browser.md.mqqbsAE7.lean.js
@@ -0,0 +1 @@
+import{_ as t,o as a,c as s,a3 as d}from"./chunks/framework.BNdm2jZV.js";const k=JSON.parse('{"title":"Vue 与浏览器工具","description":"","frontmatter":{},"headers":[],"relativePath":"reference/utils/browser.md","filePath":"reference/utils/browser.md"}'),i={name:"reference/utils/browser.md"};function r(o,e,l,n,h,c){return a(),s("div",null,[...e[0]||(e[0]=[d("",11)])])}const f=t(i,[["render",r]]);export{k as __pageData,f as default};
diff --git a/docs/assets/reference_utils_core.md.D6K4f3-H.js b/docs/assets/reference_utils_core.md.D6K4f3-H.js
new file mode 100644
index 00000000..f8bfe293
--- /dev/null
+++ b/docs/assets/reference_utils_core.md.D6K4f3-H.js
@@ -0,0 +1,97 @@
+import{d as x,a4 as f,o as F,c as u,j as k,k as g,t as o,a5 as m,a6 as v,a as D,h as A,p as b,a3 as _,E as I}from"./chunks/framework.BNdm2jZV.js";/*!
+ * currency.js - v2.0.4
+ * http://scurker.github.io/currency.js
+ *
+ * Copyright (c) 2021 Jason Wilson
+ * Released under MIT license
+ */var V={symbol:"$",separator:",",decimal:".",errorOnInvalid:!1,precision:2,pattern:"!#",negativePattern:"-!#",format:T,fromCents:!1},q=function(i){return Math.round(i)},B=function(i){return Math.pow(10,i)},P=function(i,a){return q(i/a)*a},S=/(\d)(?=(\d{3})+\b)/g,O=/(\d)(?=(\d\d)+\d\b)/g;function d(n,i){var a=this;if(!(a instanceof d))return new d(n,i);var s=Object.assign({},V,i),t=B(s.precision),h=C(n,s);a.intValue=h,a.value=h/t,s.increment=s.increment||1/t,s.useVedic?s.groups=O:s.groups=S,this.s=s,this.p=t}function C(n,i){var a=arguments.length>2&&arguments[2]!==void 0?arguments[2]:!0,s=0,t=i.decimal,h=i.errorOnInvalid,p=i.precision,r=i.fromCents,l=B(p),e=typeof n=="number",E=n instanceof d;if(E&&r)return n.intValue;if(e||E)s=E?n.value:n;else if(typeof n=="string"){var y=new RegExp("[^-\\d"+t+"]","g"),c=new RegExp("\\"+t,"g");s=n.replace(/\((.*)\)/,"-$1").replace(y,"").replace(c,"."),s=s||0}else{if(h)throw Error("Invalid Input");s=0}return r||(s*=l,s=s.toFixed(4)),a?q(s):s}function T(n,i){var a=i.pattern,s=i.negativePattern,t=i.symbol,h=i.separator,p=i.decimal,r=i.groups,l=(""+n).replace(/^-/,"").split("."),e=l[0],E=l[1];return(n.value>=0?a:s).replace("!",t).replace("#",e.replace(r,"$1"+h)+(E?p+E:""))}d.prototype={add:function(i){var a=this.intValue,s=this.s,t=this.p;return d((a+=C(i,s))/(s.fromCents?1:t),s)},subtract:function(i){var a=this.intValue,s=this.s,t=this.p;return d((a-=C(i,s))/(s.fromCents?1:t),s)},multiply:function(i){var a=this.intValue,s=this.s;return d((a*=i)/(s.fromCents?1:B(s.precision)),s)},divide:function(i){var a=this.intValue,s=this.s;return d(a/=C(i,s,!1),s)},distribute:function(i){for(var a=this.intValue,s=this.p,t=this.s,h=[],p=Math[a>=0?"floor":"ceil"](a/i),r=Math.abs(a-p*i),l=t.fromCents?1:s;i!==0;i--){var e=d(p/l,t);r-- >0&&(e=e[a>=0?"add":"subtract"](1/l)),h.push(e)}return h},dollars:function(){return~~this.value},cents:function(){var i=this.intValue,a=this.p;return~~(i%a)},format:function(i){var a=this.s;return typeof i=="function"?i(this,a):a.format(this,Object.assign({},a,i))},toString:function(){var i=this.intValue,a=this.p,s=this.s;return P(i/a,s.increment).toFixed(s.precision)},toJSON:function(){return this.value}};const N={precision:8,decimal:"."},w=(...n)=>n.reduce((i,a)=>i.add(a),d(0,N)),R=["lang"],j={class:"ray-demo-fields"},$=["for"],J=["id","aria-describedby","aria-invalid"],M=["for"],U=["id","aria-describedby","aria-invalid"],W=["id"],H=["for"],z={key:0},G={key:1},X=x({__name:"PrecisionDemo",props:{locale:{}},setup(n){const i=n,a=A(()=>i.locale==="en"?{first:"First number",second:"Second number",fixed:"Fixed precision",native:"JavaScript addition",hint:"Enter up to 7 integer digits and 8 decimal places per number.",invalid:"Enter two valid decimal numbers."}:{first:"第一个数",second:"第二个数",fixed:"定点运算",native:"JavaScript 加法",hint:"每个数最多输入 7 位整数和 8 位小数。",invalid:"请输入两个有效的十进制数。"}),s=b("0.1"),t=b("0.2"),h=f(),p=f(),r=f(),l=E=>/^[+-]?(?:\d{1,7}(?:\.\d{0,8})?|\.\d{1,8})$/.test(E),e=A(()=>{if(!(!l(s.value)||!l(t.value)))return{fixed:w(s.value,t.value).toString(),native:Number(s.value)+Number(t.value)}});return(E,y)=>(F(),u("div",{class:"ray-demo",lang:n.locale??"zh-CN"},[k("div",j,[k("div",null,[k("label",{for:g(h)},o(a.value.first),9,$),m(k("input",{id:g(h),"onUpdate:modelValue":y[0]||(y[0]=c=>s.value=c),inputmode:"decimal","aria-describedby":g(r),"aria-invalid":!l(s.value)},null,8,J),[[v,s.value,void 0,{trim:!0}]])]),k("div",null,[k("label",{for:g(p)},o(a.value.second),9,M),m(k("input",{id:g(p),"onUpdate:modelValue":y[1]||(y[1]=c=>t.value=c),inputmode:"decimal","aria-describedby":g(r),"aria-invalid":!l(t.value)},null,8,U),[[v,t.value,void 0,{trim:!0}]])])]),k("p",{id:g(r),class:"ray-demo-hint"},o(a.value.hint),9,W),k("output",{class:"ray-demo-result",for:`${g(h)} ${g(p)}`},[e.value?(F(),u("span",z,[D(o(a.value.fixed)+":",1),k("code",null,o(e.value.fixed),1),y[2]||(y[2]=k("br",null,null,-1)),D(" "+o(a.value.native)+":",1),k("code",null,o(e.value.native),1)])):(F(),u("span",G,o(a.value.invalid),1))],8,H)],8,R))}}),Q=JSON.parse('{"title":"基础、日期和数值工具","description":"","frontmatter":{},"headers":[],"relativePath":"reference/utils/core.md","filePath":"reference/utils/core.md"}'),L={name:"reference/utils/core.md"},Y=Object.assign(L,{setup(n){return(i,a)=>(F(),u("div",null,[a[0]||(a[0]=_(`基础、日期和数值工具
从 @/utils 导入以下函数。基础能力的实现位于 @/utils/core,精度工具也可从 @/utils/precision 单独导入。
类型、标识和错误处理
| API | 输入与返回 |
|---|
isValueType<T>(value, type) | 按 Object.prototype.toString 标签判断,普通函数和 async 函数都匹配 Function。 |
isPromise<T>(value) | 有可调用的 then 时返回 true,包括自定义 PromiseLike。 |
isAsyncFunction(fn) | 判断函数是否用 async 声明,普通返回 Promise 的函数不匹配。 |
uuid(length = 16, radix = 62) | Web Crypto 随机标识。字符集依次是数字、大写、小写,基数范围 1–62,长度是非负安全整数。参数非法抛 RangeError;结果不是 RFC UUID。 |
callWithErrorHandling(fn, onError, args?) | 返回同步执行结果;抛错时调用回调并返回 undefined。不会等待 Promise。 |
callWithAsyncErrorHandling(fn, onError, args?) | 等待函数返回值,处理同步抛错和拒绝。回调自身抛错时,错误会传给调用方。 |
tsimport { callWithAsyncErrorHandling, uuid } from '@/utils'
+
+export const draftId = () => 'draft-' + uuid(12, 36)
+
+export function loadOrReport<T>(
+ load: () => Promise<T>,
+ report: (error: Error) => void,
+) {
+ return callWithAsyncErrorHandling(load, report)
+}
对象、路径和日期
updateObjectValue(obj, key, value, callback?) 只修改对象的自有属性;新旧值均为普通对象时浅合并,其他情况替换。成功后调用回调。removeDuplicateKeys(obj) 返回自有可枚举属性的浅拷贝。JavaScript 对象字面量的同名键已经在创建时由后值覆盖,不能用这个函数找回前值。equalRouterPath(a, b) 忽略 query、hash 和末尾斜杠。需要区分筛选参数或标签实例时用完整路径。getDateByNaiveDatePicker(value, isRange) 把清空的范围 null 转成 [null, null],其他值原样保留。它不转换单位、时区或格式。getAppEnvironment() 返回 Vite 的 import.meta.env,用于读取 MODE、DEV、PROD 等。客户端可见的配置不要放密钥。detectOperatingSystem() 基于浏览器 User-Agent 返回 OperatingSystem,识别 iOS(含桌面标识 iPad)、Android、Windows、macOS、Linux 或 Unknown。它适合辅助显示,不代替能力检测。
定点运算
输入 CurrencyArguments 可为数字、字符串或 currency.js 实例。模板缺省精度为 8 位小数;运算结果仍是 currency.js 实例,可取 .value 或 .toString()。
交互示例
修改两个数,对比 add 与 JavaScript + 的结果。示例直接调用 workspace 内的 @ray-template/utils/precision。
`,11)),I(X),a[1]||(a[1]=_(`查看示例源码
vue<template>
+ <div class="ray-demo" :lang="locale ?? 'zh-CN'">
+ <div class="ray-demo-fields">
+ <div>
+ <label :for="firstId">{{ copy.first }}</label>
+ <input
+ :id="firstId"
+ v-model.trim="first"
+ inputmode="decimal"
+ :aria-describedby="hintId"
+ :aria-invalid="!isDecimal(first)"
+ />
+ </div>
+ <div>
+ <label :for="secondId">{{ copy.second }}</label>
+ <input
+ :id="secondId"
+ v-model.trim="second"
+ inputmode="decimal"
+ :aria-describedby="hintId"
+ :aria-invalid="!isDecimal(second)"
+ />
+ </div>
+ </div>
+ <p :id="hintId" class="ray-demo-hint">{{ copy.hint }}</p>
+ <output class="ray-demo-result" :for="\`\${firstId} \${secondId}\`">
+ <span v-if="result">
+ {{ copy.fixed }}:<code>{{ result.fixed }}</code>
+ <br />
+ {{ copy.native }}:<code>{{ result.native }}</code>
+ </span>
+ <span v-else>{{ copy.invalid }}</span>
+ </output>
+ </div>
+</template>
+
+<script setup lang="ts">
+import { add } from '@ray-template/utils/precision'
+import { computed, ref, useId } from 'vue'
+
+const props = defineProps<{ locale?: 'zh-CN' | 'en' }>()
+const copy = computed(() =>
+ props.locale === 'en'
+ ? {
+ first: 'First number',
+ second: 'Second number',
+ fixed: 'Fixed precision',
+ native: 'JavaScript addition',
+ hint: 'Enter up to 7 integer digits and 8 decimal places per number.',
+ invalid: 'Enter two valid decimal numbers.',
+ }
+ : {
+ first: '第一个数',
+ second: '第二个数',
+ fixed: '定点运算',
+ native: 'JavaScript 加法',
+ hint: '每个数最多输入 7 位整数和 8 位小数。',
+ invalid: '请输入两个有效的十进制数。',
+ },
+)
+const first = ref('0.1')
+const second = ref('0.2')
+const firstId = useId()
+const secondId = useId()
+const hintId = useId()
+const isDecimal = (value: string) =>
+ /^[+-]?(?:\\d{1,7}(?:\\.\\d{0,8})?|\\.\\d{1,8})$/.test(value)
+const result = computed(() => {
+ if (!isDecimal(first.value) || !isDecimal(second.value)) return
+
+ return {
+ fixed: add(first.value, second.value).toString(),
+ native: Number(first.value) + Number(second.value),
+ }
+})
+</script>
API
| API | 行为 |
|---|
add(...values) | 求和,无参数返回零。 |
subtract(first, ...rest) | 依次相减。 |
multiply(first, ...rest) | 依次相乘,字符串因子会先解析。 |
divide(first, ...rest) | 依次相除,零除或非有限结果抛 RangeError。 |
format(value, options?) | 按精度转换,默认返回数字;type: 'string' 返回保留精度的数字字符串。 |
distribute(value, length, options?) | 平分金额,余数优先给前几份。0 和 1 都视作一份,负数或非整数抛错;支持 precision 和 type。 |
isCurrency(value) | 判断是否是当前 currency.js 类的实例。 |
tsimport { add, distribute, format } from '@/utils'
+
+export const amount = format(add('0.1', '0.2'), {
+ precision: 2,
+ type: 'string',
+})
+export const parts = distribute(10, 3, { precision: 2, type: 'string' })
分摊或货币结算由业务明确小数位和舍入规则。保留字符串或整数分值跨接口传输可避免展示时的二进制浮点误差。
基础函数 · 精度实现 · 日期选择器辅助
`,6))]))}});export{Q as __pageData,Y as default};
diff --git a/docs/assets/reference_utils_core.md.D6K4f3-H.lean.js b/docs/assets/reference_utils_core.md.D6K4f3-H.lean.js
new file mode 100644
index 00000000..bc43acc6
--- /dev/null
+++ b/docs/assets/reference_utils_core.md.D6K4f3-H.lean.js
@@ -0,0 +1,7 @@
+import{d as x,a4 as f,o as F,c as u,j as k,k as g,t as o,a5 as m,a6 as v,a as D,h as A,p as b,a3 as _,E as I}from"./chunks/framework.BNdm2jZV.js";/*!
+ * currency.js - v2.0.4
+ * http://scurker.github.io/currency.js
+ *
+ * Copyright (c) 2021 Jason Wilson
+ * Released under MIT license
+ */var V={symbol:"$",separator:",",decimal:".",errorOnInvalid:!1,precision:2,pattern:"!#",negativePattern:"-!#",format:T,fromCents:!1},q=function(i){return Math.round(i)},B=function(i){return Math.pow(10,i)},P=function(i,a){return q(i/a)*a},S=/(\d)(?=(\d{3})+\b)/g,O=/(\d)(?=(\d\d)+\d\b)/g;function d(n,i){var a=this;if(!(a instanceof d))return new d(n,i);var s=Object.assign({},V,i),t=B(s.precision),h=C(n,s);a.intValue=h,a.value=h/t,s.increment=s.increment||1/t,s.useVedic?s.groups=O:s.groups=S,this.s=s,this.p=t}function C(n,i){var a=arguments.length>2&&arguments[2]!==void 0?arguments[2]:!0,s=0,t=i.decimal,h=i.errorOnInvalid,p=i.precision,r=i.fromCents,l=B(p),e=typeof n=="number",E=n instanceof d;if(E&&r)return n.intValue;if(e||E)s=E?n.value:n;else if(typeof n=="string"){var y=new RegExp("[^-\\d"+t+"]","g"),c=new RegExp("\\"+t,"g");s=n.replace(/\((.*)\)/,"-$1").replace(y,"").replace(c,"."),s=s||0}else{if(h)throw Error("Invalid Input");s=0}return r||(s*=l,s=s.toFixed(4)),a?q(s):s}function T(n,i){var a=i.pattern,s=i.negativePattern,t=i.symbol,h=i.separator,p=i.decimal,r=i.groups,l=(""+n).replace(/^-/,"").split("."),e=l[0],E=l[1];return(n.value>=0?a:s).replace("!",t).replace("#",e.replace(r,"$1"+h)+(E?p+E:""))}d.prototype={add:function(i){var a=this.intValue,s=this.s,t=this.p;return d((a+=C(i,s))/(s.fromCents?1:t),s)},subtract:function(i){var a=this.intValue,s=this.s,t=this.p;return d((a-=C(i,s))/(s.fromCents?1:t),s)},multiply:function(i){var a=this.intValue,s=this.s;return d((a*=i)/(s.fromCents?1:B(s.precision)),s)},divide:function(i){var a=this.intValue,s=this.s;return d(a/=C(i,s,!1),s)},distribute:function(i){for(var a=this.intValue,s=this.p,t=this.s,h=[],p=Math[a>=0?"floor":"ceil"](a/i),r=Math.abs(a-p*i),l=t.fromCents?1:s;i!==0;i--){var e=d(p/l,t);r-- >0&&(e=e[a>=0?"add":"subtract"](1/l)),h.push(e)}return h},dollars:function(){return~~this.value},cents:function(){var i=this.intValue,a=this.p;return~~(i%a)},format:function(i){var a=this.s;return typeof i=="function"?i(this,a):a.format(this,Object.assign({},a,i))},toString:function(){var i=this.intValue,a=this.p,s=this.s;return P(i/a,s.increment).toFixed(s.precision)},toJSON:function(){return this.value}};const N={precision:8,decimal:"."},w=(...n)=>n.reduce((i,a)=>i.add(a),d(0,N)),R=["lang"],j={class:"ray-demo-fields"},$=["for"],J=["id","aria-describedby","aria-invalid"],M=["for"],U=["id","aria-describedby","aria-invalid"],W=["id"],H=["for"],z={key:0},G={key:1},X=x({__name:"PrecisionDemo",props:{locale:{}},setup(n){const i=n,a=A(()=>i.locale==="en"?{first:"First number",second:"Second number",fixed:"Fixed precision",native:"JavaScript addition",hint:"Enter up to 7 integer digits and 8 decimal places per number.",invalid:"Enter two valid decimal numbers."}:{first:"第一个数",second:"第二个数",fixed:"定点运算",native:"JavaScript 加法",hint:"每个数最多输入 7 位整数和 8 位小数。",invalid:"请输入两个有效的十进制数。"}),s=b("0.1"),t=b("0.2"),h=f(),p=f(),r=f(),l=E=>/^[+-]?(?:\d{1,7}(?:\.\d{0,8})?|\.\d{1,8})$/.test(E),e=A(()=>{if(!(!l(s.value)||!l(t.value)))return{fixed:w(s.value,t.value).toString(),native:Number(s.value)+Number(t.value)}});return(E,y)=>(F(),u("div",{class:"ray-demo",lang:n.locale??"zh-CN"},[k("div",j,[k("div",null,[k("label",{for:g(h)},o(a.value.first),9,$),m(k("input",{id:g(h),"onUpdate:modelValue":y[0]||(y[0]=c=>s.value=c),inputmode:"decimal","aria-describedby":g(r),"aria-invalid":!l(s.value)},null,8,J),[[v,s.value,void 0,{trim:!0}]])]),k("div",null,[k("label",{for:g(p)},o(a.value.second),9,M),m(k("input",{id:g(p),"onUpdate:modelValue":y[1]||(y[1]=c=>t.value=c),inputmode:"decimal","aria-describedby":g(r),"aria-invalid":!l(t.value)},null,8,U),[[v,t.value,void 0,{trim:!0}]])])]),k("p",{id:g(r),class:"ray-demo-hint"},o(a.value.hint),9,W),k("output",{class:"ray-demo-result",for:`${g(h)} ${g(p)}`},[e.value?(F(),u("span",z,[D(o(a.value.fixed)+":",1),k("code",null,o(e.value.fixed),1),y[2]||(y[2]=k("br",null,null,-1)),D(" "+o(a.value.native)+":",1),k("code",null,o(e.value.native),1)])):(F(),u("span",G,o(a.value.invalid),1))],8,H)],8,R))}}),Q=JSON.parse('{"title":"基础、日期和数值工具","description":"","frontmatter":{},"headers":[],"relativePath":"reference/utils/core.md","filePath":"reference/utils/core.md"}'),L={name:"reference/utils/core.md"},Y=Object.assign(L,{setup(n){return(i,a)=>(F(),u("div",null,[a[0]||(a[0]=_("",11)),I(X),a[1]||(a[1]=_("",6))]))}});export{Q as __pageData,Y as default};
diff --git a/docs/assets/reference_utils_storage.md.aIMEPocl.js b/docs/assets/reference_utils_storage.md.aIMEPocl.js
new file mode 100644
index 00000000..22976312
--- /dev/null
+++ b/docs/assets/reference_utils_storage.md.aIMEPocl.js
@@ -0,0 +1,10 @@
+import{_ as i,o as a,c as e,a3 as t}from"./chunks/framework.BNdm2jZV.js";const c=JSON.parse('{"title":"缓存与兼容加密","description":"","frontmatter":{},"headers":[],"relativePath":"reference/utils/storage.md","filePath":"reference/utils/storage.md"}'),n={name:"reference/utils/storage.md"};function r(l,s,h,p,d,k){return a(),e("div",null,[...s[0]||(s[0]=[t(`缓存与兼容加密
Web Storage
默认使用 sessionStorage,传 'localStorage' 跨刷新保存。所有读写值按 JSON 序列化。类型参数仅影响 TypeScript,不能确认缓存格式。
| API | 行为 |
|---|
setStorage(key, value, storageType?, options?) | 写入可序列化值,空键、循环引用或浏览器拒绝写入时记录错误。 |
getStorage<T>(key, storageType?, options?) | 缺键、损坏或不可读时返回 options.defaultValue 或 null;显式 JSON null 仍返回 null。 |
hasStorage(key, storageType?, options?) | 检查键存在,存储不可访问时返回 false,不验证 JSON 内容。 |
removeStorage(key, storageType?, options?) | 删除单键。也可传 __all__、__all_sessionStorage__ 或 __all_localStorage__ 做批量删除。 |
prefixCacheKey(key, { customPrefix }?) | 拼接自定义前缀或默认 APP_CATCH_KEY_PREFIX,分隔符需包含在前缀内。 |
缓存方法只有在 options.prefix: true 时才调用前缀函数,prefixKey 覆盖默认值。启用非空前缀时,批量删除只影响匹配的键;空前缀会清整个对应存储区域。读写和删除使用同一套前缀选项。Pinia 插件使用自己的持久化配置,修改工具前缀不会迁移 Pinia 的历史数据。
tsimport { getStorage, removeStorage, setStorage } from '@/utils'
+
+const options = { prefix: true, prefixKey: 'inventory:' }
+export function saveOrderFilter(status: string) {
+ setStorage('order-filter', { status }, 'sessionStorage', options)
+}
+export const readOrderFilter = () =>
+ getStorage<{ status: string }>('order-filter', 'sessionStorage', options)
+export const clearOrderFilter = () =>
+ removeStorage('order-filter', 'sessionStorage', options)
兼容 AES JSON
encrypt(data, key?) 返回 JSON 密文,decrypt(ciphertext, key?) 解码。可用字符串口令或 CryptoJS WordArray,同一数据须使用同类型和内容的 key。字符串沿用 OpenSSL 兼容格式,原始密钥使用随机 IV,字符串序列化为 IV:密文。错误密文或密钥会记录错误并返回 undefined,无法 JSON 序列化的输入会使加密抛错。
CRYPTO_KEY 是应用公开的历史兼容常量。这个工具用于读取既有本地数据(如演示锁屏),不能保护服务端密钥或替代认证。迁移格式时先保留对历史密文的读取能力。
缓存实现 · 加密 · 解密
`,10)])])}const g=i(n,[["render",r]]);export{c as __pageData,g as default};
diff --git a/docs/assets/reference_utils_storage.md.aIMEPocl.lean.js b/docs/assets/reference_utils_storage.md.aIMEPocl.lean.js
new file mode 100644
index 00000000..c091bacd
--- /dev/null
+++ b/docs/assets/reference_utils_storage.md.aIMEPocl.lean.js
@@ -0,0 +1 @@
+import{_ as i,o as a,c as e,a3 as t}from"./chunks/framework.BNdm2jZV.js";const c=JSON.parse('{"title":"缓存与兼容加密","description":"","frontmatter":{},"headers":[],"relativePath":"reference/utils/storage.md","filePath":"reference/utils/storage.md"}'),n={name:"reference/utils/storage.md"};function r(l,s,h,p,d,k){return a(),e("div",null,[...s[0]||(s[0]=[t("",10)])])}const g=i(n,[["render",r]]);export{c as __pageData,g as default};
diff --git a/docs/assets/setup-ts-config-1.webp b/docs/assets/setup-ts-config-1.webp
new file mode 100644
index 00000000..3e8b559a
Binary files /dev/null and b/docs/assets/setup-ts-config-1.webp differ
diff --git a/docs/assets/setup-ts-config-2.webp b/docs/assets/setup-ts-config-2.webp
new file mode 100644
index 00000000..c51adc22
Binary files /dev/null and b/docs/assets/setup-ts-config-2.webp differ
diff --git a/docs/assets/setup-ts-config-3.webp b/docs/assets/setup-ts-config-3.webp
new file mode 100644
index 00000000..fd8e09f3
Binary files /dev/null and b/docs/assets/setup-ts-config-3.webp differ
diff --git a/docs/assets/style.x9OR2Sj_.css b/docs/assets/style.x9OR2Sj_.css
new file mode 100644
index 00000000..508946d3
--- /dev/null
+++ b/docs/assets/style.x9OR2Sj_.css
@@ -0,0 +1 @@
+textarea[data-v-e6a3014a]{width:100%;padding:10px;border:1px solid var(--vp-c-divider);border-radius:6px;background:var(--vp-c-bg);font-family:var(--vp-font-family-mono);resize:vertical}@font-face{font-family:Inter;font-style:normal;font-weight:100 900;font-display:swap;src:url(/ray-template/docs/assets/inter-roman-cyrillic-ext.BBPuwvHQ.woff2) format("woff2");unicode-range:U+0460-052F,U+1C80-1C88,U+20B4,U+2DE0-2DFF,U+A640-A69F,U+FE2E-FE2F}@font-face{font-family:Inter;font-style:normal;font-weight:100 900;font-display:swap;src:url(/ray-template/docs/assets/inter-roman-cyrillic.C5lxZ8CY.woff2) format("woff2");unicode-range:U+0301,U+0400-045F,U+0490-0491,U+04B0-04B1,U+2116}@font-face{font-family:Inter;font-style:normal;font-weight:100 900;font-display:swap;src:url(/ray-template/docs/assets/inter-roman-greek-ext.CqjqNYQ-.woff2) format("woff2");unicode-range:U+1F00-1FFF}@font-face{font-family:Inter;font-style:normal;font-weight:100 900;font-display:swap;src:url(/ray-template/docs/assets/inter-roman-greek.BBVDIX6e.woff2) format("woff2");unicode-range:U+0370-0377,U+037A-037F,U+0384-038A,U+038C,U+038E-03A1,U+03A3-03FF}@font-face{font-family:Inter;font-style:normal;font-weight:100 900;font-display:swap;src:url(/ray-template/docs/assets/inter-roman-vietnamese.BjW4sHH5.woff2) format("woff2");unicode-range:U+0102-0103,U+0110-0111,U+0128-0129,U+0168-0169,U+01A0-01A1,U+01AF-01B0,U+0300-0301,U+0303-0304,U+0308-0309,U+0323,U+0329,U+1EA0-1EF9,U+20AB}@font-face{font-family:Inter;font-style:normal;font-weight:100 900;font-display:swap;src:url(/ray-template/docs/assets/inter-roman-latin-ext.4ZJIpNVo.woff2) format("woff2");unicode-range:U+0100-02AF,U+0304,U+0308,U+0329,U+1E00-1E9F,U+1EF2-1EFF,U+2020,U+20A0-20AB,U+20AD-20C0,U+2113,U+2C60-2C7F,U+A720-A7FF}@font-face{font-family:Inter;font-style:normal;font-weight:100 900;font-display:swap;src:url(/ray-template/docs/assets/inter-roman-latin.Di8DUHzh.woff2) format("woff2");unicode-range:U+0000-00FF,U+0131,U+0152-0153,U+02BB-02BC,U+02C6,U+02DA,U+02DC,U+0304,U+0308,U+0329,U+2000-206F,U+2074,U+20AC,U+2122,U+2191,U+2193,U+2212,U+2215,U+FEFF,U+FFFD}@font-face{font-family:Inter;font-style:italic;font-weight:100 900;font-display:swap;src:url(/ray-template/docs/assets/inter-italic-cyrillic-ext.r48I6akx.woff2) format("woff2");unicode-range:U+0460-052F,U+1C80-1C88,U+20B4,U+2DE0-2DFF,U+A640-A69F,U+FE2E-FE2F}@font-face{font-family:Inter;font-style:italic;font-weight:100 900;font-display:swap;src:url(/ray-template/docs/assets/inter-italic-cyrillic.By2_1cv3.woff2) format("woff2");unicode-range:U+0301,U+0400-045F,U+0490-0491,U+04B0-04B1,U+2116}@font-face{font-family:Inter;font-style:italic;font-weight:100 900;font-display:swap;src:url(/ray-template/docs/assets/inter-italic-greek-ext.1u6EdAuj.woff2) format("woff2");unicode-range:U+1F00-1FFF}@font-face{font-family:Inter;font-style:italic;font-weight:100 900;font-display:swap;src:url(/ray-template/docs/assets/inter-italic-greek.DJ8dCoTZ.woff2) format("woff2");unicode-range:U+0370-0377,U+037A-037F,U+0384-038A,U+038C,U+038E-03A1,U+03A3-03FF}@font-face{font-family:Inter;font-style:italic;font-weight:100 900;font-display:swap;src:url(/ray-template/docs/assets/inter-italic-vietnamese.BSbpV94h.woff2) format("woff2");unicode-range:U+0102-0103,U+0110-0111,U+0128-0129,U+0168-0169,U+01A0-01A1,U+01AF-01B0,U+0300-0301,U+0303-0304,U+0308-0309,U+0323,U+0329,U+1EA0-1EF9,U+20AB}@font-face{font-family:Inter;font-style:italic;font-weight:100 900;font-display:swap;src:url(/ray-template/docs/assets/inter-italic-latin-ext.CN1xVJS-.woff2) format("woff2");unicode-range:U+0100-02AF,U+0304,U+0308,U+0329,U+1E00-1E9F,U+1EF2-1EFF,U+2020,U+20A0-20AB,U+20AD-20C0,U+2113,U+2C60-2C7F,U+A720-A7FF}@font-face{font-family:Inter;font-style:italic;font-weight:100 900;font-display:swap;src:url(/ray-template/docs/assets/inter-italic-latin.C2AdPX0b.woff2) format("woff2");unicode-range:U+0000-00FF,U+0131,U+0152-0153,U+02BB-02BC,U+02C6,U+02DA,U+02DC,U+0304,U+0308,U+0329,U+2000-206F,U+2074,U+20AC,U+2122,U+2191,U+2193,U+2212,U+2215,U+FEFF,U+FFFD}@font-face{font-family:Punctuation SC;font-weight:400;src:local("PingFang SC Regular"),local("Noto Sans CJK SC"),local("Microsoft YaHei");unicode-range:U+201C,U+201D,U+2018,U+2019,U+2E3A,U+2014,U+2013,U+2026,U+00B7,U+007E,U+002F}@font-face{font-family:Punctuation SC;font-weight:500;src:local("PingFang SC Medium"),local("Noto Sans CJK SC"),local("Microsoft YaHei");unicode-range:U+201C,U+201D,U+2018,U+2019,U+2E3A,U+2014,U+2013,U+2026,U+00B7,U+007E,U+002F}@font-face{font-family:Punctuation SC;font-weight:600;src:local("PingFang SC Semibold"),local("Noto Sans CJK SC Bold"),local("Microsoft YaHei Bold");unicode-range:U+201C,U+201D,U+2018,U+2019,U+2E3A,U+2014,U+2013,U+2026,U+00B7,U+007E,U+002F}@font-face{font-family:Punctuation SC;font-weight:700;src:local("PingFang SC Semibold"),local("Noto Sans CJK SC Bold"),local("Microsoft YaHei Bold");unicode-range:U+201C,U+201D,U+2018,U+2019,U+2E3A,U+2014,U+2013,U+2026,U+00B7,U+007E,U+002F}:root{--vp-c-white: #ffffff;--vp-c-black: #000000;--vp-c-neutral: var(--vp-c-black);--vp-c-neutral-inverse: var(--vp-c-white)}.dark{--vp-c-neutral: var(--vp-c-white);--vp-c-neutral-inverse: var(--vp-c-black)}:root{--vp-c-gray-1: #dddde3;--vp-c-gray-2: #e4e4e9;--vp-c-gray-3: #ebebef;--vp-c-gray-soft: rgba(142, 150, 170, .14);--vp-c-indigo-1: #3451b2;--vp-c-indigo-2: #3a5ccc;--vp-c-indigo-3: #5672cd;--vp-c-indigo-soft: rgba(100, 108, 255, .14);--vp-c-purple-1: #6f42c1;--vp-c-purple-2: #7e4cc9;--vp-c-purple-3: #8e5cd9;--vp-c-purple-soft: rgba(159, 122, 234, .14);--vp-c-green-1: #18794e;--vp-c-green-2: #299764;--vp-c-green-3: #30a46c;--vp-c-green-soft: rgba(16, 185, 129, .14);--vp-c-yellow-1: #915930;--vp-c-yellow-2: #946300;--vp-c-yellow-3: #9f6a00;--vp-c-yellow-soft: rgba(234, 179, 8, .14);--vp-c-red-1: #b8272c;--vp-c-red-2: #d5393e;--vp-c-red-3: #e0575b;--vp-c-red-soft: rgba(244, 63, 94, .14);--vp-c-sponsor: #db2777}.dark{--vp-c-gray-1: #515c67;--vp-c-gray-2: #414853;--vp-c-gray-3: #32363f;--vp-c-gray-soft: rgba(101, 117, 133, .16);--vp-c-indigo-1: #a8b1ff;--vp-c-indigo-2: #5c73e7;--vp-c-indigo-3: #3e63dd;--vp-c-indigo-soft: rgba(100, 108, 255, .16);--vp-c-purple-1: #c8abfa;--vp-c-purple-2: #a879e6;--vp-c-purple-3: #8e5cd9;--vp-c-purple-soft: rgba(159, 122, 234, .16);--vp-c-green-1: #3dd68c;--vp-c-green-2: #30a46c;--vp-c-green-3: #298459;--vp-c-green-soft: rgba(16, 185, 129, .16);--vp-c-yellow-1: #f9b44e;--vp-c-yellow-2: #da8b17;--vp-c-yellow-3: #a46a0a;--vp-c-yellow-soft: rgba(234, 179, 8, .16);--vp-c-red-1: #f66f81;--vp-c-red-2: #f14158;--vp-c-red-3: #b62a3c;--vp-c-red-soft: rgba(244, 63, 94, .16)}:root{--vp-c-bg: #ffffff;--vp-c-bg-alt: #f6f6f7;--vp-c-bg-elv: #ffffff;--vp-c-bg-soft: #f6f6f7}.dark{--vp-c-bg: #1b1b1f;--vp-c-bg-alt: #161618;--vp-c-bg-elv: #202127;--vp-c-bg-soft: #202127}:root{--vp-c-border: #c2c2c4;--vp-c-divider: #e2e2e3;--vp-c-gutter: #e2e2e3}.dark{--vp-c-border: #3c3f44;--vp-c-divider: #2e2e32;--vp-c-gutter: #000000}:root{--vp-c-text-1: #3c3c43;--vp-c-text-2: #67676c;--vp-c-text-3: #929295}.dark{--vp-c-text-1: #dfdfd6;--vp-c-text-2: #98989f;--vp-c-text-3: #6a6a71}:root{--vp-c-default-1: var(--vp-c-gray-1);--vp-c-default-2: var(--vp-c-gray-2);--vp-c-default-3: var(--vp-c-gray-3);--vp-c-default-soft: var(--vp-c-gray-soft);--vp-c-brand-1: var(--vp-c-indigo-1);--vp-c-brand-2: var(--vp-c-indigo-2);--vp-c-brand-3: var(--vp-c-indigo-3);--vp-c-brand-soft: var(--vp-c-indigo-soft);--vp-c-brand: var(--vp-c-brand-1);--vp-c-tip-1: var(--vp-c-brand-1);--vp-c-tip-2: var(--vp-c-brand-2);--vp-c-tip-3: var(--vp-c-brand-3);--vp-c-tip-soft: var(--vp-c-brand-soft);--vp-c-note-1: var(--vp-c-brand-1);--vp-c-note-2: var(--vp-c-brand-2);--vp-c-note-3: var(--vp-c-brand-3);--vp-c-note-soft: var(--vp-c-brand-soft);--vp-c-success-1: var(--vp-c-green-1);--vp-c-success-2: var(--vp-c-green-2);--vp-c-success-3: var(--vp-c-green-3);--vp-c-success-soft: var(--vp-c-green-soft);--vp-c-important-1: var(--vp-c-purple-1);--vp-c-important-2: var(--vp-c-purple-2);--vp-c-important-3: var(--vp-c-purple-3);--vp-c-important-soft: var(--vp-c-purple-soft);--vp-c-warning-1: var(--vp-c-yellow-1);--vp-c-warning-2: var(--vp-c-yellow-2);--vp-c-warning-3: var(--vp-c-yellow-3);--vp-c-warning-soft: var(--vp-c-yellow-soft);--vp-c-danger-1: var(--vp-c-red-1);--vp-c-danger-2: var(--vp-c-red-2);--vp-c-danger-3: var(--vp-c-red-3);--vp-c-danger-soft: var(--vp-c-red-soft);--vp-c-caution-1: var(--vp-c-red-1);--vp-c-caution-2: var(--vp-c-red-2);--vp-c-caution-3: var(--vp-c-red-3);--vp-c-caution-soft: var(--vp-c-red-soft)}:root{--vp-font-family-base: "Inter", ui-sans-serif, system-ui, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji";--vp-font-family-mono: ui-monospace, "Menlo", "Monaco", "Consolas", "Liberation Mono", "Courier New", monospace;font-optical-sizing:auto}:root:where(:lang(zh)){--vp-font-family-base: "Punctuation SC", "Inter", ui-sans-serif, system-ui, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji"}:root{--vp-shadow-1: 0 1px 2px rgba(0, 0, 0, .04), 0 1px 2px rgba(0, 0, 0, .06);--vp-shadow-2: 0 3px 12px rgba(0, 0, 0, .07), 0 1px 4px rgba(0, 0, 0, .07);--vp-shadow-3: 0 12px 32px rgba(0, 0, 0, .1), 0 2px 6px rgba(0, 0, 0, .08);--vp-shadow-4: 0 14px 44px rgba(0, 0, 0, .12), 0 3px 9px rgba(0, 0, 0, .12);--vp-shadow-5: 0 18px 56px rgba(0, 0, 0, .16), 0 4px 12px rgba(0, 0, 0, .16)}:root{--vp-z-index-footer: 10;--vp-z-index-local-nav: 20;--vp-z-index-nav: 30;--vp-z-index-layout-top: 40;--vp-z-index-backdrop: 50;--vp-z-index-sidebar: 60}@media(min-width:960px){:root{--vp-z-index-sidebar: 25}}:root{--vp-layout-max-width: 1440px}:root{--vp-header-anchor-symbol: "#"}:root{--vp-code-line-height: 1.7;--vp-code-font-size: .875em;--vp-code-color: var(--vp-c-brand-1);--vp-code-link-color: var(--vp-c-brand-1);--vp-code-link-hover-color: var(--vp-c-brand-2);--vp-code-bg: var(--vp-c-default-soft);--vp-code-block-color: var(--vp-c-text-2);--vp-code-block-bg: var(--vp-c-bg-alt);--vp-code-block-divider-color: var(--vp-c-gutter);--vp-code-lang-color: var(--vp-c-text-3);--vp-code-line-highlight-color: var(--vp-c-default-soft);--vp-code-line-number-color: var(--vp-c-text-3);--vp-code-line-diff-add-color: var(--vp-c-success-soft);--vp-code-line-diff-add-symbol-color: var(--vp-c-success-1);--vp-code-line-diff-remove-color: var(--vp-c-danger-soft);--vp-code-line-diff-remove-symbol-color: var(--vp-c-danger-1);--vp-code-line-warning-color: var(--vp-c-warning-soft);--vp-code-line-error-color: var(--vp-c-danger-soft);--vp-code-copy-code-border-color: var(--vp-c-divider);--vp-code-copy-code-bg: var(--vp-c-bg-soft);--vp-code-copy-code-hover-border-color: var(--vp-c-divider);--vp-code-copy-code-hover-bg: var(--vp-c-bg);--vp-code-copy-code-active-text: var(--vp-c-text-2);--vp-code-copy-copied-text-content: "Copied";--vp-code-tab-divider: var(--vp-code-block-divider-color);--vp-code-tab-text-color: var(--vp-c-text-2);--vp-code-tab-bg: var(--vp-code-block-bg);--vp-code-tab-hover-text-color: var(--vp-c-text-1);--vp-code-tab-active-text-color: var(--vp-c-text-1);--vp-code-tab-active-bar-color: var(--vp-c-brand-1)}:lang(es),:lang(pt){--vp-code-copy-copied-text-content: "Copiado"}:lang(fa){--vp-code-copy-copied-text-content: "کپی شد"}:lang(ko){--vp-code-copy-copied-text-content: "복사됨"}:lang(ru){--vp-code-copy-copied-text-content: "Скопировано"}:lang(zh){--vp-code-copy-copied-text-content: "已复制"}:root{--vp-button-brand-border: transparent;--vp-button-brand-text: var(--vp-c-white);--vp-button-brand-bg: var(--vp-c-brand-3);--vp-button-brand-hover-border: transparent;--vp-button-brand-hover-text: var(--vp-c-white);--vp-button-brand-hover-bg: var(--vp-c-brand-2);--vp-button-brand-active-border: transparent;--vp-button-brand-active-text: var(--vp-c-white);--vp-button-brand-active-bg: var(--vp-c-brand-1);--vp-button-alt-border: transparent;--vp-button-alt-text: var(--vp-c-text-1);--vp-button-alt-bg: var(--vp-c-default-3);--vp-button-alt-hover-border: transparent;--vp-button-alt-hover-text: var(--vp-c-text-1);--vp-button-alt-hover-bg: var(--vp-c-default-2);--vp-button-alt-active-border: transparent;--vp-button-alt-active-text: var(--vp-c-text-1);--vp-button-alt-active-bg: var(--vp-c-default-1);--vp-button-sponsor-border: var(--vp-c-text-2);--vp-button-sponsor-text: var(--vp-c-text-2);--vp-button-sponsor-bg: transparent;--vp-button-sponsor-hover-border: var(--vp-c-sponsor);--vp-button-sponsor-hover-text: var(--vp-c-sponsor);--vp-button-sponsor-hover-bg: transparent;--vp-button-sponsor-active-border: var(--vp-c-sponsor);--vp-button-sponsor-active-text: var(--vp-c-sponsor);--vp-button-sponsor-active-bg: transparent}:root{--vp-custom-block-font-size: 14px;--vp-custom-block-code-font-size: 13px;--vp-custom-block-info-border: transparent;--vp-custom-block-info-text: var(--vp-c-text-1);--vp-custom-block-info-bg: var(--vp-c-default-soft);--vp-custom-block-info-code-bg: var(--vp-c-default-soft);--vp-custom-block-note-border: transparent;--vp-custom-block-note-text: var(--vp-c-text-1);--vp-custom-block-note-bg: var(--vp-c-default-soft);--vp-custom-block-note-code-bg: var(--vp-c-default-soft);--vp-custom-block-tip-border: transparent;--vp-custom-block-tip-text: var(--vp-c-text-1);--vp-custom-block-tip-bg: var(--vp-c-tip-soft);--vp-custom-block-tip-code-bg: var(--vp-c-tip-soft);--vp-custom-block-important-border: transparent;--vp-custom-block-important-text: var(--vp-c-text-1);--vp-custom-block-important-bg: var(--vp-c-important-soft);--vp-custom-block-important-code-bg: var(--vp-c-important-soft);--vp-custom-block-warning-border: transparent;--vp-custom-block-warning-text: var(--vp-c-text-1);--vp-custom-block-warning-bg: var(--vp-c-warning-soft);--vp-custom-block-warning-code-bg: var(--vp-c-warning-soft);--vp-custom-block-danger-border: transparent;--vp-custom-block-danger-text: var(--vp-c-text-1);--vp-custom-block-danger-bg: var(--vp-c-danger-soft);--vp-custom-block-danger-code-bg: var(--vp-c-danger-soft);--vp-custom-block-caution-border: transparent;--vp-custom-block-caution-text: var(--vp-c-text-1);--vp-custom-block-caution-bg: var(--vp-c-caution-soft);--vp-custom-block-caution-code-bg: var(--vp-c-caution-soft);--vp-custom-block-details-border: var(--vp-custom-block-info-border);--vp-custom-block-details-text: var(--vp-custom-block-info-text);--vp-custom-block-details-bg: var(--vp-custom-block-info-bg);--vp-custom-block-details-code-bg: var(--vp-custom-block-info-code-bg)}:root{--vp-input-border-color: var(--vp-c-border);--vp-input-bg-color: var(--vp-c-bg-alt);--vp-input-switch-bg-color: var(--vp-c-default-soft)}:root{--vp-nav-height: 64px;--vp-nav-bg-color: var(--vp-c-bg);--vp-nav-screen-bg-color: var(--vp-c-bg);--vp-nav-logo-height: 24px}.hide-nav{--vp-nav-height: 0px}.hide-nav .VPSidebar{--vp-nav-height: 22px}:root{--vp-local-nav-bg-color: var(--vp-c-bg)}:root{--vp-sidebar-width: 272px;--vp-sidebar-bg-color: var(--vp-c-bg-alt)}:root{--vp-backdrop-bg-color: rgba(0, 0, 0, .6)}:root{--vp-home-hero-name-color: var(--vp-c-brand-1);--vp-home-hero-name-background: transparent;--vp-home-hero-image-background-image: none;--vp-home-hero-image-filter: none}:root{--vp-badge-info-border: transparent;--vp-badge-info-text: var(--vp-c-text-2);--vp-badge-info-bg: var(--vp-c-default-soft);--vp-badge-tip-border: transparent;--vp-badge-tip-text: var(--vp-c-tip-1);--vp-badge-tip-bg: var(--vp-c-tip-soft);--vp-badge-warning-border: transparent;--vp-badge-warning-text: var(--vp-c-warning-1);--vp-badge-warning-bg: var(--vp-c-warning-soft);--vp-badge-danger-border: transparent;--vp-badge-danger-text: var(--vp-c-danger-1);--vp-badge-danger-bg: var(--vp-c-danger-soft)}:root{--vp-carbon-ads-text-color: var(--vp-c-text-1);--vp-carbon-ads-poweredby-color: var(--vp-c-text-2);--vp-carbon-ads-bg-color: var(--vp-c-bg-soft);--vp-carbon-ads-hover-text-color: var(--vp-c-brand-1);--vp-carbon-ads-hover-poweredby-color: var(--vp-c-text-1)}:root{--vp-local-search-bg: var(--vp-c-bg);--vp-local-search-result-bg: var(--vp-c-bg);--vp-local-search-result-border: var(--vp-c-divider);--vp-local-search-result-selected-bg: var(--vp-c-bg);--vp-local-search-result-selected-border: var(--vp-c-brand-1);--vp-local-search-highlight-bg: var(--vp-c-brand-1);--vp-local-search-highlight-text: var(--vp-c-neutral-inverse)}@media(prefers-reduced-motion:reduce){*,:before,:after{animation-delay:-1ms!important;animation-duration:1ms!important;animation-iteration-count:1!important;background-attachment:initial!important;scroll-behavior:auto!important;transition-duration:0s!important;transition-delay:0s!important}}*,:before,:after{box-sizing:border-box}html{line-height:1.4;font-size:16px;-webkit-text-size-adjust:100%}html.dark{color-scheme:dark}body{margin:0;width:100%;min-width:320px;min-height:100vh;line-height:24px;font-family:var(--vp-font-family-base);font-size:16px;font-weight:400;color:var(--vp-c-text-1);background-color:var(--vp-c-bg);font-synthesis:style;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}main{display:block}h1,h2,h3,h4,h5,h6{margin:0;line-height:24px;font-size:16px;font-weight:400}p{margin:0}strong,b{font-weight:600}a,area,button,[role=button],input,label,select,summary,textarea{touch-action:manipulation}a{color:inherit;text-decoration:inherit}ol,ul{list-style:none;margin:0;padding:0}blockquote{margin:0}pre,code,kbd,samp{font-family:var(--vp-font-family-mono)}img,svg,video,canvas,audio,iframe,embed,object{display:block}figure{margin:0}img,video{max-width:100%;height:auto}button,input,optgroup,select,textarea{border:0;padding:0;line-height:inherit;color:inherit}button{padding:0;font-family:inherit;background-color:transparent;background-image:none}button:enabled,[role=button]:enabled{cursor:pointer}button:focus,button:focus-visible{outline:1px dotted;outline:4px auto -webkit-focus-ring-color}button:focus:not(:focus-visible){outline:none!important}input:focus,textarea:focus,select:focus{outline:none}table{border-collapse:collapse}input{background-color:transparent}input:-ms-input-placeholder,textarea:-ms-input-placeholder{color:var(--vp-c-text-3)}input::-ms-input-placeholder,textarea::-ms-input-placeholder{color:var(--vp-c-text-3)}input::placeholder,textarea::placeholder{color:var(--vp-c-text-3)}input::-webkit-outer-spin-button,input::-webkit-inner-spin-button{-webkit-appearance:none;margin:0}input[type=number]{-moz-appearance:textfield}textarea{resize:vertical}select{-webkit-appearance:none}fieldset{margin:0;padding:0}h1,h2,h3,h4,h5,h6,li,p{overflow-wrap:break-word}vite-error-overlay{z-index:9999}mjx-container{overflow-x:auto}mjx-container>svg{display:inline-block;margin:auto}[class^=vpi-],[class*=" vpi-"],.vp-icon{width:1em;height:1em}[class^=vpi-].bg,[class*=" vpi-"].bg,.vp-icon.bg{background-size:100% 100%;background-color:transparent}[class^=vpi-]:not(.bg),[class*=" vpi-"]:not(.bg),.vp-icon:not(.bg){-webkit-mask:var(--icon) no-repeat;mask:var(--icon) no-repeat;-webkit-mask-size:100% 100%;mask-size:100% 100%;background-color:currentColor;color:inherit}.vpi-align-left{--icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Cpath d='M21 6H3M15 12H3M17 18H3'/%3E%3C/svg%3E")}.vpi-arrow-right,.vpi-arrow-down,.vpi-arrow-left,.vpi-arrow-up{--icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Cpath d='M5 12h14M12 5l7 7-7 7'/%3E%3C/svg%3E")}.vpi-chevron-right,.vpi-chevron-down,.vpi-chevron-left,.vpi-chevron-up{--icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Cpath d='m9 18 6-6-6-6'/%3E%3C/svg%3E")}.vpi-chevron-down,.vpi-arrow-down{transform:rotate(90deg)}.vpi-chevron-left,.vpi-arrow-left{transform:rotate(180deg)}.vpi-chevron-up,.vpi-arrow-up{transform:rotate(-90deg)}.vpi-square-pen{--icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Cpath d='M12 3H5a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2v-7'/%3E%3Cpath d='M18.375 2.625a2.121 2.121 0 1 1 3 3L12 15l-4 1 1-4Z'/%3E%3C/svg%3E")}.vpi-plus{--icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Cpath d='M5 12h14M12 5v14'/%3E%3C/svg%3E")}.vpi-sun{--icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Ccircle cx='12' cy='12' r='4'/%3E%3Cpath d='M12 2v2M12 20v2M4.93 4.93l1.41 1.41M17.66 17.66l1.41 1.41M2 12h2M20 12h2M6.34 17.66l-1.41 1.41M19.07 4.93l-1.41 1.41'/%3E%3C/svg%3E")}.vpi-moon{--icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Cpath d='M12 3a6 6 0 0 0 9 9 9 9 0 1 1-9-9Z'/%3E%3C/svg%3E")}.vpi-more-horizontal{--icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Ccircle cx='12' cy='12' r='1'/%3E%3Ccircle cx='19' cy='12' r='1'/%3E%3Ccircle cx='5' cy='12' r='1'/%3E%3C/svg%3E")}.vpi-languages{--icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Cpath d='m5 8 6 6M4 14l6-6 2-3M2 5h12M7 2h1M22 22l-5-10-5 10M14 18h6'/%3E%3C/svg%3E")}.vpi-heart{--icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Cpath d='M19 14c1.49-1.46 3-3.21 3-5.5A5.5 5.5 0 0 0 16.5 3c-1.76 0-3 .5-4.5 2-1.5-1.5-2.74-2-4.5-2A5.5 5.5 0 0 0 2 8.5c0 2.3 1.5 4.05 3 5.5l7 7Z'/%3E%3C/svg%3E")}.vpi-search{--icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Ccircle cx='11' cy='11' r='8'/%3E%3Cpath d='m21 21-4.3-4.3'/%3E%3C/svg%3E")}.vpi-layout-list{--icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Crect width='7' height='7' x='3' y='3' rx='1'/%3E%3Crect width='7' height='7' x='3' y='14' rx='1'/%3E%3Cpath d='M14 4h7M14 9h7M14 15h7M14 20h7'/%3E%3C/svg%3E")}.vpi-delete{--icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Cpath d='M20 5H9l-7 7 7 7h11a2 2 0 0 0 2-2V7a2 2 0 0 0-2-2ZM18 9l-6 6M12 9l6 6'/%3E%3C/svg%3E")}.vpi-corner-down-left{--icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Cpath d='m9 10-5 5 5 5'/%3E%3Cpath d='M20 4v7a4 4 0 0 1-4 4H4'/%3E%3C/svg%3E")}:root{--vp-icon-copy: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='rgba(128,128,128,1)' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Crect width='8' height='4' x='8' y='2' rx='1' ry='1'/%3E%3Cpath d='M16 4h2a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2V6a2 2 0 0 1 2-2h2'/%3E%3C/svg%3E");--vp-icon-copied: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='rgba(128,128,128,1)' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Crect width='8' height='4' x='8' y='2' rx='1' ry='1'/%3E%3Cpath d='M16 4h2a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2V6a2 2 0 0 1 2-2h2'/%3E%3Cpath d='m9 14 2 2 4-4'/%3E%3C/svg%3E")}.visually-hidden{position:absolute;width:1px;height:1px;white-space:nowrap;clip:rect(0 0 0 0);clip-path:inset(50%);overflow:hidden}.custom-block{border:1px solid transparent;border-radius:8px;padding:16px 16px 8px;line-height:24px;font-size:var(--vp-custom-block-font-size);color:var(--vp-c-text-2)}.custom-block.info{border-color:var(--vp-custom-block-info-border);color:var(--vp-custom-block-info-text);background-color:var(--vp-custom-block-info-bg)}.custom-block.info a,.custom-block.info code{color:var(--vp-c-brand-1)}.custom-block.info a:hover,.custom-block.info a:hover>code{color:var(--vp-c-brand-2)}.custom-block.info code{background-color:var(--vp-custom-block-info-code-bg)}.custom-block.note{border-color:var(--vp-custom-block-note-border);color:var(--vp-custom-block-note-text);background-color:var(--vp-custom-block-note-bg)}.custom-block.note a,.custom-block.note code{color:var(--vp-c-brand-1)}.custom-block.note a:hover,.custom-block.note a:hover>code{color:var(--vp-c-brand-2)}.custom-block.note code{background-color:var(--vp-custom-block-note-code-bg)}.custom-block.tip{border-color:var(--vp-custom-block-tip-border);color:var(--vp-custom-block-tip-text);background-color:var(--vp-custom-block-tip-bg)}.custom-block.tip a,.custom-block.tip code{color:var(--vp-c-tip-1)}.custom-block.tip a:hover,.custom-block.tip a:hover>code{color:var(--vp-c-tip-2)}.custom-block.tip code{background-color:var(--vp-custom-block-tip-code-bg)}.custom-block.important{border-color:var(--vp-custom-block-important-border);color:var(--vp-custom-block-important-text);background-color:var(--vp-custom-block-important-bg)}.custom-block.important a,.custom-block.important code{color:var(--vp-c-important-1)}.custom-block.important a:hover,.custom-block.important a:hover>code{color:var(--vp-c-important-2)}.custom-block.important code{background-color:var(--vp-custom-block-important-code-bg)}.custom-block.warning{border-color:var(--vp-custom-block-warning-border);color:var(--vp-custom-block-warning-text);background-color:var(--vp-custom-block-warning-bg)}.custom-block.warning a,.custom-block.warning code{color:var(--vp-c-warning-1)}.custom-block.warning a:hover,.custom-block.warning a:hover>code{color:var(--vp-c-warning-2)}.custom-block.warning code{background-color:var(--vp-custom-block-warning-code-bg)}.custom-block.danger{border-color:var(--vp-custom-block-danger-border);color:var(--vp-custom-block-danger-text);background-color:var(--vp-custom-block-danger-bg)}.custom-block.danger a,.custom-block.danger code{color:var(--vp-c-danger-1)}.custom-block.danger a:hover,.custom-block.danger a:hover>code{color:var(--vp-c-danger-2)}.custom-block.danger code{background-color:var(--vp-custom-block-danger-code-bg)}.custom-block.caution{border-color:var(--vp-custom-block-caution-border);color:var(--vp-custom-block-caution-text);background-color:var(--vp-custom-block-caution-bg)}.custom-block.caution a,.custom-block.caution code{color:var(--vp-c-caution-1)}.custom-block.caution a:hover,.custom-block.caution a:hover>code{color:var(--vp-c-caution-2)}.custom-block.caution code{background-color:var(--vp-custom-block-caution-code-bg)}.custom-block.details{border-color:var(--vp-custom-block-details-border);color:var(--vp-custom-block-details-text);background-color:var(--vp-custom-block-details-bg)}.custom-block.details a{color:var(--vp-c-brand-1)}.custom-block.details a:hover,.custom-block.details a:hover>code{color:var(--vp-c-brand-2)}.custom-block.details code{background-color:var(--vp-custom-block-details-code-bg)}.custom-block-title{font-weight:600}.custom-block p+p{margin:8px 0}.custom-block.details summary{margin:0 0 8px;font-weight:700;cursor:pointer;-webkit-user-select:none;user-select:none}.custom-block.details summary+p{margin:8px 0}.custom-block a{color:inherit;font-weight:600;text-decoration:underline;text-underline-offset:2px;transition:opacity .25s}.custom-block a:hover{opacity:.75}.custom-block code{font-size:var(--vp-custom-block-code-font-size)}.custom-block.custom-block th,.custom-block.custom-block blockquote>p{font-size:var(--vp-custom-block-font-size);color:inherit}.dark .vp-code span{color:var(--shiki-dark, inherit)}html:not(.dark) .vp-code span{color:var(--shiki-light, inherit)}.vp-code-group{margin-top:16px}.vp-code-group .tabs{position:relative;display:flex;margin-right:-24px;margin-left:-24px;padding:0 12px;background-color:var(--vp-code-tab-bg);overflow-x:auto;overflow-y:hidden;box-shadow:inset 0 -1px var(--vp-code-tab-divider)}@media(min-width:640px){.vp-code-group .tabs{margin-right:0;margin-left:0;border-radius:8px 8px 0 0}}.vp-code-group .tabs input{position:fixed;opacity:0;pointer-events:none}.vp-code-group .tabs label{position:relative;display:inline-block;border-bottom:1px solid transparent;padding:0 12px;line-height:48px;font-size:14px;font-weight:500;color:var(--vp-code-tab-text-color);white-space:nowrap;cursor:pointer;transition:color .25s}.vp-code-group .tabs label:after{position:absolute;right:8px;bottom:-1px;left:8px;z-index:1;height:2px;border-radius:2px;content:"";background-color:transparent;transition:background-color .25s}.vp-code-group label:hover{color:var(--vp-code-tab-hover-text-color)}.vp-code-group input:checked+label{color:var(--vp-code-tab-active-text-color)}.vp-code-group input:checked+label:after{background-color:var(--vp-code-tab-active-bar-color)}.vp-code-group div[class*=language-],.vp-block{display:none;margin-top:0!important;border-top-left-radius:0!important;border-top-right-radius:0!important}.vp-code-group div[class*=language-].active,.vp-block.active{display:block}.vp-block{padding:20px 24px}.vp-doc h1,.vp-doc h2,.vp-doc h3,.vp-doc h4,.vp-doc h5,.vp-doc h6{position:relative;font-weight:600;outline:none}.vp-doc h1{letter-spacing:-.02em;line-height:40px;font-size:28px}.vp-doc h2{margin:48px 0 16px;border-top:1px solid var(--vp-c-divider);padding-top:24px;letter-spacing:-.02em;line-height:32px;font-size:24px}.vp-doc h3{margin:32px 0 0;letter-spacing:-.01em;line-height:28px;font-size:20px}.vp-doc h4{margin:24px 0 0;letter-spacing:-.01em;line-height:24px;font-size:18px}.vp-doc .header-anchor{position:absolute;top:0;left:0;margin-left:-.87em;font-weight:500;-webkit-user-select:none;user-select:none;opacity:0;text-decoration:none;transition:color .25s,opacity .25s}.vp-doc .header-anchor:before{content:var(--vp-header-anchor-symbol)}.vp-doc h1:hover .header-anchor,.vp-doc h1 .header-anchor:focus,.vp-doc h2:hover .header-anchor,.vp-doc h2 .header-anchor:focus,.vp-doc h3:hover .header-anchor,.vp-doc h3 .header-anchor:focus,.vp-doc h4:hover .header-anchor,.vp-doc h4 .header-anchor:focus,.vp-doc h5:hover .header-anchor,.vp-doc h5 .header-anchor:focus,.vp-doc h6:hover .header-anchor,.vp-doc h6 .header-anchor:focus{opacity:1}@media(min-width:768px){.vp-doc h1{letter-spacing:-.02em;line-height:40px;font-size:32px}}.vp-doc h2 .header-anchor{top:24px}.vp-doc p,.vp-doc summary{margin:16px 0}.vp-doc p{line-height:28px}.vp-doc blockquote{margin:16px 0;border-left:2px solid var(--vp-c-divider);padding-left:16px;transition:border-color .5s;color:var(--vp-c-text-2)}.vp-doc blockquote>p{margin:0;font-size:16px;transition:color .5s}.vp-doc a{font-weight:500;color:var(--vp-c-brand-1);text-decoration:underline;text-underline-offset:2px;transition:color .25s,opacity .25s}.vp-doc a:hover{color:var(--vp-c-brand-2)}.vp-doc strong{font-weight:600}.vp-doc ul,.vp-doc ol{padding-left:1.25rem;margin:16px 0}.vp-doc ul{list-style:disc}.vp-doc ol{list-style:decimal}.vp-doc li+li{margin-top:8px}.vp-doc li>ol,.vp-doc li>ul{margin:8px 0 0}.vp-doc table{display:block;border-collapse:collapse;margin:20px 0;overflow-x:auto}.vp-doc tr{background-color:var(--vp-c-bg);border-top:1px solid var(--vp-c-divider);transition:background-color .5s}.vp-doc tr:nth-child(2n){background-color:var(--vp-c-bg-soft)}.vp-doc th,.vp-doc td{border:1px solid var(--vp-c-divider);padding:8px 16px}.vp-doc th{text-align:left;font-size:14px;font-weight:600;color:var(--vp-c-text-2);background-color:var(--vp-c-bg-soft)}.vp-doc td{font-size:14px}.vp-doc hr{margin:16px 0;border:none;border-top:1px solid var(--vp-c-divider)}.vp-doc .custom-block{margin:16px 0}.vp-doc .custom-block p{margin:8px 0;line-height:24px}.vp-doc .custom-block p:first-child{margin:0}.vp-doc .custom-block div[class*=language-]{margin:8px 0;border-radius:8px}.vp-doc .custom-block div[class*=language-] code{font-weight:400;background-color:transparent}.vp-doc .custom-block .vp-code-group .tabs{margin:0;border-radius:8px 8px 0 0}.vp-doc :not(pre,h1,h2,h3,h4,h5,h6)>code{font-size:var(--vp-code-font-size);color:var(--vp-code-color)}.vp-doc :not(pre)>code{border-radius:4px;padding:3px 6px;background-color:var(--vp-code-bg);transition:color .25s,background-color .5s}.vp-doc a>code{color:var(--vp-code-link-color)}.vp-doc a:hover>code{color:var(--vp-code-link-hover-color)}.vp-doc h1>code,.vp-doc h2>code,.vp-doc h3>code,.vp-doc h4>code{font-size:.9em}.vp-doc div[class*=language-],.vp-block{position:relative;margin:16px -24px;background-color:var(--vp-code-block-bg);overflow-x:auto;transition:background-color .5s}@media(min-width:640px){.vp-doc div[class*=language-],.vp-block{border-radius:8px;margin:16px 0}}@media(max-width:639px){.vp-doc li div[class*=language-]{border-radius:8px 0 0 8px}}.vp-doc div[class*=language-]+div[class*=language-],.vp-doc div[class$=-api]+div[class*=language-],.vp-doc div[class*=language-]+div[class$=-api]>div[class*=language-]{margin-top:-8px}.vp-doc [class*=language-] pre,.vp-doc [class*=language-] code{direction:ltr;text-align:left;white-space:pre;word-spacing:normal;word-break:normal;word-wrap:normal;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-hyphens:none;-moz-hyphens:none;-ms-hyphens:none;hyphens:none}.vp-doc [class*=language-] pre{position:relative;z-index:1;margin:0;padding:20px 0;background:transparent;overflow-x:auto}.vp-doc [class*=language-] code{display:block;padding:0 24px;width:fit-content;min-width:100%;line-height:var(--vp-code-line-height);font-size:var(--vp-code-font-size);color:var(--vp-code-block-color);transition:color .5s}.vp-doc [class*=language-] code .highlighted{background-color:var(--vp-code-line-highlight-color);transition:background-color .5s;margin:0 -24px;padding:0 24px;width:calc(100% + 48px);display:inline-block}.vp-doc [class*=language-] code .highlighted.error{background-color:var(--vp-code-line-error-color)}.vp-doc [class*=language-] code .highlighted.warning{background-color:var(--vp-code-line-warning-color)}.vp-doc [class*=language-] code .diff{transition:background-color .5s;margin:0 -24px;padding:0 24px;width:calc(100% + 48px);display:inline-block}.vp-doc [class*=language-] code .diff:before{position:absolute;left:10px}.vp-doc [class*=language-] .has-focused-lines .line:not(.has-focus){filter:blur(.095rem);opacity:.4;transition:filter .35s,opacity .35s}.vp-doc [class*=language-] .has-focused-lines .line:not(.has-focus){opacity:.7;transition:filter .35s,opacity .35s}.vp-doc [class*=language-]:hover .has-focused-lines .line:not(.has-focus){filter:blur(0);opacity:1}.vp-doc [class*=language-] code .diff.remove{background-color:var(--vp-code-line-diff-remove-color);opacity:.7}.vp-doc [class*=language-] code .diff.remove:before{content:"-";color:var(--vp-code-line-diff-remove-symbol-color)}.vp-doc [class*=language-] code .diff.add{background-color:var(--vp-code-line-diff-add-color)}.vp-doc [class*=language-] code .diff.add:before{content:"+";color:var(--vp-code-line-diff-add-symbol-color)}.vp-doc div[class*=language-].line-numbers-mode{padding-left:32px}.vp-doc .line-numbers-wrapper{position:absolute;top:0;bottom:0;left:0;z-index:3;border-right:1px solid var(--vp-code-block-divider-color);padding-top:20px;width:32px;text-align:center;font-family:var(--vp-font-family-mono);line-height:var(--vp-code-line-height);font-size:var(--vp-code-font-size);color:var(--vp-code-line-number-color);transition:border-color .5s,color .5s}.vp-doc [class*=language-]>button.copy{direction:ltr;position:absolute;top:12px;right:12px;z-index:3;border:1px solid var(--vp-code-copy-code-border-color);border-radius:4px;width:40px;height:40px;background-color:var(--vp-code-copy-code-bg);opacity:0;cursor:pointer;background-image:var(--vp-icon-copy);background-position:50%;background-size:20px;background-repeat:no-repeat;transition:border-color .25s,background-color .25s,opacity .25s}.vp-doc [class*=language-]:hover>button.copy,.vp-doc [class*=language-]>button.copy:focus{opacity:1}.vp-doc [class*=language-]>button.copy:hover,.vp-doc [class*=language-]>button.copy.copied{border-color:var(--vp-code-copy-code-hover-border-color);background-color:var(--vp-code-copy-code-hover-bg)}.vp-doc [class*=language-]>button.copy.copied,.vp-doc [class*=language-]>button.copy:hover.copied{border-radius:0 4px 4px 0;background-color:var(--vp-code-copy-code-hover-bg);background-image:var(--vp-icon-copied)}.vp-doc [class*=language-]>button.copy.copied:before,.vp-doc [class*=language-]>button.copy:hover.copied:before{position:relative;top:-1px;transform:translate(calc(-100% - 1px));display:flex;justify-content:center;align-items:center;border:1px solid var(--vp-code-copy-code-hover-border-color);border-right:0;border-radius:4px 0 0 4px;padding:0 10px;width:fit-content;height:40px;text-align:center;font-size:12px;font-weight:500;color:var(--vp-code-copy-code-active-text);background-color:var(--vp-code-copy-code-hover-bg);white-space:nowrap;content:var(--vp-code-copy-copied-text-content)}.vp-doc [class*=language-]>span.lang{position:absolute;top:2px;right:8px;z-index:2;font-size:12px;font-weight:500;-webkit-user-select:none;user-select:none;color:var(--vp-code-lang-color);transition:color .4s,opacity .4s}.vp-doc [class*=language-]:hover>button.copy+span.lang,.vp-doc [class*=language-]>button.copy:focus+span.lang{opacity:0}.vp-doc .VPTeamMembers{margin-top:24px}.vp-doc .VPTeamMembers.small.count-1 .container{margin:0!important;max-width:calc((100% - 24px)/2)!important}.vp-doc .VPTeamMembers.small.count-2 .container,.vp-doc .VPTeamMembers.small.count-3 .container{max-width:100%!important}.vp-doc .VPTeamMembers.medium.count-1 .container{margin:0!important;max-width:calc((100% - 24px)/2)!important}:is(.vp-external-link-icon,.vp-doc a[href*="://"],.vp-doc a[target=_blank]):not(:is(.no-icon,svg a,:has(img,svg))):after{display:inline-block;margin-top:-1px;margin-left:4px;width:11px;height:11px;background:currentColor;color:var(--vp-c-text-3);flex-shrink:0;--icon: url("data:image/svg+xml, %3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' %3E%3Cpath d='M0 0h24v24H0V0z' fill='none' /%3E%3Cpath d='M9 5v2h6.59L4 18.59 5.41 20 17 8.41V15h2V5H9z' /%3E%3C/svg%3E");-webkit-mask-image:var(--icon);mask-image:var(--icon)}.vp-external-link-icon:after{content:""}.external-link-icon-enabled :is(.vp-doc a[href*="://"],.vp-doc a[target=_blank]):not(:is(.no-icon,svg a,:has(img,svg))):after{content:"";color:currentColor}.vp-sponsor{border-radius:16px;overflow:hidden}.vp-sponsor.aside{border-radius:12px}.vp-sponsor-section+.vp-sponsor-section{margin-top:4px}.vp-sponsor-tier{margin:0 0 4px!important;text-align:center;letter-spacing:1px!important;line-height:24px;width:100%;font-weight:600;color:var(--vp-c-text-2);background-color:var(--vp-c-bg-soft)}.vp-sponsor.normal .vp-sponsor-tier{padding:13px 0 11px;font-size:14px}.vp-sponsor.aside .vp-sponsor-tier{padding:9px 0 7px;font-size:12px}.vp-sponsor-grid+.vp-sponsor-tier{margin-top:4px}.vp-sponsor-grid{display:flex;flex-wrap:wrap;gap:4px}.vp-sponsor-grid.xmini .vp-sponsor-grid-link{height:64px}.vp-sponsor-grid.xmini .vp-sponsor-grid-image{max-width:64px;max-height:22px}.vp-sponsor-grid.mini .vp-sponsor-grid-link{height:72px}.vp-sponsor-grid.mini .vp-sponsor-grid-image{max-width:96px;max-height:24px}.vp-sponsor-grid.small .vp-sponsor-grid-link{height:96px}.vp-sponsor-grid.small .vp-sponsor-grid-image{max-width:96px;max-height:24px}.vp-sponsor-grid.medium .vp-sponsor-grid-link{height:112px}.vp-sponsor-grid.medium .vp-sponsor-grid-image{max-width:120px;max-height:36px}.vp-sponsor-grid.big .vp-sponsor-grid-link{height:184px}.vp-sponsor-grid.big .vp-sponsor-grid-image{max-width:192px;max-height:56px}.vp-sponsor-grid[data-vp-grid="2"] .vp-sponsor-grid-item{width:calc((100% - 4px)/2)}.vp-sponsor-grid[data-vp-grid="3"] .vp-sponsor-grid-item{width:calc((100% - 4px * 2) / 3)}.vp-sponsor-grid[data-vp-grid="4"] .vp-sponsor-grid-item{width:calc((100% - 12px)/4)}.vp-sponsor-grid[data-vp-grid="5"] .vp-sponsor-grid-item{width:calc((100% - 16px)/5)}.vp-sponsor-grid[data-vp-grid="6"] .vp-sponsor-grid-item{width:calc((100% - 4px * 5) / 6)}.vp-sponsor-grid-item{flex-shrink:0;width:100%;background-color:var(--vp-c-bg-soft);transition:background-color .25s}.vp-sponsor-grid-item:hover{background-color:var(--vp-c-default-soft)}.vp-sponsor-grid-item:hover .vp-sponsor-grid-image{filter:grayscale(0) invert(0)}.vp-sponsor-grid-item.empty:hover{background-color:var(--vp-c-bg-soft)}.dark .vp-sponsor-grid-item:hover{background-color:var(--vp-c-white)}.dark .vp-sponsor-grid-item.empty:hover{background-color:var(--vp-c-bg-soft)}.vp-sponsor-grid-link{display:flex}.vp-sponsor-grid-box{display:flex;justify-content:center;align-items:center;width:100%}.vp-sponsor-grid-image{max-width:100%;filter:grayscale(1);transition:filter .25s}.dark .vp-sponsor-grid-image{filter:grayscale(1) invert(1)}.VPBadge{display:inline-block;margin-left:2px;border:1px solid transparent;border-radius:12px;padding:0 10px;line-height:22px;font-size:12px;font-weight:500;transform:translateY(-2px)}.VPBadge.small{padding:0 6px;line-height:18px;font-size:10px;transform:translateY(-8px)}.VPDocFooter .VPBadge{display:none}.vp-doc h1>.VPBadge{margin-top:4px;vertical-align:top}.vp-doc h2>.VPBadge{margin-top:3px;padding:0 8px;vertical-align:top}.vp-doc h3>.VPBadge{vertical-align:middle}.vp-doc h4>.VPBadge,.vp-doc h5>.VPBadge,.vp-doc h6>.VPBadge{vertical-align:middle;line-height:18px}.VPBadge.info{border-color:var(--vp-badge-info-border);color:var(--vp-badge-info-text);background-color:var(--vp-badge-info-bg)}.VPBadge.tip{border-color:var(--vp-badge-tip-border);color:var(--vp-badge-tip-text);background-color:var(--vp-badge-tip-bg)}.VPBadge.warning{border-color:var(--vp-badge-warning-border);color:var(--vp-badge-warning-text);background-color:var(--vp-badge-warning-bg)}.VPBadge.danger{border-color:var(--vp-badge-danger-border);color:var(--vp-badge-danger-text);background-color:var(--vp-badge-danger-bg)}.VPBackdrop[data-v-ce96ec35]{position:fixed;top:0;right:0;bottom:0;left:0;z-index:var(--vp-z-index-backdrop);background:var(--vp-backdrop-bg-color);transition:opacity .5s}.VPBackdrop.fade-enter-from[data-v-ce96ec35],.VPBackdrop.fade-leave-to[data-v-ce96ec35]{opacity:0}.VPBackdrop.fade-leave-active[data-v-ce96ec35]{transition-duration:.25s}@media(min-width:1280px){.VPBackdrop[data-v-ce96ec35]{display:none}}.NotFound[data-v-1eb4640a]{padding:64px 24px 96px;text-align:center}@media(min-width:768px){.NotFound[data-v-1eb4640a]{padding:96px 32px 168px}}.code[data-v-1eb4640a]{line-height:64px;font-size:64px;font-weight:600}.title[data-v-1eb4640a]{padding-top:12px;letter-spacing:2px;line-height:20px;font-size:20px;font-weight:700}.divider[data-v-1eb4640a]{margin:24px auto 18px;width:64px;height:1px;background-color:var(--vp-c-divider)}.quote[data-v-1eb4640a]{margin:0 auto;max-width:256px;font-size:14px;font-weight:500;color:var(--vp-c-text-2)}.action[data-v-1eb4640a]{padding-top:20px}.link[data-v-1eb4640a]{display:inline-block;border:1px solid var(--vp-c-brand-1);border-radius:16px;padding:3px 16px;font-size:14px;font-weight:500;color:var(--vp-c-brand-1);transition:border-color .25s,color .25s}.link[data-v-1eb4640a]:hover{border-color:var(--vp-c-brand-2);color:var(--vp-c-brand-2)}.root[data-v-78a615b5]{position:relative;z-index:1}.nested[data-v-78a615b5]{padding-right:16px;padding-left:16px}.outline-link[data-v-78a615b5]{display:block;line-height:32px;font-size:14px;font-weight:400;color:var(--vp-c-text-2);white-space:nowrap;overflow:hidden;text-overflow:ellipsis;transition:color .5s}.outline-link[data-v-78a615b5]:hover,.outline-link.active[data-v-78a615b5]{color:var(--vp-c-text-1);transition:color .25s}.outline-link.nested[data-v-78a615b5]{padding-left:13px}.VPDocAsideOutline[data-v-a849a091]{display:none}.VPDocAsideOutline.has-outline[data-v-a849a091]{display:block}.content[data-v-a849a091]{position:relative;border-left:1px solid var(--vp-c-divider);padding-left:16px;font-size:13px;font-weight:500}.outline-marker[data-v-a849a091]{position:absolute;top:32px;left:-1px;z-index:0;opacity:0;width:2px;border-radius:2px;height:18px;background-color:var(--vp-c-brand-1);transition:top .25s cubic-bezier(0,1,.5,1),background-color .5s,opacity .25s}.outline-title[data-v-a849a091]{line-height:32px;font-size:14px;font-weight:600}.VPDocAside[data-v-6d31e1a2]{display:flex;flex-direction:column;flex-grow:1}.spacer[data-v-6d31e1a2]{flex-grow:1}.VPDocAside[data-v-6d31e1a2] .spacer+.VPDocAsideSponsors,.VPDocAside[data-v-6d31e1a2] .spacer+.VPDocAsideCarbonAds{margin-top:24px}.VPDocAside[data-v-6d31e1a2] .VPDocAsideSponsors+.VPDocAsideCarbonAds{margin-top:16px}.VPLastUpdated[data-v-490d5539]{line-height:24px;font-size:14px;font-weight:500;color:var(--vp-c-text-2)}@media(min-width:640px){.VPLastUpdated[data-v-490d5539]{line-height:32px;font-size:14px;font-weight:500}}.VPDocFooter[data-v-028296d9]{margin-top:64px}.edit-info[data-v-028296d9]{padding-bottom:18px}@media(min-width:640px){.edit-info[data-v-028296d9]{display:flex;justify-content:space-between;align-items:center;padding-bottom:14px}}.edit-link-button[data-v-028296d9]{display:flex;align-items:center;border:0;line-height:32px;font-size:14px;font-weight:500;color:var(--vp-c-brand-1);transition:color .25s}.edit-link-button[data-v-028296d9]:hover{color:var(--vp-c-brand-2)}.edit-link-icon[data-v-028296d9]{margin-right:8px}.prev-next[data-v-028296d9]{border-top:1px solid var(--vp-c-divider);padding-top:24px;display:grid;grid-row-gap:8px}@media(min-width:640px){.prev-next[data-v-028296d9]{grid-template-columns:repeat(2,1fr);grid-column-gap:16px}}.pager-link[data-v-028296d9]{display:block;border:1px solid var(--vp-c-divider);border-radius:8px;padding:11px 16px 13px;width:100%;height:100%;transition:border-color .25s}.pager-link[data-v-028296d9]:hover{border-color:var(--vp-c-brand-1)}.pager-link.next[data-v-028296d9]{margin-left:auto;text-align:right}.desc[data-v-028296d9]{display:block;line-height:20px;font-size:12px;font-weight:500;color:var(--vp-c-text-2)}.title[data-v-028296d9]{display:block;line-height:20px;font-size:14px;font-weight:500;color:var(--vp-c-brand-1);transition:color .25s}.VPDoc[data-v-b0483432]{padding:32px 24px 96px;width:100%}@media(min-width:768px){.VPDoc[data-v-b0483432]{padding:48px 32px 128px}}@media(min-width:960px){.VPDoc[data-v-b0483432]{padding:48px 32px 0}.VPDoc:not(.has-sidebar) .container[data-v-b0483432]{display:flex;justify-content:center;max-width:992px}.VPDoc:not(.has-sidebar) .content[data-v-b0483432]{max-width:752px}}@media(min-width:1280px){.VPDoc .container[data-v-b0483432]{display:flex;justify-content:center}.VPDoc .aside[data-v-b0483432]{display:block}}@media(min-width:1440px){.VPDoc:not(.has-sidebar) .content[data-v-b0483432]{max-width:784px}.VPDoc:not(.has-sidebar) .container[data-v-b0483432]{max-width:1104px}}.container[data-v-b0483432]{margin:0 auto;width:100%}.aside[data-v-b0483432]{position:relative;display:none;order:2;flex-grow:1;padding-left:32px;width:100%;max-width:256px}.left-aside[data-v-b0483432]{order:1;padding-left:unset;padding-right:32px}.aside-container[data-v-b0483432]{position:fixed;top:0;padding-top:calc(var(--vp-nav-height) + var(--vp-layout-top-height, 0px) + var(--vp-doc-top-height, 0px) + 48px);width:224px;height:100vh;overflow-x:hidden;overflow-y:auto;scrollbar-width:none}.aside-container[data-v-b0483432]::-webkit-scrollbar{display:none}.aside-curtain[data-v-b0483432]{position:fixed;bottom:0;z-index:10;width:224px;height:32px;background:linear-gradient(transparent,var(--vp-c-bg) 70%)}.aside-content[data-v-b0483432]{display:flex;flex-direction:column;min-height:calc(100vh - (var(--vp-nav-height) + var(--vp-layout-top-height, 0px) + 48px));padding-bottom:32px}.content[data-v-b0483432]{position:relative;margin:0 auto;width:100%}@media(min-width:960px){.content[data-v-b0483432]{padding:0 32px 128px}}@media(min-width:1280px){.content[data-v-b0483432]{order:1;margin:0;min-width:640px}}.content-container[data-v-b0483432]{margin:0 auto}.VPDoc.has-aside .content-container[data-v-b0483432]{max-width:688px}.VPButton[data-v-32834a2d]{display:inline-block;border:1px solid transparent;text-align:center;font-weight:600;white-space:nowrap;transition:color .25s,border-color .25s,background-color .25s}.VPButton[data-v-32834a2d]:active{transition:color .1s,border-color .1s,background-color .1s}.VPButton.medium[data-v-32834a2d]{border-radius:20px;padding:0 20px;line-height:38px;font-size:14px}.VPButton.big[data-v-32834a2d]{border-radius:24px;padding:0 24px;line-height:46px;font-size:16px}.VPButton.brand[data-v-32834a2d]{border-color:var(--vp-button-brand-border);color:var(--vp-button-brand-text);background-color:var(--vp-button-brand-bg)}.VPButton.brand[data-v-32834a2d]:hover{border-color:var(--vp-button-brand-hover-border);color:var(--vp-button-brand-hover-text);background-color:var(--vp-button-brand-hover-bg)}.VPButton.brand[data-v-32834a2d]:active{border-color:var(--vp-button-brand-active-border);color:var(--vp-button-brand-active-text);background-color:var(--vp-button-brand-active-bg)}.VPButton.alt[data-v-32834a2d]{border-color:var(--vp-button-alt-border);color:var(--vp-button-alt-text);background-color:var(--vp-button-alt-bg)}.VPButton.alt[data-v-32834a2d]:hover{border-color:var(--vp-button-alt-hover-border);color:var(--vp-button-alt-hover-text);background-color:var(--vp-button-alt-hover-bg)}.VPButton.alt[data-v-32834a2d]:active{border-color:var(--vp-button-alt-active-border);color:var(--vp-button-alt-active-text);background-color:var(--vp-button-alt-active-bg)}.VPButton.sponsor[data-v-32834a2d]{border-color:var(--vp-button-sponsor-border);color:var(--vp-button-sponsor-text);background-color:var(--vp-button-sponsor-bg)}.VPButton.sponsor[data-v-32834a2d]:hover{border-color:var(--vp-button-sponsor-hover-border);color:var(--vp-button-sponsor-hover-text);background-color:var(--vp-button-sponsor-hover-bg)}.VPButton.sponsor[data-v-32834a2d]:active{border-color:var(--vp-button-sponsor-active-border);color:var(--vp-button-sponsor-active-text);background-color:var(--vp-button-sponsor-active-bg)}html:not(.dark) .VPImage.dark[data-v-a9cdc337]{display:none}.dark .VPImage.light[data-v-a9cdc337]{display:none}.VPHero[data-v-941f646e]{margin-top:calc((var(--vp-nav-height) + var(--vp-layout-top-height, 0px)) * -1);padding:calc(var(--vp-nav-height) + var(--vp-layout-top-height, 0px) + 48px) 24px 48px}@media(min-width:640px){.VPHero[data-v-941f646e]{padding:calc(var(--vp-nav-height) + var(--vp-layout-top-height, 0px) + 80px) 48px 64px}}@media(min-width:960px){.VPHero[data-v-941f646e]{padding:calc(var(--vp-nav-height) + var(--vp-layout-top-height, 0px) + 80px) 64px 64px}}.container[data-v-941f646e]{display:flex;flex-direction:column;margin:0 auto;max-width:1152px}@media(min-width:960px){.container[data-v-941f646e]{flex-direction:row}}.main[data-v-941f646e]{position:relative;z-index:10;order:2;flex-grow:1;flex-shrink:0}.VPHero.has-image .container[data-v-941f646e]{text-align:center}@media(min-width:960px){.VPHero.has-image .container[data-v-941f646e]{text-align:left}}@media(min-width:960px){.main[data-v-941f646e]{order:1;width:calc((100% / 3) * 2)}.VPHero.has-image .main[data-v-941f646e]{max-width:592px}}.heading[data-v-941f646e]{display:flex;flex-direction:column}.name[data-v-941f646e],.text[data-v-941f646e]{width:fit-content;max-width:392px;letter-spacing:-.4px;line-height:40px;font-size:32px;font-weight:700;white-space:pre-wrap}.VPHero.has-image .name[data-v-941f646e],.VPHero.has-image .text[data-v-941f646e]{margin:0 auto}.name[data-v-941f646e]{color:var(--vp-home-hero-name-color)}.clip[data-v-941f646e]{background:var(--vp-home-hero-name-background);-webkit-background-clip:text;background-clip:text;-webkit-text-fill-color:var(--vp-home-hero-name-color)}@media(min-width:640px){.name[data-v-941f646e],.text[data-v-941f646e]{max-width:576px;line-height:56px;font-size:48px}}@media(min-width:960px){.name[data-v-941f646e],.text[data-v-941f646e]{line-height:64px;font-size:56px}.VPHero.has-image .name[data-v-941f646e],.VPHero.has-image .text[data-v-941f646e]{margin:0}}.tagline[data-v-941f646e]{padding-top:8px;max-width:392px;line-height:28px;font-size:18px;font-weight:500;white-space:pre-wrap;color:var(--vp-c-text-2)}.VPHero.has-image .tagline[data-v-941f646e]{margin:0 auto}@media(min-width:640px){.tagline[data-v-941f646e]{padding-top:12px;max-width:576px;line-height:32px;font-size:20px}}@media(min-width:960px){.tagline[data-v-941f646e]{line-height:36px;font-size:24px}.VPHero.has-image .tagline[data-v-941f646e]{margin:0}}.actions[data-v-941f646e]{display:flex;flex-wrap:wrap;margin:-6px;padding-top:24px}.VPHero.has-image .actions[data-v-941f646e]{justify-content:center}@media(min-width:640px){.actions[data-v-941f646e]{padding-top:32px}}@media(min-width:960px){.VPHero.has-image .actions[data-v-941f646e]{justify-content:flex-start}}.action[data-v-941f646e]{flex-shrink:0;padding:6px}.image[data-v-941f646e]{order:1;margin:-76px -24px -48px}@media(min-width:640px){.image[data-v-941f646e]{margin:-108px -24px -48px}}@media(min-width:960px){.image[data-v-941f646e]{flex-grow:1;order:2;margin:0;min-height:100%}}.image-container[data-v-941f646e]{position:relative;margin:0 auto;width:320px;height:320px}@media(min-width:640px){.image-container[data-v-941f646e]{width:392px;height:392px}}@media(min-width:960px){.image-container[data-v-941f646e]{display:flex;justify-content:center;align-items:center;width:100%;height:100%;transform:translate(-32px,-32px)}}.image-bg[data-v-941f646e]{position:absolute;top:50%;left:50%;border-radius:50%;width:192px;height:192px;background-image:var(--vp-home-hero-image-background-image);filter:var(--vp-home-hero-image-filter);transform:translate(-50%,-50%)}@media(min-width:640px){.image-bg[data-v-941f646e]{width:256px;height:256px}}@media(min-width:960px){.image-bg[data-v-941f646e]{width:320px;height:320px}}[data-v-941f646e] .image-src{position:absolute;top:50%;left:50%;max-width:192px;max-height:192px;transform:translate(-50%,-50%)}@media(min-width:640px){[data-v-941f646e] .image-src{max-width:256px;max-height:256px}}@media(min-width:960px){[data-v-941f646e] .image-src{max-width:320px;max-height:320px}}.VPFeature[data-v-3348c7a6]{display:block;border:1px solid var(--vp-c-bg-soft);border-radius:12px;height:100%;background-color:var(--vp-c-bg-soft);transition:border-color .25s,background-color .25s}.VPFeature.link[data-v-3348c7a6]:hover{border-color:var(--vp-c-brand-1)}.box[data-v-3348c7a6]{display:flex;flex-direction:column;padding:24px;height:100%}.box[data-v-3348c7a6]>.VPImage{margin-bottom:20px}.icon[data-v-3348c7a6]{display:flex;justify-content:center;align-items:center;margin-bottom:20px;border-radius:6px;background-color:var(--vp-c-default-soft);width:48px;height:48px;font-size:24px;transition:background-color .25s}.title[data-v-3348c7a6]{line-height:24px;font-size:16px;font-weight:600}.details[data-v-3348c7a6]{flex-grow:1;padding-top:8px;line-height:24px;font-size:14px;font-weight:500;color:var(--vp-c-text-2)}.link-text[data-v-3348c7a6]{padding-top:8px}.link-text-value[data-v-3348c7a6]{display:flex;align-items:center;font-size:14px;font-weight:500;color:var(--vp-c-brand-1)}.link-text-icon[data-v-3348c7a6]{margin-left:6px}.VPFeatures[data-v-dbc98b8f]{position:relative;padding:0 24px}@media(min-width:640px){.VPFeatures[data-v-dbc98b8f]{padding:0 48px}}@media(min-width:960px){.VPFeatures[data-v-dbc98b8f]{padding:0 64px}}.container[data-v-dbc98b8f]{margin:0 auto;max-width:1152px}.items[data-v-dbc98b8f]{display:flex;flex-wrap:wrap;margin:-8px}.item[data-v-dbc98b8f]{padding:8px;width:100%}@media(min-width:640px){.item.grid-2[data-v-dbc98b8f],.item.grid-4[data-v-dbc98b8f],.item.grid-6[data-v-dbc98b8f]{width:50%}}@media(min-width:768px){.item.grid-2[data-v-dbc98b8f],.item.grid-4[data-v-dbc98b8f]{width:50%}.item.grid-3[data-v-dbc98b8f],.item.grid-6[data-v-dbc98b8f]{width:calc(100% / 3)}}@media(min-width:960px){.item.grid-4[data-v-dbc98b8f]{width:25%}}.container[data-v-b07866dd]{margin:auto;width:100%;max-width:1280px;padding:0 24px}@media(min-width:640px){.container[data-v-b07866dd]{padding:0 48px}}@media(min-width:960px){.container[data-v-b07866dd]{width:100%;padding:0 64px}}.vp-doc[data-v-b07866dd] .VPHomeSponsors,.vp-doc[data-v-b07866dd] .VPTeamPage{margin-left:var(--vp-offset, calc(50% - 50vw) );margin-right:var(--vp-offset, calc(50% - 50vw) )}.vp-doc[data-v-b07866dd] .VPHomeSponsors h2{border-top:none;letter-spacing:normal}.vp-doc[data-v-b07866dd] .VPHomeSponsors a,.vp-doc[data-v-b07866dd] .VPTeamPage a{text-decoration:none}.VPHome[data-v-5fa32eaa]{margin-bottom:96px}@media(min-width:768px){.VPHome[data-v-5fa32eaa]{margin-bottom:128px}}.VPContent[data-v-7ec33352]{flex-grow:1;flex-shrink:0;margin:var(--vp-layout-top-height, 0px) auto 0;width:100%}.VPContent.is-home[data-v-7ec33352]{width:100%;max-width:100%}.VPContent.has-sidebar[data-v-7ec33352]{margin:0}@media(min-width:960px){.VPContent[data-v-7ec33352]{padding-top:var(--vp-nav-height)}.VPContent.has-sidebar[data-v-7ec33352]{margin:var(--vp-layout-top-height, 0px) 0 0;padding-left:var(--vp-sidebar-width)}}@media(min-width:1440px){.VPContent.has-sidebar[data-v-7ec33352]{padding-right:calc((100vw - var(--vp-layout-max-width)) / 2);padding-left:calc((100vw - var(--vp-layout-max-width)) / 2 + var(--vp-sidebar-width))}}.VPFooter[data-v-20a32aa3]{position:relative;z-index:var(--vp-z-index-footer);border-top:1px solid var(--vp-c-gutter);padding:32px 24px;background-color:var(--vp-c-bg)}.VPFooter.has-sidebar[data-v-20a32aa3]{display:none}.VPFooter[data-v-20a32aa3] a{text-decoration-line:underline;text-underline-offset:2px;transition:color .25s}.VPFooter[data-v-20a32aa3] a:hover{color:var(--vp-c-text-1)}@media(min-width:768px){.VPFooter[data-v-20a32aa3]{padding:32px}}.container[data-v-20a32aa3]{margin:0 auto;max-width:var(--vp-layout-max-width);text-align:center}.message[data-v-20a32aa3],.copyright[data-v-20a32aa3]{line-height:24px;font-size:14px;font-weight:500;color:var(--vp-c-text-2)}.VPLocalNavOutlineDropdown[data-v-debc629b]{padding:12px 20px 11px}@media(min-width:960px){.VPLocalNavOutlineDropdown[data-v-debc629b]{padding:12px 36px 11px}}.VPLocalNavOutlineDropdown button[data-v-debc629b]{display:block;font-size:12px;font-weight:500;line-height:24px;color:var(--vp-c-text-2);transition:color .5s;position:relative}.VPLocalNavOutlineDropdown button[data-v-debc629b]:hover{color:var(--vp-c-text-1);transition:color .25s}.VPLocalNavOutlineDropdown button.open[data-v-debc629b]{color:var(--vp-c-text-1)}.icon[data-v-debc629b]{display:inline-block;vertical-align:middle;margin-left:2px;font-size:14px;transform:rotate(0);transition:transform .25s}@media(min-width:960px){.VPLocalNavOutlineDropdown button[data-v-debc629b]{font-size:14px}.icon[data-v-debc629b]{font-size:16px}}.open>.icon[data-v-debc629b]{transform:rotate(90deg)}.items[data-v-debc629b]{position:absolute;top:40px;right:16px;left:16px;display:grid;gap:1px;border:1px solid var(--vp-c-border);border-radius:8px;background-color:var(--vp-c-gutter);max-height:calc(var(--vp-vh, 100vh) - 86px);overflow:hidden auto;box-shadow:var(--vp-shadow-3)}@media(min-width:960px){.items[data-v-debc629b]{right:auto;left:calc(var(--vp-sidebar-width) + 32px);width:320px}}.header[data-v-debc629b]{background-color:var(--vp-c-bg-soft)}.top-link[data-v-debc629b]{display:block;padding:0 16px;line-height:48px;font-size:14px;font-weight:500;color:var(--vp-c-brand-1)}.outline[data-v-debc629b]{padding:8px 0;background-color:var(--vp-c-bg-soft)}.flyout-enter-active[data-v-debc629b]{transition:all .2s ease-out}.flyout-leave-active[data-v-debc629b]{transition:all .15s ease-in}.flyout-enter-from[data-v-debc629b],.flyout-leave-to[data-v-debc629b]{opacity:0;transform:translateY(-16px)}.VPLocalNav[data-v-60478e07]{position:sticky;top:0;left:0;z-index:var(--vp-z-index-local-nav);border-bottom:1px solid var(--vp-c-gutter);padding-top:var(--vp-layout-top-height, 0px);width:100%;background-color:var(--vp-local-nav-bg-color)}.VPLocalNav.fixed[data-v-60478e07]{position:fixed}@media(min-width:960px){.VPLocalNav[data-v-60478e07]{top:var(--vp-nav-height)}.VPLocalNav.has-sidebar[data-v-60478e07]{padding-left:var(--vp-sidebar-width)}.VPLocalNav.empty[data-v-60478e07]{display:none}}@media(min-width:1280px){.VPLocalNav[data-v-60478e07]{display:none}}@media(min-width:1440px){.VPLocalNav.has-sidebar[data-v-60478e07]{padding-left:calc((100vw - var(--vp-layout-max-width)) / 2 + var(--vp-sidebar-width))}}.container[data-v-60478e07]{display:flex;justify-content:space-between;align-items:center}.menu[data-v-60478e07]{display:flex;align-items:center;padding:12px 24px 11px;line-height:24px;font-size:12px;font-weight:500;color:var(--vp-c-text-2);transition:color .5s}.menu[data-v-60478e07]:hover{color:var(--vp-c-text-1);transition:color .25s}@media(min-width:768px){.menu[data-v-60478e07]{padding:0 32px}}@media(min-width:960px){.menu[data-v-60478e07]{display:none}}.menu-icon[data-v-60478e07]{margin-right:8px;font-size:14px}.VPOutlineDropdown[data-v-60478e07]{padding:12px 24px 11px}@media(min-width:768px){.VPOutlineDropdown[data-v-60478e07]{padding:12px 32px 11px}}.VPSwitch[data-v-54e91c08]{position:relative;border-radius:11px;display:block;width:40px;height:22px;flex-shrink:0;border:1px solid var(--vp-input-border-color);background-color:var(--vp-input-switch-bg-color);transition:border-color .25s!important}.VPSwitch[data-v-54e91c08]:hover{border-color:var(--vp-c-brand-1)}.check[data-v-54e91c08]{position:absolute;top:1px;left:1px;width:18px;height:18px;border-radius:50%;background-color:var(--vp-c-neutral-inverse);box-shadow:var(--vp-shadow-1);transition:transform .25s!important}.icon[data-v-54e91c08]{position:relative;display:block;width:18px;height:18px;border-radius:50%;overflow:hidden}.icon[data-v-54e91c08] [class^=vpi-]{position:absolute;top:3px;left:3px;width:12px;height:12px;color:var(--vp-c-text-2)}.dark .icon[data-v-54e91c08] [class^=vpi-]{color:var(--vp-c-text-1);transition:opacity .25s!important}.sun[data-v-2b76c23f]{opacity:1}.moon[data-v-2b76c23f],.dark .sun[data-v-2b76c23f]{opacity:0}.dark .moon[data-v-2b76c23f]{opacity:1}.dark .VPSwitchAppearance[data-v-2b76c23f] .check{transform:translate(18px)}.VPNavBarAppearance[data-v-a4a103b4]{display:none}@media(min-width:1280px){.VPNavBarAppearance[data-v-a4a103b4]{display:flex;align-items:center}}.VPMenuGroup+.VPMenuLink[data-v-3dce307f]{margin:12px -12px 0;border-top:1px solid var(--vp-c-divider);padding:12px 12px 0}.link[data-v-3dce307f]{display:block;border-radius:6px;padding:0 12px;line-height:32px;font-size:14px;font-weight:500;color:var(--vp-c-text-1);white-space:nowrap;transition:background-color .25s,color .25s}.link[data-v-3dce307f]:hover{color:var(--vp-c-brand-1);background-color:var(--vp-c-default-soft)}.link.active[data-v-3dce307f]{color:var(--vp-c-brand-1)}.VPMenuGroup[data-v-c2553465]{margin:12px -12px 0;border-top:1px solid var(--vp-c-divider);padding:12px 12px 0}.VPMenuGroup[data-v-c2553465]:first-child{margin-top:0;border-top:0;padding-top:0}.VPMenuGroup+.VPMenuGroup[data-v-c2553465]{margin-top:12px;border-top:1px solid var(--vp-c-divider)}.title[data-v-c2553465]{padding:0 12px;line-height:32px;font-size:14px;font-weight:600;color:var(--vp-c-text-2);white-space:nowrap;transition:color .25s}.VPMenu[data-v-80746065]{border-radius:12px;padding:12px;min-width:128px;border:1px solid var(--vp-c-divider);background-color:var(--vp-c-bg-elv);box-shadow:var(--vp-shadow-3);transition:background-color .5s;max-height:calc(100vh - var(--vp-nav-height));overflow-y:auto}.VPMenu[data-v-80746065] .group{margin:0 -12px;padding:0 12px 12px}.VPMenu[data-v-80746065] .group+.group{border-top:1px solid var(--vp-c-divider);padding:11px 12px 12px}.VPMenu[data-v-80746065] .group:last-child{padding-bottom:0}.VPMenu[data-v-80746065] .group+.item{border-top:1px solid var(--vp-c-divider);padding:11px 16px 0}.VPMenu[data-v-80746065] .item{padding:0 16px;white-space:nowrap}.VPMenu[data-v-80746065] .label{flex-grow:1;line-height:28px;font-size:12px;font-weight:500;color:var(--vp-c-text-2);transition:color .5s}.VPMenu[data-v-80746065] .action{padding-left:24px}.VPFlyout[data-v-57202eaf]{position:relative}.VPFlyout[data-v-57202eaf]:hover{color:var(--vp-c-brand-1);transition:color .25s}.VPFlyout:hover .text[data-v-57202eaf]{color:var(--vp-c-text-2)}.VPFlyout:hover .icon[data-v-57202eaf]{fill:var(--vp-c-text-2)}.VPFlyout.active .text[data-v-57202eaf]{color:var(--vp-c-brand-1)}.VPFlyout.active:hover .text[data-v-57202eaf]{color:var(--vp-c-brand-2)}.button[aria-expanded=false]+.menu[data-v-57202eaf]{opacity:0;visibility:hidden;transform:translateY(0)}.VPFlyout:hover .menu[data-v-57202eaf],.button[aria-expanded=true]+.menu[data-v-57202eaf]{opacity:1;visibility:visible;transform:translateY(0)}.button[data-v-57202eaf]{display:flex;align-items:center;padding:0 12px;height:var(--vp-nav-height);color:var(--vp-c-text-1);transition:color .5s}.text[data-v-57202eaf]{display:flex;align-items:center;line-height:var(--vp-nav-height);font-size:14px;font-weight:500;color:var(--vp-c-text-1);transition:color .25s}.option-icon[data-v-57202eaf]{margin-right:0;font-size:16px}.text-icon[data-v-57202eaf]{margin-left:4px;font-size:14px}.icon[data-v-57202eaf]{font-size:20px;transition:fill .25s}.menu[data-v-57202eaf]{position:absolute;top:calc(var(--vp-nav-height) / 2 + 20px);right:0;opacity:0;visibility:hidden;transition:opacity .25s,visibility .25s,transform .25s}.VPSocialLink[data-v-976d6037]{display:flex;justify-content:center;align-items:center;width:36px;height:36px;color:var(--vp-c-text-2);transition:color .5s}.VPSocialLink[data-v-976d6037]:hover{color:var(--vp-c-text-1);transition:color .25s}.VPSocialLink[data-v-976d6037]>svg,.VPSocialLink[data-v-976d6037]>[class^=vpi-social-]{width:20px;height:20px;fill:currentColor}.VPSocialLinks[data-v-91f5f172]{display:flex;justify-content:center}.VPNavBarExtra[data-v-766dd493]{display:none;margin-right:-12px}@media(min-width:768px){.VPNavBarExtra[data-v-766dd493]{display:block}}@media(min-width:1280px){.VPNavBarExtra[data-v-766dd493]{display:none}}.trans-title[data-v-766dd493]{padding:0 24px 0 12px;line-height:32px;font-size:14px;font-weight:700;color:var(--vp-c-text-1)}.item.appearance[data-v-766dd493],.item.social-links[data-v-766dd493]{display:flex;align-items:center;padding:0 12px}.item.appearance[data-v-766dd493]{min-width:176px}.appearance-action[data-v-766dd493]{margin-right:-2px}.social-links-list[data-v-766dd493]{margin:-4px -8px}.VPNavBarHamburger[data-v-0ee194e1]{display:flex;justify-content:center;align-items:center;width:48px;height:var(--vp-nav-height)}@media(min-width:768px){.VPNavBarHamburger[data-v-0ee194e1]{display:none}}.container[data-v-0ee194e1]{position:relative;width:16px;height:14px;overflow:hidden}.VPNavBarHamburger:hover .top[data-v-0ee194e1]{top:0;left:0;transform:translate(4px)}.VPNavBarHamburger:hover .middle[data-v-0ee194e1]{top:6px;left:0;transform:translate(0)}.VPNavBarHamburger:hover .bottom[data-v-0ee194e1]{top:12px;left:0;transform:translate(8px)}.VPNavBarHamburger.active .top[data-v-0ee194e1]{top:6px;transform:translate(0) rotate(225deg)}.VPNavBarHamburger.active .middle[data-v-0ee194e1]{top:6px;transform:translate(16px)}.VPNavBarHamburger.active .bottom[data-v-0ee194e1]{top:6px;transform:translate(0) rotate(135deg)}.VPNavBarHamburger.active:hover .top[data-v-0ee194e1],.VPNavBarHamburger.active:hover .middle[data-v-0ee194e1],.VPNavBarHamburger.active:hover .bottom[data-v-0ee194e1]{background-color:var(--vp-c-text-2);transition:top .25s,background-color .25s,transform .25s}.top[data-v-0ee194e1],.middle[data-v-0ee194e1],.bottom[data-v-0ee194e1]{position:absolute;width:16px;height:2px;background-color:var(--vp-c-text-1);transition:top .25s,background-color .5s,transform .25s}.top[data-v-0ee194e1]{top:0;left:0;transform:translate(0)}.middle[data-v-0ee194e1]{top:6px;left:0;transform:translate(8px)}.bottom[data-v-0ee194e1]{top:12px;left:0;transform:translate(4px)}.VPNavBarMenuLink[data-v-991603b8]{display:flex;align-items:center;padding:0 12px;line-height:var(--vp-nav-height);font-size:14px;font-weight:500;color:var(--vp-c-text-1);transition:color .25s}.VPNavBarMenuLink.active[data-v-991603b8],.VPNavBarMenuLink[data-v-991603b8]:hover{color:var(--vp-c-brand-1)}.VPNavBarMenu[data-v-49bcf2ef]{display:none}@media(min-width:768px){.VPNavBarMenu[data-v-49bcf2ef]{display:flex}}/*! @docsearch/css 3.8.2 | MIT License | © Algolia, Inc. and contributors | https://docsearch.algolia.com */:root{--docsearch-primary-color:#5468ff;--docsearch-text-color:#1c1e21;--docsearch-spacing:12px;--docsearch-icon-stroke-width:1.4;--docsearch-highlight-color:var(--docsearch-primary-color);--docsearch-muted-color:#969faf;--docsearch-container-background:rgba(101,108,133,.8);--docsearch-logo-color:#5468ff;--docsearch-modal-width:560px;--docsearch-modal-height:600px;--docsearch-modal-background:#f5f6f7;--docsearch-modal-shadow:inset 1px 1px 0 0 hsla(0,0%,100%,.5),0 3px 8px 0 #555a64;--docsearch-searchbox-height:56px;--docsearch-searchbox-background:#ebedf0;--docsearch-searchbox-focus-background:#fff;--docsearch-searchbox-shadow:inset 0 0 0 2px var(--docsearch-primary-color);--docsearch-hit-height:56px;--docsearch-hit-color:#444950;--docsearch-hit-active-color:#fff;--docsearch-hit-background:#fff;--docsearch-hit-shadow:0 1px 3px 0 #d4d9e1;--docsearch-key-gradient:linear-gradient(-225deg,#d5dbe4,#f8f8f8);--docsearch-key-shadow:inset 0 -2px 0 0 #cdcde6,inset 0 0 1px 1px #fff,0 1px 2px 1px rgba(30,35,90,.4);--docsearch-key-pressed-shadow:inset 0 -2px 0 0 #cdcde6,inset 0 0 1px 1px #fff,0 1px 1px 0 rgba(30,35,90,.4);--docsearch-footer-height:44px;--docsearch-footer-background:#fff;--docsearch-footer-shadow:0 -1px 0 0 #e0e3e8,0 -3px 6px 0 rgba(69,98,155,.12)}html[data-theme=dark]{--docsearch-text-color:#f5f6f7;--docsearch-container-background:rgba(9,10,17,.8);--docsearch-modal-background:#15172a;--docsearch-modal-shadow:inset 1px 1px 0 0 #2c2e40,0 3px 8px 0 #000309;--docsearch-searchbox-background:#090a11;--docsearch-searchbox-focus-background:#000;--docsearch-hit-color:#bec3c9;--docsearch-hit-shadow:none;--docsearch-hit-background:#090a11;--docsearch-key-gradient:linear-gradient(-26.5deg,#565872,#31355b);--docsearch-key-shadow:inset 0 -2px 0 0 #282d55,inset 0 0 1px 1px #51577d,0 2px 2px 0 rgba(3,4,9,.3);--docsearch-key-pressed-shadow:inset 0 -2px 0 0 #282d55,inset 0 0 1px 1px #51577d,0 1px 1px 0 #0304094d;--docsearch-footer-background:#1e2136;--docsearch-footer-shadow:inset 0 1px 0 0 rgba(73,76,106,.5),0 -4px 8px 0 rgba(0,0,0,.2);--docsearch-logo-color:#fff;--docsearch-muted-color:#7f8497}.DocSearch-Button{align-items:center;background:var(--docsearch-searchbox-background);border:0;border-radius:40px;color:var(--docsearch-muted-color);cursor:pointer;display:flex;font-weight:500;height:36px;justify-content:space-between;margin:0 0 0 16px;padding:0 8px;-webkit-user-select:none;user-select:none}.DocSearch-Button:active,.DocSearch-Button:focus,.DocSearch-Button:hover{background:var(--docsearch-searchbox-focus-background);box-shadow:var(--docsearch-searchbox-shadow);color:var(--docsearch-text-color);outline:none}.DocSearch-Button-Container{align-items:center;display:flex}.DocSearch-Search-Icon{stroke-width:1.6}.DocSearch-Button .DocSearch-Search-Icon{color:var(--docsearch-text-color)}.DocSearch-Button-Placeholder{font-size:1rem;padding:0 12px 0 6px}.DocSearch-Button-Keys{display:flex;min-width:calc(40px + .8em)}.DocSearch-Button-Key{align-items:center;background:var(--docsearch-key-gradient);border:0;border-radius:3px;box-shadow:var(--docsearch-key-shadow);color:var(--docsearch-muted-color);display:flex;height:18px;justify-content:center;margin-right:.4em;padding:0 0 2px;position:relative;top:-1px;width:20px}.DocSearch-Button-Key--pressed{box-shadow:var(--docsearch-key-pressed-shadow);transform:translate3d(0,1px,0)}@media(max-width:768px){.DocSearch-Button-Keys,.DocSearch-Button-Placeholder{display:none}}.DocSearch--active{overflow:hidden!important}.DocSearch-Container,.DocSearch-Container *{box-sizing:border-box}.DocSearch-Container{background-color:var(--docsearch-container-background);height:100vh;left:0;position:fixed;top:0;width:100vw;z-index:200}.DocSearch-Container a{text-decoration:none}.DocSearch-Link{-webkit-appearance:none;-moz-appearance:none;appearance:none;background:none;border:0;color:var(--docsearch-highlight-color);cursor:pointer;font:inherit;margin:0;padding:0}.DocSearch-Modal{background:var(--docsearch-modal-background);border-radius:6px;box-shadow:var(--docsearch-modal-shadow);flex-direction:column;margin:60px auto auto;max-width:var(--docsearch-modal-width);position:relative}.DocSearch-SearchBar{display:flex;padding:var(--docsearch-spacing) var(--docsearch-spacing) 0}.DocSearch-Form{align-items:center;background:var(--docsearch-searchbox-focus-background);border-radius:4px;box-shadow:var(--docsearch-searchbox-shadow);display:flex;height:var(--docsearch-searchbox-height);margin:0;padding:0 var(--docsearch-spacing);position:relative;width:100%}.DocSearch-Input{-webkit-appearance:none;-moz-appearance:none;appearance:none;background:transparent;border:0;color:var(--docsearch-text-color);flex:1;font:inherit;font-size:1.2em;height:100%;outline:none;padding:0 0 0 8px;width:80%}.DocSearch-Input::placeholder{color:var(--docsearch-muted-color);opacity:1}.DocSearch-Input::-webkit-search-cancel-button,.DocSearch-Input::-webkit-search-decoration,.DocSearch-Input::-webkit-search-results-button,.DocSearch-Input::-webkit-search-results-decoration{display:none}.DocSearch-LoadingIndicator,.DocSearch-MagnifierLabel,.DocSearch-Reset{margin:0;padding:0}.DocSearch-MagnifierLabel,.DocSearch-Reset{align-items:center;color:var(--docsearch-highlight-color);display:flex;justify-content:center}.DocSearch-Container--Stalled .DocSearch-MagnifierLabel,.DocSearch-LoadingIndicator{display:none}.DocSearch-Container--Stalled .DocSearch-LoadingIndicator{align-items:center;color:var(--docsearch-highlight-color);display:flex;justify-content:center}@media screen and (prefers-reduced-motion:reduce){.DocSearch-Reset{animation:none;-webkit-appearance:none;-moz-appearance:none;appearance:none;background:none;border:0;border-radius:50%;color:var(--docsearch-icon-color);cursor:pointer;right:0;stroke-width:var(--docsearch-icon-stroke-width)}}.DocSearch-Reset{animation:fade-in .1s ease-in forwards;-webkit-appearance:none;-moz-appearance:none;appearance:none;background:none;border:0;border-radius:50%;color:var(--docsearch-icon-color);cursor:pointer;padding:2px;right:0;stroke-width:var(--docsearch-icon-stroke-width)}.DocSearch-Reset[hidden]{display:none}.DocSearch-Reset:hover{color:var(--docsearch-highlight-color)}.DocSearch-LoadingIndicator svg,.DocSearch-MagnifierLabel svg{height:24px;width:24px}.DocSearch-Cancel{display:none}.DocSearch-Dropdown{max-height:calc(var(--docsearch-modal-height) - var(--docsearch-searchbox-height) - var(--docsearch-spacing) - var(--docsearch-footer-height));min-height:var(--docsearch-spacing);overflow-y:auto;overflow-y:overlay;padding:0 var(--docsearch-spacing);scrollbar-color:var(--docsearch-muted-color) var(--docsearch-modal-background);scrollbar-width:thin}.DocSearch-Dropdown::-webkit-scrollbar{width:12px}.DocSearch-Dropdown::-webkit-scrollbar-track{background:transparent}.DocSearch-Dropdown::-webkit-scrollbar-thumb{background-color:var(--docsearch-muted-color);border:3px solid var(--docsearch-modal-background);border-radius:20px}.DocSearch-Dropdown ul{list-style:none;margin:0;padding:0}.DocSearch-Label{font-size:.75em;line-height:1.6em}.DocSearch-Help,.DocSearch-Label{color:var(--docsearch-muted-color)}.DocSearch-Help{font-size:.9em;margin:0;-webkit-user-select:none;user-select:none}.DocSearch-Title{font-size:1.2em}.DocSearch-Logo a{display:flex}.DocSearch-Logo svg{color:var(--docsearch-logo-color);margin-left:8px}.DocSearch-Hits:last-of-type{margin-bottom:24px}.DocSearch-Hits mark{background:none;color:var(--docsearch-highlight-color)}.DocSearch-HitsFooter{color:var(--docsearch-muted-color);display:flex;font-size:.85em;justify-content:center;margin-bottom:var(--docsearch-spacing);padding:var(--docsearch-spacing)}.DocSearch-HitsFooter a{border-bottom:1px solid;color:inherit}.DocSearch-Hit{border-radius:4px;display:flex;padding-bottom:4px;position:relative}@media screen and (prefers-reduced-motion:reduce){.DocSearch-Hit--deleting{transition:none}}.DocSearch-Hit--deleting{opacity:0;transition:all .25s linear}@media screen and (prefers-reduced-motion:reduce){.DocSearch-Hit--favoriting{transition:none}}.DocSearch-Hit--favoriting{transform:scale(0);transform-origin:top center;transition:all .25s linear;transition-delay:.25s}.DocSearch-Hit a{background:var(--docsearch-hit-background);border-radius:4px;box-shadow:var(--docsearch-hit-shadow);display:block;padding-left:var(--docsearch-spacing);width:100%}.DocSearch-Hit-source{background:var(--docsearch-modal-background);color:var(--docsearch-highlight-color);font-size:.85em;font-weight:600;line-height:32px;margin:0 -4px;padding:8px 4px 0;position:sticky;top:0;z-index:10}.DocSearch-Hit-Tree{color:var(--docsearch-muted-color);height:var(--docsearch-hit-height);opacity:.5;stroke-width:var(--docsearch-icon-stroke-width);width:24px}.DocSearch-Hit[aria-selected=true] a{background-color:var(--docsearch-highlight-color)}.DocSearch-Hit[aria-selected=true] mark{text-decoration:underline}.DocSearch-Hit-Container{align-items:center;color:var(--docsearch-hit-color);display:flex;flex-direction:row;height:var(--docsearch-hit-height);padding:0 var(--docsearch-spacing) 0 0}.DocSearch-Hit-icon{height:20px;width:20px}.DocSearch-Hit-action,.DocSearch-Hit-icon{color:var(--docsearch-muted-color);stroke-width:var(--docsearch-icon-stroke-width)}.DocSearch-Hit-action{align-items:center;display:flex;height:22px;width:22px}.DocSearch-Hit-action svg{display:block;height:18px;width:18px}.DocSearch-Hit-action+.DocSearch-Hit-action{margin-left:6px}.DocSearch-Hit-action-button{-webkit-appearance:none;-moz-appearance:none;appearance:none;background:none;border:0;border-radius:50%;color:inherit;cursor:pointer;padding:2px}svg.DocSearch-Hit-Select-Icon{display:none}.DocSearch-Hit[aria-selected=true] .DocSearch-Hit-Select-Icon{display:block}.DocSearch-Hit-action-button:focus,.DocSearch-Hit-action-button:hover{background:#0003;transition:background-color .1s ease-in}@media screen and (prefers-reduced-motion:reduce){.DocSearch-Hit-action-button:focus,.DocSearch-Hit-action-button:hover{transition:none}}.DocSearch-Hit-action-button:focus path,.DocSearch-Hit-action-button:hover path{fill:#fff}.DocSearch-Hit-content-wrapper{display:flex;flex:1 1 auto;flex-direction:column;font-weight:500;justify-content:center;line-height:1.2em;margin:0 8px;overflow-x:hidden;position:relative;text-overflow:ellipsis;white-space:nowrap;width:80%}.DocSearch-Hit-title{font-size:.9em}.DocSearch-Hit-path{color:var(--docsearch-muted-color);font-size:.75em}.DocSearch-Hit[aria-selected=true] .DocSearch-Hit-Tree,.DocSearch-Hit[aria-selected=true] .DocSearch-Hit-action,.DocSearch-Hit[aria-selected=true] .DocSearch-Hit-icon,.DocSearch-Hit[aria-selected=true] .DocSearch-Hit-path,.DocSearch-Hit[aria-selected=true] .DocSearch-Hit-text,.DocSearch-Hit[aria-selected=true] .DocSearch-Hit-title,.DocSearch-Hit[aria-selected=true] mark{color:var(--docsearch-hit-active-color)!important}@media screen and (prefers-reduced-motion:reduce){.DocSearch-Hit-action-button:focus,.DocSearch-Hit-action-button:hover{background:#0003;transition:none}}.DocSearch-ErrorScreen,.DocSearch-NoResults,.DocSearch-StartScreen{font-size:.9em;margin:0 auto;padding:36px 0;text-align:center;width:80%}.DocSearch-Screen-Icon{color:var(--docsearch-muted-color);padding-bottom:12px}.DocSearch-NoResults-Prefill-List{display:inline-block;padding-bottom:24px;text-align:left}.DocSearch-NoResults-Prefill-List ul{display:inline-block;padding:8px 0 0}.DocSearch-NoResults-Prefill-List li{list-style-position:inside;list-style-type:"» "}.DocSearch-Prefill{-webkit-appearance:none;-moz-appearance:none;appearance:none;background:none;border:0;border-radius:1em;color:var(--docsearch-highlight-color);cursor:pointer;display:inline-block;font-size:1em;font-weight:700;padding:0}.DocSearch-Prefill:focus,.DocSearch-Prefill:hover{outline:none;text-decoration:underline}.DocSearch-Footer{align-items:center;background:var(--docsearch-footer-background);border-radius:0 0 8px 8px;box-shadow:var(--docsearch-footer-shadow);display:flex;flex-direction:row-reverse;flex-shrink:0;height:var(--docsearch-footer-height);justify-content:space-between;padding:0 var(--docsearch-spacing);position:relative;-webkit-user-select:none;user-select:none;width:100%;z-index:300}.DocSearch-Commands{color:var(--docsearch-muted-color);display:flex;list-style:none;margin:0;padding:0}.DocSearch-Commands li{align-items:center;display:flex}.DocSearch-Commands li:not(:last-of-type){margin-right:.8em}.DocSearch-Commands-Key{align-items:center;background:var(--docsearch-key-gradient);border:0;border-radius:2px;box-shadow:var(--docsearch-key-shadow);color:var(--docsearch-muted-color);display:flex;height:18px;justify-content:center;margin-right:.4em;padding:0 0 1px;width:20px}.DocSearch-VisuallyHiddenForAccessibility{clip:rect(0 0 0 0);clip-path:inset(50%);height:1px;overflow:hidden;position:absolute;white-space:nowrap;width:1px}@media(max-width:768px){:root{--docsearch-spacing:10px;--docsearch-footer-height:40px}.DocSearch-Dropdown{height:100%}.DocSearch-Container{height:100vh;height:-webkit-fill-available;height:calc(var(--docsearch-vh, 1vh)*100);position:absolute}.DocSearch-Footer{border-radius:0;bottom:0;position:absolute}.DocSearch-Hit-content-wrapper{display:flex;position:relative;width:80%}.DocSearch-Modal{border-radius:0;box-shadow:none;height:100vh;height:-webkit-fill-available;height:calc(var(--docsearch-vh, 1vh)*100);margin:0;max-width:100%;width:100%}.DocSearch-Dropdown{max-height:calc(var(--docsearch-vh, 1vh)*100 - var(--docsearch-searchbox-height) - var(--docsearch-spacing) - var(--docsearch-footer-height))}.DocSearch-Cancel{-webkit-appearance:none;-moz-appearance:none;appearance:none;background:none;border:0;color:var(--docsearch-highlight-color);cursor:pointer;display:inline-block;flex:none;font:inherit;font-size:1em;font-weight:500;margin-left:var(--docsearch-spacing);outline:none;overflow:hidden;padding:0;-webkit-user-select:none;user-select:none;white-space:nowrap}.DocSearch-Commands,.DocSearch-Hit-Tree{display:none}}@keyframes fade-in{0%{opacity:0}to{opacity:1}}[class*=DocSearch]{--docsearch-primary-color: var(--vp-c-brand-1);--docsearch-highlight-color: var(--docsearch-primary-color);--docsearch-text-color: var(--vp-c-text-1);--docsearch-muted-color: var(--vp-c-text-2);--docsearch-searchbox-shadow: none;--docsearch-searchbox-background: transparent;--docsearch-searchbox-focus-background: transparent;--docsearch-key-gradient: transparent;--docsearch-key-shadow: none;--docsearch-modal-background: var(--vp-c-bg-soft);--docsearch-footer-background: var(--vp-c-bg)}.dark [class*=DocSearch]{--docsearch-modal-shadow: none;--docsearch-footer-shadow: none;--docsearch-logo-color: var(--vp-c-text-2);--docsearch-hit-background: var(--vp-c-default-soft);--docsearch-hit-color: var(--vp-c-text-2);--docsearch-hit-shadow: none}.DocSearch-Button{display:flex;justify-content:center;align-items:center;margin:0;padding:0;width:48px;height:55px;background:transparent;transition:border-color .25s}.DocSearch-Button:hover{background:transparent}.DocSearch-Button:focus{outline:1px dotted;outline:5px auto -webkit-focus-ring-color}.DocSearch-Button-Key--pressed{transform:none;box-shadow:none}.DocSearch-Button:focus:not(:focus-visible){outline:none!important}@media(min-width:768px){.DocSearch-Button{justify-content:flex-start;border:1px solid transparent;border-radius:8px;padding:0 10px 0 12px;width:100%;height:40px;background-color:var(--vp-c-bg-alt)}.DocSearch-Button:hover{border-color:var(--vp-c-brand-1);background:var(--vp-c-bg-alt)}}.DocSearch-Button .DocSearch-Button-Container{display:flex;align-items:center}.DocSearch-Button .DocSearch-Search-Icon{position:relative;width:16px;height:16px;color:var(--vp-c-text-1);fill:currentColor;transition:color .5s}.DocSearch-Button:hover .DocSearch-Search-Icon{color:var(--vp-c-text-1)}@media(min-width:768px){.DocSearch-Button .DocSearch-Search-Icon{top:1px;margin-right:8px;width:14px;height:14px;color:var(--vp-c-text-2)}}.DocSearch-Button .DocSearch-Button-Placeholder{display:none;margin-top:2px;padding:0 16px 0 0;font-size:13px;font-weight:500;color:var(--vp-c-text-2);transition:color .5s}.DocSearch-Button:hover .DocSearch-Button-Placeholder{color:var(--vp-c-text-1)}@media(min-width:768px){.DocSearch-Button .DocSearch-Button-Placeholder{display:inline-block}}.DocSearch-Button .DocSearch-Button-Keys{direction:ltr;display:none;min-width:auto}@media(min-width:768px){.DocSearch-Button .DocSearch-Button-Keys{display:flex;align-items:center}}.DocSearch-Button .DocSearch-Button-Key{display:block;margin:2px 0 0;border:1px solid var(--vp-c-divider);border-right:none;border-radius:4px 0 0 4px;padding-left:6px;min-width:0;width:auto;height:22px;line-height:22px;font-family:var(--vp-font-family-base);font-size:12px;font-weight:500;transition:color .5s,border-color .5s}.DocSearch-Button .DocSearch-Button-Key+.DocSearch-Button-Key{border-right:1px solid var(--vp-c-divider);border-left:none;border-radius:0 4px 4px 0;padding-left:2px;padding-right:6px}.DocSearch-Button .DocSearch-Button-Key:first-child{font-size:0!important}.DocSearch-Button .DocSearch-Button-Key:first-child:after{content:"Ctrl";font-size:12px;letter-spacing:normal;color:var(--docsearch-muted-color)}.mac .DocSearch-Button .DocSearch-Button-Key:first-child:after{content:"⌘"}.DocSearch-Button .DocSearch-Button-Key:first-child>*{display:none}.DocSearch-Search-Icon{--icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' stroke-width='1.6' viewBox='0 0 20 20'%3E%3Cpath fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' d='m14.386 14.386 4.088 4.088-4.088-4.088A7.533 7.533 0 1 1 3.733 3.733a7.533 7.533 0 0 1 10.653 10.653z'/%3E%3C/svg%3E")}.VPNavBarSearch{display:flex;align-items:center}@media(min-width:768px){.VPNavBarSearch{flex-grow:1;padding-left:24px}}@media(min-width:960px){.VPNavBarSearch{padding-left:32px}}.dark .DocSearch-Footer{border-top:1px solid var(--vp-c-divider)}.DocSearch-Form{border:1px solid var(--vp-c-brand-1);background-color:var(--vp-c-white)}.dark .DocSearch-Form{background-color:var(--vp-c-default-soft)}.DocSearch-Screen-Icon>svg{margin:auto}.VPNavBarSocialLinks[data-v-584f2254]{display:none}@media(min-width:1280px){.VPNavBarSocialLinks[data-v-584f2254]{display:flex;align-items:center}}.title[data-v-49754884]{display:flex;align-items:center;border-bottom:1px solid transparent;width:100%;height:var(--vp-nav-height);font-size:16px;font-weight:600;color:var(--vp-c-text-1);transition:opacity .25s}@media(min-width:960px){.title[data-v-49754884]{flex-shrink:0}.VPNavBarTitle.has-sidebar .title[data-v-49754884]{border-bottom-color:var(--vp-c-divider)}}[data-v-49754884] .logo{margin-right:8px;height:var(--vp-nav-logo-height)}.VPNavBarTranslations[data-v-870ffc4c]{display:none}@media(min-width:1280px){.VPNavBarTranslations[data-v-870ffc4c]{display:flex;align-items:center}}.title[data-v-870ffc4c]{padding:0 24px 0 12px;line-height:32px;font-size:14px;font-weight:700;color:var(--vp-c-text-1)}.VPNavBar[data-v-d231c45b]{position:relative;height:var(--vp-nav-height);pointer-events:none;white-space:nowrap;transition:background-color .25s}.VPNavBar.screen-open[data-v-d231c45b]{transition:none;background-color:var(--vp-nav-bg-color);border-bottom:1px solid var(--vp-c-divider)}.VPNavBar[data-v-d231c45b]:not(.home){background-color:var(--vp-nav-bg-color)}@media(min-width:960px){.VPNavBar[data-v-d231c45b]:not(.home){background-color:transparent}.VPNavBar[data-v-d231c45b]:not(.has-sidebar):not(.home.top){background-color:var(--vp-nav-bg-color)}}.wrapper[data-v-d231c45b]{padding:0 8px 0 24px}@media(min-width:768px){.wrapper[data-v-d231c45b]{padding:0 32px}}@media(min-width:960px){.VPNavBar.has-sidebar .wrapper[data-v-d231c45b]{padding:0}}.container[data-v-d231c45b]{display:flex;justify-content:space-between;margin:0 auto;max-width:calc(var(--vp-layout-max-width) - 64px);height:var(--vp-nav-height);pointer-events:none}.container>.title[data-v-d231c45b],.container>.content[data-v-d231c45b]{pointer-events:none}.container[data-v-d231c45b] *{pointer-events:auto}@media(min-width:960px){.VPNavBar.has-sidebar .container[data-v-d231c45b]{max-width:100%}}.title[data-v-d231c45b]{flex-shrink:0;height:calc(var(--vp-nav-height) - 1px);transition:background-color .5s}@media(min-width:960px){.VPNavBar.has-sidebar .title[data-v-d231c45b]{position:absolute;top:0;left:0;z-index:2;padding:0 32px;width:var(--vp-sidebar-width);height:var(--vp-nav-height);background-color:transparent}}@media(min-width:1440px){.VPNavBar.has-sidebar .title[data-v-d231c45b]{padding-left:max(32px,calc((100% - (var(--vp-layout-max-width) - 64px)) / 2));width:calc((100% - (var(--vp-layout-max-width) - 64px)) / 2 + var(--vp-sidebar-width) - 32px)}}.content[data-v-d231c45b]{flex-grow:1}@media(min-width:960px){.VPNavBar.has-sidebar .content[data-v-d231c45b]{position:relative;z-index:1;padding-right:32px;padding-left:var(--vp-sidebar-width)}}@media(min-width:1440px){.VPNavBar.has-sidebar .content[data-v-d231c45b]{padding-right:calc((100vw - var(--vp-layout-max-width)) / 2 + 32px);padding-left:calc((100vw - var(--vp-layout-max-width)) / 2 + var(--vp-sidebar-width))}}.content-body[data-v-d231c45b]{display:flex;justify-content:flex-end;align-items:center;height:var(--vp-nav-height);transition:background-color .5s}@media(min-width:960px){.VPNavBar:not(.home.top) .content-body[data-v-d231c45b]{position:relative;background-color:var(--vp-nav-bg-color)}.VPNavBar:not(.has-sidebar):not(.home.top) .content-body[data-v-d231c45b]{background-color:transparent}}@media(max-width:767px){.content-body[data-v-d231c45b]{column-gap:.5rem}}.menu+.translations[data-v-d231c45b]:before,.menu+.appearance[data-v-d231c45b]:before,.menu+.social-links[data-v-d231c45b]:before,.translations+.appearance[data-v-d231c45b]:before,.appearance+.social-links[data-v-d231c45b]:before{margin-right:8px;margin-left:8px;width:1px;height:24px;background-color:var(--vp-c-divider);content:""}.menu+.appearance[data-v-d231c45b]:before,.translations+.appearance[data-v-d231c45b]:before{margin-right:16px}.appearance+.social-links[data-v-d231c45b]:before{margin-left:16px}.social-links[data-v-d231c45b]{margin-right:-8px}.divider[data-v-d231c45b]{width:100%;height:1px}@media(min-width:960px){.VPNavBar.has-sidebar .divider[data-v-d231c45b]{padding-left:var(--vp-sidebar-width)}}@media(min-width:1440px){.VPNavBar.has-sidebar .divider[data-v-d231c45b]{padding-left:calc((100vw - var(--vp-layout-max-width)) / 2 + var(--vp-sidebar-width))}}.divider-line[data-v-d231c45b]{width:100%;height:1px;transition:background-color .5s}.VPNavBar:not(.home) .divider-line[data-v-d231c45b]{background-color:var(--vp-c-gutter)}@media(min-width:960px){.VPNavBar:not(.home.top) .divider-line[data-v-d231c45b]{background-color:var(--vp-c-gutter)}.VPNavBar:not(.has-sidebar):not(.home.top) .divider[data-v-d231c45b]{background-color:var(--vp-c-gutter)}}.VPNavScreenAppearance[data-v-7e51c018]{display:flex;justify-content:space-between;align-items:center;border-radius:8px;padding:12px 14px 12px 16px;background-color:var(--vp-c-bg-soft)}.text[data-v-7e51c018]{line-height:24px;font-size:12px;font-weight:500;color:var(--vp-c-text-2)}.VPNavScreenMenuLink[data-v-f7cb399b]{display:block;border-bottom:1px solid var(--vp-c-divider);padding:12px 0 11px;line-height:24px;font-size:14px;font-weight:500;color:var(--vp-c-text-1);transition:border-color .25s,color .25s}.VPNavScreenMenuLink[data-v-f7cb399b]:hover{color:var(--vp-c-brand-1)}.VPNavScreenMenuGroupLink[data-v-be39927d]{display:block;margin-left:12px;line-height:32px;font-size:14px;font-weight:400;color:var(--vp-c-text-1);transition:color .25s}.VPNavScreenMenuGroupLink[data-v-be39927d]:hover{color:var(--vp-c-brand-1)}.VPNavScreenMenuGroupSection[data-v-a2adf6de]{display:block}.title[data-v-a2adf6de]{line-height:32px;font-size:13px;font-weight:700;color:var(--vp-c-text-2);transition:color .25s}.VPNavScreenMenuGroup[data-v-e513829a]{border-bottom:1px solid var(--vp-c-divider);height:48px;overflow:hidden;transition:border-color .5s}.VPNavScreenMenuGroup .items[data-v-e513829a]{visibility:hidden}.VPNavScreenMenuGroup.open .items[data-v-e513829a]{visibility:visible}.VPNavScreenMenuGroup.open[data-v-e513829a]{padding-bottom:10px;height:auto}.VPNavScreenMenuGroup.open .button[data-v-e513829a]{padding-bottom:6px;color:var(--vp-c-brand-1)}.VPNavScreenMenuGroup.open .button-icon[data-v-e513829a]{transform:rotate(45deg)}.button[data-v-e513829a]{display:flex;justify-content:space-between;align-items:center;padding:12px 4px 11px 0;width:100%;line-height:24px;font-size:14px;font-weight:500;color:var(--vp-c-text-1);transition:color .25s}.button[data-v-e513829a]:hover{color:var(--vp-c-brand-1)}.button-icon[data-v-e513829a]{transition:transform .25s}.group[data-v-e513829a]:first-child{padding-top:0}.group+.group[data-v-e513829a],.group+.item[data-v-e513829a]{padding-top:4px}.VPNavScreenTranslations[data-v-3cf033df]{height:24px;overflow:hidden}.VPNavScreenTranslations.open[data-v-3cf033df]{height:auto}.title[data-v-3cf033df]{display:flex;align-items:center;font-size:14px;font-weight:500;color:var(--vp-c-text-1)}.icon[data-v-3cf033df]{font-size:16px}.icon.lang[data-v-3cf033df]{margin-right:8px}.icon.chevron[data-v-3cf033df]{margin-left:4px}.list[data-v-3cf033df]{padding:4px 0 0 24px}.link[data-v-3cf033df]{line-height:32px;font-size:13px;color:var(--vp-c-text-1)}.VPNavScreen[data-v-68d28474]{position:fixed;top:calc(var(--vp-nav-height) + var(--vp-layout-top-height, 0px));right:0;bottom:0;left:0;padding:0 32px;width:100%;background-color:var(--vp-nav-screen-bg-color);overflow-y:auto;transition:background-color .25s;pointer-events:auto}.VPNavScreen.fade-enter-active[data-v-68d28474],.VPNavScreen.fade-leave-active[data-v-68d28474]{transition:opacity .25s}.VPNavScreen.fade-enter-active .container[data-v-68d28474],.VPNavScreen.fade-leave-active .container[data-v-68d28474]{transition:transform .25s ease}.VPNavScreen.fade-enter-from[data-v-68d28474],.VPNavScreen.fade-leave-to[data-v-68d28474]{opacity:0}.VPNavScreen.fade-enter-from .container[data-v-68d28474],.VPNavScreen.fade-leave-to .container[data-v-68d28474]{transform:translateY(-8px)}@media(min-width:768px){.VPNavScreen[data-v-68d28474]{display:none}}.container[data-v-68d28474]{margin:0 auto;padding:24px 0 96px;max-width:288px}.menu+.translations[data-v-68d28474],.menu+.appearance[data-v-68d28474],.translations+.appearance[data-v-68d28474]{margin-top:24px}.menu+.social-links[data-v-68d28474]{margin-top:16px}.appearance+.social-links[data-v-68d28474]{margin-top:16px}.VPNav[data-v-b2a7789c]{position:relative;top:var(--vp-layout-top-height, 0px);left:0;z-index:var(--vp-z-index-nav);width:100%;pointer-events:none;transition:background-color .5s}@media(min-width:960px){.VPNav[data-v-b2a7789c]{position:fixed}}.VPSidebarItem.level-0[data-v-d34e54b2]{padding-bottom:24px}.VPSidebarItem.collapsed.level-0[data-v-d34e54b2]{padding-bottom:10px}.item[data-v-d34e54b2]{position:relative;display:flex;width:100%}.VPSidebarItem.collapsible>.item[data-v-d34e54b2]{cursor:pointer}.indicator[data-v-d34e54b2]{position:absolute;top:6px;bottom:6px;left:-17px;width:2px;border-radius:2px;transition:background-color .25s}.VPSidebarItem.level-2.is-active>.item>.indicator[data-v-d34e54b2],.VPSidebarItem.level-3.is-active>.item>.indicator[data-v-d34e54b2],.VPSidebarItem.level-4.is-active>.item>.indicator[data-v-d34e54b2],.VPSidebarItem.level-5.is-active>.item>.indicator[data-v-d34e54b2]{background-color:var(--vp-c-brand-1)}.link[data-v-d34e54b2]{display:flex;align-items:center;flex-grow:1}.text[data-v-d34e54b2]{flex-grow:1;padding:4px 0;line-height:24px;font-size:14px;transition:color .25s}.VPSidebarItem.level-0 .text[data-v-d34e54b2]{font-weight:700;color:var(--vp-c-text-1)}.VPSidebarItem.level-1 .text[data-v-d34e54b2],.VPSidebarItem.level-2 .text[data-v-d34e54b2],.VPSidebarItem.level-3 .text[data-v-d34e54b2],.VPSidebarItem.level-4 .text[data-v-d34e54b2],.VPSidebarItem.level-5 .text[data-v-d34e54b2]{font-weight:500;color:var(--vp-c-text-2)}.VPSidebarItem.level-0.is-link>.item>.link:hover .text[data-v-d34e54b2],.VPSidebarItem.level-1.is-link>.item>.link:hover .text[data-v-d34e54b2],.VPSidebarItem.level-2.is-link>.item>.link:hover .text[data-v-d34e54b2],.VPSidebarItem.level-3.is-link>.item>.link:hover .text[data-v-d34e54b2],.VPSidebarItem.level-4.is-link>.item>.link:hover .text[data-v-d34e54b2],.VPSidebarItem.level-5.is-link>.item>.link:hover .text[data-v-d34e54b2]{color:var(--vp-c-brand-1)}.VPSidebarItem.level-0.has-active>.item>.text[data-v-d34e54b2],.VPSidebarItem.level-1.has-active>.item>.text[data-v-d34e54b2],.VPSidebarItem.level-2.has-active>.item>.text[data-v-d34e54b2],.VPSidebarItem.level-3.has-active>.item>.text[data-v-d34e54b2],.VPSidebarItem.level-4.has-active>.item>.text[data-v-d34e54b2],.VPSidebarItem.level-5.has-active>.item>.text[data-v-d34e54b2],.VPSidebarItem.level-0.has-active>.item>.link>.text[data-v-d34e54b2],.VPSidebarItem.level-1.has-active>.item>.link>.text[data-v-d34e54b2],.VPSidebarItem.level-2.has-active>.item>.link>.text[data-v-d34e54b2],.VPSidebarItem.level-3.has-active>.item>.link>.text[data-v-d34e54b2],.VPSidebarItem.level-4.has-active>.item>.link>.text[data-v-d34e54b2],.VPSidebarItem.level-5.has-active>.item>.link>.text[data-v-d34e54b2]{color:var(--vp-c-text-1)}.VPSidebarItem.level-0.is-active>.item .link>.text[data-v-d34e54b2],.VPSidebarItem.level-1.is-active>.item .link>.text[data-v-d34e54b2],.VPSidebarItem.level-2.is-active>.item .link>.text[data-v-d34e54b2],.VPSidebarItem.level-3.is-active>.item .link>.text[data-v-d34e54b2],.VPSidebarItem.level-4.is-active>.item .link>.text[data-v-d34e54b2],.VPSidebarItem.level-5.is-active>.item .link>.text[data-v-d34e54b2]{color:var(--vp-c-brand-1)}.caret[data-v-d34e54b2]{display:flex;justify-content:center;align-items:center;margin-right:-7px;width:32px;height:32px;color:var(--vp-c-text-3);cursor:pointer;transition:color .25s;flex-shrink:0}.item:hover .caret[data-v-d34e54b2]{color:var(--vp-c-text-2)}.item:hover .caret[data-v-d34e54b2]:hover{color:var(--vp-c-text-1)}.caret-icon[data-v-d34e54b2]{font-size:18px;transform:rotate(90deg);transition:transform .25s}.VPSidebarItem.collapsed .caret-icon[data-v-d34e54b2]{transform:rotate(0)}.VPSidebarItem.level-1 .items[data-v-d34e54b2],.VPSidebarItem.level-2 .items[data-v-d34e54b2],.VPSidebarItem.level-3 .items[data-v-d34e54b2],.VPSidebarItem.level-4 .items[data-v-d34e54b2],.VPSidebarItem.level-5 .items[data-v-d34e54b2]{border-left:1px solid var(--vp-c-divider);padding-left:16px}.VPSidebarItem.collapsed .items[data-v-d34e54b2]{display:none}.no-transition[data-v-90a0702d] .caret-icon{transition:none}.group+.group[data-v-90a0702d]{border-top:1px solid var(--vp-c-divider);padding-top:10px}@media(min-width:960px){.group[data-v-90a0702d]{padding-top:10px;width:calc(var(--vp-sidebar-width) - 64px)}}.VPSidebar[data-v-efe03c19]{position:fixed;top:var(--vp-layout-top-height, 0px);bottom:0;left:0;z-index:var(--vp-z-index-sidebar);padding:32px 32px 96px;width:calc(100vw - 64px);max-width:320px;background-color:var(--vp-sidebar-bg-color);opacity:0;box-shadow:var(--vp-c-shadow-3);overflow-x:hidden;overflow-y:auto;transform:translate(-100%);transition:opacity .5s,transform .25s ease;overscroll-behavior:contain}.VPSidebar.open[data-v-efe03c19]{opacity:1;visibility:visible;transform:translate(0);transition:opacity .25s,transform .5s cubic-bezier(.19,1,.22,1)}.dark .VPSidebar[data-v-efe03c19]{box-shadow:var(--vp-shadow-1)}@media(min-width:960px){.VPSidebar[data-v-efe03c19]{padding-top:var(--vp-nav-height);width:var(--vp-sidebar-width);max-width:100%;background-color:var(--vp-sidebar-bg-color);opacity:1;visibility:visible;box-shadow:none;transform:translate(0)}}@media(min-width:1440px){.VPSidebar[data-v-efe03c19]{padding-left:max(32px,calc((100% - (var(--vp-layout-max-width) - 64px)) / 2));width:calc((100% - (var(--vp-layout-max-width) - 64px)) / 2 + var(--vp-sidebar-width) - 32px)}}@media(min-width:960px){.curtain[data-v-efe03c19]{position:sticky;top:-64px;left:0;z-index:1;margin-top:calc(var(--vp-nav-height) * -1);margin-right:-32px;margin-left:-32px;height:var(--vp-nav-height);background-color:var(--vp-sidebar-bg-color)}}.nav[data-v-efe03c19]{outline:0}.VPSkipLink[data-v-770676c7]{top:8px;left:8px;padding:8px 16px;z-index:999;border-radius:8px;font-size:12px;font-weight:700;text-decoration:none;color:var(--vp-c-brand-1);box-shadow:var(--vp-shadow-3);background-color:var(--vp-c-bg)}.VPSkipLink[data-v-770676c7]:focus{height:auto;width:auto;clip:auto;clip-path:none}@media(min-width:1280px){.VPSkipLink[data-v-770676c7]{top:14px;left:16px}}.Layout[data-v-f9c03b6e]{display:flex;flex-direction:column;min-height:100vh}:root{color-scheme:light;--ray-blue: #3b63d9;--vp-c-bg: #ffffff;--vp-c-bg-alt: #f5f7fb;--vp-c-bg-elv: #ffffff;--vp-c-bg-soft: #f5f7fb;--vp-c-text-1: #1d2a3e;--vp-c-text-2: #52647c;--vp-c-text-3: #617187;--vp-c-divider: #e4e9f1;--vp-c-gutter: #e4e9f1;--vp-c-border: #c6d0e0;--vp-c-brand-1: var(--ray-blue);--vp-c-brand-2: #3156c2;--vp-c-brand-3: var(--ray-blue);--vp-c-brand-soft: #3b63d914;--ray-map-bg: #edf3ff;--ray-map-line: #3b63d91a}:root.dark{color-scheme:dark;--vp-c-bg: #101722;--vp-c-bg-alt: #172131;--vp-c-bg-elv: #192638;--vp-c-bg-soft: #172131;--vp-c-text-1: #e9eef7;--vp-c-text-2: #b3c0d3;--vp-c-text-3: #a0b0c6;--vp-c-divider: #2c394d;--vp-c-gutter: #2c394d;--vp-c-border: #687b96;--vp-c-brand-1: #a4b8ff;--vp-c-brand-soft: #a4b8ff24;--ray-map-bg: #172640;--ray-map-line: #a4b8ff21}.ray-home{width:min(100% - 3rem,76rem);margin-inline:auto}.ray-hero{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));align-items:center;gap:clamp(1.75rem,5vw,5rem);padding-block:clamp(2.5rem,6vw,5rem) clamp(2.25rem,5vw,3.75rem)}.ray-hero h1{margin:0;font-size:clamp(2.25rem,1.75rem + 2vw,3.75rem);line-height:1.12;letter-spacing:-.045em;font-weight:700}.ray-lead{max-width:25rem;margin-block-start:1rem;color:var(--vp-c-text-2);font-size:1.05rem;line-height:1.8}.ray-actions{display:flex;flex-wrap:wrap;gap:.5rem .8rem;margin-block-start:1.5rem}.ray-actions a{display:inline-flex;align-items:center;min-height:2.625rem;padding-inline:.95rem;border:1px solid transparent;border-radius:.5rem;font-size:.9rem;font-weight:600}.ray-actions .ray-start{background-color:var(--ray-blue);color:#fff}.ray-actions .ray-start:hover{background-color:var(--vp-c-brand-2)}.ray-actions .ray-migrate{border-color:var(--vp-c-border)}.ray-actions .ray-migrate:hover{background-color:var(--vp-c-bg-soft)}.ray-map{position:relative;isolation:isolate;padding:clamp(1rem,3vw,1.75rem);border:1px solid var(--vp-c-divider);border-radius:.875rem;background:linear-gradient(var(--ray-map-line) 1px,transparent 1px) 0 0 / 28px 28px,linear-gradient(90deg,var(--ray-map-line) 1px,transparent 1px) 0 0 / 28px 28px,var(--ray-map-bg)}.ray-map h2{margin-block:0 .85rem;color:var(--vp-c-brand-1);font-size:.875rem;font-weight:650}.ray-map ul,.ray-paths ul{list-style:none;margin:0;padding:0}.ray-map ul{display:grid;gap:.5rem;width:min(100%,15rem)}.ray-map a{display:flex;flex-wrap:wrap;justify-content:space-between;gap:.25rem .65rem;align-items:center;padding:.55rem .75rem;border:1px solid var(--vp-c-divider);border-radius:.45rem;background:var(--vp-c-bg-elv);font-size:.875rem;font-weight:600}.ray-map a:hover{border-color:var(--vp-c-brand-1)}.ray-map code,.ray-doc-meta code{font-size:.8rem;color:var(--vp-c-brand-1)}.ray-orbit{position:absolute;z-index:-1;inset:50% 5% auto auto;width:min(42%,12.5rem);transform:translateY(-50%);fill:none;stroke:currentColor;color:var(--vp-c-brand-1);opacity:.45}.ray-paths{padding-block:1.5rem 2.5rem;border-block-start:1px solid var(--vp-c-divider)}.ray-paths h2,.ray-showcase h2{font-size:1.3rem;font-weight:650;line-height:1.4}.ray-paths h2{margin-block-end:.9rem}.ray-paths ul{display:grid;grid-template-columns:repeat(auto-fit,minmax(min(100%,15rem),1fr));gap:.8rem}.ray-path{display:block;height:100%;border:1px solid var(--vp-c-divider);border-radius:.65rem;background:var(--vp-c-bg)}.ray-path:hover{border-color:var(--vp-c-brand-1);background:var(--vp-c-bg-soft)}.ray-path article{position:relative;padding:1rem 1.15rem}.ray-path-icon,.ray-path-arrow{display:block;fill:none;stroke:currentColor;stroke-width:1.6;stroke-linecap:round;stroke-linejoin:round;color:var(--vp-c-brand-1)}.ray-path-icon{width:2.25rem;height:2.25rem;padding:.42rem;border-radius:.45rem;background:var(--vp-c-brand-soft)}.ray-path-arrow{position:absolute;inset:1.15rem 1.15rem auto auto;width:1.1rem;height:1.1rem}.ray-path h3{margin-block:.65rem .2rem;font-size:1rem;font-weight:650}.ray-path p,.ray-showcase p{color:var(--vp-c-text-2);font-size:.9rem;line-height:1.6}.ray-showcase{display:grid;grid-template-columns:minmax(0,1fr) minmax(0,2.1fr);align-items:center;gap:clamp(1rem,3vw,2.5rem);padding:clamp(1rem,3vw,2rem);border:1px solid var(--vp-c-divider);border-radius:.875rem;background:var(--vp-c-bg-alt)}.ray-showcase p{margin-block-start:.5rem}.ray-showcase-links{display:flex;flex-wrap:wrap;gap:.4rem 1rem;margin-block-start:.85rem;color:var(--vp-c-brand-1);font-size:.9rem;font-weight:600}.ray-showcase-links a:hover,.ray-doc-meta a:hover{text-decoration:underline;text-underline-offset:.2em}.ray-showcase img{display:block;width:100%;height:auto;border:1px solid var(--vp-c-divider);border-radius:.55rem}.ray-doc-meta{display:flex;flex-wrap:wrap;justify-content:space-between;gap:.25rem 1rem;margin-block-end:1.25rem;padding-block-end:.55rem;border-block-end:1px solid var(--vp-c-divider);color:var(--vp-c-text-2);font-size:.85rem}.ray-doc-meta>span{color:var(--vp-c-brand-1);font-weight:650}.ray-home a:focus-visible,.ray-doc-meta a:focus-visible{outline:2px solid var(--vp-c-brand-1);outline-offset:3px}@media(max-width:800px){.ray-hero,.ray-showcase{grid-template-columns:minmax(0,1fr)}}@media(max-width:560px){.ray-home{width:calc(100% - 2.5rem)}}.ray-demo{margin-block:16px;padding:16px;border:1px solid var(--vp-c-divider);border-radius:12px;background:var(--vp-c-bg-soft)}.ray-demo-fields{display:flex;flex-wrap:wrap;align-items:start;gap:12px 16px}.ray-demo-fields>*{flex:1 1 200px;min-inline-size:0}.ray-demo-fields>div>label,.ray-demo-fields legend{display:block;margin-block-end:4px;font-size:14px;font-weight:600}.ray-demo input:not([type=radio]){inline-size:100%;min-block-size:40px;padding-inline:10px;border:1px solid var(--vp-c-divider);border-radius:6px;background:var(--vp-c-bg)}.ray-demo input[aria-invalid=true]{border-color:var(--vp-c-danger-1)}.ray-demo input:focus-visible{outline:2px solid var(--vp-c-brand-1);outline-offset:2px}.ray-demo-options{display:flex;flex-wrap:wrap;gap:4px 12px}.ray-demo-options label{display:inline-flex;min-block-size:40px;align-items:center;gap:4px;cursor:pointer;font-size:14px}.ray-demo-options input{-webkit-appearance:auto;-moz-appearance:auto;appearance:auto;accent-color:var(--vp-c-brand-1)}.vp-doc .ray-demo-hint{margin:8px 0 0;color:var(--vp-c-text-2);font-size:14px}.ray-demo-hint:empty{margin:0}.ray-demo-result{display:block;margin-block-start:12px;overflow-wrap:anywhere}.ray-demo-barcode{width:fit-content;max-width:100%;margin-block-start:12px;overflow:auto;border-radius:6px;background:#fff}.fullscreen-demo[data-v-0d48cce2]{display:grid;place-items:center;margin:0;background:var(--vp-c-bg-soft)}.VPLocalSearchBox[data-v-c99087ed]{position:fixed;z-index:100;top:0;right:0;bottom:0;left:0;display:flex}.backdrop[data-v-c99087ed]{position:absolute;top:0;right:0;bottom:0;left:0;background:var(--vp-backdrop-bg-color);transition:opacity .5s}.shell[data-v-c99087ed]{position:relative;padding:12px;margin:64px auto;display:flex;flex-direction:column;gap:16px;background:var(--vp-local-search-bg);width:min(100vw - 60px,900px);height:min-content;max-height:min(100vh - 128px,900px);border-radius:6px}@media(max-width:767px){.shell[data-v-c99087ed]{margin:0;width:100vw;height:100vh;max-height:none;border-radius:0}}.search-bar[data-v-c99087ed]{border:1px solid var(--vp-c-divider);border-radius:4px;display:flex;align-items:center;padding:0 12px;cursor:text}@media(max-width:767px){.search-bar[data-v-c99087ed]{padding:0 8px}}.search-bar[data-v-c99087ed]:focus-within{border-color:var(--vp-c-brand-1)}.local-search-icon[data-v-c99087ed]{display:block;font-size:18px}.navigate-icon[data-v-c99087ed]{display:block;font-size:14px}.search-icon[data-v-c99087ed]{margin:8px}@media(max-width:767px){.search-icon[data-v-c99087ed]{display:none}}.search-input[data-v-c99087ed]{padding:6px 12px;font-size:inherit;width:100%}@media(max-width:767px){.search-input[data-v-c99087ed]{padding:6px 4px}}.search-actions[data-v-c99087ed]{display:flex;gap:4px}@media(any-pointer:coarse){.search-actions[data-v-c99087ed]{gap:8px}}@media(min-width:769px){.search-actions.before[data-v-c99087ed]{display:none}}.search-actions button[data-v-c99087ed]{padding:8px}.search-actions button[data-v-c99087ed]:not([disabled]):hover,.toggle-layout-button.detailed-list[data-v-c99087ed]{color:var(--vp-c-brand-1)}.search-actions button.clear-button[data-v-c99087ed]:disabled{opacity:.37}.search-keyboard-shortcuts[data-v-c99087ed]{font-size:.8rem;opacity:75%;display:flex;flex-wrap:wrap;gap:16px;line-height:14px}.search-keyboard-shortcuts span[data-v-c99087ed]{display:flex;align-items:center;gap:4px}@media(max-width:767px){.search-keyboard-shortcuts[data-v-c99087ed]{display:none}}.search-keyboard-shortcuts kbd[data-v-c99087ed]{background:#8080801a;border-radius:4px;padding:3px 6px;min-width:24px;display:inline-block;text-align:center;vertical-align:middle;border:1px solid rgba(128,128,128,.15);box-shadow:0 2px 2px #0000001a}.results[data-v-c99087ed]{display:flex;flex-direction:column;gap:6px;overflow-x:hidden;overflow-y:auto;overscroll-behavior:contain}.result[data-v-c99087ed]{display:flex;align-items:center;gap:8px;border-radius:4px;transition:none;line-height:1rem;border:solid 2px var(--vp-local-search-result-border);outline:none}.result>div[data-v-c99087ed]{margin:12px;width:100%;overflow:hidden}@media(max-width:767px){.result>div[data-v-c99087ed]{margin:8px}}.titles[data-v-c99087ed]{display:flex;flex-wrap:wrap;gap:4px;position:relative;z-index:1001;padding:2px 0}.title[data-v-c99087ed]{display:flex;align-items:center;gap:4px}.title.main[data-v-c99087ed]{font-weight:500}.title-icon[data-v-c99087ed]{opacity:.5;font-weight:500;color:var(--vp-c-brand-1)}.title svg[data-v-c99087ed]{opacity:.5}.result.selected[data-v-c99087ed]{--vp-local-search-result-bg: var(--vp-local-search-result-selected-bg);border-color:var(--vp-local-search-result-selected-border)}.excerpt-wrapper[data-v-c99087ed]{position:relative}.excerpt[data-v-c99087ed]{opacity:50%;pointer-events:none;max-height:140px;overflow:hidden;position:relative;margin-top:4px}.result.selected .excerpt[data-v-c99087ed]{opacity:1}.excerpt[data-v-c99087ed] *{font-size:.8rem!important;line-height:130%!important}.titles[data-v-c99087ed] mark,.excerpt[data-v-c99087ed] mark{background-color:var(--vp-local-search-highlight-bg);color:var(--vp-local-search-highlight-text);border-radius:2px;padding:0 2px}.excerpt[data-v-c99087ed] .vp-code-group .tabs{display:none}.excerpt[data-v-c99087ed] .vp-code-group div[class*=language-]{border-radius:8px!important}.excerpt-gradient-bottom[data-v-c99087ed]{position:absolute;bottom:-1px;left:0;width:100%;height:8px;background:linear-gradient(transparent,var(--vp-local-search-result-bg));z-index:1000}.excerpt-gradient-top[data-v-c99087ed]{position:absolute;top:-1px;left:0;width:100%;height:8px;background:linear-gradient(var(--vp-local-search-result-bg),transparent);z-index:1000}.result.selected .titles[data-v-c99087ed],.result.selected .title-icon[data-v-c99087ed]{color:var(--vp-c-brand-1)!important}.no-results[data-v-c99087ed]{font-size:.9rem;text-align:center;padding:12px}svg[data-v-c99087ed]{flex:none}:root{--r-theme-primary-color: #3b63d9;--r-bezier: cubic-bezier(.4, 0, .2, 1);--r-primary-text: var(--r-theme-primary-color);--r-selected-text: var(--r-theme-primary-color);--r-canvas: #f5f7fb;--r-surface: #ffffff;--r-surface-muted: #f7f9fc;--r-surface-hover: #eef2f8;--r-line: #e4e9f1;--r-control-border: #8492a8;--r-text: #1d2a3e;--r-text-secondary: #52647c;--r-text-muted: #617187;--r-shadow-soft: 0 1px 2px rgb(25 43 74 / 3%), 0 6px 20px rgb(25 43 74 / 3%);--r-radius: 12px;--r-font-mono: "SFMono-Regular", Consolas, "Liberation Mono", monospace;color-scheme:light}.r-template--dark{--r-primary-text: var(--r-text-secondary);--r-selected-text: var(--r-text);--r-canvas: #101722;--r-surface: #172131;--r-surface-muted: #1c293b;--r-surface-hover: #243247;--r-line: #2c394d;--r-control-border: #687b96;--r-text: #e9eef7;--r-text-secondary: #b3c0d3;--r-text-muted: #a0b0c6;--r-shadow-soft: 0 1px 2px rgb(0 0 0 / 10%), 0 8px 24px rgb(0 0 0 / 10%);color-scheme:dark}@media(forced-colors:active){:root,.r-template--dark{--r-primary-text: CanvasText;--r-selected-text: CanvasText;--r-canvas: Canvas;--r-surface: Canvas;--r-surface-muted: Canvas;--r-surface-hover: Canvas;--r-line: CanvasText;--r-control-border: ButtonText;--r-text: CanvasText;--r-text-secondary: CanvasText;--r-text-muted: CanvasText;--r-shadow-soft: none}}:where(button,a,summary,[tabindex]):focus-visible{outline:2px solid var(--r-theme-primary-color);outline-offset:3px}@media(prefers-reduced-motion:reduce){.r-layout-full *,.r-layout-full *:before,.r-layout-full *:after{scroll-behavior:auto!important;animation-duration:.01ms!important;transition-duration:.01ms!important}}.r-icon{position:relative;width:var(--r-icon-width);height:var(--r-icon-height);border:none;outline:none;text-align:center;display:inline-flex;flex-shrink:0;justify-content:center;align-items:center;color:var(--r-icon-color);transform:translateZ(0);opacity:var(--r-icon-depth);cursor:var(--r-icon-cursor)}.r-icon svg[RIconAttribute=r-icon]{display:block;width:var(--r-icon-width);height:var(--r-icon-height);fill:currentColor}.r-icon-path__animate{stroke-dasharray:var(--r-icon-path-length);stroke-dashoffset:var(--r-icon-path-length);animation:rayIconPathAnimate 2s forwards}@keyframes rayIconPathAnimate{to{stroke-dashoffset:0}}.r-layout-full{position:fixed;top:0;right:0;bottom:0;left:0;display:flex;flex-direction:column}.r-layout-full .r-layout-full__body{flex:1;min-block-size:0}.r-layout-full .r-layout-full__viewer{block-size:100%;min-width:0}.r-layout-full .r-layout-full__viewer>.n-layout-scroll-container{display:flex;flex-direction:column;overflow:clip;height:100%}.r-layout-full .r-layout-header-region,.r-layout-full .r-layout-tabs-region,.r-layout-full .r-layout-footer-region{flex-shrink:0}.r-layout-full .r-layout-content-viewport{position:relative;flex:1;min-block-size:0;min-inline-size:0;background:var(--r-canvas)}.r-layout-full .r-layout-full__viewer-content{block-size:100%;background:transparent}.r-layout-full .r-layout-full__viewer-content>.n-scrollbar>.n-scrollbar-container{height:100%}.r-layout-full .r-layout-content-scroll{display:flex;flex-direction:column;min-height:100%}.r-layout-full .r-layout-content-inner{--layout-content-gutter: var(--layout-content-padding);box-sizing:border-box;container-type:inline-size;width:100%;max-width:var(--layout-content-max-width);margin-inline:auto;padding:var(--layout-content-gutter);flex:1;min-width:0}.r-layout-full .r-layout-content--maximized{--layout-content-height: 100dvh;position:fixed;top:0;right:0;bottom:0;left:0}.r-layout-full .r-layout-content--maximized .r-layout-header-region,.r-layout-full .r-layout-content--maximized .r-layout-tabs-region,.r-layout-full .r-layout-content--maximized .r-layout-footer-region{display:none}.r-layout-full .r-layout-content--maximized .r-layout-content-scroll{padding-inline-end:52px}.r-layout-content-restore__button{position:absolute;inset-block-start:10px;inset-inline-end:10px;z-index:3;display:grid;place-items:center;inline-size:36px;block-size:36px;border:1px solid var(--r-control-border);border-radius:8px;color:var(--r-text);background:var(--r-surface);cursor:pointer}.r-layout-content-restore__button:hover{background:var(--r-surface-hover)}@media(max-width:768px){.r-layout-full .r-layout-content-inner{--layout-content-gutter: min( var(--layout-content-padding), clamp(10px, 4vw, 16px) )}}.r-layout-extension-description{margin-block-end:18px;color:var(--r-text-secondary);line-height:1.8}.r-layout-settings{min-inline-size:0}.r-layout-settings .n-form-item{margin-block-end:16px}.r-layout-settings__hint{color:var(--r-text-muted);font-size:12px;line-height:1.8}.r-layout-presets{box-sizing:border-box;display:grid;grid-auto-flow:column;grid-auto-columns:minmax(72px,1fr);gap:6px;max-inline-size:min(100%,410px);padding:5px;overflow-x:auto}.r-layout-preset{position:relative;box-sizing:border-box;display:grid;align-content:center;place-items:center;gap:4px;align-self:start;min-inline-size:0;min-block-size:0;inline-size:100%;block-size:68px;padding:4px;border:1px solid var(--r-line);border-radius:var(--r-radius);background:var(--r-surface-muted);color:var(--r-text-secondary);font:inherit;font-size:13px;font-weight:500;line-height:1.3;text-align:center;cursor:pointer;transition:border-color .18s var(--r-bezier),background-color .18s var(--r-bezier),color .18s var(--r-bezier)}.r-layout-preset:hover{border-color:var(--r-theme-primary-color);background:var(--r-surface-hover)}.r-layout-preset[aria-pressed=true]{border-color:var(--r-theme-primary-color);background:color-mix(in srgb,var(--r-theme-primary-color) 10%,var(--r-surface));color:var(--r-selected-text);font-weight:600}.r-layout-preset__label{font-size:11px;overflow-wrap:anywhere}.r-layout-preview{box-sizing:border-box;display:grid;grid-template:minmax(0,1fr) minmax(0,3fr)/minmax(0,1fr) minmax(0,3fr);gap:3px;inline-size:min(65%,37px);max-inline-size:100%;aspect-ratio:1;padding:4px;border:1px solid var(--r-line);border-radius:8px;background:var(--r-surface)}.r-layout-preview>span{border-radius:2px;background:currentColor}.r-layout-preview__aside{grid-area:1/1/3/2;opacity:.65}.r-layout-preview__header{grid-area:1/2/2/3;opacity:.28}.r-layout-preview__body{grid-area:2/2/3/3;opacity:.2}.r-layout-preview--top .r-layout-preview__aside{display:none}.r-layout-preview--top .r-layout-preview__header,.r-layout-preview--top .r-layout-preview__body{grid-column:1/-1}.r-layout-preview--top .r-layout-preview__header,.r-layout-preview--mixed .r-layout-preview__header{opacity:.65}.r-layout-preview--right{grid-template-columns:minmax(0,3fr) minmax(0,1fr)}.r-layout-preview--right .r-layout-preview__aside{grid-column:2}.r-layout-preview--right .r-layout-preview__header,.r-layout-preview--right .r-layout-preview__body{grid-column:1}.r-layout-preview--split .r-layout-preview__header{grid-column:1/-1;opacity:.65}.r-layout-preview--split .r-layout-preview__aside{grid-row:2}.r-layout-preview--mixed .r-layout-preview__header{background:linear-gradient(to bottom,currentColor 30%,transparent 30% 52%,currentColor 52%)}.r-layout-preset__selected{position:absolute;inset-block-start:4px;inset-inline-end:5px;color:var(--r-selected-text);font-size:12px;line-height:1}@media(forced-colors:active){.r-layout-preset[aria-pressed=true]{border-color:Highlight}}@media(prefers-reduced-motion:reduce){.r-layout-preset{transition:none}}.r-layout-top-navigation{display:flex;align-items:center;min-inline-size:0;padding-inline:16px;border-block-end:1px solid var(--r-line);background:var(--r-surface)}.r-layout-top-navigation .r-menu__logo{inline-size:200px}.r-layout-top-navigation .n-menu{flex:1;min-inline-size:0}.menu-tag{padding:5px 0;border-bottom:1px solid var(--r-line);background:var(--r-surface)}.menu-tag-space{box-sizing:border-box;width:100%;padding-inline:var(--ray-shell-tab-gutter, 18px)}.menu-tag__scroll{flex:1;min-width:0}.menu-tag-wrapper{display:flex;align-items:center;gap:6px;width:max-content;padding-block:2px}.menu-tag__item{display:inline-flex;flex:none;align-items:center;min-height:28px;overflow:hidden;border:1px solid transparent;border-radius:7px;background:var(--r-surface-muted);color:var(--r-text-secondary)}.menu-tag__item:hover{background:var(--r-surface-hover)}.menu-tag__item--active{border-color:color-mix(in srgb,var(--r-theme-primary-color) 28%,var(--r-line));background:color-mix(in srgb,var(--r-theme-primary-color) 11%,var(--r-surface));color:var(--r-selected-text)}.menu-tag__tab,.menu-tag__close{border:0;background:transparent;color:inherit;font:inherit;cursor:pointer}.menu-tag__tab:focus-visible,.menu-tag__close:focus-visible{outline-offset:-2px}.menu-tag__tab{max-inline-size:clamp(7rem,24vw,14rem);min-height:28px;padding-inline:10px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;font-size:13px}.menu-tag__close{position:relative;isolation:isolate;display:grid;flex:none;place-items:center;inline-size:0;block-size:26px;padding:0;overflow:hidden;border-radius:5px;opacity:0;pointer-events:none;transition:inline-size .16s var(--r-bezier),opacity .12s ease}.menu-tag__close:before{content:"";position:absolute;z-index:-1;top:3px;right:3px;bottom:3px;left:3px;border-radius:5px;background:currentColor;opacity:0;transition:opacity .12s ease,transform .12s var(--r-bezier)}.menu-tag__close:is(:hover,:active){color:var(--r-text)}.menu-tag__close:hover:before{opacity:.14}.menu-tag__close:active:before{opacity:.24;transform:scale(.88)}.menu-tag__item:focus-within .menu-tag__close{inline-size:26px;opacity:1;pointer-events:auto}@media(hover:hover){.menu-tag__item:hover .menu-tag__close{inline-size:26px;opacity:1;pointer-events:auto}}@media(hover:none){.menu-tag__item--active .menu-tag__close{inline-size:32px;opacity:1;pointer-events:auto}}.menu-tag__right-setting--spinning{animation:elementRotate .8s linear infinite}.override-button__menu-tag{padding:0 6px}@media(forced-colors:active){.menu-tag__item--active{border-color:Highlight}.menu-tag__close:is(:hover,:active):before{border:1px solid ButtonText;background:transparent;opacity:1}}@media(prefers-reduced-motion:reduce){.menu-tag__close,.menu-tag__close:before{transition:none}}.shell-demo[data-v-aae3d615]{--html-height: 100dvh;--html-width: 100vw;--r-theme-primary-color: #3b63d9;color:var(--r-text)}.shell-bar[data-v-aae3d615]{display:flex;flex-wrap:wrap;align-items:center;gap:12px;padding:10px 12px;background:var(--r-surface);border-block-end:1px solid var(--r-line)}.r-barcode{position:relative;width:var(--r-barcode-width);height:var(--r-barcode-height);transition:filter .3s var(--r-bezier)}.r-barcode.r-barcode--loading{filter:blur(4px)}.r-barcode-container{width:100%;height:100%;display:flex;align-items:center;justify-content:center}.r-barcode-container .r-barcode{width:100%;height:100%}.r-barcode-spin,.r-barcode-spin .n-spin-content{width:max-content;height:max-content}.r-barcode-spin:has(.r-barcode-container),.r-barcode-spin:has(.r-barcode-container) .n-spin-content{width:100%;height:100%}.r-table{container:table-panel/inline-size;display:flex;flex-direction:column;gap:16px;inline-size:100%;min-inline-size:0}.r-table__result{display:flex;flex-direction:column;gap:8px;min-inline-size:0}.r-table__header{display:flex;flex-wrap:wrap;align-items:center;gap:10px 16px}.r-table__header h2{color:var(--r-text);font-size:18px;font-weight:650;line-height:1.4}.r-table__toolbar{display:flex;flex-wrap:wrap;align-items:center;justify-content:flex-end;gap:6px;margin-inline-start:auto}.r-table__heading{min-inline-size:0}.r-table--fill{block-size:var(--r-table-height, max(20rem, var(--layout-content-height, 100dvh) - 2 * var(--layout-content-gutter, 16px)))}.r-table--fill>.r-table__result,.r-table--fill>.r-table__result>.n-data-table{flex:1;min-block-size:0}.r-table:fullscreen{box-sizing:border-box;padding:12px;background:var(--r-surface);overflow:auto}.r-table__footer,.r-table__action{color:var(--r-text-secondary);font-size:13px}.r-table__tool[aria-pressed=true]{color:var(--r-selected-text);background:var(--r-surface-hover)}.r-table-search{display:flex;flex-wrap:wrap;align-items:end;gap:12px}.r-table-search__field{display:grid;flex:0 1 16rem;min-inline-size:min(100%,12rem);gap:6px;color:var(--r-text-secondary);font-size:13px;font-weight:550}.r-table-search__actions{display:flex;flex-wrap:wrap;gap:8px}.r-template--dark .r-table-search__submit.n-button,.r-template--dark .r-table-search__submit.n-button:hover,.r-template--dark .r-table-search__submit.n-button:focus-visible,.r-template--dark .r-table-search__submit.n-button:active{color:var(--r-text);background-color:var(--r-surface-hover)}@container table-panel (inline-size < 600px){.r-table__toolbar{gap:4px}.r-table__tool{inline-size:30px;padding-inline:0}.r-table-search__field{flex:1 1 100%}.r-table-search__actions{margin-inline-start:auto}}.r-table-columns{min-inline-size:0;max-inline-size:min(26rem,100vw - 36px);max-block-size:min(28rem,65dvh);overflow:auto;padding:0;border:0}.r-table-columns legend{margin-block-end:6px;color:var(--r-text);font-weight:600}.r-table-columns__check{display:inline-flex;align-items:center;min-block-size:44px;gap:8px;cursor:pointer}.r-table-columns__check input{inline-size:16px;block-size:16px;flex:none;accent-color:var(--r-theme-primary-color)}.r-table-columns__check span{overflow-wrap:anywhere}.table-demo[data-v-890bc3a6]{--r-table-height: 460px}.table-demo[data-v-890bc3a6] .n-data-table-table{display:table;margin:0;overflow:visible}.table-demo[data-v-890bc3a6] .n-data-table-tr{background:transparent;border:0}
diff --git a/docs/assets/tablepro-auto-height.png b/docs/assets/tablepro-auto-height.png
new file mode 100644
index 00000000..a6dc4b6c
Binary files /dev/null and b/docs/assets/tablepro-auto-height.png differ
diff --git a/docs/assets/tablepro-preview.jpg b/docs/assets/tablepro-preview.jpg
new file mode 100644
index 00000000..8bd36377
Binary files /dev/null and b/docs/assets/tablepro-preview.jpg differ
diff --git a/docs/assets/vitest-threads-error.webp b/docs/assets/vitest-threads-error.webp
new file mode 100644
index 00000000..cd8e51f4
Binary files /dev/null and b/docs/assets/vitest-threads-error.webp differ
diff --git a/docs/docs/components/basic/description.html b/docs/docs/components/basic/description.html
new file mode 100644
index 00000000..335b4e5e
--- /dev/null
+++ b/docs/docs/components/basic/description.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/docs/components/basic/qr-code.html b/docs/docs/components/basic/qr-code.html
new file mode 100644
index 00000000..e81962d9
--- /dev/null
+++ b/docs/docs/components/basic/qr-code.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/docs/components/basic/r-barcode.html b/docs/docs/components/basic/r-barcode.html
new file mode 100644
index 00000000..7461557c
--- /dev/null
+++ b/docs/docs/components/basic/r-barcode.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/docs/components/basic/r-chart.html b/docs/docs/components/basic/r-chart.html
new file mode 100644
index 00000000..279aa398
--- /dev/null
+++ b/docs/docs/components/basic/r-chart.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/docs/components/basic/r-collapse-grid.html b/docs/docs/components/basic/r-collapse-grid.html
new file mode 100644
index 00000000..17d8e0d4
--- /dev/null
+++ b/docs/docs/components/basic/r-collapse-grid.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/docs/components/basic/r-form.html b/docs/docs/components/basic/r-form.html
new file mode 100644
index 00000000..7984783d
--- /dev/null
+++ b/docs/docs/components/basic/r-form.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/docs/components/basic/r-icon.html b/docs/docs/components/basic/r-icon.html
new file mode 100644
index 00000000..9a2f86a9
--- /dev/null
+++ b/docs/docs/components/basic/r-icon.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/docs/components/basic/r-iframe.html b/docs/docs/components/basic/r-iframe.html
new file mode 100644
index 00000000..b25191b4
--- /dev/null
+++ b/docs/docs/components/basic/r-iframe.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/docs/components/basic/r-modal.html b/docs/docs/components/basic/r-modal.html
new file mode 100644
index 00000000..ef4b1571
--- /dev/null
+++ b/docs/docs/components/basic/r-modal.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/docs/components/basic/r-more-dropdown.html b/docs/docs/components/basic/r-more-dropdown.html
new file mode 100644
index 00000000..8910e108
--- /dev/null
+++ b/docs/docs/components/basic/r-more-dropdown.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/docs/components/basic/r-segment.html b/docs/docs/components/basic/r-segment.html
new file mode 100644
index 00000000..0d25eb4c
--- /dev/null
+++ b/docs/docs/components/basic/r-segment.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/docs/components/basic/r-table.html b/docs/docs/components/basic/r-table.html
new file mode 100644
index 00000000..d6591c49
--- /dev/null
+++ b/docs/docs/components/basic/r-table.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/docs/components/basic/r-transition-component.html b/docs/docs/components/basic/r-transition-component.html
new file mode 100644
index 00000000..f1d21dba
--- /dev/null
+++ b/docs/docs/components/basic/r-transition-component.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/docs/directives/copy.html b/docs/docs/directives/copy.html
new file mode 100644
index 00000000..4fedf5bf
--- /dev/null
+++ b/docs/docs/directives/copy.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/docs/directives/debounce.html b/docs/docs/directives/debounce.html
new file mode 100644
index 00000000..74a5c73e
--- /dev/null
+++ b/docs/docs/directives/debounce.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/docs/directives/ellipsis.html b/docs/docs/directives/ellipsis.html
new file mode 100644
index 00000000..6111c341
--- /dev/null
+++ b/docs/docs/directives/ellipsis.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/docs/directives/ripple.html b/docs/docs/directives/ripple.html
new file mode 100644
index 00000000..f05c153f
--- /dev/null
+++ b/docs/docs/directives/ripple.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/docs/directives/throttle.html b/docs/docs/directives/throttle.html
new file mode 100644
index 00000000..74a5c73e
--- /dev/null
+++ b/docs/docs/directives/throttle.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/docs/hooks/components/useContextmenuCoordinate.html b/docs/docs/hooks/components/useContextmenuCoordinate.html
new file mode 100644
index 00000000..41184eb7
--- /dev/null
+++ b/docs/docs/hooks/components/useContextmenuCoordinate.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/docs/hooks/description.html b/docs/docs/hooks/description.html
new file mode 100644
index 00000000..a9ae61b6
--- /dev/null
+++ b/docs/docs/hooks/description.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/docs/hooks/template/useAppNavigation.html b/docs/docs/hooks/template/useAppNavigation.html
new file mode 100644
index 00000000..486f8a0e
--- /dev/null
+++ b/docs/docs/hooks/template/useAppNavigation.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/docs/hooks/template/useAppRoot.html b/docs/docs/hooks/template/useAppRoot.html
new file mode 100644
index 00000000..1a664658
--- /dev/null
+++ b/docs/docs/hooks/template/useAppRoot.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/docs/hooks/template/useBadge.html b/docs/docs/hooks/template/useBadge.html
new file mode 100644
index 00000000..24981954
--- /dev/null
+++ b/docs/docs/hooks/template/useBadge.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/docs/hooks/template/useContentScroll.html b/docs/docs/hooks/template/useContentScroll.html
new file mode 100644
index 00000000..e8d348a7
--- /dev/null
+++ b/docs/docs/hooks/template/useContentScroll.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/docs/hooks/template/useMaximize.html b/docs/docs/hooks/template/useMaximize.html
new file mode 100644
index 00000000..fe9ffff5
--- /dev/null
+++ b/docs/docs/hooks/template/useMaximize.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/docs/hooks/template/useSiderBar.html b/docs/docs/hooks/template/useSiderBar.html
new file mode 100644
index 00000000..5141d4b6
--- /dev/null
+++ b/docs/docs/hooks/template/useSiderBar.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/docs/hooks/template/useSiderScroll.html b/docs/docs/hooks/template/useSiderScroll.html
new file mode 100644
index 00000000..76fb57c0
--- /dev/null
+++ b/docs/docs/hooks/template/useSiderScroll.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/docs/hooks/template/useSpinning.html b/docs/docs/hooks/template/useSpinning.html
new file mode 100644
index 00000000..ff4728c6
--- /dev/null
+++ b/docs/docs/hooks/template/useSpinning.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/docs/hooks/template/useTheme.html b/docs/docs/hooks/template/useTheme.html
new file mode 100644
index 00000000..102287d7
--- /dev/null
+++ b/docs/docs/hooks/template/useTheme.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/docs/hooks/template/useWatermark.html b/docs/docs/hooks/template/useWatermark.html
new file mode 100644
index 00000000..7d5bce57
--- /dev/null
+++ b/docs/docs/hooks/template/useWatermark.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/docs/hooks/web/useDayjs.html b/docs/docs/hooks/web/useDayjs.html
new file mode 100644
index 00000000..e4b377e1
--- /dev/null
+++ b/docs/docs/hooks/web/useDayjs.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/docs/hooks/web/useDevice.html b/docs/docs/hooks/web/useDevice.html
new file mode 100644
index 00000000..0fc30da7
--- /dev/null
+++ b/docs/docs/hooks/web/useDevice.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/docs/hooks/web/useDomToImage.html b/docs/docs/hooks/web/useDomToImage.html
new file mode 100644
index 00000000..a9b59742
--- /dev/null
+++ b/docs/docs/hooks/web/useDomToImage.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/docs/hooks/web/useElementFullscreen.html b/docs/docs/hooks/web/useElementFullscreen.html
new file mode 100644
index 00000000..2a997ec0
--- /dev/null
+++ b/docs/docs/hooks/web/useElementFullscreen.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/docs/hooks/web/useI18n.html b/docs/docs/hooks/web/useI18n.html
new file mode 100644
index 00000000..ab0a1a85
--- /dev/null
+++ b/docs/docs/hooks/web/useI18n.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/docs/hooks/web/usePagination.html b/docs/docs/hooks/web/usePagination.html
new file mode 100644
index 00000000..a9e20a9c
--- /dev/null
+++ b/docs/docs/hooks/web/usePagination.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/docs/hooks/web/usePrint.html b/docs/docs/hooks/web/usePrint.html
new file mode 100644
index 00000000..e4e36e1f
--- /dev/null
+++ b/docs/docs/hooks/web/usePrint.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/docs/hooks/web/useVueRouter.html b/docs/docs/hooks/web/useVueRouter.html
new file mode 100644
index 00000000..21f8ab8c
--- /dev/null
+++ b/docs/docs/hooks/web/useVueRouter.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/docs/norm/annotation.html b/docs/docs/norm/annotation.html
new file mode 100644
index 00000000..9001fd16
--- /dev/null
+++ b/docs/docs/norm/annotation.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/docs/norm/api.html b/docs/docs/norm/api.html
new file mode 100644
index 00000000..ae10fd04
--- /dev/null
+++ b/docs/docs/norm/api.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/docs/norm/css.html b/docs/docs/norm/css.html
new file mode 100644
index 00000000..f8dd0126
--- /dev/null
+++ b/docs/docs/norm/css.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/docs/norm/export.html b/docs/docs/norm/export.html
new file mode 100644
index 00000000..9001fd16
--- /dev/null
+++ b/docs/docs/norm/export.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/docs/norm/format.html b/docs/docs/norm/format.html
new file mode 100644
index 00000000..9001fd16
--- /dev/null
+++ b/docs/docs/norm/format.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/docs/norm/hook.html b/docs/docs/norm/hook.html
new file mode 100644
index 00000000..9001fd16
--- /dev/null
+++ b/docs/docs/norm/hook.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/docs/norm/import.html b/docs/docs/norm/import.html
new file mode 100644
index 00000000..9001fd16
--- /dev/null
+++ b/docs/docs/norm/import.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/docs/norm/name.html b/docs/docs/norm/name.html
new file mode 100644
index 00000000..9001fd16
--- /dev/null
+++ b/docs/docs/norm/name.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/docs/refer/env-configuration.html b/docs/docs/refer/env-configuration.html
new file mode 100644
index 00000000..9001fd16
--- /dev/null
+++ b/docs/docs/refer/env-configuration.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/docs/refer/setup.html b/docs/docs/refer/setup.html
new file mode 100644
index 00000000..9001fd16
--- /dev/null
+++ b/docs/docs/refer/setup.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/guide/appearance.html b/docs/guide/appearance.html
new file mode 100644
index 00000000..2231dcb0
--- /dev/null
+++ b/docs/guide/appearance.html
@@ -0,0 +1,34 @@
+
+
+
+
+
+ 主题与国际化 · Ray Template 文档
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/guide/architecture.html b/docs/guide/architecture.html
new file mode 100644
index 00000000..d0bc049a
--- /dev/null
+++ b/docs/guide/architecture.html
@@ -0,0 +1,33 @@
+
+
+
+
+
+ v6 Monorepo 架构 · Ray Template 文档
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/guide/first-page.html b/docs/guide/first-page.html
new file mode 100644
index 00000000..f9a5617c
--- /dev/null
+++ b/docs/guide/first-page.html
@@ -0,0 +1,59 @@
+
+
+
+
+
+ 第一个业务页面 · Ray Template 文档
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/guide/layout.html b/docs/guide/layout.html
new file mode 100644
index 00000000..cc46c73a
--- /dev/null
+++ b/docs/guide/layout.html
@@ -0,0 +1,224 @@
+
+
+
+
+
+ 应用布局与状态 · Ray Template 文档
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/guide/requests.html b/docs/guide/requests.html
new file mode 100644
index 00000000..bb307d96
--- /dev/null
+++ b/docs/guide/requests.html
@@ -0,0 +1,51 @@
+
+
+
+
+
+ 接口、取消与 Mock · Ray Template 文档
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/guide/routing.html b/docs/guide/routing.html
new file mode 100644
index 00000000..873ff933
--- /dev/null
+++ b/docs/guide/routing.html
@@ -0,0 +1,111 @@
+
+
+
+
+
+ 路由、菜单与权限 · Ray Template 文档
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/guide/start.html b/docs/guide/start.html
new file mode 100644
index 00000000..58df9751
--- /dev/null
+++ b/docs/guide/start.html
@@ -0,0 +1,33 @@
+
+
+
+
+
+ 快速开始 · Ray Template 文档
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/guide/tooling.html b/docs/guide/tooling.html
new file mode 100644
index 00000000..df4386c6
--- /dev/null
+++ b/docs/guide/tooling.html
@@ -0,0 +1,26 @@
+
+
+
+
+
+ 工程检查与部署 · Ray Template 文档
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/hashmap.json b/docs/hashmap.json
new file mode 100644
index 00000000..17fb6329
--- /dev/null
+++ b/docs/hashmap.json
@@ -0,0 +1 @@
+{"guide_appearance.md":"D-523bFh","guide_architecture.md":"C6HIHYR1","guide_first-page.md":"z-hytCrx","guide_layout.md":"B7nfsGPS","guide_requests.md":"DXAGH_Ni","guide_routing.md":"CyhQoTmx","guide_start.md":"B6oCR027","guide_tooling.md":"CkJoP04H","index.md":"nUYT09g4","migration.md":"CIZms3hv","playground_shell.md":"CH48frZN","reference_components.md":"iMZjSjdU","reference_components_app.md":"Q6aQiDRo","reference_components_barcode.md":"BbJVFbEo","reference_components_chart.md":"JthpvMcl","reference_components_collapse-grid.md":"_8SHiB6D","reference_components_draggable-card.md":"4XemeqwB","reference_components_flow.md":"s-rnj-8X","reference_components_form.md":"BrB2cmbN","reference_components_iframe.md":"CZP63QsN","reference_components_modal.md":"bQ_aJsj-","reference_components_more-dropdown.md":"BubiDbuv","reference_components_qr-code.md":"BtXSFJtd","reference_components_route-transition.md":"Dg7dX5PR","reference_components_segment.md":"BrQOf2XY","reference_configuration.md":"BeYwV4AY","reference_directives.md":"DZcDGixq","reference_hooks.md":"fkz_ntnz","reference_hooks_appearance.md":"JMrRj834","reference_hooks_browser.md":"D5n_xtb0","reference_hooks_interaction.md":"Big820ZZ","reference_hooks_layout.md":"BcnUJtrr","reference_hooks_navigation.md":"CGGlTsKj","reference_hooks_output.md":"B8QXZTOo","reference_icons.md":"lwCUuJHp","reference_index.md":"DRoeAVBG","reference_source.md":"M6GWIIfO","reference_store.md":"BykMC8BP","reference_store_navigation.md":"BBSrn9C3","reference_store_runtime.md":"DN1nqjBy","reference_store_setting.md":"CB2Icw7k","reference_store_signing.md":"453f7xx-","reference_table-pro.md":"DW6Gztpq","reference_utils.md":"CPo2FGYU","reference_utils_browser.md":"mqqbsAE7","reference_utils_core.md":"D6K4f3-H","reference_utils_storage.md":"aIMEPocl"}
diff --git a/docs/index.html b/docs/index.html
new file mode 100644
index 00000000..eb52f947
--- /dev/null
+++ b/docs/index.html
@@ -0,0 +1,26 @@
+
+
+
+
+
+ 开发者文档 · Ray Template 文档
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 跳转到正文TablePro 自适应高度
表格填满可用高度,数据在表内滚动。

+
+
+
+
\ No newline at end of file
diff --git a/docs/logo.svg b/docs/logo.svg
new file mode 100644
index 00000000..daaef75a
--- /dev/null
+++ b/docs/logo.svg
@@ -0,0 +1,14 @@
+
\ No newline at end of file
diff --git a/docs/migration.html b/docs/migration.html
new file mode 100644
index 00000000..8c07f57e
--- /dev/null
+++ b/docs/migration.html
@@ -0,0 +1,26 @@
+
+
+
+
+
+ v5 与 v6 的版本分界 · Ray Template 文档
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/playground/shell.html b/docs/playground/shell.html
new file mode 100644
index 00000000..dfbbbe15
--- /dev/null
+++ b/docs/playground/shell.html
@@ -0,0 +1,27 @@
+
+
+
+
+
+ Ray Template · Ray Template 文档
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/ray-mark.svg b/docs/ray-mark.svg
new file mode 100644
index 00000000..134cc953
--- /dev/null
+++ b/docs/ray-mark.svg
@@ -0,0 +1,5 @@
+
diff --git a/docs/ray-template-docs/advanced/app-global-provider.html b/docs/ray-template-docs/advanced/app-global-provider.html
new file mode 100644
index 00000000..51498121
--- /dev/null
+++ b/docs/ray-template-docs/advanced/app-global-provider.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/ray-template-docs/advanced/cdn.html b/docs/ray-template-docs/advanced/cdn.html
new file mode 100644
index 00000000..9001fd16
--- /dev/null
+++ b/docs/ray-template-docs/advanced/cdn.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/ray-template-docs/advanced/commit.html b/docs/ray-template-docs/advanced/commit.html
new file mode 100644
index 00000000..9001fd16
--- /dev/null
+++ b/docs/ray-template-docs/advanced/commit.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/ray-template-docs/advanced/echart-themes.html b/docs/ray-template-docs/advanced/echart-themes.html
new file mode 100644
index 00000000..f8dd0126
--- /dev/null
+++ b/docs/ray-template-docs/advanced/echart-themes.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/ray-template-docs/advanced/eslint.html b/docs/ray-template-docs/advanced/eslint.html
new file mode 100644
index 00000000..9001fd16
--- /dev/null
+++ b/docs/ray-template-docs/advanced/eslint.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/ray-template-docs/advanced/hooks/components.html b/docs/ray-template-docs/advanced/hooks/components.html
new file mode 100644
index 00000000..a9ae61b6
--- /dev/null
+++ b/docs/ray-template-docs/advanced/hooks/components.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/ray-template-docs/advanced/hooks/template.html b/docs/ray-template-docs/advanced/hooks/template.html
new file mode 100644
index 00000000..a9ae61b6
--- /dev/null
+++ b/docs/ray-template-docs/advanced/hooks/template.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/ray-template-docs/advanced/hooks/web.html b/docs/ray-template-docs/advanced/hooks/web.html
new file mode 100644
index 00000000..a9ae61b6
--- /dev/null
+++ b/docs/ray-template-docs/advanced/hooks/web.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/ray-template-docs/advanced/husky.html b/docs/ray-template-docs/advanced/husky.html
new file mode 100644
index 00000000..9001fd16
--- /dev/null
+++ b/docs/ray-template-docs/advanced/husky.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/ray-template-docs/advanced/mock.html b/docs/ray-template-docs/advanced/mock.html
new file mode 100644
index 00000000..ae10fd04
--- /dev/null
+++ b/docs/ray-template-docs/advanced/mock.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/ray-template-docs/advanced/postcss.html b/docs/ray-template-docs/advanced/postcss.html
new file mode 100644
index 00000000..f8dd0126
--- /dev/null
+++ b/docs/ray-template-docs/advanced/postcss.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/ray-template-docs/advanced/reactivity.html b/docs/ray-template-docs/advanced/reactivity.html
new file mode 100644
index 00000000..0d8d2c8c
--- /dev/null
+++ b/docs/ray-template-docs/advanced/reactivity.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/ray-template-docs/advanced/types.html b/docs/ray-template-docs/advanced/types.html
new file mode 100644
index 00000000..9001fd16
--- /dev/null
+++ b/docs/ray-template-docs/advanced/types.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/ray-template-docs/advanced/version.html b/docs/ray-template-docs/advanced/version.html
new file mode 100644
index 00000000..d4fa2f9c
--- /dev/null
+++ b/docs/ray-template-docs/advanced/version.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/ray-template-docs/advanced/vitest.html b/docs/ray-template-docs/advanced/vitest.html
new file mode 100644
index 00000000..9001fd16
--- /dev/null
+++ b/docs/ray-template-docs/advanced/vitest.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/ray-template-docs/common-problem/build.html b/docs/ray-template-docs/common-problem/build.html
new file mode 100644
index 00000000..9001fd16
--- /dev/null
+++ b/docs/ray-template-docs/common-problem/build.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/ray-template-docs/common-problem/hmr.html b/docs/ray-template-docs/common-problem/hmr.html
new file mode 100644
index 00000000..9001fd16
--- /dev/null
+++ b/docs/ray-template-docs/common-problem/hmr.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/ray-template-docs/common-problem/keep-alive.html b/docs/ray-template-docs/common-problem/keep-alive.html
new file mode 100644
index 00000000..12daf061
--- /dev/null
+++ b/docs/ray-template-docs/common-problem/keep-alive.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/ray-template-docs/common-problem/request-cancel.html b/docs/ray-template-docs/common-problem/request-cancel.html
new file mode 100644
index 00000000..ae10fd04
--- /dev/null
+++ b/docs/ray-template-docs/common-problem/request-cancel.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/ray-template-docs/dev/auth.html b/docs/ray-template-docs/dev/auth.html
new file mode 100644
index 00000000..12daf061
--- /dev/null
+++ b/docs/ray-template-docs/dev/auth.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/ray-template-docs/dev/axios.html b/docs/ray-template-docs/dev/axios.html
new file mode 100644
index 00000000..ae10fd04
--- /dev/null
+++ b/docs/ray-template-docs/dev/axios.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/ray-template-docs/dev/build.html b/docs/ray-template-docs/dev/build.html
new file mode 100644
index 00000000..9001fd16
--- /dev/null
+++ b/docs/ray-template-docs/dev/build.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/ray-template-docs/dev/component.html b/docs/ray-template-docs/dev/component.html
new file mode 100644
index 00000000..335b4e5e
--- /dev/null
+++ b/docs/ray-template-docs/dev/component.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/ray-template-docs/dev/config.html b/docs/ray-template-docs/dev/config.html
new file mode 100644
index 00000000..9001fd16
--- /dev/null
+++ b/docs/ray-template-docs/dev/config.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/ray-template-docs/dev/data-state/global-variable.html b/docs/ray-template-docs/dev/data-state/global-variable.html
new file mode 100644
index 00000000..23163d36
--- /dev/null
+++ b/docs/ray-template-docs/dev/data-state/global-variable.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/ray-template-docs/dev/data-state/pinia.html b/docs/ray-template-docs/dev/data-state/pinia.html
new file mode 100644
index 00000000..f3c28717
--- /dev/null
+++ b/docs/ray-template-docs/dev/data-state/pinia.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/ray-template-docs/dev/file.html b/docs/ray-template-docs/dev/file.html
new file mode 100644
index 00000000..9001fd16
--- /dev/null
+++ b/docs/ray-template-docs/dev/file.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/ray-template-docs/dev/i18n.html b/docs/ray-template-docs/dev/i18n.html
new file mode 100644
index 00000000..f8dd0126
--- /dev/null
+++ b/docs/ray-template-docs/dev/i18n.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/ray-template-docs/dev/menu.html b/docs/ray-template-docs/dev/menu.html
new file mode 100644
index 00000000..12daf061
--- /dev/null
+++ b/docs/ray-template-docs/dev/menu.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/ray-template-docs/dev/regulation.html b/docs/ray-template-docs/dev/regulation.html
new file mode 100644
index 00000000..9001fd16
--- /dev/null
+++ b/docs/ray-template-docs/dev/regulation.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/ray-template-docs/dev/router.html b/docs/ray-template-docs/dev/router.html
new file mode 100644
index 00000000..12daf061
--- /dev/null
+++ b/docs/ray-template-docs/dev/router.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/ray-template-docs/dev/scomponent.html b/docs/ray-template-docs/dev/scomponent.html
new file mode 100644
index 00000000..335b4e5e
--- /dev/null
+++ b/docs/ray-template-docs/dev/scomponent.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/ray-template-docs/dev/style.html b/docs/ray-template-docs/dev/style.html
new file mode 100644
index 00000000..f8dd0126
--- /dev/null
+++ b/docs/ray-template-docs/dev/style.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/ray-template-docs/dev/utils/basic.html b/docs/ray-template-docs/dev/utils/basic.html
new file mode 100644
index 00000000..0d8d2c8c
--- /dev/null
+++ b/docs/ray-template-docs/dev/utils/basic.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/ray-template-docs/dev/utils/cache.html b/docs/ray-template-docs/dev/utils/cache.html
new file mode 100644
index 00000000..0d8d2c8c
--- /dev/null
+++ b/docs/ray-template-docs/dev/utils/cache.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/ray-template-docs/dev/utils/directive/create-directive.html b/docs/ray-template-docs/dev/utils/directive/create-directive.html
new file mode 100644
index 00000000..ea73cf4a
--- /dev/null
+++ b/docs/ray-template-docs/dev/utils/directive/create-directive.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/ray-template-docs/dev/utils/directive/directive.html b/docs/ray-template-docs/dev/utils/directive/directive.html
new file mode 100644
index 00000000..ea73cf4a
--- /dev/null
+++ b/docs/ray-template-docs/dev/utils/directive/directive.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/ray-template-docs/dev/utils/dom.html b/docs/ray-template-docs/dev/utils/dom.html
new file mode 100644
index 00000000..0d8d2c8c
--- /dev/null
+++ b/docs/ray-template-docs/dev/utils/dom.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/ray-template-docs/dev/utils/element.html b/docs/ray-template-docs/dev/utils/element.html
new file mode 100644
index 00000000..0d8d2c8c
--- /dev/null
+++ b/docs/ray-template-docs/dev/utils/element.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/ray-template-docs/dev/utils/precision.html b/docs/ray-template-docs/dev/utils/precision.html
new file mode 100644
index 00000000..0d8d2c8c
--- /dev/null
+++ b/docs/ray-template-docs/dev/utils/precision.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/ray-template-docs/dev/utils/vue.html b/docs/ray-template-docs/dev/utils/vue.html
new file mode 100644
index 00000000..0d8d2c8c
--- /dev/null
+++ b/docs/ray-template-docs/dev/utils/vue.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/ray-template-docs/guide/concept.html b/docs/ray-template-docs/guide/concept.html
new file mode 100644
index 00000000..7c7a34ad
--- /dev/null
+++ b/docs/ray-template-docs/guide/concept.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/ray-template-docs/guide/features.html b/docs/ray-template-docs/guide/features.html
new file mode 100644
index 00000000..7c7a34ad
--- /dev/null
+++ b/docs/ray-template-docs/guide/features.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/ray-template-docs/guide/setup.html b/docs/ray-template-docs/guide/setup.html
new file mode 100644
index 00000000..7c7a34ad
--- /dev/null
+++ b/docs/ray-template-docs/guide/setup.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/ray-template-docs/guide/why.html b/docs/ray-template-docs/guide/why.html
new file mode 100644
index 00000000..7c7a34ad
--- /dev/null
+++ b/docs/ray-template-docs/guide/why.html
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+文档已迁移 · Ray Template
+这篇文档已迁移。前往新版文档。
+
diff --git a/docs/reference/components.html b/docs/reference/components.html
new file mode 100644
index 00000000..97419040
--- /dev/null
+++ b/docs/reference/components.html
@@ -0,0 +1,26 @@
+
+
+
+
+
+ 组件 · Ray Template 文档
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/reference/components/app.html b/docs/reference/components/app.html
new file mode 100644
index 00000000..b1147bf2
--- /dev/null
+++ b/docs/reference/components/app.html
@@ -0,0 +1,35 @@
+
+
+
+
+
+ 应用组件与 Provider · Ray Template 文档
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/reference/components/barcode.html b/docs/reference/components/barcode.html
new file mode 100644
index 00000000..f20cee0b
--- /dev/null
+++ b/docs/reference/components/barcode.html
@@ -0,0 +1,130 @@
+
+
+
+
+
+ RBarcode · Ray Template 文档
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/reference/components/chart.html b/docs/reference/components/chart.html
new file mode 100644
index 00000000..5a27ba02
--- /dev/null
+++ b/docs/reference/components/chart.html
@@ -0,0 +1,46 @@
+
+
+
+
+
+ RChart 与 useChart · Ray Template 文档
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/reference/components/collapse-grid.html b/docs/reference/components/collapse-grid.html
new file mode 100644
index 00000000..4f3c6938
--- /dev/null
+++ b/docs/reference/components/collapse-grid.html
@@ -0,0 +1,59 @@
+
+
+
+
+
+ RCollapseGrid · Ray Template 文档
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/reference/components/draggable-card.html b/docs/reference/components/draggable-card.html
new file mode 100644
index 00000000..3021e51a
--- /dev/null
+++ b/docs/reference/components/draggable-card.html
@@ -0,0 +1,37 @@
+
+
+
+
+
+ RDraggableCard · Ray Template 文档
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/reference/components/flow.html b/docs/reference/components/flow.html
new file mode 100644
index 00000000..61add63f
--- /dev/null
+++ b/docs/reference/components/flow.html
@@ -0,0 +1,53 @@
+
+
+
+
+
+ RFlow 与 useFlow · Ray Template 文档
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/reference/components/form.html b/docs/reference/components/form.html
new file mode 100644
index 00000000..b4fe4f73
--- /dev/null
+++ b/docs/reference/components/form.html
@@ -0,0 +1,67 @@
+
+
+
+
+
+ RForm 与 useForm · Ray Template 文档
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/reference/components/iframe.html b/docs/reference/components/iframe.html
new file mode 100644
index 00000000..de53a468
--- /dev/null
+++ b/docs/reference/components/iframe.html
@@ -0,0 +1,30 @@
+
+
+
+
+
+ RIframe · Ray Template 文档
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/reference/components/modal.html b/docs/reference/components/modal.html
new file mode 100644
index 00000000..a187be42
--- /dev/null
+++ b/docs/reference/components/modal.html
@@ -0,0 +1,56 @@
+
+
+
+
+
+ RModal 与弹窗 · Ray Template 文档
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/reference/components/more-dropdown.html b/docs/reference/components/more-dropdown.html
new file mode 100644
index 00000000..6dd53b5a
--- /dev/null
+++ b/docs/reference/components/more-dropdown.html
@@ -0,0 +1,46 @@
+
+
+
+
+
+ RMoreDropdown · Ray Template 文档
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/reference/components/qr-code.html b/docs/reference/components/qr-code.html
new file mode 100644
index 00000000..29bd17d4
--- /dev/null
+++ b/docs/reference/components/qr-code.html
@@ -0,0 +1,40 @@
+
+
+
+
+
+ 二维码 · Ray Template 文档
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/reference/components/route-transition.html b/docs/reference/components/route-transition.html
new file mode 100644
index 00000000..7bf87c44
--- /dev/null
+++ b/docs/reference/components/route-transition.html
@@ -0,0 +1,30 @@
+
+
+
+
+
+ RTransitionComponent · Ray Template 文档
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/reference/components/segment.html b/docs/reference/components/segment.html
new file mode 100644
index 00000000..5cb03bc6
--- /dev/null
+++ b/docs/reference/components/segment.html
@@ -0,0 +1,46 @@
+
+
+
+
+
+ RSegment · Ray Template 文档
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/reference/configuration.html b/docs/reference/configuration.html
new file mode 100644
index 00000000..dbe57cbf
--- /dev/null
+++ b/docs/reference/configuration.html
@@ -0,0 +1,26 @@
+
+
+
+
+
+ 应用配置 · Ray Template 文档
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/reference/directives.html b/docs/reference/directives.html
new file mode 100644
index 00000000..77395559
--- /dev/null
+++ b/docs/reference/directives.html
@@ -0,0 +1,92 @@
+
+
+
+
+
+ 指令 · Ray Template 文档
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/reference/hooks.html b/docs/reference/hooks.html
new file mode 100644
index 00000000..03d3f007
--- /dev/null
+++ b/docs/reference/hooks.html
@@ -0,0 +1,26 @@
+
+
+
+
+
+ Hooks · Ray Template 文档
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/reference/hooks/appearance.html b/docs/reference/hooks/appearance.html
new file mode 100644
index 00000000..ce438d1c
--- /dev/null
+++ b/docs/reference/hooks/appearance.html
@@ -0,0 +1,51 @@
+
+
+
+
+
+ 主题、语言和水印 Hooks · Ray Template 文档
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/reference/hooks/browser.html b/docs/reference/hooks/browser.html
new file mode 100644
index 00000000..67c5e46d
--- /dev/null
+++ b/docs/reference/hooks/browser.html
@@ -0,0 +1,73 @@
+
+
+
+
+
+ 窗口、全屏和日期 · Ray Template 文档
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/reference/hooks/interaction.html b/docs/reference/hooks/interaction.html
new file mode 100644
index 00000000..b01fe3de
--- /dev/null
+++ b/docs/reference/hooks/interaction.html
@@ -0,0 +1,59 @@
+
+
+
+
+
+ 分页与右键菜单 · Ray Template 文档
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/reference/hooks/layout.html b/docs/reference/hooks/layout.html
new file mode 100644
index 00000000..3d11d68f
--- /dev/null
+++ b/docs/reference/hooks/layout.html
@@ -0,0 +1,53 @@
+
+
+
+
+
+ 布局与滚动 Hooks · Ray Template 文档
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/reference/hooks/navigation.html b/docs/reference/hooks/navigation.html
new file mode 100644
index 00000000..e426b7d0
--- /dev/null
+++ b/docs/reference/hooks/navigation.html
@@ -0,0 +1,58 @@
+
+
+
+
+
+ 导航与菜单 · Ray Template 文档
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/reference/hooks/output.html b/docs/reference/hooks/output.html
new file mode 100644
index 00000000..c3c0aea5
--- /dev/null
+++ b/docs/reference/hooks/output.html
@@ -0,0 +1,47 @@
+
+
+
+
+
+ DOM 截图与打印 · Ray Template 文档
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/reference/icons.html b/docs/reference/icons.html
new file mode 100644
index 00000000..fa7667d8
--- /dev/null
+++ b/docs/reference/icons.html
@@ -0,0 +1,31 @@
+
+
+
+
+
+ SVG 图标 · Ray Template 文档
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/reference/index.html b/docs/reference/index.html
new file mode 100644
index 00000000..83acdf59
--- /dev/null
+++ b/docs/reference/index.html
@@ -0,0 +1,26 @@
+
+
+
+
+
+ API 参考 · Ray Template 文档
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/reference/source.html b/docs/reference/source.html
new file mode 100644
index 00000000..4a74ac0e
--- /dev/null
+++ b/docs/reference/source.html
@@ -0,0 +1,26 @@
+
+
+
+
+
+ 文档与源码版本 · Ray Template 文档
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/reference/store.html b/docs/reference/store.html
new file mode 100644
index 00000000..f2ca29d7
--- /dev/null
+++ b/docs/reference/store.html
@@ -0,0 +1,26 @@
+
+
+
+
+
+ Store · Ray Template 文档
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/reference/store/navigation.html b/docs/reference/store/navigation.html
new file mode 100644
index 00000000..14a0b4b0
--- /dev/null
+++ b/docs/reference/store/navigation.html
@@ -0,0 +1,32 @@
+
+
+
+
+
+ Menu 与 KeepAlive Store · Ray Template 文档
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/reference/store/runtime.html b/docs/reference/store/runtime.html
new file mode 100644
index 00000000..51e39be9
--- /dev/null
+++ b/docs/reference/store/runtime.html
@@ -0,0 +1,38 @@
+
+
+
+
+
+ Runtime 与 Lock Screen Store · Ray Template 文档
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/reference/store/setting.html b/docs/reference/store/setting.html
new file mode 100644
index 00000000..cd15e462
--- /dev/null
+++ b/docs/reference/store/setting.html
@@ -0,0 +1,38 @@
+
+
+
+
+
+ Setting Store · Ray Template 文档
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/reference/store/signing.html b/docs/reference/store/signing.html
new file mode 100644
index 00000000..66197009
--- /dev/null
+++ b/docs/reference/store/signing.html
@@ -0,0 +1,33 @@
+
+
+
+
+
+ Signing Store · Ray Template 文档
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/reference/table-pro.html b/docs/reference/table-pro.html
new file mode 100644
index 00000000..44657768
--- /dev/null
+++ b/docs/reference/table-pro.html
@@ -0,0 +1,238 @@
+
+
+
+
+
+ TablePro · Ray Template 文档
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/reference/utils.html b/docs/reference/utils.html
new file mode 100644
index 00000000..4e6baeb7
--- /dev/null
+++ b/docs/reference/utils.html
@@ -0,0 +1,26 @@
+
+
+
+
+
+ 工具函数 · Ray Template 文档
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/reference/utils/browser.html b/docs/reference/utils/browser.html
new file mode 100644
index 00000000..9935b8a9
--- /dev/null
+++ b/docs/reference/utils/browser.html
@@ -0,0 +1,29 @@
+
+
+
+
+
+ Vue 与浏览器工具 · Ray Template 文档
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/reference/utils/core.html b/docs/reference/utils/core.html
new file mode 100644
index 00000000..71fe0f1f
--- /dev/null
+++ b/docs/reference/utils/core.html
@@ -0,0 +1,116 @@
+
+
+
+
+
+ 基础、日期和数值工具 · Ray Template 文档
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/reference/utils/storage.html b/docs/reference/utils/storage.html
new file mode 100644
index 00000000..2217a2e8
--- /dev/null
+++ b/docs/reference/utils/storage.html
@@ -0,0 +1,35 @@
+
+
+
+
+
+ 缓存与兼容加密 · Ray Template 文档
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/vp-icons.css b/docs/vp-icons.css
new file mode 100644
index 00000000..ddc5bd8e
--- /dev/null
+++ b/docs/vp-icons.css
@@ -0,0 +1 @@
+.vpi-social-github{--icon:url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' width='24' height='24'%3E%3Cpath fill='black' d='M12 .297c-6.63 0-12 5.373-12 12c0 5.303 3.438 9.8 8.205 11.385c.6.113.82-.258.82-.577c0-.285-.01-1.04-.015-2.04c-3.338.724-4.042-1.61-4.042-1.61C4.422 18.07 3.633 17.7 3.633 17.7c-1.087-.744.084-.729.084-.729c1.205.084 1.838 1.236 1.838 1.236c1.07 1.835 2.809 1.305 3.495.998c.108-.776.417-1.305.76-1.605c-2.665-.3-5.466-1.332-5.466-5.93c0-1.31.465-2.38 1.235-3.22c-.135-.303-.54-1.523.105-3.176c0 0 1.005-.322 3.3 1.23c.96-.267 1.98-.399 3-.405c1.02.006 2.04.138 3 .405c2.28-1.552 3.285-1.23 3.285-1.23c.645 1.653.24 2.873.12 3.176c.765.84 1.23 1.91 1.23 3.22c0 4.61-2.805 5.625-5.475 5.92c.42.36.81 1.096.81 2.22c0 1.606-.015 2.896-.015 3.286c0 .315.21.69.825.57C20.565 22.092 24 17.592 24 12.297c0-6.627-5.373-12-12-12'/%3E%3C/svg%3E")}
\ No newline at end of file
diff --git a/index.html b/index.html
index bda9a574..1d295e10 100644
--- a/index.html
+++ b/index.html
@@ -5,7 +5,7 @@
-
+
@@ -15,7 +15,7 @@
- Ray Template - Vue 3 中后台管理模板
+ Ray Admin - Vue 3 中后台管理模板
+
-
+
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+