2.7.16 Swan Song (2023-12-24)

Bug Fixes

2.7.16-beta.2 (2023-12-14)

Bug Fixes

2.7.16-beta.1 (2023-12-08)

Bug Fixes

2.7.15 (2023-10-23)

Bug Fixes

2.7.14 (2022-11-09)

Bug Fixes

2.7.13 (2022-10-14)

Bug Fixes

2.7.12 (2022-10-12)

Reverts

2.7.11 (2022-10-11)

Bug Fixes

Performance Improvements

2.7.10 (2022-08-23)

Bug Fixes

2.7.9 (2022-08-19)

Bug Fixes

Features

2.7.8 (2022-07-22)

Bug Fixes

Features

2.7.7 (2022-07-16)

Bug Fixes

2.7.6 (2022-07-15)

Bug Fixes

2.7.5 (2022-07-13)

Bug Fixes

2.7.4 (2022-07-08)

Bug Fixes

Features

2.7.3 (2022-07-06)

Bug Fixes

2.7.2 (2022-07-05)

Bug Fixes

Features

2.7.1 (2022-07-04)

Bug Fixes

2.7.0 (2022-07-01)

Backported Features

In addition, the following APIs are also supported:

Notes on API exposure

Behavior Differences from Vue 3

The Composition API is backported using Vue 2's getter/setter-based reactivity system to ensure browser compatibility. This means there are some important behavior differences from Vue 3's proxy-based system:

In addition, the following features are explicitly NOT ported:

TypeScript Changes

Upgrade Guide

Vue CLI / webpack

  1. Upgrade local @vue/cli-xxx dependencies the latest version in your major version range (if applicable):

    • ~4.5.18 for v4
    • ~5.0.6 for v5
  2. Upgrade vue to ^2.7.0. You can also remove vue-template-compiler from the dependencies - it is no longer needed in 2.7.

    Note: if you are using @vue/test-utils, you may need to keep it in the dependencies for now, but this requirement will also be lifted in a new release of test utils.

  3. Check your package manager lockfile to ensure the following dependencies meet the version requirements. They may be transitive dependencies not listed in package.json.

    • vue-loader: ^15.10.0
    • vue-demi: ^0.13.1

    If not, you will need to remove node_modules and the lockfile and perform a fresh install to ensure they are bumped to the latest version.

  4. If you were previously using @vue/composition-api, update imports from it to vue instead. Note that some APIs exported by the plugin, e.g. createApp, are not ported in 2.7.

  5. Update eslint-plugin-vue to latest version (9+) if you run into unused variable lint errors when using <script setup>.

  6. The SFC compiler for 2.7 now uses PostCSS 8 (upgraded from 7). PostCSS 8 should be backwards compatible with most plugins, but the upgrade may cause issues if you were previously using a custom PostCSS plugin that can only work with PostCSS 7. In such cases, you will need to upgrade the relevant plugins to their PostCSS 8 compatible versions.

Vite

2.7 support for Vite is provided via a new plugin: @vitejs/plugin-vue2. This new plugin requires Vue 2.7 or above and supersedes the existing vite-plugin-vue2.

Note that the new plugin does not handle Vue-specific JSX / TSX transform, which is intentional. Vue 2 JSX / TSX transform should be handled in a separate, dedicated plugin, which will be provided soon.

Volar Compatibility

2.7 ships improved type definitions so it is no longer necessary to install @vue/runtime-dom just for Volar template type inference support. All you need now is the following config in tsconfig.json:

{
  // ...
  "vueCompilerOptions": {
    "target": 2.7
  }
}

Devtools Support

Vue Devtools 6.2.0 has added support for inspecting 2.7 Composition API state, but the extensions may still need a few days to go through review on respective publishing platforms.

Bug Fixes

2.7.0-beta.8 (2022-06-28)

Bug Fixes

2.7.0-beta.7 (2022-06-27)

Bug Fixes

2.7.0-beta.6 (2022-06-26)

Bug Fixes

2.7.0-beta.5 (2022-06-22)

Bug Fixes

2.7.0-beta.4 (2022-06-21)

Bug Fixes

2.7.0-beta.3 (2022-06-20)

Bug Fixes

Features

2.7.0-beta.2 (2022-06-17)

Bug Fixes

2.7.0-beta.1 (2022-06-17)

Bug Fixes

Features

2.7.0-alpha.12 (2022-06-16)

Features

2.7.0-alpha.11 (2022-06-16)

Bug Fixes

2.7.0-alpha.10 (2022-06-16)

Bug Fixes

Features

2.7.0-alpha.9 (2022-06-16)

Features

2.7.0-alpha.8 (2022-06-14)

Features

2.7.0-alpha.7 (2022-06-14)

2.7.0-alpha.6 (2022-06-09)

Features

2.7.0-alpha.5 (2022-06-06)

Bug Fixes

2.7.0-alpha.4 (2022-06-01)

Bug Fixes

Features

2.7.0-alpha.3 (2022-06-01)

2.7.0-alpha.2 (2022-06-01)

Features

2.7.0-alpha.1 (2022-05-31)

This release includes full Composition API support, including:

Behavior difference from Vue 3

Notes on API exposure

In addition:

Bug Fixes

Features

2.6.14 (2021-06-07)

Bug Fixes

Features

2.6.13 (2021-06-01)

Bug Fixes

Features

Performance Improvements

2.6.12 (2020-08-20)

Bug Fixes

2.6.11 (2019-12-13)

Bug Fixes

2.6.10 (2019-03-20)

Bug Fixes

2.6.9 (2019-03-14)

Bug Fixes

2.6.8 (2019-03-01)

Bug Fixes

2.6.7 (2019-02-21)

Bug Fixes

2.6.6 (2019-02-12)

Bug Fixes

2.6.5 (2019-02-11)

Bug Fixes

2.6.4 (2019-02-08)

Bug Fixes

Performance Improvements

2.6.3 (2019-02-06)

Bug Fixes

Reverts

2.6.2 (2019-02-05)

Bug Fixes

Features

2.6.1 (2019-02-04)

Bug Fixes

2.6.0 (2019-02-04)

Bug Fixes

Features

2.6.0-beta.3 (2019-01-30)

Features

2.6.0-beta.2 (2019-01-26)

Bug Fixes

Features

Performance Improvements

2.6.0-beta.1 (2019-01-16)

Bug Fixes

Features

2.5.22 (2019-01-11)

Bug Fixes

2.5.21 (2018-12-11)

Bug Fixes

Performance Improvements

Reverts

2.5.20 (2018-12-10)

Bug Fixes

2.5.19 (2018-12-09)

Bug Fixes

Reverts

2.5.18 (2018-12-07)

Bug Fixes

2.5.18-beta.0 (2018-12-02)

Bug Fixes

Features

Reverts

2.5.17-beta.0 (2018-03-23)

Bug Fixes

Performance Improvements

Reverts

2.5.16 (2018-03-13)

Bug Fixes

2.5.15 (2018-03-10)

Bug Fixes

2.5.14 (2018-03-09)

Bug Fixes

Features

2.5.13 (2017-12-19)

Reverts

2.5.12 (2017-12-19)

Bug Fixes

Features

Reverts

2.5.11 (2017-12-14)

Bug Fixes

Features

2.5.10 (2017-12-12)

Bug Fixes

2.5.9 (2017-11-27)

Bug Fixes

2.5.8 (2017-11-21)

Bug Fixes

2.5.7 (2017-11-20)

Bug Fixes

Features

2.5.6 (2017-11-18)

Bug Fixes

2.5.5 (2017-11-17)

Bug Fixes

Features

2.5.4 (2017-11-16)

Bug Fixes

Features

2.5.3 (2017-11-03)

Bug Fixes

2.5.2 (2017-10-13)

Bug Fixes

2.5.1 (2017-10-13)

Bug Fixes

2.5.0 (2017-10-13)

Bug Fixes

Features

Reverts

2.4.4 (2017-09-14)

Bug Fixes

2.4.3 (2017-09-13)

Bug Fixes

Features

Performance Improvements

2.4.2 (2017-07-21)

Bug Fixes

Features

Reverts

2.4.1 (2017-07-13)

2.4.0 (2017-07-13)

Bug Fixes

Features

Performance Improvements

2.3.3 (2017-05-09)

2.3.2 (2017-05-02)

2.3.1 (2017-05-02)

2.3.0 (2017-04-27)

2.3.0-beta.1 (2017-04-26)

2.2.6 (2017-03-27)

2.2.5 (2017-03-24)

Bug Fixes

2.2.4 (2017-03-13)

2.2.3 (2017-03-13)

2.2.2 (2017-03-09)

2.2.1 (2017-02-26)

2.2.0 (2017-02-26)

2.2.0-beta.2 (2017-02-25)

Reverts

2.2.0-beta.1 (2017-02-24)

Bug Fixes

Features

2.1.10 (2017-01-17)

2.1.9 (2017-01-16)

Reverts

2.1.8 (2016-12-28)

Reverts

2.1.7 (2016-12-24)

2.1.6 (2016-12-13)

2.1.5 (2016-12-13)

2.1.4 (2016-12-02)

2.1.3 (2016-11-24)

2.1.2 (2016-11-23)

2.1.1 (2016-11-23)

2.1.0 (2016-11-22)

2.0.8 (2016-11-20)

2.0.7 (2016-11-16)

2.0.6 (2016-11-15)

Reverts

2.0.5 (2016-11-05)

2.0.4 (2016-11-04)

2.0.3 (2016-10-13)

2.0.2 (2016-10-12)

Reverts

2.0.1 (2016-09-30)

2.0.0 (2016-09-30)

2.0.0-rc.8 (2016-09-27)

2.0.0-rc.7 (2016-09-23)

2.0.0-rc.6 (2016-09-13)

2.0.0-rc.5 (2016-09-08)

2.0.0-rc.4 (2016-08-29)

2.0.0-rc.3 (2016-08-20)

2.0.0-rc.2 (2016-08-16)

Reverts

2.0.0-rc.1 (2016-08-11)

2.0.0-beta.8 (2016-08-10)

2.0.0-beta.7 (2016-08-05)

2.0.0-beta.6 (2016-08-01)

2.0.0-beta.5 (2016-07-27)

Reverts

2.0.0-beta.4 (2016-07-26)

2.0.0-beta.3 (2016-07-24)

2.0.0-beta.2 (2016-07-17)

2.0.0-beta.1 (2016-07-07)

2.0.0-alpha.8 (2016-06-28)

2.0.0-alpha.7 (2016-06-28)

2.0.0-alpha.6 (2016-06-22)

2.0.0-alpha.5 (2016-06-17)

2.0.0-alpha.4 (2016-06-16)

2.0.0-alpha.3 (2016-06-15)

2.0.0-alpha.2 (2016-06-13)

2.0.0-alpha.1 (2016-06-10)

Reverts