element如何初始化组件功能详解

软件发布|下载排行|最新软件

当前位置:首页IT学院IT技术

element如何初始化组件功能详解

codeniu   2022-12-24 我要评论

前言

上篇文章学习了 tdesign-vue 初始化组件的方式,这篇文章学习一下element组件库是如何初始化组件的。

资源:

源码

入口文件

找到用于初始化组件的脚本,位置如图:

开始

脚本的开始引用了一些文件,说明了脚本所要用到的工具都有那些。

'use strict';

console.log();
process.on('exit', () => {
  console.log();
});

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

// 处理文件和目录路径
const path = require('path');
// 内置的 Node.js 模块,它提供文件系统操作,比如对文件系统的读写。
const fs = require('fs');
// 用于文本保存
const fileSave = require('file-save');
// 这是一个将字符串转换为 upperCamelcase 的库
const uppercamelcase = require('uppercamelcase');

const componentname = process.argv[2];
const chineseName = process.argv[3] || componentname;
const ComponentName = uppercamelcase(componentname);
const PackagePath = path.resolve(__dirname, '../../packages', componentname);

该脚本首先使用 process 对象的 on 方法注册一个回调函数,以便在进程退出时执行。回调函数将一个空行记录到控制台。

然后,脚本检查第二个命令行参数(process.argv [2])是否为真。如果它不是真值,那么脚本将记录一条错误消息,并使用非零退出代码退出进程(指示一个错误)。

然后,脚本声明一些变量:

  • componentname 设置为第二个命令行参数(组件名)。
  • chineseName 设置为第三个命令行参数(组件的中文名称) ,如果没有提供第三个参数,则设置为组件名称。
  • 组件名设置为使用 upperCamelCase 库将组件名转换为 UpperCamelCase 的结果。
  • PackagePath 设置为包目录的路径,后跟组件名。

文件列表

const Files = [
  {
    filename: 'index.js',
    content: `import ${ComponentName} from './src/main';
    ... 省略部分内容
    `
   },
   
   // ... 
 ]

之后脚本定义了一个Files变量,这个变量存储了需要添加或者需要修改的文件列表,同时也指示了添加或者修改的内容是什么。

那么具体都会修改那些文件呢:

  • index.js
  • 4个说明文档(zh-CN、en-US、es、fr-FR)
  • 测试文件 (/test/unit/specs)
  • 主题文件 (theme-chalk/src)
  • 类型文件

添加到 components.json

// 添加到 components.json
const componentsFile = require('../../components.json');
if (componentsFile[componentname]) {
  console.error(`${componentname} 已存在.`);
  process.exit(1);
}
componentsFile[componentname] = `./packages/${componentname}/index.js`;
fileSave(path.join(__dirname, '../../components.json'))
  .write(JSON.stringify(componentsFile, null, '  '), 'utf8')
  .end('\n');

检查组件名称的对象属性是否已经存在于 componentsFile 对象中。如果存在,脚本将记录一条错误消息,并使用非零退出代码退出进程。

如果组件不存在于 ComponentsFile 中,脚本将在对象上设置一个新属性,其中包含组件的名称和到达组件主入口点的路径的值(./package/${ Component entname }/index.js).

最后,脚本使用文件保存库将修改后的 ComponentsFile 对象写入 Components.json 文件,该文件采用缩进格式,并在文件末尾使用换行符。

其他文件的添加

// 添加到 index.scss
const sassPath = path.join(__dirname, '../../packages/theme-chalk/src/index.scss');
const sassImportText = `${fs.readFileSync(sassPath)}@import "./${componentname}.scss";`;
fileSave(sassPath)
  .write(sassImportText, 'utf8')
  .end('\n');

// 添加到 element-ui.d.ts
const elementTsPath = path.join(__dirname, '../../types/element-ui.d.ts');

let elementTsText = `${fs.readFileSync(elementTsPath)}
/** ${ComponentName} Component */
export class ${ComponentName} extends El${ComponentName} {}`;

const index = elementTsText.indexOf('export') - 1;
const importString = `import { El${ComponentName} } from './${componentname}'`;

elementTsText = elementTsText.slice(0, index) + importString + '\n' + elementTsText.slice(index);

fileSave(elementTsPath)
  .write(elementTsText, 'utf8')
  .end('\n');
  
// 创建 package
Files.forEach(file => {
  fileSave(path.join(PackagePath, file.filename))
    .write(file.content, 'utf8')
    .end('\n');
});

// 添加到 nav.config.json
const navConfigFile = require('../../examples/nav.config.json');

Object.keys(navConfigFile).forEach(lang => {
  let groups = navConfigFile[lang][4].groups;
  groups[groups.length - 1].list.push({
    path: `/${componentname}`,
    title: lang === 'zh-CN' && componentname !== chineseName
      ? `${ComponentName} ${chineseName}`
      : ComponentName
  });
});

fileSave(path.join(__dirname, '../../examples/nav.config.json'))
  .write(JSON.stringify(navConfigFile, null, '  '), 'utf8')
  .end('\n');

console.log('DONE!');

之后的代码将修改 index.scss 与 element-ui.d.ts,创建 package,修改nav.config.json,使用的方式也和上述相同。

总结

组件初始化脚本,很大程度上提高了开发效率,避免了程序员们将精力浪费在做重复的事情上,在我们日常的开发中也可尝试写一些这样的脚本。

Copyright 2022 版权所有 软件发布 访问手机版

声明:所有软件和文章来自软件开发商或者作者 如有异议 请与本站联系 联系我们