tiny-essentials/dist/v1/libs/TinyHtml/TinyHtmlIcon.cjs

Collection of small, essential scripts designed to be used across various projects. These simple utilities are crafted for speed, ease of use, and versatility.

'use strict';

var TinyHtmlTemplate = require('./TinyHtmlTemplate.cjs');

/**
 * TinyIcon is a lightweight helper class for managing icon-like elements
 * (such as `<i>` or `<span>` tags) with class-based styling.
 * It extends TinyHtml to provide direct DOM element manipulation.
 *
 * @extends TinyHtmlTemplate<HTMLElement>
 */
class TinyHtmlIcon extends TinyHtmlTemplate {
  /** @type {string} */
  static #defaultTag = 'i';

  /** @returns {string} */
  static get defaultTag() {
    return TinyHtmlIcon.#defaultTag;
  }

  /** @param {string} value */
  static set defaultTag(value) {
    if (typeof value !== 'string') throw new TypeError('defaultTag must be a string');
    TinyHtmlIcon.#defaultTag = value;
  }

  /**
   * Creates a new TinyIcon instance.
   * @param {string|string[]|Set<string>} tags - Initial icon classes to apply.
   * @param {string} [tagName=TinyHtmlIcon.#defaultTag] - The HTML tag to use for the element (e.g., `i`, `span`).
   */
  constructor(tags, tagName = TinyHtmlIcon.#defaultTag) {
    if (typeof tagName !== 'string') throw new TypeError('TinyIcon: "tagName" must be a string.');
    super(document.createElement(tagName), tags);
  }
}

module.exports = TinyHtmlIcon;