import { VNodeTypes, VNode, createVNode, VNodeChildren, Fragment, Portal } from './vnode' import { isObject, isArray } from '@vue/shared' import { Ref } from '@vue/reactivity' import { RawSlots } from './componentSlots' import { FunctionalComponent } from './component' import { ComponentOptionsWithoutProps, ComponentOptionsWithArrayProps, ComponentOptionsWithObjectProps, ComponentOptions } from './apiOptions' import { ExtractPropTypes } from './componentProps' // `h` is a more user-friendly version of `createVNode` that allows omitting the // props when possible. It is intended for manually written render functions. // Compiler-generated code uses `createVNode` because // 1. it is monomorphic and avoids the extra call overhead // 2. it allows specifying patchFlags for optimization /* // type only h('div') // type + props h('div', {}) // type + omit props + children // Omit props does NOT support named slots h('div', []) // array h('div', () => {}) // default slot h('div', 'foo') // text // type + props + children h('div', {}, []) // array h('div', {}, () => {}) // default slot h('div', {}, {}) // named slots h('div', {}, 'foo') // text // named slots without props requires explicit `null` to avoid ambiguity h('div', null, {}) **/ export interface RawProps { [key: string]: any key?: string | number ref?: string | Ref | Function // used to differ from a single VNode object as children _isVNode?: never // used to differ from Array children [Symbol.iterator]?: never } export type RawChildren = | string | number | boolean | VNodeChildren | (() => any) export { RawSlots } // fake constructor type returned from `createComponent` interface Constructor
{ new (): { $props: P } } // The following is a series of overloads for providing props validation of // manually written render functions. // element export function h(type: string, children?: RawChildren): VNode export function h( type: string, props?: RawProps | null, children?: RawChildren ): VNode // keyed fragment export function h(type: typeof Fragment, children?: RawChildren): VNode export function h( type: typeof Fragment, props?: (RawProps & { key?: string | number }) | null, children?: RawChildren ): VNode // portal export function h(type: typeof Portal, children?: RawChildren): VNode export function h( type: typeof Portal, props?: (RawProps & { target: any }) | null, children?: RawChildren ): VNode // functional component export function h(type: FunctionalComponent, children?: RawChildren): VNode export function h
( type: FunctionalComponent
, props?: (RawProps & P) | null, children?: RawChildren | RawSlots ): VNode // stateful component export function h(type: ComponentOptions, children?: RawChildren): VNode export function h
( type: ComponentOptionsWithoutProps
, props?: (RawProps & P) | null, children?: RawChildren | RawSlots ): VNode export function h
( type: ComponentOptionsWithArrayProps
, // TODO for now this doesn't really do anything, but it would become useful // if we make props required by default props?: (RawProps & { [key in P]?: any }) | null, children?: RawChildren | RawSlots ): VNode export function h
( type: ComponentOptionsWithObjectProps
, props?: (RawProps & ExtractPropTypes
) | null, children?: RawChildren | RawSlots ): VNode // fake constructor type returned by `createComponent` export function h(type: Constructor, children?: RawChildren): VNode export function h
( type: Constructor
, props?: (RawProps & P) | null, children?: RawChildren | RawSlots ): VNode // Actual implementation export function h( type: VNodeTypes, propsOrChildren?: any, children?: any ): VNode { if (arguments.length === 2) { if (isObject(propsOrChildren) && !isArray(propsOrChildren)) { // props without children return createVNode(type, propsOrChildren) } else { // omit props return createVNode(type, null, propsOrChildren) } } else { return createVNode(type, propsOrChildren, children) } }