Function makeIconClass

frontend/util/util.ts:122–171

(icon: string, fw: boolean, opts?: { spin?: boolean; defaultIcon?: string })

}

function makeIconClass(icon: string, fw: boolean, opts?: { spin?: boolean; defaultIcon?: string }): string {
    if (isBlank(icon)) {
        if (opts?.defaultIcon != null) {
            return makeIconClass(opts.defaultIcon, fw, { spin: opts?.spin });
        }
        return null;
    }

    let animation: string | null = null;
    let hasFwModifier = false;

    while (icon.match(/\+(spin|beat|fade|fw)$/)) {
        const modifierMatch = icon.match(/\+(spin|beat|fade|fw)$/);
        if (modifierMatch) {
            const modifier = modifierMatch[1];
            if (modifier === "fw") {
                hasFwModifier = true;
            } else {
                animation = modifier;
            }
            icon = icon.replace(/\+(spin|beat|fade|fw)$/, "");
        }
    }

    let baseClass: string;
    if (icon.match(/^(solid@)?[a-z0-9-]+$/)) {
        icon = icon.replace(/^solid@/, "");
        baseClass = `fa fa-solid fa-${icon}`;
    } else if (icon.match(/^regular@[a-z0-9-]+$/)) {
        icon = icon.replace(/^regular@/, "");
        baseClass = `fa fa-sharp fa-regular fa-${icon}`;
    } else if (icon.match(/^brands@[a-z0-9-]+$/)) {
        icon = icon.replace(/^brands@/, "");
        baseClass = `fa fa-brands fa-${icon}`;
    } else if (icon.match(/^custom@[a-z0-9-]+$/)) {
        icon = icon.replace(/^custom@/, "");
        baseClass = `fa fa-kit fa-${icon}`;
    } else {
        if (opts?.defaultIcon != null) {
            return makeIconClass(opts.defaultIcon, fw, { spin: opts?.spin });
        }
        return null;
    }

    const shouldAddFw = fw || hasFwModifier;
    const hasSpin = animation === "spin" || opts?.spin;
    const animationClass = animation && animation !== "spin" ? `fa-${animation}` : null;

    return clsx(baseClass, shouldAddFw ? "fa-fw" : null, hasSpin ? "fa-spin" : null, animationClass);
}

/**
 * A wrapper function for running a promise and catching any errors