@salesforcedevs/dx-components 0.26.1-alpha0.6 → 0.27.0

package/src/modules/dx/treeTile/treeTile.ts

@@ -0,0 +1,59 @@
+import { LightningElement, api } from "lwc";
+import cx from "classnames";
+import { InternalTreeNode } from "typings/custom";
+
+const methodTextMap: {
+    [key: string]: string;
+} = {
+    get: "GET",
+    put: "PUT",
+    post: "POST",
+    patch: "PATC",
+    delete: "DELE"
+};
+
+export default class TreeTile extends LightningElement {
+    @api isRoot = false;
+    @api treeNode!: InternalTreeNode;
+    @api isExpanded = false;
+    @api hasChildren = false;
+    @api isSelected = false;
+    @api href!: string;
+
+    get tileAriaLevel() {
+        return this.treeNode.level + 2;
+    }
+
+    private get iconSize() {
+        return this.isRoot ? "small" : "xsmall";
+    }
+
+    private get badgeClass() {
+        return cx("flex", "tile-icon", this.treeNode.method);
+    }
+
+    private get showMethod() {
+        return this.treeNode.method && !this.hasChildren;
+    }
+
+    private get methodText() {
+        if (this.treeNode.method && this.treeNode.method in methodTextMap) {
+            return methodTextMap[this.treeNode.method];
+        }
+        return "";
+    }
+
+    private get tileClass() {
+        return cx("tile", "sidebar-item", {
+            "tile-root": this.isRoot,
+            "tile-with-children": !this.isRoot && this.hasChildren,
+            "sidebar-item-selected": this.isSelected
+        });
+    }
+
+    private onClickIcon(event: Event) {
+        event.preventDefault();
+        event.stopPropagation();
+        this.dispatchEvent(new CustomEvent("iconclick"));
+    }
+}

package/src/modules/dx/typeBadge/typeBadge.css

@@ -0,0 +1,74 @@
+@import "helpers/reset";
+
+.typebadge {
+    align-items: center;
+    background: var(--dx-c-type-badge-background, var(--background));
+    border-radius: var(--dx-c-type-badge-border-radius, var(--border-radius));
+    color: var(--dx-c-type-badge-color, var(--color));
+    display: flex;
+    justify-content: center;
+    height: var(--dx-c-type-badge-height, var(--height));
+    text-align: center;
+    white-space: nowrap;
+    width: min-content;
+}
+
+.typebadge.typebadge_metadata {
+    --background: var(--dx-g-cloud-blue-natural-90);
+    --border-radius: var(--dx-g-spacing-xs);
+    --color: var(--dx-g-blue-vibrant-20);
+    --height: var(--dx-g-spacing-md);
+    --horizontal-spacing: var(--dx-g-spacing-sm);
+
+    font-family: var(--dx-g-font-display);
+    font-size: 10px;
+    letter-spacing: 0.6px;
+    text-transform: var(--dx-c-type-badge-text-transform, uppercase);
+    padding: 0 var(--horizontal-spacing);
+}
+
+.typebadge.typebadge_content-type {
+    --background: var(--sds-g-gray-3);
+    --border-radius: var(--dx-g-spacing-smd);
+    --color: var(--sds-g-gray-10);
+    --height: var(--dx-g-spacing-lg);
+    --horizontal-spacing: var(--dx-g-spacing-smd);
+    --vertical-spacing: var(--dx-g-spacing-xs);
+
+    font-family: var(--dx-g-font-sans);
+    font-size: var(--dx-g-text-xs);
+    font-weight: var(--dx-g-font-bold);
+    padding: var(--vertical-spacing) var(--horizontal-spacing);
+}
+
+.typebadge.typebadge_content-type.size-small {
+    --height: var(--dx-g-spacing-mlg);
+    --horizontal-spacing: var(--dx-g-spacing-sm);
+
+    font-size: 10px;
+}
+
+.typebadge.typebadge_metadata.size-small {
+    --height: var(--dx-g-spacing-md);
+    --horizontal-spacing: var(--dx-g-spacing-xs);
+
+    font-size: 8px;
+    letter-spacing: 0.5px;
+}
+
+.typebadge.typebadge_metadata span {
+    transform: translateY(2px);
+    width: var(--dx-c-type-badge-text-width, unset);
+}
+
+.typebadge.typebadge_metadata.size-small span {
+    transform: translateY(1px);
+}
+
+@media screen and (max-width: 768px) {
+    .typebadge.typebadge_metadata:not(.size-small) {
+        height: var(--dx-g-spacing-lg);
+        padding: 0 var(--dx-g-spacing-sm);
+        font-size: var(--dx-g-text-2xs);
+    }
+}

package/src/modules/dx/typeBadge/typeBadge.html

@@ -0,0 +1,5 @@
+<template>
+    <div class={className} style={style}>
+        <span>{value}</span>
+    </div>
+</template>

package/src/modules/dx/typeBadge/typeBadge.ts

@@ -0,0 +1,65 @@
+import { LightningElement, api } from "lwc";
+import cx from "classnames";
+import {
+    TypeBadgeColor,
+    Color,
+    TypeBadgeSize,
+    BadgeType,
+    Brand
+} from "typings/custom";
+import { colorToDxColors } from "utils/css";
+
+const DEFAULT_TYPE = "typebadge_metadata";
+const VALID_BRANDS: Array<Brand> = [
+    "employees",
+    "marketing",
+    "partners",
+    "commerce",
+    "sales",
+    "success",
+    "integration",
+    "platform",
+    "industries",
+    "learning",
+    "service",
+    "analytics"
+];
+
+export default class TypeBadge extends LightningElement {
+    @api size: TypeBadgeSize = "default";
+    @api value: string = "";
+    @api color?: TypeBadgeColor = "default";
+    @api type?: BadgeType = "metadata";
+
+    private get className(): string {
+        return cx(
+            "typebadge",
+            `size-${this.size}`,
+            (this.type && `typebadge_${this.type}`) || DEFAULT_TYPE
+        );
+    }
+
+    private get style(): string {
+        if (VALID_BRANDS.includes(this.color as Brand)) {
+            return this.buildStyleString({
+                background: `--dx-g-brand-${this.color}-color-background`,
+                color: `--dx-g-brand-${this.color}-color`
+            });
+        }
+        const variables = colorToDxColors(this.color as Color);
+        if (variables) {
+            return this.buildStyleString(variables);
+        }
+        return "";
+    }
+
+    private buildStyleString({
+        background,
+        color
+    }: {
+        background: string;
+        color: string;
+    }): string {
+        return `--color: var(${color}); --background: var(${background})`;
+    }
+}

package/src/modules/dx/typeBadgeGroup/typeBadgeGroup.css

@@ -0,0 +1,12 @@
+.badges-group {
+    display: flex;
+    flex-wrap: wrap;
+}
+
+.badges-group > dx-type-badge {
+    margin-bottom: var(--dx-g-spacing-sm);
+}
+
+.badges-group > dx-type-badge:not(:last-child) {
+    margin-right: var(--dx-g-spacing-sm);
+}

package/src/modules/dx/typeBadgeGroup/typeBadgeGroup.html

@@ -0,0 +1,11 @@
+<template>
+    <div class="badges-group">
+        <template for:each={badges} for:item="badge">
+            <dx-type-badge
+                key={badge}
+                size={size}
+                value={badge}
+            ></dx-type-badge>
+        </template>
+    </div>
+</template>

package/src/modules/dx/typeBadgeGroup/typeBadgeGroup.ts

@@ -0,0 +1,18 @@
+import { LightningElement, api } from "lwc";
+import { normalizeToArray } from "utils/normalizers";
+import { TypeBadgeSize } from "typings/custom";
+
+export default class TypeBadgeGroup extends LightningElement {
+    @api size: TypeBadgeSize = "medium";
+
+    @api
+    get badges() {
+        return this._badges;
+    }
+    set badges(value: string[] | string | null) {
+        this._badges = normalizeToArray(value);
+    }
+
+    // can be an array of strings or a comma delimited string
+    private _badges!: string | string[] | null;
+}

package/src/modules/helpers/animations/animations.css

@@ -0,0 +1,15 @@
+@keyframes fadeIn {
+    0% {
+        opacity: 0;
+        transform: translateY(var(--dx-g-spacing-sm));
+    }
+
+    100% {
+        opacity: 1;
+        transform: translateY(0);
+    }
+}
+
+:host {
+    --dx-g-animation-fadein: fadein 0.2s linear forwards;
+}

package/src/modules/helpers/button/button.css

@@ -0,0 +1,4 @@
+:host {
+    --dx-g-button-heading-color-hover: var(--dx-g-blue-vibrant-40);
+    --dx-g-button-image-filter-hover: brightness(90%);
+}

package/src/modules/helpers/card/card.css

@@ -0,0 +1,258 @@
+@import "helpers/button";
+
+/* main card base */
+
+:host {
+    display: block;
+
+    --dx-g-card-border: 1px solid var(--dx-g-gray-90);
+    --dx-g-card-border-radius: 16px;
+    --dx-g-card-item-spacing: 12px;
+    --dx-g-card-img-spacing: 20px;
+    --dx-c-body-max-lines: 6;
+}
+
+.dx-card-base {
+    height: 100%;
+}
+
+.dx-card-base:not(.dx-card-base_borderless) {
+    --dx-g-card-padding: 20px;
+
+    background: white;
+    transition: var(--dx-g-transition-box-shadow-2x);
+    box-shadow: var(--dx-g-box-shadow-sm);
+    border-radius: var(--dx-g-card-border-radius);
+    overflow: hidden;
+}
+
+.dx-card-base:not(.dx-card-base_borderless):hover {
+    box-shadow: var(--dx-g-box-shadow-lg);
+}
+
+.dx-card-base_borderless {
+    --dx-g-card-padding: 0;
+}
+
+.dx-card-base_override-width {
+    width: 100% !important;
+}
+
+.dx-card-base:not(.dx-card-base_borderless):active {
+    box-shadow: var(--dx-g-box-shadow-md);
+}
+
+.dx-card-base_layout-horizontal {
+    flex-direction: row;
+}
+
+/* card sections with responsive padding */
+
+/* vertical sections */
+.dx-card-base_section-vertical {
+    padding: 0 var(--dx-g-card-padding) var(--dx-g-card-img-spacing)
+        var(--dx-g-card-padding);
+}
+
+.dx-card-base_section-vertical:first-of-type {
+    padding-top: var(--dx-g-card-padding);
+}
+
+.dx-card-base > .dx-card-base_section-vertical {
+    width: 100%;
+}
+
+.dx-card-base_section-vertical:last-of-type {
+    padding-bottom: var(--dx-g-card-padding);
+}
+
+/* horizontal sections */
+.dx-card-base_section-horizontal {
+    padding: var(--dx-g-card-padding) var(--dx-g-card-img-spacing)
+        var(--dx-g-card-padding) 0;
+}
+
+.dx-card-base_section-horizontal:first-of-type {
+    padding-left: var(--dx-g-card-padding);
+}
+
+.dx-card-base_section-horizontal:last-of-type {
+    padding-right: var(--dx-g-card-padding);
+}
+
+.dx-card-base > .dx-card-base_section-horizontal {
+    height: 100%;
+}
+
+/* flex containers with responsive spacing */
+
+.dx-card-base_column {
+    display: flex;
+    flex-direction: column;
+    align-items: flex-start;
+}
+
+.dx-card-base_column > *:not(:last-child) {
+    margin-bottom: var(--dx-g-card-item-spacing);
+}
+
+/* card ctas */
+
+.dx-card-base_ctas {
+    /* this is a hack since we can't target the ::slotted ctas */
+    display: grid;
+    grid-gap: var(--dx-g-spacing-xs) var(--dx-g-spacing-xl);
+    grid-template-columns: repeat(
+        auto-fill,
+        minmax(min-content, var(--dx-c-card-grid-max-width, 50px))
+    );
+}
+
+/* card image */
+
+.dx-card-base_image {
+    grid-area: image;
+    object-fit: cover;
+    transition: var(--dx-g-transition-filter-2x),
+        var(--dx-g-transition-box-shadow-2x);
+}
+
+.dx-card-base_borderless-image {
+    position: absolute;
+    top: 0;
+    right: 0;
+    width: 100%;
+    height: 100%;
+}
+
+.dx-card-base_borderless-image_link {
+    position: relative;
+    margin-bottom: var(--dx-g-card-img-spacing);
+    height: 0;
+    padding-top: 50%;
+    border-radius: var(--dx-g-card-border-radius);
+    box-shadow: var(--dx-g-box-shadow-sm);
+    transition: var(--dx-g-transition-box-shadow-2x);
+    overflow: hidden;
+}
+
+.dx-card-base_borderless-image_link img {
+    border-radius: inherit;
+}
+
+/* Card play button */
+
+.dx-play-button {
+    --dx-c-icon-badge-box-shadow: var(--dx-g-box-shadow-sm);
+    --dx-c-icon-badge-color: var(--dx-g-blue-vibrant-50);
+    --dx-c-icon-badge-icon-transform: translateX(2px);
+    --dx-c-icon-badge-transition: var(--dx-g-transition-box-shadow-2x),
+        var(--dx-g-transition-hue-1x);
+}
+
+/* card link hovering */
+.dx-card-base_link-hovered .dx-card-base_image,
+a.dx-card-base:hover .dx-card-base_image {
+    filter: var(--dx-g-button-image-filter-hover);
+}
+
+.dx-card-base_link-hovered a .dx-play-button,
+a.dx-card-base:hover a .dx-play-button {
+    --dx-c-icon-badge-color: var(--dx-g-blue-vibrant-40);
+    --dx-c-icon-badge-box-shadow: var(--dx-g-box-shadow-md);
+}
+
+.dx-card-base_link-hovered a.dx-card-base_borderless-image_link,
+a.dx-card-base:hover a.dx-card-base_borderless-image_link {
+    --dx-c-icon-badge-box-shadow: var(--dx-g-box-shadow-md);
+}
+
+dx-card-title:hover,
+.dx-card-base_link-hovered dx-card-title,
+a.dx-card-base:hover dx-card-title {
+    --dx-c-card-title-color: var(--dx-g-button-heading-color-hover);
+}
+
+/* Line Limits */
+.dx-text-body-2,
+.dx-text-body-3 {
+    display: -webkit-box;
+    -webkit-line-clamp: var(--dx-c-body-max-lines);
+    -webkit-box-orient: vertical;
+    overflow: hidden;
+}
+
+/* Desktop Only */
+@media screen and (min-width: 1024px) {
+    .dx-card-base_layout-horizontal .dx-card-base_borderless-image_link {
+        align-self: flex-start;
+        flex-shrink: 0;
+        width: 0;
+        height: unset;
+        margin-right: var(--dx-g-card-img-spacing);
+        margin-bottom: unset;
+        padding-top: unset;
+        padding-right: 45%;
+        padding-bottom: 22.5%;
+    }
+
+    .dx-card-base_featured dx-card-title {
+        --dx-c-card-title-letter-spacing: -0.6px;
+        --dx-c-card-title-font-size: 32px;
+        --dx-c-card-title-line-height: 40px;
+        --dx-c-card-title-icon-size: 28px;
+    }
+
+    .dx-card-base_featured .dx-text-body-2 {
+        font-size: 20px;
+        letter-spacing: 0;
+        line-height: 32px;
+    }
+
+    .dx-card-base_featured .dx-text-body-3 {
+        font-size: 16px;
+        letter-spacing: 0;
+        line-height: 24px;
+    }
+}
+
+/* Tablet */
+@media screen and (max-width: 1024px) {
+    :host {
+        --dx-g-card-item-spacing: 8px;
+        --dx-g-card-img-spacing: 16px;
+    }
+
+    .dx-card-base_borderless-image {
+        min-height: unset;
+    }
+
+    /* text resp */
+    .dx-text-body-2,
+    .dx-text-body-3 {
+        -webkit-line-clamp: 3;
+    }
+
+    .dx-text-body-2 {
+        font-size: var(--dx-g-text-sm);
+        line-height: 20px;
+    }
+
+    .dx-text-body-3 {
+        font-size: var(--dx-g-text-xs);
+        line-height: 16px;
+    }
+
+    .dx-text-heading-3 {
+        font-size: 24px;
+        line-height: 28px;
+    }
+
+    .dx-text-heading-5 {
+        font-size: 12px;
+    }
+
+    .dx-text-heading-6 {
+        font-size: var(--dx-g-text-sm);
+    }
+}