<!-- Release notes authoring guidelines: http://keepachangelog.com/ -->

# Modals Release Notes

<!-- ## [Unreleased] -->

## 2.28.0

### Fixed

- Fixed close button focus indicator color to meet contrast ratio accessibility requirements.

## 2.25.1

### Updated

- Updated the modals blueprint to display a white background for the close button (X) to improve visibility for people with low vision. Specifically, we updated the close button (X) color from white to gray by removing the `slds-button_icon-inverse` class. To display the modal close button correctly, don’t use the `slds-button_icon-inverse` class for your close button markup.

## 2.25.0

### Updated

- Updated background color of the Modal's close icon along with its active state styling

## 2.24.0

### Changed

- Added tabindex to the heading element to make it programmatically focusable.

### Fixed

- Fixed modal by removing code explicitly scoped to patching internal, private implementations. Appropriate styles will be displayed again.

## 2.23.2

### Changed

- Fixed token notation in header padding-right property

## 2.22.0

### Changed

- Optimized full size option and refactored to use CSS grid.
- Updated full size variant to trigger at the `$mq-small` breakpoint to prevent larger devices from receiving the variant.

## 2.21.0

### Fixed

- Fixed `aria-labelledby` to meet accessibility requirements specifically for screen readers.

## 2.21.0

### Changed

- Added full size option for modal. This will allow the modal to reach full screen for mobile screen size and devices. When screen is bigger than mobile screen width (from 768px), full size modal will take on large size modal behaviour.
- Changed close button to meet accessibility requirement when in full size and in mobile width.

## 2.19.0

### Changed

- Added tabindex to Footless example for programmatic focus use case.

## 2.18.0

### Changed

- Added `slds-modal__content_footless` class to example for clarity.
- Added clarifying notes around modal focus and header for accessibility, and modified Footless example to show tabindex.

## 2.17.0

### Added

- Added CSS Custom Property reassignments for variants and states.
- Added clarifying notes around modal focus for accessibility.
- Added `.slds-modal__content_headless` and `slds-modal__content_footless` classes for styling modal content.

### Changed

- Changed `header` and `footer` to generic `div` tags for better accessibility semantics.
- Changed assistive text for close buttons in modals, and added notes to accessibility documentation.
- Changed default header level from `h2` to `h1` for semantics and added more description around using headers in the Accessibility section.
- Removed redundant `title` attribute from modal close button.
- Updated use of `aria-describedby` attribute for modal content, and clarified in accessibility documentation section.
- Added the `role="presentation"` attribute to the modal backdrop.
- Moved `slds-modal__close` out of the modal header container and adjusted styles and annotations accordingly.
- Headless modal variant no longer requires `slds-modal__header` in the markup.

### Deprecated

- Deprecated older styles for previous markup of the `slds-modal__close` button.

## 2.14.0

### Added

- Added styling hooks for text color that let you set the `color` for the whole modal or a specific section.
- Added styling hooks for background color that let you set the `background-color` for the whole modal or a specific section.

### Fixed

- Fixed incorrect styling hooks on heading

## 2.13.3

### Fixed

- Fixed incorrect styling hooks on footer.

## 2.13.1

### Fixed

- Fixed issue where mobile text size wasn't accurately sized.
- Small improvements to the UI text.

## 2.13.0

### Added

- Enabled styling hooks for modal. See modal's styling hooks overview table for a full listing of the currently available hooks.

## 2.11.7

### Added

- Added documentation and examples for mobile/touch context

## 2.10.0

### Changed

- Changed `slds-modal_small` width to percentage-based to address the disparity of size relationship between `slds-modal_small` and other sized modals `slds-modal_medium` and `slds-modal_large`)
- Deprecated use of `slds-text-heading_medium` utility class on Modal title, added class `slds-modal__title` to declare styles for the Modal title.
- For touch devices:
  - Set font weight of Modal title to `$font-weight-bold`
  - Set tap target size of the Modal close button to `$height-tappable` (2.75rem)

<!-- ## [VERSION] -->
