如何创建一个库,公开可供分布式 .mjs 文件使用的单个 Vue 组件?
P粉797004644
P粉797004644 2023-08-26 23:23:36
[Vue.js讨论组]

我想创建一个捆绑到单个 .mjs 文件中的 Vue 组件。另一个 Vue 项目可以通过 HTTP 获取此 .mjs 文件并使用该组件。通过 npm 安装可插入组件是不可能的,因为其他应用程序会尝试在运行时根据配置来获取它。

可插拔组件需要考虑的事项

  • 可能正在使用另一个 UI 框架/库中的子组件
  • 可能使用自定义 CSS
  • 可能依赖其他文件,例如图片

复制库

我通过 npm create vuetify 创建了一个新的 Vuetify 项目

我删除了 src 文件夹中除 vite-env.d.ts 之外的所有内容,创建了一个组件 Renderer.vue

<script setup lang="ts">
import { VContainer } from "vuetify/components"

defineProps<{ value: unknown }>()
</script>

<template>
  <v-container>
    <span class="red-text">Value is: {{ JSON.stringify(value, null, 2) }}</span>
  </v-container>
</template>

<style>
.red-text { color: red; }
</style>

和一个index.ts文件

import Renderer from "./Renderer.vue";

export { Renderer };

我在vite.config.ts中添加了库模式

build: {
    lib: {
      entry: resolve(__dirname, "./src/index.ts"),
      name: "Renderer",
      fileName: "renderer",
    },
    rollupOptions: {
      external: ["vue"],
      output: {
        globals: {
          vue: "Vue",
        },
      },
    },
  },

并扩展了 package.json 文件

"files": ["dist"],
  "main": "./dist/renderer.umd.cjs",
  "module": "./dist/renderer.js",
  "exports": {
    ".": {
      "import": "./dist/renderer.js",
      "require": "./dist/renderer.umd.cjs"
    }
  },

由于我使用自定义 CSS,Vite 会生成 styles.css 文件,但我必须将样式注入到 .mjs 文件中。基于这个问题,我正在使用插件 vite-plugin-css-injected-by-js。

构建时,我获得了包含自定义 CSS 的所需 .mjs 文件


使用组件

我通过npm create vue创建了一个新的Vue项目

出于测试目的,我将生成的 .mjs 文件直接复制到新项目的 src 目录中,并将 App.vue 文件更改为

<script setup lang="ts">
import { onMounted, type Ref, ref } from "vue";

const ComponentToConsume: Ref = ref(null);

onMounted(async () => {
  try {
    const { Renderer } = await import("./renderer.mjs"); // fetch the component during runtime

    ComponentToConsume.value = Renderer;
  } catch (e) {
    console.log(e);
  } finally {
    console.log("done...");
  }
});
</script>

<template>
  <div>Imported component below:</div>
  <div v-if="ComponentToConsume === null">"still loading..."</div>
  <component-to-consume v-else :value="123" />
</template>

不幸的是,我收到以下警告和错误

[Vue warn]:Vue 接收到一个已成为响应式对象的组件。这可能会导致不必要的性能开销,应该通过使用 markRaw 标记组件或使用 shallowRef 而不是 ref 来避免。

[Vue warn]:找不到注入“Symbol(vuetify:defaults)”。

[Vue warn]:执行设置函数期间出现未处理的错误

[Vue warn]:执行调度程序刷新期间出现未处理的错误。

未捕获(承诺中)错误:[Vuetify] 找不到默认实例

有人知道我缺少什么或如何解决它吗?

P粉797004644
P粉797004644

全部回复(1)
P粉668146636

Vuetify 不提供隔离组件,需要初始化插件,您需要在主应用中执行此操作:

app.use(Vuetify)

确保 vuetify 在项目 deps 中不重复,以便库和主应用程序使用相同的副本。

lib应该使用vuetify作为开发依赖,并在Rollup external中指定它,以防止项目全局的东西与lib捆绑在一起:

external: ["vue", "vuetify"]
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号