## **Release 2.7.0 - September 7, 2018**
### General
- Redesigned our [Design Tokens page](https://lightningdesignsystem.com/design-tokens/) to include GA vs Internal designations and "New" badges
- Added Release Notes to individual component pages
- Improved the accessibility of links on our site
- Added new design guidelines for [Builders](https://lightningdesignsystem.com/guidelines/builder/) and [Empty States](https://lightningdesignsystem.com/guidelines/empty-state/)
- Moved [Tree Grid](https://lightningdesignsystem.com/components/tree-grid/) to its own item, instead of being included in Trees
- Added [variable spacing tokens](https://lightningdesignsystem.com/design-tokens/#category-spacing) to support new Densification settings
### Components
#### [Accordion](https://lightningdesignsystem.com/components/accordion)
##### Removed
- Removed hard coded text sizing utility class, `slds-text-heading_small`, from the `slds-accordion__summary-heading` element
#### [Alert](https://lightningdesignsystem.com/components/alert)
##### Changed
- Changed HTML so the button icon can be slotted into the `slds-notify__close` element
##### Fixed
- Buttons with the new BEM syntax used within an inverse themed component no longer have their text color overridden
#### [App Launcher](https://lightningdesignsystem.com/components/app-launcher)
##### Changed
- Updated the tile markup for improved accessibility and added features
- Changed the outer element from an `` to a `
` and removed `aria-describedby`
- Replaced the grab handle icon with a stateful icon button, which will now be the keyboard accessilbe drag and drop control. Please [read the new section](https://www.lightningdesignsystem.com/components/app-launcher/#Reordering-tiles-via-drag-and-drop) in the documentation about specific implementation detials
- Moved the tile link to the card title since the whole tile is no longer a link
- Made the "more" overflow a tooltip trigger
#### [Avatar](https://lightningdesignsystem.com/components/avatar)
##### Changed
- Changed HTML so the Avatar component can be slotted inside of an `href` vs being the `href` element
#### [Badges](https://lightningdesignsystem.com/components/badges)
##### Fixed
- Nested `inline` and `inline-block` elements now receive the proper vertical alignment.
#### [Builder Header](https://lightningdesignsystem.com/components/builder-header)
##### Added
- Updated design guidelines and design notes.
#### [Button Groups](https://lightningdesignsystem.com/components/button-groups)
##### Added
- A `1px` separator now appears when a brand button and a brand button icon are used within a button group.
- Added [Button Group Row component](/components/button-groups/?variant=row) that provides spacing in between each item that contains a button
#### [Button Icons](https://lightningdesignsystem.com/components/button-icons)
##### Added
- Added a title and assistive text to most button icon examples
#### [Buttons](https://lightningdesignsystem.com/components/buttons)
##### Added
- `slds-button_text-destructive` modifier option, which is styled as an inverted `slds-button_descructive` button.
- Added selector for `:disabled` pseudo-class.
##### Deprecated
- Deprecated the class `slds-button__icon_stateful`, which was located on the svg inside of the button. Use the Button Icon component with a small size modifier instead, `slds-button__icon slds-button__icon_small`.
#### [Cards](https://lightningdesignsystem.com/components/cards)
##### Changed
- Replaced spacing tokens with variable spacing tokens to respond to a user's densification setting
#### [Carousel](https://lightningdesignsystem.com/components/carousel)
##### Fixed
- Swapped values for `aria-hidden` on Carousel panels.
- In previous versions, the `true` and `false` values for `aria-hidden` were inadvertently reversed—`aria-hidden: true` was placed on open panels, and vice versa. This has now been updated to use the proper values for open and closed panels.
- Fixed bug that caused Carousel panels to be improperly sized in IE11.
#### [Chat](https://lightningdesignsystem.com/components/chat)
##### Added
- File component (image and file content types) is now natively supported within an inbound and outbound message.
##### Fixed
- Outbound messages that contain a string of text shorter than the `max-width` no longer has unnecessary white space.
- Removed unnecessary whitespace when sending messages with a small amount of text (.e.g, "Hi there.").
#### [Checkbox](https://lightningdesignsystem.com/components/checkbox)
##### Added
- Added variant for a checkbox inside of a standard [form element component](/components/checkbox/?variant=form-element)
##### Fixed
- Fixed [issue #556](https://github.com/salesforce-ux/design-system/issues/556) by increasing the font size on checkbox labels to match radio button labels
#### [Checkbox Button](https://lightningdesignsystem.com/components/checkbox-button)
##### Added
- Added an example of a checked-and-disabled checkbox button.
##### Fixed
- Increased the contrast between the plus symbol and background color for the disabled checkbox button.
#### [Combobox](https://lightningdesignsystem.com/components/combobox)
##### Added
- Added `slds-listbox__option-icon` to be used as a container that maintains the dimensions of an icon when it is removed from the HTML
##### Fixed
- Increased z-index of entity icon when a selection is made to ensure icon is always on top of input field
- Fixed alignment of dropdown icon in object switcher
- Click events are no longer prevented on the grouped combobox in Firefox
#### [Data Tables](https://lightningdesignsystem.com/components/data-tables)
##### Added
- Added a hidden header variation of the data table
- This involves adding the `slds-table_header-hidden` class to the `
` and using the `slds-assistive-text` class on the `` to ensure the table remains accessible
- Multi select data tables now require `aria-multiselectable="true"` applied to the `table` element for both Advanced and Inline Edit variants.
- Multi select data tables now require `aria-selected` to be set to `false` on every row that is not selected
##### Changed
- Data tables underwent some minor markup changes to help align all the different variants to use common markup patterns. No visual styling or functionality has changed, but you will notice more examples.
##### Fixed
- Improved the color contrast of links inside of selected rows
#### [Drop Zone](https://lightningdesignsystem.com/components/drop-zone)
##### Added
- Added new Drop Zone component to help construct a drag and drop screen building experience
#### [Dueling Picklist](https://lightningdesignsystem.com/components/dueling-picklist)
##### Changed
- Wrapped `slds-dueling-list` element with `slds-form-element__control`.
- Removed `slds-text-title_caps` from label.
#### [Expandable Section](https://lightningdesignsystem.com/components/expandable-section)
##### Changed
- Replaced spacing tokens with variable spacing tokens to respond to a user's densification setting
#### [Expression](https://lightningdesignsystem.com/components/expression)
##### Added
- Added new Expression component to help users declaratively construct logical expressions
#### [Feeds](https://lightningdesignsystem.com/components/feeds)
##### Changed
- Replaced spacing tokens with variable spacing tokens to respond to a user's densification setting
#### [File Selector](https://lightningdesignsystem.com/components/file-selector)
##### Changed
- Replaced spacing tokens with variable spacing tokens to respond to a user's densification setting
- Reduced height to minimize whitespace
#### [Files](https://lightningdesignsystem.com/components/files)
##### Added
- New class `sld-file_loading` for loading state.
- In effort to prevent the hover styles from applying to the loading state, `slds-file_loading` is now added to `slds-file`.
- Class `slds-has-title` for when Files have a title applied.
- `slds-has-title` is now added to `slds-file` to ensure the Preview icon (displayed in hover state) is properly centered.
- This class should not be added when `slds-file_overlay` is used.
- `z-index` to titles and actions for non-loading states.
- This is an effort to keep the new hover overlay styles from not covering the title and actions to keep them clickable.
##### Changed
- New design treatment for hover state.
- `box-shadow` and `transition` have been replaced with an overlay and absolutely-centered Preview icon.
- This hover state does not appear on devices that do not support `hover` (e.g., mobile). Note that this does effect devices that supports both hover (e.g., touch) and no-hover (e.g., mouse) input devices, such as the Microsoft Surface.
- New option for loading state.
- Added a loading spinner option for Files with and without a title.
##### Fixed
- Improved the color contrast of the text placed on top of a file overlay
#### [Form Element](https://lightningdesignsystem.com/components/form-element)
##### Added
- Left aligned label support for components with help text icon and required asterisk
- Left aligned label support for `fieldset` and `legend` form elements
- Added `slds-form-element__readonly` to apply appropiate styling when a form element is in view mode
##### Changed
- Reduced overall height of all view mode form elements
- Changed HTML so a compound form's `slds-form-element__group` is wrapped inside of `slds-form-element__control`
- Changed HTML that moved the required asterisk inside of `legend` element
- Changed HTML that moved the help text icon to be adjacent to the `legend` element
- Changed HTML so `slds-form-element__legend` is now required on all `legend` elements
- Changed HTML so `slds-form-element__control` is now required to wrap all form controls
#### [Global Header](https://lightningdesignsystem.com/components/global-header)
##### Changed
- Changed Salesforce logo image path.
#### [Global Navigation](https://lightningdesignsystem.com/components/global-navigation)
##### Changed
- Overflow menu on navigation item no longer opens on hover.
- Added the `slds-indicator-container` class to be used whenever tabs and menu items have unread or unsaved indicators.
- The `slds-indicator_unsaved` abbreviation and/or the `slds-indicator_unsaved` span should always be contained *within* a `` with class `slds-indicator-container`.
- This class preserves spacing between the indicators and the tab/menu text when no icon is present by adding a margin-right.
- If the indicator container is empty, no margin-right is added.
##### Fixed
- HTML validation error on tabbed navigation indicators, swapped a `div` for a `span`
#### [Icons](https://lightningdesignsystem.com/components/icons)
##### Added
- Icons can now be filled with the success text color by adding `slds-icon-text-success`.
##### Fixed
- Fixed [issue #228](https://github.com/salesforce-ux/design-system/issues/228), which was causing x-small and xx-small circular icons to appear as ovals. Contribution made by [@geebru](https://github.com/geebru).
#### [Illustration](https://lightningdesignsystem.com/components/illustration)
##### Added
- Added example for large illustrations
#### [List Builder](https://lightningdesignsystem.com/components/list-builder)
##### Added
- Added examples for list builders with disabled items and items selected by default.
- Added an example of a list builder with a headless table
##### Changed
- List Builder now requires `aria-multiselectable="true"` applied to the `table` element.
- Each row now requires `aria-selected` to be set to `false` on every row that is not selected
#### [Map](https://lightningdesignsystem.com/components/map)
##### Added
- Added a standalone map example that lives outside of a modal
##### Fixed
- Replaced inline styles from `iframe` and placed them within the component styling
- Improved the color contrast of links inside of selected items in the locations list
#### [Page Headers](https://lightningdesignsystem.com/components/page-headers)
##### Added
- Added `slds-page-header_record-home` class to be used within a record home page. This class utilizes variable font tokens to respond to a user's densification setting.
- Made Related Lists Page Header visible, so you can see it. Yay! 🎉
- Added the following classes:
- For layout:
- `slds-page-header__row`, `slds-page-header__row_gutters`, `slds-page-header__col-title`, `slds-page-header__col-actions`, `slds-page-header__col-meta`, `slds-page-header__col-controls`, `slds-page-header__col-details`
- For the page name:
- `slds-page-header__name`, `slds-page-header__name-title`, `slds-page-header__name-switcher`, `slds-page-header__name-meta`, `slds-page-header__meta-text`
- For header controls
- `slds-page-header__controls`, `slds-page-header__control`,
- For record home
- `slds-page-header_record-home`
- For record home details
- `slds-page-header__detail-row`, `slds-page-header__detail-block`
- For vertical record home list
- `slds-page-header__detail-list`, `slds-page-header__detail-item`
##### Changed
- Replaced spacing tokens with variable spacing tokens to respond to a user's densification setting
- Changed dimension of `slds-page-header__icon` to be 36x36
- Pretty much all of it in a sizable refactor of the markup
- Made it easier to componentize the page headers and share code between the different variants
- Made page headers less reliant on utility classes
- Please see above for added class names
##### Deprecated
- Deprecated page header specific spacing tokens
- PAGE_HEADER_SPACING_MARGIN
- PAGE_HEADER_SPACING_PADDING
- PAGE_HEADER_SPACING_ROW
#### [Panels](https://lightningdesignsystem.com/components/panels)
##### Changed
- Updated panel headers to have left aligned text by default. To center the header title, use the class `slds-panel__header_align-center`.
- Updated `slds-panel_body` padding to be 0.75rem around instead of 1rem.
- Updated our documentation to reflect that panels always have a close button, but may also have a back button if panel was invoked by drilling in.
##### Fixed
- Forced panel buttons to keep their square shape by preventing `flex-shrink`.
#### [Path](https://lightningdesignsystem.com/components/path)
##### Added
- Added `slds-path_has-coaching` hook on the `slds-path` container element, to add support for spacing differences between coaching and non-coaching.
##### Changed
- Modified the appearance of the Path container.
- Revised the colors used on the active and curent Path steps, introducing support for borders.
- Replaced spacing tokens with variable spacing tokens to respond to a user's densification setting.
- Changed the direction of the coaching arrow to point to the right / down, instead of up / down. To take advantage of this change, remove the `slds-flip_vertical` class on the open state for `slds-path__trigger`, and instead use our new class `slds-path__trigger_open` to set the direction of the open state on the button arrow.
##### Fixed
- Fixed text centering issue with first and last Path steps
- Fixed rotation transition on Path coaching toggle button
#### [Popovers](https://lightningdesignsystem.com/components/popovers)
##### Added
- Added `slds-nubbin_*-corner` modifier classes to place nubbin elements at the corner of a Popover.
##### Fixed
- Fixed a bug where long strings of text would overflow the popover boundary. Popover body, header, and footer now include `word-wrap: break-word`.
- Increased the contrast for focused links and buttons in our inversed popovers, Walkthrough and Feature.
- Fixed a bug that allowed `slds-popover_small` to grow larger than its expected width.
- Buttons with the new BEM syntax used within an inverse themed component no longer have their text color overridden
#### [Progress Bar](https://lightningdesignsystem.com/components/progress-bar)
##### Added
- Updated the documentation for vertical progress bars. Now you can actually see it, yay!
#### [Progress Ring](https://lightningdesignsystem.com/components/progress-ring)
##### Added
- Added an example of a progress ring that fills rather than drains, meaning the colored portion of the ring increases clockwise.
#### [Publishers](https://lightningdesignsystem.com/components/publishers)
##### Fixed
- Made the publisher label visible to screen readers in the collapsed state of a publisher, by removing the use of `display: none`
#### [Radio Group](https://lightningdesignsystem.com/components/radio-group)
##### Added
- Added an example of a checked-and-disabled radio button.
#### [Rich Text Editor](https://lightningdesignsystem.com/components/rich-text-editor)
##### Fixed
- Fixed incorrect `border-radius` in text area.
- Fixed a bug where child input elements were unintentionally affected when the Rich Text Editor was in an error state.
##### Changed
- [New markup](https://www.lightningdesignsystem.com/components/rich-text-editor/?state=error&variant=base) that moves the error message outside of Rich Text Editor, and adds a `slds-form-element__control` element to enable left align labels.
#### [Scoped Tabs](https://lightningdesignsystem.com/components/scoped-tabs)
##### Added
- Added `slds-tabs_medium` and `slds-tabs_large` to modify the `font-size` and spacing of the tab items
- Added `slds-tabs_scoped__overflow-button` to tabs with overflow so the Button Menu component can be slotted inside the tab item
##### Changed
- Replaced spacing tokens with variable spacing tokens to respond to a user's densification setting
- Changed the color of a tab item when a tab is active
- Changed HTML on [Tabs with Overflow](/components/scoped-tabs/?example=overflowing-items&variant=base) example so a Button Menu component is the trigger for the overflow menu
#### [Setup Assistant](https://lightningdesignsystem.com/components/setup-assistant)
##### Changed
- Updated the setup assistant steps to use the new [filling progress ring](https://lightningdesignsystem.com/components/progress-ring/?example=progress-ring-partially-filled&variant=base).
#### [Slider](https://lightningdesignsystem.com/components/slider)
##### Fixed
- Fixed a bug that prevented Slider background from appearing in IE11.
#### [Split View](https://lightningdesignsystem.com/components/split-view)
##### Changed
- Replaced spacing tokens with variable spacing tokens to respond to a user's densification setting
#### [Tabs](https://lightningdesignsystem.com/components/tabs)
##### Added
- Added `slds-tabs_medium` and `slds-tabs_large` to modify the `font-size` and spacing of the tab items
- Added animation when activating a tab item
- Added `slds-tabs_default__overflow-button` to tabs with overflow so the Button Menu component can be slotted inside the tab item
- Extended the documentation for mobile tabs to include panels
- When drilling into a mobile tab, a panel slides in displaying that tab's content
- Check out the [Tabs On Mobile](https://lightningdesignsystem.com/components/tabs/#On-Mobile) section for more details
- Animations and transitions for `:hover` and `slds-is-active` states.
##### Changed
- Replaced spacing tokens with variable spacing tokens to respond to a user's densification setting
- Removed title caps from tab items
- Removed letter spacing from tab items
- Increased height of bar when a tab is active
- Changed HTML on [Tabs with Overflow](/components/scoped-tabs/?example=overflowing-items&variant=base) example so a Button Menu component is the trigger for the overflow menu
##### Fixed
- Updated `slds-tabs-mobile` to have a white background by default, instead of a transparent background.
- Improved the color contrast of the text of a sub tab when it is in focus
- HTML validation error on sub tab indicators, swapped a `div` for a `span`
#### [Textarea](https://lightningdesignsystem.com/components/textarea)
##### Fixed
- Removed `box-shadow` added by Firefox for all required fields.
- By default, Firefox was adding a `box-shadow` to all fields marked `required`. This has now been normalized to match the styling in all other browsers.
#### [Toast](https://lightningdesignsystem.com/components/toast)
##### Changed
- Swapped the `role` value of toasts from `alert` to `status`
##### Fixed
- Increased contrast between the icons and the yellow background in warning toasts.
- Buttons with the new BEM syntax used within an inverse themed component no longer have their text color overridden
#### [Tree Grid](https://lightningdesignsystem.com/components/tree-grid)
##### Added
- Checkboxes in the left most column were added to multi select tree grids
- Multi select tree grids now require `aria-multiselectable="true"` applied to the `table` element.
- Multi select tree grids now require `aria-selected` to be set to `false` on every row that is not selected
- Single select tree grids were added as examples
- Headless tree grids were added
- Borderless tree grids were added
##### Changed
- Tree grid now aligns better with the lightning component, which is an extension of [Advanced Data Table](https://www.lightningdesignsystem.com/components/data-tables/?modifiers=.slds-table_bordered&variant=advanced).
#### [Trees](https://lightningdesignsystem.com/components/trees)
##### Changed
- Removed `aria-selected` from the examples since this is only necessary if the tree supports multi-select
- Removed `role="application"` from the top level tree
##### Fixed
- Replaced the `slds-size_1-of-1` surrounding the tree label with `slds-has-flexi-truncate` to prevent the label from overflowing the tree's boundary
#### [Trial Bar](https://lightningdesignsystem.com/components/trial-bar)
##### Fixed
- Buttons with the new BEM syntax used within an inverse themed component no longer have their text color overridden
#### [Visual Picker](https://lightningdesignsystem.com/components/visual-picker)
##### Changed
- Updated disabled visual picker UI to be more apparent and better match established conventions for disabled UI
#### [Welcome Mat](https://lightningdesignsystem.com/components/welcome-mat)
##### Changed
- Updated the semantics of steps in a welcome mat to be list items within an unordered list. Check out the component documentation for the [updated DOM structure](https://lightningdesignsystem.com/components/welcome-mat/)
### Utilities
#### [Description List](https://lightningdesignsystem.com/components/description-list)
##### Changed
- Changed behavior of media query when `slds-dl_horizontal` and `slds-dl_inline` are located inside of `slds-region_narrow`
#### [Grid](https://lightningdesignsystem.com/components/grid)
##### Added
- Added `slds-gutters_direct` for adding gutters to direct child columns of a grid.
- See the [Direct Columns Only](https://lightningdesignsystem.com/utilities/grid/#Direct-Columns-Only) section for more info.
#### Fixed
- Updated `slds-col_bump-bottom` to accurately set margin-bottom, instead of margin-right, to auto.
#### [Text](https://lightningdesignsystem.com/components/text)
##### Added
- Added text color utility class, `slds-text-color_destructive`, for destructive actions
## **Release [2.6.2] - June 29, 2018**
## Fixes
**[Cards](https://www.lightningdesignsystem.com/components/cards)**
- Updated broken links within the Cards docs ([7b48637](https://github.com/salesforce-ux/design-system/commit/7b48637))
**Gulp Script Update**
- Fix path to gulp.js to resolve build error in Windows ([2a78a47](https://github.com/salesforce-ux/design-system/commit/2a78a47))
**[Input](https://www.lightningdesignsystem.com/components/input)**
- Updated the Error with Icon example to use the new Error icon ([35d90ba](https://github.com/salesforce-ux/design-system/commit/35d90ba))
**[Margin](https://www.lightningdesignsystem.com/utilities/margin)**
- Added examples of using "none" on margin utilities ([a3e9eb9](https://github.com/salesforce-ux/design-system/commit/a3e9eb9))
- Updated broken links within the Margin docs ([26a5eed](https://github.com/salesforce-ux/design-system/commit/26a5eed))
## **Release [2.6.1] - May 18, 2018**
## Fixes
**[Form Element](https://www.lightningdesignsystem.com/components/form-element/#Compound)**
- Removed margin if compound field is found inside of a stacked form ([0d3e752](https://github.com/salesforce-ux/design-system/commit/0d3e752))
**[Grid](https://www.lightningdesignsystem.com/utilities/grid/)**
- Adjusted docs to avoid confusion on columns and vertical alignment ([1b17639](https://github.com/salesforce-ux/design-system/commit/1b17639))
**[Tabs](https://www.lightningdesignsystem.com/components/tabs/)**
- Fixed incorrect link to Vertical Tabs component in Tabs documentation ([#548](https://github.com/salesforce-ux/design-system/issues/548))
## **Release [2.6.0] - May 4, 2018**
May the 4th be with you!
## Big Impact
**[Component Blueprints](https://lightningdesignsystem.com/components/overview)**
- Renamed our 'Components' to 'Component Blueprints' to create distinction between our SLDS Components and ([Lightning Components](https://developer.salesforce.com/docs/atlas.en-us.lightning.meta/lightning/aura_compref.htm)). We define our 'Component Blueprints' as 'Framework agnostic, accessible HTML and CSS used to create components in conjunction with our implementation guidelines'. For more details, check out the glossary we added to our [FAQ page](/faq).
**[Form Layout](https://lightningdesignsystem.com/components/form-element/#Layout)**
- Merged Form Layout into Form Element ([f3c5b48](https://github.com/salesforce-ux/design-system/commit/f3c5b48))
**[Icon](https://lightningdesignsystem.com/icons/#utility)**
- Addressed 2 issues with the usage of *Warning* and *Error* icons. ([cd98ab6](https://github.com/salesforce-ux/design-system/commit/cd98ab6))
1) Research showed that the ban icon best represented an error for our users, so we switched the error and ban icons. The new error icon is the circle with a diagonal slash through it
2) We also realized that we used the same icon for both error and warning states in many components, so we updated components that were using the warning icon in red as an error state to use the new error icon.
**[Lookup](https://lightningdesignsystem.com/components/lookups/)**
- Deprecated `slds-lookup` and replaced with `slds-combobox` and `slds-combobox-group` ([2dbe619](https://github.com/salesforce-ux/design-system/commit/2dbe619))
**[Walkthrough -> Trial Bar](https://lightningdesignsystem.com/components/trial-bar/)**
- Renamed our Walkthrough component to Trial Bar ([fe8cfc1](https://github.com/salesforce-ux/design-system/commit/fe8cfc1))
## New components:
**[Builder Header](https://lightningdesignsystem.com/components/builder-header/)**
- Created new Builder Header component ([3b6f741](https://github.com/salesforce-ux/design-system/commit/3b6f741))
**[Illustration](https://lightningdesignsystem.com/components/illustration/)**
- Created new component for Empty States and other Illustrations ([a1824e0](https://github.com/salesforce-ux/design-system/commit/a1824e0))
**[Setup Assistant](https://lightningdesignsystem.com/components/setup-assistant/)**
- Created new Setup Assistant component ([26be78c](https://github.com/salesforce-ux/design-system/commit/26be78c))
**[Summary Detail](https://lightningdesignsystem.com/components/summary-detail/)**
- Created new Summary Detail component ([245492e](https://github.com/salesforce-ux/design-system/commit/245492e))
**[Welcome Mat](https://lightningdesignsystem.com/components/welcome-mat/)**
- Created new Welcome Mat component ([5d2d818](https://github.com/salesforce-ux/design-system/commit/5d2d818))
## Documentation Updates
**[Button](https://lightningdesignsystem.com/components/buttons/#Disabled)**
- Updated examples to show disabled states of all variants ([013b16d](https://github.com/salesforce-ux/design-system/commit/013b16d))
**[Combobox](https://lightningdesignsystem.com/components/combobox/)**
- Updated examples and documentation for Base, Autocomplete, Entity Autocomplete, and Grouped comboboxes ([6c79edd](https://github.com/salesforce-ux/design-system/commit/6c79edd))
- Added an example to show [listbox styling options](https://lightningdesignsystem.com/components/combobox/#Styling-choices-for-options) ([3d4af71](https://github.com/salesforce-ux/design-system/commit/3d4af71))
- Updated mouse and keyboard interaction documentation ([04bde0c](https://github.com/salesforce-ux/design-system/commit/04bde0c))
**[Dueling Picklist](https://lightningdesignsystem.com/components/dueling-picklist/#Group-Label)**
- Added an example detailing how to add a group label to a dueling picklist ([b5e0083](https://github.com/salesforce-ux/design-system/commit/b5e0083))
**[Form Element](https://lightningdesignsystem.com/components/form-element/#Record-Detail)**
- Added an example to show Record Detail ([73989b0](https://github.com/salesforce-ux/design-system/commit/73989b0))
**[Global Header](https://lightningdesignsystem.com/components/global-header/#Notifications)**
- Updated documentation to show animated examples ([399da9c](https://github.com/salesforce-ux/design-system/commit/399da9c))
**[Grid](https://lightningdesignsystem.com/utilities/grid/#Content-alignment-with-bump)**
- Added examples and documentation for `slds-col-bump_*` classes ([a095cba](https://github.com/salesforce-ux/design-system/commit/a095cba))
**[Icon](https://lightningdesignsystem.com/components/icons/#Current-Color)**
- Added an example that uses `slds-current-color` ([2ef3489](https://github.com/salesforce-ux/design-system/commit/2ef3489))
**[Rich Text Editor](https://lightningdesignsystem.com/components/rich-text-editor/)**
- Updated examples to properly wrap the Rich Text Editor in `slds-form-element` ([b6df0b0](https://github.com/salesforce-ux/design-system/commit/b6df0b0))
## Features
**[Button](https://lightningdesignsystem.com/components/buttons/#Outline-Brand)**
- Added `slds-button_outline-brand` modifier ([0dec41e](https://github.com/salesforce-ux/design-system/commit/0dec41e))
**[Chat](https://lightningdesignsystem.com/components/chat/#Delivery-Status-Messages)**
- Added support for delivery failure and unsupported type messages ([14aa268](https://github.com/salesforce-ux/design-system/commit/14aa268))
**[Combobox](https://lightningdesignsystem.com/components/combobox/#Grouped-Comboboxes-(Cross-entity-Polymorphic))**
- Introduced grouped comboboxes with text and icon variants ([6c79edd](https://github.com/salesforce-ux/design-system/commit/6c79edd))
**[Dueling Picklist](https://lightningdesignsystem.com/components/dueling-picklist/#Edit-Mode)**
- Updated docs to add non-reorderable and view mode variants of dueling picklist to be used for multiple selection ([c336057](https://github.com/salesforce-ux/design-system/commit/c336057))
- Added `slds-is-grabbed` class
- Added `slds-dueling-picklist__column_responsive` to add [responsiveness](https://lightningdesignsystem.com/components/dueling-picklist/#Responsive) ([4000150](https://github.com/salesforce-ux/design-system/commit/4000150))
**[Global Header](https://lightningdesignsystem.com/components/global-header/)**
- Added support for branded skip links ([789aa99](https://github.com/salesforce-ux/design-system/commit/789aa99))
**[Input](https://lightningdesignsystem.com/components/input/?example=counter&variant=base)**
- Added counter variant ([0b20b85](https://github.com/salesforce-ux/design-system/commit/0b20b85))
**[Panel](https://lightningdesignsystem.com/components/panels/)**
- Added docked panel variant ([e88713e](https://github.com/salesforce-ux/design-system/commit/e88713e))
**[Popover](https://lightningdesignsystem.com/components/popovers/)**
- Added warning and error variants ([60a628d](https://github.com/salesforce-ux/design-system/commit/60a628d))
**[Progress Bar](https://lightningdesignsystem.com/components/progress-bar/?example=progress-bar-descriptive&variant=base)**
- Added an example of descriptive progress bar with label and progress percentage above bar ([dbd0db1](https://github.com/salesforce-ux/design-system/commit/dbd0db1))
**[Progress Indicator](https://lightningdesignsystem.com/components/progress-indicator/)**
- Added new vertical variant ([118b520](https://github.com/salesforce-ux/design-system/commit/118b520))
- Added `slds-progress__marker_icon-success` to indicate completed stage
**[Progress Ring](https://lightningdesignsystem.com/components/progress-ring/)**
- Added `slds-progress-ring_large` modifier to make a 32x32px ring ([26be78c](https://github.com/salesforce-ux/design-system/commit/26be78c))
- Added `slds-progress-ring_active-step` modifier to change color of progress ring
**[Spinner](https://lightningdesignsystem.com/components/spinners/?example=inlined&variant=base)**
- Added new inline spinner variant ([c05738f](https://github.com/salesforce-ux/design-system/commit/c05738f))
**[Tabs](https://lightningdesignsystem.com/components/tabs/#On-Mobile)**
- Added new mobile stacked variant ([9d7b861](https://github.com/salesforce-ux/design-system/commit/9d7b861))
**[Text](https://lightningdesignsystem.com/utilities/text/?example=text-font-monospace&variant=text)**
- Added new monospace font-family ([7a41fd6](https://github.com/salesforce-ux/design-system/commit/7a41fd6))
## Fixes
**[Avatar](https://lightningdesignsystem.com/components/avatar/?example=fallback-user-initials&variant=base)**
- Added text shadow to `slds-avatar__initials` for better contrast ([3f43dfa](https://github.com/salesforce-ux/design-system/commit/3f43dfa))
- Added `slds-avatar__initials_inverse` for dark text initials on a light background
**[Button Group](https://lightningdesignsystem.com/components/button-groups/?example=button-group-more-open&variant=base)**
- Added `slds-dropdown_actions` to button group overflow dropdown ([8ab08fe](https://github.com/salesforce-ux/design-system/commit/8ab08fe))
**[Button Icon](https://lightningdesignsystem.com/components/button-icons/?variant=bordered-inverse)**
- Added selected stying to border inverse variant ([2624d4f](https://github.com/salesforce-ux/design-system/commit/2624d4f))
**[Card](https://lightningdesignsystem.com/components/cards/?example=related-list-table&variant=base)**
- Added `slds-card__footer-action` to have footer link take up full width of card ([89c6a28](https://github.com/salesforce-ux/design-system/commit/89c6a28))
**[Chat](https://lightningdesignsystem.com/components/chat/#Sneak-peek)**
- Changed `slds-chat-message__text-sneak-peak` to `slds-chat-message__text-sneak-peek` ([cdaabbf](https://github.com/salesforce-ux/design-system/commit/cdaabbf))
**[Checkbox](https://lightningdesignsystem.com/components/checkbox/)**
- Updated examples to have unique `value` attributes ([cdf72cd](https://github.com/salesforce-ux/design-system/commit/cdf72cd))
**[Compound Form](https://lightningdesignsystem.com/components/form-element/#Compound)**
- Fixed layout overflow bug ([#530](https://github.com/salesforce-ux/design-system/issues/530))
**[Data Table](https://lightningdesignsystem.com/components/data-tables/?state=row-error-and-selected&variant=inline-edit)**
- Adjusted styling for edited and error cells when row is selected ([9ed087a](https://github.com/salesforce-ux/design-system/commit/9ed087a))
- Updated checkboxes and radio groups in Data Tables to be grouped with a common label by using `aria-labelledby` and hidden group label in the column header ([f8f8801](https://github.com/salesforce-ux/design-system/commit/f8f8801))
**[Datepicker](https://lightningdesignsystem.com/components/datepickers/?state=datepicker-with-error&variant=base)**
- Prevented error border from applying to nested select component ([0fa0165](https://github.com/salesforce-ux/design-system/commit/0fa0165))
**[Dueling Picklist](https://lightningdesignsystem.com/components/dueling-picklist/)**
- Updated all examples to include a group label and form-element wrapper ([8d1a1b4](https://github.com/salesforce-ux/design-system/commit/8d1a1b4))
**[Form Element](https://lightningdesignsystem.com/components/form-element/#Compound)**
- Added `slds-form-element__legend_has-tooltip` modifier to allow for tooltip icon next to legend ([f3c5b48](https://github.com/salesforce-ux/design-system/commit/f3c5b48))
**[Global Header](https://lightningdesignsystem.com/components/global-header/)**
- Updated colors of global [actions](https://lightningdesignsystem.com/components/global-header/#Global-Actions-Bar) ([58d68e1](https://github.com/salesforce-ux/design-system/commit/58d68e1))
- Updated search to use [new combobox group](https://lightningdesignsystem.com/components/global-header/#Global-Search) ([9bddfde](https://github.com/salesforce-ux/design-system/commit/9bddfde))
**[Input](https://lightningdesignsystem.com/components/input/)**
- Removed red box shadow from required inputs in firefox ([069a3c8](https://github.com/salesforce-ux/design-system/commit/069a3c8))
- Used `aria-labelledby` instead of `aria-describedby` for associating the prepended and appended fixed text to the input ([25d51d7](https://github.com/salesforce-ux/design-system/commit/25d51d7))
- Reordered `slds-input:required` styles to prevent overrides ([ba3ac5b](https://github.com/salesforce-ux/design-system/commit/ba3ac5b))
- Removed pointer event when icon is located on top of an input ([84b650b](https://github.com/salesforce-ux/design-system/commit/84b650b))
- Added `slds-input-has-icon_group-right` to fix spacing issues for [multiple icons on the right](https://lightningdesignsystem.com/components/input/?example=double-icon-spinner&variant=base) ([9bddfde](https://github.com/salesforce-ux/design-system/commit/9bddfde))
**[Modal](https://lightningdesignsystem.com/components/modals/?modifiers=.slds-fade-in-open&modifiers=.slds-modal_medium&variant=base)**
- Changed width of medium modal to 70% ([b2d9e1b](https://github.com/salesforce-ux/design-system/commit/b2d9e1b))
**[Path](https://lightningdesignsystem.com/components/path/)**
- Added focus styling for completed stages ([f197b4a](https://github.com/salesforce-ux/design-system/commit/f197b4a))
- Reordered `slds-is-active` and `slds-is-complete` to prevent overrides
- Added min-width to action button ([1b8e6b8](https://github.com/salesforce-ux/design-system/commit/1b8e6b8))
**[Radio Group](https://lightningdesignsystem.com/components/radio-group/) and [Radio Button Group](https://lightningdesignsystem.com/components/radio-button-group/)**
- Updated examples to have unique `value` attributes ([cdf72cd](https://github.com/salesforce-ux/design-system/commit/cdf72cd))
**[Rich Text Editor](https://lightningdesignsystem.com/components/rich-text-editor/?state=error&variant=base)**
- Added white background to error message with `slds-form-element__help` modifier ([8033c22](https://github.com/salesforce-ux/design-system/commit/8033c22))
- Removed margin-bottom from `slds-rich-text-editor__spacing-wrapper` and added it to `slds-rich-text-editor__select` ([bf907ed](https://github.com/salesforce-ux/design-system/commit/bf907ed))
**[Trees](https://lightningdesignsystem.com/components/trees/?state=metatext&variant=base)**
- Added missing assistive text span for tree branch with metatext ([a407e58](https://github.com/salesforce-ux/design-system/commit/a407e58))
**Utilities**
- Added `!important` to [visibility utilities](https://lightningdesignsystem.com/utilities/visibility/?example=hidden-visible&variant=visibility) `slds-hide` and `slds-hidden` ([16bf902](https://github.com/salesforce-ux/design-system/commit/16bf902))
- Fixed error in Grid documentation around [width and ordering class prefixes](https://latest-214.lightningdesignsystem.com/utilities/grid/#Responsive-Layout-Options) ([f6a66d9](https://github.com/salesforce-ux/design-system/commit/f6a66d9))
**[Vertical Tabs](https://lightningdesignsystem.com/components/vertical-tabs/)**
- Removed outline when link has focus ([72fcd6f](https://github.com/salesforce-ux/design-system/commit/72fcd6f))
**[Visual Picker](https://lightningdesignsystem.com/components/visual-picker/)**
- Added focus styling ([cbd07e9](https://github.com/salesforce-ux/design-system/commit/cbd07e9))
## Tokens
**[Text](https://lightningdesignsystem.com/design-tokens/#category-text-color)**
- Changed value of `$color-text-success`([97d13bb](https://github.com/salesforce-ux/design-system/commit/97d13bb))
- Changed value of `$color-text-link`([9bc8b0d](https://github.com/salesforce-ux/design-system/commit/9bc8b0d))
## **Release [2.5.4] - April 19, 2018**
## Fix
- Reordered Quill styles to apply indentation styles to the Rich Text Editor output class ([0bbf51c](https://github.com/salesforce-ux/design-system/commit/0bbf51c))
## **Release [2.5.3] - March 13, 2018**
## Fix
- Remove Quill styles from the Rich Text Editor output class to fix properly nested lists ([296afb3](https://github.com/salesforce-ux/design-system/commit/296afb3))
## **Release [2.5.2] - February 8, 2018**
## Fix
- Add warm/cool header contrast tokens ([d6515ee](https://github.com/salesforce-ux/design-system/commit/d6515ee))
- Set background image on Brand Band to not repeat ([d843c97](https://github.com/salesforce-ux/design-system/commit/d843c97))
- Update bundle script to fix windows npm error ([#523](https://github.com/salesforce-ux/design-system/issues/523))
## **Release [2.5.1] - January 19, 2018**
## Fix
- Backport tokens for Path ([1932e76](https://github.com/salesforce-ux/design-system/commit/1932e76))
## **Release [2.5.0] - January 9, 2018**
## Features
**General Notes**
- Updated Color guidelines to include Gray palette and Brand Colors
- Introduced a new documentation style for Badges, Brand Band, Carousel, Chat, Menus, and the Grid utility.
### The following components have been updated:
**Activity Timeline**
- Updated behavior and styling of activity timeline by adding expandable sections ([10cf834](https://github.com/salesforce-ux/design-system/commit/10cf834))
**Brand Band**
- Added Brand Band component
**Breadcrumbs**
- Added overflow menu button option for breadcrumbs ([a69621c](https://github.com/salesforce-ux/design-system/commit/a69621c))
**Button Icons**
- Added new branding variant
**Cards**
- Added variant with Einstein branded header
**Carousel**
- Added Carousel component
**Chat**
- Added Chat component
**Checkbox**
- Added a stacked variant
**Data Tables**
- Added icons to data table headers and cells ([59c44b2](https://github.com/salesforce-ux/design-system/commit/59c44b2))
- Added header menu buttons to table headers ([33bd050](https://github.com/salesforce-ux/design-system/commit/33bd050))
- Added Product Listing example to advanced data tables
- Added Radio Group example to advanced data tables
**Global Header**
- Updated styling to allow for rectangular logos ([ea43705](https://github.com/salesforce-ux/design-system/commit/ea43705))
**Grids**
- Added top level gutter classes: `slds-gutters` and `slds-gutters_*` for sizes ([b6d7fd5](https://github.com/salesforce-ux/design-system/commit/b6d7fd5))
**Icons**
- Added utility class `slds-current-color` to set an icon to use current color ([c9974d1](https://github.com/salesforce-ux/design-system/commit/c9974d1))
**Map**
- Added Map component
**Menus**
- Added a variant for Menus with Submenus
**Notifications**
- Updated multiple styling attributes for reminder notifications, including background color, border color, and spacing ([9cbb18a](https://github.com/salesforce-ux/design-system/commit/9cbb18a))
**Popovers**
- Added variant with Einstein branded header
- Added variant for Feature callout
**Rich Text Editor**
- Moved Quill styles to rich text editor ([402845b](https://github.com/salesforce-ux/design-system/commit/402845b))
**Spinners**
- Added class `slds-spinner_delayed` to apply a 300ms delay to the animation ([fbaa8d4](https://github.com/salesforce-ux/design-system/commit/fbaa8d4))
**Trees**
- Added new ability to include metatext on tree items ([754c9fe](https://github.com/salesforce-ux/design-system/commit/754c9fe))
**Utilities**
- Added utility class `slds-size-xxx-small` for sizing ([69d0eb2](https://github.com/salesforce-ux/design-system/commit/69d0eb2))
- Added utility class `slds-text-color-success` for text ([e744eb2](https://github.com/salesforce-ux/design-system/commit/e744eb2))
**Vertical Navigation**
- Added a variant of vertical nav that uses radio groups as underlying markup
## Fixes
The following fixes are now available:
**Accordion**
- Adjusted styling to only target first accordion child ([9f8f601](https://github.com/salesforce-ux/design-system/commit/9f8f601))
- Changed accordion focus styling from overall highlight to underline of header text ([0658e13](https://github.com/salesforce-ux/design-system/commit/0658e13))
- Updated to hide content overflow when closed ([7fb7cb0](https://github.com/salesforce-ux/design-system/commit/7fb7cb0))
**App Launcher**
- Added grab styling to match current use in product
- Changed to Dev Ready from prototype
**Button Groups**
- Updated z-index for button group focus ([259a6db](https://github.com/salesforce-ux/design-system/commit/259a6db))
**Buttons**
- Stopped events from happening on disabled buttons ([e661ee8](https://github.com/salesforce-ux/design-system/commit/e661ee8))
**Color Picker**
- Added spacing utility class to dropdown button icon between color and arrow ([69839b2](https://github.com/salesforce-ux/design-system/commit/69839b2))
**Combobox**
- Added class `slds-combobox__input-value` that must be applied, in order to propagate styling, when a selection is made in a single selection inline listbox ([1d4e30f](https://github.com/salesforce-ux/design-system/commit/1d4e30f))
- Added spacing utility class to dropdown button icon between icon and arrow ([69839b2](https://github.com/salesforce-ux/design-system/commit/69839b2))
**Data Tables**
- Added `slds-table_column-*-wrap` to add column wrap support ([b841961](https://github.com/salesforce-ux/design-system/commit/b841961))
**Date Picker**
- Fixed background color used when today's date is selected ([75f0f6a](https://github.com/salesforce-ux/design-system/commit/75f0f6a))
**Dueling Picklist**
- Fixed accessibility of disabled list boxes ([4ea5889](https://github.com/salesforce-ux/design-system/commit/4ea5889))
- Renamed Required to Locked, switched to lock icon instead of red asterisk ([3556b26](https://github.com/salesforce-ux/design-system/commit/3556b26))
- Updated background and border colors of disabled picklist ([4ea5889](https://github.com/salesforce-ux/design-system/commit/4ea5889))
**Expandable Section**
- Updated to hide content overflow when closed ([7fb7cb0](https://github.com/salesforce-ux/design-system/commit/7fb7cb0))
**Global Navigation**
- Changed global nav styling when subtabs are present with `slds-has-sub-tabs` ([d99332b](https://github.com/salesforce-ux/design-system/commit/d99332b))
- Prevented icons from shrinking when long text is present ([881da86](https://github.com/salesforce-ux/design-system/commit/881da86))
**Input**
- Updated size of search icon to be 14x14px from 16x16px ([add0ba0](https://github.com/salesforce-ux/design-system/commit/add0ba0))
- Fixed vertical alignment issues when using `slds-input__icon` ([cb3fe60](https://github.com/salesforce-ux/design-system/commit/cb3fe60))
**Lookups**
- Fixed icon alignment ([9b3de3c](https://github.com/salesforce-ux/design-system/commit/9b3de3c))
**Menus**
- Fixed disabled menu items to turn disabled icons gray
- Updated `slds-dropdown_xx-small` to use correct token ([0569d6d](https://github.com/salesforce-ux/design-system/commit/0569d6d))
**Modal**
- Fixed modal background color ([2f0ad5a](https://github.com/salesforce-ux/design-system/commit/2f0ad5a))
- Removed hyphenation from modal body ([9f70ae7](https://github.com/salesforce-ux/design-system/commit/9f70ae7))
**Pills**
- Update icons and improve consistency among pill usage
**Popovers**
- Updated background color of Walkthrough popovers ([08b2aac](https://github.com/salesforce-ux/design-system/commit/08b2aac))
- Added clouds to the header ([08b2aac](https://github.com/salesforce-ux/design-system/commit/08b2aac))
- Removed hyphenation from body text ([9f70ae7](https://github.com/salesforce-ux/design-system/commit/9f70ae7))
**Rich Text Editor**
- Fixed issue where selection dropdowns overlapped content on smaller screens ([f1a7e8d](https://github.com/salesforce-ux/design-system/commit/f1a7e8d))
- Updated to prevent hyperlinks from breaking mid word ([4827702](https://github.com/salesforce-ux/design-system/commit/4827702))
**Tabs**
- Adjusted position of unsaved indicator on a tab when used with notifications ([5916f2f](https://github.com/salesforce-ux/design-system/commit/5916f2f))
**Trees**
- Added missing ARIA role `role=gridcell` to tree grid TD elements ([f94d3dd](https://github.com/salesforce-ux/design-system/commit/f94d3dd))
- Removed extra indentation spacing for base variant ([e64cfc1](https://github.com/salesforce-ux/design-system/commit/e64cfc1))
**Utilities**
- Added missing BEM syntax to `slds-text-link_faux` ([#505](https://github.com/salesforce-ux/design-system/issues/505))
**Vertical Navigation**
- Changed active and hover background colors ([ae7997c](https://github.com/salesforce-ux/design-system/commit/ae7997c))
## Tokens
**Sizing**
- Added `$size-xxx-small` sizing token for UI components ([69d0eb2](https://github.com/salesforce-ux/design-system/commit/69d0eb2))
## **Release [2.4.6] - November 22, 2017**
## Fixes
**Colors**
- Modified tokens using gray-2 to use gray-3
## **Release [2.4.5] - November 14, 2017**
## Fixes
**Buttons**
- Remove pointer-events from icons found within buttons
## **Release [2.4.4] - October 17, 2017**
## Fixes
**Cards**
- Fixed padding-left and padding-right on nested `slds-card__header` and `slds-card__footer` with `slds-card_boundary`
**Sizing**
- Fixed known IE11 bug when you have nested flex containers with flex-basis on children
## **Release [2.4.3] - September 19, 2017**
## Fixes
**Buttons**
- Removed dark border on focus, fixing bug when buttons are found inside of a button group
**Checkbox/Radio Button Group**
- Fixed issue when a selection is made then that selection is put into a disabled state
**Modal**
- Update background color token to transparent value
**Path**
- Use transform to properly align checkmark inside of path element
## **Release [2.4.1] - September 14, 2017**
## Big Impact
We've made several enhancements in the Winter ’18 release which might affect your components and pages.
**As a designer what do I need to know about the design changes in the Winter ‘18 release?**
- We’ve enhanced font hierarchy to draw attention to what's most important in the moment and improve legibility.
- We’ve condensed the spacing of content (from 16px to 12px) to allow more information on the page. You’ll especially notice this in the tightening of data tables.
- We've added layering and a colorful graphics to the layout to create contrast between foreground and background cards. The cards have white backgrounds and drop shadows, while the page background introduces color.
- The components we’ve updated are cards, avatar, data tables, and page headers.
- For more detailed information, please visit this Salesforce UX blog post: [Evolving the Lightning User Experience](https://medium.com/salesforce-ux/evolving-the-lightning-user-experience-5f1de21f7af)
**As a developer what do I need to know about the design changes in the Winter ‘18 release?**
- With the changes to the page background color, you may notice some of your custom components are transparent, rendering the text on the dark background. You can fix that easily by adding the class `.slds-card` to the outer wrapper of your component.
- If you need default tabs to appear to be in a card, you can place the `.slds-tabs_card` class on the `.slds-tabs_default` DOM node. This will give the tabset padding and drop-shadows like a card.
- When the `.slds-card` class is used inside `.slds-tabs_default`, `.slds-modal`, or another `.slds-card`, they no longer have the drop-shadow card look. Instead they are simply white. In some situations, you may need to differentiate your card from content around it. You can add the `.slds-card_boundary` class to the `.slds-card` for a rounded border.
- On some pages, you’ll notice the header is attached to a list view. If you have a custom page where you’d like to attach the header to a component below, add the `.slds-has-bottom-magnet` class to the `slds-page-header`. Then add `.slds-has-top-magnet` to the component below. This will visually attach the components to each other.
- If you have been using SLDS in Visualforce via the `` tag, your Visualforce pages will also inherit the new styling in Winter ’18
- For more detailed information, please visit this developer blog post: [Get your Lightning components ready for Winter ’18](https://developer.salesforce.com/blogs/developer-relations/2017/08/winter-coming-lightning.html)
## Fixes
**Cards**
- Added `slds-card_boundary` class to provide card-like look when component is inside a tabset
**Magnet**
- Force magnet layout by making their properties immutable when using `slds-has-top-magnet` and `slds-has-bottom-magnet`
## **Release [2.4.0] - September 12, 2017**
## Features
The following are now available:
**Badges**
- Added dark blue badge
- Added white badge with icon and normalized text
**Dynamic Menu**
- Removed dynamic lists from combobox component and created new dynamic menu component
**Progress Bar**
- Added green variant
**Progress Ring**
- Added new Progress Ring component
**Scoped Notification**
- Added scoped inline notifications component
**Slider**
- Added two `spans` inside `label` to give the ability to visually hide one or both
## Fixes
The following issues have now been resolved:
**Alerts**
- Fixed grammatical errors in alerts documentation ([aa8099a](https://github.com/salesforce-ux/design-system/commit/aa8099a))
**Button Group**
- Button menu uses filled button icon modifier by default ([f9c2168](https://github.com/salesforce-ux/design-system/commit/f9c2168))
**Buttons**
- Added `pointer-events:none` to svg in button ([cc9cd5f](https://github.com/salesforce-ux/design-system/commit/cc9cd5f))
**Cards**
- Removed card look when inside of a modal ([f58c355](https://github.com/salesforce-ux/design-system/commit/f58c355))
- Removed card look when inside of a tabset
**Color Picker**
- Added more descriptive assistive text and fixed `tabindex` on swatches ([fc989c1](https://github.com/salesforce-ux/design-system/commit/fc989c1))
- Added `input` error state ui and examples ([b982bf7](https://github.com/salesforce-ux/design-system/commit/b982bf7))
- Added focus state to color picker slider thumb ([c29d368](https://github.com/salesforce-ux/design-system/commit/c29d368))
**Combobox**
- Added `role=none` to `div` that wraps `input` ([e695ae7](https://github.com/salesforce-ux/design-system/commit/e695ae7))
- Removed title and assistive text from search icon
**Date Picker**
- Added styles when adjacent month is selected within a week range ([bab8e26](https://github.com/salesforce-ux/design-system/commit/bab8e26))
**Dueling Picklist**
- Added documentation on focus management
- Fixed syntax and grammatical errors in dueling picklist accessibility docs
- Removed double focus on ul ([c231132](https://github.com/salesforce-ux/design-system/commit/c231132))
**File-selectors**
- Fixed file selector input labelling
**Global Navigation**
- Added animation on active and when hovering on a global navigation list item ([074771a](https://github.com/salesforce-ux/design-system/commit/074771a))
**Grids**
- Fix IE sizing issue by adding max-width ([00a0e35](https://github.com/salesforce-ux/design-system/commit/00a0e35))
**Modals**
- Removed extra `.slds-modal__header` class from headless modal example
**Normalize**
- Removed `[hidden] { display: none; }` to fix Visual Force charts disappearance when SLDS is added
**Notifications**
- Updated assistive text for dismiss notification button and added event type to header and live region ([d96535d](https://github.com/salesforce-ux/design-system/commit/d96535d))
- Updated styling to add bordercolor and darker drop shadow ([f977ee6](https://github.com/salesforce-ux/design-system/commit/f977ee6))
**Path**
- Simplified and fix active tab focus styling across all stage states ([3f9fbd4](https://github.com/salesforce-ux/design-system/commit/3f9fbd4))
**Responsive Tables**
- Examples for using responsive tables can now be found on the site again ([d427148](https://github.com/salesforce-ux/design-system/commit/d427148))
## Tokens
**Colors**
- Reduced and updated gray palettes to 12 total ([ff582b0](https://github.com/salesforce-ux/design-system/commit/ff582b0))
## Design Changes
**Cards**
- Background color changed to white
- Added drop shadow for improved depth and heirarchy
- Cards found inside of a tabset have their drop shadow removed
**Data Tables**
- Decreased row height for improved content density
**Split View**
- Changed color of background
**Static/Read Only Inputs**
- Updated font size, weight, and color ([ce7b275](https://github.com/salesforce-ux/design-system/commit/ce7b275))
**Default Tabs**
- Tabs take on the look and feel of a card
## **Release [2.3.1] - May 25, 2017**
## Big Impact
**BEM naming change**
Initially we used the double dash style for BEM notation (`--`). Due to the fact that double dashes are problematic in an XML environment (which doesn't allow double dashes within comments), we have upgraded our syntax to use the single underscore style (`_`). This change is backward compatible for 18 months. But all components going forward are built with the single underscore BEM style.
## Fixes
The following issues have now been resolved:
* Removed dotted underline for `abbr` that Chrome introduced in version 58
* Fix issue on Spinner component where Firefox and IE11 wouldn't respect its z-index token
* Fix line-height issue on `slds-form-element__static` when the output was multi-line
* Fix BEM naming convention on visibility classes - [#452](https://github.com/salesforce-ux/design-system/issues/452)
## **Release [2.3.0] - May 15, 2017**
## Features
The following are now available:
**Accordion**
* Added Accordion component — [Accordion](/components/accordion)
**Button**
* Added class `slds-is-selected-clicked` to handle click event on stateful button - [Stateful Button](/components/buttons?modifiers=.slds-is-selected-clicked&variant=stateful)
**Combobox**
* Added Combobox component — [Combobox](/components/combobox)
**Docked Utility Bar**
* Added two line support for docked utility bar items
**Dueling Picklist**
* Re-named from Multi-select — [Dueling Picklist](/components/dueling-picklist)
**Dynamic Icons**
* Added Ellie animated icon
* Added Equalizer animated icon
* Added Score animated icon
* Added Waffle animated icon
* Added Strength animated icon
* Added Trend animated icon
**Expandable Section**
* Added Expandable section component — [Expandable Section](/components/expandable-section?modifiers=.slds-is-open&variant=base)
* Added non-collapsable example
**Input**
* Added an example for Search input with loading spinner - [Input with spinner](/components/input?example=double-icon-spinner&variant=base)
* Added `slds-has-input-focus` utility class to provide focus styles on an element
**Lookups**
* Uses new combobox HTML
**Menus**
* Added `slds-dropdown—fluid` to adjust the width of a dropdown so it can be fluid to its container
* Added updated styles for base HTML elements in the Rich Text Editor
* Added the same updated styles in the output of the Rich Text Editor using the `.slds-rich-text-editor__output` class
* Added `slds-pill_link` to modify pill for when we want the hyperlink to take up 100% of the available pill
* Added `slds-pill__action` to the actionable link element inside of `slds-pill—link`
**Path**
* Re-named from Process
**Picklist**
* Uses new combobox HTML
**Pills**
* Added listbox of pill option variant — [Listbox of Pill Options](/components/pills?variant=listbox-of-pill-options)
**Popover**
* Added `slds-popover_walkthrough-alt` to modify the background of a walkthrough popover - [Walkthrough Popover](/components/popovers?example=action-popover&variant=walkthrough)
**Progress Bar**
* Added Progress Bar component — [Progress Bar](/components/progress-bar)
**Rich text editor**
* Added bottom toolbar support - [Bottom toolbar example](/components/rich-text-editor?example=bottom-toolbar&variant=base)
* Added long-form formatting support
**Spinner**
* Xx-small Spinner variant — [Spinner](/components/spinners?modifiers=.slds-spinner_xx-small&variant=base)
**Split View List**
* Added Split View component — [Split View](/components/split-view)
**Visual Picker**
* Added Visual Picker component — [Visual Picker](/components/visual-picker)
**Vertical Navigation**
* Added Vertical Navigation component — [Vertical Navigation](/components/vertical-navigation/)
* Deprecated Navigation component for this improved version
**Visibility**
* Improved visibility classes for responsive design — [#429](https://github.com/salesforce-ux/design-system/pull/429) - Thanks [@3den](https://github.com/3den)!
## Fixes
The following issues have now been resolved:
* Fix for `::-ms-clear` to remove native clear button in IE
* Whenever `slds-truncate` is used, it is required to be used in conjunction with a [title] attribute
* The Alert component icon is now contained within `slds-icon_container`
* The Button icon component is required to have `slds-button—icon` applied to the `` element. Before, `slds-button—icon-inverse`, `slds-button—icon-container`, `slds-button—icon-border`, `slds-button—icon-border-filled`, `slds-button—icon-border-inverse`, `slds-button—icon-more`, and `slds-button—icon-error` were used in conjunction with the `slds-button` classname but we now require `slds-button—icon` to be a part of this grouping of classnames
* The Stateful button component is required to have `slds-button—stateful` applied to the `` element
* The Toast component icon is now contained within `slds-icon_container`
* The Page header component "entity" icon is now contained within `slds-icon_container`
* The Feeds component "Post" examples have been updated to be contained within the `slds-feed` list
* The Compound Form Layout example was updated so each `fieldset` is correctly using the `slds-form-element` class and the whole form is now contained in `slds-form—compound`
* Unless the HTML output is represented as a list — `ul`, `ol`, or `dl` — all examples were updated to use `slds-bottom—[position]` instead of `slds-has-divider—[position]`
* Whenever `slds-dropdown` is used, it is required to be contained inside an element that has the classname `slds-dropdown-trigger`
* Whenever `slds-form—stacked`, `slds-form—horizontal`, and `slds-form—compound` is used, it is required to be used in conjunction with `slds-form`
* Whenever `slds-icon-text-default`, `slds-icon-text-warning`, or `slds-icon-text-error` is used, it is required to be used in conjunction with `slds-icon`
* Fixed a bug where the task2 icon corresponding class name was incorrectly named "task-2"
* Scoped :focus style for data-tables to `slds-table`
* Fixed an issue where assistive text in an parent with `text-transform: uppercase` would get read as full-caps (e.g. "Sorted ascending" in data table headers getting read as
* Rounded corners have been removed from utility icons so that they no longer clip incorrectly
* Breadcrumbs now wrap properly
* Focus state for pills has been moved to the containing element, rather than just the text inside of the pill
* Updated z-index of Docked Utility Bar to 4 to play nicely with others
* Prevent docked composer content from collapsing in Safari
* Updated cursor style for disabled state on radio button groups
## Deprecated
The following features are being marked as deprecated in this release and will be removed in three releases:
* Navigation was removed from site navigation and replaced with improved Vertical Navigation — [Vertical Navigation](/components/vertical-navigation/)
## Design
The following updates have been made to component designs:
* Touch components have been removed from the site
**Dropdown Menus:**
* Sub-headings inside of dropdown menus should now be truncated
**Docked Composer:**
* Added focus state around entire composer panel
* Title inside of composer panel header should truncate instead of wrap to two lines
**Feeds:**
* Removed the like count in the bottom right of the Feed post
* Changed spacing between feed posts from 1.5rem to .75rem
* Add top border to feed footer on mobile
**Files:**
* Added example for no title
* Added example for loading state
* Updated location of the files action menu
**Popovers**
* Always have a close button icon
## Tokens
The following changes have been made to tokens:
* `TASK_2` was renamed into `TASK2`
* Standard icon set: Added `ENTITLEMENT`
* Standard icon set: Added `LIVE_CHAT`
**s1-base/sizing**
* Removed `MAX_HEIGHT_ACTION_OVERFLOW_MENU`
* Removed `MAX_WIDTH_ACTION_BAR`
* Removed `MAX_WIDTH_ACTION_BAR_ITEM`
* Added `UTILITY_BAR_COLOR_BACKGROUND_NOTIFICATION_FOCUS`
* Added `VERTICAL_NAVIGATION_COLOR_BACKGROUND_SHADE_ROW_HOVER`
* Added `VERTICAL_NAVIGATION_COLOR_BACKGROUND_SHADE_ROW_ACTIVE`
## Accessibility
The following changes have been made to make our product more accessible:
**Activity Timeline**
- Added `title` attribute to item icons
- Changed the checkbox markup to match the new, "Explicit Label" markup pattern
**App Launcher**
- Changed `slds-modal` to be a `` element
- Changed `slds-modal__header` to be a `` element
- Changed the App Tiles icons to match the new [Avatar Fallback Entity Initials](/components/avatar) pattern, adding an `` tag
- Removed Assistive Text from Drag Handle image as it's irrelevant to screen reader users
- Implemented the new Expandable Section pattern to the expanding sections
- Placed a button element inside the section heading elements
- Added `aria-expanded="true|false"` to reflect state
- Added `aria-controls="id_of_expanding_section"` to associate the button to the content it controls and gave the content wrapper the same id
- Added three new states for Accessible Drag and Drop
- Added in the three missing states, necessary to demonstrate the Assistive Technology implementation for the full Drag and Drop lifecycle. "Grabbed", "Moved in list" and "Dropped"
- Added a live region to be used to update the user of Assistive Technology, to the current state of the operation
- Add an additional hidden piece of instructional text, that instructs the user how to perform the operation: "Press space bar to move this app within the list." This is present in the default state.
- Each focusable tile element, should be `aria-describedby="id-of-span-containing-instructional-text"`
- In the grabbed state
- Remove the instructional text as the user has performed the action, but keep the container
- Change the content of the live region, to be "{App Name}: current position {x} of 6. Use the up and down arrows to move this app"
- In the "Moved in List" state, implement the same changes applied to Grabbed but:
- Update the live region text to be: "{App Name}: new position {x} of 4."
- In the dropped state
- Update the live region text to be: "{App Name}: final position {x} of 4."
- Replace the hidden instructional text to be what it was in the base state
**Avatars**
- Added missing title attributes
**Button**
- Fixed the color contrast issues on the Success Button
**Card**
- Changed `slds-card__footer` to a `` element
- Changed Tiles to be a list of `slds-tile`'s
**Checkbox Button Group**
- Removed `for` attributes on wrapping `span` elements
**Date Picker**
- Added `role="dialog"` to the `slds-datepicker`
- Added `aria-label` to the `dialog` to describe its purpose
- Made the first day cell focusable as it is a ARIA `grid` widget
- Added `aria-multiselectable="true"` to the `grid` to indicate you can selected multiple dates
- Removed `headers` attribute from each `gridcell`
- Added assistive text for when we mark today's date in the grid. We do this to provide additional meaning since the grey background color is not enough of an indicator to non-sighted users
- Changed the "Today" option to be a selectable cell, just like any other day in the grid, by removing its `` tag
**Docked Composer**
- Changed the container element to be a ``
- Added `aria-describedby="id_of_body_element"` to the element that holds the `dialog` role. Gave the Composer body the same ID
- Changed the header to be to a `` element
- Removed redundant word "icon" in assistive text for icons in the Overflow Menu items
- Removed a duplicate `role="dialog"` attribute from the Popout variant as it created nested dialogs
- Added a means to tell a Docked Composer is "Minimized" by adding Assistive Text to the header
- Changed the Composer body and footer to be truly hidden when minimized
**Docked Composer - Task**
- Added assistive text to the icons used in the Lookup examples
- Upgraded the Lookups to ARIA 1.1 Specification
- See Lookup Notes for details
- Upgraded `listbox` markup to include option group headings being accessible, to match Picklist
- See Lookup Notes for details
- Fixed Listbox `option`'s markup to not wrap `div` elements in `span` elements
**Docked Composer - Voice**
- Added `aria-live="assertive"` to the header for alerting a user of a change in status of a call
- Changed the Mute button to be an ARIA Toggle Button with `aria-pressed="true|false"`
- Made "Recent Activity" on Incoming call example an ``
- Updated icon assistive text for icons in the Incoming Call example
- Added assistive text to the icons used in the Lookup examples on Log a Call
- Upgraded the Lookups to ARIA 1.1 Specification
- See Lookup Notes for details
- Upgraded `listbox` markup to include option group headings being accessible, to match Picklist
- See Lookup Notes for details
- Fixed Listbox `option`'s markup to not wrap `div` elements in `span` elements
**Docked Form Footer**
- Fixed button text on "with errors" state from "Settings" to "Review the Following Errors"
**Docked Utility Bar**
- Removed invalid role of `footer` from the `` element
- Implemented the ARIA Toggle Button pattern using `aria-pressed="true|false"` on buttons. Provides indication of an active or open utility panel
**Docked Utility Panel**
- Changed the container element to be a ``
- Changed the header to be to a `` element
- Made sure the content of a minimized Panel is not focusable by removing it from the DOM completely
**Expandable Section**
- Added `aria-controls` to the `` element that performs the action
- Added `aria-expanded="true|false"` to the `` element that performs the action
- Added `aria-hidden="true|false"` to the `slds-section__content` wrapper
- Added an ID to `slds-section__content` which the `` uses as its `aria-controls` value
**Feeds**
- Changed "Like" buttons to be `` elements
- Changed "Like" buttons to be ARIA Toggle Buttons with `aria-pressed="true|false"`
- Changed "More Comments" button to be a `` element
- Changed "Share" buttons to be `` elements
**Form Layout**
- Updated Checkbox and Radio Buttons to match newer "Explicit Label" pattern
**Global Header**
- Added `aria-label` to the Notifications dialog
- Added `aria-describedby` to the Notifications dialog
- Upgrade the ARIA Combobox markup to ARIA 1.1 Specification
- See Lookup Notes for details
- Upgraded `listbox` markup to include option group headings being accessible, to match Picklist
- See Lookup Notes for details
- Fixed Listbox `option`'s markup to not wrap `div` elements in `span` elements
- Fixed Favorites Button to communicate pressed state by Implementing the ARIA Toggle Button pattern using `aria-pressed`
**Global Navigation**
- Changed the App Launcher link to be a `` as it launches a Modal
- Fixed a malformed `title` attribute of the App Name
- Fixed the `title` attribute of the Object Switcher link to match visual text
- Fixed the `title` attribute of the Object Switcher Menu Button
**Global Navigation - Navigation Bar**
- Fixed Menu item title attributes
- Removed `aria-haspopup=true` from dropdown `li`.
- Removed `tabindex="0"` from `slds-context-bar__icon-action`.
- Removed `tabindex="-1"` from `slds-context-bar__icon-action`'s button.
- Added `aria-haspopup="true"` to `slds-context-bar__icon-action`'s button.
- Added assistive text to active item for Current page.
**Global Navigation - Tab Bar**
- Fixed `title` attribute on the Split View Toggle Button
- Removed `aria-haspopup` from Split View Toggle Button
- Implemented a simple Expanding Section ARIA pattern on the Split View Toggle button
- Added `aria-expanded="true|false" to reflect state
- Added `aria-controls="id_of_expanding_section"` to associate the button to the content it controls
- Added `aria-controls` to each `role="tab"`
- Created a `tabpanel` for each `tab`
- Added a unique ID to each which matches corresponding `aria-controls` attribute
- Added `aria-labelledby` to each which matches corresponding `tab` ID
- Updated the "New Tab" button text to match its function
- Updated the "New Tab" button title attribute
- Removed `aria-haspopup` attribute from "New Tab" button
- Added `aria-label` to the New Tab `dialog`
- Removed focusable hidden remove buttons in Pinned Tabs
**Input - Field Level Help**
- Moved `aria-describedby` from the `input` to the Tooltip Trigger ``
- Removed `aria-live` from the Tooltip
**List Builder**
- Changed the `role="dialog"` element to be a ``
- Changed `slds-modal__header` to be a `` element
- Changed `slds-modal__footer` to be a `` element
- Replaced selected Pills to be the new Listbox of Pills component
- Updated Lookup mark-up to match new structure. See Lookup notes
**Lookup**
- Upgrade the ARIA Combobox markup to ARIA 1.1 Specification
- Moved `role="combobox"` attribute from the `input` element to `slds-lookup` root element
- Moved `aria-expanded="true|false"` attribute from the `input` element to `slds-lookup` root element
- Added `aria-haspopup="listbox"` attribute to `slds-lookup` root element
- Added `autocomplete="off"` to the `input` element
- Added `aria-controls=""` to the `input` element which points to the ID of the `listbox`
- Added `role="textbox"` to the `input` element
- Removed `aria-owns` attribute from the `input` element as the `listbox` is not a child of the `combobox` role
- Changed `type` attribute on the `input` element to be `text`
- Upgraded `listbox` markup to include option group headings being accessible, to match Picklist
- Moved `role="listbox"` attribute from the `ul` element to the `slds-lookup__menu` root element
- When a `listbox` has option groups (a `slds-lookup__item_label`)
- `ul` element has `role="group"` with an `aria-label` of the same text as the `slds-lookup__item_label` text
- `slds-lookup__item_label`, becomes a presentational list item by placing it inside an `li[role="presentation"]` and being a child of the `ul`, as the `aria-label` on the `group` replaces its function
- When a `listbox` has no option groups (no `slds-lookup__item_label`)
- `ul` element has `role="presentation"` and no `aria-label`
- Fixed Listbox `option`'s markup to not wrap `div` elements in `span` elements
**Menus**
- Added `aria-checked` to Menu items with `role="menuitemcheckbox"` in all cases. Shouldn't just be added when `true`, setting `false` is important to communicate
**Modals**
- Added `aria-describedby` to the `slds-modal` element. This points to ID of `slds-modal__content`
- Added `aria-label` to Header Empty example, in the absence of a header with a heading tag
**Panels - Details**
- Updated the checkbox mark-up to be the new "explicit label" version
- Added `aria-haspopup="true"` to "More Actions" button in the Panel header
- Changed "Follow up on '15 contact" to be an `` element
- Changed the list of fields to be a list `
`
- Switched the DOM order of the field and edit pencil, so the edit action comes after the field
**Panels - Filtering**
- Changed the footer actions to be `` elements instead of links
- Changed "Matching all these filters" to a heading for better hierarchy
- Changed the filters to be `` elements instead of links.
- Locked filters are now `disabled`, which is possible with the change in element used, to be a ``
- Each filter button now includes additional assistive text to better describe the action: "Edit filter: "
- Improved repetitive button text for the remove filter buttons. Now follows the format of `"Remove Filter: ${name_of_filter}"` instead of just "Remove"
- Panel error message converted from `aria-live` to be `role="alert"`, which is implicitly "live"
- Inline error messages are now associated to the invalid filter button with `aria-describedby` being placed on the offending button
**Path**
- Fixed focus so that only one stage is focusable at a time
- Fixed focus styling on stages
- Removed `aria-live` from stages
- Added non-visual indicator of "Current Stage" by adding "Current Stage:" assistive text
- Updated semantics when no coaching available
- Swapped `tabset` to `listbox`
- Swapped `tab` to `option`
- Added `aria-orientation="horizontal"`
- Update `aria-controls` on each `tab` to match a unique ID
- Updates to expandable coaching tab panels
- Update button text on coaching expand/collapse toggle button so it's clear
- Add aria-expanded="false" by default to the `slds-tabs_path__link` which have `role="tab"`
- When the `tabpanel` is expanded, `aria-expanded="true"` is set on the currently selected `tab`
- Change the "edit" link to be a `` in the coaching panels
**Picklist**
- Upgrade the ARIA Combobox markup to ARIA 1.1 Specification
- Moved `role="combobox"` attribute from the `input` element to `slds-picklist` root element
- Moved `aria-expanded="true|false"` attribute from the `input` element to `slds-picklist` root element
- Added `aria-haspopup="listbox"` attribute to `slds-picklist` root element
- Added `autocomplete="off"` to the `input` element
- Added `aria-controls=""` to the `input` element which points to the ID of the `listbox`
- Added `role="textbox"` to the `input` element
- Removed `aria-owns` attribute from the `input` element as the `listbox` is not a child of the `combobox` role
- Changed `type` attribute on the `input` element to be `text`
- Changed the expand trigger button `title` attribute to match button text
- Moved the ID from `slds-dropdown__list` to `slds-dropdown` with `role="listbox"`
- Implemented Listbox of Pills component on Multi Select states
**Pills**
- Add title attributes to all icons or avatars in a Pill
**Popovers**
- Popovers without headers get `aria-label` applied to the `dialog`
- "Tesla Motors" Panel heading changed to `h2`
- Add a close button to all Popovers that don't have any
- Updated implementation guidelines
**Progress Indicator**
- Only apply `aria-describedby` to markers when a tooltip is shown
- In the Modal example, DOM order is fixed to follow visual order
- Updates to `slds-progress-bar`
- Added `role="progressbar"`
- Added `aria-valuemin="0"`
- Added `aria-valuemax="100"` to essentially make the progress bar a percentage
- Added `aria-valuenow` to track current progress
**Prompt**
- Added an ID to `slds-modal__content` for `aria-describedby` to work on the `alertdialog`
**Publisher**
- Made the "To: My Followers" definition list be part of the comment box `label` as a string, to create a better label
- Made the Publisher Actions not focusable when hidden
**Select**
- Added missing `required` attribute to Required and Error states
**Tabs**
- Fixed Sub Tabs `tabpanels` ID typos
**Vertical Navigation**
- Now uses a `` element as its parent
- Added `aria-label` to the `nav` element so it's easily identifiable from other navigation regions on the same page
- Added `aria-current="page"` to the "active" link
**Utilities - List**
- Name Value Pairs changed to definition lists
## Release [2.2.2] - March 8th, 2017
**ADDED**
The following classes are now available:
- Added `slds-table_resizable-cols` as a modifier to `slds-table`. Should be used if your table supports resizable columns.
**FIXES**
The following issues have now been resolved:
- `slds-table_fixed-layout` can now be used with the basic table - [#396](https://github.com/salesforce-ux/design-system/issues/396)
## February 24, 2017
**SITE IA/ENHANCEMENTS**
- Updated [iOS implementation documentation](/platforms/ios/)
**NEW IOS RELEASE (3.0.0)**
- Substantial script rewrite to handle future token changes
- You can now use design tokens in Swift
- Updated tokens to Spring ’17
- See detailed [release notes](https://github.com/salesforce-ux/design-system-ios/blob/master/CHANGELOG.md) for design-system-ios
## February 3, 2017
**SITE IA/ENHANCEMENTS**
- New and improved [Messaging Guidelines](/guidelines/messaging-overview)
## Release [2.2.1] - January 9, 2017
**NEW COMPONENTS AND VARIANTS**
The following components are now available:
- Added a toast for small columns - [Small Column Toast](/components/notifications#flavor-toast-small)
## Release [2.2.0] - January 6, 2017
**SITE IA/ENHANCEMENTS**
The following site enhancements are now available:
**NEW COMPONENTS AND VARIANTS**
The following components are now available:
- Added Global Navigation Tab bar (Workspace Tabs) - [Global Navigation Tab bar](/components/global-navigation/#flavor-navigation-tab-bar)
- Added Checkbox Add Button - [Checkbox Add Button](/components/forms/#flavor-checkbox-add-button)
- Added Button Group List - [Button Group List](/components/button-groups/#flavor-list) - the new recommended way to mark up button groups.
- Added Rich Text Editor - [Rich Text Editor](/components/rich-text-editor)
- Added Global Header Notifications - [Global Header Notifications](/components/global-header#flavor-notifications)
- Added Popover Header - [Popover Header](/components/popovers/#flavor-base-popover-header)
- Added Popover Footer - [Popover Footer](/components/popovers/#flavor-base-popover-footer)
- Added Progress Indicator - [Progress Indicator](/components/progress-indicator/)
- Added Walkthrough Popovers - [Walkthrough Popovers](/components/walkthrough/#flavor-popovers-default)
- Added Walkthrough Header - [Walkthrough Header](/components/walkthrough/#flavor-header)
- Added Success Button - [Success Button](/components/buttons/#flavor-base-success)
- Added Sub Tabs - [Sub Tabs](/components/tabs/#flavor-sub-tabs)
- Added Dynamic Lists Dropdown - [Dynamic Lists](/components/menus/#flavor-dynamic-list)
**ADDED**
The following classes are now available:
- Added `slds-float_none` utility - [Utilities › Floats › Float None](/components/utilities/floats/#flavor-float-none)
- Added `slds-button_icon-container-more` modifier - [Button Icons › Button Icon with Dropdown](/components/button-icons/#flavor-icon-with-dropdown)
- Added `slds-button_icon-more-filled` for more buttons that require a background.
- Added `slds-text-color_inverse` utility - [Utilities › Text › Color](/components/utilities/text/#flavor-color-text-color-inverse)
- Added `slds-text-color_inverse-weak` utility - [Utilities › Text › Color](/components/utilities/text/#flavor-color-text-color-inverse-weak)
- Added `slds-is-absolute` utility for overriding a components default positioning - [Utilities › Position › Absolute](/components/utilities/position/#flavor-absolute)
- Added additional spacing support for normalizing padding on a grid region
- Added `slds-border_bottom` utility [Utilities › Borders › Border Bottom](/components/utilities/borders/#flavor-border-bottom)
- Added `slds-border_left` utility [Utilities › Borders › Border Left](/components/utilities/borders/#flavor-border-left)
- Added `slds-border_right` utility [Utilities › Borders › Border Right](/components/utilities/borders/#flavor-border-right)
- Added `slds-border_top` utility [Utilities › Borders › Border Top](/components/utilities/borders/#flavor-border-top)
- Added `slds-box_xx-small` utility [Utilities › Themes › Box](/components/utilities/themes/#flavor-box-xx-small)
- Added support for dark backgrounds on `slds-dropdown` by adding modifier `slds-dropdown_inverse`
- Added support for narrow region on feeds.
**CHANGES**
The following changes have been made in this release:
- Global actions icon on global header updated to have a background color
- Changed global header icon's color and size
- Changed background color of docked panels
- Docked Utility Panel - [Docked Utility Panel](/components/docked-utility-bar/#flavor-utility-panel)
- Docked Composer Panel - [Docked Composer Panel](/components/docked-composer)
- Cards are now responsive - [Cards](/components/cards/)
- Improvements made to `slds-type-focus` utility - [Utilities › Interactions](/components/utilities/interactions/#flavor-faux-links)
- Avatars now support initials.
- Stateful icon buttons are now compatible with `slds-button_icon-container`
- Spacing adjustments made to lookup items
- Spacing adjustments made to feeds
**FIXED**
The following issues have now been resolved:
- Accessibility improvement - Picklists changed to a read-only combobox with a listbox.
- Add collapsable margin to `slds-card__body` to account for white space when the footer is empty
- Data Table › Inline edit now has full support
- Icon inside of an input field now uses the correct token
- Modal content properly wraps and hyphenates longform text
- Fixed flex issue on docked composer that made popout example stretch the height of the viewport
**DEPRECATED**
The following features are being marked as deprecated in this release and will be removed in three releases:
- Process › Wizard - Please use the new Progress Indicator instead [Progress Indicator](/components/progress-indicator/)
**REMOVED**
The following features are being removed in this release:
- `$css-prefix` is no longer available to change the prefix of `slds-` class names to something of your choice. As an alternative, please use this PostCSS plugin to customize class name prefixes: [postcss-slds-prefix](https://github.com/salesforce-ux/postcss-slds-prefix).
- Removed custom styled scrollbar mixin from `slds--scrollable-` helpers
- Deleted legacy font-files for older, unsupported browsers (*.eot, *.svg)
**TOKENS**
Tokens are now part of the Lightning Design System.
Token files previously available from the `@salesforce-ux/design-tokens` npm package are now available in `design-tokens/dist` in the `@salesforce-ux/design-system` package (the same applies for the zip download).
The following tokens have been add/removed/deprecated in this release:
- Added `force-base/fill.json`
- Added token: `FILL_HEADER_BUTTON`
- Added token: `FILL_HEADER_BUTTON_HOVER`
- Added `force-base/text-transform.json`
- Added token: `TEXT_TRANSFORM`
- Added token: `FONT_FAMILY_TEXT`
- Added token: `FONT_FAMILY_HEADING`
- Added token: `Z_INDEX_STICKY`
- Added token: `FONT_FAMILY_TEXT`
- Added token: `FONT_FAMILY_HEADING`
- Added token: `PROGRESS_COLOR_BACKGROUND`
- Added token: `PROGRESS_COLOR_BACKGROUND_SHADE`
- Added token: `PROGRESS_COLOR_BORDER`
- Added token: `PROGRESS_COLOR_BORDER_SHADE`
- Added token: `PROGRESS_COLOR_BORDER_HOVER`
- Added token: `PROGRESS_COLOR_BORDER_ACTIVE`
- Added token: `PROGRESS_BAR_HEIGHT`
- Added token: `PROGRESS_BAR_COLOR_BACKGROUND`
- Added token: `PROGRESS_BAR_COLOR_BACKGROUND_FILL`
- Added token: `COLOR_STROKE_BRAND`
- Added token: `COLOR_STROKE_BRAND_HOVER`
- Added token: `COLOR_STROKE_BRAND_ACTIVE`
- Added token: `COLOR_STROKE_DISABLED`
- Added token: `COLOR_STROKE_HEADER_BUTTON`
- Added token: `FILL_BRAND`
- Added token: `FILL_BRAND_HOVER`
- Added token: `FILL_BRAND_ACTIVE`
- Added token: `BORDER_STROKE_WIDTH_THIN`
- Added token: `BORDER_STROKE_WIDTH_THICK`
- Added token: `COLOR_BACKGROUND_BUTTON_SUCCESS`
- Added token: `COLOR_BACKGROUND_BUTTON_SUCCESS_HOVER`
- Added token: `COLOR_BACKGROUND_BUTTON_SUCCESS_ACTIVE`
- Added token: `COLOR_TEXT_SUCCESS_INVERSE`
- Added token: `CUSTOM_101`
- Added token: `CUSTOM_102`
- Added token: `CUSTOM_103`
- Added token: `CUSTOM_104`
- Added token: `CUSTOM_105`
- Added token: `CUSTOM_106`
- Added token: `CUSTOM_107`
- Added token: `CUSTOM_108`
- Added token: `CUSTOM_109`
- Added token: `CUSTOM_110`
- Added token: `CUSTOM_111`
- Added token: `CUSTOM_112`
- Added token: `CUSTOM_113`
- Added token: `CUSTOM_NOTIFICATION`
- Added token: `DATADOTCOM`
- Added token: `RTC_PRESENCE`
- Added token: `PRODUCT_CONSUMED`
- Added token: `PRODUCT_TRANSFER`
- Added token: `PRODUCT_ITEM`
- Added token: `PRODUCT_ITEM_TRANSACTION`
- Added token: `LOCATION`
- Added token: `ADDRESS`
- Added token: `CAROUSEL`
- Added token: `ASSIGNED_RESOURCE`
- Added token: `OPERATING_HOURS`
- Added token: `PRODUCT_REQUIRED`
- Added token: `RESOURCE_ABSENCE`
- Added token: `RESOURCE_CAPACITY`
- Added token: `RESOURCE_PREFERENCE`
- Added token: `RESOURCE_SKILL`
- Added token: `SERVICE_TERRITORY_MEMBER`
- Added token: `SERVICE_APPOINTMENT`
- Added token: `SERVICE_REPORT`
- Added token: `SERVICE_RESOURCE`
- Added token: `SERVICE_TERRITORY`
- Added token: `SKILL`
- Added token: `SKILL_REQUIREMENT`
- Added token: `TIMESLOT`
- Added token: `WORK_TYPE`
- Added alias: `SANS_SERIF`
- Added alias: `MALIBU`
- Added alias: `SANS_SERIF`
- Added alias: `EBONY_CLAY`
- Added alias: `OXFORD_BLUE`
- Added alias: `RIVER_BED`
- Deprecated `FONT_FAMILY`
## Release [2.1.4] - November 7, 2016
**FIXED**
The following issues have now been resolved:
- Title attributes were added to all button icons and truncated text for accessibility
- Added line-height fix for `.slds-button—icon-border-inverse`
- Amended `.slds-button_icon` documentation
- Removed unnecessary `.slds-not-selected` class from stateful `.slds-button_icon` markup and adjusted documentation
## Release [2.1.3] - September 21, 2016
**FIXED**
The following issues have now been resolved:
- Included the logo SVG asset used in the Global header
- Use `@support` for progressive enhancement of `mix-blend-mode` for active/hover states in Global Navigation
- Removed the demo style `.slds-text-align_center` from `.slds-card__body`
**DEPRECATED**
Customizing the CSS class names by customizing `$css-prefix` is deprecated and will be removed in version 2.2.
As an alternative, please use this PostCSS plugin to customize class name prefixes: [postcss-slds-prefix](https://github.com/salesforce-ux/postcss-slds-prefix).
## Release [2.1.2] - September 6, 2016
**SITE IA/ENHANCEMENTS**
The following site enhancements are now available:
- Moved Archives section up on Downloads page, and added a link to the section on the homepage, for better visibility.
- New Checkbox Toggle guidelines under [Data Entry section](/guidelines/data-entry/).
- New "Touch" section under "Components", where you’ll find patterns especially optimized for touch
- Link to Styling with Design Tokens on the platform added on [Design Tokens](/design-tokens/), [Lightning Components](/platforms/lightning/), and [Downloads](/downloads/) pages.
- Button Icon component has been moved out of Buttons and into its own category [Button Icon](/components/button-icons/)
- Picklist component has been moved out of Menus and into its own category [Picklist](/components/picklist/)
**NEW COMPONENTS AND VARIANTS**
The following components are now available:
- App Launcher - [App Launcher Component](/components/app-launcher/)
- Global Navigation - Standard context bar - [Global Navigation Component](/components/global-navigation/)
- Global Header - [Global Header Component](/components/global-header/)
- Docked Utility Bar - [Docked Utility Bar Component](/components/docked-utility-bar/)
- Filtering panel - [Filtering Panel Component](/components/panels/#flavor-filtering)
- Files - [File Components](/components/files/)
- File selector - [File Selector](/components/file-selector/)
- Feed v2 - [Feeds Component](/components/feeds/)
- Indeterminate checkbox - [Indeterminate checkbox component](/components/forms/#flavor-checkbox)
- Button Icon Inverse - Bordered - [Button Icon Inverse with Border](/components/button-icons/#flavor-icon-container-button-icon-border)
- Button Icon Inverse - Hint Hover - [Button Icon with Hint Hover](/components/button-icons/#flavor-icon-with-hint-hover)
- Button Icon Error - [Button Icon Error](/components/button-icons/#flavor-base-button-icon-error)
- Image Cards - [Figure Card Component](/components/images/#flavor-figure-figure-card)
- Image Ratios - [Figure Ratio Component](/components/images/#flavor-figure-ratio)
- Vertical Navigation color variation - [Vertical Navigation](/components/navigation/#flavor-vertical-inverse)
**ADDED**
The following classes are now available:
- Text color helpers - [Utilities › Text › Color](/components/utilities/text/#flavor-color)
- Text title utility - `.slds-text-title` - [Utilities › Text › Text Title](/components/utilities/text/#flavor-title)
- Text link utility - Made text inside of `.slds-text-link_reset` appear as a link - [Utilities › Interactions › Text Link](/components/utilities/interactions/#flavor-text-link)
- Truncation containers [Utilities › Truncation](/components/utilities/truncation/#flavor-max-width)
- Absolute sizes utility classes: `.slds-size_xx-small`, `.slds-size_x-small`, `.slds-size_medium`, `.slds-size_large`, `.slds-size_x-large`, `.slds-size_xx-large` and their responsive equivalents - in [Utilities › Sizing](/components/utilities/sizing/)
- Hyphenation utility for non-truncated headings in narrow containers - [Utilities › Hyphenation](/components/utilities/hyphenation/)
- Position utilities - [Utilities › Position](/components/utilities/position/)
- Table column borders - Added vertical column borders on a table by applying `.slds-table_col-bordered`
- Name/Value pair lists - 3 variations - horizontal, inline and stacked - [Utilities › Lists › Name Value Pair](/components/utilities/lists/#flavor-name-value-pair)
- Generated grid column spans 1, 2, 3, 4, 5, 6, 7, 8, and 12 for all breakpoints
- Added archives for previous versions of the site for customers that can't upgrade yet. These site archives are currently available at the bottom of the [Downloads page](/downloads/)
**CHANGES**
The following changes have been made in this release:
- [Docked Form Footer](/components/forms/#flavor-docked-form-footer-docked-form-footer-with-popover) popover tooltip naming changed to popover.
- [CSS Scoping Tool](https://tools.lightningdesignsystem.com/css-customizer) is now only necessary when building components to be included in Visualforce
- [Using SLDS in Lightning](/platforms/lightning/) has been updated to include information about Lightning Out, Lightning Components for Visualforce, and Lightning Applications.
- Nubbins on [Popovers](/components/popovers/#flavor-nubbins) have been moved .5rem/8px closer to the respective edge of the popover to match the spec
- [Pills](/components/pills/) have been updated with a more accessible DOM. They are no longer made from an anchor, but instead contain the anchor. Documentation is updated. (Old pills will not break)
- [Checkbox Toggle](/components/forms/#flavor-checkbox-toggle) has an updated design with the ability to add custom words below the toggle
- [Checkbox](/components/forms/#flavor-checkbox) and [Radios](/components/forms/#flavor-radio) have been updated with a new, more accessible than ever DOM structure. (Your old DOM will not break.)
- Brightened yellow background on `mark` element.
- Text selected with your mouse is light blue.
- Renamed "slide-out" panel to "details" - [Detail Panel Component](/components/panels/#detail)
- Renamed "Base" data table to "Basic" data table - [Data Table Component](/components/data-tables/)
- Abstracted complex data table features into a variant named "Advanced" data table - [Data Table Component](/components/data-tables/#advanced)
- Improvements made to `.slds-text-link_reset` - [Utilities › Interactions › Text Link Reset](/components/utilities/interactions/#link-reset)
- Removed light font-weight from the text utility `.slds-text-heading_small` - [Utilities › Text › Text Heading Small](/components/utilities/text/#flavor-heading-heading-small)
- Removed `position: relative` from `.slds-grid`
- Feeds are now responsive
- Added close button to error popover so a screen reader can access popover
- Added animated waffle icon to Global Navigation [Global Navigation](/components/global-navigation/)
- Feeds:
- Changed post's comment metric labels to lowercase
- Added hint-hover to post's comment action overflow icon
- Changed post's comment "link" text to use `.slds-color-link_weak`
- Removed dotted line separator from post's attachment payload
- Moved URL of post's attachment to the bottom of the content ordering
- Removed truncation from preamble
- Reduced white space between feed items
- Updated [Activity Timeline Email example](/components/activity-timeline/#flavor-email) to show the to and from with truncation
**FIXED**
The following issues have now been resolved:
- Recorded home vertical accessibility fixes
- Added `aria-haspopup="true"` to action overflow buttons
- Added assistive text for icon
- Removed unnecessary aria roles from action overflow buttons
- Improved assistive text verbiage
- Made multiple value field entirely clickable to invoke dropdown
- Global header accessibility fixes
- Modified tab order of global header actions
- Added `title` attribute to global header actions
- Changed avatar wrapper from anchor to a button
- Allowed `.slds-assistive-text` to become visible on focus if `.slds-assistive-text_focus` is used
- Added aria roles to global search input
- Changed global search listbox options to be non-actionable
- Moved "click enter to search" and "go to" options back into `
` so they can be discovered by screen readers
- Added `.slds-has-focus` to apply focus state on listbox options when keyboard interactions are used
- Moved clear button to the right of the input to visually match tab order
- Lookup/Global Header Search accessibility fixes
- Improved semantics of dropdown menus
- Applied `role=separator` to dropdown menu list items that do not have an actionable element
- Applied `role=presentation` to dropdown menu list items
- Changed `
` wrapping dropdown menu items text to ``
- Dropdown menu items have a default `tabindex="-1"`, tab focused items changed to a `tabindex="0"`
- Utility bar accessibility fixes
- Added landmark `role="footer"` to utility bar
- Added `aria-label="Utility Bar"` description to utility bar
- Added hidden heading to utility bar
- Added aria `role=dialog` and `aria-labelledby` to utility bar panel
- Changed panel header text to be wrapped in a heading with a id to reference the `aria-labelledby`
- Placed utility bar buttons inside `
`
- Files accessibility fixes
- Fixed invalid markup by moving button group outside of anchor
- Image overlay is now enabled by adding an extra html element before the image and adding the class `.slds-image_overlay`
- Card accessibility fixes
- Moved `` element to only contain the card header text, rather than the text and overflow menu
- Changed `
` tags with truncation in related list markup to `` tags
- Made primary labels of compound fields capital
- Dropdowns appear on icon focus within Global Navigation
- Labeled the dialog with the heading of the modal using `aria-labelledby="id_of_heading"` in the app launcher component
- Tables accessibility fixes: all tables now use the same truncation method when text is too long in a cell and show the full text when truncated text is hovered
- Accessibility fixes for list builder
- Fixed an issue where examples contained the same ID multiple times
- Feeds accessibility fixes
- Comments are now list items in an unordered list structure
- The browser shows a focus ring when avatars are focused
- Accessibility fixes to Menus and Picklist, including Menus used in composite SLDS components
- Removed of `aria-expanded` on containers
- `role="presentation"` added on list items to remove them from the accessibility tree
- Corrected use of `menuitemcheckbox` for selectable menu items, with the use of `aria-checked` instead of `aria-selected`
- Corrected sub heading menus which was split across multiple un-ordered lists
- Included line separators and sub-heading separators into the accessibility tree with `role="separator"`
- Added `aria-describedby` on textarea element to show error message ID
- Added `aria-live` attribute to the stateful icon button
- Added `aria-describedby` on select element to show error message ID
- Added `aria-haspopup` on Activity Timeline menu buttons, and updated each list item to use an `
` tag
- Added hyphenation code to popovers so that long words will break and wrap
**DEPRECATED**
The following features are being marked as deprecated in this release and will be removed in three releases:
- Feeds v1 - Design has changed to v2 - [Feeds v2 Component](/components/feeds/)
- Text heading label utility - Use Text title utilities instead - [Utilities › Text › Text Title](/components/utilities/text/#flavor-title)
**REMOVED**
The following features or demos are being removed in this release:
- Removed inverse and state themes from examples to provide clarity of usage.
## Release [2.0.3] - August 1, 2016
**FIXED**
The following issues have now been resolved:
- Card a11y fixes
- Card semantically changed to an `article`
- Card header semantically changed to a `header`
- Added `aria-haspopup="true"` to action overflow button since it invokes a dropdown menu
- Wrapped card header text in an `
`
- Fixed label for / textarea id mismatch in form textarea example
- Fixed modal close button styling so the focus halo no longer overlaps with the modal body
- Labeled the dialog with the heading of the modal using `aria-labelledby="id_of_heading"` and removed `aria-hidden="false"` from modal
- Added an example usage of `slds-table_striped` in the basic data table example
- Reverted modal components for the touch devices to prototype status while a fix for using them in Salesforce1 is found
- Added a title attribute to the truncation example
- Changed status of single-line truncation to dev-ready
- Fixed an issue where `