The Last Naruto,兼容IE11的vue脚手架

封面

摘要

the-last-naruto是一个基于Vue@2.7Vite@3的一个项目模板(支持IE11浏览器),灵感来源自antfu大佬的vitesse-lite。旨在给项目上还需要支持IE11浏览器的一些同学提供近似Vue3生态的开发体验。

前言

众所周知,由于Vue3中的响应式系统是基于proxy来构建的,导致需要兼容IE和低版本浏览器的项目无法升级到Vue3。有些同学又想尝试用新的组合式api来组织代码,还需要借助于@vue/composition-api这个插件的力量,虽然也将就能用,但是ts不友好和缺少setup语法糖的境况还是令人沮丧😢。

直到那个男人在2022年7月1日发布了代号为NarutoVue2.7。喜大普奔,咱们终于能在Vue2里面用上组合式apisetup了,还有完备的ts支持💪。当时仔细看了release blog,发现除了可以用Vue CLI / webpack起项目,竟然连Vite也支持了!激动的💕,颤抖的🙌,借助vite-plugin-vue2就可以用Vite支持我们开发vue2.7的项目了,鉴于之前用过antfu大佬vitesse-lite写过项目,觉得非常好用,于是我就想能既然Vue2.7出来了,vite也支持了,能不能让Vue2.7的项目的开发体验朝Vue3靠齐,毕竟天下苦webpack久矣,所以the-last-naruto就诞生了。

特性

完善的TypeScript<script setup>语法糖

Vue2.7直接完美支持!

VueUse

开箱即用!

支持使用Vite开发和打包

伴随Vue2.7releaseVue官方也提供了对应的Vite插件vite-plugin-vue2。给不能升级到Vue@3版本的开发者提供了大力的支持!具体配置参考

配置打包产物支持IE11

Vite的默认浏览器支持基线是原生ESM也就是es6-module,所以我们需要使用Vite官方提供的一个插件@vitejs/plugin-legacy来为打包后的文件提供传统浏览器兼容性支持。具体配置参考

文件路由

知道Nuxtjs的路由系统的应该都了解这种路由系统的特点,不用手动配置路由,基于文件夹层级和文件名自动生成的路由系统,并且也支持动态路由,非常方便。在vitesse-lite中我知道了这么一个插件vite-plugin-pages,虽说这个插件的文档中说自己是支持Vue 3 / React应用的文件路由系统,但是经过我的尝试,不出意外的vue@2.7配合vue-router@3.5.4配置稍作改动也是可以用的,具体配置参考

组件自动导入

了解Vue3Vite生态的应该都知道antfu大佬的一个很有名也很好用的插件unplugin-vue-components,之前的开发中我们要使用封装好的组件,都要引入组件,并在components中声明,当我们的项目越来越复杂,这种代码会越来越多,导致代码可读性下降,我们使用unplugin-vue-components来优化这个问题,使用组件直接在模板文件中使用即可,不需要导入不需要声明,具体配置参考

组合式Api自动导入

跟上面组件导入的痛点类似,之前我们在使用组合式apiVueUse中提供的方法来组织代码逻辑的时候还是手动引入类似refreactiveonMounted。我们可以使用unplugin-auto-import来优化这个问题,别问,问就是还是antfu大佬的库😂,具体配置参考

UnoCSS

用过tailwindcsswindicss或者用过vitesse-lite模板的都大概知道UnoCSS的能力怎样,谁用谁知道!🤔我们借助Vite的能力,同样的可以在Vue2.7的项目中使用强大的、高性能的、高灵活性的UnoCSS。给你个眼神自己体会,还是antfu大佬的库😜,具体配置参考

纯CSS的图标(能力在IE11上部分支持)

十分不好意思各位,由于antfu大佬的icons-in-pure-css方案中使用了IE11不支持的CSS能力:IE11中无法支持CSS MasksCSS property: mask-image,所以这个能力在IE11上成为了遗憾。但是👀,也有另一种不怎么优雅的方案来提供有限的能力。

因为所有的这些icons都是基于iconify这个图标框架的图标集icon-sets,其底层都是使用的svg来渲染,并且提供了这些svgURLicones.js.org,我们就能拿到想要使用的图标的URL或者Data URL,判断当前浏览器如果是IE,就用background-image的方案来使用图标,通过指定元素宽高也可以模拟实现,组件大概逻辑:

<div :class="isIE ? `w-${size} h-${size}` : ''" display-context inline-block text-center>
  <div v-if="isIE" :class="`w-${size} h-${size}`" :style="{ backgroundImage: `url(${Icons[name]})`, backgroundSize: '100% 100%' }" />
  <div v-else :class="`${IconName[name]} text-${size}`" inline-block />
</div>

具体代码参考
遗憾的一点就是图标颜色的设置还没有一个比较好的方案,如果你有比较好的颜色改变方案,欢迎PR!

CSS Variables Polyfill

感谢ie11CustomProperties的支持,只在IE11浏览器环境上加载一段polyfill来支持css var

使用

npx degit luvletterldl/the-last-naruto your-project-name
cd your-project-name
pnpm i # If you don't have pnpm installed, run: npm install -g pnpm

总结

长江后浪推前浪,前端圈里面更是如此。Vue团队在打磨了好了Vue3生态之后,并没有选择把Vue2"拍死在沙滩上"。依然对Vue2保持初心,为我们开发者精心准备了Vue2.7这样的传奇版本。就像他的代号Naruto一样。

只要有树叶飞舞的地方就会有火在燃烧,火的影子照耀着村子,然后新的树叶会再次萌芽

最后,也希望the-last-naruto能够帮助到你,使用有任何问题也可以给我评论或者提issue,如果有好的建议也欢迎PR!有用请点赞(顺便给个Star😜),喜欢请关注,我是Senar

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 194,242评论 5 459
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 81,769评论 2 371
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 141,484评论 0 319
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,133评论 1 263
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 61,007评论 4 355
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,080评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,496评论 3 381
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,190评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,464评论 1 290
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,549评论 2 309
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,330评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,205评论 3 312
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,567评论 3 298
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,889评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,160评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,475评论 2 341
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,650评论 2 335

推荐阅读更多精彩内容