vue2 項目遷移 vue3,必須適配的部分

以下列舉遷移到 vue3系吩,必須適配的幾個點(diǎn)澈蚌,vue2 項目才能正常運(yùn)行在 vue3 上邪财。更多查看完整的非兼容特性列表

  • main.js

    • 創(chuàng)建應(yīng)用實(shí)例

      // 之前 - Vue 2
      import Vue from 'vue'
      import App from './App'
      Vue.config.productionTip = false    // vue3 不再需要
      App.mpType = 'app'    // vue3 不再需要
      const app = new Vue({
      ...App
      })
      app.$mount()
      
      // 之后 - Vue 3
      import App from './App'
      import { createSSRApp } from 'vue'
      export function createApp() {
         const app = createSSRApp(App)
         return {
            app
         }
      }
      
    • 全局屬性啥刻,例如:全局網(wǎng)絡(luò)請求

    // 之前 - Vue 2
    Vue.prototype.$http = () => {};
    
    // 之后 - Vue 3
    const app = createApp({});
    app.config.globalProperties.$http = () => {};
    
    • 插件使用煤搜,例如:使用 vuex 的 store
    // 之前 - Vue 2
    import store from "./store";
    Vue.prototype.$store = store;
    
    // 之后 - Vue 3
    import store from "./store";
    const app = createApp(App);
    app.use(store);
    
  • 項目根目錄必需創(chuàng)建 index.html 文件,粘貼復(fù)制如下內(nèi)容:

    <!DOCTYPE html>
    <html lang="en">
      <head>
        <meta charset="UTF-8" />
        <meta name="viewport" content="width=device-width, user-scalable=no, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0" />
        <title></title>
        <!--preload-links-->
        <!--app-context-->
      </head>
      <body>
        <div id="app"><!--app-html--></div>
        <script type="module" src="/main.js"></script>
      </body>
    </html>
    
  • 只支持使用 ES6 模塊規(guī)范凡伊,commonJS 需改為 ES6 模塊規(guī)范

    • 導(dǎo)入模塊, 例如:

      // 之前 - Vue 2, 使用 commonJS
      var utils = require("../../../common/util.js");
      
      // 之后 - Vue 3零渐, 只支持 ES6 模塊
      import utils from "../../../common/util.js";
      
    • 模塊導(dǎo)出,例如:

      // 之前 - Vue 2, 依賴如使用 commonJS 方式導(dǎo)出
      module.exports.X = X;
      
      // 之后 - Vue 3系忙, 可手動改為 ES6 導(dǎo)出
      export default { X };
      
  • vuex 用法

    // 之前 - Vue 2
      import Vue from 'vue'
      import Vuex from 'vuex'
      Vue.use(Vuex)
      const store = new Vuex.Store({
          state: {}
      })
      export default store
    
    // 之后 - Vue 3
      import { createStore } from 'vuex'
      const store = createStore({
          state: {}
      })
      export default store
    
  • 避免在同一元素上同時使用 v-if 與 v-for

    而 Vue3 中诵盼,v-if 總是優(yōu)先于 v-for 生效。以上寫法將會在 Vue3 中與預(yù)期不符合银还,由于語法上存在歧義风宁,建議避免在同一元素上同時使用兩者(更多)。

  • 生命周期的適配

    在Vue3中組件卸載的生命周期被重新命名

    • destroyed 修改為 unmounted
    • beforeDestroy 修改為 beforeUnmount
  • 事件的適配

    Vue3 現(xiàn)在提供了一個emits選項蛹疯,類似于現(xiàn)有props選項戒财。此選項可用于定義組件可以向其父對象發(fā)出的事件, 更多

    強(qiáng)烈建議使用emits記錄每個組件發(fā)出的所有事件捺弦。

這一點(diǎn)特別重要饮寞,因為去除了.native修飾符。emits 現(xiàn)在在未使用聲明的事件的所有偵聽器都將包含在組件的中$attrs列吼,默認(rèn)情況下幽崩,該偵聽器將綁定到組件的根節(jié)點(diǎn)。

  <template>
    <button @click="onClick">OK</button>
  </template>
  <script>
  export default {
    emits: ['click'],
    methods:{
      onClick(){
        this.$emit('click', 'OK')
      }
    }
  }
  </script>
  • v-model 的適配 Vue3 的 v-model 相對 Vue2 來說 寞钥,有了較大的改變慌申。可以使用多 model,相應(yīng)語法也有變化理郑。更多

    • 修改 modelValue 用于自定義組件時太示,Vue3 v-model prop 和事件默認(rèn)名稱已更改 props.value 修改為 props.modelValue ,event.value 修改為 update:modelValue

      export default {
        props: {
          // value:String,
          // 替換 value 為 modelValue
          modelValue:String
        }
      }
      
  • 事件返回 將之前的 this.$emit('input') 修改為 this.$emit('update:modelValue') ,vue3 中將省略這一步驟

    自定義組件上的 v-model 相當(dāng)于傳遞了 modelValue prop 并接收拋出的 update:modelValue 事件:

      <ChildComponent v-model="pageTitle" />
    
      <!-- 是以下的簡寫: -->
    
      <ChildComponent
        :modelValue="pageTitle"
        @update:modelValue="pageTitle = $event"
      />
    

若需要更改 model 名稱香浩,作為組件內(nèi) model 選項的替代,現(xiàn)在我們可以將一個 argument 傳遞給 v-model:

    <ChildComponent v-model:title="pageTitle" />

    <!-- 是以下的簡寫: -->

    <ChildComponent :title="pageTitle" @update:title="pageTitle = $event" />
  • 插槽的適配

    Vue3 將不支持 slot="xxx" 的用法 臼勉,請使用 v-slot:xxx 用法邻吭。更多

    <!--  Vue2 支持的用法 -->
    <uni-nav-bar>
      <view slot="left" class="city">
        <!-- ... -->
      </view>
    </uni-nav-bar>
    
    <!--  Vue3 支持的用法 -->
    <uni-nav-bar>
      <template v-slot:left>
        <view class="city">
          <!-- ... -->
        </view>
      </template>
    </uni-nav-bar>
    
  • 從 Vue 3.0 開始,過濾器已刪除宴霸,不再支持囱晴,建議用方法調(diào)用或計算屬性替換它們。更多

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末瓢谢,一起剝皮案震驚了整個濱河市畸写,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌氓扛,老刑警劉巖枯芬,帶你破解...
    沈念sama閱讀 206,839評論 6 482
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件论笔,死亡現(xiàn)場離奇詭異,居然都是意外死亡千所,警方通過查閱死者的電腦和手機(jī)狂魔,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 88,543評論 2 382
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來淫痰,“玉大人最楷,你說我怎么就攤上這事〈恚” “怎么了籽孙?”我有些...
    開封第一講書人閱讀 153,116評論 0 344
  • 文/不壞的土叔 我叫張陵,是天一觀的道長火俄。 經(jīng)常有香客問我犯建,道長,這世上最難降的妖魔是什么烛占? 我笑而不...
    開封第一講書人閱讀 55,371評論 1 279
  • 正文 為了忘掉前任胎挎,我火速辦了婚禮,結(jié)果婚禮上忆家,老公的妹妹穿的比我還像新娘犹菇。我一直安慰自己,他們只是感情好芽卿,可當(dāng)我...
    茶點(diǎn)故事閱讀 64,384評論 5 374
  • 文/花漫 我一把揭開白布揭芍。 她就那樣靜靜地躺著,像睡著了一般卸例。 火紅的嫁衣襯著肌膚如雪称杨。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 49,111評論 1 285
  • 那天筷转,我揣著相機(jī)與錄音姑原,去河邊找鬼。 笑死呜舒,一個胖子當(dāng)著我的面吹牛锭汛,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播袭蝗,決...
    沈念sama閱讀 38,416評論 3 400
  • 文/蒼蘭香墨 我猛地睜開眼唤殴,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了到腥?” 一聲冷哼從身側(cè)響起朵逝,我...
    開封第一講書人閱讀 37,053評論 0 259
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎乡范,沒想到半個月后配名,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體啤咽,經(jīng)...
    沈念sama閱讀 43,558評論 1 300
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 36,007評論 2 325
  • 正文 我和宋清朗相戀三年段誊,在試婚紗的時候發(fā)現(xiàn)自己被綠了闰蚕。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 38,117評論 1 334
  • 序言:一個原本活蹦亂跳的男人離奇死亡连舍,死狀恐怖没陡,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情索赏,我是刑警寧澤盼玄,帶...
    沈念sama閱讀 33,756評論 4 324
  • 正文 年R本政府宣布,位于F島的核電站潜腻,受9級特大地震影響埃儿,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜融涣,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 39,324評論 3 307
  • 文/蒙蒙 一童番、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧威鹿,春花似錦剃斧、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,315評論 0 19
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至科雳,卻和暖如春根蟹,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背糟秘。 一陣腳步聲響...
    開封第一講書人閱讀 31,539評論 1 262
  • 我被黑心中介騙來泰國打工简逮, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人尿赚。 一個月前我還...
    沈念sama閱讀 45,578評論 2 355
  • 正文 我出身青樓买决,卻偏偏與公主長得像,于是被迫代替她去往敵國和親吼畏。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 42,877評論 2 345

推薦閱讀更多精彩內(nèi)容