@vaadin/icon 23.2.16 → 23.2.17

package/README.md

@@ -28,7 +28,7 @@ import '@vaadin/icon';
 ## Themes
 
 Vaadin components come with two built-in [themes](https://vaadin.com/docs/latest/styling), Lumo and Material.
-The [main entrypoint](https://github.com/vaadin/web-components/blob/main/packages/icon/vaadin-icon.js) of the package uses the Lumo theme.
+The [main entrypoint](https://github.com/vaadin/web-components/blob/master/packages/icon/vaadin-icon.js) of the package uses the Lumo theme.
 
 To use the Material theme, import the component from the `theme/material` folder:
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vaadin/icon",
-  "version": "23.2.16",
+  "version": "23.2.17",
   "publishConfig": {
     "access": "public"
   },
@@ -35,19 +35,17 @@
   ],
   "dependencies": {
     "@polymer/polymer": "^3.0.0",
-    "@vaadin/component-base": "~23.2.16",
-    "@vaadin/vaadin-lumo-styles": "~23.2.16",
-    "@vaadin/vaadin-themable-mixin": "~23.2.16",
+    "@vaadin/component-base": "~23.2.17",
+    "@vaadin/vaadin-lumo-styles": "~23.2.17",
+    "@vaadin/vaadin-themable-mixin": "~23.2.17",
     "lit": "^2.0.0"
   },
   "devDependencies": {
-    "@esm-bundle/chai": "^4.3.4",
-    "@vaadin/testing-helpers": "^0.4.0",
-    "sinon": "^13.0.2"
+    "@vaadin/testing-helpers": "^0.3.2"
   },
   "web-types": [
     "web-types.json",
     "web-types.lit.json"
   ],
-  "gitHead": "57010013e59a3ecdc70ceef4377dbc3b1ac03fb3"
+  "gitHead": "60bf51d55e8b93a30536ebb4966248ba256c9b5d"
 }

package/src/vaadin-icon-svg.d.ts

@@ -1,6 +1,6 @@
 /**
  * @license
- * Copyright (c) 2021 - 2023 Vaadin Ltd.
+ * Copyright (c) 2021 - 2022 Vaadin Ltd.
  * This program is available under Apache License Version 2.0, available at https://vaadin.com/license/
  */
 import type { nothing, SVGTemplateResult } from 'lit';

package/src/vaadin-icon-svg.js

@@ -1,6 +1,6 @@
 /**
  * @license
- * Copyright (c) 2021 - 2023 Vaadin Ltd.
+ * Copyright (c) 2021 - 2022 Vaadin Ltd.
  * This program is available under Apache License Version 2.0, available at https://vaadin.com/license/
  */
 import { nothing, render, svg } from 'lit';

package/src/vaadin-icon.d.ts

@@ -1,9 +1,8 @@
 /**
  * @license
- * Copyright (c) 2021 - 2023 Vaadin Ltd.
+ * Copyright (c) 2021 - 2022 Vaadin Ltd.
  * This program is available under Apache License Version 2.0, available at https://vaadin.com/license/
  */
-import { ControllerMixin } from '@vaadin/component-base/src/controller-mixin.js';
 import { ElementMixin } from '@vaadin/component-base/src/element-mixin.js';
 import { ThemableMixin } from '@vaadin/vaadin-themable-mixin/vaadin-themable-mixin.js';
 import type { IconSvgLiteral } from './vaadin-icon-svg.js';
@@ -47,7 +46,7 @@ import type { IconSvgLiteral } from './vaadin-icon-svg.js';
  * }
  * ```
  */
-declare class Icon extends ThemableMixin(ElementMixin(ControllerMixin(HTMLElement))) {
+declare class Icon extends ThemableMixin(ElementMixin(HTMLElement)) {
   /**
    * The name of the icon to use. The name should be of the form:
    * `iconset_name:icon_name`. When using `vaadin-icons` it is possible

package/src/vaadin-icon.js

@@ -1,16 +1,16 @@
 /**
  * @license
- * Copyright (c) 2021 - 2023 Vaadin Ltd.
+ * Copyright (c) 2021 - 2022 Vaadin Ltd.
  * This program is available under Apache License Version 2.0, available at https://vaadin.com/license/
  */
 import { html, PolymerElement } from '@polymer/polymer/polymer-element.js';
-import { ControllerMixin } from '@vaadin/component-base/src/controller-mixin.js';
 import { ElementMixin } from '@vaadin/component-base/src/element-mixin.js';
-import { TooltipController } from '@vaadin/component-base/src/tooltip-controller.js';
 import { ThemableMixin } from '@vaadin/vaadin-themable-mixin/vaadin-themable-mixin.js';
 import { ensureSvgLiteral, renderSvg } from './vaadin-icon-svg.js';
 import { Iconset } from './vaadin-iconset.js';
 
+const DEFAULT_ICONSET = 'vaadin';
+
 /**
  * `<vaadin-icon>` is a Web Component for displaying SVG icons.
  *
@@ -51,11 +51,10 @@ import { Iconset } from './vaadin-iconset.js';
  * ```
  *
  * @extends HTMLElement
- * @mixes ControllerMixin
  * @mixes ThemableMixin
  * @mixes ElementMixin
  */
-class Icon extends ThemableMixin(ElementMixin(ControllerMixin(PolymerElement))) {
+class Icon extends ThemableMixin(ElementMixin(PolymerElement)) {
   static get template() {
     return html`
       <style>
@@ -88,8 +87,6 @@ class Icon extends ThemableMixin(ElementMixin(ControllerMixin(PolymerElement)))
         preserveAspectRatio="xMidYMid meet"
         aria-hidden="true"
       ></svg>
-
-      <slot name="tooltip"></slot>
     `;
   }
 
@@ -141,53 +138,79 @@ class Icon extends ThemableMixin(ElementMixin(ControllerMixin(PolymerElement)))
     return ['__svgChanged(svg, __svgElement)'];
   }
 
+  constructor() {
+    super();
+    this.__onIconsetRegistered = this.__onIconsetRegistered.bind(this);
+  }
+
   /** @protected */
   ready() {
     super.ready();
     this.__svgElement = this.shadowRoot.querySelector('svg');
+  }
+
+  /** @private */
+  __getIconsetName(icon) {
+    if (!icon) {
+      return;
+    }
 
-    this._tooltipController = new TooltipController(this);
-    this.addController(this._tooltipController);
+    const parts = icon.split(':');
+    return parts[0] || DEFAULT_ICONSET;
+  }
+
+  /** @private */
+  __onIconsetRegistered(e) {
+    if (e.detail === this.__getIconsetName(this.icon)) {
+      this.__iconChanged(this.icon);
+    }
   }
 
   /** @protected */
   connectedCallback() {
     super.connectedCallback();
-
-    Iconset.attachedIcons.add(this);
+    document.addEventListener('vaadin-iconset-registered', this.__onIconsetRegistered);
   }
 
   /** @protected */
   disconnectedCallback() {
     super.disconnectedCallback();
-
-    Iconset.attachedIcons.delete(this);
-  }
-
-  /** @protected */
-  _applyIcon() {
-    const { svg, size, viewBox } = Iconset.getIconSvg(this.icon);
-
-    if (viewBox) {
-      this.__viewBox = viewBox;
-    }
-
-    if (size && size !== this.size) {
-      this.size = size;
-    }
-
-    this.svg = svg;
+    document.removeEventListener('vaadin-iconset-registered', this.__onIconsetRegistered);
   }
 
   /** @private */
   __iconChanged(icon) {
     if (icon) {
-      this._applyIcon();
+      this.__checkDeprecatedIcon(icon);
+      const iconsetName = this.__getIconsetName(icon);
+      const iconset = Iconset.getIconset(iconsetName);
+      const { svg, size, viewBox } = iconset.applyIcon(icon);
+      if (viewBox) {
+        this.__viewBox = viewBox;
+      }
+      if (size !== this.size) {
+        this.size = size;
+      }
+      this.svg = svg;
     } else {
       this.svg = ensureSvgLiteral(null);
     }
   }
 
+  /** @private */
+  __checkDeprecatedIcon(icon) {
+    const deprecatedIcons = {
+      'vaadin:buss': 'vaadin:bus',
+      'vaadin:funcion': 'vaadin:function',
+      'vaadin:megafone': 'vaadin:megaphone',
+      'vaadin:palete': 'vaadin:palette',
+      'vaadin:trendind-down': 'vaadin:trending-down',
+    };
+    if (icon in deprecatedIcons) {
+      console.warn(`WARNING: The icon "${icon}" is deprecated. Use "${deprecatedIcons[icon]}" instead`);
+    }
+  }
+
   /** @private */
   __svgChanged(svg, svgElement) {
     if (!svgElement) {

package/src/vaadin-iconset.d.ts

@@ -1,10 +1,9 @@
 /**
  * @license
- * Copyright (c) 2021 - 2023 Vaadin Ltd.
+ * Copyright (c) 2021 - 2022 Vaadin Ltd.
  * This program is available under Apache License Version 2.0, available at https://vaadin.com/license/
  */
 import { ElementMixin } from '@vaadin/component-base/src/element-mixin.js';
-import type { Icon } from './vaadin-icon.js';
 import type { IconSvgLiteral } from './vaadin-icon-svg.js';
 
 /**
@@ -12,26 +11,10 @@ import type { IconSvgLiteral } from './vaadin-icon-svg.js';
  */
 declare class Iconset extends ElementMixin(HTMLElement) {
   /**
-   * Set of the `vaadin-icon` instances in the DOM.
-   */
-  static attachedIcons(): Set<Icon>;
-
-  /**
-   * Returns an instance of the iconset by its name.
+   * Create an instance of the iconset.
    */
   static getIconset(name: string): Iconset;
 
-  /**
-   * Register an iconset without adding to the DOM.
-   */
-  static register(name: string, size: number, template: HTMLTemplateElement): void;
-
-  /**
-   * Returns SVGTemplateResult for the `icon` ID matching `name` of the
-   * iconset, or `nothing` literal if there is no matching icon found.
-   */
-  static getIconSvg(icon: string, name?: string): { svg: IconSvgLiteral; size?: number; viewBox?: string | null };
-
   /**
    * The name of the iconset. Every iconset is required to have its own unique name.
    * All the SVG icons in the iconset must have IDs conforming to its name.
@@ -47,6 +30,12 @@ declare class Iconset extends ElementMixin(HTMLElement) {
    * over the size defined by the user to ensure correct appearance.
    */
   size: number;
+
+  /**
+   * Produce SVGTemplateResult for the element matching `name` in this
+   * iconset, or `undefined` if there is no matching element.
+   */
+  applyIcon(name: string): { svg: IconSvgLiteral; size: number; viewBox: string | null };
 }
 
 declare global {

package/src/vaadin-iconset.js

@@ -1,38 +1,13 @@
 /**
  * @license
- * Copyright (c) 2021 - 2023 Vaadin Ltd.
+ * Copyright (c) 2021 - 2022 Vaadin Ltd.
  * This program is available under Apache License Version 2.0, available at https://vaadin.com/license/
  */
 import { PolymerElement } from '@polymer/polymer/polymer-element.js';
 import { ElementMixin } from '@vaadin/component-base/src/element-mixin.js';
 import { cloneSvgNode } from './vaadin-icon-svg.js';
 
-const iconsetRegistry = {};
-
-const attachedIcons = new Set();
-
-function getIconId(id, name) {
-  return (id || '').replace(`${name}:`, '');
-}
-
-function getIconsetName(icon) {
-  if (!icon) {
-    return;
-  }
-
-  const parts = icon.split(':');
-
-  // Use "vaadin" as a fallback
-  return parts[0] || 'vaadin';
-}
-
-function initIconsMap(iconset, name) {
-  iconset._icons = [...iconset.querySelectorAll('[id]')].reduce((map, svg) => {
-    const key = getIconId(svg.id, name);
-    map[key] = svg;
-    return map;
-  }, {});
-}
+const iconRegistry = {};
 
 /**
  * `<vaadin-iconset>` is a Web Component for creating SVG icon collections.
@@ -76,72 +51,18 @@ class Iconset extends ElementMixin(PolymerElement) {
   }
 
   /**
-   * Set of the `vaadin-icon` instances in the DOM.
-   *
-   * @return {Set<Icon>}
-   */
-  static get attachedIcons() {
-    return attachedIcons;
-  }
-
-  /**
-   * Returns an instance of the iconset by its name.
+   * Create an instance of the iconset.
    *
    * @param {string} name
-   * @return {Iconset}
    */
   static getIconset(name) {
-    return iconsetRegistry[name];
-  }
-
-  /**
-   * Returns SVGTemplateResult for the `icon` ID matching `name` of the
-   * iconset, or `nothing` literal if there is no matching icon found.
-   *
-   * @param {string} icon
-   * @param {?string} name
-   */
-  static getIconSvg(icon, name) {
-    const iconsetName = name || getIconsetName(icon);
-    const iconset = this.getIconset(iconsetName);
-
-    if (!icon || !iconset) {
-      // Missing icon, return `nothing` literal.
-      return { svg: cloneSvgNode(null) };
-    }
-
-    const iconId = getIconId(icon, iconsetName);
-    const iconSvg = iconset._icons[iconId];
-
-    return {
-      svg: cloneSvgNode(iconSvg),
-      size: iconset.size,
-      viewBox: iconSvg ? iconSvg.getAttribute('viewBox') : null,
-    };
-  }
-
-  /**
-   * Register an iconset without adding to the DOM.
-   *
-   * @param {string} name
-   * @param {number} size
-   * @param {?HTMLTemplateElement} template
-   */
-  static register(name, size, template) {
-    if (!iconsetRegistry[name]) {
-      const iconset = document.createElement('vaadin-iconset');
-      iconset.appendChild(template.content.cloneNode(true));
-      iconsetRegistry[name] = iconset;
-
-      initIconsMap(iconset, name);
-
-      iconset.size = size;
+    let iconset = iconRegistry[name];
+    if (!iconset) {
+      iconset = document.createElement('vaadin-iconset');
       iconset.name = name;
-
-      // Call this function manually instead of using observer
-      // to make it work without appending element to the DOM.
-      iconset.__nameChanged(name);
+      iconRegistry[name] = iconset;
     }
+    return iconset;
   }
 
   /** @protected */
@@ -149,36 +70,51 @@ class Iconset extends ElementMixin(PolymerElement) {
     super.connectedCallback();
 
     this.style.display = 'none';
-
-    // Store reference and init icons.
-    const { name } = this;
-    iconsetRegistry[name] = this;
-    initIconsMap(this, name);
-    this.__updateIcons(name);
   }
 
   /**
-   * Update all the icons instances in the DOM.
+   * Produce SVGTemplateResult for the element matching `name` in this
+   * iconset, or `undefined` if there is no matching element.
    *
    * @param {string} name
-   * @private
    */
-  __updateIcons(name) {
-    attachedIcons.forEach((element) => {
-      if (name === getIconsetName(element.icon)) {
-        element._applyIcon();
-      }
+  applyIcon(name) {
+    // Create the icon map on-demand, since the iconset itself has no discrete
+    // signal to know when it's children are fully parsed
+    this._icons = this._icons || this.__createIconMap();
+    const icon = this._icons[this.__getIconId(name)];
+    return {
+      svg: cloneSvgNode(icon),
+      size: this.size,
+      viewBox: icon ? icon.getAttribute('viewBox') : null,
+    };
+  }
+
+  /**
+   * Create a map of child SVG elements by id.
+   */
+  __createIconMap() {
+    const icons = {};
+    this.querySelectorAll('[id]').forEach((icon) => {
+      icons[this.__getIconId(icon.id)] = icon;
     });
+    return icons;
+  }
+
+  /** @private */
+  __getIconId(id) {
+    return (id || '').replace(`${this.name}:`, '');
   }
 
   /** @private */
   __nameChanged(name, oldName) {
     if (oldName) {
-      iconsetRegistry[name] = iconsetRegistry[oldName];
-      delete iconsetRegistry[oldName];
+      iconRegistry[name] = Iconset.getIconset(oldName);
+      delete iconRegistry[oldName];
     }
     if (name) {
-      this.__updateIcons(name);
+      iconRegistry[name] = this;
+      document.dispatchEvent(new CustomEvent('vaadin-iconset-registered', { detail: name }));
     }
   }
 }

package/web-types.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/web-types",
   "name": "@vaadin/icon",
-  "version": "23.2.16",
+  "version": "23.2.17",
   "description-markup": "markdown",
   "contributions": {
     "html": {
@@ -12,7 +12,7 @@
           "attributes": [
             {
               "name": "name",
-              "description": "The name of the iconset. Every iconset is required to have its own unique name.\nAll the SVG icons in the iconset must have IDs conforming to its name.\n\nSee also [`name`](https://cdn.vaadin.com/vaadin-web-components/23.2.16/#/elements/vaadin-icon#property-name) property of `vaadin-icon`.",
+              "description": "The name of the iconset. Every iconset is required to have its own unique name.\nAll the SVG icons in the iconset must have IDs conforming to its name.\n\nSee also [`name`](https://cdn.vaadin.com/vaadin-web-components/23.2.17/#/elements/vaadin-icon#property-name) property of `vaadin-icon`.",
               "value": {
                 "type": [
                   "string",
@@ -48,7 +48,7 @@
             "properties": [
               {
                 "name": "name",
-                "description": "The name of the iconset. Every iconset is required to have its own unique name.\nAll the SVG icons in the iconset must have IDs conforming to its name.\n\nSee also [`name`](https://cdn.vaadin.com/vaadin-web-components/23.2.16/#/elements/vaadin-icon#property-name) property of `vaadin-icon`.",
+                "description": "The name of the iconset. Every iconset is required to have its own unique name.\nAll the SVG icons in the iconset must have IDs conforming to its name.\n\nSee also [`name`](https://cdn.vaadin.com/vaadin-web-components/23.2.17/#/elements/vaadin-icon#property-name) property of `vaadin-icon`.",
                 "value": {
                   "type": [
                     "string",
@@ -74,11 +74,11 @@
         },
         {
           "name": "vaadin-icon",
-          "description": "`<vaadin-icon>` is a Web Component for displaying SVG icons.\n\n### Icon property\n\nThe `<vaadin-icon>` component is designed to be used as a drop-in replacement for `<iron-icon>`.\nFor example, you can use it with `vaadin-icons` like this:\n\n```html\n<vaadin-icon icon=\"vaadin:angle-down\"></vaadin-icon>\n```\n\nAlternatively, you can also pick one of the Lumo icons:\n\n```html\n<vaadin-icon icon=\"lumo:user\"></vaadin-icon>\n```\n\n### Custom SVG icon\n\nAlternatively, instead of selecting an icon from an iconset by name, you can pass any custom `svg`\nliteral using the [`svg`](https://cdn.vaadin.com/vaadin-web-components/23.2.16/#/elements/vaadin-icon#property-svg) property. In this case you can also\ndefine the size of the SVG `viewBox` using the [`size`](https://cdn.vaadin.com/vaadin-web-components/23.2.16/#/elements/vaadin-icon#property-size) property:\n\n```js\nimport { html, svg } from 'lit';\n\n// in your component\nrender() {\n  const svgIcon = svg`<path d=\"M13 4v2l-5 5-5-5v-2l5 5z\"></path>`;\n  return html`\n    <vaadin-icon\n      .svg=\"${svgIcon}\"\n      size=\"16\"\n    ></vaadin-icon>\n  `;\n}\n```",
+          "description": "`<vaadin-icon>` is a Web Component for displaying SVG icons.\n\n### Icon property\n\nThe `<vaadin-icon>` component is designed to be used as a drop-in replacement for `<iron-icon>`.\nFor example, you can use it with `vaadin-icons` like this:\n\n```html\n<vaadin-icon icon=\"vaadin:angle-down\"></vaadin-icon>\n```\n\nAlternatively, you can also pick one of the Lumo icons:\n\n```html\n<vaadin-icon icon=\"lumo:user\"></vaadin-icon>\n```\n\n### Custom SVG icon\n\nAlternatively, instead of selecting an icon from an iconset by name, you can pass any custom `svg`\nliteral using the [`svg`](https://cdn.vaadin.com/vaadin-web-components/23.2.17/#/elements/vaadin-icon#property-svg) property. In this case you can also\ndefine the size of the SVG `viewBox` using the [`size`](https://cdn.vaadin.com/vaadin-web-components/23.2.17/#/elements/vaadin-icon#property-size) property:\n\n```js\nimport { html, svg } from 'lit';\n\n// in your component\nrender() {\n  const svgIcon = svg`<path d=\"M13 4v2l-5 5-5-5v-2l5 5z\"></path>`;\n  return html`\n    <vaadin-icon\n      .svg=\"${svgIcon}\"\n      size=\"16\"\n    ></vaadin-icon>\n  `;\n}\n```",
           "attributes": [
             {
               "name": "icon",
-              "description": "The name of the icon to use. The name should be of the form:\n`iconset_name:icon_name`. When using `vaadin-icons` it is possible\nto omit the first part and only use `icon_name` as a value.\n\nSetting the `icon` property updates the `svg` and `size` based on the\nvalues provided by the corresponding `vaadin-iconset` element.\n\nSee also [`name`](https://cdn.vaadin.com/vaadin-web-components/23.2.16/#/elements/vaadin-iconset#property-name) property of `vaadin-iconset`.",
+              "description": "The name of the icon to use. The name should be of the form:\n`iconset_name:icon_name`. When using `vaadin-icons` it is possible\nto omit the first part and only use `icon_name` as a value.\n\nSetting the `icon` property updates the `svg` and `size` based on the\nvalues provided by the corresponding `vaadin-iconset` element.\n\nSee also [`name`](https://cdn.vaadin.com/vaadin-web-components/23.2.17/#/elements/vaadin-iconset#property-name) property of `vaadin-iconset`.",
               "value": {
                 "type": [
                   "string",
@@ -114,7 +114,7 @@
             "properties": [
               {
                 "name": "icon",
-                "description": "The name of the icon to use. The name should be of the form:\n`iconset_name:icon_name`. When using `vaadin-icons` it is possible\nto omit the first part and only use `icon_name` as a value.\n\nSetting the `icon` property updates the `svg` and `size` based on the\nvalues provided by the corresponding `vaadin-iconset` element.\n\nSee also [`name`](https://cdn.vaadin.com/vaadin-web-components/23.2.16/#/elements/vaadin-iconset#property-name) property of `vaadin-iconset`.",
+                "description": "The name of the icon to use. The name should be of the form:\n`iconset_name:icon_name`. When using `vaadin-icons` it is possible\nto omit the first part and only use `icon_name` as a value.\n\nSetting the `icon` property updates the `svg` and `size` based on the\nvalues provided by the corresponding `vaadin-iconset` element.\n\nSee also [`name`](https://cdn.vaadin.com/vaadin-web-components/23.2.17/#/elements/vaadin-iconset#property-name) property of `vaadin-iconset`.",
                 "value": {
                   "type": [
                     "string",

package/web-types.lit.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/web-types",
   "name": "@vaadin/icon",
-  "version": "23.2.16",
+  "version": "23.2.17",
   "description-markup": "markdown",
   "framework": "lit",
   "framework-config": {
@@ -21,7 +21,7 @@
           "attributes": [
             {
               "name": ".name",
-              "description": "The name of the iconset. Every iconset is required to have its own unique name.\nAll the SVG icons in the iconset must have IDs conforming to its name.\n\nSee also [`name`](https://cdn.vaadin.com/vaadin-web-components/23.2.16/#/elements/vaadin-icon#property-name) property of `vaadin-icon`.",
+              "description": "The name of the iconset. Every iconset is required to have its own unique name.\nAll the SVG icons in the iconset must have IDs conforming to its name.\n\nSee also [`name`](https://cdn.vaadin.com/vaadin-web-components/23.2.17/#/elements/vaadin-icon#property-name) property of `vaadin-icon`.",
               "value": {
                 "kind": "expression"
               }
@@ -37,12 +37,12 @@
         },
         {
           "name": "vaadin-icon",
-          "description": "`<vaadin-icon>` is a Web Component for displaying SVG icons.\n\n### Icon property\n\nThe `<vaadin-icon>` component is designed to be used as a drop-in replacement for `<iron-icon>`.\nFor example, you can use it with `vaadin-icons` like this:\n\n```html\n<vaadin-icon icon=\"vaadin:angle-down\"></vaadin-icon>\n```\n\nAlternatively, you can also pick one of the Lumo icons:\n\n```html\n<vaadin-icon icon=\"lumo:user\"></vaadin-icon>\n```\n\n### Custom SVG icon\n\nAlternatively, instead of selecting an icon from an iconset by name, you can pass any custom `svg`\nliteral using the [`svg`](https://cdn.vaadin.com/vaadin-web-components/23.2.16/#/elements/vaadin-icon#property-svg) property. In this case you can also\ndefine the size of the SVG `viewBox` using the [`size`](https://cdn.vaadin.com/vaadin-web-components/23.2.16/#/elements/vaadin-icon#property-size) property:\n\n```js\nimport { html, svg } from 'lit';\n\n// in your component\nrender() {\n  const svgIcon = svg`<path d=\"M13 4v2l-5 5-5-5v-2l5 5z\"></path>`;\n  return html`\n    <vaadin-icon\n      .svg=\"${svgIcon}\"\n      size=\"16\"\n    ></vaadin-icon>\n  `;\n}\n```",
+          "description": "`<vaadin-icon>` is a Web Component for displaying SVG icons.\n\n### Icon property\n\nThe `<vaadin-icon>` component is designed to be used as a drop-in replacement for `<iron-icon>`.\nFor example, you can use it with `vaadin-icons` like this:\n\n```html\n<vaadin-icon icon=\"vaadin:angle-down\"></vaadin-icon>\n```\n\nAlternatively, you can also pick one of the Lumo icons:\n\n```html\n<vaadin-icon icon=\"lumo:user\"></vaadin-icon>\n```\n\n### Custom SVG icon\n\nAlternatively, instead of selecting an icon from an iconset by name, you can pass any custom `svg`\nliteral using the [`svg`](https://cdn.vaadin.com/vaadin-web-components/23.2.17/#/elements/vaadin-icon#property-svg) property. In this case you can also\ndefine the size of the SVG `viewBox` using the [`size`](https://cdn.vaadin.com/vaadin-web-components/23.2.17/#/elements/vaadin-icon#property-size) property:\n\n```js\nimport { html, svg } from 'lit';\n\n// in your component\nrender() {\n  const svgIcon = svg`<path d=\"M13 4v2l-5 5-5-5v-2l5 5z\"></path>`;\n  return html`\n    <vaadin-icon\n      .svg=\"${svgIcon}\"\n      size=\"16\"\n    ></vaadin-icon>\n  `;\n}\n```",
           "extension": true,
           "attributes": [
             {
               "name": ".icon",
-              "description": "The name of the icon to use. The name should be of the form:\n`iconset_name:icon_name`. When using `vaadin-icons` it is possible\nto omit the first part and only use `icon_name` as a value.\n\nSetting the `icon` property updates the `svg` and `size` based on the\nvalues provided by the corresponding `vaadin-iconset` element.\n\nSee also [`name`](https://cdn.vaadin.com/vaadin-web-components/23.2.16/#/elements/vaadin-iconset#property-name) property of `vaadin-iconset`.",
+              "description": "The name of the icon to use. The name should be of the form:\n`iconset_name:icon_name`. When using `vaadin-icons` it is possible\nto omit the first part and only use `icon_name` as a value.\n\nSetting the `icon` property updates the `svg` and `size` based on the\nvalues provided by the corresponding `vaadin-iconset` element.\n\nSee also [`name`](https://cdn.vaadin.com/vaadin-web-components/23.2.17/#/elements/vaadin-iconset#property-name) property of `vaadin-iconset`.",
               "value": {
                 "kind": "expression"
               }