[{"data":1,"prerenderedAt":711},["ShallowReactive",2],{"content:\u002Fvite-plugin-uni-pages\u002Fguide":3,"section:vite-plugin-uni-pages":691},{"id":4,"title":5,"aside":6,"authors":7,"badges":8,"banner":7,"body":17,"breadcrumb":6,"collapse":682,"description":683,"editLink":6,"extension":684,"fullpage":682,"header":7,"icon":685,"main":7,"meta":686,"navBadges":7,"navTruncate":682,"navigation":7,"path":687,"prevNext":6,"seo":688,"stem":689,"toc":6,"__hash__":690},"content\u002Fvite-plugin-uni-pages\u002F1.guide.md","起步",true,null,[9,13],{"value":10,"to":11,"target":12},"npm","https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@uni-helper\u002Fvite-plugin-uni-pages","_blank",{"value":14,"icon":15,"to":16,"target":12},"source","lucide:code","https:\u002F\u002Fgithub.com\u002Funi-helper\u002Fvite-plugin-uni-pages",{"type":18,"value":19,"toc":672},"minimark",[20,32,36,40,43,53,195,205,208,226,339,342,357,472,475,484,490,493,496,569,572,618,639,642,668],[21,22,23,24,28,29,31],"p",{},"本插件扫描页面目录，生成 uni-app 需要的 ",[25,26,27],"code",{},"pages.json","。页面路由由文件路径推导，不用手写 ",[25,30,27],{},"。",[33,34,35],"h2",{"id":35},"安装",[37,38],"pm-install",{"name":39},"-D @uni-helper\u002Fvite-plugin-uni-pages",[33,41,42],{"id":42},"使用",[21,44,45,48,49,52],{},[25,46,47],{},"UniPages()"," 必须放在 ",[25,50,51],{},"Uni()"," 之前。",[54,55,61],"pre",{"className":56,"code":57,"filename":58,"language":59,"meta":60,"style":60},"language-ts shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","import Uni from '@dcloudio\u002Fvite-plugin-uni'\nimport UniPages from '@uni-helper\u002Fvite-plugin-uni-pages'\nimport { defineConfig } from 'vite'\n\nexport default defineConfig({\n  plugins: [UniPages(), Uni()],\n})\n","vite.config.ts","ts","",[25,62,63,90,107,131,137,155,186],{"__ignoreMap":60},[64,65,68,72,76,79,83,87],"span",{"class":66,"line":67},"line",1,[64,69,71],{"class":70},"s7zQu","import",[64,73,75],{"class":74},"sTEyZ"," Uni ",[64,77,78],{"class":70},"from",[64,80,82],{"class":81},"sMK4o"," '",[64,84,86],{"class":85},"sfazB","@dcloudio\u002Fvite-plugin-uni",[64,88,89],{"class":81},"'\n",[64,91,93,95,98,100,102,105],{"class":66,"line":92},2,[64,94,71],{"class":70},[64,96,97],{"class":74}," UniPages ",[64,99,78],{"class":70},[64,101,82],{"class":81},[64,103,104],{"class":85},"@uni-helper\u002Fvite-plugin-uni-pages",[64,106,89],{"class":81},[64,108,110,112,115,118,121,124,126,129],{"class":66,"line":109},3,[64,111,71],{"class":70},[64,113,114],{"class":81}," {",[64,116,117],{"class":74}," defineConfig",[64,119,120],{"class":81}," }",[64,122,123],{"class":70}," from",[64,125,82],{"class":81},[64,127,128],{"class":85},"vite",[64,130,89],{"class":81},[64,132,134],{"class":66,"line":133},4,[64,135,136],{"emptyLinePlaceholder":6},"\n",[64,138,140,143,146,149,152],{"class":66,"line":139},5,[64,141,142],{"class":70},"export",[64,144,145],{"class":70}," default",[64,147,117],{"class":148},"s2Zo4",[64,150,151],{"class":74},"(",[64,153,154],{"class":81},"{\n",[64,156,158,162,165,168,171,174,177,180,183],{"class":66,"line":157},6,[64,159,161],{"class":160},"swJcz","  plugins",[64,163,164],{"class":81},":",[64,166,167],{"class":74}," [",[64,169,170],{"class":148},"UniPages",[64,172,173],{"class":74},"()",[64,175,176],{"class":81},",",[64,178,179],{"class":148}," Uni",[64,181,182],{"class":74},"()]",[64,184,185],{"class":81},",\n",[64,187,189,192],{"class":66,"line":188},7,[64,190,191],{"class":81},"}",[64,193,194],{"class":74},")\n",[21,196,197,198,201,202,31],{},"插件会扫描 ",[25,199,200],{},"src\u002Fpages","，把发现的页面写进 ",[25,203,204],{},"src\u002Fpages.json",[33,206,207],{"id":207},"类型支持",[21,209,210,213,214,217,218,221,222,225],{},[25,211,212],{},"definePage"," 宏与 ",[25,215,216],{},"defineUniPages"," 的类型需要加进 ",[25,219,220],{},"tsconfig.json"," 或 ",[25,223,224],{},"jsconfig.json","：",[227,228,229,291],"code-group",{},[54,230,234],{"className":231,"code":232,"filename":220,"language":233,"meta":60,"style":60},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"compilerOptions\": {\n    \"types\": [\"@uni-helper\u002Fvite-plugin-uni-pages\"]\n  }\n}\n","json",[25,235,236,240,257,281,286],{"__ignoreMap":60},[64,237,238],{"class":66,"line":67},[64,239,154],{"class":81},[64,241,242,245,249,252,254],{"class":66,"line":92},[64,243,244],{"class":81},"  \"",[64,246,248],{"class":247},"spNyl","compilerOptions",[64,250,251],{"class":81},"\"",[64,253,164],{"class":81},[64,255,256],{"class":81}," {\n",[64,258,259,262,266,268,270,272,274,276,278],{"class":66,"line":109},[64,260,261],{"class":81},"    \"",[64,263,265],{"class":264},"sBMFI","types",[64,267,251],{"class":81},[64,269,164],{"class":81},[64,271,167],{"class":81},[64,273,251],{"class":81},[64,275,104],{"class":85},[64,277,251],{"class":81},[64,279,280],{"class":81},"]\n",[64,282,283],{"class":66,"line":133},[64,284,285],{"class":81},"  }\n",[64,287,288],{"class":66,"line":139},[64,289,290],{"class":81},"}\n",[54,292,293],{"className":231,"code":232,"filename":224,"language":233,"meta":60,"style":60},[25,294,295,299,311,331,335],{"__ignoreMap":60},[64,296,297],{"class":66,"line":67},[64,298,154],{"class":81},[64,300,301,303,305,307,309],{"class":66,"line":92},[64,302,244],{"class":81},[64,304,248],{"class":247},[64,306,251],{"class":81},[64,308,164],{"class":81},[64,310,256],{"class":81},[64,312,313,315,317,319,321,323,325,327,329],{"class":66,"line":109},[64,314,261],{"class":81},[64,316,265],{"class":264},[64,318,251],{"class":81},[64,320,164],{"class":81},[64,322,167],{"class":81},[64,324,251],{"class":81},[64,326,104],{"class":85},[64,328,251],{"class":81},[64,330,280],{"class":81},[64,332,333],{"class":66,"line":133},[64,334,285],{"class":81},[64,336,337],{"class":66,"line":139},[64,338,290],{"class":81},[33,340,341],{"id":341},"全局配置",[21,343,344,345,348,349,356],{},"在 ",[25,346,347],{},"pages.config.(ts|mts|cts|js|cjs|mjs|json)"," 里定义全局配置。文件位置与文件名由 ",[350,351,353],"a",{"href":352},"\u002Fvite-plugin-uni-pages\u002Foption#configsource",[25,354,355],{},"configSource"," 控制。",[54,358,361],{"className":56,"code":359,"filename":360,"language":59,"meta":60,"style":60},"import { defineUniPages } from '@uni-helper\u002Fvite-plugin-uni-pages'\n\nexport default defineUniPages({\n  \u002F\u002F 也可以直接写 pages 字段，它的优先级最高\n  pages: [],\n  globalStyle: {\n    navigationBarTextStyle: 'black',\n    navigationBarTitleText: '@uni-helper',\n  },\n})\n","pages.config.ts",[25,362,363,382,386,398,404,416,425,442,459,465],{"__ignoreMap":60},[64,364,365,367,369,372,374,376,378,380],{"class":66,"line":67},[64,366,71],{"class":70},[64,368,114],{"class":81},[64,370,371],{"class":74}," defineUniPages",[64,373,120],{"class":81},[64,375,123],{"class":70},[64,377,82],{"class":81},[64,379,104],{"class":85},[64,381,89],{"class":81},[64,383,384],{"class":66,"line":92},[64,385,136],{"emptyLinePlaceholder":6},[64,387,388,390,392,394,396],{"class":66,"line":109},[64,389,142],{"class":70},[64,391,145],{"class":70},[64,393,371],{"class":148},[64,395,151],{"class":74},[64,397,154],{"class":81},[64,399,400],{"class":66,"line":133},[64,401,403],{"class":402},"sHwdD","  \u002F\u002F 也可以直接写 pages 字段，它的优先级最高\n",[64,405,406,409,411,414],{"class":66,"line":139},[64,407,408],{"class":160},"  pages",[64,410,164],{"class":81},[64,412,413],{"class":74}," []",[64,415,185],{"class":81},[64,417,418,421,423],{"class":66,"line":157},[64,419,420],{"class":160},"  globalStyle",[64,422,164],{"class":81},[64,424,256],{"class":81},[64,426,427,430,432,434,437,440],{"class":66,"line":188},[64,428,429],{"class":160},"    navigationBarTextStyle",[64,431,164],{"class":81},[64,433,82],{"class":81},[64,435,436],{"class":85},"black",[64,438,439],{"class":81},"'",[64,441,185],{"class":81},[64,443,445,448,450,452,455,457],{"class":66,"line":444},8,[64,446,447],{"class":160},"    navigationBarTitleText",[64,449,164],{"class":81},[64,451,82],{"class":81},[64,453,454],{"class":85},"@uni-helper",[64,456,439],{"class":81},[64,458,185],{"class":81},[64,460,462],{"class":66,"line":461},9,[64,463,464],{"class":81},"  },\n",[64,466,468,470],{"class":66,"line":467},10,[64,469,191],{"class":81},[64,471,194],{"class":74},[33,473,474],{"id":474},"页面配置",[21,476,477,478,480,481,31],{},"单个页面的配置写在页面文件的 ",[25,479,212],{}," 宏里，详见 ",[350,482,212],{"href":483},"\u002Fvite-plugin-uni-pages\u002Fdefinepage",[21,485,486,487,489],{},"不写 ",[25,488,212],{}," 时，路径仍按文件位置自动生成。",[33,491,492],{"id":492},"读取页面元数据",[21,494,495],{},"导入虚拟模块即可拿到所有页面的元数据：",[54,497,499],{"className":56,"code":498,"language":59,"meta":60,"style":60},"\u002F\u002F\u002F \u003Creference types=\"@uni-helper\u002Fvite-plugin-uni-pages\u002Fclient\" \u002F>\nimport { pages } from 'virtual:uni-pages'\n\nconsole.log(pages)\n",[25,500,501,531,551,555],{"__ignoreMap":60},[64,502,503,506,509,513,517,520,522,526,528],{"class":66,"line":67},[64,504,505],{"class":402},"\u002F\u002F\u002F ",[64,507,508],{"class":70},"\u003C",[64,510,512],{"class":511},"s5tWE","reference",[64,514,516],{"class":515},"s6hCs"," types",[64,518,519],{"class":70},"=",[64,521,251],{"class":70},[64,523,525],{"class":524},"smbvS","@uni-helper\u002Fvite-plugin-uni-pages\u002Fclient",[64,527,251],{"class":70},[64,529,530],{"class":70}," \u002F>\n",[64,532,533,535,537,540,542,544,546,549],{"class":66,"line":92},[64,534,71],{"class":70},[64,536,114],{"class":81},[64,538,539],{"class":74}," pages",[64,541,120],{"class":81},[64,543,123],{"class":70},[64,545,82],{"class":81},[64,547,548],{"class":85},"virtual:uni-pages",[64,550,89],{"class":81},[64,552,553],{"class":66,"line":109},[64,554,136],{"emptyLinePlaceholder":6},[64,556,557,560,563,566],{"class":66,"line":133},[64,558,559],{"class":74},"console",[64,561,562],{"class":81},".",[64,564,565],{"class":148},"log",[64,567,568],{"class":74},"(pages)\n",[33,570,571],{"id":571},"生成的文件",[573,574,575,588],"table",{},[576,577,578],"thead",{},[579,580,581,585],"tr",{},[582,583,584],"th",{},"文件",[582,586,587],{},"说明",[589,590,591,601],"tbody",{},[579,592,593,598],{},[594,595,596],"td",{},[25,597,204],{},[594,599,600],{},"生成的页面配置，不要手改",[579,602,603,608],{},[594,604,605],{},[25,606,607],{},"uni-pages.d.ts",[594,609,610,611,617],{},"页面路径的类型声明，由 ",[350,612,614],{"href":613},"\u002Fvite-plugin-uni-pages\u002Foption#dts",[25,615,616],{},"dts"," 控制",[21,619,620,622,623,356],{},[25,621,27],{}," 的生成格式由 ",[350,624,626,629,630,629,633,629,636],{"href":625},"\u002Fvite-plugin-uni-pages\u002Foption#%E7%94%9F%E6%88%90%E7%BB%93%E6%9E%9C",[25,627,628],{},"minify","、",[25,631,632],{},"indent",[25,634,635],{},"eol",[25,637,638],{},"insertFinalNewline",[33,640,641],{"id":641},"感谢",[643,644,645,654,661],"ul",{},[646,647,648],"li",{},[350,649,653],{"href":650,"rel":651},"https:\u002F\u002Fgithub.com\u002Fhannoeru\u002Fvite-plugin-pages",[652],"nofollow","hannoeru\u002Fvite-plugin-pages",[646,655,656],{},[350,657,660],{"href":658,"rel":659},"https:\u002F\u002Foiyo.js.org\u002F",[652],"skiyee\u002Foiyo",[646,662,663],{},[350,664,667],{"href":665,"rel":666},"https:\u002F\u002Fgithub.com\u002Funi-ku\u002Fpages-json",[652],"uni-ku\u002Fpages-json",[669,670,671],"style",{},"html pre.shiki code .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html pre.shiki code .s5tWE, html code.shiki .s5tWE{--shiki-light:#E53935;--shiki-light-font-style:italic;--shiki-default:#F07178;--shiki-default-font-style:italic;--shiki-dark:#F07178;--shiki-dark-font-style:italic}html pre.shiki code .s6hCs, html code.shiki .s6hCs{--shiki-light:#9C3EDA;--shiki-light-font-style:italic;--shiki-default:#C792EA;--shiki-default-font-style:italic;--shiki-dark:#C792EA;--shiki-dark-font-style:italic}html pre.shiki code .smbvS, html code.shiki .smbvS{--shiki-light:#91B859;--shiki-light-font-style:italic;--shiki-default:#C3E88D;--shiki-default-font-style:italic;--shiki-dark:#C3E88D;--shiki-dark-font-style:italic}",{"title":60,"searchDepth":92,"depth":92,"links":673},[674,675,676,677,678,679,680,681],{"id":35,"depth":92,"text":35},{"id":42,"depth":92,"text":42},{"id":207,"depth":92,"text":207},{"id":341,"depth":92,"text":341},{"id":474,"depth":92,"text":474},{"id":492,"depth":92,"text":492},{"id":571,"depth":92,"text":571},{"id":641,"depth":92,"text":641},false,"为 Vite 下的 uni-app 提供基于文件系统的路由","md","lucide:rocket",{},"\u002Fvite-plugin-uni-pages\u002Fguide",{"title":5,"description":683},"vite-plugin-uni-pages\u002F1.guide","tC_dlSDc20ACwezbgfKGIKqiKXZlK5Cp1ynJIm8AVrk",{"id":692,"title":693,"aside":6,"authors":7,"badges":7,"banner":7,"body":7,"breadcrumb":6,"collapse":682,"description":7,"editLink":6,"extension":694,"fullpage":682,"header":7,"icon":695,"main":7,"meta":696,"navBadges":7,"navTruncate":682,"navigation":697,"path":698,"prevNext":6,"seo":699,"stem":700,"toc":701,"__hash__":710},"content\u002Fvite-plugin-uni-pages\u002F_dir.yml","plugin-uni-pages","yml","lucide:file-scan",{"showTitle":682},{"redirect":687},"\u002Fvite-plugin-uni-pages\u002F_dir",{"title":693},"vite-plugin-uni-pages\u002F_dir",{"links":702},[703,706],{"title":704,"icon":705,"to":16,"target":12},"点亮星星","lucide:star",{"title":707,"icon":708,"to":709,"target":12},"反馈问题","lucide:github","https:\u002F\u002Fgithub.com\u002Funi-helper\u002Fvite-plugin-uni-pages\u002Fissues","ONgEU7Qcls4mfExF8v9RgvAiNNBCev_YLY4bMnIF6gE",1795081000938]