如何获取vue单文件自身源码路径


Posted in Javascript onMay 06, 2019

这个问题要从一个想法说起。

D2Admin 是一个开源的,前端中后台集成方案,原先是基于 vue-cli2,大概是向 vue-cli3 过渡时,
作者老李,想在页面右下角加个 Toggle 点击,跳到当前页面源码对应的 github 页面。

确实很实用的功能,D2Admin 的 Demo 页面太多了,想看某个页面的源码,对于不熟悉项目目录结构的新手很不友好。
这些页面统一为 .vue 组件,那么转换一下:如何获取 vue 单文件自身源码路径?

目前经历了三个方案,最终目标是把自身路径赋值到 this.$options.__source 上。目前方案 3 是最新的。

方案 1 :node + __filename

直接使用 node 中的 __filename 变量:

<template>
 <h1>{{ $options.__source }}</h1>
</template>

<script>
export default {
 mounted() {
  this.$options.__source = __filename
 }
}
</script>

因为 webpack 编译时,会把源码文件在内部转为 node 模块,.vue 文件中的 script 内容也被转换了,
其中的 __filename 在编译时被运行,直接得到当前文件自身路径。

使用这个变量还需要在 webpack 配置中启用 node.__filename:

/* vue.config.js */
module.exports = {
 // ...
 chainWebpack: config => {
  // ...
  config.node
   .set('__dirname', true) // 同理
   .set('__filename', true)
 }
};

缺点

  1. 要在每个组件里手动赋值,还不能用 mixin
  2. __filename 得到的路径在部分 .vue 文件下并不准确,路径可能还会带附带 querystring

一开始,坚强的老李用这个方式,给上百个组件手动挂上了路径,但总比手动写死每个路径要好

方案 2 :vue-loader + exposeFilename

在 loader 层面,其实 vue-loader 提供了一个 exposeFilename 选项,只要启用,
就会给每个 .vue 组件带上 this.$options.__file,上面有准确的路径。
这样只需要改 loader 配置:

/* vue.config.js */
module.exports = {
 // ...
 chainWebpack: config => {
  // ...
  config.module
   .rule('vue')
   .use('vue-loader')
    .loader('vue-loader')
    .tap(options => {
     options.exposeFilename = true
     return options
    })
 }
};

开发环境默认是开启 exposeFilename 的。

此时组件内应该直接取 this.$options.__file,内容大致为 src/foo/bar.vue。

缺点

为了安全,vue-loader 在生产环境将 __file 赋值为文件名,非路径名,详见文档

后来得知这个方法,老李就第一时间改代码,删了方案 1 中的所有附加代码,结果发现生产环境结果不一致,翻车了orz

方案 3 :loader + Custom Block

既然方案 2 不让在生产环境用,那就自己写 loader 去加上这个源码路径,这里采用了Custom Block。

这个方法是慢慢调试自定义的 loader 摸索出来的,先在 vue-loader 之前加自定义的 loader A,

去注入 Custom Block 代码,再在全局加入一个针对该 Custom Block 的 loader B。

这里将方案封装,在 chainWebpack 中调用即可:

/* vue.config.js */
const VueFilenameInjector = require('./path/to/vue-filename-injector')

module.exports = {
 chainWebpack: config => {
  VueFilenameInjector(config, {
   propName: '__source' // default
  })
 }
}

源码参考:@d2-projects/d2-advance/tools/vue-filename-injector

.
└── vue-filename-injector
  ├── README.md
  ├── index.js
  └── src
    ├── index.js
    └── lib
      ├── config.js
      ├── injector.js
      └── loader.js

vue-filename-injector/index.js:

const { blockName } = require('./lib/config.js')

// for chainWebpack
module.exports = function(config, options) {
 // 注入
 config.module
  .rule('vue')
  .use('vue-filename-injector')
  .loader(require.resolve('./lib/injector.js'))
  .options(options)
  .after('vue-loader') // 不知为何 .before() 不是预期的结果,这里就绕了一下
  .end()
 // 解析
 config.module
  .rule('')
  .resourceQuery(new RegExp(`blockType=${blockName}`))
  .use('vue-filename-injector-loader')
  .loader(require.resolve('./lib/loader.js'))
  .end()
}

vue-filename-injector/lib/config.js:

const defaultPropName = '__source'
const blockName = 'vue-filename-injector'

module.exports = {
 defaultPropName,
 blockName
}

vue-filename-injector/lib/injector.js,源码部分来自 vue-loader:

const path = require('path')
const loaderUtils = require('loader-utils')

const { blockName, defaultPropName } = require('./config.js')

module.exports = function (content /*, map, meta */) {
 const loaderContext = this

 const {
  rootContext,
  resourcePath
 } = loaderContext

 const context = rootContext || process.cwd()
 const options = loaderUtils.getOptions(loaderContext) || {}
 const rawShortFilePath = path
  .relative(context, resourcePath)
  .replace(/^(\.\.[\/\\])+/, '')

 const propName = options.propName || defaultPropName

 content += `
<${blockName}>
export default function (Component) {
 Component.options.${propName} = ${JSON.stringify(rawShortFilePath.replace(/\\/g, '/'))}
}
</${blockName}>
`
 return content
}

vue-filename-injector/lib/loader.js:

module.exports = function(source, map) {
 this.callback(null, source, map)
}

相关仓库

可进入预览页面查看效果,在右下角有 Toggle

github.com/d2-projects… (可能还在翻车中)

github.com/d2-projects…

总结

目前看来,用自定义 loader 去注入代码是最便捷的方案,不用在每个组件中手写重复的代码。

由于 vue-cli3 采用 chainWebpack,加上个人对 webpack 的理解更是不深,暂时采用方案 3。

以上所述是小编给大家介绍的如何获取vue单文件自身源码路径详解整合,希望对大家有所帮助,如果大家有任何疑问请给我留言,小编会及时回复大家的。在此也非常感谢大家对三水点靠木网站的支持!

Javascript 相关文章推荐
比较全面的event对像在IE与FF中的区别 推荐
Sep 21 Javascript
javascrip关于继承的小例子
May 10 Javascript
jQuery Ajax异步处理Json数据详解
Nov 05 Javascript
IE8中使用javascript动态加载CSS的解决方法
Jun 17 Javascript
举例讲解JavaScript substring()的使用方法
Nov 09 Javascript
理解 JavaScript Scoping &amp; Hoisting(二)
Nov 18 Javascript
AngularJS  双向数据绑定详解简单实例
Oct 20 Javascript
Javascript中的神器——Promise
Feb 08 Javascript
js中apply与call简单用法详解
Nov 06 Javascript
微信小程序实现YDUI的ScrollTab组件
Feb 02 Javascript
使用 vue 实例更好的监听事件及vue实例的方法
Apr 22 Javascript
vue-froala-wysiwyg 富文本编辑器功能
Sep 19 Javascript
详解vue-cli中使用rem,vue自适应
May 06 #Javascript
用Vue编写抽象组件的方法
May 06 #Javascript
JS解惑之Object中的key是有序的么
May 06 #Javascript
微信小程序和百度的语音识别接口详解
May 06 #Javascript
微信小程序生成海报分享朋友圈的实现方法
May 06 #Javascript
vue项目打包后上传至GitHub并实现github-pages的预览
May 06 #Javascript
Vue实现购物车的全选、单选、显示商品价格代码实例
May 06 #Javascript
You might like
星际争霸任务指南——神族
2020/03/04 星际争霸
PHP中str_replace函数使用小结
2008/10/11 PHP
PHP 常用数组内部函数(Array Functions)介绍
2013/06/05 PHP
php实现的CSS更新类实例
2014/09/22 PHP
使用URL传输SESSION信息
2015/07/14 PHP
PHP批斗大会之缺失的异常详解
2019/07/09 PHP
TNC vs BOOM BO3 第三场2.13
2021/03/10 DOTA
js 模拟实现类似c#下的hashtable的简单功能代码
2010/01/24 Javascript
js null undefined 空区别说明
2010/06/13 Javascript
jquery 元素相对定位代码
2010/10/15 Javascript
Jquery时间验证和转换工具小例子
2013/07/01 Javascript
js采用map取到id集合组并且实现点击一行选中一行
2013/12/16 Javascript
js 限制input只能输入数字、字母和汉字等等
2013/12/18 Javascript
JavaScript中数组成员的添加、删除介绍
2014/12/30 Javascript
JavaScript实现带缓冲效果的随屏滚动漂浮广告代码
2015/11/06 Javascript
jQuery实现将div中滚动条滚动到指定位置的方法
2016/08/10 Javascript
AngularJS ng-style中使用filter
2016/09/21 Javascript
原生js实现中奖信息无间隙滚动效果
2017/01/18 Javascript
利用n工具轻松管理Node.js的版本
2017/04/21 Javascript
vue-cli webpack 开发环境跨域详解
2017/05/18 Javascript
Vue 使用中的小技巧
2018/04/26 Javascript
js 数组详细操作方法及解析合集
2018/06/01 Javascript
jquery中attr、prop、data区别与用法分析
2019/09/25 jQuery
react国际化化插件react-i18n-auto使用详解
2020/03/31 Javascript
VueJS实现用户管理系统
2020/05/29 Javascript
Python中标准库OS的常用方法总结大全
2017/07/19 Python
python excel转换csv代码实例
2019/08/26 Python
Django Channel实时推送与聊天的示例代码
2020/04/30 Python
python爬虫看看虎牙女主播中谁最“顶”步骤详解
2020/12/01 Python
致长跑运动员加油稿
2014/02/20 职场文书
投资协议书范本
2014/04/21 职场文书
个人安全生产责任书
2014/07/28 职场文书
怎么写工作检讨书
2014/11/16 职场文书
傲慢与偏见电影观后感
2015/06/10 职场文书
婚礼嘉宾致辞
2015/07/28 职场文书
详解vue中v-for的key唯一性
2021/05/15 Vue.js