腾讯开源组件库tdesign-vue:新增组件时是如何初始化的

简介: 组件库在添加一个组件的时候,可能会涉及到很多初始化的问题,比如要添加组件库入口文件、组件的说明文档文件、demo例子的入口文件,单元测试的入口文件等等

image.png


组件库在添加一个组件的时候,可能会涉及到很多初始化的问题,比如要添加组件库入口文件、组件的说明文档文件、demo例子的入口文件,单元测试的入口文件等等


那么通过本文可以了解到一个命令来处理这些文件的初始化,省去了很多的手动处理


  • 1、克隆代码
  • 2、查看package.json文件
  • 3、运行命令
  • 4、调试命令
  • 5、调试npm run init aehyok 命令
  • 6、可自行调试npm run init aehyok del
  • 7、总结


1、克隆代码


git@github.com:Tencent/tdesign-vue.git


2、查看根目录下的package.json


  • scripts脚本命令很多
  • dependencies依赖不少
  • devDependencies 依赖巨多
  • 东西太多我们今天重点就来学习一下其中的init命令,实际执行的命令为node script/init


3、运行命令(新增开发组件时初始化的文件)


3.1.安装依赖


npm i


3.2.本地运行


npm run init aehyok


运行结束后可以发现项目中多了一些文件,截图如下


image.png


这就是新增一个开发组件时,可以通过命令的方式,一键将各个文件进行初始化,这样其实节省了很多新建文件的重复工作,以及防止某些文件的遗漏,不得不说碉堡了。那接下来我们看看具体的逻辑是什么样的


4、调试命令


在vscode中通过使用快捷键:Ctrl + Shift + P,出现以下截图


image.png


Auto Attach 也就是第一个Debug: 奇幻开关自动附加,然后鼠标点击或者通过Enter选中,选中后效果如截图


image.png


选中智能即可。


接着我们打开终端命令行在命令行中输入npm run init aehyok,同时我们找到script/init/index.js文件,在文件末尾的init()位置打上断点。


image.png


看到如上所示截图,说明我们的调式命名成功了。


5、调试npm run init aehyok命令


5.1、init()算是index.js入口函数


const [component, isDeleted] = process.argv.slice(2);


image.png


process.argv读取命令行的参数 第一个索引为0的是Nodejs的路径 第二个索引为1的是当前js文件的所在路径 第三个也就是索引为2之后的才是我们命令行中自己定义的 通过定义两个变量 componentisDeleted,获取process.argv的第三和第四个参数


5.2、获取参数后进行判断


if (!component) {
    console.error('[组件名]必填 - Please enter new component name');
    process.exit(1);
}


如果变量component为空,则进行提示错误,并退出命令行的执行


5.3、获取路径


const cwdPath = process.cwd();
const indexPath = path.resolve(cwdPath, 'src/index.ts');


通过process.cwd()获取当前项目的工作目录(相当于根目录) 然后通过path.resolve拼接src下index.ts的完整路径


5.4、获取将要添加的文件模板对象


const config = require('./config');
const toBeCreatedFiles = config.getToBeCreatedFiles(component);


与index.js同目录下另外一个文件config.js,是一个目录为key,将要添加的文件列表为值的一个数组,其中 files属性则是要添加的文件。 通过传入一个组件名称,生成的对象如下图所示


image.png


5.5、判断是添加还是删除


if (isDeleted === 'del') {
    deleteComponent(toBeCreatedFiles, component);
    deleteComponentFromIndex(component, indexPath);
  } else {
    addComponent(toBeCreatedFiles, component);
    insertComponentToIndex(component, indexPath);
  }


通过isDeleted来判断,这里我们的命令行参数中并未传值,所以下一步开始执行添加和插入的操作


5.6、addComponent添加组件


我们重点来看一下addComponent函数,先是通过Object.keys来循环上图中的keys值。


function addComponent(toBeCreatedFiles, component) {
  // At first, we need to create directories for components.
  // 循环上图中五个路径的数组对象
  Object.keys(toBeCreatedFiles).forEach((dir) => {
    // 拼接路径
    const _d = path.resolve(cwdPath, dir);
    // 根据拼接路径,如果不存在,先创建路径文件夹
    fs.mkdir(_d, { recursive: true }, (err) => {
      if (err) {
        utils.log(err, 'error');
        return;
      }
      console.log(`${_d} directory has been created successfully!`);
      // Then, we create files for components.
      // 从路径模板对象中找到对应的key值
      const contents = toBeCreatedFiles[dir];
      // 获取当前节点的files数组进行循环
      contents.files.forEach((item) => {
        // item为object对象时
        if (typeof item === 'object') {
          if (item.template) {
            outputFileWithTemplate(item, component, contents.desc, _d);
          }
        } else {
          // 看到了有一个e2e test就是一个字符串
          const _f = path.resolve(_d, item);
          createFile(_f, '', contents.desc);
        }
      });
    });
  });
}


5.7、outputFileWithTemplate


接下来再来看item为object时的函数,这里面涉及到一个简单的函数getFirstLetterUpper,将传入的字符串转换为首字母大写。


再来看一下lodash中的template方法,看一个例子应该就明白了。更多的用法可以去 www.lodashjs.com/docs/lodash…

// 通过分隔符创建编译模板然后通过变量进行替换,骚的一批
var compiled = _.template('hello <%= user %>!');\
compiled({ 'user': 'world' });   


最终打印出来的是hello world


接下来继续看整个函数


function outputFileWithTemplate(item, component, desc, _d) {
  const tplPath = path.resolve(__dirname, `./tpl/${item.template}`);
  let data = fs.readFileSync(tplPath).toString();
  const compiled = _.template(data);
  data = compiled({
    component,
    upperComponent: getFirstLetterUpper(component),
  });
  const _f = path.resolve(_d, item.file);
  createFile(_f, data, desc);
}


第一行的代码又是来拼接路径的,看了一下tpl文件夹下的文件


image.png


竟然是模板字符串,应该是用来生成初始化文件的


第二行通过fs.readFileSync来读取模板字符串


然后下面就是lodash的templte方法和compiled方法,就是根据预设变量进行模板字符串替换


替换完毕后,就要通过方法createFile生成文件了


function createFile(path, data = '', desc) {
  fs.writeFile(path, data, (err) => {
    if (err) {
      utils.log(err, 'error');
    } else {
      utils.log(`> ${desc}\n${path} file has been created successfully!`, 'success');
    }
  });
}


就是通过fs.writeFile函数将替换后的模板字符串,一起生成并写入到文件中去,这样addComponent方法算是执行完毕了


5.8 同理看一下deleteComponent


其中包含一个 getSnapshotFiles


function getSnapshotFiles(component) {
  return {
    [`test/unit/${component}/__snapshots__/`]: {
      desc: 'snapshot test',
      files: ['index.test.js.snap', 'demo.test.js.snap'],
    },
  };
}


通过函数可以发现主要是执行单元测试的时候生成测试的快照文件 snapshots,这里我们就简单的提一下(实际上是我去查了一下),不做过深的学习。


接着看主函数


function deleteComponent(toBeCreatedFiles, component) {
  const snapShotFiles = getSnapshotFiles(component);
  const files = Object.assign(toBeCreatedFiles, snapShotFiles);
  Object.keys(files).forEach((dir) => {
    const item = files[dir];
    if (item.deleteFiles && item.deleteFiles.length) {
      item.deleteFiles.forEach((f) => {
        fs.existsSync(f) && fs.unlinkSync(f);
      });
    } else {
      utils.deleteFolderRecursive(dir);
    }
  });
  utils.log('All radio files have been removed.', 'success');
}


将快照的文件夹及相关文件对象,一起合并到toBeCreatedFiles上,这个在上面说过可以回头查看。 接下来循环files,对数组中的每个对象也就是每个文件夹下的文件进行遍历的。


这里发现deleteFiles属性是不存在的,唯一存在的地方是关于ssr的地方,这里也做了注释处理所以直接看


function deleteFolderRecursive(path) {
  // 先判断路径是否存在
  if (fs.existsSync(path)) {
    // 路径存在则读取path路径下的所有文件,进行循环
    fs.readdirSync(path).forEach((file) => {
      const current = `${path}/${file}`;
      // 如果current是一个路径目录则进行递归调用
      if (fs.statSync(current).isDirectory()) {
        deleteFolderRecursive(current);
      } else {
        // 如果是个文件则删除即可
        fs.unlinkSync(current);
      }
    });
    // 上面文件删除了,再进行目录的删除
    fs.rmdirSync(path);
  }
}


5.9 字符串的替换函数replace


// last import line pattern
  const importPattern = /import.*?;(?=\n\n)/;
  const cmpPattern = /(?<=const components = {\n)[.|\s|\S]*?(?=};\n)/g;
  let data = fs.readFileSync(indexPath).toString();
   data = data.replace(importPattern, (a) => `${a}\n${importPath}`).replace(cmpPattern, (a) => `${a}  ${upper},\n`);
  fs.writeFile(indexPath, data, (err) => {
    if (err) {
      utils.log(err, 'error');
    } else {
      utils.log(`${desc}\n${component} has been inserted into /src/index.ts`, 'success');
    }
  });


上面是两个正则,通过字符串的replace函数来替换掉字符,替换后将字符串再写会源文件。


5.10 deleteComponentFromIndex


删除的逻辑跟添加的逻辑一致


6、总结


  • 学习到一个命令创建组件库的初始化文件
  • lodash的template、compiled 模板字符串的编译替换生成想要的字符串,再写入文件
  • 对于nodejs的删除文件、创建文件、删除文件夹、创建文件夹、写入文件等操作,本质对fs的操作的熟悉
  • 关于两个正则通过repace替换的第二个正则理解有点费解,有时间再学习一下正则表达式
目录
相关文章
|
2月前
|
JavaScript
Vue中如何实现兄弟组件之间的通信
在Vue中,兄弟组件可通过父组件中转、事件总线、Vuex/Pinia或provide/inject实现通信。小型项目推荐父组件中转或事件总线,大型项目建议使用Pinia等状态管理工具,确保数据流清晰可控,避免内存泄漏。
300 2
|
5月前
|
人工智能 JavaScript 算法
Vue 中 key 属性的深入解析:改变 key 导致组件销毁与重建
Vue 中 key 属性的深入解析:改变 key 导致组件销毁与重建
769 0
|
7月前
|
JavaScript
vue实现任务周期cron表达式选择组件
vue实现任务周期cron表达式选择组件
1006 4
|
5月前
|
JavaScript UED
用组件懒加载优化Vue应用性能
用组件懒加载优化Vue应用性能
|
5月前
|
JavaScript 前端开发 UED
Vue 表情包输入组件的实现代码:支持自定义表情库、快捷键发送和输入框联动的聊天表情解决方案
本文详细介绍了在 Vue 项目中实现一个功能完善、交互友好的表情包输入组件的方法,并提供了具体的应用实例。组件设计包含表情分类展示、响应式布局、与输入框的交互及样式定制等功能。通过核心技术实现,如将表情插入输入框光标位置和点击外部关闭选择器,确保用户体验流畅。同时探讨了性能优化策略,如懒加载和虚拟滚动,以及扩展性方案,如自定义主题和国际化支持。最终,展示了如何在聊天界面中集成该组件,为用户提供丰富的表情输入体验。
480 8
|
5月前
|
JavaScript 前端开发 UED
Vue 表情包输入组件实现代码及详细开发流程解析
这是一篇关于 Vue 表情包输入组件的使用方法与封装指南的文章。通过安装依赖、全局注册和局部使用,可以快速集成表情包功能到 Vue 项目中。文章还详细介绍了组件的封装实现、高级配置(如自定义表情列表、主题定制、动画效果和懒加载)以及完整集成示例。开发者可根据需求扩展功能,例如 GIF 搜索或自定义表情上传,提升用户体验。资源链接提供进一步学习材料。
273 1
|
5月前
|
JavaScript 前端开发 UED
Vue 项目中如何自定义实用的进度条组件
本文介绍了如何使用Vue.js创建一个灵活多样的自定义进度条组件。该组件可接受进度段数据数组作为输入,动态渲染进度段,支持动画效果和内容展示。当进度超出总长时,超出部分将以红色填充。文章详细描述了组件的设计目标、实现步骤(包括props定义、宽度计算、模板渲染、动画处理及超出部分的显示),并提供了使用示例。通过此组件,开发者可根据项目需求灵活展示进度情况,优化用户体验。资源地址:[https://pan.quark.cn/s/35324205c62b](https://pan.quark.cn/s/35324205c62b)。
248 0
|
7月前
|
存储 JavaScript 前端开发
基于 ant-design-vue 和 Vue 3 封装的功能强大的表格组件
VTable 是一个基于 ant-design-vue 和 Vue 3 的多功能表格组件,支持列自定义、排序、本地化存储、行选择等功能。它继承了 Ant-Design-Vue Table 的所有特性并加以扩展,提供开箱即用的高性能体验。示例包括基础表格、可选择表格和自定义列渲染等。
597 6
|
12月前
|
前端开发 JavaScript 测试技术
Vue3中v-model在处理自定义组件双向数据绑定时,如何避免循环引用?
Web 组件化是一种有效的开发方法,可以提高项目的质量、效率和可维护性。在实际项目中,要结合项目的具体情况,合理应用 Web 组件化的理念和技术,实现项目的成功实施和交付。通过不断地探索和实践,将 Web 组件化的优势充分发挥出来,为前端开发领域的发展做出贡献。
272 64
|
12月前
|
缓存 JavaScript UED
Vue3中v-model在处理自定义组件双向数据绑定时有哪些注意事项?
在使用`v-model`处理自定义组件双向数据绑定时,要仔细考虑各种因素,确保数据的准确传递和更新,同时提供良好的用户体验和代码可维护性。通过合理的设计和注意事项的遵循,能够更好地发挥`v-model`的优势,实现高效的双向数据绑定效果。
404 64