Skip to content

docs: document patterned templates (RFC 823) - #3465

Draft
ubugeeei wants to merge 3 commits into
vuejs:mainfrom
ubugeeei:feat/patterned-templates-reference
Draft

ubugeeei wants to merge 3 commits into
vuejs:mainfrom
ubugeeei:feat/patterned-templates-reference

Conversation

@ubugeeei

@ubugeeei ubugeeei commented Sep 16, 2026

Copy link
Copy Markdown
Member

Description of Problem

RFC 823 needs documentation for its patterned-template reference implementation.

Proposed Solution

Add a guide beside conditional rendering and API entries for v-match and v-when. Explain patterns, branch-local bindings, rest, guards, narrowing, exhaustiveness errors and unreachable-arm warnings, with examples.

The guide and API entries identify the syntax as a Draft reference implementation. They follow the current RFC and leave its property-presence question open. Companion PRs: core #15531 and language-tools #6207.

The basic SFC example puts v-match directly on the top-level <template>. Explain its equivalence to an inner match and retain the same arm scope and coverage rules. The reference notice identifies the current inline-HTML and bundler integration limits.

Additional Information

pnpm build passed. Browser checks at 1440 px and 390 px found no horizontal overflow or page errors. The Netlify preview checks passed.

pnpm type fails on the unchanged .vitepress/config.ts:795 Plugin tuple cast. This PR does not modify that configuration.

@netlify

netlify Bot commented Sep 16, 2026

Copy link
Copy Markdown

Deploy Preview for vuejs ready!

Name Link
🔨 Latest commit bad77b0
🔍 Latest deploy log https://app.netlify.com/projects/vuejs/deploys/6aaae51bdadd160008ad4549
😎 Deploy Preview https://deploy-preview-3465--vuejs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@ubugeeei

ubugeeei commented Sep 16, 2026

Copy link
Copy Markdown
Member Author

Draft reference documentation for RFC 823, paired with core #15531 and language-tools #6207.

At bad77b085, Netlify preview checks pass. The basic example uses v-match on the SFC top-level template and explains its equivalence to an inner match. Arm scopes, shadowing, duplicate declarations, narrowing and exhaustive coverage are unchanged.

The reference notice identifies the current inline-HTML and bundler integration limits. The existing pnpm type failure in .vitepress/config.ts:795 remains recorded in the PR description.

@ubugeeei ubugeeei changed the title docs: add RFC 823 patterned template reference guide docs: document patterned templates (RFC 823) Sep 16, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant