@fluentui/web-components 3.0.0-beta.84 → 3.0.0-beta.85

package/dist/esm/tree-item/tree-item.styles.js

@@ -0,0 +1,170 @@
+import { css } from '@microsoft/fast-element';
+import { borderRadiusMedium, colorNeutralForeground2, colorNeutralForeground2Hover, colorNeutralForeground2Pressed, colorNeutralForeground2Selected, colorNeutralForeground3, colorNeutralForeground3Hover, colorNeutralForeground3Pressed, colorNeutralForeground3Selected, colorStrokeFocus2, colorSubtleBackground, colorSubtleBackgroundHover, colorSubtleBackgroundLightAlphaHover, colorSubtleBackgroundLightAlphaPressed, colorSubtleBackgroundLightAlphaSelected, colorSubtleBackgroundPressed, colorSubtleBackgroundSelected, colorTransparentBackground, colorTransparentBackgroundHover, colorTransparentBackgroundPressed, colorTransparentBackgroundSelected, curveEasyEaseMax, durationFaster, fontSizeBase300, spacingHorizontalM, spacingHorizontalXS, spacingHorizontalXXL, spacingHorizontalXXS, spacingVerticalNone, spacingVerticalS, spacingVerticalXXL, spacingVerticalXXS, spacingVerticalXXXL, } from '../theme/design-tokens.js';
+import { display } from '../utils/display.js';
+export const styles = css `
+  ${display('block')}
+
+  :host {
+    outline: none;
+  }
+
+  :host(:focus-visible) .positioning-region {
+    box-shadow: ${spacingVerticalNone} ${spacingVerticalNone} ${spacingVerticalNone} ${spacingVerticalXXS}
+      ${colorStrokeFocus2} inset;
+  }
+
+  /**
+   * Default variants:
+   * Size - medium
+   * Appearance - subtle
+   */
+  .positioning-region {
+    display: flex;
+    align-items: stretch;
+    justify-content: space-between;
+    cursor: pointer;
+    height: ${spacingVerticalXXXL};
+    padding-inline-start: calc(var(--indent) * ${spacingHorizontalXXL});
+    padding-inline-end: ${spacingVerticalS};
+    border-radius: ${borderRadiusMedium};
+    background-color: ${colorSubtleBackground};
+    color: ${colorNeutralForeground2};
+  }
+
+  @media (prefers-contrast: more) {
+    :host(:focus-visible) .positioning-region {
+      outline: 1px solid ${colorStrokeFocus2};
+    }
+  }
+
+  .content {
+    display: flex;
+    align-items: center;
+    font-size: ${fontSizeBase300};
+    min-width: 0;
+  }
+
+  .chevron {
+    display: flex;
+    align-items: center;
+    flex-shrink: 0;
+    min-width: 0;
+    justify-content: center;
+    width: ${spacingHorizontalXXL};
+    height: ${spacingVerticalXXL};
+    color: ${colorNeutralForeground3};
+    transition: transform ${durationFaster} ${curveEasyEaseMax};
+    transform: rotate(0deg);
+  }
+
+  .chevron:dir(rtl) {
+    transform: rotate(180deg);
+  }
+
+  .badging,
+  .toolbar {
+    display: flex;
+    align-items: center;
+    min-width: 0;
+    font-size: ${fontSizeBase300};
+  }
+
+  .positioning-region:hover {
+    background-color: ${colorSubtleBackgroundHover};
+    color: ${colorNeutralForeground2Hover};
+  }
+
+  .positioning-region:hover .content,
+  .positioning-region:hover .chevron {
+    color: ${colorNeutralForeground3Hover};
+  }
+
+  .positioning-region:active {
+    background-color: ${colorSubtleBackgroundPressed};
+    color: ${colorNeutralForeground2Pressed};
+  }
+
+  .positioning-region:active .content,
+  .positioning-region:active .chevron {
+    color: ${colorNeutralForeground3Pressed};
+  }
+
+  ::slotted([slot='start']),
+  ::slotted(:not([slot])) {
+    display: flex;
+    align-items: center;
+    min-width: 0;
+  }
+
+  ::slotted([slot='start']) {
+    flex-shrink: 0;
+    margin-inline-end: ${spacingHorizontalXS};
+  }
+
+  ::slotted(:not([slot])) {
+    padding-inline: ${spacingHorizontalXXS};
+  }
+
+  .items {
+    display: none;
+  }
+
+  :host([expanded]) .items {
+    display: block;
+  }
+
+  :host([empty]) .chevron,
+  :host([empty]) .items {
+    visibility: hidden;
+  }
+
+  :host([selected]) .positioning-region {
+    background-color: ${colorSubtleBackgroundSelected};
+    color: ${colorNeutralForeground2Selected};
+  }
+
+  :host([selected]) .content,
+  :host([selected]) .chevron {
+    color: ${colorNeutralForeground3Selected};
+  }
+
+  :host([size='small']) .positioning-region {
+    height: ${spacingVerticalXXL};
+    padding-inline-start: calc(var(--indent) * ${spacingHorizontalM});
+  }
+
+  :host([appearance='subtle-alpha']) .positioning-region:hover {
+    background-color: ${colorSubtleBackgroundLightAlphaHover};
+  }
+
+  :host([appearance='subtle-alpha']) .positioning-region:active {
+    background-color: ${colorSubtleBackgroundLightAlphaPressed};
+  }
+
+  :host([appearance='subtle-alpha'][selected]) .positioning-region {
+    background-color: ${colorSubtleBackgroundLightAlphaSelected};
+    color: ${colorNeutralForeground2Selected};
+  }
+
+  :host([appearance='transparent']) .positioning-region {
+    background-color: ${colorTransparentBackground};
+  }
+
+  :host([appearance='transparent']) .positioning-region:hover {
+    background-color: ${colorTransparentBackgroundHover};
+  }
+
+  :host([appearance='transparent']) .positioning-region:active {
+    background-color: ${colorTransparentBackgroundPressed};
+  }
+
+  :host([appearance='transparent'][selected]) .positioning-region {
+    background-color: ${colorTransparentBackgroundSelected};
+    color: ${colorNeutralForeground2Selected};
+  }
+
+  :host([expanded]) .chevron {
+    transform: rotate(90deg);
+  }
+`;
+//# sourceMappingURL=tree-item.styles.js.map

package/dist/esm/tree-item/tree-item.styles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-item.styles.js","sourceRoot":"","sources":["../../../src/tree-item/tree-item.styles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,yBAAyB,CAAC;AAC9C,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,4BAA4B,EAC5B,8BAA8B,EAC9B,+BAA+B,EAC/B,uBAAuB,EACvB,4BAA4B,EAC5B,8BAA8B,EAC9B,+BAA+B,EAC/B,iBAAiB,EACjB,qBAAqB,EACrB,0BAA0B,EAC1B,oCAAoC,EACpC,sCAAsC,EACtC,uCAAuC,EACvC,4BAA4B,EAC5B,6BAA6B,EAC7B,0BAA0B,EAC1B,+BAA+B,EAC/B,iCAAiC,EACjC,kCAAkC,EAClC,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAE9C,MAAM,CAAC,MAAM,MAAM,GAAG,GAAG,CAAA;IACrB,OAAO,CAAC,OAAO,CAAC;;;;;;;kBAOF,mBAAmB,IAAI,mBAAmB,IAAI,mBAAmB,IAAI,kBAAkB;QACjG,iBAAiB;;;;;;;;;;;;;cAaX,mBAAmB;iDACgB,oBAAoB;0BAC3C,gBAAgB;qBACrB,kBAAkB;wBACf,qBAAqB;aAChC,uBAAuB;;;;;2BAKT,iBAAiB;;;;;;;iBAO3B,eAAe;;;;;;;;;;aAUnB,oBAAoB;cACnB,kBAAkB;aACnB,uBAAuB;4BACR,cAAc,IAAI,gBAAgB;;;;;;;;;;;;;iBAa7C,eAAe;;;;wBAIR,0BAA0B;aACrC,4BAA4B;;;;;aAK5B,4BAA4B;;;;wBAIjB,4BAA4B;aACvC,8BAA8B;;;;;aAK9B,8BAA8B;;;;;;;;;;;;yBAYlB,mBAAmB;;;;sBAItB,oBAAoB;;;;;;;;;;;;;;;;;wBAiBlB,6BAA6B;aACxC,+BAA+B;;;;;aAK/B,+BAA+B;;;;cAI9B,kBAAkB;iDACiB,kBAAkB;;;;wBAI3C,oCAAoC;;;;wBAIpC,sCAAsC;;;;wBAItC,uCAAuC;aAClD,+BAA+B;;;;wBAIpB,0BAA0B;;;;wBAI1B,+BAA+B;;;;wBAI/B,iCAAiC;;;;wBAIjC,kCAAkC;aAC7C,+BAA+B;;;;;;CAM3C,CAAC"}

package/dist/esm/tree-item/tree-item.template.js

@@ -0,0 +1,41 @@
+import { children, elements, html } from '@microsoft/fast-element';
+const chevronIcon = html `
+  <svg width="12" height="12" xmlns="http://www.w3.org/2000/svg" fill="currentColor">
+    <path
+      d="M4.65 2.15a.5.5 0 000 .7L7.79 6 4.65 9.15a.5.5 0 10.7.7l3.5-3.5a.5.5 0 000-.7l-3.5-3.5a.5.5 0 00-.7 0z"
+    ></path>
+  </svg>
+`;
+export const template = html `
+  <template
+    tabindex="-1"
+    slot="${x => (x.isNestedItem ? 'item' : void 0)}"
+    @focusin="${(x, c) => x.focusHandler(c.event)}"
+    @focusout="${(x, c) => x.blurHandler(c.event)}"
+    ${children({
+    property: 'childTreeItems',
+    filter: elements(),
+})}
+  >
+    <div class="positioning-region" part="positioning-region">
+      <div class="content" part="content">
+        <span class="chevron" part="chevron">
+          <slot name="chevron">${chevronIcon}</slot>
+        </span>
+        <slot name="start"></slot>
+        <slot></slot>
+        <slot name="end"></slot>
+      </div>
+      <div class="badging" part="badging">
+        <slot name="badging"></slot>
+      </div>
+      <div class="toolbar" part="toolbar">
+        <slot name="toolbar"></slot>
+      </div>
+    </div>
+    <div role="group" class="items" part="items">
+      <slot name="item"></slot>
+    </div>
+  </template>
+`;
+//# sourceMappingURL=tree-item.template.js.map

package/dist/esm/tree-item/tree-item.template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-item.template.js","sourceRoot":"","sources":["../../../src/tree-item/tree-item.template.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAGnE,MAAM,WAAW,GAAG,IAAI,CAAA;;;;;;CAMvB,CAAC;AAEF,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,CAAU;;;YAG1B,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;gBACnC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,KAAmB,CAAC;iBAC9C,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,KAAmB,CAAC;MACzD,QAAQ,CAAC;IACT,QAAQ,EAAE,gBAAgB;IAC1B,MAAM,EAAE,QAAQ,EAAE;CACnB,CAAC;;;;;iCAK2B,WAAW;;;;;;;;;;;;;;;;;CAiB3C,CAAC"}

package/dist/web-components.d.ts

@@ -7371,6 +7371,16 @@ export declare function isDropdownOption(value: Node | null, tagName?: string):
  */
 export declare function isListbox(element?: Node | null, tagName?: string): element is Listbox;
 
+/**
+ * Predicate function that determines if the element should be considered an tree-item.
+ *
+ * @param element - The element to check.
+ * @param tagName - The tag name to check.
+ * @returns true if the element is a dropdown.
+ * @public
+ */
+export declare function isTreeItem(element?: Node | null, tagName?: string): element is TreeItem;
+
 /**
  * The base class used for constructing a fluent-label custom element
  * @public
@@ -11149,6 +11159,153 @@ export declare const TooltipStyles: ElementStyles;
  */
 export declare const TooltipTemplate: ViewTemplate<Tooltip, any>;
 
+export declare class TreeItem extends FASTElement {
+    /**
+     * The internal {@link https://developer.mozilla.org/docs/Web/API/ElementInternals | `ElementInternals`} instance for the component.
+     *
+     * @internal
+     */
+    elementInternals: ElementInternals;
+    constructor();
+    /**
+     * When true, the control will be appear expanded by user interaction.
+     * @public
+     * HTML Attribute: `expanded`
+     */
+    expanded: boolean;
+    /**
+     * Handles changes to the expanded attribute
+     * @param prev - the previous state
+     * @param next - the next state
+     *
+     * @public
+     */
+    expandedChanged(prev: boolean, next: boolean): void;
+    /**
+     * When true, the control will appear selected by user interaction.
+     * @public
+     * @remarks
+     * HTML Attribute: selected
+     */
+    selected: boolean;
+    /**
+     * Handles changes to the selected attribute
+     * @param prev - the previous state
+     * @param next - the next state
+     *
+     * @internal
+     */
+    protected selectedChanged(prev: boolean, next: boolean): void;
+    /**
+     * When true, the control has no child tree items
+     * @public
+     * HTML Attribute: empty
+     */
+    empty: boolean;
+    /**
+     * The size of the tree item element
+     * @public
+     */
+    size: TreeItemSize;
+    /**
+     * Handles changes to the size attribute
+     * we update the child tree items' size based on the size
+     *  @internal
+     */
+    private sizeChanged;
+    /**
+     * The size of the tree item element
+     * @public
+     */
+    appearance: TreeItemAppearance;
+    /**
+     * Handles changes to the appearance attribute
+     *
+     * @internal
+     */
+    private appearanceChanged;
+    private styles;
+    /**
+     * The indent of the tree item element.
+     * This is not needed once css attr() is supported (--indent: attr(data-indent type(<number>)));
+     * @public
+     */
+    dataIndent: number | undefined;
+    private dataIndentChanged;
+    childTreeItems: TreeItem[] | undefined;
+    /**
+     * Handles changes to the child tree items
+     *
+     * @internal
+     */
+    protected childTreeItemsChanged(): void;
+    /**
+     * 1. Update the child items' size based on the tree's size
+     * 2. Update the child items' appearance based on the tree's appearance
+     */
+    private updateChildTreeItems;
+    /**
+     * Sets the indent for each item
+     */
+    private setIndent;
+    /**
+     * Handle focus events
+     *
+     * @public
+     */
+    focusHandler(e: FocusEvent): void;
+    /**
+     * Handle blur events
+     *
+     * @public
+     */
+    blurHandler(e: FocusEvent): void;
+    /**
+     * Toggle the expansion state of the tree item
+     *
+     * @public
+     */
+    toggleExpansion(): void;
+    /**
+     * Toggle the single selection state of the tree item
+     *
+     * @public
+     */
+    toggleSelection(): void;
+    /**
+     * Whether the tree is nested
+     * @internal
+     */
+    get isNestedItem(): boolean;
+}
+
+export declare const TreeItemAppearance: {
+    readonly subtle: "subtle";
+    readonly subtleAlpha: "subtle-alpha";
+    readonly transparent: "transparent";
+};
+
+export declare type TreeItemAppearance = ValuesOf<typeof TreeItemAppearance>;
+
+/**
+ *
+ * @public
+ * @remarks
+ * HTML Element: \<fluent-tree-item\>
+ */
+export declare const TreeItemDefinition: FASTElementDefinition<typeof TreeItem>;
+
+export declare const TreeItemSize: {
+    readonly small: "small";
+    readonly medium: "medium";
+};
+
+export declare type TreeItemSize = ValuesOf<typeof TreeItemSize>;
+
+export declare const TreeItemStyles: ElementStyles;
+
+export declare const TreeItemTemplate: ViewTemplate<TreeItem, any>;
+
 export declare const typographyBody1StrongerStyles: CSSDirective;
 
 export declare const typographyBody1StrongStyles: CSSDirective;