多应用+插件架构,代码干净,二开方便,首家独创一键云编译技术,文档视频完善,免费商用码云13.8K 广告
# 新增页面 如果熟悉`vue-router`的配置就很简单了。 首先在`@/router/index.js`中增加你需要添加的路由。 **如:新增一个 excel 页面** ~~~ { path: '/excel', component: Layout, redirect: '/excel/export-excel', name: 'excel', meta: { title: 'excel', icon: 'excel' } } ~~~ TIP 仅仅这样不会有任何效果的,它只是创建了一个基于`layout`的一级路由,你还需要在它下面的`children`中添加子路由。 ~~~ { path: '/excel', component: Layout, redirect: '/excel/export-excel', name: 'excel', meta: { title: 'excel', icon: 'excel' }, children: [ { path: 'export-excel', component: ()=>import('excel/exportExcel'), name: 'exportExcel', meta: { title: 'exportExcel' } } ] } ~~~ **这样侧边栏就会出现如图所示的`menu-item`了** ![](https://gitee.com/panjiachen/gitee-cdn/raw/master/vue-element-admin-site/2ab6921d-f9bb-4fbb-a151-0e6027e23a6e.png) TIP 由于`children`下面只声明了一个路由所以不会有展开箭头,如果`children`下面的路由个数大于 1 就会有展开箭头,如下面所示。 如果你想忽视这个自动判断可以使用`alwaysShow: true`,这样它就会忽略之前定义的规则,一直显示根路由。详情见[路由和侧边栏](https://panjiachen.github.io/vue-element-admin-site/zh/guide/essentials/router-and-nav.html#%E8%B7%AF%E7%94%B1%E5%92%8C%E4%BE%A7%E8%BE%B9%E6%A0%8F) ~~~ { path: '/excel', component: Layout, redirect: '/excel/export-excel', name: 'excel', meta: { title: 'excel', icon: 'excel' }, children: [ { path: 'export-excel', component: ()=>import('excel/exportExcel'), name: 'exportExcel', meta: { title: 'exportExcel' }}, { path: 'export-selected-excel', component: ()=>import('excel/selectExcel'), name: 'selectExcel', meta: { title: 'selectExcel' }}, { path: 'upload-excel', component: ()=>import('excel/uploadExcel'), name: 'uploadExcel', meta: { title: 'uploadExcel' }} ] } ~~~ ![](https://gitee.com/panjiachen/gitee-cdn/raw/master/vue-element-admin-site/89d6a0b8-5cf7-4a19-9afd-7267ec454066.png) **侧边栏就会出现如图所示的`submenu`了** ## [#](https://panjiachen.github.io/vue-element-admin-site/zh/guide/essentials/new-page.html#%E5%A4%9A%E7%BA%A7%E7%9B%AE%E5%BD%95-%E5%B5%8C%E5%A5%97%E8%B7%AF%E7%94%B1)多级目录(嵌套路由) 如果你的路由是多级目录,如本项目[@/views/nested](https://github.com/PanJiaChen/vue-element-admin/tree/master/src/views/nested)那样, 有三级路由嵌套的情况下,**不要忘记还要手动在二级目录的根文件下添加一个`<router-view>`**。 ~~~ <!-- 父级路由组件 --> <template> <div> <!-- xxx html 内容 --> <router-view /> </div> </template> ~~~ 如:[@/views/nested/menu1/index.vue](https://github.com/PanJiaChen/vue-element-admin/blob/master/src/views/nested/menu1/index.vue),原则上有多少级路由嵌套就需要多少个`<router-view>`。 ![](https://gitee.com/panjiachen/gitee-cdn/raw/master/vue-element-admin-site/9459de62-64d0-4819-9730-daf3f9889018.png) ## [#](https://panjiachen.github.io/vue-element-admin-site/zh/guide/essentials/new-page.html#%E6%96%B0%E5%A2%9E-view)新增 view 新增完路由之后不要忘记在`@/views`文件下 创建对应的文件夹,一般一个路由对应一个文件,该模块下的功能组件或者方法就建议在本文件夹下创建一个`utils`或`components`文件夹,各个功能模块维护自己的`utils`或`components`组件。如: ![](https://gitee.com/panjiachen/gitee-cdn/raw/master/vue-element-admin-site/8ca55a30-c22c-4143-aa8d-2a0d3e04fc33.png) ## [#](https://panjiachen.github.io/vue-element-admin-site/zh/guide/essentials/new-page.html#%E6%96%B0%E5%A2%9E-api)新增 api 最后在[@/api](https://github.com/PanJiaChen/vue-element-admin/tree/master/src/api)文件夹下创建本模块对应的 api 服务。 ## [#](https://panjiachen.github.io/vue-element-admin-site/zh/guide/essentials/new-page.html#%E6%96%B0%E5%A2%9E%E7%BB%84%E4%BB%B6)新增组件 个人写 vue 项目的习惯,在全局的`@/components`只会写一些全局的组件,如富文本,各种搜索组件,封装的日期组件等等能被公用的组件。每个页面或者模块特定的业务组件则会写在当前 views 下面。如:`@/views/article/components/xxx.vue`。这样拆分大大减轻了维护成本。 **请记住拆分组件最大的好处不是公用而是可维护性!** ## [#](https://panjiachen.github.io/vue-element-admin-site/zh/guide/essentials/new-page.html#%E6%96%B0%E5%A2%9E%E6%A0%B7%E5%BC%8F)新增样式 页面的样式和组件是一个道理,全局的`@/style`放置一下全局公用的样式,每一个页面的样式就写在当前`views`下面,请记住加上`scoped`或者命名空间,避免造成全局的样式污染。 ~~~ <style> /* global styles */ </style> <style scoped> /* local styles */ .xxx-container{ /* name scoped */ xxx } </style> ~~~ [在 GitHub 上编辑此页](https://github.com/PanJiaChen/vue-element-admin-site/edit/master/docs/zh/guide/essentials/new-page.md)