# SwiftUI updates Learn about important changes to SwiftUI. ## Overview Browse notable changes in . ## June 2026 ### General - Build your project in Xcode 27 or later so that the `@State` attribute uses the macro to create a state value in an , , or . This change only initializes and stores your property once when it’s a class. - Build your project in Xcode 27 or later to construct type-agnostic content from closures that you mark with , which serves as the unified replacement for type-specific builders like and . - Add reordering by drag-and-drop in containers such as lists, stacks, grids, or custom layouts with and . - Add custom swipe actions to views in containers such as scroll views, stacks, grids, or custom layouts using and . ### Transitions - Specify the transition to have a sheet appear by fading in over content. ### Images - Cache images locally that you download with , using , , , and . ### Toolbars - Use the modifier to prioritize important toolbar actions so SwiftUI keeps them visible as space shrinks, moving lower-priority items to the overflow menu first. - Send secondary toolbar actions, like archive or delete, directly to the overflow menu by wrapping them in a , keeping your primary toolbar focused on key actions. - Anchor a toolbar item to the trailing edge of the top bar using the placement so it stays in place even as other items shift or move to the overflow menu. - Control how toolbars minimize in response to scrolling using the modifier. ### Documents - Build document-based apps that read directly from a file URL by conforming your document class to , enabling access to large files and integration with URL-based frameworks. - Add write support to a URL-based document by also conforming to . - Implement custom reading and writing logic with and , or use and for simpler file-wrapper-based cases. - Access the document’s file URL and last modification date, and coordinate additional file access, using . - Export a to disk using the modifier. ### Tab bars - Set the role on a tab to place the tab in a separate, trailing position of the tab bar. ### Alerts and confirmation dialogs - Present an alert or confirmation dialog from an optional data item or error object, and use that data to produce the content and title: - - - - - - ### Gestures - Specify the sources of gesture input to recognize, such as direct or indirect touches, pencil, or pointer. The following gestures have initializers that you can use to specify the sources of gesture input: , , , , , , , , . For more information see . ## June 2025 ### General - Apply Liquid Glass effects to views using . - Use with the modifier to apply Liquid Glass to instances of `Button`. - creates a visual break between items in toolbars containing Liquid Glass. - Use to configure the scroll edge effect style for scroll views. - duplicates, mirrors, and blurs views placed around edges with available safe areas. - Set behavior for tab bar minimization with . - Set the role on a tab to take someone to a search tab and have a search field take the place of the tab bar. - Adjust the content of accessory views based on the placement in a tab view with . - Connect a with a to fully control the browsing experience in your app. - Drag multiple items using the modifier. Make a view a container for draggable views using the modifier. - Use the macro to have SwiftUI synthesize custom animatable data properties. - now supports tick marks. Tick marks appear automatically when initializing a `Slider` with the `step` parameter. - Use to set the window anchor point when a window must resize. ### Text - now supports . - Handle text selection with attributed text using . - defines how text can be styled in specific contexts. - Use to create a find navigator in views that support text editing. ### Accessibility - Support Assistive Access in iOS and iPadOS scenes with . ### HDR - is a set of RGBA values that represent a color that can be shown, including HDR headroom information. ### UIKit and AppKit integration - Host and present SwiftUI scenes in UIKit with and in AppKit with . - Incorporate gesture recognizers in SwiftUI views from AppKit with . ### Immersive spaces - Manipulate views using common hand gestures with . - Snap volumes to horizontal surfaces and windows to vertical surfaces using . - Use to render stereo content from your Mac app on Apple Vision Pro. - Use to create a layout container that aligns overlapping content in 3D space. - Depth-based variants of modifiers allow easier volumetric layouts in SwiftUI. For example, , , and . ## June 2024 ### Volumes - Specify the alignment of a volume when moved in the world using the scene modifier. - Specify the default world scaling behavior of your scene using the scene modifier. - Adjust the visibilty of a volume’s baseplate using the view modifier. - Define a custom action to execute when the viewpoint of a volume changes using the view modifier. ### Windows - Change the default initial size and position of a window using the modifier. - Change the default behavior for how windows behave when performing a zoom using and provide the placement for the zoomed window with the modifier. - Create utility windows in SwiftUI using the new scene type and toggle the window’s visibility using the . - Customize the style of a window using the new container background placement, the view modifier, and the window style. - Set the default launch behavior for a scene using the modifier. - Replace one scene with another using the method. ### Immersive spaces - Add an action to perform when the state of the immersion changes using the modifier. - Apply a custom color or dim a passthrough video in an immersive space using the and initializers. ### Documents - Customize the launch experience of document-based applications using and . ### Navigation - Specify the appearance and interaction of with the modifier using values like , , and . - Build hierarchy by nesting tabs as a tab item within . - Enable people to customize a using the modifier and persist customization state in with . ### Modal presentations - Use built-in presentation sizes for sheets like or with the modifier or create custom sized sheets using the protocol. ### Toolbars - Specify the display mode of toolbars in macOS using the type. - Configure the foreground style in the toolbar environment in watchOS using the view modifier. - Anchor ornaments relative to the depth of your volume — in addition to the height and width — using the method that takes a . ### Views - Create custom container views like , , and using new and initializers, like and , respectively. - Declare a custom container value by defining a key that conforms to the protocol, and set the container value for a view using the modifier. - Create , , , and entries by using the macro to the variable declaration. ### Animation - Customize the transition when pushing a view onto a navigation stack or presenting a view with the view modifier. - Add new symbols effects and configurations like , , and using the modifier. ### Text input and output - Add text suggestions support to any text field using and view modifiers. - Access and modify selected text using a new binding for and . - Bind to the focus state of an app’s search field using the view modifier. ### Drawing and graphics - Precompile shaders at build time using the method. - Create mesh gradients with a grid of points and colors using the new type. - Extend SwiftUI Text views with custom rendering effects and interaction behaviors using , , and . - Create a new by mixing two colors using the method. ### Layout - Enable custom spacing between views in a along the depth axis with the initializer. ### Scrolling - Scroll to a view, offset, or edge in a scroll view using the view modifier and specifying one of the values. - Limit the number of views that can be scrolled by a single interaction using the limit behavior value or . - Add an action to be called when a view crosses a provided threshold using the modifier. - Access both the old and new values when a scroll view’s phase changes by using the modifier. ### Gestures - Conditionally disable a gesture using the `isEnabled` parameter in a modifier like . - Create extra drag areas of a window in macOS when you add a gesture. - Create a hand gesture shortcut for Double Tap in watchOS using the structure. - Enable whether gestures can handle events that activate the containing window using the view modifier. ### Input events - Create a group of hover effects that activate together using and apply them to a view using the view modifier. - Customize the appearance of the system pointer in macOS, iPadOS, and visionOS with new pointer styles using or the visibility with the modifier. - Access keyboard modifier flags using the . - Replace the primary view with one or more alternative views when pressing a specified set of modifier keys using the view modifier. - Enable the hand pointer for custom drawing and markup applications using the modifier. ### Previews in Xcode - Write dynamic properties inline in previews using the new macro. - Inject shared environment objects, model containers, or other dependencies into previews using the protocol. ### Accessibility - Specify that your accessibility element behaves as a tab bar using the accessibility trait with the modifier. In UIKit, use . - Generate a localized description of a color in a string interpolation by adding `accessibilityName:`, such as `"\(accessibilityName: myColor)"`. Pass that string to any accessibility modifier. ### Framework interoperability - Reuse existing UIKit gesture recognizer code in SwiftUI. In SwiftUI, create UIKit gesture recognizers using . In UIKit, refer to SwiftUI gestures by name using . - Share menu content definitions between SwiftUI and AppKit by using the in your AppKit view hierarchy. --- ## June 2023, visionOS ### Scenes - Create a volume that can display 3D models by applying the window style to an app’s window. - Make use of a Full Space by opening an scene. You can use the immersion style to place objects in a person’s surroundings, or the style to completely control the visual experience. - Display 3D models in a volume or a Full Space using RealityKit entities that you load with that framework’s or structure. ### Toolbars and ornaments - Display a toolbar item in an ornament using the toolbar item placement. - Add an ornament to a window directly using the view modifier. ### Drawing and graphics - Detect view geometry in three dimensions using a . - Add a 3D visual effect using the view modifier. - Rotate or scale in three dimensions with view modifiers like and , respectively. - Convert between display points and physical distances using a . ### View configuration - Add a glass background effect to a view using the view modifier. - Dim passthrough when appropriate by applying a modifier. ### View layout - Make 3D adjustments to layout with view modifiers like , , and . ### Gestures - Enable people to rotate objects in three dimensions when you add a gesture. --- ## June 2023 ### Scenes - Close windows by their identifier using the action stored in the environment. - Enable people to open a settings window by presenting a button. ### Navigation - Control views of a navigation split view or stack using a new overload of the view modifier. - Manage column visibility of a navigation split view using new overloads of the view’s initializer, like . ### Modal presentations - Use new overloads of the file export, import, and move modifiers, like , to access new file management features. For example, you can: - Configure a file import or export dialog to open on a default directory, enable only certain file types, display hidden files, and so on. - Retain file interface configuration that a person chooses from one presentation to the next. - Export types that conform to the protocol. - Specify a dialog severity using the view modifier. - Provide a custom icon for a dialog using the modifier. - Enable people to suppress dialogs using one of the dialog suppression modifiers, like . ### Toolbars - Configure the toolbar title display size using the modifier. ### Search - Present search programmatically using a binding to a new `isPresented` parameter available in some searchable view modifiers, like . - Create mutable search tokens by providing a binding to the input of the `token` closure in the applicable searchable view modifiers, like . ### Data and storage - Bridge between SwiftUI environment keys and UIKit traits more easily using the protocol. - Get better performance when you share data throughout your app by using the new macro. - Access both the old and new values of a value that changes when processing the completion closure of the view modifier. ### Views - Display a standard interface when a resource, like search results or a network connection, isn’t available using the view type. - Display a standard inspector interface with a platform-appropriate appearance by applying the modifier. ### Animation - Perform an action when an animation completes by specifying a completion closure to the view modifier. - Define custom animation behaviors by creating a type that conforms to the protocol. - Perform animations that progress through predefined phases using the structure, or according to a set of time-based keyframes by using the protocol. - Specify information about a change in state — for example, to request a particular animation — using custom instances. - Design custom animation curves using . - Apply streamlined spring parameters, now standardized across all Apple frameworks, using the new animation. You can also use the structure as a convenience to represent a spring’s motion. ### Text input and output - Indicate the language that appears in a specific view so that SwiftUI can help to avoid clipping and collision of text, and perform proper line breaking and hyphenation using the view modifier. - Scale text semantically, for example by labeling it as having a secondary text scale, using the modifier. ### Shapes - Apply more than one or modifier to a single . - Apply Boolean operations to both shapes and paths, like and . - Use predefined shape styles, like , to simplify your code. - Create rounded rectangles with uneven corners using . ### Drawing and graphics - Create fully customizable, high-performance graphics by drawing with Metal shaders inside a SwiftUI app using a structure. - Configure an image with a specific dynamic range by applying the view modifier. - Compose effects that you apply to a view based on some aspect of the geometry of the view using the modifier. For example, you can apply a blur that varies depending on the view’s position in the display. ### Layout - Define custom coordinate spaces using the with new methods, like and , to get the dimensions of containers. - Create a frame for a view that lays out its content based on characteristics of the container view using . - Set the background of a container view using the view modifier. ### Lists and tables - Disable selectability of an item in a or by applying the modifier. - Collapse or expand a of a list or table using the `isExpanded` binding in the section’s initializer. - Configure row or section spacing using the and modifiers, respectively. - Set the prominence of a badge using the view modifier. - Configure alternating row backgrounds using the modifier. - Customize table column visibility and reordering using the structure. - Add hierarchical rows to a table using the structure, or recursively hierarchical rows using the structure. - Hide table column headers using the modifier. ### Scrolling - Read the position of a scroll view using one of the scroll position modifiers, like . - Flash scroll indicators programmatically using a view modifier, like . - Clip scroll views in custom ways after disabling default clipping using the modifier. - Create paged scroll views, aligned to either page or view boundaries, using the view modifier. - Create custom scroll behaviors using the protocol. - Control the insets of scrollable views using the and view modifiers. - Add effects to views as they scroll on- and offscreen using one of the modifiers. - Create a that supports vertical paging in watchOS by applying the tab view style. ### Gestures - Make smoother transitions between gestures and animations by using a new property on the values associated with certain gestures and a property on . - Gain access to more information, including both velocity and position, by migrating to the new and , which replace the now deprecated `MagnificationGesture` and `RotationGesture`. ### Input events - Enable a view that’s in focus to react directly to keyboard input by applying one of the view modifiers. - Enable people to choose from a compact collection of items in a by styling a with the style. - Provide haptic or audio feedback in response to an event using one of the sensory feedback modifiers, like . - Create buttons and toggles that perform an in a widget, Live Activity, and other places using new initializers like and . ### Focus - Distinguish between views for which focus serves different purposes, such as those that have a primary action like a button and those that take input like a text field, using the new view modifier. - Manage the effect that receiving focus has on a view using the modifier. ### Previews in Xcode - Reduce the amount of boilerplate that you need to create Xcode previews by using the new macro. --- Copyright © 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)