Migration to Vue 3 Guide

[bencodezen]

The following contains a list of all remaining sections of the migration guide to complete.

Legend

In terms of what the styling means:

• means this has been PR'd and merged
• Bolded means that this is still an item to do
• Normal text with a PR at the end means it's currently in review

Critical

• RFC #19: Global API Treeshaking - PR #144
  • RFC #29: Global mounting / configuration - PR #125
  • RFC #117: Global API updates - PR #125
• RFC #8: Replace v-bind sync with v-model - PR #143

High

• RFC #27: Functional and async components API change - PR #135
  • RFC #148: New Async Component API - PR #139
• RFC #31: Component v-model API change - PR #143
• RFC #154: Attribute fallthrough + functional component updates - PR #141

Medium

• RFC #32: Custom Directive API change - PR #146
• RFC #105: transition API changes - Issue #138
• RFC #118: Remove instance events methods (API removal) - PR #167
• RFC #126: Attribute coercion behavior change - PR #149
• RFC #149: Custom Elements Interop Improvements - PR #177
• RFC #20: Slots Unification - PR #159
• RFC #28: Render function API change and library authors - PR #160

Low

• RFC #95: Remove keycode support in v-on - PR #158
• RFC #97: Remove filters (API removal) - PR #164
• RFC #98: Remove inline-template (API removal) - PR #183
• RFC #111: Remove data object declaration (API removal) - PR #165

New Features

• RFC #78 Composition API - PR #161
• RFC #112 Teleport - PR #161
• RFC #16: Add "emits" component option - PR #161
• Custom Renderer API - PR #161
• Fragments - PR #163

[haoqunjiang]

https://github.com/vuejs/vue-codemod#migrating-from-vue-2-to-vue-3 can be used as a starting point.

[jacekkarczmarczyk]

Not sure if this is the best place to comment but FAQ links to migration helper which looks quite outdated

[NataliaTepluhina]

@jacekkarczmarczyk we will change the link to new migration helper as soon as we have it 😄

[ota-meshi]

Hi!
Not included in the RFC, but need to write a migration guide for lifecycle hook changes?

• Removed beforeDestroy and destroyed
• Added beforeUnmount and unmounted

[xPaw]

There should be a section about watch no longer accepting dot-eliminated path strings. vuejs/core#671 (comment)

[posva]

I think it's worth documenting the removal of $parent (and $children) as well vuejs/core#2044 (comment)

[NataliaTepluhina]

Closing this issue as transition API changes were added to docs and linked on Migration Guide - Introduction via 5d02aad