Skip to content

docs: document VNode support for the component is prop - #3473

Open
hermanrous wants to merge 1 commit into
vuejs:mainfrom
hermanrous:docs/component-is-vnode
Open

hermanrous wants to merge 1 commit into
vuejs:mainfrom
hermanrous:docs/component-is-vnode

Conversation

@hermanrous

Copy link
Copy Markdown

Description of Problem

The is prop of <component> accepts a VNode instance, but the API reference documents only is: string | Component, and the Dynamic Components guide lists only registered component names and imported component objects. vuejs/core's createVNode explicitly handles this case (see vnode.ts, <component :is="vnode"/>), and core team member @bencodezen requested this documentation update in the issue.

Proposed Solution

  • src/api/built-in-special-elements.md: update the DynamicComponentProps.is type to string | Component | VNode and document binding a VNode directly with an example.
  • src/guide/essentials/component-basics.md: add VNode instances (e.g. created via h()) to the list of valid is values.

Additional Information

Closes #2999.

@netlify

netlify Bot commented Oct 2, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for vuejs ready!

Name Link
🔨 Latest commit 0a83277
🔍 Latest deploy log https://app.netlify.com/projects/vuejs/deploys/6abfcce42d2a180008fc08fc
😎 Deploy Preview https://deploy-preview-3473--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.

This branch has not been deployed

No deployments
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.

内置组件“component”支持VNode类型

1 participant