TelegramPWA/src/lib/teact/teact-dom.ts
2026-01-20 12:07:34 +01:00

994 lines
30 KiB
TypeScript

import type { ChangeEvent, FocusEvent } from 'react';
import type { Signal } from '../../util/signals';
import type {
VirtualElement,
VirtualElementChildren,
VirtualElementComponent,
VirtualElementFragment,
VirtualElementParent,
VirtualElementReal,
VirtualElementTag,
} from './teact';
import { DEBUG } from '../../config';
import { addEventListener, removeAllDelegatedListeners, removeEventListener } from './dom-events';
import {
captureImmediateEffects,
hasElementChanged,
isParentElement,
mountComponent,
MountState,
renderComponent,
unmountComponent,
VirtualType,
} from './teact';
interface VirtualDomHead {
children: [VirtualElement] | [];
}
interface SelectionState {
selectionStart: number | null;
selectionEnd: number | null;
isCaretAtEnd: boolean;
}
type CurrentContext = Record<string, Signal<unknown>>;
type DOMElement = HTMLElement | SVGElement;
const SVG_NAMESPACE = 'http://www.w3.org/2000/svg';
const HTML_NAMESPACE = 'http://www.w3.org/1999/xhtml';
const FILTERED_ATTRIBUTES = new Set(['key', 'ref', 'teactFastList', 'teactOrderKey']);
const HTML_ATTRIBUTES = new Set(['dir', 'role', 'form']);
const CONTROLLABLE_TAGS = ['INPUT', 'TEXTAREA', 'SELECT'];
const MAPPED_ATTRIBUTES: Partial<Record<string, string>> = {
autoCapitalize: 'autocapitalize',
autoComplete: 'autocomplete',
autoCorrect: 'autocorrect',
autoPlay: 'autoplay',
spellCheck: 'spellcheck',
};
const INDEX_KEY_PREFIX = '__indexKey#';
const SELECTION_STATE_ATTRIBUTE = '__teactSelectionState';
const headsByElement = new WeakMap<Element, VirtualDomHead>();
const extraClasses = new WeakMap<Element, Set<string>>();
const extraStyles = new WeakMap<Element, Record<string, string>>();
const uniqueChildKeysCache = new WeakMap<VirtualElementChildren, (keyof any)[]>();
let DEBUG_virtualTreeSize = 1;
function render($element: VirtualElement | undefined, parentEl: HTMLElement) {
if (!headsByElement.has(parentEl)) {
headsByElement.set(parentEl, { children: [] });
}
const runImmediateEffects = captureImmediateEffects();
const $head = headsByElement.get(parentEl)!;
const $renderedChild = renderWithVirtual(parentEl, $head.children[0], $element, $head, {}, 0);
runImmediateEffects?.();
$head.children = $renderedChild ? [$renderedChild] : [];
if (process.env.APP_ENV === 'perf') {
DEBUG_virtualTreeSize = 0;
DEBUG_addToVirtualTreeSize($head);
return DEBUG_virtualTreeSize;
}
return undefined;
}
interface RenderWithVirtualOptions {
skipComponentUpdate?: boolean;
nextSibling?: ChildNode;
forceMoveToEnd?: boolean;
fragment?: DocumentFragment;
namespace?: string;
}
function renderWithVirtual<T extends VirtualElement | undefined>(
parentEl: DOMElement,
$current: VirtualElement | undefined,
$new: T,
$parent: VirtualElementParent | VirtualDomHead,
currentContext: CurrentContext,
index: number,
options: RenderWithVirtualOptions = {},
): T {
const { skipComponentUpdate, fragment } = options;
let { nextSibling, namespace } = options;
const isCurrentComponent = $current?.type === VirtualType.Component;
const isNewComponent = $new?.type === VirtualType.Component;
const $newAsReal = $new as VirtualElementReal;
const isCurrentFragment = !isCurrentComponent && $current?.type === VirtualType.Fragment;
const isNewFragment = !isNewComponent && $new?.type === VirtualType.Fragment;
if ($new?.type === VirtualType.Tag) {
if ($new.tag === 'svg') namespace = SVG_NAMESPACE;
if ($new.props.xmlns) namespace = $new.props.xmlns;
}
if ($new?.type === VirtualType.Component) {
$new.componentInstance.lastMountNamespace = namespace;
}
if (
!skipComponentUpdate
&& isCurrentComponent && isNewComponent
&& !hasElementChanged($current, $new!)
) {
$new = updateComponent($current, $new as VirtualElementComponent) as typeof $new;
}
// Parent element may have changed, so we need to update the listener closure.
if (
!skipComponentUpdate
&& isNewComponent
&& ($new as VirtualElementComponent).componentInstance.mountState === MountState.Mounted
) {
setupComponentUpdateListener(parentEl, $new as VirtualElementComponent, $parent, currentContext, index);
}
if ($current === $new) {
return $new;
}
if (DEBUG && $new) {
const newTarget = 'target' in $new && $new.target;
if (newTarget && (!$current || ('target' in $current && newTarget !== $current.target))) {
throw new Error('[Teact] Cached virtual element was moved within tree');
}
}
if (!$current && $new) {
if (isNewComponent || isNewFragment) {
if (isNewComponent) {
$new = initComponent(
parentEl, $new as VirtualElementComponent, $parent, currentContext, index,
) as unknown as typeof $new;
currentContext = ($new as VirtualElementComponent).componentInstance.context ?? currentContext;
}
mountChildren(parentEl, $new as VirtualElementComponent | VirtualElementFragment, currentContext, {
nextSibling, fragment, namespace,
});
} else {
const canSetTextContent = !fragment
&& !nextSibling
&& $newAsReal.type === VirtualType.Text
&& $parent.children.length === 1
&& !parentEl.firstChild;
if (canSetTextContent) {
parentEl.textContent = $newAsReal.value;
$newAsReal.target = parentEl.firstChild!;
} else {
const node = createNode($newAsReal, currentContext, namespace);
$newAsReal.target = node;
insertBefore(fragment || parentEl, node, nextSibling);
if ($newAsReal.type === VirtualType.Tag) {
setElementRef($newAsReal, node as DOMElement);
}
}
}
} else if ($current && !$new) {
remount(parentEl, $current, currentContext, undefined);
} else if ($current && $new) {
if (hasElementChanged($current, $new)) {
if (!nextSibling) {
nextSibling = getNextSibling($current);
}
if (isNewComponent || isNewFragment) {
if (isNewComponent) {
$new = initComponent(
parentEl, $new as VirtualElementComponent, $parent, currentContext, index,
) as unknown as typeof $new;
currentContext = ($new as VirtualElementComponent).componentInstance.context ?? currentContext;
}
remount(parentEl, $current, currentContext, undefined);
mountChildren(parentEl, $new as VirtualElementComponent | VirtualElementFragment, currentContext, {
nextSibling, fragment, namespace,
});
} else {
const node = createNode($newAsReal, currentContext, namespace);
$newAsReal.target = node;
remount(parentEl, $current, currentContext, node, nextSibling);
if ($newAsReal.type === VirtualType.Tag) {
setElementRef($newAsReal, node as DOMElement);
}
}
} else {
const isComponent = isCurrentComponent && isNewComponent;
const isFragment = isCurrentFragment && isNewFragment;
if (isComponent || isFragment) {
renderChildren(
$current,
$new as VirtualElementComponent | VirtualElementFragment,
currentContext,
parentEl,
nextSibling,
options.forceMoveToEnd,
namespace,
);
} else {
const $currentAsReal = $current as VirtualElementReal;
const currentTarget = $currentAsReal.target!;
$newAsReal.target = currentTarget;
$currentAsReal.target = undefined; // Help GC
const isTag = $current.type === VirtualType.Tag;
if (isTag) {
const $newAsTag = $new as VirtualElementTag;
setElementRef($current, undefined);
setElementRef($newAsTag, currentTarget as DOMElement);
if (nextSibling || options.forceMoveToEnd) {
insertBefore(parentEl, currentTarget, nextSibling);
}
updateAttributes($current, $newAsTag, currentTarget as DOMElement, namespace);
renderChildren(
$current, $newAsTag, currentContext, currentTarget as DOMElement, undefined, undefined, namespace,
);
}
}
}
}
return $new;
}
function initComponent(
parentEl: DOMElement,
$element: VirtualElementComponent,
$parent: VirtualElementParent | VirtualDomHead,
currentContext: CurrentContext,
index: number,
) {
const { componentInstance } = $element;
$element.componentInstance.context = currentContext;
if (componentInstance.mountState === MountState.Unmounted) {
$element = mountComponent(componentInstance);
setupComponentUpdateListener(parentEl, $element, $parent, currentContext, index);
}
return $element;
}
function updateComponent($current: VirtualElementComponent, $new: VirtualElementComponent) {
$current.componentInstance.props = $new.componentInstance.props;
return renderComponent($current.componentInstance);
}
function setupComponentUpdateListener(
parentEl: DOMElement,
$element: VirtualElementComponent,
$parent: VirtualElementParent | VirtualDomHead,
currentContext: CurrentContext,
index: number,
) {
const { componentInstance } = $element;
componentInstance.onUpdate = () => {
$parent.children[index] = renderWithVirtual(
parentEl,
$parent.children[index],
componentInstance.$element,
$parent,
currentContext,
index,
{
skipComponentUpdate: true,
namespace: componentInstance.lastMountNamespace,
},
);
};
}
function mountChildren(
parentEl: DOMElement,
$element: VirtualElementComponent | VirtualElementFragment,
currentContext: CurrentContext,
options: {
nextSibling?: ChildNode;
fragment?: DocumentFragment;
namespace?: string;
},
) {
const { children } = $element;
// Add a placeholder comment node for empty fragments to maintain position
if ($element.type === VirtualType.Fragment && children.length === 0) {
const fragmentEl = $element;
fragmentEl.placeholderTarget = document.createComment('empty-fragment');
insertBefore(options.fragment || parentEl, fragmentEl.placeholderTarget, options.nextSibling);
return;
}
for (let i = 0, l = children.length; i < l; i++) {
const $child = children[i];
const $renderedChild = renderWithVirtual(parentEl, undefined, $child, $element, currentContext, i, options);
if ($renderedChild !== $child) {
children[i] = $renderedChild;
}
}
}
function unmountChildren(
parentEl: DOMElement, $element: VirtualElementComponent | VirtualElementFragment, currentContext: CurrentContext,
) {
for (const $child of $element.children) {
renderWithVirtual(parentEl, $child, undefined, $element, currentContext, -1);
}
}
function createNode($element: VirtualElementReal, currentContext: CurrentContext, namespace = HTML_NAMESPACE): Node {
if ($element.type === VirtualType.Empty) {
return document.createTextNode('');
}
if ($element.type === VirtualType.Text) {
return document.createTextNode($element.value);
}
const { tag, props, children } = $element;
const element = document.createElementNS(namespace, tag) as DOMElement;
processControlled(tag, props);
for (const key in props) {
if (!props.hasOwnProperty(key)) continue;
if (props[key] !== undefined) {
setAttribute(element, key, props[key], namespace);
}
}
processUncontrolledOnMount(element, props);
for (let i = 0, l = children.length; i < l; i++) {
const $child = children[i];
const $renderedChild = renderWithVirtual(element, undefined, $child, $element, currentContext, i, { namespace });
if ($renderedChild !== $child) {
children[i] = $renderedChild;
}
}
return element;
}
function remount(
parentEl: DOMElement,
$current: VirtualElement,
currentContext: CurrentContext,
node: Node | undefined,
componentNextSibling?: ChildNode,
) {
const isComponent = $current.type === VirtualType.Component;
const isFragment = !isComponent && $current.type === VirtualType.Fragment;
if (isComponent || isFragment) {
if (isComponent) {
unmountComponent($current.componentInstance);
}
unmountChildren(parentEl, $current, currentContext);
if (node) {
insertBefore(parentEl, node, componentNextSibling);
}
} else {
if (node) {
parentEl.replaceChild(node, $current.target!);
} else {
parentEl.removeChild($current.target!);
}
unmountRealTree($current);
}
}
function unmountRealTree($element: VirtualElement) {
if ($element.type === VirtualType.Component) {
unmountComponent($element.componentInstance);
} else if ($element.type === VirtualType.Fragment) {
// Remove placeholder for empty fragments
const fragment = $element;
if (fragment.placeholderTarget && fragment.children.length === 0) {
fragment.placeholderTarget.parentNode?.removeChild(fragment.placeholderTarget);
fragment.placeholderTarget = undefined;
}
} else {
if ($element.type === VirtualType.Tag) {
extraClasses.delete($element.target!);
setElementRef($element, undefined);
removeAllDelegatedListeners($element.target!);
}
$element.target = undefined; // Help GC
if ($element.type !== VirtualType.Tag) {
return;
}
}
for (const $child of $element.children) {
unmountRealTree($child);
}
}
function insertBefore(parentEl: DOMElement | DocumentFragment, node: Node, nextSibling?: ChildNode) {
if (nextSibling) {
parentEl.insertBefore(node, nextSibling);
} else {
parentEl.appendChild(node);
}
}
function getNextSibling($current: VirtualElement): ChildNode | undefined {
if ($current.type === VirtualType.Component || $current.type === VirtualType.Fragment) {
if ($current.children.length === 0) {
// For empty fragments, use the placeholder node to track position
const fragment = $current as VirtualElementFragment;
if (fragment.placeholderTarget) {
return fragment.placeholderTarget.nextSibling || undefined;
}
return undefined;
}
const lastChild = $current.children[$current.children.length - 1];
return getNextSibling(lastChild);
}
return $current.target!.nextSibling || undefined;
}
function renderChildren(
$current: VirtualElementParent,
$new: VirtualElementParent,
currentContext: CurrentContext,
currentEl: DOMElement,
nextSibling?: ChildNode,
forceMoveToEnd = false,
namespace?: string,
) {
if (('props' in $new) && $new.props.teactFastList) {
renderFastListChildren($current, $new, currentContext, currentEl, namespace);
return;
}
// Handle transitions between empty and non-empty fragments
if ($current.type === VirtualType.Fragment && $new.type === VirtualType.Fragment) {
const currentFragment = $current;
const newFragment = $new;
// If transitioning from empty to non-empty, use the placeholder's position
if (currentFragment.children.length === 0 && newFragment.children.length > 0 && currentFragment.placeholderTarget) {
nextSibling = currentFragment.placeholderTarget.nextSibling || undefined;
// Remove the placeholder as we're adding real content
currentFragment.placeholderTarget.parentNode?.removeChild(currentFragment.placeholderTarget);
currentFragment.placeholderTarget = undefined;
}
// If transitioning from non-empty to empty, add a placeholder
if (currentFragment.children.length > 0 && newFragment.children.length === 0) {
const lastCurrentChild = currentFragment.children[currentFragment.children.length - 1];
const siblingAfterFragment = getNextSibling(lastCurrentChild);
newFragment.placeholderTarget = document.createComment('empty-fragment');
insertBefore(currentEl, newFragment.placeholderTarget, siblingAfterFragment);
}
}
const currentChildren = $current.children;
const newChildren = $new.children;
const currentChildrenLength = currentChildren.length;
const newChildrenLength = newChildren.length;
const maxLength = Math.max(currentChildrenLength, newChildrenLength);
const fragment = newChildrenLength > currentChildrenLength ? document.createDocumentFragment() : undefined;
const lastCurrentChild = $current.children[currentChildrenLength - 1];
const fragmentNextSibling = fragment && (
nextSibling || (lastCurrentChild ? getNextSibling(lastCurrentChild) : undefined)
);
for (let i = 0; i < maxLength; i++) {
const $renderedChild = renderWithVirtual(
currentEl,
currentChildren[i],
newChildren[i],
$new,
currentContext,
i,
i >= currentChildrenLength ? { fragment, namespace } : { nextSibling, forceMoveToEnd, namespace },
);
if ($renderedChild && $renderedChild !== newChildren[i]) {
newChildren[i] = $renderedChild;
}
}
if (fragment) {
insertBefore(currentEl, fragment, fragmentNextSibling);
}
}
// This function allows to prepend/append a bunch of new DOM nodes to the top/bottom of preserved ones.
// It also allows to selectively move particular preserved nodes within their DOM list.
function renderFastListChildren(
$current: VirtualElementParent,
$new: VirtualElementParent,
currentContext: CurrentContext,
currentEl: DOMElement,
namespace?: string,
) {
const currentChildren = $current.children;
const newChildren = $new.children;
// Clear out duplicated keys to avoid incorrect elements matching
const currentKeysByIndex = getChildKeysByIndex(currentChildren);
const newKeysByIndex = getChildKeysByIndex(newChildren);
const newKeys = new Set(newKeysByIndex);
if (DEBUG) {
for (const $newChild of newChildren) {
if ($newChild.type === VirtualType.Fragment) {
throw new Error('[Teact] Fragment can not be child of container with `teactFastList`');
}
}
}
// Build a collection of old children that also remain in the new list
let currentRemainingIndex = 0;
const remainingByKey: Record<keyof any, { $element: VirtualElement; index: number; orderKey?: number }> = {};
for (let i = 0, l = currentChildren.length; i < l; i++) {
const $currentChild = currentChildren[i];
const key = currentKeysByIndex[i];
// First we process removed children
if (!newKeys.has(key)) {
renderWithVirtual(currentEl, $currentChild, undefined, $new, currentContext, -1);
continue;
}
// Then we build up info about remaining children
remainingByKey[key] = {
$element: $currentChild,
index: currentRemainingIndex++,
orderKey: 'props' in $currentChild ? $currentChild.props.teactOrderKey : undefined,
};
}
let fragmentIndex: number | undefined;
let fragmentSize: number | undefined;
let currentPreservedIndex = 0;
for (let i = 0, l = newChildren.length; i < l; i++) {
const $newChild = newChildren[i];
const key = newKeysByIndex[i];
const currentChildInfo = remainingByKey[key];
if (!currentChildInfo) {
if (fragmentSize === undefined) {
fragmentIndex = i;
fragmentSize = 0;
}
fragmentSize++;
continue;
}
// This prepends new children to the top
if (fragmentSize) {
renderFragment(fragmentIndex!, fragmentSize, currentEl, $new, currentContext, namespace);
fragmentSize = undefined;
fragmentIndex = undefined;
}
// Now we check if a preserved node was moved within preserved list
const newOrderKey = 'props' in $newChild ? $newChild.props.teactOrderKey : undefined;
// That is indicated by a changed `teactOrderKey` value
const shouldMoveNode = (
currentChildInfo.index !== currentPreservedIndex && (!newOrderKey || currentChildInfo.orderKey !== newOrderKey)
);
const isMovingDown = shouldMoveNode && currentPreservedIndex > currentChildInfo.index;
if (!shouldMoveNode || isMovingDown) {
currentPreservedIndex++;
}
const nextSibling = currentEl.childNodes[isMovingDown ? i + 1 : i];
const options: RenderWithVirtualOptions = { namespace };
if (shouldMoveNode) {
if (nextSibling) {
options.nextSibling = nextSibling;
} else {
options.forceMoveToEnd = true;
}
}
const $renderedChild = renderWithVirtual(
currentEl, currentChildInfo.$element, $newChild, $new, currentContext, i, options,
);
if ($renderedChild !== $newChild) {
newChildren[i] = $renderedChild;
}
}
// This appends new children to the bottom
if (fragmentSize) {
renderFragment(fragmentIndex!, fragmentSize, currentEl, $new, currentContext, namespace);
}
}
function renderFragment(
fragmentIndex: number,
fragmentSize: number,
parentEl: DOMElement,
$parent: VirtualElementParent,
currentContext: CurrentContext,
namespace?: string,
) {
const nextSibling = parentEl.childNodes[fragmentIndex];
if (fragmentSize === 1) {
const $child = $parent.children[fragmentIndex];
const $renderedChild = renderWithVirtual(
parentEl, undefined, $child, $parent, currentContext, fragmentIndex, { nextSibling, namespace },
);
if ($renderedChild !== $child) {
$parent.children[fragmentIndex] = $renderedChild;
}
return;
}
const fragment = document.createDocumentFragment();
for (let i = fragmentIndex; i < fragmentIndex + fragmentSize; i++) {
const $child = $parent.children[i];
const $renderedChild = renderWithVirtual(
parentEl, undefined, $child, $parent, currentContext, i, { fragment, namespace },
);
if ($renderedChild !== $child) {
$parent.children[i] = $renderedChild;
}
}
insertBefore(parentEl, fragment, nextSibling);
}
function setElementRef($element: VirtualElementTag, element: DOMElement | undefined) {
const { ref } = $element.props;
if (typeof ref === 'object') {
ref.current = element;
ref.onChange?.();
} else if (typeof ref === 'function') {
ref(element);
}
}
function processControlled(tag: string, props: AnyLiteral) {
// TODO Remove after tests
if (!props.teactExperimentControlled) {
return;
}
const isValueControlled = props.value !== undefined;
const isCheckedControlled = props.checked !== undefined;
const isControlled = (isValueControlled || isCheckedControlled) && CONTROLLABLE_TAGS.includes(tag.toUpperCase());
if (!isControlled) {
return;
}
const {
value, checked, onInput, onChange, onBlur,
} = props;
props.onChange = undefined;
props.onInput = (e: ChangeEvent<HTMLInputElement>) => {
onInput?.(e);
onChange?.(e);
if (value !== undefined && value !== e.currentTarget.value) {
const { selectionStart, selectionEnd } = e.currentTarget;
const isCaretAtEnd = selectionStart === selectionEnd && selectionEnd === e.currentTarget.value.length;
e.currentTarget.value = value;
if (typeof selectionStart === 'number' && typeof selectionEnd === 'number') {
e.currentTarget.setSelectionRange(selectionStart, selectionEnd);
const selectionState: SelectionState = { selectionStart, selectionEnd, isCaretAtEnd };
e.currentTarget.dataset[SELECTION_STATE_ATTRIBUTE] = JSON.stringify(selectionState);
}
}
if (checked !== undefined) {
e.currentTarget.checked = checked;
}
};
props.onBlur = (e: FocusEvent<HTMLInputElement>) => {
delete e.currentTarget.dataset[SELECTION_STATE_ATTRIBUTE];
onBlur?.(e);
};
}
function processUncontrolledOnMount(element: DOMElement, props: AnyLiteral) {
if (!CONTROLLABLE_TAGS.includes(element.tagName)) {
return;
}
if (props.defaultValue) {
setAttribute(element, 'value', props.defaultValue);
}
if (props.defaultChecked) {
setAttribute(element, 'checked', props.defaultChecked);
}
}
function updateAttributes(
$current: VirtualElementTag, $new: VirtualElementTag, element: DOMElement, namespace?: string,
) {
processControlled(element.tagName, $new.props);
const currentEntries = Object.entries($current.props);
const newEntries = Object.entries($new.props);
for (const [key, currentValue] of currentEntries) {
const newValue = $new.props[key];
if (
currentValue !== undefined
&& (
newValue === undefined
|| (currentValue !== newValue && key.startsWith('on'))
)
) {
removeAttribute(element, key, currentValue);
}
}
for (const [key, newValue] of newEntries) {
const currentValue = $current.props[key];
if (newValue !== undefined && newValue !== currentValue) {
setAttribute(element, key, newValue, namespace);
}
}
}
function setAttribute(element: DOMElement, key: string, value: any, namespace?: string) {
if (key === 'className') {
updateClassName(element, value, namespace);
} else if (key === 'value') {
const inputEl = element as HTMLInputElement;
if (inputEl.value !== value) {
inputEl.value = value;
const selectionStateJson = inputEl.dataset[SELECTION_STATE_ATTRIBUTE];
if (selectionStateJson) {
const { selectionStart, selectionEnd, isCaretAtEnd } = JSON.parse(selectionStateJson) as SelectionState;
if (isCaretAtEnd) {
const length = inputEl.value.length;
inputEl.setSelectionRange(length, length);
} else if (typeof selectionStart === 'number' && typeof selectionEnd === 'number') {
inputEl.setSelectionRange(selectionStart, selectionEnd);
}
}
}
} else if (key === 'style') {
updateStyle(element, value);
} else if (key === 'dangerouslySetInnerHTML') {
element.innerHTML = value.__html;
} else if (key.startsWith('on')) {
addEventListener(element, key, value, key.endsWith('Capture'));
} else if (
key.startsWith('data-') || key.startsWith('aria-') || HTML_ATTRIBUTES.has(key)
) {
element.setAttribute(key, value);
} else if (!FILTERED_ATTRIBUTES.has(key)) {
if (namespace === SVG_NAMESPACE) {
element.setAttribute(key, value);
} else {
(element as any)[MAPPED_ATTRIBUTES[key] || key] = value;
}
}
}
function removeAttribute(element: DOMElement, key: string, value: any) {
if (key === 'className') {
updateClassName(element, '');
} else if (key === 'value') {
(element as HTMLInputElement).value = '';
} else if (key === 'style') {
updateStyle(element, '');
} else if (key === 'dangerouslySetInnerHTML') {
element.innerHTML = '';
} else if (key.startsWith('on')) {
removeEventListener(element, key, value, key.endsWith('Capture'));
} else if (!FILTERED_ATTRIBUTES.has(key)) {
element.removeAttribute(key);
}
}
function updateClassName(element: DOMElement, value: string, namespace?: string) {
if (namespace === SVG_NAMESPACE) {
element.setAttribute('class', value);
return;
}
const htmlElement = element as HTMLElement;
const extra = extraClasses.get(element);
if (!extra) {
htmlElement.className = value;
return;
}
const extraArray = Array.from(extra);
if (value) {
extraArray.push(value);
}
htmlElement.className = extraArray.join(' ');
}
function updateStyle(element: DOMElement, value: string) {
element.style.cssText = value;
const extraObject = extraStyles.get(element);
if (extraObject) {
applyExtraStyles(element);
}
}
export function addExtraClass(element: DOMElement, className: string) {
element.classList.add(className);
const classList = extraClasses.get(element);
if (classList) {
classList.add(className);
} else {
extraClasses.set(element, new Set([className]));
}
}
export function removeExtraClass(element: DOMElement, className: string) {
element.classList.remove(className);
const classList = extraClasses.get(element);
if (classList) {
classList.delete(className);
if (!classList.size) {
extraClasses.delete(element);
}
}
}
export function toggleExtraClass(element: DOMElement, className: string, force?: boolean) {
if (force === true) {
addExtraClass(element, className);
} else if (force === false) {
removeExtraClass(element, className);
} else if (extraClasses.get(element)?.has(className)) {
removeExtraClass(element, className);
} else {
addExtraClass(element, className);
}
}
export function setExtraStyles(element: DOMElement, styles: Partial<CSSStyleDeclaration> & AnyLiteral) {
extraStyles.set(element, styles);
applyExtraStyles(element);
}
function applyExtraStyles(element: DOMElement) {
const standardStyles = Object.entries(extraStyles.get(element)!).reduce<Record<string, string>>(
(acc, [prop, value]) => {
if (prop.startsWith('--')) {
element.style.setProperty(prop, value);
} else {
acc[prop] = value;
}
return acc;
},
{},
);
Object.assign(element.style, standardStyles);
}
function DEBUG_addToVirtualTreeSize($current: VirtualElementParent | VirtualDomHead) {
DEBUG_virtualTreeSize += $current.children.length;
$current.children.forEach(($child) => {
if (isParentElement($child)) {
DEBUG_addToVirtualTreeSize($child);
}
});
}
/** Returns unique and not missing key for each child */
function getChildKeysByIndex(children: VirtualElementChildren) {
// The caching makes sense, because each children list is handled at least twice (as the new and the current children)
let uniqueKeysByIndex = uniqueChildKeysCache.get(children);
if (uniqueKeysByIndex) return uniqueKeysByIndex;
const seenKeys = new Set<any>();
const DEBUG_duplicatedKeys = new Set<any>();
uniqueKeysByIndex = children.map(($child, index) => {
let key = getElementKey($child);
if (isNullable(key)) {
if (DEBUG && isParentElement($child)) {
// eslint-disable-next-line no-console
console.warn('Missing `key` in `teactFastList`');
}
key = `${INDEX_KEY_PREFIX}${index}`;
} else {
if (seenKeys.has(key)) {
if (DEBUG) {
DEBUG_duplicatedKeys.add(key);
}
key = `${INDEX_KEY_PREFIX}${index}`;
} else {
seenKeys.add(key);
}
}
return key;
});
if (DEBUG && DEBUG_duplicatedKeys.size) {
// eslint-disable-next-line no-console
console.warn('[Teact] Duplicated keys:', [...DEBUG_duplicatedKeys], children);
throw new Error('[Teact] Children keys are not unique');
}
uniqueChildKeysCache.set(children, uniqueKeysByIndex);
return uniqueKeysByIndex;
}
function getElementKey($element: VirtualElement) {
return 'props' in $element ? $element.props.key : undefined;
}
function isNullable(value: unknown): value is undefined | null {
// eslint-disable-next-line no-null/no-null
return value === undefined || value === null;
}
const TeactDOM = { render };
export default TeactDOM;