|
| 1 | +{/* Copyright 2020 Adobe. All rights reserved. |
| 2 | +This file is licensed to you under the Apache License, Version 2.0 (the "License"); |
| 3 | +you may not use this file except in compliance with the License. You may obtain a copy |
| 4 | +of the License at http://www.apache.org/licenses/LICENSE-2.0 |
| 5 | +Unless required by applicable law or agreed to in writing, software distributed under |
| 6 | +the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS |
| 7 | +OF ANY KIND, either express or implied. See the License for the specific language |
| 8 | +governing permissions and limitations under the License. */} |
| 9 | + |
| 10 | +import {Layout} from '../../../src/Layout'; |
| 11 | +export default Layout; |
| 12 | + |
| 13 | +import docs from 'docs:@react-spectrum/s2'; |
| 14 | + |
| 15 | +export const section = ''; |
| 16 | +export const tags = ['release', 'S2']; |
| 17 | +export const date = 'November 22, 2024'; |
| 18 | +export const title = 'v0.5.0'; |
| 19 | +export const description = 'Version 0.5.0 includes major updates to Dialog and DialogTrigger APIs with four new dialog components: Dialog, FullscreenDialog, CustomDialog, and Popover. This release also improves style macro documentation and adds support for arbitrary pixel sizing.'; |
| 20 | + |
| 21 | +# v0.5.0 - November 22, 2024 |
| 22 | + |
| 23 | +Version 0.5.0 includes major updates to Dialog and DialogTrigger APIs with four new dialog components: Dialog, FullscreenDialog, CustomDialog, and Popover. This release also improves style macro documentation and adds support for arbitrary pixel sizing. |
| 24 | + |
| 25 | +In this release we have updated our Dialog and DialogTrigger APIs to improve layout flexibility for custom dialogs and popovers. Dialog has been split into four components: |
| 26 | + |
| 27 | +* [Dialog](../Dialog.html) – a modal dialog with a standard layout with slots for the heading, content, hero image, button group, etc. This corresponds to the previous `type="modal"` API. |
| 28 | +* [FullscreenDialog](../FullscreenDialog.html) – a fullscreen or takeover modal, similar to a Dialog but with different slots and layout. This corresponds to the previous `type="fullscreen"` and `type="fullscreenTakeover"` APIs. |
| 29 | +* [CustomDialog](../Dialog.html#custom-dialog) – a modal dialog with a completely custom layout. It can have default padding or go edge-to-edge. No built-in slots are provided, the layout is entirely up to you. |
| 30 | +* [Popover](../Popover.html) – Popovers no longer support the previous dialog-style layout, which was rarely needed in recent apps. In addition, popover now has a reduced amount of padding by default, which was a common request. |
| 31 | + |
| 32 | +In addition, several DialogTrigger props have moved to the above children: |
| 33 | + |
| 34 | +* `type` is removed. Use one of the above components instead. |
| 35 | +* `isKeyboardDismissDisabled` moved to Dialog, FullscreenDialog, and CustomDialog |
| 36 | +* `isDismissable` was renamed to `isDismissible` (fixed spelling), and moved to Dialog and CustomDialog |
| 37 | +* `hideArrow`, `offset`, `crossOffset`, `containerPadding`, `placement`, and `shouldFlip` moved to Popover |
| 38 | + |
| 39 | +We've also continued to iterate on developer experience based on your feedback. Documentation on style macro usage with regards to |
| 40 | +[colors](?path=/docs/style-macro--docs#colors) and [typography](?path=/docs/style-macro--docs#typography) have been added to help clarify |
| 41 | +these common use cases. Style macro properties like `width` and `height` now allow for arbitrary pixel size values, please see the [docs](?path=/docs/style-macro--docs#sizing) |
| 42 | +for more information. Finally, documentation on [optimizing CSS bundling](?path=/docs/style-macro--docs#css-optimization) have also been |
| 43 | +added to help you generate a properly optimized output when using the bundler of your choice. |
| 44 | + |
| 45 | +## New components |
| 46 | + |
| 47 | +* [ActionButtonGroup](../ActionButtonGroup.html) |
| 48 | +* [CloseButton](../Dialog.html#custom-dialog) |
| 49 | +* [CustomDialog](../Dialog.html#custom-dialog) |
| 50 | +* [FullscreenDialog](../FullscreenDialog.html) |
| 51 | +* [Popover](../Popover.html) |
| 52 | +* [ToggleButtonGroup](../ToggleButtonGroup.html) |
| 53 | + |
| 54 | +## Updates |
| 55 | + |
| 56 | +* [Accordion](../Accordion.html): Add support for adjacent sibling elements in header |
| 57 | +* [ActionButton](../ActionButton.html): Add support for Avatars in ActionButtons |
| 58 | +* [Dialog](../Dialog.html): See above for a summary of the changes to Dialog and Dialog adjacent components. |
| 59 | +* [Disclosure](../Disclosure.html): Add support for adjacent sibling elements in header |
| 60 | +* [DropZone](../DropZone.html): Add t-shirt sizing |
| 61 | +* [Menu](../Menu.html): Add support for separate user defined selection modes per MenuSection |
| 62 | +* [Meter](../Meter.html): Add label positioning support |
| 63 | +* Update Spectrum Tokens to v53 |
| 64 | +* Allow arbitrary pixel sizes for style macro sizing properties (e.g. width, height) |
| 65 | + |
| 66 | +## Codemods |
| 67 | + |
| 68 | +* Support Dialog updates |
| 69 | +* Support ActionGroup -> ActionButtonGroup/ToggleButtonGroup |
| 70 | +* Support arbitrary pixel sizing for style macro sizing properties |
| 71 | +* Update S1 to S2 icon mapping |
| 72 | + |
| 73 | +## Github release tag |
| 74 | + |
| 75 | +[Tag v0.5.0](https://github.com/adobe/react-spectrum/releases/tag/%40react-spectrum%2Fs2%400.5.0) |
0 commit comments