更新记录

1.1.1（2023-05-03）

配置文件customMeta改为metaConfig, 升级后请及时修改

1.1.0（2023-04-21）

增加配置模板

1.0.9（2023-04-20）

修复已知问题

平台兼容性

主要功能

• IE或低版本浏览器不兼容提示, 支持自定义修改
• 内置PC端必要Meta设置, 支持自定义修改

开始使用

1. 使用插件

   // vite.config.js
   
   import { defineConfig } from 'vite';
   import uni from '@dcloudio/vite-plugin-uni';
   import MiViteIndexHtml from './uni_modules/mi-vite-index-html';
   
   export default defineConfig({
       plugins: [uni(), MiViteIndexHtml()]
   });

2. 运行项目
3. 开发者工具可查看配置的meta信息
4. 切换至IE或低版本浏览器, 即可显示不兼容提示

插件配置

1. 开启和关闭

   // vite.config.js
   
   import { defineConfig } from 'vite';
   import uni from '@dcloudio/vite-plugin-uni';
   import MiViteIndexHtml from './uni_modules/mi-vite-index-html';
   
   export default defineConfig({
       plugins: [
           uni(), 
           MiViteIndexHtml({
               insertMeta: false, // 是否插入meta信息, 默认true
               browserTip: false  // 是否开启浏览器不兼容提示, 默认true
           })
       ]
   });

2. 自定义修改内容

   • 浏览器不兼容提示信息, 在 uni_modules/mi-vite-index-html/config.js 中进行修改
   • 内置meta通用配置, 在 uni_modules/mi-vite-index-html/config.js 中进行修改
   • 项目meta差异配置(如keywords, description等), 在根目录新建 config/mi-vite-plugin-config.js 中进行配置
   • 项目meta差异配置也可直接在index.html中进行补充, 但不建议

   // config/mi-vite-plugin-config.js
   
   module.exports = {
       metaConfig: [
           { injectTo: 'head', tag: 'meta', attrs: { name: 'keywords', content: 'uni-app' } }, // 页面内容关键词, 使用逗号分割
           { injectTo: 'head', tag: 'meta', attrs: { name: 'description', content: 'uni-app' } } // 页面内容描述, 不超过150个字符
       ]
   };

注意事项

• 浏览器不兼容提示仅在编译h5平台(UNI_PLATFORM)生效
• 内置meta信息在编译h5平台时插入内容为: 内置必要配置 + 自定义配置
• 内置meta信息在编译非h5平台插入内容为: <meta charset="UTF-8"> + 自定义配置