3.2 updates #1157

yyx990803 · 2021-08-03T21:56:56Z

Added dedicated API pages for SFC spec, tooling & features
Added "Vue and Web Components" section
various 3.2 features

- Updated Single File Components guide section - Added dedicated SFC spec & tooling sections in API references - Added dedicated API references for `<script setup>` and `<style>` features

src/api/sfc-tooling.md

src/api/sfc-script-setup.md

posva · 2021-08-04T08:40:46Z

src/api/sfc-script-setup.md

+
+  - In dev mode, the compiler will try to infer corresponding runtime validation from the types. For example here `foo: String` is inferred from the `foo: string` type. If the type is a reference to an imported type, the inferred result will be `foo: null` (equal to `any` type) since the compiler does not have information of external files.
+
+  - In prod mode, the compiler will generate the array format declaration to reduce bundle size (the props here will be compiled into `['msg']`)


I didn't know this! 🔥

NataliaTepluhina

@yyx990803 great work! I've added a bunch of minor nitpicks here and there

src/api/computed-watch-api.md

src/api/directives.md

NataliaTepluhina · 2021-08-04T08:26:55Z

src/api/effect-scope.md

+# Effect Scope API <Badge text="3.2+" />
+
+:::info
+Effect scope is an advanced API primarily intended for library authors. For details on how to leverage this API, please consult its corresponding [RFC](https://github.com/vuejs/rfcs/blob/master/active-rfcs/0041-reactivity-effect-scope.md).


@yyx990803 should we eventually move the RFC to the Guide section of the docs? Definitely not the scope of the current PR but we can create a follow-up after 3.2 is released

Maybe. I want to think about where it should be fit into the doc structure though, maybe a section for "advanced reactivity patterns".

src/api/sfc-script-setup.md

src/api/sfc-spec.md

src/api/sfc-style.md

src/api/sfc-tooling.md

Co-authored-by: Natalia Tepluhina <[email protected]> Co-authored-by: Adrià Fontcuberta <[email protected]> Co-authored-by: Eduardo San Martin Morote <[email protected]>

src/api/sfc-style.md

src/api/directives.md

src/api/global-api.md

src/api/sfc-script-setup.md

src/api/sfc-spec.md

src/api/sfc-style.md

src/guide/single-file-component.md

src/guide/web-components.md

src/api/sfc-script-setup.md

Co-authored-by: Eduardo San Martin Morote <[email protected]> Co-authored-by: Jeff Yang <[email protected]>

skirtles-code

Some suggested tweaks from me. Let me know if anything I've suggested needs clarification.

src/api/directives.md

src/api/sfc-script-setup.md

src/guide/web-components.md

src/api/directives.md

src/api/effect-scope.md

Co-authored-by: skirtle <[email protected]> Co-authored-by: Jeff Yang <[email protected]>

bencodezen · 2021-08-07T12:21:48Z

@yyx990803 Should this PR be targeting next rather than master?

yyx990803 · 2021-08-09T13:46:18Z

@bencodezen this should land on master since we are releasing 3.2 before we finish the new design. We will rebase next to include this.

yyx990803 added 7 commits August 2, 2021 17:01

update and improve SFC documentation with 3.2 features

4a95d84

- Updated Single File Components guide section - Added dedicated SFC spec & tooling sections in API references - Added dedicated API references for `<script setup>` and `<style>` features

vue and web components

b55bd00

update intro section on web components

2fe150d

document v-memo

7b25e89

watchEffect alises + computed debugger options

a747c66

v-bind .prop & .attr modifiers

8c7cabe

effectScope

373d3cd

github-actions bot added the review-alert-box label Aug 3, 2021

afontcu reviewed Aug 4, 2021

View reviewed changes

src/api/sfc-tooling.md Show resolved Hide resolved

src/api/sfc-tooling.md Outdated Show resolved Hide resolved

src/api/sfc-script-setup.md Outdated Show resolved Hide resolved

posva reviewed Aug 4, 2021

View reviewed changes

src/api/sfc-script-setup.md Outdated Show resolved Hide resolved

posva reviewed Aug 4, 2021

View reviewed changes

NataliaTepluhina reviewed Aug 4, 2021

View reviewed changes

posva reviewed Aug 4, 2021

View reviewed changes

src/api/sfc-style.md Outdated Show resolved Hide resolved

posva reviewed Aug 4, 2021

View reviewed changes

src/api/sfc-tooling.md Outdated Show resolved Hide resolved

posva reviewed Aug 4, 2021

View reviewed changes

src/api/sfc-tooling.md Outdated Show resolved Hide resolved

kazupon reviewed Aug 4, 2021

View reviewed changes

src/api/sfc-tooling.md Outdated Show resolved Hide resolved

Apply suggestions from code review

8ff23c7

Co-authored-by: Natalia Tepluhina <[email protected]> Co-authored-by: Adrià Fontcuberta <[email protected]> Co-authored-by: Eduardo San Martin Morote <[email protected]>

yyx990803 commented Aug 4, 2021

View reviewed changes

src/api/sfc-style.md Outdated Show resolved Hide resolved

yyx990803 added 2 commits August 4, 2021 09:20

Update src/api/sfc-style.md

4573adc

add custom block examples

a4cf142

posva reviewed Aug 4, 2021

View reviewed changes

src/api/directives.md Outdated Show resolved Hide resolved

ydcjeff reviewed Aug 4, 2021

View reviewed changes

yyx990803 and others added 3 commits August 4, 2021 17:23

improve computed type signature

e71274b

Apply suggestions from code review

d337d21

Co-authored-by: Eduardo San Martin Morote <[email protected]> Co-authored-by: Jeff Yang <[email protected]>

use vue codeblock

55505e7

skirtles-code reviewed Aug 5, 2021

View reviewed changes

Oleksii14 reviewed Aug 5, 2021

View reviewed changes

src/api/effect-scope.md Show resolved Hide resolved

yyx990803 and others added 3 commits August 5, 2021 18:56

Apply suggestions from code review

4a37fe0

Co-authored-by: skirtle <[email protected]> Co-authored-by: Jeff Yang <[email protected]>

more updates per feedback

cf83e29

more explicit computed debugger option example

8614424

update sfc custom element usage

ff3e222

yyx990803 force-pushed the 3.2 branch from 7fe57bf to ff3e222 Compare August 7, 2021 01:29

yyx990803 added 2 commits August 9, 2021 10:41

document sfc namedspaced components

2ad63ec

add warning for v-memo + v-for usage

f1a3a27

yyx990803 merged commit 9d759d9 into master Aug 9, 2021

yyx990803 deleted the 3.2 branch August 9, 2021 19:54

yyx990803 added a commit that referenced this pull request Aug 11, 2021

3.2 updates (#1157)

4b554c5

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

3.2 updates #1157

3.2 updates #1157

yyx990803 commented Aug 3, 2021

posva Aug 4, 2021

NataliaTepluhina left a comment

NataliaTepluhina Aug 4, 2021

yyx990803 Aug 4, 2021

skirtles-code left a comment

bencodezen commented Aug 7, 2021

yyx990803 commented Aug 9, 2021 •

edited

Loading


		- In dev mode, the compiler will try to infer corresponding runtime validation from the types. For example here `foo: String` is inferred from the `foo: string` type. If the type is a reference to an imported type, the inferred result will be `foo: null` (equal to `any` type) since the compiler does not have information of external files.

		- In prod mode, the compiler will generate the array format declaration to reduce bundle size (the props here will be compiled into `['msg']`)

3.2 updates #1157

3.2 updates #1157

Conversation

yyx990803 commented Aug 3, 2021

posva Aug 4, 2021

Choose a reason for hiding this comment

NataliaTepluhina left a comment

Choose a reason for hiding this comment

NataliaTepluhina Aug 4, 2021

Choose a reason for hiding this comment

yyx990803 Aug 4, 2021

Choose a reason for hiding this comment

skirtles-code left a comment

Choose a reason for hiding this comment

bencodezen commented Aug 7, 2021

yyx990803 commented Aug 9, 2021 • edited Loading

yyx990803 commented Aug 9, 2021 •

edited

Loading