mes-ui-d2/docs/zh/guide/getting-started.md

快速上手

本文将会带领您从 0 开始使用 D2Admin 创建下面的页面：

前置知识

使用 D2Admin 首先组要有以下前置知识：

• 首先需要熟悉 web 开发基础三样：HTML CSS JavaScript
• 会使用 vue.js

如果您了解以下技术，在使用本项目进行您的开发时会更加得心应手：

• ES6
• sass

准备

在上手之前，建议您先大致浏览以下章节，对整个系统有大致了解：

• 每个页面最基础的构成部分：页面容器
• 一些会用到的全局数据和方法：VUEX 实用工具
• 一些会用到的公用方法：Util 实用工具

如果想了解更多 D2Admin 相关的教程和更新文章，可以参阅 文章

下载项目

• 完整版仓库 Github | 码云

• 简化版起始模板 Github | 码云

挑选一个您喜欢的网站 Fork 代码到您的仓库，然后下载或克隆。

::: tip 如果使用 Github 下载过慢，请参考 常见问题。 :::

我的建议是使用 简化版起始模板 因为在完整版的基础上做减法，要比在简化版基础上做加法复杂。

下面的步骤都以简化版起始模板为基础演示如何使用。

下载完成后您会得到这些资源（以 1.1.5 版本为例）：

安装环境

::: tip 如果您以前运行过 webpack 项目，并且本机 node 版本为 8，可以忽略这一步。 :::

node

在 node.js 官网 下载合适您系统的 node.js。

安装完毕后检查版本（最好使用 node 8 版本）。

node -v
v8.11.1
npm -v
5.6.0

nrm or cnpm

由于网络原因，npm 在国内使用比较慢，建议切换 npm 源到国内镜像。

有两种比较方便的方式切换您的 npm 源：

1. nrm [ 建议 ]

安装：

npm install -g nrm

查看所有可用源：

nrm ls
* npm -----  https://registry.npmjs.org/
  cnpm ----  http://r.cnpmjs.org/
  taobao --  https://registry.npm.taobao.org/
  nj ------  https://registry.nodejitsu.com/
  rednpm -- http://registry.mirror.cqupt.edu.cn
  skimdb -- https://skimdb.npmjs.com/registry

切换源：

nrm use taobao

2. cnpm

安装：

npm install -g cnpm --registry=https://registry.npm.taobao.org

安装依赖

将终端切换到项目目录之后安装依赖：

npm i

如果遇到问题比如 node-sass 安装不上，请参考 常见问题。

开发调试

在项目目录内启动项目：

npm run dev

或者使用：

npm start

也可以使用 cli3 新推荐的命令：

npm run serve

以上每种方式效果都是一样的，只是为了照顾不同人的习惯起了三个名字，实质上都是运行了 vue-cli-service serve --open。

成功运行后会显示登陆界面：

新建页面

src/pages 目录是页面存放目录，在此目录下新建目录，例如 page-demo：

然后在文件夹内新建 index.vue 文件：

<template>
  <d2-container>
    <template slot="header">header</template>
    Hello World
    <template slot="footer">footer</template>
  </d2-container>
</template>

上面的代码生成了一个带有 header 和 footer 的页面，页面内容只有一句话，如果您好奇为什么这么写，可以参考 页面容器

设置路由

src/router/routes.js 是路由配置文件。

在 frameIn 变量最后添加：

{
  path: '/page-demo',
  name: 'page-demo',
  component: () => import('@/pages/page-demo'),
  meta: { meta, title: '新建示例' }
}

最后 frameIn 变量应该是这样：

const frameIn = [
  {
    path: '/',
    redirect: { name: 'index' },
    component: layoutHeaderAside,
    children: [
      {
        path: 'index',
        name: 'index',
        meta,
        component: () => import('@/pages/index')
      },
      // ...
      {
        path: '/page3',
        name: 'page3',
        component: () => import('@/pages/page3'),
        meta: { meta, title: '页面 3' }
      },
      {
        path: '/page-demo',
        name: 'page-demo',
        component: () => import('@/pages/page-demo'),
        meta: { meta, title: '新建示例' }
      }
    ]
  }
]

设置菜单

src/menu 目录是菜单存放目录，里面的两个文件分别存放顶栏和侧边栏的菜单。

::: tip D2Admin 现在将顶栏和侧边栏菜单分别存放然后赋值的逻辑只是一个最简单的演示，请根据您的需要自己修改菜变化逻辑，您可以只用一行代码就可以动态更新菜单，方法见 VUEX 实用工具。 :::

打开 src/menu/header.js 添加新的菜单（高亮行）：

export default [
  { path: '/index', title: '首页', icon: 'home' },
  {
    title: '页面',
    icon: 'folder-o',
    children: [
      { path: '/page1', title: '页面 1' },
      { path: '/page2', title: '页面 2' },
      { path: '/page3', title: '页面 3' },
      { path: '/page-demo', title: '新建示例' }
    ]
  }
]

打开 src/menu/aside.js 添加新的菜单（高亮行）：

export default [
  { path: '/index', title: '首页', icon: 'home' },
  {
    title: '页面',
    icon: 'folder-o',
    children: [
      { path: '/page1', title: '页面 1' },
      { path: '/page2', title: '页面 2' },
      { path: '/page3', title: '页面 3' },
      { path: '/page-demo', title: '新建示例' }
    ]
  }
]

效果

经过上述步骤您得到了一个具有顶栏和底栏的页面，这个页面的入口在顶栏菜单和侧边栏菜单都会显示，并且打开此页面时浏览器 title 也会做出相应更新。

上述教程只是介绍了 D2Admin 的冰山一角，更多的配置项和组件文档请查阅本文档其它板块。

如果您有疑问，请加 QQ 群 806395827 反馈。

资源

下面是一些在开发过程会用到的文档，列举在这里方便大家快速查看：

组件库：

• element-ui

项目基础：

名称	介绍
vue.js	框架基础
vuex	全局状态管理
vue-router	路由控制
sass	CSS 预处理语言

脚手架：

名称	介绍
vue-cli3	项目脚手架
webpack-chain	vue-cli3 中 webpack 的配置语法

插件：

名称	介绍
axios	最流行的网络请求库
better-scroll	d2-container 的自定义滚动条依赖
dayjs	日期处理库
v-charts	vue 版本的 echarts 由饿了么开发
echarts	v-charts 的核心
lowdb	D2Admin 操作本地数据的依赖
mockjs	模拟请求依赖
vue-i18n	多国语依赖
vue-grid-layout	网格布局组件
vue-splitpane	切分布局组件

上面只是一些猜您会用到的链接，还有一些项目中用到但是这里没有列举的，如果您觉得有必要，可以提 pr 修改本篇文档。