@coreui/angular 5.7.12 → 5.7.13

package/fesm2022/coreui-angular.mjs

@@ -1,12 +1,12 @@
 import * as i0 from '@angular/core';
-import { inject, ElementRef, Directive, input, Renderer2, effect, TemplateRef, booleanAttribute, untracked, NgModule, computed, Injectable, Component, afterNextRender, linkedSignal, output, signal, contentChildren, numberAttribute, MAX_ANIMATION_TIMEOUT, DestroyRef, DOCUMENT, PLATFORM_ID, RendererFactory2, forwardRef, NgZone, ChangeDetectorRef, contentChild, afterEveryRender, viewChild, ViewContainerRef, model, afterRenderEffect, ChangeDetectionStrategy, Pipe, Input, HostBinding, ContentChildren, HostListener, Injector, runInInjectionContext, ViewEncapsulation } from '@angular/core';
+import { inject, ElementRef, Directive, input, Renderer2, effect, TemplateRef, booleanAttribute, untracked, NgModule, computed, Injectable, Component, linkedSignal, output, signal, contentChildren, numberAttribute, MAX_ANIMATION_TIMEOUT, DestroyRef, DOCUMENT, PLATFORM_ID, RendererFactory2, afterNextRender, forwardRef, NgZone, ChangeDetectorRef, contentChild, afterEveryRender, viewChild, ViewContainerRef, model, afterRenderEffect, ChangeDetectionStrategy, Pipe, Input, HostBinding, ContentChildren, HostListener, Injector, runInInjectionContext, ViewEncapsulation } from '@angular/core';
 import { NgTemplateOutlet, isPlatformServer, isPlatformBrowser } from '@angular/common';
-import { animation, animate, style, AnimationBuilder, useAnimation, group, query, trigger, state, transition, animateChild } from '@angular/animations';
 import { takeUntilDestroyed, toSignal, toObservable } from '@angular/core/rxjs-interop';
 import { fromEvent, Subject, BehaviorSubject, merge, takeWhile, skipWhile } from 'rxjs';
 import * as i1 from '@angular/router';
 import { RouterModule, Router, ActivatedRoute, NavigationEnd, RouterLink } from '@angular/router';
 import { filter, tap, finalize, zipWith, withLatestFrom, debounceTime } from 'rxjs/operators';
+import { animation, group, query, animate, style, trigger, state, transition, useAnimation, animateChild } from '@angular/animations';
 import { createPopper } from '@popperjs/core';
 import * as i1$1 from '@angular/cdk/a11y';
 import { FocusKeyManager, FocusMonitor, A11yModule } from '@angular/cdk/a11y';
@@ -261,74 +261,62 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.0", ngImpor
             args: [{ selector: 'c-accordion', template: '<ng-content />', exportAs: 'cAccordionItem', providers: [AccordionService], host: { '[class]': 'hostClasses()' }, styles: [":host{display:block}\n"] }]
         }], propDecorators: { flush: [{ type: i0.Input, args: [{ isSignal: true, alias: "flush", required: false }] }], alwaysOpen: [{ type: i0.Input, args: [{ isSignal: true, alias: "alwaysOpen", required: false }] }] } });
 
-const expandAnimation = animation([animate('{{ time }} {{ easing }}')]);
-const collapseAnimation = animation([
-    style({ height: '*', minHeight: '*' }),
-    animate('{{ time }} {{ easing }}', style({ height: 0, minHeight: 0 }))
-]);
-const expandHorizontalAnimation = animation([animate('{{ time }} {{ easing }}')]);
-const collapseHorizontalAnimation = animation([animate('{{ time }} {{ easing }}')]);
-
 class CollapseDirective {
-    #animationBuilder = inject(AnimationBuilder);
+    static ngAcceptInputType_animate;
+    static ngAcceptInputType_horizontal;
+    static ngAcceptInputType_navbar;
+    static ngAcceptInputType_visible;
     #hostElement = inject(ElementRef);
     #renderer = inject(Renderer2);
-    #player = undefined;
-    constructor() {
-        afterNextRender({
-            read: () => {
-                this.#initialized.set(true);
-            }
-        });
-    }
+    #unlistenTransitionEnd;
+    #isFirstChange = true;
     /**
-     * @ignore
+     * @ignore internal
      */
     animateInput = input(true, { ...(ngDevMode ? { debugName: "animateInput" } : /* istanbul ignore next */ {}), transform: booleanAttribute, alias: 'animate' });
-    animate = linkedSignal({ ...(ngDevMode ? { debugName: "animate" } : /* istanbul ignore next */ {}), source: this.animateInput,
-        computation: (value) => value });
+    animate = linkedSignal(this.animateInput, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "animate" }] : /* istanbul ignore next */ []));
     /**
      * Set horizontal collapsing to transition the width instead of height.
-     * @type boolean
+     * @return boolean
      * @default false
      */
     horizontal = input(false, { ...(ngDevMode ? { debugName: "horizontal" } : /* istanbul ignore next */ {}), transform: booleanAttribute });
     /**
-     * Toggle the visibility of collapsible element.
-     * @type boolean
+     * Toggle the visibility of a collapsible element.
+     * @return boolean
      * @default false
      */
     visibleInput = input(false, { ...(ngDevMode ? { debugName: "visibleInput" } : /* istanbul ignore next */ {}), transform: booleanAttribute, alias: 'visible' });
+    /**
+     * Event emitted on visibility change. [docs]
+     * @return boolean
+     */
     visibleChange = output();
-    visible = linkedSignal({ ...(ngDevMode ? { debugName: "visible" } : /* istanbul ignore next */ {}), source: this.visibleInput, computation: (value) => value });
-    #initialized = signal(false, /* @ts-ignore */
-    ...(ngDevMode ? [{ debugName: "#initialized" }] : /* istanbul ignore next */ []));
+    visible = linkedSignal(this.visibleInput, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "visible" }] : /* istanbul ignore next */ []));
     #visibleEffect = effect(() => {
         const visible = this.visible();
-        if (this.#initialized()) {
-            this.createPlayer(visible);
+        if (this.#isFirstChange || !untracked(() => this.animate())) {
+            // no transition
+            this.#isFirstChange = false;
+            this.setInitialState(visible);
+            return;
         }
+        untracked(() => {
+            this.runTransition(visible);
+        });
     }, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "#visibleEffect" }] : /* istanbul ignore next */ []));
     /**
-     * Add `navbar` prop for grouping and hiding navbar contents by a parent breakpoint.
-     * @type boolean
+     * Add a `navbar` prop for grouping and hiding navbar contents by a parent breakpoint.
+     * @return boolean
      * @default false
      */
     navbar = input(false, { ...(ngDevMode ? { debugName: "navbar" } : /* istanbul ignore next */ {}), transform: booleanAttribute });
-    /**
-     * @ignore
-     */
-    duration = input('350ms', /* @ts-ignore */
-    ...(ngDevMode ? [{ debugName: "duration" }] : /* istanbul ignore next */ []));
-    /**
-     * @ignore
-     */
-    transition = input('ease', /* @ts-ignore */
-    ...(ngDevMode ? [{ debugName: "transition" }] : /* istanbul ignore next */ []));
     /**
      * Event emitted on visibility change. [docs]
-     * @type string
+     * @return string
      */
     collapseChange = output();
     hostClasses = computed(() => {
@@ -339,60 +327,88 @@ class CollapseDirective {
     }, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "hostClasses" }] : /* istanbul ignore next */ []));
     ngOnDestroy() {
-        this.destroyPlayer();
+        this.clearPendingCallbacks();
     }
     toggle(visible = !this.visible()) {
         this.visible.set(visible);
     }
-    destroyPlayer() {
-        this.#player?.destroy();
-        this.#player = undefined;
+    clearPendingCallbacks() {
+        this.#unlistenTransitionEnd?.();
+        this.#unlistenTransitionEnd = undefined;
     }
-    createPlayer(visible = this.visible()) {
-        if (this.#player?.hasStarted()) {
-            this.destroyPlayer();
-        }
+    setInitialState(visible) {
         const host = this.#hostElement.nativeElement;
+        this.#renderer.addClass(host, 'collapse');
+        this.#renderer.removeClass(host, 'collapsing');
         if (visible) {
-            this.#renderer.removeStyle(host, 'display');
+            this.#renderer.addClass(host, 'show');
         }
-        const duration = this.animate() ? this.duration() : '0ms';
-        const expand = this.horizontal() ? expandHorizontalAnimation : expandAnimation;
-        const collapse = this.horizontal() ? collapseHorizontalAnimation : collapseAnimation;
+        else {
+            this.#renderer.removeClass(host, 'show');
+        }
+    }
+    runTransition(visible) {
+        this.clearPendingCallbacks();
+        const host = this.#hostElement.nativeElement;
         const dimension = this.horizontal() ? 'width' : 'height';
         const capitalizedDimension = dimension[0].toUpperCase() + dimension.slice(1);
         const scrollSize = `scroll${capitalizedDimension}`;
-        const animationFactory = this.#animationBuilder?.build(useAnimation(visible ? expand : collapse, { params: { time: duration, easing: this.transition() } }));
-        this.#player = animationFactory.create(host);
-        !visible && host.offsetHeight && host.style[dimension] && host.scrollHeight;
-        this.#renderer.setStyle(host, dimension, visible ? 0 : `${host.getBoundingClientRect()[dimension]}px`);
-        this.#player.onStart(() => {
+        const animate = this.animate();
+        if (visible) {
             this.setMaxSize();
+            // Switch off `collapse`/`show` before we measure its scroll size below.
             this.#renderer.removeClass(host, 'collapse');
+            this.#renderer.removeClass(host, 'show');
             this.#renderer.addClass(host, 'collapsing');
+            this.collapseChange?.emit('opening');
+            // Reading scrollHeight/scrollWidth forces a synchronous reflow, committing the 0-size
+            // starting point before we set the target size below, so the browser animates the change.
+            const targetSize = host[scrollSize];
+            this.#renderer.setStyle(host, dimension, `${targetSize}px`);
+        }
+        else {
+            // Lock in the current pixel size first so the browser has a committed starting point,
+            // then switch to the collapsing state and clear it so the size can animate down to 0.
+            const startSize = host.getBoundingClientRect()[dimension];
+            this.#renderer.setStyle(host, dimension, `${startSize}px`);
+            // Force a reflow so the browser registers the starting size before the next style change.
+            // eslint-disable-next-line @typescript-eslint/no-unused-expressions
+            host.offsetHeight;
+            this.#renderer.removeClass(host, 'collapse');
             this.#renderer.removeClass(host, 'show');
-            this.#renderer.setStyle(host, dimension, visible ? `${host[scrollSize]}px` : '');
-            if (this.#player) {
-                this.collapseChange?.emit(visible ? 'opening' : 'collapsing');
-            }
-        });
-        this.#player.onDone(() => {
-            this.#renderer.removeClass(host, 'collapsing');
-            this.#renderer.addClass(host, 'collapse');
-            if (visible) {
-                this.#renderer.addClass(host, 'show');
-                this.#renderer.setStyle(host, dimension, '');
-            }
-            else {
-                this.#renderer.removeClass(host, 'show');
-            }
-            if (this.#player) {
-                this.collapseChange?.emit(visible ? 'open' : 'collapsed');
-                this.visibleChange?.emit(visible);
-            }
-            this.destroyPlayer();
-        });
-        this.#player?.play();
+            this.#renderer.addClass(host, 'collapsing');
+            this.collapseChange?.emit('collapsing');
+            // Now that the starting size is committed, set the target size (0) so the browser
+            // animates the transition down.
+            this.#renderer.setStyle(host, dimension, '0px');
+        }
+        const finish = () => this.finishTransition(visible, host, dimension);
+        if (animate) {
+            this.#unlistenTransitionEnd = this.#renderer.listen(host, 'transitionend', (event) => {
+                // Ignore bubbled transitionend events from descendant elements.
+                if (event.target === host && event.propertyName === dimension) {
+                    finish();
+                }
+            });
+        }
+        else {
+            finish();
+        }
+    }
+    finishTransition(visible, host, dimension) {
+        this.clearPendingCallbacks();
+        this.#renderer.removeClass(host, 'collapsing');
+        this.#renderer.addClass(host, 'collapse');
+        if (visible) {
+            this.#renderer.addClass(host, 'show');
+        }
+        else {
+            this.#renderer.removeClass(host, 'show');
+        }
+        this.#renderer.removeStyle(host, 'transition');
+        this.#renderer.removeStyle(host, dimension);
+        this.collapseChange?.emit(visible ? 'open' : 'collapsed');
+        this.visibleChange?.emit(visible);
     }
     setMaxSize() {
         const host = this.#hostElement.nativeElement;
@@ -403,16 +419,16 @@ class CollapseDirective {
         }
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.1.0", ngImport: i0, type: CollapseDirective, deps: [], target: i0.ɵɵFactoryTarget.Directive });
-    static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "17.1.0", version: "22.1.0", type: CollapseDirective, isStandalone: true, selector: "[cCollapse]", inputs: { animateInput: { classPropertyName: "animateInput", publicName: "animate", isSignal: true, isRequired: false, transformFunction: null }, horizontal: { classPropertyName: "horizontal", publicName: "horizontal", isSignal: true, isRequired: false, transformFunction: null }, visibleInput: { classPropertyName: "visibleInput", publicName: "visible", isSignal: true, isRequired: false, transformFunction: null }, navbar: { classPropertyName: "navbar", publicName: "navbar", isSignal: true, isRequired: false, transformFunction: null }, duration: { classPropertyName: "duration", publicName: "duration", isSignal: true, isRequired: false, transformFunction: null }, transition: { classPropertyName: "transition", publicName: "transition", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { visibleChange: "visibleChange", collapseChange: "collapseChange" }, host: { properties: { "class": "hostClasses()", "style": "{ display: \"none\" }" } }, exportAs: ["cCollapse"], ngImport: i0 });
+    static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "17.1.0", version: "22.1.0", type: CollapseDirective, isStandalone: true, selector: "[cCollapse]", inputs: { animateInput: { classPropertyName: "animateInput", publicName: "animate", isSignal: true, isRequired: false, transformFunction: null }, horizontal: { classPropertyName: "horizontal", publicName: "horizontal", isSignal: true, isRequired: false, transformFunction: null }, visibleInput: { classPropertyName: "visibleInput", publicName: "visible", isSignal: true, isRequired: false, transformFunction: null }, navbar: { classPropertyName: "navbar", publicName: "navbar", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { visibleChange: "visibleChange", collapseChange: "collapseChange" }, host: { properties: { "class": "hostClasses()" } }, exportAs: ["cCollapse"], ngImport: i0 });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.0", ngImport: i0, type: CollapseDirective, decorators: [{
             type: Directive,
             args: [{
                     selector: '[cCollapse]',
                     exportAs: 'cCollapse',
-                    host: { '[class]': 'hostClasses()', '[style]': '{ display: "none" }' }
+                    host: { '[class]': 'hostClasses()' }
                 }]
-        }], ctorParameters: () => [], propDecorators: { animateInput: [{ type: i0.Input, args: [{ isSignal: true, alias: "animate", required: false }] }], horizontal: [{ type: i0.Input, args: [{ isSignal: true, alias: "horizontal", required: false }] }], visibleInput: [{ type: i0.Input, args: [{ isSignal: true, alias: "visible", required: false }] }], visibleChange: [{ type: i0.Output, args: ["visibleChange"] }], navbar: [{ type: i0.Input, args: [{ isSignal: true, alias: "navbar", required: false }] }], duration: [{ type: i0.Input, args: [{ isSignal: true, alias: "duration", required: false }] }], transition: [{ type: i0.Input, args: [{ isSignal: true, alias: "transition", required: false }] }], collapseChange: [{ type: i0.Output, args: ["collapseChange"] }] } });
+        }], propDecorators: { animateInput: [{ type: i0.Input, args: [{ isSignal: true, alias: "animate", required: false }] }], horizontal: [{ type: i0.Input, args: [{ isSignal: true, alias: "horizontal", required: false }] }], visibleInput: [{ type: i0.Input, args: [{ isSignal: true, alias: "visible", required: false }] }], visibleChange: [{ type: i0.Output, args: ["visibleChange"] }], navbar: [{ type: i0.Input, args: [{ isSignal: true, alias: "navbar", required: false }] }], collapseChange: [{ type: i0.Output, args: ["collapseChange"] }] } });
 
 class CollapseModule {
     static forRoot() {
@@ -473,7 +489,7 @@ class AccordionItemComponent {
         this.#accordionService.toggleItem(this);
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.1.0", ngImport: i0, type: AccordionItemComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.2.0", version: "22.1.0", type: AccordionItemComponent, isStandalone: true, selector: "c-accordion-item", inputs: { visibleInput: { classPropertyName: "visibleInput", publicName: "visible", isSignal: true, isRequired: false, transformFunction: null } }, host: { classAttribute: "accordion-item" }, queries: [{ propertyName: "contentTemplates", predicate: TemplateIdDirective, descendants: true, isSignal: true }], exportAs: ["cAccordionItem"], ngImport: i0, template: "@let tmpl = templates();\n<ng-container>\n  <div class=\"accordion-header\">\n    <ng-container *ngTemplateOutlet=\"tmpl['accordionHeaderTemplate'] || defaultAccordionHeaderTemplate; context: itemContext\" />\n  </div>\n  <div class=\"accordion-collapse\" cCollapse [visible]=\"itemVisible()\" [attr.aria-expanded]=\"itemVisible()\" [id]=\"contentId\">\n    <ng-container *ngTemplateOutlet=\"tmpl['accordionBodyTemplate'] || defaultAccordionBodyTemplate; context: itemContext\" />\n  </div>\n</ng-container>\n\n<ng-template #defaultAccordionHeaderTemplate>\n  <button cAccordionButton [collapsed]=\"!itemVisible()\" [attr.aria-controls]=\"contentId\" (click)=\"toggleItem()\">\n    <ng-container *ngTemplateOutlet=\"tmpl['accordionHeader'] || defaultAccordionHeaderContentTemplate; context: itemContext\" />\n  </button>\n</ng-template>\n\n<ng-template #defaultAccordionHeaderContentTemplate>\n  <ng-content />\n</ng-template>\n\n<ng-template #defaultAccordionBodyTemplate>\n  <div class=\"accordion-body\">\n    <ng-container *ngTemplateOutlet=\"tmpl['accordionBody'] || defaultAccordionBodyContentTemplate; context: itemContext\" />\n  </div>\n</ng-template>\n\n<ng-template #defaultAccordionBodyContentTemplate>\n  <ng-content />\n</ng-template>\n", styles: [":host{display:block;overflow:hidden}\n"], dependencies: [{ kind: "directive", type: AccordionButtonDirective, selector: "[cAccordionButton]", inputs: ["collapsed", "type"] }, { kind: "directive", type: NgTemplateOutlet, selector: "[ngTemplateOutlet]", inputs: ["ngTemplateOutletContext", "ngTemplateOutlet", "ngTemplateOutletInjector"] }, { kind: "directive", type: CollapseDirective, selector: "[cCollapse]", inputs: ["animate", "horizontal", "visible", "navbar", "duration", "transition"], outputs: ["visibleChange", "collapseChange"], exportAs: ["cCollapse"] }] });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.2.0", version: "22.1.0", type: AccordionItemComponent, isStandalone: true, selector: "c-accordion-item", inputs: { visibleInput: { classPropertyName: "visibleInput", publicName: "visible", isSignal: true, isRequired: false, transformFunction: null } }, host: { classAttribute: "accordion-item" }, queries: [{ propertyName: "contentTemplates", predicate: TemplateIdDirective, descendants: true, isSignal: true }], exportAs: ["cAccordionItem"], ngImport: i0, template: "@let tmpl = templates();\n<ng-container>\n  <div class=\"accordion-header\">\n    <ng-container *ngTemplateOutlet=\"tmpl['accordionHeaderTemplate'] || defaultAccordionHeaderTemplate; context: itemContext\" />\n  </div>\n  <div class=\"accordion-collapse\" cCollapse [visible]=\"itemVisible()\" [attr.aria-expanded]=\"itemVisible()\" [id]=\"contentId\">\n    <ng-container *ngTemplateOutlet=\"tmpl['accordionBodyTemplate'] || defaultAccordionBodyTemplate; context: itemContext\" />\n  </div>\n</ng-container>\n\n<ng-template #defaultAccordionHeaderTemplate>\n  <button cAccordionButton [collapsed]=\"!itemVisible()\" [attr.aria-controls]=\"contentId\" (click)=\"toggleItem()\">\n    <ng-container *ngTemplateOutlet=\"tmpl['accordionHeader'] || defaultAccordionHeaderContentTemplate; context: itemContext\" />\n  </button>\n</ng-template>\n\n<ng-template #defaultAccordionHeaderContentTemplate>\n  <ng-content />\n</ng-template>\n\n<ng-template #defaultAccordionBodyTemplate>\n  <div class=\"accordion-body\">\n    <ng-container *ngTemplateOutlet=\"tmpl['accordionBody'] || defaultAccordionBodyContentTemplate; context: itemContext\" />\n  </div>\n</ng-template>\n\n<ng-template #defaultAccordionBodyContentTemplate>\n  <ng-content />\n</ng-template>\n", styles: [":host{display:block;overflow:hidden}\n"], dependencies: [{ kind: "directive", type: AccordionButtonDirective, selector: "[cAccordionButton]", inputs: ["collapsed", "type"] }, { kind: "directive", type: NgTemplateOutlet, selector: "[ngTemplateOutlet]", inputs: ["ngTemplateOutletContext", "ngTemplateOutlet", "ngTemplateOutletInjector"] }, { kind: "directive", type: CollapseDirective, selector: "[cCollapse]", inputs: ["animate", "horizontal", "visible", "navbar"], outputs: ["visibleChange", "collapseChange"], exportAs: ["cCollapse"] }] });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.0", ngImport: i0, type: AccordionItemComponent, decorators: [{
             type: Component,
@@ -5055,12 +5071,11 @@ class NavbarComponent {
             if (!collapse) {
                 return;
             }
-            const animate = collapse.animate();
             collapse.animate.set(false);
             collapse.toggle(false);
             setTimeout(() => {
                 collapse.toggle(result.matches);
-                setTimeout(() => collapse.animate.set(animate));
+                setTimeout(() => collapse.animate.set(collapse.animateInput()));
             });
         });
         onCleanup(() => subscription.unsubscribe());
@@ -5141,27 +5156,29 @@ class NavbarTogglerDirective {
     }
     /**
      * Reference to navbar collapse element (via # template variable) . [docs]
-     * @type string
+     * @return string
      * @default 'button'
      */
     collapseRef = input(undefined, { ...(ngDevMode ? { debugName: "collapseRef" } : /* istanbul ignore next */ {}), alias: 'cNavbarToggler' });
     /**
      * Default type for navbar-toggler. [docs]
-     * @type string
+     * @return string
      * @default 'button'
      */
     type = input('button', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "type" }] : /* istanbul ignore next */ []));
     /**
      * Default aria-label attr for navbar-toggler. [docs]
-     * @type string
+     * @return string
      * @default 'Toggle navigation'
      */
     ariaLabel = input('Toggle navigation', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "ariaLabel" }] : /* istanbul ignore next */ []));
     handleClick($event) {
         const collapseRef = this.collapseRef();
-        collapseRef?.toggle(!collapseRef?.visible());
+        if (collapseRef) {
+            collapseRef?.toggle(!collapseRef?.visible());
+        }
     }
     addDefaultIcon() {
         const span = this.#renderer.createElement('span');