48 KiB
3.0.0-alpha.12 (2020-04-08)
Bug Fixes
- compiler: should not condense
(8c17535), closes #945 - compiler: should only strip leading newline directly in pre tag (be666eb)
- compiler: support full range of entity decoding in browser builds (1f6e72b)
- compiler-core: elements with dynamic keys should be forced into blocks (d531686), closes #916
- reactivity: track reactive keys in raw collection types (5dcc645), closes #919
- runtime-core: fix globalProperties in check on instance render proxy (c28a919)
- runtime-core: set fragment root children should also update dynamicChildren (#944) (a27e9ee), closes #943
- runtime-dom: fix getModelAssigner order in vModelCheckbox (#926) (da1fb7a)
- runtime-dom: support native onxxx handlers (2302dea), closes #927
- slots: should update compiled dynamic slots (8444078)
- transition: fix dynamic transition update on nested HOCs (b8da8b2)
- transition: should ship props declarations in production (4227831)
- types: accept generic Component type in h() (c1d5928), closes #922
- v-model: handle dynamic assigners and array assigners (f42d11e), closes #923
Features
- asyncComponent: add
onError
option for defineAsyncComponent (e804463) - runtime-core: improve component public instance proxy inspection (899287a)
BREAKING CHANGES
- compiler: compiler options have been adjusted.
- new option
decodeEntities
is added. namedCharacterReferences
option has been removed.maxCRNameLength
option has been removed.
- new option
- asyncComponent:
retryWhen
andmaxRetries
options fordefineAsyncComponent
has been replaced by the more flexibleonError
option, per https://github.com/vuejs/rfcs/pull/148
3.0.0-alpha.11 (2020-04-04)
Bug Fixes
- compiler: fix pre tag whitespace handling (7f30cb5), closes #908
- compiler-core/slots: should support on-component named slots (a022b63)
- compiler-sfc: always use offset for template block sourcemaps (#911) (db50009)
- inject: allow default value to be
undefined
(#894) (94562da), closes #892 - portal: portal should always remove its children when unmounted (16cd8ee)
- reactivity: scheduled effect should not execute if stopped (0764c33), closes #910
- runtime-core: support attr merging on child with root level comments (e42cb54), closes #904
- runtime-dom: v-cloak should be removed after compile on the root element (#893) (0ed147d), closes #890
- runtime-dom: properly support creating customized built-in element (b1d0b04)
- transition: warn only when there is more than one rendered child (#903) (37b1dc8)
- types: allow use PropType with Function (#915) (026eb72), closes #748
- types: export missing types from runtime-core (#889) (412ec86)
- types/reactivity: add generics constraint for markNonReactive (f3b6559), closes #917
Code Refactoring
- runtime-core: adjust attr fallthrough behavior (21bcdec)
- rename
<portal>
to<teleport>
(eee5095) - runtime-core: rename
createAsyncComponent
todefineAsyncComponent
(#888) (ebc5873)
Features
- asyncComponent: retry support (c01930e)
- compiler-core: export
transformElement
from compiler-core (#907) (20f4965) - compiler-core: support v-is (b8ffbff)
- portal: hydration support for portal disabled mode (b74bab2)
- portal: SSR support for multi portal shared target (e866434)
- portal: SSR support for portal disabled prop (9ed9bf3)
- portal: support disabled prop (8ce3da0)
- portal: support multiple portal appending to same target (aafb880)
- reactivity: add effect to public api (#909) (6fba241)
- runtime-core: config.performance tracing support (e93e426)
- runtime-core: emits validation and warnings (c7c3a6a)
- runtime-core: failed component resolution should fallback to native element (cb31eb4)
- runtime-core: support app.config.globalProperties (27873db)
- runtime-core: type and attr fallthrough support for emits option (bf473a6)
- templateRef: should work with direct reactive property (449ab03), closes #901
- templateRef: support template ref for all vnode types (55b364d)
BREAKING CHANGES
-
runtime-core: attribute fallthrough behavior has been adjusted according to https://github.com/vuejs/rfcs/pull/154
-
<portal>
has been renamed to<teleport>
.target
prop is also renamed toto
, so the new usage will be:<Teleport to="#modal-layer" :disabled="isMobile"> <div class="modal"> hello </div> </Teleport>
The primary reason for the renaming is to avoid potential naming conflict with native portals.
-
asyncComponent: async component
error
andloading
options have been renamed toerrorComponent
andloadingComponent
respectively. -
runtime-core:
createAsyncComponent
has been renamed todefineAsyncComponent
for consistency withdefineComponent
.
3.0.0-alpha.10 (2020-03-24)
Bug Fixes
- fix option merge global mixins presence check (10ad965)
- compiler-core: assign patchFlag for template v-if fragment (a1da9c2), closes #850
- compiler-core: support interpolation in RCDATA mode (e.g. textarea) (0831b98)
- keep-alive: should update re-activated component with latest props (1237387)
- reactivity: should not observe frozen objects (1b2149d), closes #867
- reactivity: should not trigger map keys iteration when keys did not change (45ba06a), closes #877
- runtime-core: fix boolean props validation (3b282e7)
- runtime-dom: invalid lineGradient svg tag (#863) (d425818), closes #862
- TransitionGroup: ignore comment node when warn (fix#869) (#875) (0dba5d4)
- do not drop SFC runtime behavior code in global builds (4c1a193), closes #873
- dynamic component fallback to native element (f529dbd), closes #870
- runtime-core: fix component proxy props presence check (b3890a9), closes #864
- suspense: clear effects on suspense resolve (ebc1ca8)
- transition: fix duration prop validation (0dc2478), closes #868
Features
- asyncComponent: SSR/hydration support for async component (cba2f1a)
- runtime-core: async component support (c3bb316)
- runtime-core: support
config.optionMergeStrategies
(528621b) - add hook for transforming h's arguments (#851) (b7d1e0f)
Performance Improvements
3.0.0-alpha.9 (2020-03-16)
Bug Fixes
- build: remove RUNTIME_COMPILE flag (206640a), closes #817
- compiler-core: fix property shorthand detection (586e5bb), closes #845
- compiler-ssr: fix input w/ v-bind="obj" codegen (3b40fc5)
- compiler-ssr: should pass necessary tag names for dynamic v-bind (a46f3b3)
- runtime-core: always set invalid vnode type (#820) (28a9bee)
- runtime-core: empty boolean props (#844) (c7ae269), closes #843
- runtime-core: pass instance proxy as data() argument (#828) (d9dd1d8)
- runtime-dom: patch xlink attribute (#842) (d318576)
- simplify and use correct ctx in withCtx (4dc8ffc)
- runtime-core: pass prev value to hostPatchProp (#809) (cd34603), closes #808
- runtime-core: should allow empty string and 0 as valid vnode key (#807) (54a0e93)
- types: app.component should accept defineComponent return type (#822) (1e9d131), closes #730
Code Refactoring
- runtime-core: adjust patchProp value arguments order (ca5f39e)
Features
- compiler-core: wrap slot functions with render context (ecd7ce6)
- compiler-sfc: add ssr option (3b2d236)
- runtime-core: add special property to get class component options (#821) (dd17fa1)
- runtime-core: implement RFC-0020 (bb7fa3d)
- runtime-core: set context for manual slot functions as well (8a58dce)
- server-renderer: render suspense in vnode mode (#727) (589aeb4)
- ssr: compiler-ssr support for Suspense (80c625d)
- ssr: hide comment anchors during hydration in dev mode (cad5bcc)
- ssr: improve fragment mismatch handling (60ed4e7)
- ssr: support getSSRProps for vnode directives (c450ede)
- ssr/suspense: suspense hydration (a3cc970)
- types: export
ErrorTypes
(#840) (760c3e0)
Reverts
- Revert "refactor(directives): remove binding.instance" (2370166)
BREAKING CHANGES
-
runtime-core: data no longer supports object format (per RFC-0020)
-
runtime-core:
RendererOptions.patchProp
arguments order has changedThe
prevValue
andnextValue
position has been swapped to keep it consistent with other functions in the renderer implementation. This only affects custom renderers using thecreateRenderer
API.
3.0.0-alpha.8 (2020-03-06)
Bug Fixes
- directives: ignore invalid directive hooks (7971b04), closes #795
- portal: fix portal placeholder text (4397528)
- reactivity: allow effect trigger inside no-track execution contexts (274f81c), closes #804
- reactivity: Map/Set identity methods should work even if raw value contains reactive entries (cc69fd7), closes #799
- reactivity: should not trigger length dependency on Array delete (a306658), closes #774
- runtime-core: ensure inhertied attrs update on optimized child root (6810d14), closes #677 #784
- slots: fix conditional slot (3357ff4), closes #787
- ssr: fix ssr on-the-fly compilation + slot fallback branch helper injection (3be3785)
Code Refactoring
- runtime-core: adjust attr fallthrough behavior (e1660f4), closes #749
- runtime-core: revert setup() result reactive conversion (e67f655)
Features
- compiler-core: switch to @babel/parser for expression parsing (8449a97)
- compiler-ssr: compile portal (#775) (d8ed0e7)
- ssr: hydration mismatch handling (91269da)
BREAKING CHANGES
-
runtime-core: adjust attr fallthrough behavior
Updated per pending RFC https://github.com/vuejs/rfcs/pull/137
-
Implicit fallthrough now by default only applies for a whitelist of attributes (class, style, event listeners, a11y attributes, and data attributes).
-
Fallthrough is now applied regardless of whether the component has
-
-
runtime-core: revert setup() result reactive conversion
Revert
6b10f0c
&a840e7d
. The motivation of the original change was avoiding unnecessary deep conversions, but that can be achieved by explicitly marking values non-reactive viamarkNonReactive
.Removing the reactive conversion behavior leads to an usability issue in that plain objects containing refs (which is what most composition functions will return), when exposed as a nested property from
setup()
, will not unwrap the refs in templates. This goes against the "no .value in template" intuition and the only workaround requires users to manually wrap it again withreactive()
.So in this commit we are reverting to the previous behavior where objects returned from
setup()
are implicitly wrapped withreactive()
for deep ref unwrapping.
3.0.0-alpha.7 (2020-02-26)
Bug Fixes
- renderSlot: set slot render as a STABLE_FRAGMENT (#776) (8cb0b83), closes #766
- runtime-core: fix slot fallback + slots typing (4a5b91b), closes #773
- runtime-core: make watchEffect ignore deep option (#765) (19a799c)
- runtime-core: set appContext.provides to Object.create(null) (#781) (04f83fa)
- template-explorer: rename watch -> watchEffect (#780) (59393dd)
- template-ref: fix string template refs inside slots (3eab143)
- types: ref value type unwrapping should happen at creation time (d4c6957)
- types: shallowRef should not unwrap value type (3206e5d)
Code Refactoring
- directives: remove binding.instance (52cc7e8)
BREAKING CHANGES
-
directives: custom directive bindings no longer expose instance
This is a rarely used property that creates extra complexity in ensuring it points to the correct instance. From a design perspective, a custom directive should be scoped to the element and data it is bound to and should not have access to the entire instance in the first place.
3.0.0-alpha.6 (2020-02-22)
Bug Fixes
- compiler-core: should alias name in helperString (#743) (7b987d9), closes #740
- compiler-dom: properly stringify class/style bindings when hoisting static strings (1b9b235)
- reactivity: should trigger all effects when array length is mutated (#754) (5fac655)
- sfc: inherit parent scopeId on child root (#756) (9547c2b)
- types: improve ref typing, close #759 (627b9df)
- types: update setup binding unwrap types for
6b10f0c
(a840e7d), closes #738
Code Refactoring
Features
Performance Improvements
- effect: optimize effect trigger for array length mutation (#761) (76c7f54)
- reactivity: only trigger all effects on Array length mutation if new length is shorter than old length (33622d6)
BREAKING CHANGES
-
runtime-core: replace
watch(fn, options?)
withwatchEffect
The
watch(fn, options?)
signature has been replaced by the newwatchEffect
API, which has the same usage and behavior.watch
now only supports thewatch(source, cb, options?)
signature. -
reactivity: reactive arrays no longer unwraps contained refs
When reactive arrays contain refs, especially a mix of refs and plain values, Array prototype methods will fail to function properly - e.g. sort() or reverse() will overwrite the ref's value instead of moving it (see #737).
Ensuring correct behavior for all possible Array methods while retaining the ref unwrapping behavior is exceedingly complicated; In addition, even if Vue handles the built-in methods internally, it would still break when the user attempts to use a 3rd party utility function (e.g. lodash) on a reactive array containing refs.
After this commit, similar to other collection types like Map and Set, Arrays will no longer automatically unwrap contained refs.
The usage of mixed refs and plain values in Arrays should be rare in practice. In cases where this is necessary, the user can create a computed property that performs the unwrapping.
3.0.0-alpha.5 (2020-02-18)
Bug Fixes
- compiler: fix v-for fragment openBlock argument (12fcf9a)
- compiler-core: fix keep-alive when used in templates (ade07c6), closes #715
- compiler-core: only check is prop on
<component>
(78c4f32) - compiler-core: relax error on unknown entities (730d329), closes #663
- compiler-core: should apply text transform to if branches (e0f3c6b), closes #725
- compiler-core: should not hoist element with cached + merged event handlers (5455e8e)
- compiler-dom: fix duplicated transforms (9e51297)
- compiler-sfc: handle empty nodes with src attribute (#695) (2d56dfd)
- compiler-ssr: import helpers from correct packages (8f6b669)
- computed: support arrow function usage for computed option (2fb7a63), closes #733
- reactivity: avoid cross-component dependency leaks in setup() (d9d63f2)
- reactivity: effect should handle self dependency mutations (e8e6772)
- reactivity: trigger iteration effect on Map.set (e1c9153), closes #709
- runtime-core: ensure renderCache always exists (8383e54)
- runtime-core: fix keep-alive tree-shaking (5b43764)
- runtime-core: fix ShapeFlags tree shaking (0f67aa7)
- runtime-core: handle component updates with only class/style bindings (35d91f4)
- runtime-core: render context set should not unwrap reactive values (27fbfbd)
- runtime-core: rework vnode hooks handling (cfadb98), closes #684
- runtime-core: should not return early on text patchFlag (778f3a5)
- runtime-core/scheduler: avoid duplicate updates of child component (8a87074)
- runtime-core/scheduler: invalidate job (#717) (fe9da2d)
- runtime-core/watch: trigger watcher with undefined as initial value (#687) (5742a0b), closes #683
- runtime-dom/ssr: properly handle xlink and boolean attributes (e6e2c58)
- ssr: avoid hard-coded ssr checks in cjs builds (bc07e95)
- ssr: fix class/style rendering + ssrRenderComponent export name (688ad92)
- ssr: render components returning render function from setup (#720) (4669215)
- transition-group: handle multiple move-classes (#679) (5495c70), closes #678
- types: app.component should accept defineComponent return type (57ee5df), closes #730
- types: ensure correct oldValue typing based on lazy option (c6a9787), closes #719
- v-on: transform click.right and click.middle modifiers (028f748), closes #735
- remove effect from public API (4bc4cb9), closes #712
- v-model: should use dynamic directive on input with dynamic v-bind (1f2de9e)
Code Refactoring
- watch: adjust watch API behavior (9571ede)
Features
- compiler: mark hoisted trees with patchFlag (175f8aa)
- compiler: warn invalid children for transition and keep-alive (4cc39e1)
- compiler-core: support mode: cjs in codegen (04da2a8)
- compiler-core/v-on: support @vnode-xxx usage for vnode hooks (571ed42)
- compiler-dom: handle constant expressions when stringifying static content (8b7c162)
- compiler-dom/runtime-dom: stringify eligible static trees (27913e6)
- reactivity: add shallowReactive function (#689) (7f38c1e)
- runtime-core/reactivity: expose shallowReactive (#711) (21944c4)
- server-renderer: support on-the-fly template compilation (#707) (6d10a6c)
- ssr: render portals (#714) (e495fa4)
- ssr: support portal hydration (70dc3e3)
- ssr: useSSRContext (fd03149)
Performance Improvements
- prevent renderer hot functions being inlined by minifiers (629ee75)
- reactivity: better computed tracking (#710) (8874b21)
BREAKING CHANGES
-
watch:
watch
behavior has been adjusted.-
When using the
watch(source, callback, options?)
signature, the callback now fires lazily by default (consistent with 2.x behavior).Note that the
watch(effect, options?)
signature is still eager, since it must invoke theeffect
immediately to collect dependencies. -
The
lazy
option has been replaced by the oppositeimmediate
option, which defaults tofalse
. (It's ignored when using the effect signature) -
Due to the above changes, the
watch
option in Options API now behaves exactly the same as 2.x. -
When using the effect signature or
{ immediate: true }
, the initial execution is now performed synchronously instead of deferred until the component is mounted. This is necessary for certain use cases to work properly withasync setup()
and Suspense.The side effect of this is the immediate watcher invocation will no longer have access to the mounted DOM. However, the watcher can be initiated inside
onMounted
to retain previous behavior.
-
3.0.0-alpha.4 (2020-01-27)
Bug Fixes
- reactivity: Array methods relying on identity should work with raw values (aefb7d2)
- runtime-core: instance should not expose non-declared props (2884831)
- runtime-dom: should not access document in non-browser env (48152bc), closes #657
- v-model/emit: update:camelCase events should trigger kebab case equivalent (2837ce8), closes #656
Code Refactoring
- adjust
createApp
related API signatures (c07751f) - remove implicit reactive() call on renderContext (6b10f0c)
Performance Improvements
- ssr: avoid unnecessary async overhead (297282a)
BREAKING CHANGES
-
object returned from
setup()
are no longer implicitly passed toreactive()
.The renderContext is the object returned by
setup()
(or a new object if no setup() is present). Before this change, it was implicitly passed toreactive()
for ref unwrapping. But this has the side effect of unnecessary deep reactive conversion on properties that should not be made reactive (e.g. computed return values and injected non-reactive objects), and can lead to performance issues.This change removes the
reactive()
call and instead performs a shallow ref unwrapping at the render proxy level. The breaking part is when the user returns an object with a plain property fromsetup()
, e.g.return { count: 0 }
, this property will no longer trigger updates when mutated by a in-template event handler. Instead, explicit refs are required.This also means that any objects not explicitly made reactive in
setup()
will remain non-reactive. This can be desirable when exposing heavy external stateful objects onthis
. -
createApp
API has been adjusted.createApp()
now accepts the root component, and optionally a props object to pass to the root component.app.mount()
now accepts a single argument (the root container)app.unmount()
no longer requires arguments.
New behavior looks like the following:
const app = createApp(RootComponent) app.mount('#app') app.unmount()
3.0.0-alpha.3 (2020-01-22)
Bug Fixes
- Suspense should include into dynamic children (#653) (ec63623), closes #649
- compiler-core: avoid override user keys when injecting branch key (#630) (aca2c2a)
- compiler-core: force
<svg>
into blocks for correct runtime isSVG (f2ac28b) - compiler-sfc: only transform relative asset URLs (#628) (c71ca35)
- dom: fix
<svg>
and<foreignObject>
mount and updates (4f06eeb) - runtime-core: condition for parent node check should be any different nodes (c35fea3), closes #622
- runtime-core: isSVG check should also apply for patch branch (035b656), closes #639
- runtime-core: should not warn unused attrs when accessed via setup context (751d838), closes #625
- transition: handle multiple transition classes (#638) (#645) (98d50d8)
Features
- runtime-core: emit now returns array of return values from all triggered handlers (e81c8a3), closes #635
- runtime-core: support app.unmount(container) (#601) (04ac6c4), closes #593
3.0.0-alpha.2 (2020-01-13)
Bug Fixes
- compiler/v-on: handle multiple statements in v-on handler (close #572) (137893a)
- compiler/v-slot: handle implicit default slot mixed with named slots (2ac4b72)
- reactivity: should delete observe value (#598) (63a6563), closes #597
- runtime-core: allow classes to be passed as plugins (#588) (8f616a8)
- runtime-core: should preserve props casing when component has no declared props (bb6a346), closes #583
- runtime-core/renderer: fix v-if toggle inside blocks (2e9726e), closes #604 #607
- runtime-core/vnode: should not render boolean values in vnode children (close #574) (84dc5a6)
- types: components options should accept components defined with defineComponent (#602) (74baea1)
- watch: remove recorded effect on manual stop (#590) (453e688)
3.0.0-alpha.1 (2020-01-02)
Bug Fixes
- runtime-core: pass options to plugins (#561) (4d20981)
- sfc: treat custom block content as raw text (d6275a3)
- mounting new children (7d436ab)
- core: clone mounted hoisted vnodes on patch (47a6a84)
- fragment: perform direct remove when removing fragments (2fdb499)
Features
- hmr: root instance reload (eda495e)
Performance Improvements
3.0.0-alpha.0 (2019-12-20)
For changes between 2.x and 3.0 up to this release, please refer to merged RFCs here.