阅读(4391) (0)

Vite 静态资源处理

2022-03-07 11:18:43 更新

将资源引入为URL

服务时引入一个静态资源会返回解析后的公共路径:

import imgUrl from './img.png'
document.getElementById('hero-img').src = imgUrl

例如,​imgUrl ​在开发时会是 ​/img.png​,在生产构建后会是 ​/assets/img.2d8efhg.png​。

行为类似于 Webpack 的 ​file-loader​。区别在于导入既可以使用绝对公共路径(基于开发期间的项目根路径),也可以使用相对路径。

  • url()​ 在 CSS 中的引用也以同样的方式处理。
  • 如果 Vite 使用了 Vue 插件,Vue SFC 模板中的资源引用都将自动转换为导入。
  • 常见的图像、媒体和字体文件类型被自动检测为资源。你可以使用 ​assetsInclude ​选项 扩展内部列表。
  • 引用的资源作为构建资源图的一部分包括在内,将生成散列文件名,并可以由插件进行处理以进行优化。
  • 较小的资源体积小于 ​assetsInlineLimit ​选项值 则会被内联为 base64 data URL。

显式URL引入

未被包含在内部列表或 assetsInclude 中的资源,可以使用 ?url 后缀显式导入为一个 URL。这十分有用,例如,要导入 Houdini Paint Worklets 时:

import workletURL from 'extra-scalloped-border/worklet.js?url'
CSS.paintWorklet.addModule(workletURL)

将资源引入为字符串

资源可以使用 ?raw 后缀声明作为字符串引入。

import shaderString from './shader.glsl?raw'

导入脚本作为Worker

脚本可以通过 ?worker 或 ?sharedworker 后缀导入为 web worker。

// 在生产构建中将会分离出 chunk
import Worker from './shader.js?worker'
const worker = new Worker()
// sharedworker
import SharedWorker from './shader.js?sharedworker'
const sharedWorker = new SharedWorker()
// 内联为 base64 字符串
import InlineWorker from './shader.js?worker&inline'

public目录

如果你有下列这些资源:

  • 不会被源码引用(例如 ​robots.txt​)
  • 必须保持原有文件名(没有经过 hash)
  • ...或者你压根不想引入该资源,只是想得到其 URL。

那么你可以将该资源放在指定的 public​目录中,它应位于你的项目根目录。该目录中的资源在开发时能直接通过 ​​根路径访问到,并且打包时会被完整复制到目标目录的根目录下。

目录默认是 ​<root>/public​,但可以通过 ​publicDir​选项 来配置。

请注意:

  • 引入 ​public ​中的资源永远应该使用根绝对路径 —— 举个例子,​public/icon.png​ 应该在源码中被引用为 ​/icon.png​。
  • public中的资源不应该被 JavaScript 文件引用。

new URL(url, import.meta.url)

import.meta.url 是一个 ESM 的原生功能,会暴露当前模块的 URL。将它与原生的 URL 构造器 组合使用,在一个 JavaScript 模块中,通过相对路径我们就能得到一个被完整解析的静态资源 URL:

const imgUrl = new URL('./img.png', import.meta.url).href

document.getElementById('hero-img').src = imgUrl

这在现代浏览器中能够原生使用 - 实际上,Vite 并不需要在开发阶段处理这些代码!

这个模式同样还可以通过字符串模板支持动态 URL:

function getImageUrl(name) {
  return new URL(`./dir/${name}.png`, import.meta.url).href
}

在生产构建时,Vite 才会进行必要的转换保证 URL 在打包和资源哈希后仍指向正确的地址。

注意:无法在 SSR 中使用

如果你正在以服务端渲染模式使用 Vite 则此模式不支持,因为import.meta.url​在浏览器和 Node.js 中有不同的语义。服务端的产物也无法预先确定客户端主机 URL。