vue3-yuanma/packages/runtime-core/src/componentRenderUtils.ts

259 lines
7.0 KiB
TypeScript
Raw Normal View History

2019-09-07 00:58:31 +08:00
import {
ComponentInternalInstance,
FunctionalComponent,
Data
} from './component'
import {
VNode,
normalizeVNode,
createVNode,
Comment,
cloneVNode
} from './vnode'
2019-09-07 00:58:31 +08:00
import { handleError, ErrorCodes } from './errorHandling'
import { PatchFlags, ShapeFlags, EMPTY_OBJ, isOn } from '@vue/shared'
import { warn } from './warning'
2019-09-06 23:25:11 +08:00
// mark the current rendering instance for asset resolution (e.g.
// resolveComponent, resolveDirective) during render
2019-09-07 00:58:31 +08:00
export let currentRenderingInstance: ComponentInternalInstance | null = null
2019-09-06 23:25:11 +08:00
2020-02-06 12:07:23 +08:00
export function setCurrentRenderingInstance(
instance: ComponentInternalInstance | null
) {
currentRenderingInstance = instance
}
// dev only flag to track whether $attrs was used during render.
// If $attrs was used during render then the warning for failed attrs
// fallthrough can be suppressed.
let accessedAttrs: boolean = false
export function markAttrsAccessed() {
accessedAttrs = true
}
2019-09-07 00:58:31 +08:00
export function renderComponentRoot(
instance: ComponentInternalInstance
): VNode {
2019-09-06 23:25:11 +08:00
const {
type: Component,
parent,
2019-09-06 23:25:11 +08:00
vnode,
proxy,
withProxy,
2019-09-06 23:25:11 +08:00
props,
slots,
attrs,
emit,
renderCache
2019-09-06 23:25:11 +08:00
} = instance
let result
currentRenderingInstance = instance
if (__DEV__) {
accessedAttrs = false
}
2019-09-06 23:25:11 +08:00
try {
let fallthroughAttrs
2019-09-06 23:25:11 +08:00
if (vnode.shapeFlag & ShapeFlags.STATEFUL_COMPONENT) {
// withProxy is a proxy with a different `has` trap only for
2020-02-14 07:28:40 +08:00
// runtime-compiled render functions using `with` block.
const proxyToUse = withProxy || proxy
result = normalizeVNode(
instance.render!.call(proxyToUse, proxyToUse!, renderCache)
)
fallthroughAttrs = attrs
2019-09-06 23:25:11 +08:00
} else {
// functional
const render = Component as FunctionalComponent
result = normalizeVNode(
render.length > 1
? render(props, {
2019-09-06 23:25:11 +08:00
attrs,
slots,
emit
})
: render(props, null as any /* we know it doesn't need it */)
2019-09-06 23:25:11 +08:00
)
fallthroughAttrs = Component.props ? attrs : getFallthroughAttrs(attrs)
2019-09-06 23:25:11 +08:00
}
// attr merging
if (
Component.inheritAttrs !== false &&
fallthroughAttrs &&
fallthroughAttrs !== EMPTY_OBJ
) {
if (
result.shapeFlag & ShapeFlags.ELEMENT ||
result.shapeFlag & ShapeFlags.COMPONENT
) {
result = cloneVNode(result, fallthroughAttrs)
// If the child root node is a compiler optimized vnode, make sure it
// force update full props to account for the merged attrs.
2020-03-19 06:14:51 +08:00
if (result.dynamicChildren) {
result.patchFlag |= PatchFlags.FULL_PROPS
}
} else if (__DEV__ && !accessedAttrs && result.type !== Comment) {
warn(
`Extraneous non-props attributes (` +
`${Object.keys(attrs).join(', ')}) ` +
2019-11-26 16:27:51 +08:00
`were passed to component but could not be automatically inherited ` +
`because component renders fragment or text root nodes.`
)
}
}
// inherit scopeId
const parentScopeId = parent && parent.type.__scopeId
if (parentScopeId) {
result = cloneVNode(result, { [parentScopeId]: '' })
}
// inherit directives
2020-03-19 06:14:51 +08:00
if (vnode.dirs) {
if (__DEV__ && !isElementRoot(result)) {
warn(
`Runtime directive used on component with non-element root node. ` +
`The directives will not function as intended.`
)
}
result.dirs = vnode.dirs
}
// inherit transition data
2020-03-19 06:14:51 +08:00
if (vnode.transition) {
if (__DEV__ && !isElementRoot(result)) {
warn(
`Component inside <Transition> renders non-element root node ` +
`that cannot be animated.`
)
}
result.transition = vnode.transition
}
2019-09-06 23:25:11 +08:00
} catch (err) {
2019-09-07 00:58:31 +08:00
handleError(err, instance, ErrorCodes.RENDER_FUNCTION)
result = createVNode(Comment)
2019-09-06 23:25:11 +08:00
}
currentRenderingInstance = null
2019-09-06 23:25:11 +08:00
return result
}
const getFallthroughAttrs = (attrs: Data): Data | undefined => {
let res: Data | undefined
for (const key in attrs) {
if (key === 'class' || key === 'style' || isOn(key)) {
;(res || (res = {}))[key] = attrs[key]
}
}
return res
}
const isElementRoot = (vnode: VNode) => {
return (
vnode.shapeFlag & ShapeFlags.COMPONENT ||
vnode.shapeFlag & ShapeFlags.ELEMENT ||
vnode.type === Comment // potential v-if branch switch
)
}
2019-09-06 23:25:11 +08:00
export function shouldUpdateComponent(
prevVNode: VNode,
nextVNode: VNode,
parentComponent: ComponentInternalInstance | null,
2019-09-06 23:25:11 +08:00
optimized?: boolean
): boolean {
const { props: prevProps, children: prevChildren } = prevVNode
const { props: nextProps, children: nextChildren, patchFlag } = nextVNode
// Parent component's render function was hot-updated. Since this may have
// caused the child component's slots content to have changed, we need to
// force the child to update as well.
if (
__BUNDLER__ &&
__DEV__ &&
(prevChildren || nextChildren) &&
parentComponent &&
parentComponent.renderUpdated
) {
return true
}
// force child update on runtime directive usage on component vnode.
2020-03-19 06:14:51 +08:00
if (nextVNode.dirs) {
return true
}
if (patchFlag > 0) {
2019-09-06 23:25:11 +08:00
if (patchFlag & PatchFlags.DYNAMIC_SLOTS) {
// slot content that references values that might have changed,
// e.g. in a v-for
return true
}
if (patchFlag & PatchFlags.FULL_PROPS) {
// presence of this flag indicates props are always non-null
2019-10-05 22:09:34 +08:00
return hasPropsChanged(prevProps!, nextProps!)
} else {
if (patchFlag & PatchFlags.CLASS) {
return prevProps!.class !== nextProps!.class
}
if (patchFlag & PatchFlags.STYLE) {
return hasPropsChanged(prevProps!.style, nextProps!.style)
}
if (patchFlag & PatchFlags.PROPS) {
const dynamicProps = nextVNode.dynamicProps!
for (let i = 0; i < dynamicProps.length; i++) {
const key = dynamicProps[i]
if (nextProps![key] !== prevProps![key]) {
return true
}
2019-09-06 23:25:11 +08:00
}
}
}
} else if (!optimized) {
// this path is only taken by manually written render functions
// so presence of any children leads to a forced update
2020-03-19 06:14:51 +08:00
if (prevChildren || nextChildren) {
if (!nextChildren || !(nextChildren as any).$stable) {
return true
}
2019-09-06 23:25:11 +08:00
}
if (prevProps === nextProps) {
return false
}
2020-03-19 06:14:51 +08:00
if (!prevProps) {
return !!nextProps
2019-09-06 23:25:11 +08:00
}
2020-03-19 06:14:51 +08:00
if (!nextProps) {
return true
2019-09-06 23:25:11 +08:00
}
return hasPropsChanged(prevProps, nextProps)
}
2019-09-06 23:25:11 +08:00
return false
}
function hasPropsChanged(prevProps: Data, nextProps: Data): boolean {
const nextKeys = Object.keys(nextProps)
if (nextKeys.length !== Object.keys(prevProps).length) {
return true
}
for (let i = 0; i < nextKeys.length; i++) {
const key = nextKeys[i]
if (nextProps[key] !== prevProps[key]) {
return true
}
}
return false
}
export function updateHOCHostEl(
{ vnode, parent }: ComponentInternalInstance,
el: typeof vnode.el // HostNode
) {
while (parent && parent.subTree === vnode) {
;(vnode = parent.vnode).el = el
parent = parent.parent
}
}