公司项目的面包屑导航是使用 element 的面包屑组件,配合一份 json 配置文件来实现的,每次写新页面都需要去写 json 配置,非常麻烦,所以写一个面包屑cli,自动生成页面、自动配置面包屑数据,提高效率:rocket:
明确目标
- 提供 init 命令,在一个新项目中能够通过初始化生成面包屑相关文件
- 能够通过命令生成页面,并且自动配置面包屑 json 数据
- 按照项目原有需求,能够配置面包屑是否可点击跳转
- 按照项目原有需求,能够配置某路径下是否展示面包屑
- 支持仅配置而不生成文件,能够为已存在的页面生成配置
- 能够动态配置当前面包屑导航的数据
- …… (后续在使用中发现问题并优化)
实现分成两部分
- 面包屑实现
- cli 命令实现
面包屑实现
- 在路由前置守卫 beforEach 中根据当前路径在配置文件中匹配到相应的数据
- 把这些配置存到 vuex
- 在面包屑组件中根据 vuex 中的数据 v-for 循环渲染出面包屑
JSON 配置文件
json 配置文件是通过命令生成的,一个配置对象包含 name path clickable isShow 属性
[ { "name": "应用", // 面包屑名称(在命令交互中输入) "path": "/app", // 面包屑对应路径(根据文件自动生成) "clickable": true, // 是否可点击跳转 "isShow": true // 是否显示 }, { "name": "应用详情", "path": "/app/detail", "clickable": true, // 是否可点击跳转 "isShow": true // 是否显示 } ]
匹配配置文件中的数据
比如按照上面的配置文件,进入 /app/detail 时,将会匹配到如下数据
[ { "name": "应用", "path": "/app", "clickable": true, "isShow": true }, { "name": "应用", "path": "/app/detail", "clickable": true, "isShow": true } ]
动态面包屑实现
有时候需要动态修改面包屑数据(比如动态路由),由于数据是存在 vuex 中的,所以修改起来非常方便,只需在 vuex 相关文件中提供 mutation 即可,这些 mutation 在数据中寻找相应的项,并改掉
export const state = () => ({ breadcrumbData: [] }) export const mutations = { setBreadcrumb (state, breadcrumbData) { state.breadcrumbData = breadcrumbData }, setBreadcrumbByName (state, {oldName, newName}) { let curBreadcrumb = state.breadcrumbData.find(breadcrumb => breadcrumb.name === oldName) curBreadcrumb && (curBreadcrumb.name = newName) }, setBreadcrumbByPath (state, {path, name}) { let curBreadcrumb = state.breadcrumbData.find( breadcrumb => breadcrumb.path === path ) curBreadcrumb && (curBreadcrumb.name = name) } }
根据路径匹配相应配置数据具体代码
import breadcrumbs from '@/components/breadcrumb/breadcrumb.config.json' function path2Arr(path) { return path.split('/').filter(p => p) } function matchBreadcrumbData (matchPath) { return path2Arr(matchPath) .map(path => { path = path.replace(/^:([^:"htmlcode"><template> <div class="bcg-breadcrumb" v-if="isBreadcrumbShow"> <el-breadcrumb separator="/"> <el-breadcrumb-item v-for="(item, index) in breadcrumbData" :to="item.clickable " :key="index"> {{ item.name }} </el-breadcrumb-item> </el-breadcrumb> </div> </template> <script> import breadcrumbs from "./breadcrumb.config" export default { name: 'Breadcrumb', computed: { isBreadcrumbShow () { return this.curBreadcrumb && this.curBreadcrumb.isShow }, breadcrumbData () { return this.$store.state.breadcrumb.breadcrumbData }, curBreadcrumb () { return this.breadcrumbData[this.breadcrumbData.length - 1] } } } </script>cli命令实现
cli命令开发用到的相关库如下:这些就不细说了,基本上看下 README 就知道怎么用了
- commander :命令行工具
- boxen :在终端画一个框
- inquirer :命令行交互工具
- handlebar:模版引擎
目录结构
lib // 存命令行文件 |-- bcg.js template // 存模版 |-- breadcrumb // 面包屑配置文件与组件,将生成在项目 @/components 中 |-- breadcrumb.config.json |-- index.vue |-- braadcrumb.js // vuex 相关文件,将生成在项目 @/store 中 |-- new-page.vue // 新文件模版,将生成在命令行输入的新路径中 |-- route.js // 路由前置守卫配置文件,将生成在 @/plugins 中 test // 单元测试相关文件
node 支持命令行,只需在 package.json 的 bin 字段中关联命令行执行文件
// 执行 bcg 命令时,就会执行 lib/bcg.js 的代码 { "bin": { "bcg": "lib/bcg.js" } }
实现命令
实现一个 init 命令,生成相关面包屑文件(面包屑组件、 json配置文件、 前置守卫plugin、 面包屑store)
bcg init
实现一个 new 命令生成文件,默认基础路径是 src/pages ,带一个 -b 选项,可用来修改基础路径
bcg new <file-path> -b <base-path>
具体代码如下
#!/usr/bin/env node const path = require('path') const fs = require('fs-extra') const boxen = require('boxen') const inquirer = require('inquirer') const commander = require('commander') const Handlebars = require('handlebars') const { createPathArr, log, errorLog, successLog, infoLog, copyFile } = require('./utils') const VUE_SUFFIX = '.vue' const source = { VUE_PAGE_PATH: path.resolve(__dirname, '../template/new-page.vue'), BREADCRUMB_COMPONENT_PATH: path.resolve(__dirname, '../template/breadcrumb'), PLUGIN_PATH: path.resolve(__dirname, '../template/route.js'), STORE_PATH: path.resolve(__dirname, '../template/breadcrumb.js') } const target = { BREADCRUMB_COMPONENT_PATH: 'src/components/breadcrumb', BREADCRUMB_JSON_PATH: 'src/components/breadcrumb/breadcrumb.config.json', PLUGIN_PATH: 'src/plugins/route.js', STORE_PATH: 'src/store/breadcrumb.js' } function initBreadCrumbs() { try { copyFile(source.BREADCRUMB_COMPONENT_PATH, target.BREADCRUMB_COMPONENT_PATH) copyFile(source.PLUGIN_PATH, target.PLUGIN_PATH) copyFile(source.STORE_PATH, target.STORE_PATH) } catch (err) { throw err } } function generateVueFile(newPagePath) { try { if (fs.existsSync(newPagePath)) { log(errorLog(`${newPagePath} 已存在`)) return } const fileName = path.basename(newPagePath).replace(VUE_SUFFIX, '') const vuePage = fs.readFileSync(source.VUE_PAGE_PATH, 'utf8') const template = Handlebars.compile(vuePage) const result = template({ filename: fileName }) fs.outputFileSync(newPagePath, result) log(successLog('\nvue页面生成成功咯\n')) } catch (err) { throw err } } function updateConfiguration(filePath, { clickable, isShow } = {}) { try { if (!fs.existsSync(target.BREADCRUMB_JSON_PATH)) { log(errorLog('面包屑配置文件不存在, 配置失败咯, 可通过 bcg init 生成相关文件')) return } let pathArr = createPathArr(filePath) const configurationArr = fs.readJsonSync(target.BREADCRUMB_JSON_PATH) // 如果已经有配置就过滤掉 pathArr = pathArr.filter(pathItem => !configurationArr.some(configurationItem => configurationItem.path === pathItem)) const questions = pathArr.map(pathItem => { return { type: 'input', name: pathItem, message: `请输入 ${pathItem} 的面包屑显示名称`, default: pathItem } }) inquirer.prompt(questions).then(answers => { const pathArrLastIdx = pathArr.length - 1 pathArr.forEach((pathItem, index) => { configurationArr.push({ clickable: index === pathArrLastIdx "color: #ff0000">发布 npm
开发完成后,发布到 npm,具体方法就不细说了,发布后全局安装就能愉快的使用咯!
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持。
免责声明:本站资源来自互联网收集,仅供用于学习和交流,请遵循相关法律法规,本站一切资源不代表本站立场,如有侵权、后门、不妥请联系本站删除!
《魔兽世界》大逃杀!60人新游玩模式《强袭风暴》3月21日上线
暴雪近日发布了《魔兽世界》10.2.6 更新内容,新游玩模式《强袭风暴》即将于3月21 日在亚服上线,届时玩家将前往阿拉希高地展开一场 60 人大逃杀对战。
艾泽拉斯的冒险者已经征服了艾泽拉斯的大地及遥远的彼岸。他们在对抗世界上最致命的敌人时展现出过人的手腕,并且成功阻止终结宇宙等级的威胁。当他们在为即将于《魔兽世界》资料片《地心之战》中来袭的萨拉塔斯势力做战斗准备时,他们还需要在熟悉的阿拉希高地面对一个全新的敌人──那就是彼此。在《巨龙崛起》10.2.6 更新的《强袭风暴》中,玩家将会进入一个全新的海盗主题大逃杀式限时活动,其中包含极高的风险和史诗级的奖励。
《强袭风暴》不是普通的战场,作为一个独立于主游戏之外的活动,玩家可以用大逃杀的风格来体验《魔兽世界》,不分职业、不分装备(除了你在赛局中捡到的),光是技巧和战略的强弱之分就能决定出谁才是能坚持到最后的赢家。本次活动将会开放单人和双人模式,玩家在加入海盗主题的预赛大厅区域前,可以从强袭风暴角色画面新增好友。游玩游戏将可以累计名望轨迹,《巨龙崛起》和《魔兽世界:巫妖王之怒 经典版》的玩家都可以获得奖励。
更新日志
- 凤飞飞《我们的主题曲》飞跃制作[正版原抓WAV+CUE]
- 刘嘉亮《亮情歌2》[WAV+CUE][1G]
- 红馆40·谭咏麟《歌者恋歌浓情30年演唱会》3CD[低速原抓WAV+CUE][1.8G]
- 刘纬武《睡眠宝宝竖琴童谣 吉卜力工作室 白噪音安抚》[320K/MP3][193.25MB]
- 【轻音乐】曼托凡尼乐团《精选辑》2CD.1998[FLAC+CUE整轨]
- 邝美云《心中有爱》1989年香港DMIJP版1MTO东芝首版[WAV+CUE]
- 群星《情叹-发烧女声DSD》天籁女声发烧碟[WAV+CUE]
- 刘纬武《睡眠宝宝竖琴童谣 吉卜力工作室 白噪音安抚》[FLAC/分轨][748.03MB]
- 理想混蛋《Origin Sessions》[320K/MP3][37.47MB]
- 公馆青少年《我其实一点都不酷》[320K/MP3][78.78MB]
- 群星《情叹-发烧男声DSD》最值得珍藏的完美男声[WAV+CUE]
- 群星《国韵飘香·贵妃醉酒HQCD黑胶王》2CD[WAV]
- 卫兰《DAUGHTER》【低速原抓WAV+CUE】
- 公馆青少年《我其实一点都不酷》[FLAC/分轨][398.22MB]
- ZWEI《迟暮的花 (Explicit)》[320K/MP3][57.16MB]