CHANGELOG.md

Unreleased

Experimental

• Reinstated the ability to pass additional props to the ToolsPanel (36428).

Bug Fix

• Fixed spacing between BaseControl fields and help text within the ToolsPanel (36334)

19.0.1 (2021-11-07)

Experimental

• Updated the ToolsPanel to use Grid internally to manage panel layout (35621).

19.0.0 (2021-10-22)

New Features

• Added support for step="any" in NumberControl and RangeControl (#34542).

Enhancements

• Removed the separator shown between ToggleGroupControl items (#35497).
• The ColorPicker component property onChangeComplete, a function accepting a color object, was replaced with the property onChange, a function accepting a string on (#35220).
• The property disableAlpha, was removed from the ColorPicker component. Use the new opposite property enableAlpha instead (#35220).

Experimental

• Removed the fieldset wrapper from the FontAppearanceControl component (35461).
• Refactored the ToggleGroupControl component's structure and embedded ToggleGroupControlButton directly into ToggleGroupControlOption (#35600).
• Added support for showing an experimental hint in CustomSelectControl (#35673).

Breaking Changes

• The color property a tinycolor2 color object passed on onChangeComplete property of the ColorPicker component was removed. Please use the new onChange property that accepts a string color representation (#35562).

18.0.0 (2021-10-12)

Breaking Changes

• Removed the deprecated position and menuLabel from the DropdownMenu component (#34537).
• Removed the deprecated onClickOutside prop from the Popover component (#34537).
• Changed RangeControl component to not apply shiftStep to inputs from its <input type="range"/> (35020).
• Removed isAction prop from Item. The component will now rely on onClick to render as a button (35152).

New Features

• Add an experimental Navigator components (#34904) as a replacement for the previous Navigation related components.
• Update the ColorPicker component to the latest design (#35220)

Bug Fix

• Fixed rounding of value in RangeControl component when it loses focus while the SHIFT key is held. (#35020).

Internal

• Deleted the createComponent utility function (#34929).
• Deleted the useJumpStep utility function (#35561).

17.0.0 (2021-09-09)

Breaking Change

• Removed a min-width from the DropdownMenu component, allowing the menu to accommodate thin contents like vertical tools menus (#33995).

Bug Fix

• Fixed RTL styles in Flex component (#33729).
• Fixed unit test errors caused by CSS.supports being called in a non-browser environment (#34572).
• Fixed ToggleGroupControl's backdrop not updating when changing the isAdaptiveWidth property (#34595).

Internal

• Renamed PolymorphicComponent* types to WordPressComponent* (#34330).

16.0.0 (2021-08-23)

Breaking Change

• Updated the visual styles of the RangeControl component (#33824).

New Feature

• Add hideLabelFromVision prop to RangeControl (#33714).

Bug Fix

• Listen to resize events correctly in useBreakpointIndex. This hook is used in useResponsiveValue and consequently in the Flex and Grid components (#33902)

15.0.0 (2021-07-29)

Breaking Change

• Upgraded React components to work with v17.0 (#29118). There are no new features in React v17.0 as explained in the blog post.

Deprecation

• isScrollable prop in CardBody default value changed from true to false (#33490)

Bug Fix

• Added back box-sizing: border-box rule to CardBody, CardHeader and CardFooter components #33511.

14.2.0 (2021-07-21)

New Feature

• Update the border color used in CardBody, CardHeader, CardFooter, and CardDivider to a different shade of gray, in order to match the color used in other components (#32566).

Deprecation

• isPrimary, isSecondary, isTertiary and isLink props in Button have been deprecated. Use variant instead (#31713).
• isElevated prop in Card has been deprecated. Use elevation instead (#32566).

Internal

• Card, CardBody, CardHeader, CardFooter, CardMedia, and CardDivider components have been re-written from the ground up (#32566).

14.1.0 (2021-05-20)

14.0.0 (2021-05-14)

Breaking Changes

• Drop support for Internet Explorer 11 (#31110). Learn more at https://make.wordpress.org/core/2021/04/22/ie-11-support-phase-out-plan/.
• Increase the minimum Node.js version to v12 matching Long Term Support releases (#31270). Learn more at https://nodejs.org/en/about/releases/.
• The experimental Text component has been completely re-written and enhanced with truncation support and separate variant, size, and weight props to allow for greater control. The previous variant prop has been completely removed.

Deprecation

• isReversed prop in Flex component has been deprecated. Use direction instead (#31297).

Internal

• Flex, FlexBlock, and FlexItem components have been re-written from the ground up (#31297).

13.0.0 (2021-03-17)

Breaking Change

• onChange prop of FocalPointPicker is called at the end of drag operations. Previously, it was called repetitively while dragging.

New Feature

• Supports ref forwarding in withNotices and ResizableBox.
• Adds onDrag prop of FocalPointPicker.

Bug Fix

• Allows focus of the FocalPointPicker draggable area and adjustment with arrow keys. This was added in #22531 but was no longer working.

12.0.0 (2020-12-17)

Enhancements

• ComboboxControl: Deburr option labels before filter

Breaking Change

• Introduce support for other units and advanced CSS properties on FontSizePicker. Provided the value passed to the FontSizePicker is a string or one of the size options passed is a string, onChange will start to be called with a string value instead of a number. On WordPress usage, font size options are now automatically converted to strings with the default "px" unit added.

10.1.0 (2020-09-03)

New Feature

• Add ToolbarItem component.
• Support label prop on the Toolbar component.

Deprecations

• Deprecate the Toolbar component when used without the label prop. ToolbarGroup should be used instead.

10.0.0 (2020-07-07)

Breaking Change

• NumberControl no longer automatically transforms values when rendering value into a <input /> HTML element.
• Dashicon component no longer renders SVGs. If you rely on this component, make sure to load the dashicon font.

9.6.0 (2020-05-14)

Bug Fix

• Fix and issue that would cause the Popover component to throw an error under certain circumstances (#22264).

Deprecations

• The Guide component no longer supports passing pages as children. Use the pages prop instead.
• The GuidePage component is deprecated. Use the pages prop in Guide instead.

9.2.0 (2020-02-10)

Enhancements

• The Notice component will speak its message. With this new feature, a developer can control either the spokenMessage spoken message, or the politeness politeness level of the message.
• The Snackbar component will speak its message. With this new feature, a developer can control either the spokenMessage spoken message, or the politeness politeness level of the message.
• A Notice actions member can now assign isPrimary to render a primary button action associated with a notice message.

Bug Fixes

• Notice will assume a default status of 'info' if none is provided. This resolves an issue where the notice would be assigned a class name is-undefined. This was previously the effective default by styled appearance and should not be considered a breaking change in that regard.

9.0.0 (2020-01-13)

New Features

• Added a new Guide component which allows developers to easily present a user guide.

Breaking Changes

• is-button classname has been removed from the Button component.
• The is-default classname is not applied automatically anymore.
• By default Button components come with a fixed height and hover styles.

Bug Fixes

• Fixes a regression published in version 8.5.0 that would prevent some build tools from including styles provided in the packages build-styles directory.

Deprecations

• isDefault prop in Button has been deprecated. Consider using isSecondary instead.
• IconButton has been deprecated. Use the Button component instead.

8.2.0 (2019-08-29)

New Features

• The bundled re-resizable dependency has been updated from requiring 5.0.1 to requiring ^6.0.0 (#17011).

8.1.0 (2019-08-05)

New Features

• Added a new popoverProps prop to the Dropdown component which allows users of the Dropdown component to pass props directly to the Popover component.
• Added and documented hideLabelFromVision prop to BaseControl used by SelectControl, TextControl, and TextareaControl.
• Added a new popoverProps prop to the DropdownMenu component which allows to pass props directly to the nested Popover component.
• Added a new toggleProps prop to the DropdownMenu component which allows to pass props directly to the nested IconButton component.
• Added a new menuProps prop to the DropdownMenu component which allows to pass props directly to the nested NavigableMenu component.

Deprecations

• menuLabel prop in DropdownComponent has been deprecated. Consider using menuProps object and its aria-label property instead.
• position prop in DropdownComponent has been deprecated. Consider using popoverProps object and its position property instead.

Bug Fixes

• The Button component will no longer assign default styling (is-default class) when explicitly assigned as primary (the isPrimary prop). This should resolve potential conflicts affecting a combination of isPrimary, isDefault, and isLarge / isSmall, where the busy animation would appear with incorrect coloring.

Deprecations

• The Popover component onClickOutside prop has been deprecated. Use onFocusOutside instead.

Internal

• The Dropdown component has been refactored to focus changes using the Popover component's onFocusOutside prop.
• The MenuItem component will now always use an IconButton. This prevents a focus loss when clicking a menu item.
• Package no longer depends on external react-click-outside library.

8.0.0 (2019-06-12)

New Feature

• Add new BlockQuotation block to the primitives folder to support blockquote in a multiplatform way. #15482.
• DropdownMenu now supports passing a render prop as children for more advanced customization.

Internal

• MenuGroup no longer uses NavigableMenu internally. It needs to be explicitly wrapped with NavigableMenu to bring back the same behavior.

Documentation

• Added missing documentation for DropdownMenu props menuLabel, position, className.

Breaking Change

• ServerSideRender is no longer part of components. It was extracted to an independent package @wordpress/server-side-render.

Bug Fix

• Although DateTimePicker does not allow picking the seconds, passed the current seconds as the selected value for seconds when calling onChange. Now it passes zero.

7.4.0 (2019-05-21)

New Feature

• Added a new HorizontalRule component.
• Added a new Snackbar component.

Bug Fix

• Fixed display of reset button when using RangeControl allowReset prop.
• Fixed minutes field of DateTimePicker missed '0' before single digit values.

7.3.0 (2019-04-16)

New Features

• Added a new render property to FormFileUpload component. Allowing users of the component to custom the UI for their needs.
• Added a new BaseControl.VisualLabel component.
• Added a new preview prop to the Placeholder component which allows to display a preview, for example a media preview when the Placeholder is used in media editing contexts.
• Added a new anchorRect prop to Popover which enables a developer to provide a custom DOMRect object at which to position the popover.

Improvements

• Limit Base Control Label to the width of its content.

Bug fixes

• Fix instanceId prop passed through to Button component via MenuItems producing React console error. Fixed by removing the unnecessary use of withInstanceId on the MenuItems component #14599

7.2.0 (2019-03-20)

Improvements

• Make RangeControl validation rely on the checkValidity provided by the browsers instead of using our own validation.

Bug Fixes

• Fix a problem that made RangeControl not work as expected with float values.

7.1.0 (2019-03-06)

New Features

• Added a new Animate component.

Improvements

• withFilters has been optimized to avoid binding hook handlers for each mounted instance of the component, instead using a single centralized hook delegator.
• withFilters has been optimized to reuse a single shared component definition for all filtered instances of the component.
• Make RangeControl validate min and max properties.

Bug Fixes

• Resolves a conflict where two instance of Slot would produce an inconsistent or duplicated rendering output.
• Allow years between 0 and 1970 in DateTime component.

New Feature

• Dropdown now has a focusOnMount prop which is passed directly to the contained Popover.
• DatePicker has new prop isInvalidDate exposing react-dates' isOutsideRange.
• DatePicker allows null as accepted value for currentDate prop to signify no date selection.

7.0.5 (2019-01-03)

7.0.4 (2018-12-12)

7.0.3 (2018-11-30)

7.0.2 (2018-11-22)

7.0.1 (2018-11-21)

7.0.0 (2018-11-20)

Breaking Change

• Dropdown.refresh() has been removed. The contained Popover is now automatically refreshed.

6.0.2 (2018-11-15)

6.0.1 (2018-11-12)

Bug Fixes

• Avoid constantly recomputing the popover position.

Polish

• Remove <DateTimePicker /> obsolete locale prop (and pass-through to child components) and obsolete is12Hour prop pass through to <DateTime /> #11649

6.0.0 (2018-11-12)

Breaking Change

• The PanelColor component has been removed.

5.1.1 (2018-11-09)

5.1.0 (2018-11-09)

New Feature

• Adjust a11y roles for MenuItem component, so that aria-checked is used properly, related change in Editor/Components/BlockNavigationList (#11431).
• Popover components are now automatically refreshed every 0.5s in order to recalculate their size or position.

Deprecation

• Dropdown.refresh() has been deprecated as the contained Popover is now automatically refreshed.

5.0.2 (2018-11-03)

Polish

• Forward ref in the PanelBody component.
• Tooltip are no longer removed when Button becomes disabled, it's left to the component rendering the Tooltip.
• Forward ref support in TabbableContainer and NavigableMenu components.

5.0.1 (2018-10-30)

5.0.0 (2018-10-29)

Breaking Change

• AccessibleSVG component has been removed. Please use SVG instead.

New Feature

• The Notice component accepts an array of action objects via the actions prop. Each member object should contain a label and either a url link string or onClick callback function.

4.2.1 (2018-10-22)

Bug Fix

• Fix importing react-dates stylesheet in production.

4.2.0 (2018-10-19)

New Feature

• Added a new ColorPicker component (#10564).
• MenuItem now accepts an info prop for including an extended description.

Bug Fix

• IconButton correctly respects a passed aria-label prop.

Deprecation

• PanelColor has been deprecated in favor of wp.editor.PanelColorSettings.

4.1.2 (2018-10-18)

4.1.0 (2018-10-10)

New Feature

• Added a new ResizableBox component.

4.0.0 (2018-09-30)

Breaking Change

• Draggable as a DOM node drag handler has been removed. Please, use Draggable as a wrap component for your DOM node drag handler.

Deprecation

• Renamed AccessibleSVG component to SVG.

3.0.0 (2018-09-05)

Breaking Change

• withAPIData has been removed. Please use the Core Data module or @wordpress/api-fetch directly instead.
• Draggable as a DOM node drag handler has been deprecated. Please, use Draggable as a wrap component for your DOM node drag handler.
• Change how required built-ins are polyfilled with Babel 7 (#9171). If you're using an environment that has limited or no support for ES2015+ such as lower versions of IE then using core-js or @babel/polyfill will add support for these methods.
• withContext has been removed. Please use wp.element.createContext instead. See: https://reactjs.org/docs/context.html.

New Feature

• Added a new AccessibleSVG component.