Package detail

@microsoft/fast-foundation

Microsoft615kMIT2.50.0

A library of Web Component building blocks

readme

FAST Foundation

The fast-foundation package is a library of Web Component classes, templates, and other utilities intended to be composed into registered Web Components by design systems (e.g. Fluent Design, Material Design, etc.). The exports of this package can generally be thought of as un-styled base components that implement semantic and accessible markup and behavior.

This package does not export Web Components registered as custom elements - it exports parts and pieces intended to be composed into Web Components, allowing you to implement your own design language by simply applying CSS styles and behaviors without having to write all the JavaScript that's involved in building production-quality component implementations.

Installation

From NPM

To install the fast-foundation library, use either npm or yarn as follows:

npm install --save @microsoft/fast-foundation

yarn add @microsoft/fast-foundation

Within your JavaScript or TypeScript code, you can then import library APIs like this:

import { Anchor } from '@microsoft/fast-foundation';

Looking for a setup that integrates with a particular front-end framework or bundler? Check out our integration docs.

From CDN

A pre-bundled script that contains all APIs needed to use FAST Foundation is available on CDN. You can use this script by adding type="module" to the script element and then importing from the CDN.

<!DOCTYPE html>
<html lang="en">
    <head>
        <script type="module">
          import { Anchor } from "https://cdn.jsdelivr.net/npm/@microsoft/fast-foundation/dist/fast-foundation.min.js";

          // your code here
        </script>
    </head>
    <!-- ... -->
</html>

The markup above always references the latest release. When deploying to production, you will want to ship with a specific version. Here's an example of the markup for that:

<script type="module" src="https://cdn.jsdelivr.net/npm/@microsoft/fast-foundation@2.26.2/dist/fast-foundation.min.js"></script>

:::note For simplicity, examples throughout the documentation will assume the library has been installed from NPM, but you can always replace the import location with the CDN URL. :::

changelog

Change Log - @microsoft/fast-foundation

This log was last generated on Wed, 23 Oct 2024 23:53:44 GMT and should not be manually modified.

2.50.0

Wed, 23 Oct 2024 23:53:44 GMT

Minor changes

feat: close combobox if indicator is clicked and no selection is made (=)
Bump @microsoft/fast-element to v1.14.0

Patches

Fix design token issues involving deleting values and CSS reflection (7282195+m-akinc@users.noreply.github.com)
fix: prevent toolbar from stealing focus when focus has already been moved in the document (=)
Fix CSS custom property precedence issue and work around Chromium bug (7282195+m-akinc@users.noreply.github.com)
Fix memory leak due to binding observers (7282195+m-akinc@users.noreply.github.com)

2.49.5

Tue, 23 Jan 2024 19:35:35 GMT

Patches

Fix design token inheritance bug (7282195+m-akinc@users.noreply.github.com)
fix typing issue for menu to fix build issue (chhol@microsoft.com)
Allow non-MenuItem-derived types to be indented properly (7282195+m-akinc@users.noreply.github.com)

2.49.4

Thu, 09 Nov 2023 19:30:24 GMT

Patches

fix: call super.disconnectedCallback in form associated base class (chhol@microsoft.com)

2.49.3

Wed, 01 Nov 2023 20:34:39 GMT

Patches

Fix focus issues with toolbar (20542556+mollykreis@users.noreply.github.com)

2.49.1

Fri, 11 Aug 2023 00:10:28 GMT

Patches

Prevent keyboard navigation to hidden or disabled tabs (7282195+m-akinc@users.noreply.github.com)
set activeid when setting active tab (chhol@microsoft.com)

2.49.0

Thu, 04 May 2023 17:35:08 GMT

Minor changes

add else case to when directive (chhol@microsoft.com)
Bump @microsoft/fast-element to v1.12.0

2.48.1

Fri, 14 Apr 2023 19:08:49 GMT

Patches

Bump @microsoft/fast-element to v1.11.1

2.48.0

Mon, 10 Apr 2023 18:32:45 GMT

Minor changes

fix(Calendar): add fix for the timezones from #5539 (Mathieu.Salois@goto.com)

Patches

add missing part to tabpanel in tabs component (chhol@microsoft.com)
update anchor reference type to support undefined and suppress breadcrumb linting issue (chhol@microsoft.com)
revert: token typings that broke build (jes@microsoft.com)

2.47.1-0

Mon, 28 Nov 2022 18:28:05 GMT

Changes

hidden horizontal-scroll fix (robarb@microsoft.com)

2.47.0

Tue, 25 Oct 2022 03:07:31 GMT

Minor changes

fix(fast-foundation): update mixin helper to use new attribute api (roeisenb@microsoft.com)
Bump @microsoft/fast-element to v1.11.0

Patches

add activeid to accordion change event (chhol@microsoft.com)

2.46.14

Fri, 02 Sep 2022 17:18:31 GMT

Patches

accordion verifies change events (stephcomeau@msn.com)
ensure switch cannot be invoked via keyboard when in readonly mode (chhol@microsoft.com)
call change when search component clear button is clicked (jes@microsoft.com)

2.46.13

Sat, 27 Aug 2022 16:53:58 GMT

Patches

Fix constraint validation in focus-delegated components (nicholasrice@users.noreply.github.com)

2.46.12

Wed, 17 Aug 2022 16:41:39 GMT

Patches

Various Combobox fixes with tests. (26874831+atmgrifter00@users.noreply.github.com)
Bump @microsoft/fast-element to v1.10.5

2.46.9

Sun, 29 May 2022 07:08:52 GMT

Patches

fix: fast-foundation - 'get' and 'set' accessor must have the same type (#5964) (aagharat@dstworldwideservices.com)

2.46.8

Thu, 26 May 2022 07:11:44 GMT

Patches

Revert "fix: add missing required attribute binding to switch template (#6014)" (burtonsmith@microsoft.com)

2.46.7

Wed, 25 May 2022 07:09:21 GMT

Patches

add missing binding for required attribute in the switch template (chhol@microsoft.com)

2.46.6

Tue, 24 May 2022 07:10:02 GMT

Patches

Bump @microsoft/fast-element to v1.10.2 (roeisenb@microsoft.com)

2.46.5

Sun, 22 May 2022 07:09:02 GMT

Patches

disable keyboard controls for readonly sliders (burtonsmith@microsoft.com)

2.46.4

Thu, 19 May 2022 07:09:40 GMT

Patches

Handle disabled and hidden items in toolbar (20542556+mollykreis@users.noreply.github.com)

2.46.3

Tue, 10 May 2022 07:11:04 GMT

Patches

select ignores l&r arrow keys (scomea@microsoft.com)

2.46.2

Thu, 05 May 2022 07:11:41 GMT

Patches

fix positioning of select dropdown (abris96@gmail.com)
reset selection range when selecting option with cursor (abris96@gmail.com)

2.46.1

Wed, 04 May 2022 07:14:00 GMT

Patches

convert enums to const objects and add supported typings (chhol@microsoft.com)

2.46.0

Tue, 03 May 2022 07:15:44 GMT

Minor changes

add slots and events documentation (scomea@microsoft.com)

Patches

reflect option value changes in select (john.kreitlow@microsoft.com)
fix: selectedIndex property ignores disabled options in listbox and select (john.kreitlow@microsoft.com)
viewport lock + fill behavior (scomea@microsoft.com)
Upgraded api-extractor (44823142+williamw2@users.noreply.github.com)
Bump @microsoft/fast-element to v1.10.1 (44823142+williamw2@users.noreply.github.com)

2.45.0

Sun, 01 May 2022 07:12:05 GMT

Minor changes

add select method to number field, text field, and text area components (chhol@microsoft.com)

Patches

ensure that tabs and tabpanels without ids stay in sync (chhol@microsoft.com)
trim extra spaces from the text property for listbox-option (john.kreitlow@microsoft.com)
fix keyboarding behavior for right and left arrow keys in Tree View (chhol@microsoft.com)

2.44.0

Thu, 28 Apr 2022 07:12:47 GMT

Minor changes

update displayed selected value in select component when an option changes (john.kreitlow@microsoft.com)

2.43.0

Wed, 27 Apr 2022 07:21:09 GMT

Minor changes

update to typescript 4.6.2 and update ARIAMixin typings (chhol@microsoft.com)

Patches

Bump @microsoft/fast-web-utilities to v5.4.0 (chhol@microsoft.com)
Bump @microsoft/fast-element to v1.10.0 (chhol@microsoft.com)

2.42.2

Thu, 21 Apr 2022 07:13:54 GMT

Patches

Added support for styling slider value on the track (47367562+bheston@users.noreply.github.com)

2.42.1

Sun, 17 Apr 2022 07:11:18 GMT

Patches

fix: scrolling back from end and forward retains next flipper in horizontal-scroll (robarb@microsoft.com)
Ensured that tabs without an ID use a unique ID to prevent duplicate IDs when multiple tabs are on a page (chhol@microsoft.com)
Ensure the skeleton component's object element is not included in the accessibility tree (chhol@microsoft.com)

2.42.0

Thu, 14 Apr 2022 07:12:36 GMT

Minor changes

Implements <dialog> element events on FastDialog (web@bennypowers.com)
add multiselect mode to select (john.kreitlow@microsoft.com)

2.41.1

Thu, 07 Apr 2022 07:12:06 GMT

Patches

Improved README markdown formatting (44823142+williamw2@users.noreply.github.com)

2.41.0

Wed, 06 Apr 2022 07:12:42 GMT

Minor changes

convert fast-foundation to type:module (nicholasrice@users.noreply.github.com)

Patches

Added CEM Analyzer and API markdown to readme files (44823142+williamw2@users.noreply.github.com)
Bump @microsoft/fast-element to v1.9.0 (nicholasrice@users.noreply.github.com)

2.40.0

Sun, 03 Apr 2022 07:12:01 GMT

Minor changes

update aria-current for breadcrumb items when new nodes are appended (chhol@microsoft.com)
remove fromView from aria mixin attributes (chhol@microsoft.com)

Patches

Bump @microsoft/fast-web-utilities to v5.2.0 (nicholasrice@users.noreply.github.com)

2.39.0

Thu, 31 Mar 2022 07:13:31 GMT

Minor changes

remove duplicate use of heading class in accordion item and update part location (chhol@microsoft.com)

Patches

fix hidden menu items should not be included in the tabindex (chhol@microsoft.com)

2.38.0

Sun, 27 Mar 2022 07:11:50 GMT

Minor changes

Changed Select open attribute to public (44823142+williamw2@users.noreply.github.com)
Add string literal union types to all foundation components that use an enum for attribute options (hawkticehurst@gmail.com)

2.37.2

Thu, 24 Mar 2022 07:12:08 GMT

Patches

Detect changes to start and end slots in toolbar (20542556+mollykreis@users.noreply.github.com)

2.37.1

Sun, 20 Mar 2022 07:15:44 GMT

Patches

Fix for default selection behavior for listbox and select (26874831+atmgrifter00@users.noreply.github.com)

2.37.0

Wed, 16 Mar 2022 07:12:41 GMT

Minor changes

enable no tabbing (scomea@microsoft.com)

2.36.1

Tue, 15 Mar 2022 07:12:38 GMT

Patches

anchored region not beta (scomea@microsoft.com)
tree view single select (scomea@microsoft.com)

2.36.0

Fri, 11 Mar 2022 23:46:34 GMT

Minor changes

BREAKING CHANGE: replace WC button with stock HTML button (jes@microsoft.com)
implement attribute reflection directive (nicholasrice@users.noreply.github.com)

Patches

use WeakMap to prevent leaking element references from FormAssociated (nicholasrice@users.noreply.github.com)

2.35.2

Wed, 09 Mar 2022 07:12:32 GMT

Patches

Fix bug with menu-item indention (20542556+mollykreis@users.noreply.github.com)

2.35.1

Tue, 08 Mar 2022 07:12:45 GMT

Patches

Fix programmatic disable/enable of tabs (5454342+brianehenry@users.noreply.github.com)

2.35.0

Sun, 06 Mar 2022 07:13:48 GMT

Minor changes

add corner positions to tooltip (sethdonohue@Admins-MBP.guest.corp.microsoft.com)

Patches

passive handlers (scomea@microsoft.com)
tooltip hover (scomea@microsoft.com)

2.34.0

Wed, 02 Mar 2022 07:12:58 GMT

Minor changes

add mermaid support (steph@huynhicode.dev)

Patches

generate grid columns for manual grid (scomea@microsoft.com)
auto columns fix (scomea@microsoft.com)
Fixing no previous scroll when only 2 items (robarb@microsoft.com)

2.33.6

Fri, 25 Feb 2022 17:09:32 GMT

Patches

Bump @microsoft/fast-element to v1.7.2 (roeisenb@microsoft.com)

2.33.5

Thu, 24 Feb 2022 22:21:55 GMT

Patches

Format improvement to match standards (16669785+awentzel@users.noreply.github.com)
fix combobox and select position when set after init (corylaviska@microsoft.com)
allow programmatic control of the open property for select and combobox (john.kreitlow@microsoft.com)

2.33.4

Sun, 20 Feb 2022 07:16:20 GMT

Patches

tree view events (scomea@microsoft.com)

2.33.3

Tue, 15 Feb 2022 07:11:28 GMT

Patches

disable noImplicitAny in fast-foundation (mathieu.lavoie@shopify.com)

2.33.2

Thu, 10 Feb 2022 07:12:01 GMT

Patches

Fix initial select value when set early after connect (5454342+brianehenry@users.noreply.github.com)

2.33.1

Wed, 09 Feb 2022 07:14:00 GMT

Patches

allow empty string values for listbox-option value attribute (john.kreitlow@microsoft.com)

2.33.0

Sun, 06 Feb 2022 07:15:20 GMT

Minor changes

add menu positioning to picker (scomea@microsoft.com)
add multiselect functionality to listbox (john.kreitlow@microsoft.com)

Patches

ensure menu items update (scomea@microsoft.com)
fix: diabled listbox missing styles & allows click (jes@microsoft.com)
fix: allow slider to show small increment changes (jes@microsoft.com)
fix: flippersHiddenFromAT shouldn't map to aria-hidden (robarb@microsoft.com)
tooltip anchor attribute updates work (scomea@microsoft.com)

2.32.3

Wed, 02 Feb 2022 07:13:39 GMT

Patches

fix: February tests are failing in calendar tests (robarb@microsoft.com)
fix broken links and formatting (john.kreitlow@microsoft.com)

2.32.2

Sun, 30 Jan 2022 07:12:35 GMT

Patches

convert functions to templates (mathieulavoie94@gmail.com)

2.32.1

Tue, 25 Jan 2022 07:11:53 GMT

Patches

Bump @microsoft/fast-web-utilities to v5.1.0 (john.kreitlow@microsoft.com)

2.32.0

Sun, 23 Jan 2022 07:13:56 GMT

Minor changes

feat: add orientation to divider (jes@microsoft.com)

Patches

use default slot in accordion (mathieulavoie94@gmail.com)
Bump @microsoft/fast-element to v1.7.0 (scomea@microsoft.com)

2.31.0

Thu, 20 Jan 2022 07:12:04 GMT

Minor changes

add checked property to listbox-option (john.kreitlow@microsoft.com)

2.30.0

Sun, 16 Jan 2022 07:11:36 GMT

Minor changes

Add valueAsNumber to number field and slider (5454342+brianehenry@users.noreply.github.com)

2.29.0

Sun, 09 Jan 2022 07:11:51 GMT

Minor changes

fix accessibility for listbox, select, and combobox (john.kreitlow@microsoft.com)

2.28.0

Thu, 06 Jan 2022 07:11:52 GMT

Minor changes

fix: prevent events to propagate from disabled button (#4884) (email not defined)

Patches

tooltip uses "center" (scomea@microsoft.com)

2.27.3

Sun, 19 Dec 2021 07:12:39 GMT

Patches

Replace equality check with NaN with the Number.isNan function (anthonystewart@google.com)
add queueUpdate for setStops in horzontal scroll (sethdonohue@Admins-MBP.guest.corp.microsoft.com)

2.27.2

Wed, 15 Dec 2021 07:14:44 GMT

Patches

focus on combobox control when clicking an associated label (john.kreitlow@microsoft.com)

2.27.1

Thu, 02 Dec 2021 07:11:13 GMT

Patches

fix: disabled tree items fire (jes@microsoft.com)

2.27.0

Tue, 23 Nov 2021 07:12:23 GMT

Minor changes

add size attribute to listbox element (john.kreitlow@microsoft.com)

2.26.2

Thu, 11 Nov 2021 07:15:33 GMT

Patches

convert tsdoc-config dependency to dev-dependency (nicholasrice@users.noreply.github.com)

2.26.1

Wed, 10 Nov 2021 07:12:54 GMT

Patches

Enabling setting number-field value through script (robarb@microsoft.com)

2.26.0

Tue, 09 Nov 2021 07:14:09 GMT

Minor changes

feat: add search web component (jes@microsoft.com)

2.25.1

Thu, 04 Nov 2021 07:11:59 GMT

Patches

fix: change event emitted twice (jes@microsoft.com)

2.25.0

Wed, 03 Nov 2021 07:12:39 GMT

Minor changes

add placeholder attr to picker (scomea@microsoft.com)

2.24.0

Sun, 31 Oct 2021 07:17:45 GMT

Minor changes

Added the CheckableFormAssociated mixin to better support the addition of current-checked property/attribute that allows for setting checked state via the .setAttribute() API. This change also converts two lifecycle hooks to methods from properties so that they can be handled correctly by the browser. (nicholasrice@users.noreply.github.com)

Patches

fix: number-field increment decrement logic (robarb@microsoft.com)
picker focus on input after selection (scomea@microsoft.com)
update fast eslint package version (chhol@microsoft.com)
Bump @microsoft/fast-element to v1.6.2 (chhol@microsoft.com)
Bump @microsoft/fast-web-utilities to v5.0.2 (chhol@microsoft.com)

2.23.2

Thu, 28 Oct 2021 07:15:32 GMT

Patches

fixes emission of CSS custom properties in FireFox and Safari (nicholasrice@users.noreply.github.com)

2.23.1

Wed, 27 Oct 2021 07:11:58 GMT

Patches

switch should check when using both enter and space (chhol@microsoft.com)

2.23.0

Fri, 22 Oct 2021 17:40:52 GMT

Minor changes

adds a currentValue property to form-associated to facilitate attribute-based data binding for form values (chhol@microsoft.com)

Patches

picker clear query on selection (scomea@microsoft.com)
Improving number field interactions and tests (robarb@microsoft.com)

2.22.1

Thu, 21 Oct 2021 07:11:42 GMT

Patches

fix broken tooltip (scomea@microsoft.com)

2.22.0

Wed, 20 Oct 2021 07:13:46 GMT

Minor changes

add centered positioning option to anchored region (scomea@microsoft.com)

2.21.0

Fri, 15 Oct 2021 23:24:14 GMT

Minor changes

Implement DesignToken root-element registration for CSS custom property emission of default token values (nicholasrice@users.noreply.github.com)

Patches

implement level-2 DOM support for DesignToken in browsers that don't support Constructable StyleSheets (nicholasrice@users.noreply.github.com)

2.20.0

Wed, 13 Oct 2021 22:45:16 GMT

Minor changes

Adding fast-calendar component (robarb@microsoft.com)

Patches

move style assignment for combobox and select into the class and off the DOM node (chhol@microsoft.com)
Code fixes for calendar (robarb@microsoft.com)
Bump @microsoft/fast-element to v1.6.1 (markwhitfeld@users.noreply.github.com)

2.19.0

Wed, 13 Oct 2021 01:53:37 GMT

Minor changes

data-grid: add support for rowheader role (scomea@microsoft.com)
Add focus event handler to tooltip (v-dlesac@microsoft.com)

Patches

refactor: remove lodash-es as a dependency (connor@peet.io)
use css transforms and transitions in horizontal scroll (john.kreitlow@microsoft.com)
Bump @microsoft/fast-web-utilities to v5.0.1 (john.kreitlow@microsoft.com)

2.18.0

Tue, 12 Oct 2021 07:15:14 GMT

Minor changes

fix(di): context confused for key with some registrations (roeisenb@microsoft.com)

Patches

Update design-token default value emission to emit to a stylesheet instead of inline styles on the document body (nicholasrice@users.noreply.github.com)
add aria-disabled to accordion-item for single-mode (khamu@microsoft.com)

2.17.3

Sun, 10 Oct 2021 07:12:26 GMT

Patches

fix linting errors in horizontal-scroll tests (john.kreitlow@microsoft.com)

2.17.2

Fri, 08 Oct 2021 19:53:11 GMT

Patches

anchored region force update (scomea@microsoft.com)

2.17.1

Wed, 06 Oct 2021 07:11:47 GMT

Patches

picker menu shows with only custom options (scomea@microsoft.com)

2.17.0

Tue, 05 Oct 2021 00:45:07 GMT

Minor changes

feat: add scroll events to horizontal-scroll component (robarb@microsoft.com)

Patches

fix: nested tree items not selecting (jes@microsoft.com)

2.16.5

Thu, 30 Sep 2021 07:13:45 GMT

Patches

Disabling scroll easing for speed=0 (robarb@microsoft.com)

2.16.4

Wed, 29 Sep 2021 07:13:40 GMT

Patches

do not prevent default on tree item click (chhol@microsoft.com)
fix: allowing decimal values in fast number field (robarb@microsoft.com)
fix: sliders mouseup is not firing when leaving the window (robarb@microsoft.com)

2.16.3

Tue, 28 Sep 2021 07:10:49 GMT

Patches

made orientation changed update child tab styles (marjon@microsoft.com)
Fix: active indicator keyboarding issue in tabs (jes@microsoft.com)

2.16.2

Mon, 27 Sep 2021 07:12:15 GMT

Patches

fix: ensure tree item selection is only managed in tree view (jes@microsoft.com)

2.16.1

Thu, 23 Sep 2021 07:14:34 GMT

Patches

Removing design-system-provider from storybook (robarb@microsoft.com)
Horizontal-scroll tests cleanup (robarb@microsoft.com)

2.16.0

Wed, 22 Sep 2021 07:13:13 GMT

Minor changes

feat(di): add registerWithContext and use in design system (roeisenb@microsoft.com)

Patches

fix: active indicator does not update when activeid attr is changed (jes@microsoft.com)
fix aria-describedby typos (v-dlesac@microsoft.com)

2.15.0

Sun, 19 Sep 2021 07:17:17 GMT

Minor changes

add picker component (scomea@microsoft.com)

Patches

fix: remove dependency on document for root containers & design systems (roeisenb@microsoft.com)
Bump @microsoft/fast-web-utilities to v5.0.0 (scomea@microsoft.com)

2.14.0

Wed, 15 Sep 2021 19:49:35 GMT

Minor changes

fix type issue for FoundationElementTemplate (john.kreitlow@microsoft.com)

Patches

Fix design-token subscription bugs where subscribers were not getting notified (nicholasrice@users.noreply.github.com)

2.13.1

Tue, 14 Sep 2021 07:16:47 GMT

Patches

Using a manual focus to workaround delegatesFocus issues on Firefox for the button and anchor components (jumarroq@microsoft.com)

2.13.0

Sun, 12 Sep 2021 07:17:43 GMT

Minor changes

use class method for radio click handler property (john.kreitlow@microsoft.com)

Patches

remove dependencies on keycode (scomea@microsoft.com)
Bump @microsoft/fast-web-utilities to v4.8.1 (scomea@microsoft.com)

2.12.0

Thu, 09 Sep 2021 07:21:36 GMT

Minor changes

add start/end slot definitions to support default slotted content (chhol@microsoft.com)

Patches

fix(design-system): make FoundationElement.compose safe to use directly (roeisenb@microsoft.com)

2.11.0

Wed, 08 Sep 2021 07:16:17 GMT

Minor changes

fix: allow for base class (mathieu.lavoie@logmein.com)

Patches

force non-volatile binding and update docs to explain that DesignToken does not support volatile bindings (nicholasrice@users.noreply.github.com)
Bump @microsoft/fast-element to v1.5.1 (roeisenb@microsoft.com)

2.10.0

Thu, 02 Sep 2021 17:17:56 GMT

Minor changes

feat(design-system): enable complete ignore of duplicate elements (roeisenb@microsoft.com)

2.9.1

Thu, 02 Sep 2021 07:15:21 GMT

Patches

configure system to use a single CSSStyleSheet for custom property setting (nicholasrice@users.noreply.github.com)
progress component bar width (scomea@microsoft.com)
Removed remaining 'use-defaults' which no longer exists (47367562+bheston@users.noreply.github.com)

2.9.0

Wed, 01 Sep 2021 07:18:34 GMT

Minor changes

add viewport lock to tooltip (scomea@microsoft.com)

Patches

don't block all keys while focused (corylaviska@microsoft.com)

2.8.1

Mon, 30 Aug 2021 22:30:39 GMT

Patches

fixing issue where a token would subscribe to itself, causing max-callstack-exceded in certain scenarios (nicholasrice@users.noreply.github.com)

2.8.0

Fri, 27 Aug 2021 14:14:26 GMT

Minor changes

Refactor DesignToken implementation to support deep token dependency hierarchies (nicholasrice@users.noreply.github.com)

Patches

add up/down key support to number-field (corylaviska@microsoft.com)
Bump @microsoft/fast-element to v1.5.0 (nicholasrice@users.noreply.github.com)

2.7.1

Thu, 26 Aug 2021 07:17:43 GMT

Patches

fix slider dragging when page is scrolled (corylaviska@microsoft.com)

2.7.0

Wed, 25 Aug 2021 07:17:07 GMT

Minor changes

allow context for partials on component compositions (john.kreitlow@microsoft.com)

2.6.5

Thu, 19 Aug 2021 07:15:21 GMT

Patches

add reducefocusableElements and all slotted items to keyboard interaction (sethdonohue@Admins-MBP.guest.corp.microsoft.com)

2.6.4

Thu, 12 Aug 2021 07:16:50 GMT

Patches

fix dialog focus on open (scomea@microsoft.com)

2.6.3

Wed, 04 Aug 2021 07:15:14 GMT

Patches

menu should check for slot before automatically assigning a value (chhol@microsoft.com)

2.6.2

Thu, 29 Jul 2021 07:18:18 GMT

Patches

remove unnecessary aria-hidden attributes (47367562+bheston@users.noreply.github.com)

2.6.1

Wed, 28 Jul 2021 07:17:22 GMT

Patches

update on !regionVisible (scomea@microsoft.com)

2.6.0

Sun, 25 Jul 2021 07:17:41 GMT

Minor changes

add auto position tracking to tooltip (scomea@microsoft.com)
anchored region uses transform (scomea@microsoft.com)

2.5.2

Thu, 22 Jul 2021 07:19:53 GMT

Patches

Fixed attr boolean mode on menu item (47367562+bheston@users.noreply.github.com)

2.5.1

Wed, 21 Jul 2021 07:14:48 GMT

Patches

Hide step-up and step-down for number-field when readonly (robarb@microsoft.com)

2.5.0

Thu, 15 Jul 2021 01:41:48 GMT

Minor changes

extend design token type signature (chhol@microsoft.com)

2.4.0

Tue, 13 Jul 2021 07:14:52 GMT

Minor changes

docs(di): make API public, stabilize, and add docs (roeisenb@microsoft.com)

2.3.0

Wed, 07 Jul 2021 07:19:51 GMT

Minor changes

focus trap improvement (scomea@microsoft.com)

2.2.0

Sun, 04 Jul 2021 07:15:28 GMT

Minor changes

select should emit an input event before the change event (john.kreitlow@microsoft.com)

2.1.0

Thu, 01 Jul 2021 07:15:57 GMT

Minor changes

ensure DesignToken considers shadow DOM when determining DOM hierarchy (nicholasrice@users.noreply.github.com)

Patches

Fixes bug in DesignToken where aliased tokens didn't update CSS custom properties. (nicholasrice@users.noreply.github.com)

2.0.0

Fri, 25 Jun 2021 02:02:57 GMT

Major changes

remove deprecated APIs and Design System Provider infrastructure (nicholasrice@users.noreply.github.com)
feat(design-system): better integrate with DI and enforce constraints (roeisenb@microsoft.com)
migrate directional-stylesheet utility (nicholasrice@users.noreply.github.com)
update components to extend FoundationElement (chhol@microsoft.com)
feat: styling and text alignment for menu (jes@microsoft.com)
add API support for setting default slotted content as part of component composition (chhol@microsoft.com)
update card to extend foundation (chhol@microsoft.com)
feat: encapsulate and optimize ComponentPresentation resolution (roeisenb@microsoft.com)

Minor changes

fix(foundation-element): enable subclassing with customElement decorator (roeisenb@microsoft.com)
feat(design-system): enable overriding the shadow root mode (roeisenb@microsoft.com)
docs(fast-foundation): add api docs for design system and foundation ele (roeisenb@microsoft.com)

1.24.8

Wed, 23 Jun 2021 22:58:18 GMT

Patches

prevent left/right arrows from scrolling when expanding/collapsing tree-item (tlmii@users.noreply.github.com)

1.24.7

Sun, 20 Jun 2021 07:21:25 GMT

Patches

Enable stepping from null values on number-field (robarb@microsoft.com)
fix malformed templates (scomea@microsoft.com)

1.24.6

Sun, 13 Jun 2021 07:19:23 GMT

Patches

ensure host element of a shadowed element can be resolved (nicholasrice@users.noreply.github.com)

1.24.5

Tue, 08 Jun 2021 07:29:18 GMT

Patches

streamline horizontal scroll resize (scomea@microsoft.com)

1.24.4

Sun, 30 May 2021 07:42:30 GMT

Patches

Ensure stale Design Token custom property stylesheets are removed when token values change. (nicholasrice@users.noreply.github.com)
fix bug caused by asserting parentElement was not null (nicholasrice@users.noreply.github.com)

1.24.3

Wed, 26 May 2021 07:33:37 GMT

Patches

allow a float to be accurately represented when a step is a fraction (7559015+janechu@users.noreply.github.com)
fix css custom property emission for dependent DesignToken properties (nicholasrice@users.noreply.github.com)

1.24.2

Tue, 25 May 2021 07:27:43 GMT

Patches

fix data grid tabbing (scomea@microsoft.com)

1.24.1

Fri, 21 May 2021 17:48:08 GMT

Patches

update to Design System Provider to use dom.supportsAdoptedStyleSheets (nicholasrice@users.noreply.github.com)

1.24.0

Thu, 20 May 2021 07:24:10 GMT

Minor changes

add toolbar component (john.kreitlow@microsoft.com)

Patches

Bump @microsoft/fast-web-utilities to v4.8.0 (john.kreitlow@microsoft.com)

1.23.0

Wed, 19 May 2021 23:37:36 GMT

Minor changes

Adds subscribe and unsubscribe methods to DesignToken (nicholasrice@users.noreply.github.com)
Adds feature to DesignToken to prevent emission to CSS (nicholasrice@users.noreply.github.com)
Addresses significant performance issues with DesignToken implmentation. This change removes several alpha APIs on DesignToken. (nicholasrice@users.noreply.github.com)

Patches

fix: update scrolling with delay loaded content (robarb@microsoft.com)
menu should not reset tabIndex unnecessarily (scomea@microsoft.com)
selected option is not visible when dropdown is opened in fast-select (john.kreitlow@microsoft.com)
undefined (nicholasrice@users.noreply.github.com)
fix: fast-number-field does not fire input event when buttons pressed (robarb@microsoft.com)
Bump @microsoft/fast-element to v1.3.0 (nicholasrice@users.noreply.github.com)

1.20.0

Sun, 25 Apr 2021 07:21:02 GMT

Minor changes

undefined (nicholasrice@users.noreply.github.com)

1.19.0

Thu, 22 Apr 2021 07:21:10 GMT

Minor changes

adding withDefault method to DesignToken (nicholasrice@users.noreply.github.com)

Patches

add function to check for separator, add example and update style for not href item (khamu@microsoft.com)

1.18.0

Fri, 16 Apr 2021 01:19:08 GMT

Minor changes

open up getter and setter functions to HTMLElement (nicholasrice@users.noreply.github.com)

Patches

add missing aria-expanded to the select template (mathieu.lavoie@logmein.com)
remove incorrect role from horizontal-scroll element (chhol@microsoft.com)
ensure DesignToken works with falsey values (nicholasrice@users.noreply.github.com)
fix anchored region positioning bugs (scomea@microsoft.com)

1.16.1 (2021-03-18)

Bug Fixes

combobox with typescript ^4.0 (#4475) (e9d3b34)
ensure no exception is thrown when no properties are defined (#4469) (40dc56c)

1.16.0 (2021-03-16)

Bug Fixes

add createMenuItem(<prefix>) to menu item template (#4431) (c86b63b), closes #4414 #4412
anchored region pointer events mk2 (#4402) (e0de62e)
broken formatting and link when generating docs site (#4459) (e817863)
cannot use combobox with typescript ^4.0 (#4442) (3d52ef4)
combobox escape and arrow keys prevent listbox navigation (#4443) (aa594fe)
setting data grid focus should not throw (#4466) (3c56a18)

Features

add ability to hide step controls and update reveal on hover and focus-within (#4448) (6f6497c)
add expand/collapse icon to menu items (#4438) (db4e9fa)
add horizontal scroll web component (#4391) (08508a5), closes #4414 #4412 #4416 #4437

1.15.1 (2021-03-06)

Bug Fixes

conditionally render input container for menuitemcheckbox and menuitemradio (#4429) (8561a99)

1.15.0 (2021-03-06)

Bug Fixes

add default expanded and collapsed SVGs to accordion-item component (#4368) (b0bea82)
add radio and checkbox visual in fast-menu-item (#4205) (50efed4)
data-grid stores generated templates (#4412) (7de9602)
default selected option in listbox (#4372) (35870a6)
focusout on empty select throws an error (#4373) (b2f2f29)
tooltip doc sample (#4341) (20e1b66)
whitespaceFilter filtering elements (#4360) (2f14137)
tooltip: fix tooltip inside shadow root (#4303) (fc65f50)

Features

add placeholder attribute to combobox component (#4427) (b507c25)
di: enable dom containers to handle same element dep resolution (#4406) (e3145fe)
add combobox component (#4379) (aab8441)
add nested menu support (#4142) (551ff04)
di: enable use of the inject decorator on properties (#4401) (2f8355b)
add prefers-color-scheme behaviors for light and dark mode (#4382) (1e467d7)
enable FoundationElement.compose to accept template functions (#4390) (468f2fc)

1.14.0 (2021-02-08)

Bug Fixes

accordion arrow key press moves focus from content to accordion header (#4331) (d959c18)
add check for intersection observer support before instanciating (#4349) (d106995)

Features

adds DI system, Configuration, and FoundationElement (#4166) (cfbe786)

1.13.0 (2021-02-08)

Bug Fixes

accordion arrow key press moves focus from content to accordion header (#4331) (d959c18)
add check for intersection observer support before instanciating (#4349) (d106995)

Features

adds DI system, Configuration, and FoundationElement (#4166) (cfbe786)

1.12.0 (2021-01-30)

Bug Fixes

UnhandledPromiseRejectionWarnings when building fast-components (#4218) (48d52f4)
add class content to fix missing underline on button component (#4226) (bb9caaf), closes #4201 #16271
add whitespace filter to text-field template to correctly hide label div with start and end content (#4245) (70ce353)
display active indicator when tab is disabled (#4207) (ca0efbb)
expand collapse tree view svg (#4225) (c6d6259)
tooltips are incorrectly positioned when parent is a flex container (#4256) (bc47c02)

Features

add disclosure component (#3921) (dec77c9)
add fast-number-field component for data applications (#4204) (7196215)
add getPosition service for anchored region (#4210) (94d5ffa)
add radio group functionality to menu items (#4208) (89a3930)
add select spec (#4194) (7af127a)
Create a behavior for attaching component styles based on an appearance (#4238) (7b498ce)

1.11.1 (2020-12-17)

Bug Fixes

update applyMixin function to ensure metadata for attrs are copied and applied correctly (#4200) (dcbd6a5)

1.11.0 (2020-12-16)

Bug Fixes

anchored region default viewport (#4146) (a6806e9)
select should match native behavior for value changes and change event emitting (#4176) (07f5eaa)
dialog: accidental improperly bound this in callback (#4168) (9d54fe9)
fast-foundation: ensure global aria attrs are applied (#4172) (dd3a1c9)
disabled menu items should be focusable (#4154) (b971a18)
ensure DSP subscribes to upstream DSP properties (#4143) (b403909)
formassociated tests on firefox (#4158) (b3266fb)
remove shadowRoot in direction utility (#4157) (041ae70)

Features

add a data grid web component (#4029) (7239edc)
add beta anchored region component (#4183) (5d9f0ac)
add default slot changed to anchor (#4159) (8a264ec)
add loaded event to anchored region (#4165) (b54ac1b)

1.10.0 (2020-12-02)

Bug Fixes

fix type error in custom property manager running on safari (#4147) (6320973)

Features

add default slot change method (#4148) (5e9fb05)

1.9.0 (2020-11-19)

Bug Fixes

active indicator losing track if double click (#4085) (fcecc75)
active indicator no longer animating (#4126) (49e2608)
corrects ElementInternals feature detection (#4087) (58b3e54)
ensure form elements reset when the parent form's reset() method is invoked. (#4075) (f19894e)
ensure StyleElementCustomPropertyManager works with disconnected elements (#4112) (e903bfa)
ensure tree items with children have a value for aria-expanded (#4114) (e7a7553)
fast-slider sets value to NaN if developer tools open (#4033) (35d6903)
handle initially set value in FormAssociated (#4047) (bf7e874)
move component options to independent modules (#4048) (f8a88a8)
revert radio to using class selector instead of attr, update slider-label to use internal styles for orientation (#4108) (c6ecedf)

Features

Add disabled attr to fast-tab (#4013) (caef4b1), closes #4017
add fast-breadcrumb and fast-breadcrumb-item web components (#3627) (e2e142c)
add select component (#4074) (6984027)
add show and hide methods to dialog (#4030) (00b69ff)
convert FormAssociated to a constructable function (#4115) (da8d54b)
enable shared CSSStyleSheets in DesignSystemProvider (#4065) (5579c2e)

1.8.1 (2020-10-14)

Bug Fixes

allow child radio buttons to be changed multiple times from javascript (#3976) (8ea7cc8)
corrects keyboard behavior of tree view and tree view item. (#4003) (9d80632)
designSystem property resolution behavior correction (#4032) (7e82cae)
leverage FASTController.addStyles to attach css custom property target sheet (#4031) (2ca2ed0)
tabs directional arrow key bug (#3986) (2d797a5)

1.8.0 (2020-09-28)

Bug Fixes

active id should update selected tab (#3931) (ff956ba)
adds constraint validation to all form-associated elements (#3932) (60fbec0)
aria attributes for slider should have explicit values (#3915) (8335702)
click does not uncheck radio if it was already checked (#3888) (989c785)
ensure a dsp pulls all relevant properties from the parent provider (#3939) (c70c519)
ensure attributes are passed to text field template (#3923) (31afcd4)
ensure badge always applies inline-style when attributes exist (#3905) (7624cba)
fixed typos (#3934) (f82468c)
for tree-view removing space bar key handler and match aria spec (#3954) (4cb03e8), closes /w3c.github.io/aria-practices/#keyboard-interaction-23
remove placeholder functions for boolean attributes in dialog component (#3913) (ab21eb7)
tree view item should have a click handler on root element (#3951) (913c2bd)
tree-view right and left arrow keyboarding should behave as wai-aria spec suggests (#3890) (f866359)

Features

Anchored region reliability/perf improvements (#3876) (0e697f6)
add skeleton component (#3877) (aff7d30)
add tooltip component (#3549) (cb7aa98)

1.7.2 (2020-09-10)

Bug Fixes

able to keyboard tab back in the tree view (#3867) (d3e3cde), closes #3801
implicit form-associated submission (#3861) (8342912)
move right and move left functionality of radio-group in RTL (f2735aa)
tabs right and left keyboarding in rtl (#3836) (d9ac1b1)

1.7.1 (2020-08-27)

Bug Fixes

consistent with min-width, min-height is at least the thumb size add default height (#3746) (b3f9aee)
proxy element causes empty check on slots to fail (#3779) (78787c3)
docs: correct typos in readme and spec files (#3740) (9bdb11f)

1.7.0 (2020-08-13)

Bug Fixes

anchored region fails on firefox (#3701) (1fd02e0)
changed setupDefault to set initialValue which will set dirtyValue false after changing (#3642) (0b30fdf)
correct tabs animation when using home/end touch (#3718) (24ed0e5)
correct typos on aria attributes (#3690) (d1c9ba4)
fix radiogroup tabfocus (#3650) (59536fe)
hitting enter key when in the text-field did not submit form (#3687) (3bc4384)
turn off animation when dragging (#3664) (49e9d02)
wrapping set focus in dom.queueupdate (#3703) (7cb4616)

Features

anchored region revision (#3527) (63f3658)
export form-associated under alpha flag (#3618) (cbcb217)

Reverts

Revert "chore: update all http to https to resolve WS1262 security vulnerability (#3658)" (#3699) (0cac64a), closes #3658 #3699

1.6.0 (2020-07-31)

Bug Fixes

add form submission and reset behavior to Button (#3603) (f646343)
various fixes for form-associated custom elements (#3581) (ccba229)

Features

adding directional stylesheet behavior (#3559) (74c19af)
create an observable function to support aria-valuetext on slider component (#3508) (b4ac369), closes #3504

1.5.0 (2020-07-23)

Bug Fixes

address nested styling issues and provide a more intuitive API for nesting (#3528) (4fe0dd3)
move text field and text area appearances from foundation to components (#3540) (ca8ac76)
rollup minify selectors should retain spaces (#3524) (cbdfc45)
update nested to be observable and set isNestedItem method to readonly (#3539) (9e67f52)

Features

basic menu item check state toggling (#3512) (ea84cbd)

1.4.0 (2020-07-14)

Bug Fixes

correct spelling of aria-labelledby in tabs (#3463) (c0385d9)
correct web component menu keyboarding and aria-expanded (#3496) (0530a42)
move setAttribute calls for proxy elements to connectedCallback (#3494) (cdaf0ba)
reflect aria-hidden attribute in the DOM for the flipper component (#3468) (2f7b897)
removing un-needed nbsp; in slider-label and radio-group templates (#3506) (7cd003e)

Features

adds mixin to support global aria-* attributes for components delegating focus (#3470) (054c890)
export MatchMediaStylesheetBehavior constructor (#3445) (ffc59f8)
move appearance attributes of anchor and button out of fast-foundation (#3420) (069e1ee)
simplify rollup configs and compress tagged template literals (#3452) (7533e92)
update typescript version and remove utility types dependencies for react packages (#3422) (09d07b5)

1.3.0 (2020-07-02)

Bug Fixes

slider thumb does not respond to touch events, vertical sliders track parameters incorrect after scrolling page (#3414) (02f9ac4)

Features

add tree-vew and tree-item components (#3240) (57eaa83)
make tabs adjust method public (#3426) (0dd2a5e)

1.2.2 (2020-06-26)

Bug Fixes

selected tab becoming undefined when tab slot pass anything except icon or text node (#3350) (eda1aef)

1.2.1 (2020-06-17)

Note: Version bump only for package @microsoft/fast-foundation

1.2.0 (2020-06-15)

Bug Fixes

correct css part name for dialog component (#3260) (62eff11)
ensure all component internals have part names (#3306) (95360a7)

Features

add live code examples to docs site (#3216) (763054f)
design-system-provider now paints CSS color and background color (#3278) (8e97ac4)
provides access to the CSS variable created by CSSCustomProprtyBehaviors (#3256) (391f029)

1.1.1 (2020-06-09)

Bug Fixes

correct css part name for dialog component (6e0c7a0)

1.1.0 (2020-06-05)

Bug Fixes

children components not always added to the internal slotted radio control collection (#3169) (1d1ce86)
remove static class from start/end template (#3225) (ea6e790)
slider vertical navigation and value setting bugs (#3176) (f46d87d)

Features

add accordion web component (#3067) (f551378)
fast-foundation: add element test helper (#3184) (a27161d)
website: new docusaurus v2 setup with launch toc configuration (#3159) (f12ba16)

1.0.0 (2020-05-18)

Bug Fixes

replaces childNodes.length check with slotted (#3130) (b69d70c)
update decorator signature to align with customElement (#3131) (10256b5)

Features

web-components: new build/test/docs setup (#3156) (51d909a)
add fast-components-msft as a new package (#3096) (0515fff)
add fast-foundation as a new package (#3122) (322af95)
update badge API and styles (#3147) (23eca38)
wrap attr and observable into designSystemProperty decorator (#3132) (b6d4d59)

BREAKING CHANGES

fundamentally changes and breaks the badge component API and styles
breaks certain package exports