@salesforcedevs/dx-components 0.16.3 → 0.17.1-review-diff1

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

@@ -0,0 +1,26 @@
+<template>
+    <button
+        if:false={isButtonRole}
+        role={role}
+        part="tab"
+        id={tabId}
+        onclick={onClick}
+        class={className}
+        aria-label={tabLabel}
+        aria-selected={active}
+        tabindex="0"
+    >
+        <slot></slot>
+    </button>
+    <button
+        if:true={isButtonRole}
+        role={role}
+        part="tab"
+        onclick={onClick}
+        class={className}
+        aria-label={tabLabel}
+        tabindex="0"
+    >
+        <slot></slot>
+    </button>
+</template>

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

@@ -0,0 +1,45 @@
+import { LightningElement, api } from "lwc";
+import cx from "classnames";
+export default class TabPanelItem extends LightningElement {
+    @api groupId!: string;
+    @api index!: number;
+    @api active!: boolean;
+    @api tabLabel!: string;
+    @api role: "button" | "tab" = "tab";
+
+    @api focus() {
+        const button = this.template.querySelector("button");
+        if (!button) {
+            return;
+        }
+        button.focus();
+    }
+
+    private get isButtonRole(): boolean {
+        return this.role === "button";
+    }
+
+    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 @@
+:host {
+    --dx-c-tab-panel-list-horizontal-padding: var(--dx-g-spacing-3xl);
+}
+
+.tablist-container {
+    padding: 0 var(--dx-c-tab-panel-list-horizontal-padding);
+}
+
+.tablist {
+    display: flex;
+    flex-wrap: nowrap;
+    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;
+}

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

@@ -0,0 +1,56 @@
+<template>
+    <div class="tablist-container">
+        <div class="tablist" part="tablist">
+            <div role="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={tab.label}
+                    >
+                        {tab.label}
+                    </dx-tab-panel-item>
+                </template>
+            </div>
+            <dx-popover offset="medium" placement="bottom-center">
+                <dx-tab-panel-item
+                    role="button"
+                    class="more-btn-container"
+                    slot="control"
+                    tab-label="More"
+                >
+                    <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"
+                            tab-label={dropdownItem.label}
+                        >
+                            {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,178 @@
+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);
+        if (typeof this._activeIndex === "number") {
+            this._activeIndex = undefined;
+            this.updateTabs();
+        }
+    }
+
+    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: any) {
+        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: any, index) => {
+                    tabPanel.index = index;
+                    tabPanel.groupId = this.groupId;
+                    tabPanel.active = this.activeIndex === index;
+                });
+        }
+        this.tabElements.forEach((tab: any, index) => {
+            tab.active = this.activeIndex === index;
+        });
+
+        this.dispatchEvent(
+            new CustomEvent("tabchanged", {
+                detail: this.id || this.groupId,
+                bubbles: true,
+                composed: true
+            })
+        );
+    }
+
+    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 as any);
+        window.addEventListener("resize", this.onResize.bind(this));
+    }
+
+    private removeListeners() {
+        this.template.removeEventListener("keydown", this.onKeydown as any);
+        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;
+};

package/src/modules/dx/tabbedCodeBlock/tabbedCodeBlock.css

@@ -0,0 +1,8 @@
+dx-code-block {
+    --dx-code-block-height: 224px;
+    --dx-code-block-toolbar-border-radius: 0;
+}
+
+dx-tab-panel-list {
+    --dx-c-tab-panel-list-horizontal-padding: 0;
+}

package/src/modules/dx/tabbedCodeBlock/tabbedCodeBlock.html

@@ -0,0 +1,16 @@
+<template>
+    <dx-tab-panel-list tabs={tabs}>
+        <template for:each={_codeBlocks} for:item="codeBlockItem">
+            <dx-tab-panel key={codeBlockItem.header}>
+                <!-- The header attribute is not passed intentionally because the tab title uses the header value. -->
+                <dx-code-block
+                    default-theme={defaultTheme}
+                    code-block={codeBlockItem.codeBlock}
+                    language={codeBlockItem.language}
+                    source-link={codeBlockItem.sourceLink}
+                    is-encoded={codeBlockItem.isEncoded}
+                ></dx-code-block>
+            </dx-tab-panel>
+        </template>
+    </dx-tab-panel-list>
+</template>

package/src/modules/dx/tabbedCodeBlock/tabbedCodeBlock.ts

@@ -0,0 +1,44 @@
+import { LightningElement, api } from "lwc";
+import { CodeBlockItem } from "typings/custom";
+import { safeDecodeURI, toJson } from "dxUtils/normalizers";
+import { DARK } from "dx/codeBlock";
+
+export default class TabbedCodeBlock extends LightningElement {
+    _codeBlocks: CodeBlockItem[] = [];
+
+    // By default, we want a dark theme for the tabbed code block; however, if the user changes the theme of any code block, it updates the same across the entire website.
+    @api defaultTheme = DARK;
+
+    get tabs(): string {
+        // Use the code block headers to create a tabs array as a JSON string
+        return JSON.stringify(
+            this._codeBlocks.map((codeBlock) => ({ label: codeBlock.header }))
+        );
+    }
+
+    // We need to pass the attribute as decodedURI(JSON.stringify(codeBlocksArray)) to avoid issues with single and double quotes in the code block content.
+    @api
+    set codeBlocks(value: string) {
+        if (value) {
+            // Decode the encoded code block JSON string
+            const decodeCodeBlockJson = safeDecodeURI(value);
+            try {
+                const codeBlockItems = toJson(decodeCodeBlockJson);
+                this._codeBlocks = codeBlockItems.map(
+                    (codeBlock: CodeBlockItem) => {
+                        return {
+                            ...codeBlock,
+                            defaultTheme: this.defaultTheme
+                        };
+                    }
+                );
+            } catch (exception) {
+                console.log("Invalid codeblock items json", exception);
+            }
+        }
+    }
+
+    get codeBlocks(): CodeBlockItem[] {
+        return this._codeBlocks;
+    }
+}

package/src/modules/dx/tbidAvatarButton/tbidAvatarButton.css

@@ -0,0 +1,33 @@
+@import "dxHelpers/reset";
+
+:host {
+    --dx-c-button-custom-color: var(--dx-g-blue-vibrant-40);
+    --dx-c-button-custom-background: transparent;
+    --dx-c-button-custom-border: 1px solid transparent;
+    --dx-c-button-custom-color-hover: var(--dx-g-blue-vibrant-40);
+    --dx-c-button-custom-background-hover: var(--dx-g-cloud-blue-vibrant-90);
+    --dx-c-button-custom-border-hover: var(--dx-g-cloud-blue-vibrant-90);
+    --dx-c-slot-empty-width: max-content;
+}
+
+.avatar-control {
+    height: var(--dx-g-spacing-xl);
+    width: calc(var(--dx-g-spacing-lg) + 4px);
+}
+
+.avatar-small-container {
+    align-items: center;
+    display: flex;
+    padding: 2px 0;
+}
+
+.avatar {
+    border-radius: 100%;
+    border: 2px solid #0d9dda;
+}
+
+.avatar.avatar-small {
+    display: block;
+    height: calc(var(--dx-g-spacing-lg) + 4px);
+    width: calc(var(--dx-g-spacing-lg) + 4px);
+}

package/src/modules/dx/tbidAvatarButton/tbidAvatarButton.html

@@ -0,0 +1,53 @@
+<template>
+    <div if:true={isLoggedIn}>
+        <dx-popover
+            offset="small"
+            width="320px"
+            placement="bottom-end"
+            open-on-hover
+            show-arrow
+        >
+            <div slot="control" class="avatar-small-container login-control">
+                <button
+                    class="avatar-control"
+                    aria-labelledby="avatar-control-label"
+                >
+                    <img
+                        src={userInfo.avatarImgSrc}
+                        class="avatar avatar-small"
+                        alt="Small user avatar image"
+                    />
+                    <span id="avatar-control-label" hidden>
+                        {userInfo.fullName}
+                    </span>
+                </button>
+            </div>
+            <div slot="content">
+                <slot name="popover-content"></slot>
+            </div>
+        </dx-popover>
+    </div>
+    <div if:false={isLoggedIn}>
+        <dx-popover
+            offset="small"
+            width="320px"
+            placement="bottom-end"
+            open-on-hover
+            show-arrow
+        >
+            <dx-button
+                slot="control"
+                class="login-control"
+                icon-symbol="user"
+                icon-position="left"
+                loading={isLoading}
+                variant="custom"
+            >
+                Login
+            </dx-button>
+            <div slot="content">
+                <slot name="popover-content"></slot>
+            </div>
+        </dx-popover>
+    </div>
+</template>