befly-vite 1.41.0 → 1.43.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +39 -8
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -82,17 +82,18 @@ export default createBeflyViteConfig();
|
|
|
82
82
|
8. `build.assetsDir = "assets"`
|
|
83
83
|
9. `build.cssMinify = "lightningcss"`
|
|
84
84
|
10. `css.transformer = "lightningcss"`
|
|
85
|
-
11. 默认 CSS 浏览器基线：Chrome 107 / Edge 107 / Firefox 104 / Safari 16.
|
|
85
|
+
11. 默认 CSS 浏览器基线：Chrome 107 / Edge 107 / Firefox 104 / Safari 16.010. 默认启用 `@vitejs/plugin-legacy` 对旧浏览器做 JS polyfill
|
|
86
86
|
|
|
87
87
|
### 参数说明
|
|
88
88
|
|
|
89
|
-
| 参数 | 类型 | 默认值 | 作用
|
|
90
|
-
| -------------- | -------------------- | --------------- |
|
|
91
|
-
| `root` | `string` | `process.cwd()` | 项目根目录，用于解析 `src`、扫描 `views` 和生成别名
|
|
92
|
-
| `analyzer` | `boolean` | `false` | 是否启用打包分析，并输出到 `<root>/temp/analyzer`
|
|
93
|
-
| `
|
|
94
|
-
| `
|
|
95
|
-
| `
|
|
89
|
+
| 参数 | 类型 | 默认值 | 作用 |
|
|
90
|
+
| -------------- | -------------------- | --------------- | ------------------------------------------------------------ |
|
|
91
|
+
| `root` | `string` | `process.cwd()` | 项目根目录，用于解析 `src`、扫描 `views` 和生成别名 |
|
|
92
|
+
| `analyzer` | `boolean` | `false` | 是否启用打包分析，并输出到 `<root>/temp/analyzer` |
|
|
93
|
+
| `legacy` | `boolean \| object` | `true` | 是否启用 `@vitejs/plugin-legacy`，默认自动 polyfill 旧浏览器 |
|
|
94
|
+
| `resolvers` | `Object \| Object[]` | `undefined` | 追加到组件自动注册中的自定义 resolver |
|
|
95
|
+
| `manualChunks` | `Function \| Object` | `undefined` | 便捷写入 `build.rolldownOptions.output.manualChunks` |
|
|
96
|
+
| `viteConfig` | `Object` | `{}` | 最终合并到默认配置上的 Vite 原生配置 |
|
|
96
97
|
|
|
97
98
|
### 参数细节
|
|
98
99
|
|
|
@@ -129,6 +130,36 @@ export default createBeflyViteConfig({
|
|
|
129
130
|
|
|
130
131
|
适合：分析打包体积、依赖拆分和大包来源。
|
|
131
132
|
|
|
133
|
+
#### legacy
|
|
134
|
+
|
|
135
|
+
默认启用 `@vitejs/plugin-legacy`，自动注入 `core-js` 等 polyfill，解决旧浏览器不支持 `Array.prototype.toSorted` 等现代 JS API 的问题。
|
|
136
|
+
|
|
137
|
+
```javascript
|
|
138
|
+
import { createBeflyViteConfig } from "befly-vite";
|
|
139
|
+
|
|
140
|
+
// 使用默认配置
|
|
141
|
+
export default createBeflyViteConfig();
|
|
142
|
+
|
|
143
|
+
// 关闭 legacy
|
|
144
|
+
export default createBeflyViteConfig({
|
|
145
|
+
legacy: false
|
|
146
|
+
});
|
|
147
|
+
|
|
148
|
+
// 自定义 legacy 配置
|
|
149
|
+
export default createBeflyViteConfig({
|
|
150
|
+
legacy: {
|
|
151
|
+
targets: ["iOS >= 14", "Safari >= 14", "Chrome >= 109"],
|
|
152
|
+
modernPolyfills: true
|
|
153
|
+
}
|
|
154
|
+
});
|
|
155
|
+
```
|
|
156
|
+
|
|
157
|
+
说明：
|
|
158
|
+
|
|
159
|
+
1. 默认目标为 `["defaults", "not IE 11"]`，并开启 `modernPolyfills`。
|
|
160
|
+
2. 传 `false` 可完全关闭 legacy 插件，减少构建产物体积。
|
|
161
|
+
3. 传对象时，会与默认配置完全替换，而不是合并。
|
|
162
|
+
|
|
132
163
|
#### resolvers
|
|
133
164
|
|
|
134
165
|
`befly-vite` 默认内置：
|