@salesforcedevs/dx-components 0.0.0-alpha.0

package/src/modules/dx/spinner/spinner.html

@@ -0,0 +1,6 @@
+<template>
+    <div role="status" class={containerClass}>
+        <div class="spinner_dot-a"></div>
+        <div class="spinner_dot-b"></div>
+    </div>
+</template>

package/src/modules/dx/spinner/spinner.ts

@@ -0,0 +1,20 @@
+import { LightningElement, api } from "lwc";
+import cx from "classnames";
+import type { SpinnerSize, SpinnerVariant } from "typings/custom";
+
+export default class Spinner extends LightningElement {
+    @api size: SpinnerSize = "medium";
+    @api variant: SpinnerVariant = "base";
+
+    connectedCallback() {
+        this.classList.add("spinner_container");
+    }
+
+    get containerClass(): string {
+        return cx(
+            "spinner",
+            this.size && `spinner_${this.size}`,
+            this.variant && this.variant !== "base" && `spinner_${this.variant}`
+        );
+    }
+}

package/src/modules/dx/tab/tab.css

@@ -0,0 +1,106 @@
+@import "dxHelpers/reset";
+
+a {
+    text-decoration: none;
+}
+
+.nav-list-item {
+    --horizontal-spacing: var(
+        --dx-c-tab-horizontal-spacing,
+        var(--dx-g-spacing-md)
+    );
+
+    position: relative;
+    display: flex;
+    align-items: center;
+    height: var(--dx-g-spacing-xl);
+    font-family: var(--dx-g-font-display);
+    white-space: nowrap;
+    color: var(--dx-g-blue-vibrant-20);
+    transition: var(--dx-g-transition-hue-1x);
+    cursor: pointer;
+    outline-offset: -1px;
+}
+
+.nav-list-item_default {
+    border: 0;
+    border-radius: var(--dx-g-spacing-md);
+    font-size: var(--dx-g-text-sm);
+    padding: 0 var(--horizontal-spacing);
+}
+
+.nav-list-item_small {
+    --border-color: transparent;
+
+    border-bottom: 2px solid var(--border-color);
+    font-size: var(--dx-g-text-xs);
+    height: calc(var(--dx-g-spacing-xl) - 2px);
+    margin: 0 var(--horizontal-spacing);
+}
+
+.nav-list-item > span {
+    margin-top: var(--dx-g-spacing-xs);
+}
+
+button.nav-list-item_default > dx-icon {
+    margin-left: var(--dx-g-spacing-sm);
+}
+
+button.nav-list-item_small > dx-icon {
+    margin-left: var(--dx-g-spacing-xs);
+}
+
+.nav-list-item_default:hover,
+.nav-list-item_default:active,
+:host([aria-expanded="true"]) button.nav-list-item_default {
+    background: var(
+        --dx-g-brand-current-button-color-background-inactive,
+        var(--dx-g-brand-default-button-color-background-inactive)
+    );
+}
+
+button.nav-list-item:hover > dx-icon,
+button.nav-list-item:active > dx-icon,
+:host([aria-expanded="true"]) button.nav-list-item > dx-icon {
+    transform: rotateX(180deg);
+}
+
+.nav-list-item_small:hover,
+.nav-list-item_small:active,
+:host([aria-expanded="true"]) button.nav-list-item_small {
+    --border-color: var(--dx-g-blue-vibrant-40);
+
+    color: var(--dx-g-blue-vibrant-40);
+}
+
+.nav-list-item_small.state-active {
+    --border-color: var(--dx-g-blue-vibrant-50);
+
+    color: var(--dx-g-blue-vibrant-50);
+}
+
+.nav-list-item_default.state-active {
+    background: var(
+        --dx-g-brand-current-button-color-background-active,
+        var(--dx-g-brand-default-button-color-background-active)
+    );
+    color: var(--dx-g-brand-current-color, var(--dx-g-brand-default-color));
+}
+
+@media (max-width: 1160px) {
+    .nav-list-item_small {
+        --horizontal-spacing: var(
+            --dx-c-tab-horizontal-spacing,
+            var(--dx-g-spacing-smd)
+        );
+    }
+}
+
+@media (max-width: 1090px) {
+    .nav-list-item_small {
+        --horizontal-spacing: var(
+            --dx-c-tab-horizontal-spacing,
+            var(--dx-g-spacing-sm)
+        );
+    }
+}

package/src/modules/dx/tab/tab.html

@@ -0,0 +1,13 @@
+<template>
+    <a if:true={href} class={className} href={href} onclick={sendGtm}>
+        <span>{label}</span>
+    </a>
+    <button if:false={href} class={className}>
+        <span>{label}</span>
+        <dx-icon
+            if:true={useIcon}
+            symbol="chevrondown"
+            size={iconSize}
+        ></dx-icon>
+    </button>
+</template>

package/src/modules/dx/tab/tab.ts

@@ -0,0 +1,52 @@
+import { LightningElement, api } from "lwc";
+import { track } from "dxUtils/analytics";
+import cx from "classnames";
+import { TabVariant } from "typings/custom";
+import { normalizeBoolean } from "dxUtils/normalizers";
+
+export default class Tab extends LightningElement {
+    @api label: string | null = null;
+    @api href: string | null = null;
+    @api variant: TabVariant = "default";
+
+    @api
+    get isActive() {
+        return this._isActive;
+    }
+
+    set isActive(value) {
+        this._isActive = normalizeBoolean(value);
+    }
+
+    @api
+    get useIcon() {
+        return this._useIcon;
+    }
+
+    set useIcon(value) {
+        this._useIcon = normalizeBoolean(value);
+    }
+
+    _useIcon = false;
+    _isActive = false;
+
+    private sendGtm(e: PointerEvent) {
+        track(e.currentTarget!, "custEv_topNavLinkClick", {
+            navHeading: this.label || undefined,
+            clickText: this.href || undefined,
+            pageLocation: window.location.pathname
+        });
+    }
+
+    get className() {
+        return cx(
+            "nav-list-item",
+            this.isActive && "state-active",
+            `nav-list-item_${this.variant}`
+        );
+    }
+
+    get iconSize() {
+        return this.variant === "small" ? "xsmall" : "small";
+    }
+}

package/src/modules/dx/tabPanel/tabPanel.css

@@ -0,0 +1,23 @@
+@import "dxHelpers/reset";
+
+:host {
+    --dx-c-tab-panel-margin-top: var(--dx-g-spacing-3xl);
+    --dx-c-tab-panel-gap: var(--dx-g-spacing-md);
+}
+
+.tabpanel {
+    display: none;
+}
+
+.tabpanel-active {
+    display: flex;
+    margin-top: var(--dx-c-tab-panel-margin-top);
+    gap: var(--dx-c-tab-panel-gap);
+    flex-wrap: wrap;
+}
+
+@media screen and (max-width: 640px) {
+    .tabpanel-active {
+        --dx-c-tab-panel-margin-top: 36px;
+    }
+}

package/src/modules/dx/tabPanel/tabPanel.html

@@ -0,0 +1,13 @@
+<template>
+    <div
+        role="tabpanel"
+        part="tabpanel"
+        id={panelId}
+        class={className}
+        tabindex={activeTabIndex}
+        aria-labelledby={tabId}
+        hidden={panelHidden}
+    >
+        <slot></slot>
+    </div>
+</template>

package/src/modules/dx/tabPanel/tabPanel.ts

@@ -0,0 +1,27 @@
+import { LightningElement, api } from "lwc";
+import cx from "classnames";
+export default class TabPanel extends LightningElement {
+    @api index!: number;
+    @api groupId!: string;
+    @api active: boolean = false;
+
+    private get tabId() {
+        return `tabs--${this.groupId}--tab--${this.index}`;
+    }
+
+    private get panelId() {
+        return `tabs--${this.groupId}--panel--${this.index}`;
+    }
+
+    private get activeTabIndex() {
+        return this.active ? 0 : -1;
+    }
+
+    private get className() {
+        return cx("tabpanel", this.active && "tabpanel-active");
+    }
+
+    private get panelHidden() {
+        return !this.active;
+    }
+}

package/src/modules/dx/tabPanelItem/tabPanelItem.css

@@ -0,0 +1,43 @@
+@import "dxHelpers/reset";
+
+button:focus {
+    outline: unset;
+}
+
+.tab {
+    color: var(--dx-g-blue-vibrant-20);
+    font-family: var(--dx-g-font-display);
+    font-size: var(--dx-g-text-lg);
+    font-weight: var(--dx-g-font-bold);
+    padding: var(--dx-g-spacing-smd) var(--dx-g-spacing-xl)
+        var(--dx-g-spacing-sm);
+    border-top-left-radius: var(--dx-g-spacing-sm);
+    border-top-right-radius: var(--dx-g-spacing-sm);
+    border-bottom: var(--dx-g-spacing-xs) solid transparent;
+}
+
+.tab:hover {
+    background-color: var(--dx-g-blue-vibrant-95);
+}
+
+.tab-active {
+    color: var(--dx-g-blue-vibrant-50);
+    border-bottom: var(--dx-g-spacing-xs) solid var(--dx-g-blue-vibrant-50);
+}
+
+.tab:hover,
+.tab-active {
+    font-weight: var(--dx-g-font-bold);
+}
+
+@media screen and (max-width: 640px) {
+    .tab {
+        font-size: var(--dx-g-text-base);
+        font-family: var(--dx-g-font-sans);
+        font-weight: var(--dx-g-font-normal);
+    }
+
+    .tab-active {
+        font-weight: var(--dx-g-font-bold);
+    }
+}

package/src/modules/dx/tabPanelItem/tabPanelItem.html

@@ -0,0 +1,15 @@
+<template>
+    <button
+        role="tab"
+        part="tab"
+        id={tabId}
+        onclick={onClick}
+        class={className}
+        tabindex={activeTabIndex}
+        aria-controls={panelId}
+        aria-label="Tab button"
+        aria-selected={active}
+    >
+        <slot></slot>
+    </button>
+</template>

package/src/modules/dx/tabPanelItem/tabPanelItem.ts

@@ -0,0 +1,39 @@
+import { LightningElement, api } from "lwc";
+import cx from "classnames";
+export default class TabPanelItem extends LightningElement {
+    @api groupId!: string;
+    @api index!: number;
+    @api active: boolean = false;
+
+    @api focus() {
+        const button = this.template.querySelector("button");
+        if (!button) {
+            return;
+        }
+        button.focus();
+    }
+
+    private get activeTabIndex() {
+        return this.active ? 0 : -1;
+    }
+
+    private get panelId() {
+        return `tabs--${this.groupId}--panel--${this.index}`;
+    }
+
+    private get tabId() {
+        return `tabs--${this.groupId}--tab--${this.index}`;
+    }
+
+    private get className() {
+        return cx("tab", this.active && "tab-active");
+    }
+
+    private onClick() {
+        this.dispatchEvent(
+            new CustomEvent("select", {
+                detail: this.index
+            })
+        );
+    }
+}

package/src/modules/dx/tabPanelList/tabPanelList.css

@@ -0,0 +1,37 @@
+.tablist-container {
+    padding: 0 var(--dx-g-spacing-3xl);
+}
+
+.tablist {
+    border-bottom: 1px solid var(--dx-g-gray-80);
+}
+
+dx-popover {
+    --popover-padding: none;
+}
+
+.dropdown-item {
+    padding: var(--dx-g-spacing-sm);
+}
+
+.dropdown-item:hover {
+    cursor: pointer;
+    font-weight: var(--dx-g-font-bold);
+    background-color: var(--dx-g-blue-vibrant-95);
+}
+
+.more-btn {
+    display: flex;
+    align-items: center;
+    gap: var(--dx-g-spacing-sm);
+}
+
+.hidden {
+    display: none;
+}
+
+@media screen and (max-width: 1024px) {
+    .tablist-container {
+        padding: 0 var(--dx-g-spacing-lg);
+    }
+}

package/src/modules/dx/tabPanelList/tabPanelList.html

@@ -0,0 +1,47 @@
+<template>
+    <div class="tablist-container">
+        <div class="tablist" role="tablist" part="tablist">
+            <template for:each={tabs} for:item="tab">
+                <dx-tab-panel-item
+                    key={tab.index}
+                    onselect={onTabClick}
+                    group-id={groupId}
+                    index={tab.index}
+                    active={tab.active}
+                >
+                    {tab.label}
+                </dx-tab-panel-item>
+            </template>
+            <dx-popover offset="medium" placement="bottom-center">
+                <dx-tab-panel-item class="more-btn-container" slot="control">
+                    <div class="more-btn">
+                        More
+                        <dx-icon
+                            sprite="utility"
+                            symbol="threedots"
+                            size="large"
+                        ></dx-icon>
+                    </div>
+                </dx-tab-panel-item>
+                <div slot="content">
+                    <template for:each={dropdownItems} for:item="dropdownItem">
+                        <div
+                            role="button"
+                            onclick={onDropdownItemClick}
+                            onkeydown={onDropdownItemClick}
+                            data-value={dropdownItem.index}
+                            key={dropdownItem.label}
+                            class="dropdown-item"
+                            tabindex="0"
+                        >
+                            {dropdownItem.label}
+                        </div>
+                    </template>
+                </div>
+            </dx-popover>
+        </div>
+        <div part="tabpanels">
+            <slot onslotchange={onSlotChange}></slot>
+        </div>
+    </div>
+</template>

package/src/modules/dx/tabPanelList/tabPanelList.ts

@@ -0,0 +1,164 @@
+import { LightningElement, api } from "lwc";
+import { LightningSlotElement, Tab } from "typings/custom";
+import { toJson } from "dxUtils/normalizers";
+import { uniqueId } from "./uniqueId";
+export default class TabPanelList extends LightningElement {
+    @api
+    get initialIndex() {
+        return +this._initialIndex;
+    }
+    set initialIndex(value) {
+        this._initialIndex = +value;
+    }
+
+    @api
+    get tabs() {
+        return this._tabs.map((tab: Tab, index) => ({
+            ...tab,
+            index,
+            groupId: this.groupId,
+            active: this.activeIndex === index
+        }));
+    }
+    set tabs(value: Tab[]) {
+        this._tabs = toJson(value);
+    }
+
+    private _initialIndex: number = 0;
+    private _tabs: Tab[] = [];
+    private _activeIndex?: number;
+    private groupId: string = uniqueId();
+    private tabSlotPanels?: LightningSlotElement;
+    private showPopover: boolean = true;
+    private dropdownItems: Tab[] = [];
+    private hasRendered: boolean = false;
+
+    private get tabElements() {
+        return this.template.querySelectorAll("dx-tab-panel-item");
+    }
+
+    private get activeIndex() {
+        return this._activeIndex == null
+            ? this.initialIndex
+            : this._activeIndex;
+    }
+
+    private set activeIndex(value: number) {
+        this._activeIndex = value;
+        this.updateTabs();
+    }
+
+    connectedCallback() {
+        this.addListeners();
+    }
+
+    renderedCallback(): void {
+        if (!this.hasRendered) {
+            this.onResize();
+            this.hasRendered = true;
+        }
+    }
+
+    disconnectedCallback() {
+        this.removeListeners();
+    }
+
+    private onTabClick(e: { detail: number }) {
+        if (e.detail !== this.activeIndex) {
+            this.dispatchEvent(new CustomEvent("change", { detail: e.detail }));
+        }
+        this.activeIndex = e.detail;
+    }
+
+    private onDropdownItemClick(e: CustomEvent) {
+        this.onTabClick({ detail: +e.currentTarget!.dataset.value });
+    }
+
+    private onSlotChange(e: Event) {
+        this.tabSlotPanels = <LightningSlotElement>e.target;
+        this.updateTabs();
+    }
+
+    private updateTabs() {
+        if (this.tabSlotPanels) {
+            this.tabSlotPanels.assignedElements().forEach((tabPanel, index) => {
+                tabPanel.index = index;
+                tabPanel.groupId = this.groupId;
+                tabPanel.active = this.activeIndex === index;
+            });
+        }
+        this.tabElements.forEach((tab, index) => {
+            tab.active = this.activeIndex === index;
+        });
+    }
+
+    private focusActiveTab() {
+        this.tabElements[this.activeIndex].focus();
+    }
+
+    private onKeydown = (e: KeyboardEvent) => {
+        switch (e.key) {
+            case "ArrowLeft": {
+                e.preventDefault();
+                const prev = this.activeIndex - 1;
+                this.activeIndex = prev < 0 ? this.tabs.length - 1 : prev;
+                this.focusActiveTab();
+                break;
+            }
+            case "ArrowRight": {
+                e.preventDefault();
+                const next = this.activeIndex + 1;
+                this.activeIndex = next === this.tabs.length ? 0 : next;
+                this.focusActiveTab();
+                break;
+            }
+            default:
+        }
+    };
+
+    private onResize = () => {
+        const allItems = this.template.querySelectorAll("dx-tab-panel-item");
+        const hiddenItems: number[] = [];
+        const primaryItems = this.template.querySelectorAll(
+            "dx-tab-panel-item:not(.more-btn-container)"
+        );
+        const moreBtn = this.template.querySelector(".more-btn-container")!;
+        const containerWidth =
+            this.template.querySelector(".tablist")!.offsetWidth;
+        let stopWidth = this.template.querySelector(
+            "dx-tab-panel-item.more-btn-container"
+        )!.offsetWidth;
+
+        this.dropdownItems = [];
+        allItems.forEach((item) => {
+            item.classList.remove("hidden");
+        });
+
+        primaryItems.forEach((item, i) => {
+            if (containerWidth >= stopWidth + item.offsetWidth) {
+                stopWidth += item.offsetWidth;
+            } else {
+                item.classList.add("hidden");
+                hiddenItems.push(i);
+            }
+        });
+
+        if (!hiddenItems.length) {
+            moreBtn.classList.add("hidden");
+        } else {
+            hiddenItems.forEach((i) => {
+                this.dropdownItems.push({ ...this._tabs[i], index: i });
+            });
+        }
+    };
+
+    private addListeners() {
+        this.template.addEventListener("keydown", this.onKeydown);
+        window.addEventListener("resize", this.onResize.bind(this));
+    }
+
+    private removeListeners() {
+        this.template.removeEventListener("keydown", this.onKeydown);
+        window.removeEventListener("resize", this.onResize.bind(this));
+    }
+}

package/src/modules/dx/tabPanelList/uniqueId.ts

@@ -0,0 +1,6 @@
+let idCounter = 0;
+
+export const uniqueId = (prefix: string = "") => {
+    const id = ++idCounter;
+    return prefix + id;
+};