Skip to content

此为吴乐川的《针对 Vuejs 第 2 版单文件部件的拆分器》。本工具之代码系由吴乐川手工提取自 Vue `v2.6.11` 之官方源代码后整理而得。其功用是将一个 .vue 文件之内容全文拆分成一套结构化的数据,即一个 JavaScript 对象。该结构化的数据包含 `<template>` 、 `<script>` 、 `<style>` 等标签之内容、属性等。

License

Notifications You must be signed in to change notification settings

wulechuan/wulechuan-typescript-vue2-official-sfc-parser

Repository files navigation

针对 Vuejs 第 2 版单文件部件的拆分器
——从 Vuejs v2.6.11 官方代码中手工提取而得

中国人——特别是汉族人,理应坚持广泛、规范地使用汉语。凡非必要之情形不说外国话、不用外国字。此乃天经地义!然则每当必要,亦不排斥采用外国之语言。不妨 博世界之学问,养中国之精神

本人亦支持少数民族坚持采用自己民族的传统语言。仍须强调,凡中国人,皆应会用汉语、积极使用汉语,此乃中华各民族之大一统之必由。

Multilingual Editions of this Article

NPM 页

NPM 包名

@wulechuan/vue2-official-sfc-parser

整理者

南昌吴乐川

简介

此物之来源及功用

本工具之代码系由吴乐川手工提取自 Vue v2.6.11 之官方源代码后整理而得。这些代码之功用如下:

  • 将一个【Vue 单文件部件】(外国话所谓 “single-filed component”,扩展名往往为 .vue )之内容字符串中的:

    • 唯一的【根 <template>】、
    • 唯一的【<script>】、
    • 所有的【<style>】、
    • 以及所有的自定义部分,

    逐一分离,形成多个“纯净的”代码片段。

  • 分离出的多个代码片段全部存放在一个对象中。

  • 本工具对外界【返回】该对象。

我们不妨暂时约定将 <template> 中的纯净的代码、 <script> 中的纯净的代码,以及 <style> 中的纯净的代码等,统称为鄙人所谓“单品类代码”。

简而言之,本工具将 .vue 文件之内容拆分成一套结构化的数据,即一个对象(Object),该对象中存放着 <template><script><style> 等各个单品类代码,供其他程序采用。

为何要拆分 .vue 文件(即本工具之价值)

.vue 文件之内容拆分之意义,是令其他代码可以方便的将 .vue 文件中的各个部分分别处理。

须强调,本工具对 .vue 文件之内容仅作拆分,并不做任何额外的转译、编译、转换等工作。

假定的应用场景1

我们可以另行编写工具,接受本工具之输出内容,以便将原始 .vue 文件中的 Stylus 代码编译成 CSS 代码,并单独存放成 .css 文件。

假定的应用场景2

我们可以另行编写工具,接受本工具之输出内容,以便将原始 .vue 文件中的 TypeScript 代码转译为 JavaScript 代码,并单独存放成 .js 文件。

假定的应用场景3

我们可以将原始 .vue 文件中的 TypeScript 代码转译为 JavaScript 代码,并将 Sass 代码编译成 CSS 代码。然后将 JavaScript 和 CSS 代码,连同原封未动的 template 部分的代码,拼合为一个新的 .vue 文件,存放在磁盘上。

那么,既然已经写就了 .vue 文件,为何还要产出新的 .vue 文件呢?

这是因为:

  • 已知我们不少工具的代码是 TypeScript 语言编写的,并希望分享出去,供其他项目调用。
  • 其项目则可能采用纯 JavaScript 而非 TypeScript 语言编写代码。且可能其并未配置与兼容 TypeScript 代码相关的复杂的工具链。故其项目无法直接利用我们采用 TypeScript 语言编写的 .vue 部件。那些项目调用的工具也应采用 JavaScript 语言编写。

因此,每当我们采用 TypeScript 语言编写独立的 Vue 部件后,在发布这些由 TypeScript 语言编写的代码时,一并发布一套 JavaScript 语言之版本的代码乃是非常必要之举。 即,我们在发布时, TypeScript 和 JavaScript 并举。

欲将原始 .vue 文件中的 TypeScript 代码提取出来以便之后转译为 JavaScript 代码,就要借助本工具。

顺便再次强调,本工具对 .vue 文件之内容仅作拆分,并不做任何额外的转译、编译、转换等工作。

对官方原始代码所作的修订

为令本工具之所有代码均满足 eslint 之要求,本人对官方的原始代码做了少数修订这些修订均不改变执行之逻辑,仅影响代码风格。

  1. 将形如

    let a, b

    之写法,统统改为

    let a
    let b

    之形式。

  2. 重命名了一些工具函数,以期“顾名思义”。

用法

安装

npm  i  @wulechuan/vue2-official-sfc-parser

注意事项

  • 本工具接受的输入是一个字符串,但该字符串并非 .vue 文件路径之字符串,而是 .vue 文件之内容之字符串。因此,读取文件之操作须另行编写。如此设计,自然是为了令本工具拥有更佳的通用性。

  • 本工具对 .vue 文件之内容仅作拆分,并不做任何额外的转译、编译、转换等工作。

具体示例

import { readFile as 非阻塞式读取文件 } from 'fs-extra'
import { 将Vue2的单文件部件内容全文拆分 } from '@wulechuan/vue2-official-sfc-parser'

测试用例2('./测试集/testing-source-2.vue')

async function 测试用例2 (原始文件之路径) {
    const 原始Vue文件之内容包 = await 非阻塞式读取文件(原始文件之路径, 'utf8')
    const 原始Vue文件之内容全文 = 原始Vue文件之内容包.toString()
    const 拆分得到的结构化数据 = 将Vue2的单文件部件内容全文拆分(原始Vue文件之内容全文)
    console.log(拆分得到的结构化数据)
}

应用编程接口(所谓 API)

本工具仅提供唯一的函数作为对外接口,但故意给出汉语、英语两种名称: 将Vue2的单文件部件内容全文拆分vueSFCParser。该函数之签名( Signature )如下:

function 将Vue2的单文件部件内容全文拆分 (
    content: string,
    options?: ParseComponentOptions
): SFCDescriptor

function vueSFCParser (
    content: string,
    options?: ParseComponentOptions
): SFCDescriptor

以下是上述函数签名所涉及的、官方给出的类型定义。

interface SFCBlock {
    type: string;
    content: string; // 分离出的单品类代码。
    attrs: Record<string, string>;
    start?: number;
    end?: number;
    lang?: string; // 该品类之语言类型,例如 'ts' 、'sass' 、 'stylus' 等。
    src?: string;
    scoped?: boolean;
    module?: string | boolean;
}

interface SFCDescriptor {
    template: SFCBlock | undefined | null; // 其中 null 系由本人补充之条目。
    script: SFCBlock | undefined | null;   // 其中 null 系由本人补充之条目。
    styles: SFCBlock[];
    customBlocks: SFCBlock[];
    errors?: any[]; // 系由本人补充之条目。
}

type ParseComponentOptions = {
    outputSourceRange?: any;
    pad?: any;      // TODO 不敢冒然配为 string,遂暂定为 any。
    deindent?: any; // TODO 不敢冒然配为 string,遂暂定为 any。
};

源代码仓库

提供仓库服务之组织 仓库组织之国别 仓库地址
码云 中华人民共和国 https://gitee.com/nanchang-wulechuan/wulechuan-typescript-vue2-official-sfc-parser.git
阿里云之代码仓库 中华人民共和国 https://code.aliyun.com/wulechuan/wulechuan-typescript-vue2-official-sfc-parser.git
GitHub https://github.com/wulechuan/wulechuan-typescript-vue2-official-sfc-parser.git

About

此为吴乐川的《针对 Vuejs 第 2 版单文件部件的拆分器》。本工具之代码系由吴乐川手工提取自 Vue `v2.6.11` 之官方源代码后整理而得。其功用是将一个 .vue 文件之内容全文拆分成一套结构化的数据,即一个 JavaScript 对象。该结构化的数据包含 `<template>` 、 `<script>` 、 `<style>` 等标签之内容、属性等。

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published