Skip to main content

Function: group()

group<T extends readonly (false | ReactiveElementBase | readonly ReactiveElementBase[] | GroupElement<ReactiveElementBase> | null | undefined)[]>(...items: T): GroupElement<Extract<T[number], ReactiveElementBase> | Extract<T[number], readonly ReactiveElementBase[]>[number] | Extract<T[number], GroupElement<ReactiveElementBase>>["elements"][number]>

Creates a zero-DOM logical group proxy over multiple stage elements. Grouping allows broadcasting transitions, property mutations, and decorators across elements without adding container elements to the DOM tree.

Type Parameters​

Type Parameter
T extends readonly (false | ReactiveElementBase | readonly ReactiveElementBase[] | GroupElement<ReactiveElementBase> | null | undefined)[]

Parameters​

ParameterType
...itemsT

Returns​

GroupElement<Extract<T[number], ReactiveElementBase> | Extract<T[number], readonly ReactiveElementBase[]>[number] | Extract<T[number], GroupElement<ReactiveElementBase>>["elements"][number]>