Changelog
All notable changes to this package will be documented in this file.
The format is based on Keep a Changelog and this project adheres to Semantic Versioning.
[1.3.3] - 2025-12-10
Fixed
- Fixed columns size and added more info in Storybook window.
- Fixed the AppUI settings assets search and auto-assignation before building a project.
- Fixed code path activation for native plugins depending on target platform
Added
- Added support of CoreCLR for the migration from Mono scripting backend for Unity 6.5+
[2.1.3] - 2025-12-10
Fixed
- Fixed the AppUI settings assets search and auto-assignation before building a project.
- Fixed columns size and added more info in Storybook window.
- Fixed
VisualElementExtensions.IsOnScreenmethod which gave wrong results in world-space panels. - Fixed code path activation for native plugins depending on target platform
Added
- Added support of CoreCLR for the migration from Mono scripting backend for Unity 6.5+
[2.0.2] - 2025-12-10
Fixed
- Fixed the AppUI settings assets search and auto-assignation before building a project.
- Fixed columns size and added more info in Storybook window.
- Fixed
VisualElementExtensions.IsOnScreenmethod which gave wrong results in world-space panels. - Fixed code path activation for native plugins depending on target platform
Added
- Added support of CoreCLR for the migration from Mono scripting backend for Unity 6.5+
[2.2.0-pre.3] - 2025-12-09
Added
- A reference of the latest opened StyleSheet in IconBrowser tool is now stored per project. The next time you will open the tool, it will reload the latest StyleSheet.
- Added support of CoreCLR for the migration from Mono scripting backend for Unity 6.5+
Fixed
- Fixed the AppUI settings assets search and auto-assignation before building a project.
- Fixed columns size and added more info in Storybook window.
- Fixed
VisualElementExtensions.IsOnScreenmethod which gave wrong result in world-space panels. - Fixed code path activation for native plugins depending on target platform
[2.0.1] - 2025-11-17
Fixed
- Added
CreatePropertyattribute to generated command properties for Unity 2023.2+ to enable Unity Properties Serialization support in the MVVM CommandGenerator.
[2.1.2] - 2025-11-13
Fixed
- Added
CreatePropertyattribute to generated command properties for Unity 2023.2+ to enable Unity Properties Serialization support in the MVVM CommandGenerator.
[1.3.2] - 2025-11-07
Fixed
- Added
CreatePropertyattribute to generated command properties for Unity 2023.2+ to enable Unity Properties Serialization support in the MVVM CommandGenerator. - Fixed Source Generators culture for Turkish region.
[2.2.0-pre.2] - 2025-11-06
Fixed
- Fixed runtime bindings for
DateFieldandDateRangeFieldvalueproperty. - Added
CreatePropertyattribute to generated command properties for Unity 2023.2+ to enable Unity Properties Serialization support in the MVVM CommandGenerator.
Added
- Added support for the new EntityId API in Unity 6000.3.0a1 and newer.
[2.2.0-pre.1] - 2025-08-31
Added
- Added Conditional Resolution in Dependency Injection system.
- Added documentation about getting started using UI Builder.
Fixed
- Fixed an issue when trying to dismiss ColorPicker popup consecutively from ColorField
- Fixed coordinates conversion in AnchorPopupUtils.ComputePosition method
[2.1.1] - 2025-08-01
Fixed
- Fixed label of the blue channel slider in the ColorPicker
- Fixed hiding Alpha channel label in
ColorPickerwhenshowAlphais set tofalse.
[2.1.1-pre.1] - 2025-07-30
Fixed
- Fixed label of the blue channel slider in the ColorPicker
- Fixed hiding Alpha channel label in
ColorPickerwhenshowAlphais set tofalse.
[2.1.0] - 2025-07-26
Added
- Added input field text selection context menu to cut/copy/paste the currently selected text (starting Unity 2023.1).
- Added EyeDropper system (runtime-only) to pick a color in the last game frame.
- Added
goToStrategyproperty inSwipeViewcomponent to choose howGoTomethod should behave regarding animation direction.
Fixed
- Fixed some Icons that had white horizontal or vertical borders.
- fix: Add missing InsideTopLeft case in ComputePosition switch statement
- Fixed App UI Settings registration in EditorBuildSettings.
- fix: Add tip/arrow placement logic for Inside* popover placements
- Fixed event propagation bug in
Pressablewhich sent the wrong pointer position value to ancestors whenkeepEventPropagationwastrue. - Fixed GTK initialization on Linux platform when checking if any windowing system is available.
[2.1.0-pre.3] - 2025-07-23
Fixed
- Fixed GTK initialization on Linux platform when checking if any windowing system is available.
[1.3.1] - 2025-07-21
Removed
- Removed warning messages about using obsolete code.
[2.1.0-pre.2] - 2025-07-11
Fixed
- Fixed some Icons that had white horizontal or vertical borders.
[2.1.0-pre.1] - 2025-07-11
Added
- Added input field text selection context menu to cut/copy/paste the currently selected text (starting Unity 2023.1).
- Added EyeDropper system (runtime-only) to pick a color in the last game frame.
- Added
goToStrategyproperty inSwipeViewcomponent to choose howGoTomethod should behave regarding animation direction.
Fixed
- fix: Add missing InsideTopLeft case in ComputePosition switch statement
- Fixed App UI Settings registration in EditorBuildSettings.
- fix: Add tip/arrow placement logic for Inside* popover placements
- Fixed event propagation bug in
Pressablewhich sent the wrong pointer position value to ancestors whenkeepEventPropagationwastrue.
[2.0.0] - 2025-06-25
Removed
- Removed
Unity.AppUI.Core.AppUI.DismissAnyPopupsmethod. Popups are now registered perPanelelement. - Removed
Canvas.scrollDirectionproperty in order to support correctly the scroll direction set in the Operating System's preferences. - Removed programatic construction of RadioGroup with IList object. Since App UI offers the possibility to have Radio component as deep as you want in the visual tree compared to its RadioGroup ancestor, we wanted to limit conflicts between construction kinds.
- TextFieldExtensions.BlinkingCursor extension method has become obsolete. Please use the new BlinkingCursor manipulator instead.
- Removed intrusive Debug.Log calls from Platform class on Windows platform.
- Removed warning message when using Single selection type in an overflown ActionGroup.
- Removed EventBaseExtensionsBridge class
- [Canvas] Removed applying cursor styles during pointer events as it was too costly in terms of performance.
- Removed the Popup message Handler that was used to dispatch the display or dismissal of Popups. While this removes thread safety, it fixes issues with ordering of events to dismiss popups.
Changed
- Refactored SliderBase and BaseSlider for performance improvements and better features. The RangeSliderBase class has been removed and RangeSliderFloat/RangeSliderInt are now derived from SliderBase directly.
- The
Platform,AppUIInputandGestureRecognizerclasses now use pre-allocated buffers to deal with Touch events in a single frame, and expects aReadOnlySpan<AppUITouch>type to work with instead ofAppUITouch[]. - Refactored switch statement builder for Redux slice construction.
- The
NavDestinationnode now uses aNavDestinationTemplateas a delegate to create and set up aINavigationScreenwhen reaching this destination. - Subscribing to a Redux Store returns a
IDisposableSubscriptionobject instead of a method. You can dispose it by calling itsDisposemethod. - Changed DialogTrigger.keyboardDismissDisabled to DialogTrigger.keyboardDismissEnabled for consistency.
- Make Host optional when intializing an
Appimplementation. - Renamed
IUIToolkitApp.mainPageproperty intoIUIToolkitApp.rootVisualElementfor more clarity. - Moved
NavDestinationspecific settings such asshowAppBarinside the newDefaultNavDestinationTemplate. - Replaced ClickEvent action in MenuItem builder by an EventBase action
- Refactored completely the DropZone UI element. Now the DropZone doesn't embed any logic, but uses a
DropZoneControllerinstead. You can access this controller viaDropZone.controllerproperty and attaches a callback method to accept dragged objects and listens to drop events. - Changed
ticksrelated properties in Slider components with a newmarksproperty. To configure marks you can you the newstepproperty or directly set yourcustomMarks - Changed StoryBookEnumProperty class to become a generic type. You need to specify the Enum type as typedef parameter.
- Refactored Redux API fore more flexibility. See the migration guide in the package documentation.
- Renamed Popup.parentView to Popup.containerView for more clarity.
- Complete rewrite of the SplitView component. The SplitView is no more a derived from TwoPaneSplitView from UI-Toolkit, but a full custom component that supports any number of panes.
- Scrollable manipulator now stops the propagation of WheelEvent. This affects only the Drawer and SwipeView elements.
- Defer checking Popup's container candidate when the Popup is about to be shown, instead of during Popup creation.
- Use
resolvedStyle.translateinstead oftransform.positionto move elements such as theCanvascontainer. - Changed DropZoneController to support any VisualElement as target instead of a DropZone element.
- Changed the Text element inside the ColorField to become a selectable text.
- Others assembly modules such as
Redux,MVVMandNavigationhas been configured to be auto-referenced in the Unity project's assemblies. - Refactored every native plugin provided by the package.
- Updated App UI Native plugins for MacOS and iOS.
- Refactored the styling of Chip UI element.
- Moved Toast animation logic from code to USS.
- Changed the Trackpad sample project to work properly with the new events coming from the new Gesture Recognizer System.
- Refactored the SwipeView element logic, without impacting the public API.
- The
RadioGroupcomponent uses astringtype for itsvalueproperty. This string value is equal to the currently checkedRadiocomponent'skeyproperty. - The
Toast.AddActionmethod will now ask for a callback that takes aToastobject as argument (instead of no argument at all). This will give you an easier way to dismiss the toast from the action callback. - You can now pass an
autoDismissargument to theToast.AddActionmethod. This will automatically dismiss the toast when the action is triggered. This argument is optional and defaults totruefor backward compatibility. - Rewrite of App UI shaders in pure
HLSLinstead of legacyCGlanguage. - Changed MemoryUtils.Concatenate implementation to not use variadic parameters and avoid implicit allocations.
- Replaced the MacOS native plugin by a
.dyliblibrary instead of a.bundleone. - App UI shaders are now optionally embedded in Player builds. You can change this setting in your main App UI settings instance. The default value is
true. - Storybook stories are now sorted alphabetically.
- Upgraded the old Drag And Drop Sample to use the refactored DropZone and the new Drag And Drop system.
- Renamed
Create/App UI/Settingsmenu item intoCreate/App UI/App UI Settings - Changed the way MarkDirtyRepaint is scheduled on elements containing animated textures (check properly for visibility).
- Replaced the dropdown with an ObjectField to pick an available App UI settings asset.
- The Canvas now uses
Experimental.Animationsystem from UI-Toolkit for its damping effect when releasing the mouse with some velocity. That replaces the previous implementation that was using theVisualElementScheduledItem. - Changed fade in animation in Tooltip to use USS transitions.
- Changed the styling of primary action buttons in AlertDialog UI element.
- Changed the Context API to propagate contexts over internal components hierarchies and not just the high-level hierarchy (via
contentContainer). - Refactored the
FindResponderInChainnative method in MacOS platform to avoid undefined behaviours. - Refactored the styling of DropZone UI element.
CircularProgressandLinearProgresselements withIndeterminatevariant won't be marked asDirtyRepaintif they are off-screen anymore.- Refactored the dispatch process of Redux AsyncThunk.
Added
- Added
scaleproperty on slider components to support custom non-linear scaling of displayed values in the UI. - Added the support of inverted track progress in slider components.
- Added MaskField UI component.
- Added support of Selectors for subscribing to state changes in Redux implementation.
- Added support of UITK Runtime DataBinding system in ObervableObject class.
- Added Redux Debugging tool.
- Added a default implementation of
NavDestinationTemplatenamedDefaultNavDestinationTemplatewhich handles the creation of defaultNavigationScreenobjects. - Added the support
stringkey in Context API to identify a Context not only byt its type. This will give the ability to provide and propagate contexts of the same type but with different keys. - Added
formatFunctionalong withformatStringand grouped them into a newIFormattable<TValueType>interface. TheformatFunctionwill give you the possibility to customize entirely the string formatted value of a givenTValueType. - Added a
RestrictedValuePolicyon slider components where you can choose if the slider can take a value related to thesteporcustomMarkswith modifier keys or not. - Added support of Enhancers and Middlewares in Redux implementation.
- Navigation: Added
NavigationRailcomponent which can be used inside NavigationScreen views. - Added AsyncThunk support for Redux implementation.
- Added the
Unity.AppUI.UI.DropZoneControllerManipulator for a lower level approach to create your own "drop zones". - Added support of Attributes on fields and properties in the Dependency Injection system.
- Added Anchor Position support for Toast UI elements.
- Added
IApp.servicesproperty which returns the currentIServiceProvideravailable for this instance ofIApp. Thanks to this property you should be able to load a service from anywhere in your application by callingApp.current.services. - Added
PinchGestureRecognizerimplementation for the new Gesture Recognizer System. - Added
LangContext.GetLocalizedStringAsyncFuncto delegate the localization operation to a user-defined function. - Added
justifiedproperty on Tabs component to jusitfy tabs layout in horizontal direction. VisualElementExtensions.HasAncestorsOfType{T}method to verify if an element as any ancestor of a specific type.- Added
IInitializableComponentinterface toIAppinterface. Now when initializing a MVVMAppobject, the relatedAppBuilderwill callapp.InitializeComponentbefore hosting. - Added
editorOnlysetting in App UI's Settings panel. Enabling EditorOnly mode will add a scripting define symbol that will prevent App UI assemblies to get compiled for runtime builds. This can be useful to work in Editor only UI and avoid increasing the footprint of your builds. - Added
--appui-splitview-splitter-anchor-sizedesign token. Added Unity.AppUI.Core.DragAndDropclass to handle drag and drop (in-panel and/or with the Editor). The support of external drag and drop at runtime is planned for future releases.- Added the
keystring property onRadiocomponent to be used as unique identifier in their group. - Added PanAndZoom Manipulator
- Added
EnumFieldUI component. - Added the serialzation of last selected indices in Storybook window to save and restore selection.
- Added support of UnityEditor ColorPicker in ColorField component.
- Added
DatePicker,DateRangePicker,DateFieldandDateRangeFieldcomponents. Theses components use the newDateandDateRangedata structure also provided by App UI. - Added Modal.outsideClickDismissEnabled and Modal.outsideClickStrategy properties to support dismissing Modals by clicking outside of them.
- Added
VisualElementExtensions.SetTooltipContentmethod to populate a tooltip template with new content. - Added
orientationproperty on slider components, to support vertical sliders. - Added
RegisterUpdateCallbackto register a callback on VisualElement that needs to be notified when App UI's main loop has done a new iteration. - Added support of
ICommandinPressablemanipulator. - Added CircularProgress story in Storybook sample.
- Added AlertDialog icon Design Tokens to customize icons directly from USS.
- Added ActionBar story in Storybook sample.
- Added scoped service provider implementation.
- Added support of Color without alpha information in ColorField and ColorPicker.
- Added
rounded-progress-cornersboolean property inCircularProgressandLinearProgressto be able to disable rounded corners. - Added
SelectedLocaleListenermanipulator that reacts to Localization Package's SelectedLocale changes in order to provide a newLangContextin the visual tree. - Added the support of App UI settings asset file from packages. If there's no persistent App UI settings asset defined for your project, App UI Manager will try to find one not only in the Project assets but also in Packages. You can always switch between settings via the Project Settings > App UI settings pane.
- Added
Unity.AppUI.UI.Chip.deletedWithEventInfoandUnity.AppUI.UI.Chip.clickedWithEventInfoevents. - Added
trailing-iconproperty inActionButtoncomponent. - Added
damping-effect-durationproperty in Canvas element. The default value is 750ms. - Added an experimental method
Platform.GetSystemColorto fetch color values defined by the Operating System for specific UI element types. This can be useful if you want to precisely follow the color palette of a high-contrast theme directed by the OS. - Added
MasonryGridViewcomponent. - Added
autoShrinkproperty to theTextAreacomponent to automatically shrink the component when the text fits in a smaller area. You need to setautoResizeproperty totrueto use the shrinking feature. - Added customization support for the size of the Color swatch inside the ColorField.
- Added
VisualElementExtensions.GetLastAncestorOfType{T}method to retrieve the last ancestor of a specific type in the tree. - Added AlertDialog examples in the UI Kit sample.
- Added "Icon Browser", a new Editor tool that enables users to generate UI-Toolkit stylesheets with a specific list of icons.
- Added a new experimental Gesture Recognizer System.
- Added the ability to subscribe and check if the current operating system is in Reduce-Motion Accessibility Mode (Windows/Mac/Android/iOS).
- Added the ability to subscribe and check if the current Text Scale Factor of the currently used window (Unity Player window or the Game view window in the Editor) (Windows/Mac/Android/iOS).
- Added Phosphor Icons
- Added
VisualElementExtensions.IsOnScreenmethod to determine if aVisualElementis on-screen or off-screen. - Added
ResizeHandlecomponent. This special component can be added to your layout to resize a giventargetwhen dragging it. This component is currently used in the new resizablePopoverelement. - Added
resizableandresizableDirectionproperties inPopoverclass. You are now able to resize aPopoverusing the bottom-right corner of the popover pane. A resizable Popover will not be repositionned. - Added
VisualElementExtensions.EnableDynamicTransformmethod to set/unset theUsageHints.DynamicTransformflag in your element's usageHints. - Added the ability to subscribe and check if the current operating system is in High-Contrast Mode (Windows/Mac/Android/iOS).
- Added
IsContextClick()extension method for PointerEvent. - Added runtime binding support for commands in
Pressableviaclickable.commandproperty in most interactable UI elements. - Added
RectExtensions.Approximatelymethod to verify if two Rect object are approximately the same. - Added Clipboard handling support for UTF8 Text and PNG format on iOS, Windows, macOS, and Linux platforms. Please refer to the Native Integration documentation page for more information.
- Added support of Localization package in the Storybook window. You can now change the current used Locale in the window via a dropdown in the Storybook context toolbar. This dropdown will appear only if you have the Unity Localization package installed and have at least one existing Locale set up in your Localiztion settings.
- Added the ability to subscribe and check if the current operating system is in LeftToRight or RightToLeft layout direction (Windows/Mac/Android/iOS).
- Added
INavigationScreeninterface, more extensible than the base classNavigationScreen. - Added
leadingContainerandleadingContentTemplateproperties to theAccordionItemelement. - Popup elements such as
Popover,ModalorMenuBuildernow get their view'suserDatafilled with thePopupinstance itself. This way you can retrieve information about thePopupinstance that created this popup element from within the visual tree. - Added the ability to subscribe and check if the current Scale Factor of the currently used window (Unity Player window or the Game view window in the Editor) (Windows/Mac/Android/iOS).
- Added
showExpandButtonsproperty to theSplitViewUI element. - Added Popup
.SetContainerView method to set a custom container which will be the parent of the popup's view. - Added Source Generators for MVVM module. Source Generators helps to get rid of boilerplate code and focus on business logic.
- Added
NavHost.makeScreenproperty. By setting your own callback to this property, you will be able to customize the way to instantiate aNavigationScreenwhen navigating to a new destination. This can be useful when coupled to Dependency Injection so you can retreive instances of your screens from aIServiceProvider. By default, the property is set with the use ofSystem.Activator.CreateInstance. - Added
indicatorPositionproperty inAccordionItemcomponent, in order to swap the indicator position either at start or end of the heading row. - Added tests for Pan and Magnify gesture data structures.
- Made
AnchorPopup.GetMovableElementmethod public for easier access and increase customization possibilities. - Added new Story in the Drag And Drop sample.
- Added support of graceful fallback to lambda
Plafformimplementation if native plugins can not be loaded by the current plaftorm. - Added
PreserveAttributeon certain constructor that are only called viaActivatorreflection class. - Added arrow-square-in icon.
- Added USS custom properties to choose the font style of AccordionItem header and TabItem text.
- Added a search bar and "Save as" button in the Icon Browser window.
- Added the ability to subscribe and check if the current operating system is in Dark Mode (Windows/Mac/Android/iOS).
- Added some warning messages (Standalone builds only) when a LocalizedTextElement value cannot be localized.
- Added a safety check in TooltipManipulator to ensure the anchor element of the scheduled tooltip is still valid (not invisible) when it is time to animate in the tooltip.
- Added monitoring of key press events in the TooltipManipulator in order to dismiss any existing tooltip when the user interacts with the keyboard.
- Added
checkregular icon as a required icon in App UI themes. - Added support of
TextElement.displayTooltipWhenElidedto show elided text as a tooltip using the App UI tooltip system. - Added unit tests for MemoryUtils utility class.
Fixed
- Fixed the wrap system of the SwipeView element when swiping between elements quickly.
- Fixed tooltip that weren't showing up anymore since last pre-release.
- Fixed backgrounds color of the input fields.
- Fixed pinch gesture recognition sensitivity.
- Fixed styling of MenuItem element
- Fixed TouchSlider progress element overlapping parent's borders.
- Fixed reset of Dropdown value when changing its source items.
- Fixed the merge of default and new
Argumentobjects during navigation to aNavDestination. - Fixed
VisualElementExtensions.IsInvisiblemethod to check recursively in ancestors if any element is considered as invisible. - Fixed compilation errors when the Unity project's Input Handling is set to
BothorNew Input Systemand the packagecom.unity.inputsystemis not installed. - Fixed Daisy chaining window procedures on Windows platform.
- Fixed Action Dispatch to every Slice Reducers
- Every shared libraries of native plugins are now correctly signed with the correct Unity Technologies certificate (MacOS and Windows only)
- Fixed styling issues in
ActionButtoncomponent. - Fixed random segmentation fault on MacOS platform which appeared after domain reloads.
- Fixed meta files for native plugins on Windows platform.
- Fixed force mark as dirty repaint Progress UI element when swtiching its variant.
- Fixed some SplitView styling issues when nesting SplitViews in a visual tree.
- Fixed "Shape" icon.
- Fixed drag events in drag and drop samples to disable the Dropzone when leaving the Editor window.
- Fixed Dark Gray 1200 color value in Design Tokens for Editor-Dark theme.
- Fixed a visual bug where the checkmark symbol didn't appear on DropdownItem or MenuItem that have a
selectedstate. - Fixed Menu's backdrop to block pointer events
- Fixed a bug where
Popoverelements were not correctly anchored in Unity versions older than 6. - Added one frame delay before processing Popover dismissal.
- Fixed calling
shownevent callbacks when aModalis displayed. - Fixed usage of AppCompat theme for AppUI GameActivity on Android platform.
- Fixed MacOS native plugin memory leak when opening the Help menu in the Editor.
- Fixed Tabs emphasized color in Editor-light theme.
- Fixed notify property changes for Picker.selectedIndex.
- Fixed text cursor for selectable text elements such as TextArea.
- Fixed an edge case when popovers are dismissed as OutOfBounds as soon as Show() is called.
- Fixed some namespace usage to avoid relative ones.
- Fixed IL2CPP Compilation errors on Windows Platform due to non-static MonoPInvokeCallback.
- Fixed Localization support in the ActionBar UI element.
- Fixed path resolution of Stylesheets coming from Packages in Icon Browser tool.
- Invoke click event only if Pressable is still hovered.
- Fixed PInvoke delegate types on Windows platform.
- Fixed ColorField styling issues.
- Use correct color variables for Radio and Checkbox components
- Use
RenderTexture.GetTemporaryinstead ofnew RenderTextureto optimize RT allocations, especially on tile-based renderers such as mobile platforms. - Fixed an exception thrown when trying to update UXML schemas in the Editor.
- Removed force blurring the BaseSlider (SliderFloat, TouchSliderFloat, etc) when the users stops interacting with it.
- Fixed border color variable for AccordionItem.
- Fixed warnings related to Dialog styling.
- Register trickledown events for popups on the first child of the visual tree root element instead of the root element itself to avoid leaks.
- Fixed styling of SplitView's Splitter Anchor size.
- Fixed a regression where components using
Pressablemanipulator will not able to be clicked more than once if the cursor doesn't leave the component's layout rect. - Fixed context propoagation per key
- Fixed styling of BaseGridView when containing a single column.
- Popovers and Modals now correctly start checking for PointerDown events in the visual tree when they become visible.
- Prevent GC to collect Platform configuration to not break communication with native plugins (MacOS and iOS).
- Fixed NullReferenceException thrown when fetching Localization tables.
- Removed console message when trying to add an Editor MonoBehaviour in the scene during PlayMode.
- Fixed Screen Height calculation. UITK does not use Camera rect but blit on the whole screen instead.
- Fixed
InvalidOperationExceptionthrown by the damping effect animation of theCanvascomponent. - Fixed CultureInfo used during source code generation.
- Fixed support of Radio component that are deeper than the direct child of a RadioGroup.
- Fixed styling of emphasized checkboxes.
- Fixed an exception thrown when dismiss any popup of a panel when this panel becomes out of focus.
- Fixed the calculation of off-screen items in SwipeView with vertical direction.
- Fixed an early return in the PreProcessBuild callback of App UI when no persistent AppUISettings have been found.
- Fixed a bug where tooltips stop being shown when the window is docked/undocked.
[2.0.0-pre.22] - 2025-06-18
Added
- Added support of
ICommandinPressablemanipulator. - Added runtime binding support for commands in
Pressableviaclickable.commandproperty in most interactable UI elements.
[2.0.0-pre.21] - 2025-06-13
Changed
- The
NavDestinationnode now uses aNavDestinationTemplateas a delegate to create and set up aINavigationScreenwhen reaching this destination. - Moved
NavDestinationspecific settings such asshowAppBarinside the newDefaultNavDestinationTemplate.
Added
- Added a default implementation of
NavDestinationTemplatenamedDefaultNavDestinationTemplatewhich handles the creation of defaultNavigationScreenobjects. - Added
INavigationScreeninterface, more extensible than the base classNavigationScreen.
[2.0.0-pre.20] - 2025-06-11
Removed
- Removed
Canvas.scrollDirectionproperty in order to support correctly the scroll direction set in the Operating System's preferences.
Fixed
- Fixed tooltip that weren't showing up anymore since last pre-release.
- Fixed
VisualElementExtensions.IsInvisiblemethod to check recursively in ancestors if any element is considered as invisible.
Changed
- Use
resolvedStyle.translateinstead oftransform.positionto move elements such as theCanvascontainer. - Replaced the dropdown with an ObjectField to pick an available App UI settings asset.
Added
- Added a safety check in TooltipManipulator to ensure the anchor element of the scheduled tooltip is still valid (not invisible) when it is time to animate in the tooltip.
- Added monitoring of key press events in the TooltipManipulator in order to dismiss any existing tooltip when the user interacts with the keyboard.
[2.0.0-pre.19] - 2025-04-22
Fixed
- Fixed pinch gesture recognition sensitivity.
- Added one frame delay before processing Popover dismissal.
Removed
- [Canvas] Removed applying cursor styles during pointer events as it was too costly in terms of performance.
[2.0.0-pre.18] - 2025-03-04
Added
- Added MaskField UI component.
- Added
EnumFieldUI component. - Added Source Generators for MVVM module. Source Generators helps to get rid of boilerplate code and focus on business logic.
Fixed
- Fixed backgrounds color of the input fields.
- Fixed the merge of default and new
Argumentobjects during navigation to aNavDestination.
Changed
- Others assembly modules such as
Redux,MVVMandNavigationhas been configured to be auto-referenced in the Unity project's assemblies.
[2.0.0-pre.17] - 2025-01-31
Changed
- Replaced ClickEvent action in MenuItem builder by an EventBase action
Fixed
- Fixed styling of MenuItem element
- Fixed some SplitView styling issues when nesting SplitViews in a visual tree.
- Fixed context propoagation per key
Added
- Added scoped service provider implementation.
- Added
showExpandButtonsproperty to theSplitViewUI element.
Removed
- Removed EventBaseExtensionsBridge class
[2.0.0-pre.16] - 2025-01-19
Removed
- Removed
Unity.AppUI.Core.AppUI.DismissAnyPopupsmethod. Popups are now registered perPanelelement.
Changed
- Refactored SliderBase and BaseSlider for performance improvements and better features. The RangeSliderBase class has been removed and RangeSliderFloat/RangeSliderInt are now derived from SliderBase directly.
- The
Platform,AppUIInputandGestureRecognizerclasses now use pre-allocated buffers to deal with Touch events in a single frame, and expects aReadOnlySpan<AppUITouch>type to work with instead ofAppUITouch[]. - Changed
ticksrelated properties in Slider components with a newmarksproperty. To configure marks you can you the newstepproperty or directly set yourcustomMarks - Updated App UI Native plugins for MacOS and iOS.
Added
- Added
scaleproperty on slider components to support custom non-linear scaling of displayed values in the UI. - Added the support of inverted track progress in slider components.
- Added Redux Debugging tool.
- Added
formatFunctionalong withformatStringand grouped them into a newIFormattable<TValueType>interface. TheformatFunctionwill give you the possibility to customize entirely the string formatted value of a givenTValueType. - Added a
RestrictedValuePolicyon slider components where you can choose if the slider can take a value related to thesteporcustomMarkswith modifier keys or not. VisualElementExtensions.HasAncestorsOfType{T}method to verify if an element as any ancestor of a specific type.- Added the serialzation of last selected indices in Storybook window to save and restore selection.
- Added
orientationproperty on slider components, to support vertical sliders. - Added
VisualElementExtensions.GetLastAncestorOfType{T}method to retrieve the last ancestor of a specific type in the tree. - Added
VisualElementExtensions.EnableDynamicTransformmethod to set/unset theUsageHints.DynamicTransformflag in your element's usageHints. - Added
RectExtensions.Approximatelymethod to verify if two Rect object are approximately the same. - Popup elements such as
Popover,ModalorMenuBuildernow get their view'suserDatafilled with thePopupinstance itself. This way you can retrieve information about thePopupinstance that created this popup element from within the visual tree. - Added USS custom properties to choose the font style of AccordionItem header and TabItem text.
Fixed
- Fixed calling
shownevent callbacks when aModalis displayed. - Fixed Tabs emphasized color in Editor-light theme.
- Use
RenderTexture.GetTemporaryinstead ofnew RenderTextureto optimize RT allocations, especially on tile-based renderers such as mobile platforms. - Fixed an exception thrown when dismiss any popup of a panel when this panel becomes out of focus.
[1.2.1] - 2024-12-17
Fixed
- Avoid calling
WaitForCompletionduring Localization initialization to not get any error message in WebGL builds.
[2.0.0-pre.15] - 2024-12-12
Changed
- Renamed
Create/App UI/Settingsmenu item intoCreate/App UI/App UI Settings
[2.0.0-pre.14] - 2024-12-11
Changed
- Refactored switch statement builder for Redux slice construction.
- Subscribing to a Redux Store returns a
IDisposableSubscriptionobject instead of a method. You can dispose it by calling itsDisposemethod. - Refactored Redux API fore more flexibility. See the migration guide in the package documentation.
- Changed DropZoneController to support any VisualElement as target instead of a DropZone element.
- Refactored the dispatch process of Redux AsyncThunk.
Added
- Added support of Selectors for subscribing to state changes in Redux implementation.
- Added the support
stringkey in Context API to identify a Context not only byt its type. This will give the ability to provide and propagate contexts of the same type but with different keys. - Added support of Enhancers and Middlewares in Redux implementation.
- Added
editorOnlysetting in App UI's Settings panel. Enabling EditorOnly mode will add a scripting define symbol that will prevent App UI assemblies to get compiled for runtime builds. This can be useful to work in Editor only UI and avoid increasing the footprint of your builds. - Added the support of App UI settings asset file from packages. If there's no persistent App UI settings asset defined for your project, App UI Manager will try to find one not only in the Project assets but also in Packages. You can always switch between settings via the Project Settings > App UI settings pane.
- Added
PreserveAttributeon certain constructor that are only called viaActivatorreflection class. - Added a search bar and "Save as" button in the Icon Browser window.
Fixed
- Fixed drag events in drag and drop samples to disable the Dropzone when leaving the Editor window.
- Fixed text cursor for selectable text elements such as TextArea.
- Fixed warnings related to Dialog styling.
Removed
- Removed the Popup message Handler that was used to dispatch the display or dismissal of Popups. While this removes thread safety, it fixes issues with ordering of events to dismiss popups.
[2.0.0-pre.13] - 2024-12-02
Added
- Added
RegisterUpdateCallbackto register a callback on VisualElement that needs to be notified when App UI's main loop has done a new iteration. - Added
VisualElementExtensions.IsOnScreenmethod to determine if aVisualElementis on-screen or off-screen. - Added
leadingContainerandleadingContentTemplateproperties to theAccordionItemelement.
Changed
- Rewrite of App UI shaders in pure
HLSLinstead of legacyCGlanguage. - Refactored the
FindResponderInChainnative method in MacOS platform to avoid undefined behaviours. CircularProgressandLinearProgresselements withIndeterminatevariant won't be marked asDirtyRepaintif they are off-screen anymore.
Fixed
- Fixed random segmentation fault on MacOS platform which appeared after domain reloads.
- Prevent GC to collect Platform configuration to not break communication with native plugins (MacOS and iOS).
[1.2.0] - 2024-11-30
Changed
- Backported Localization package support from App UI 2.x.
[1.1.1] - 2024-11-27
Changed
- App UI shaders are now optionally embedded in Player builds. You can change this setting in your main App UI settings instance. The default value is
true.
Fixed
- Fixed an exception thrown when trying to update UXML schemas in the Editor.
[2.0.0-pre.12] - 2024-11-18
Added
- Navigation: Added
NavigationRailcomponent which can be used inside NavigationScreen views. - Added
autoShrinkproperty to theTextAreacomponent to automatically shrink the component when the text fits in a smaller area. You need to setautoResizeproperty totrueto use the shrinking feature. - Added
ResizeHandlecomponent. This special component can be added to your layout to resize a giventargetwhen dragging it. This component is currently used in the new resizablePopoverelement. - Added
resizableandresizableDirectionproperties inPopoverclass. You are now able to resize aPopoverusing the bottom-right corner of the popover pane. A resizable Popover will not be repositionned. - Added Clipboard handling support for UTF8 Text and PNG format on iOS, Windows, macOS, and Linux platforms. Please refer to the Native Integration documentation page for more information.
Changed
- App UI shaders are now optionally embedded in Player builds. You can change this setting in your main App UI settings instance. The default value is
true.
Fixed
- Fixed Dark Gray 1200 color value in Design Tokens for Editor-Dark theme.
- Fixed a bug where
Popoverelements were not correctly anchored in Unity versions older than 6. - Fixed usage of AppCompat theme for AppUI GameActivity on Android platform.
- Fixed an exception thrown when trying to update UXML schemas in the Editor.
- Register trickledown events for popups on the first child of the visual tree root element instead of the root element itself to avoid leaks.
[2.0.0-pre.11] - 2024-10-01
Changed
- Make Host optional when intializing an
Appimplementation. - Changed StoryBookEnumProperty class to become a generic type. You need to specify the Enum type as typedef parameter.
- Changed the styling of primary action buttons in AlertDialog UI element.
- Changed the Context API to propagate contexts over internal components hierarchies and not just the high-level hierarchy (via
contentContainer).
Added
- Added support of UITK Runtime DataBinding system in ObervableObject class.
- Added PanAndZoom Manipulator
- Added CircularProgress story in Storybook sample.
- Added AlertDialog icon Design Tokens to customize icons directly from USS.
- Added ActionBar story in Storybook sample.
- Added AlertDialog examples in the UI Kit sample.
- Added Phosphor Icons
- Added support of Localization package in the Storybook window. You can now change the current used Locale in the window via a dropdown in the Storybook context toolbar. This dropdown will appear only if you have the Unity Localization package installed and have at least one existing Locale set up in your Localiztion settings.
Fixed
- Fixed TouchSlider progress element overlapping parent's borders.
- Fixed force mark as dirty repaint Progress UI element when swtiching its variant.
- Fixed Localization support in the ActionBar UI element.
- Removed force blurring the BaseSlider (SliderFloat, TouchSliderFloat, etc) when the users stops interacting with it.
[2.0.0-pre.10] - 2024-09-11
Changed
- Renamed
IUIToolkitApp.mainPageproperty intoIUIToolkitApp.rootVisualElementfor more clarity. - Storybook stories are now sorted alphabetically.
Added
- Added
IApp.servicesproperty which returns the currentIServiceProvideravailable for this instance ofIApp. Thanks to this property you should be able to load a service from anywhere in your application by callingApp.current.services. - Added
LangContext.GetLocalizedStringAsyncFuncto delegate the localization operation to a user-defined function. - Added
IInitializableComponentinterface toIAppinterface. Now when initializing a MVVMAppobject, the relatedAppBuilderwill callapp.InitializeComponentbefore hosting. - Added
SelectedLocaleListenermanipulator that reacts to Localization Package's SelectedLocale changes in order to provide a newLangContextin the visual tree. - Added
NavHost.makeScreenproperty. By setting your own callback to this property, you will be able to customize the way to instantiate aNavigationScreenwhen navigating to a new destination. This can be useful when coupled to Dependency Injection so you can retreive instances of your screens from aIServiceProvider. By default, the property is set with the use ofSystem.Activator.CreateInstance. - Added some warning messages (Standalone builds only) when a LocalizedTextElement value cannot be localized.
Fixed
- Fixed notify property changes for Picker.selectedIndex.
- Fixed path resolution of Stylesheets coming from Packages in Icon Browser tool.
- Fixed a regression where components using
Pressablemanipulator will not able to be clicked more than once if the cursor doesn't leave the component's layout rect. - Fixed NullReferenceException thrown when fetching Localization tables.
- Fixed Screen Height calculation. UITK does not use Camera rect but blit on the whole screen instead.
- Fixed
InvalidOperationExceptionthrown by the damping effect animation of theCanvascomponent. - Fixed the calculation of off-screen items in SwipeView with vertical direction.
[2.0.0-pre.9] - 2024-09-03
Changed
- Scrollable manipulator now stops the propagation of WheelEvent. This affects only the Drawer and SwipeView elements.
- Refactored the SwipeView element logic, without impacting the public API.
- The Canvas now uses
Experimental.Animationsystem from UI-Toolkit for its damping effect when releasing the mouse with some velocity. That replaces the previous implementation that was using theVisualElementScheduledItem. - Changed fade in animation in Tooltip to use USS transitions.
Fixed
- Fixed the wrap system of the SwipeView element when swiping between elements quickly.
- Fixed Daisy chaining window procedures on Windows platform.
- Fixed an edge case when popovers are dismissed as OutOfBounds as soon as Show() is called.
- Invoke click event only if Pressable is still hovered.
- Fixed styling of emphasized checkboxes.
- Fixed a bug where tooltips stop being shown when the window is docked/undocked.
Added
- Added
justifiedproperty on Tabs component to jusitfy tabs layout in horizontal direction. - Added
damping-effect-durationproperty in Canvas element. The default value is 750ms. - Added
IsContextClick()extension method for PointerEvent. - Added support of graceful fallback to lambda
Plafformimplementation if native plugins can not be loaded by the current plaftorm.
[2.0.0-pre.8] - 2024-08-12
Changed
- Refactored completely the DropZone UI element. Now the DropZone doesn't embed any logic, but uses a
DropZoneControllerinstead. You can access this controller viaDropZone.controllerproperty and attaches a callback method to accept dragged objects and listens to drop events. - Defer checking Popup's container candidate when the Popup is about to be shown, instead of during Popup creation.
- Refactored the styling of Chip UI element.
- Upgraded the old Drag And Drop Sample to use the refactored DropZone and the new Drag And Drop system.
- Changed the way MarkDirtyRepaint is scheduled on elements containing animated textures (check properly for visibility).
- Refactored the styling of DropZone UI element.
Added
- Added the
Unity.AppUI.UI.DropZoneControllerManipulator for a lower level approach to create your own "drop zones". - Added
--appui-splitview-splitter-anchor-sizedesign token. Added Unity.AppUI.Core.DragAndDropclass to handle drag and drop (in-panel and/or with the Editor). The support of external drag and drop at runtime is planned for future releases.- Added
Unity.AppUI.UI.Chip.deletedWithEventInfoandUnity.AppUI.UI.Chip.clickedWithEventInfoevents. - Added new Story in the Drag And Drop sample.
- Added support of
TextElement.displayTooltipWhenElidedto show elided text as a tooltip using the App UI tooltip system.
Fixed
- Fixed compilation errors when the Unity project's Input Handling is set to
BothorNew Input Systemand the packagecom.unity.inputsystemis not installed. - Fixed IL2CPP Compilation errors on Windows Platform due to non-static MonoPInvokeCallback.
- Fixed PInvoke delegate types on Windows platform.
- Fixed styling of SplitView's Splitter Anchor size.
- Fixed styling of BaseGridView when containing a single column.
- Popovers and Modals now correctly start checking for PointerDown events in the visual tree when they become visible.
- Removed console message when trying to add an Editor MonoBehaviour in the scene during PlayMode.
[2.0.0-pre.7] - 2024-07-30
Changed
- Changed DialogTrigger.keyboardDismissDisabled to DialogTrigger.keyboardDismissEnabled for consistency.
- Renamed Popup.parentView to Popup.containerView for more clarity.
Added
- Added Modal.outsideClickDismissEnabled and Modal.outsideClickStrategy properties to support dismissing Modals by clicking outside of them.
- Added Popup
.SetContainerView method to set a custom container which will be the parent of the popup's view. - Made
AnchorPopup.GetMovableElementmethod public for easier access and increase customization possibilities.
Fixed
- Fixed "Shape" icon.
- Fixed border color variable for AccordionItem.
- Fixed CultureInfo used during source code generation.
Removed
- Removed intrusive Debug.Log calls from Platform class on Windows platform.
- Removed warning message when using Single selection type in an overflown ActionGroup.
[2.0.0-pre.6] - 2024-07-08
Added
- Added support of Attributes on fields and properties in the Dependency Injection system.
- Added support of UnityEditor ColorPicker in ColorField component.
- Added support of Color without alpha information in ColorField and ColorPicker.
- Added
rounded-progress-cornersboolean property inCircularProgressandLinearProgressto be able to disable rounded corners. - Added
trailing-iconproperty inActionButtoncomponent. - Added customization support for the size of the Color swatch inside the ColorField.
- Added arrow-square-in icon.
Changed
- Changed the Text element inside the ColorField to become a selectable text.
Fixed
- Fixed styling issues in
ActionButtoncomponent. - Fixed Menu's backdrop to block pointer events
- Fixed ColorField styling issues.
- Use correct color variables for Radio and Checkbox components
[2.0.0-pre.5] - 2024-06-18
Changed
- Complete rewrite of the SplitView component. The SplitView is no more a derived from TwoPaneSplitView from UI-Toolkit, but a full custom component that supports any number of panes.
Fixed
- Fixed reset of Dropdown value when changing its source items.
- Fixed a visual bug where the checkmark symbol didn't appear on DropdownItem or MenuItem that have a
selectedstate.
Added
- Added
indicatorPositionproperty inAccordionItemcomponent, in order to swap the indicator position either at start or end of the heading row. - Added
checkregular icon as a required icon in App UI themes.
[2.0.0-pre.4] - 2024-06-05
Fixed
- Fixed MacOS native plugin memory leak when opening the Help menu in the Editor.
[2.0.0-pre.3] - 2024-05-30
Added
- Added AsyncThunk support for Redux implementation.
- Added Anchor Position support for Toast UI elements.
- Added the
keystring property onRadiocomponent to be used as unique identifier in their group. - Added unit tests for MemoryUtils utility class.
Removed
- Removed programatic construction of RadioGroup with IList object. Since App UI offers the possibility to have Radio component as deep as you want in the visual tree compared to its RadioGroup ancestor, we wanted to limit conflicts between construction kinds.
Changed
- Moved Toast animation logic from code to USS.
- The
RadioGroupcomponent uses astringtype for itsvalueproperty. This string value is equal to the currently checkedRadiocomponent'skeyproperty. - The
Toast.AddActionmethod will now ask for a callback that takes aToastobject as argument (instead of no argument at all). This will give you an easier way to dismiss the toast from the action callback. - You can now pass an
autoDismissargument to theToast.AddActionmethod. This will automatically dismiss the toast when the action is triggered. This argument is optional and defaults totruefor backward compatibility. - Changed MemoryUtils.Concatenate implementation to not use variadic parameters and avoid implicit allocations.
Fixed
- Fixed Action Dispatch to every Slice Reducers
- Every shared libraries of native plugins are now correctly signed with the correct Unity Technologies certificate (MacOS and Windows only)
- Fixed support of Radio component that are deeper than the direct child of a RadioGroup.
[2.0.0-pre.2] - 2024-05-08
Added
- Added
PinchGestureRecognizerimplementation for the new Gesture Recognizer System. - Added an experimental method
Platform.GetSystemColorto fetch color values defined by the Operating System for specific UI element types. This can be useful if you want to precisely follow the color palette of a high-contrast theme directed by the OS. - Added "Icon Browser", a new Editor tool that enables users to generate UI-Toolkit stylesheets with a specific list of icons.
- Added a new experimental Gesture Recognizer System.
- Added the ability to subscribe and check if the current operating system is in Reduce-Motion Accessibility Mode (Windows/Mac/Android/iOS).
- Added the ability to subscribe and check if the current Text Scale Factor of the currently used window (Unity Player window or the Game view window in the Editor) (Windows/Mac/Android/iOS).
- Added the ability to subscribe and check if the current operating system is in High-Contrast Mode (Windows/Mac/Android/iOS).
- Added the ability to subscribe and check if the current operating system is in LeftToRight or RightToLeft layout direction (Windows/Mac/Android/iOS).
- Added the ability to subscribe and check if the current Scale Factor of the currently used window (Unity Player window or the Game view window in the Editor) (Windows/Mac/Android/iOS).
- Added the ability to subscribe and check if the current operating system is in Dark Mode (Windows/Mac/Android/iOS).
Changed
- Refactored every native plugin provided by the package.
- Changed the Trackpad sample project to work properly with the new events coming from the new Gesture Recognizer System.
Fixed
- Fixed meta files for native plugins on Windows platform.
- Fixed an early return in the PreProcessBuild callback of App UI when no persistent AppUISettings have been found.
[1.0.6] - 2024-03-18
Fixed
- Fixed the tooltip tip size to not be displayed over tooltip content.
- Fixed the handling of Tab key to focus the next component from a TextArea
- Fixed size of the Radio button for pixel alignment on 96dpi screens.
[1.0.5] - 2024-03-11
Fixed
- Fixed Hero banner in the documentation homepage
[1.0.4] - 2024-03-11
Fixed
- Fixed GridFour icon PNG file
- Fixed font weight on AppBar title elements.
- Fixed accent color in Editor Dark theme
- Fixed ActionGroup Refresh strategy.
Added
- Added gutter USS custom property for the GridView component.
- Added answer in the FAQ documentation about MacOS quarantine attribute.
[1.0.3] - 2024-03-04
Fixed
- Use equlity check while setting a new
textvalue in aLocalizedTextElement. - Fixed performance issues with the blinking text cursor in input fields.
- Fixed styling of the Toast Action container
[1.0.2] - 2024-02-28
Fixed
- Fixed the clipping flag on the GridView's ScrollView content container to prevent overscroll on touch devices.
- Fixed unit tests
- Disabled the dragging feature in the GridView when used on touch devices.
Added
- Improved Localization Unity Package support with
LangContextpropagation.
[1.0.1] - 2024-02-16
Fixed
- Fixed ColorSwatch shader to support Shader Model older than 5.0
[1.0.0-pre.15] - 2024-02-09
Removed
- Removed the
marginproperty from the Tray component. - Removed the
sizeproperty of theTraycomponent. The Tray component will fit its content in the screen automatically and doen't need anymore any specific size to be set. - Removed the
expandableproperty from the Tray component. A Tray component is should not be expandable by definition. If you are willing to have some scrollable content inside a Tray component, a new component called ScrollableTray will be avilable in future release of App UI.
Fixed
- Fixed styling on BottomNavBar items
- Fixed refresh of the
ActionGroupcomponent - Fixed Tooltip maximum size
Added
- Added monitoring of AccordionItem content size to make AccordionItem fit its content when it is already open.
Changed
- Use the ConditionalWeakTable for new releases of Unity where a fix from IL2CPP has landed.
[1.0.0-pre.14] - 2024-01-31
Fixed
- Fixed ColorSwatch refresh when the Gradient reference value didn't change but Gradient keys have changed
- Added support of Windows 11 for ARM
- Fixed ColorPicker Alpha channel slider refresh when the picked color has changed
- Fixed calls for ContextChanged callbacks registered by the context provider itself
Added
- Added new IInputElement interface in the public API
- Added the possibility to setup navigation visual components from your NavigationScreen implementation directly. You are still able to create a global setup using your own implementation of the INavVisualController interface that you have set on your NavHost.
- Added the support of a specific drag direction and drag threshold in the Draggable manipulator. Specifying a direction will avoid to prevent scrolling in the opposite direction if this maniuplator is used inside a ScrollView for example.
- Added forceUseTooltipSystem property on the Panel component to force the use of App UI tooltips system regardless the state of UI-Toolkit default tooltip system. This can be useful in a context where UITK tooltips can't be displayed in the Editor.
- Added mention about full integration of UI Toolkit with the New Input System starting 2023.2 in the documentation
Changed
- All user input related UI controls now inherit from the new IInputElement interface. This has no impact on the current implementation (some addition in certain components).
- Use ConditionalWeakTable whenever possible (Editor and no IL2CPP builds)
[1.0.0-pre.13] - 2024-01-15
Removed
- Removed Relocations folder from MacOS native plugin debug symbols bundle
Fixed
- Fixed TextField and NumericalField text offset during FocusOut event
Added
- Added missing API documentation
- Added more tests
Changed
- Changed assembly definition files to support new UXML Serialization starting Unity 2023.3.0a1
[1.0.0-pre.12] - 2024-01-04
Changed
- Color related components, such as
ColorSliderorColorSwatch, support now a value of typeUnityEngine.Gradientinstead ofUnityEngine.Colorfor more flexibility. - Removed the
disabledboolean property on App UI components from the public C# API. Thedisabledattribute in UXML has been replaced byenabledUXML attribute. This change has been made in order to be more consistent with Unity 2023.3, whereenabledUXML attribute is provided by UI Toolkit on any VisualElement. - Replaced
Nullable<T>properties in components by a custom serializable implementation calledOptional<T> - Renamed
Panel.dirproperty withPanel.layoutDirection. - Replaced the
Divider.verticalproperty byDivider.directionenum property. - Removed the
ApplicationContextclass andVisualElementExtensions.GetContext()method, replaced by the neProvideContextandRegisterContextChangedCallbackAPI. - Replaced
ActionGroup.verticalproperty byActionGroup.directionenum property.
Added
- Added support of new UI Toolkit Runtime Bindings feature through bindable properties in each App UI components. More than 420 properties can now be bound (2023.2+).
- Added support to new UI Toolkit Uxml Serialization using source code generators.
- Added
BaseVisualElementandBaseTextElementclasses which are used as base class for mostly every App UI component - Added numerous custom PropertyDrawers for a better experience in UIBuilder (2023.3+)
- Added the support of
Fixedgradient blend mode in ColorSwatch shader. - Added
.appui-rowUSS classes which support current layout direction context.
Removed
- Starting Unity 2023.3, App UI will not provide any
UxmlFactoryorUxmlTraitsimplementation, as they become obsolete and replaced by the new UITK Uxml serialization system.
Fixed
- Fixed Sliders handles to not exceed the range of track element.
- Fixed color blending in the ColorSwatch custom shader.
- Fixed
AppBarstory in Storybook samples. - Fixed some styling issues on different components.
- Cleaned up some warning messages to not get anything written in the console during package installation.
- Fixed small errors in UI Kit sample.
- Fixed a refresh bug in the App UI Storybook window.
[1.0.0-pre.11] - 2023-12-21
Fixed
- Fixed Scroller styling.
- Fixed styling for Disabled Quiet Button component.
- Fixed compilation errors while not having the new Input System installed but the Input Manager setting is set to 'New' in the Project Settings.
- Fixed border gap in TouchSlider component.
- Fixed margins on Checkbox component without label.
Changed
- Removed
sizeproperty from Checkbox and Toggle components.
[1.0.0-pre.10] - 2023-12-13
Fixed
- Fixed auto scrolling to follow text edition's cursor in TextArea component.
- Fixed layout for Bounds, Rect and Vector fields
- Fixed some examples in the UI Kit Sample
Added
- Added
maxLengthproperty in TextArea and TextField components. - Added
isPasswordandmaskCharproperties to TextField component. - Added Editor-Dark and Editor-Light themes.
- Added
isReadonlyproperty to TextArea and TextField components.
Changed
- Readjusted font sizes used on components to follow new design tokens
- Most App UI component styling now use component-level design tokens for background and border colors
[1.0.0-pre.9] - 2023-12-06
Fixed
- Fixed Selection handling in ActionGroup.
- Fixed MacOS Native plugin to support Intel 64bits architecture with IL2CPP
Changed
- In Numerical fields and sliders, the string formatting for percentage values follows now the C# standard. The formatted string of the value
1using0Por0%will give you100%. If you want the user to be able to type100in order to get a100%as a formatted string in a numerical field, we suggest to use0\%string format (be sure that thehighValueof your field is set to100too).
Added
- Added
isOpenproperty setter to be able to set the open state of theDrawercomponent without animation.
[1.0.0-pre.8] - 2023-11-30
Fixed
- Fixed Unity crashes when polling TabItem elements inside Tabs component.
- Fixed mouse capture during Pointer down event in Pressable manipulator for Unity versions older than 2023.1.
- Fixed tab key handling to switch focus in
TextAreacomponent. - Fixed UI Kit Sample with Progress components' color overrides.
- Fixed
border-radiususage inExVisualElementcomponent. - Fixed typo in App UI Elevation's USS selector.
- Fixed box-shadows border-radius calculation
- Fixed
isPrimaryActionDisabledandisSecondaryActionDisabledproperty setters
Added
- Added new methods to push sub-menus in
MenuBuilderclass. - Added
submit-on-enterproperty inTextAreacomponent. - Added
submit-modifiersproperty inTextAreacomponent. - Added
submittedevent property inTextAreacomponent. - Added
subMenuOpenedevent property inMenuItemUI component. - Added
accentproperty to theFloatingActionButtoncomponent.
Changed
- Runtime Tooltips won't be displayed if the picked element has
.is-openUSS class currently applied.
[1.0.0-pre.7] - 2023-11-24
Added
- Added others Inter font variants
Fixed
- Fixed some unit tests
[1.0.0-pre.6] - 2023-11-19
Added
- Added Layout Direction
dircontext in the App UIApplicationContext. - Added support of LTR and RTL layout direction in most App UI components
Changed
- Previously the Panel Constructor set the default scale context to "large" on mobile platforms, now the default scale context for any platform is "medium".
[1.0.0-pre.5] - 2023-11-16
Changed
- Migrated code into the App UI monorepo at https://github.com/Unity-Technologies/unity-app-ui
- Renamed
formatUXML Attribute toformat-stringto bind correctly in UIBuilder - The
MacroCommand.Flushmethod will now callUndoCommand.Flushon its child commands from the most recent to the oldest one. This is the same order as the one used by theMacroCommand.Undomethod. - Renamed CircularProgress and LinearProgress
colorUxml Attribute tocolor-overrideto bind correctly in UIBuilder - Float Fields using a string format set on Percentage (P) will now use the same value as what you typed
Added
- Added
disabledproperty on every components that needed it in order to bind correctly with UIBuilder - Added
Spacercomponent.
Fixed
- Fixed the height of Toast components to be
auto. - Fixed
MacroCommand.UndoandMacroCommand.Redomethods.
[1.0.0-pre.4] - 2023-11-13
Changed
- The
Canvascomponent now listens toPointerDownEventinTrickleDownphase to avoid to miss the event when the pointer is over a child element.
[1.0.0-pre.3] - 2023-11-07
Added
- Added public access to
Pressable.InvokePressedandPressable.InvokeLongPressedmethods. - Added
trailingContainerproperty to theAccordionItemcomponent.
Changed
- The
Pressablemanipulator now uses thekeepPropagationproperty also in itsPointerUpEventcallback to avoid to propagate the event to the parent element.
Fixed
- Fixed warning message about Z-axis scale in the
AnchorPopupcomponent. - Fixed styling of the
AccordionItemheader component. - Fixed the
not-allowed(disabled) cursor texture for Windows support at Runtime. - Fixed images in the package documentation.
[1.0.0-pre.2] - 2023-11-06
Added
- Added missing XML documentation parts for the public API of the package.
[1.0.0-pre.1] - 2023-11-06
Added
- Added debug symbols for native plugins.
Changed
- Moved internal Engine API related code into a new assembly
Unity.AppUI.InternalAPIBridge.
[0.6.5] - 2023-11-06
Added
- Added missing XML documentation parts for the public API of the package.
- Added the
primaryManipulatorproperty to theCanvascomponent to get the primary pointer manipulator used by the canvas when no modifier is pressed. - Added the
autoResizeproperty to theTextAreacomponent to grow the text area when the text overflows. - Added the handling of double-click in the
TextArearesizing handle to re-enable the auto-resize feature. - Added the
outsideScrollEnabledproperty to theAnchorPopupcomponents to enable or disable the outside scroll handling. The default value isfalse. - Added a smoother animation for the
AnchorPopupcomponents when the popup is about to be shown.
Changed
- Changed the USS selector for component-level aliases to use directly
:rootselector instead of<component_main_uss_class>selector.
Fixed
- Fixed the Canvas background to support light theme.
- Fixed the styling of DropdownItem checkmark.
- Fixed the styling of MenuItem checkmark.
- Fixed the styling of Slider components.
- Fixed the styling of TextArea component.
- Fixed the styling of TouchSlider components.
- Fixed the previous value sent in
ChangeEventofNumericalField,VectorFieldandPicker(Dropdown) components. - Improved the synchronization of the
AnchorPopupcomponents to refresh their position in the layout faster.
[0.6.4] - 2023-11-01
Fixed
- Fixed
NullReferenceExceptionwhen testing accept drag inGridViewcomponent.
[0.6.3] - 2023-11-01
Added
- Added
getItemIdproperty to theGridViewcomponent to get the id of an item.
Fixed
- Fixed items selection persistence between refreshes in
GridViewcomponent.
[0.6.2] - 2023-10-30
Added
- Added
closeOnSelectionproperty to theMenuTriggercomponent. - Added
closeOnSelectionproperty to theActionGroupcomponent to close the popover menu (if any) when an item is selected.
Fixed
- Fixed
closeOnSelectionproperty inMenuBuildercomponent. - Fixed
TextInputstyling for Unity 2023.1+ - Fixed
InvalidCastExceptionat startup of santandlone builds (in both Mono and IL2CPP) - Fixed
NullReferenceExceptionwhen dismissing a Popup from a destroyed UI-Toolkit panel. - Fixed sub-menu indicator icon in
MenuItemcomponent. - Fixed context click handling in
GridViewcomponent.
[0.5.5] - 2023-10-30
Added
- [Backport] Added
closeOnSelectionproperty to theMenuTriggercomponent. - [Backport] Added
closeOnSelectionproperty to theActionGroupcomponent to close the popover menu (if any) when an item is selected.
Fixed
- [Backport] Fixed
closeOnSelectionproperty inMenuBuildercomponent. - [Backport] Fixed
TextInputstyling for Unity 2023.1+ - [Backport] Fixed
InvalidCastExceptionat startup of santandlone builds (in both Mono and IL2CPP) - [Backport] Fixed
NullReferenceExceptionwhen dismissing a Popup from a destroyed UI-Toolkit panel. - [Backport] Fixed context click handling in
GridViewcomponent.
[0.6.1] - 2023-10-23
Added
- Added
allowNoSelectionproperty to theGridViewcomponent to enable or disable the selection of no items.
Fixed
- Fixed the support of nested components inside the
Buttoncomponent. - Fixed the reset of the previous selection when
GridView.SetSelectionWithoutNotifymethod is called.
[0.5.4] - 2023-10-23
Added
- Added
allowNoSelectionproperty to theGridViewcomponent to enable or disable the selection of no items.
Fixed
- Fixed the support of nested components inside the
Buttoncomponent. - Fixed the reset of the previous selection when
GridView.SetSelectionWithoutNotifymethod is called.
[0.6.0] - 2023-10-21
Added
- Added the
Quotecomponent. - Added
FieldLabelcomponent. - Added
HelpTextcomponent. - Added
AvatarGroupcomponent. - Added
requiredproperty to theInputLabelcomponent. - Added
indicatorTypeproperty to theInputLabelcomponent. - Added
helpMessageproperty to theInputLabelcomponent. - Added
helpVariantproperty to theInputLabelcomponent. - Added
variantproperty to theAvatarcomponent to supportsquare,roundedandcircularvariants.
Changed
- Added the
Buttonvariantproperty and removed theprimaryproperty. - Updated App UI icons with a default size of 256x256 and moved into a folder named
Regular. - The
InputLabelcomponent uses theFieldLabelandHelpTextcomponents to display the label and the help text. - The
Avatarcomponent now listens toAvatarVarianContextandSizeContextchanges to update the variant and size of the avatar.
Removed
- Removed the
sizeproperty from theInputLabelcomponent.
[0.5.3] - 2023-10-18
Added
- Added
useSpaceBarproperty inCanvascomponent to enable or disable the handling of the space bar key.
Fixed
- Removed the handling of the space bar key in the
Canvascomponent when the used control scheme isEditor.
[0.5.2] - 2023-10-13
Added
- Added
acceptDragproperty to theGridViewcomponent to enable or disable the drag and drop feature. - Added
menuicon. - Added
AddDividerandAddSectionmethods to theMenuBuildercomponent.
Fixed
- Fixed handling
acceptDragproperty inDraggermanipulator. - Fixed MenuItem opening sub menus when the item is disabled.
- Fixed mipmap limit for Icons when a global limit is set in the Quality settings of the project.
- Fixed the capture of pointer during PointerDown event in
Draggermanipulator. Now the pointer is captured only if theDraggermanipulator is active (i.e. the threshold has been reached).
[0.5.1] - 2023-09-21
Added
- Added
selectedIndexproperty to thePickercomponent to get or set the selected index for a single selection mode. - Added a new
Enumerableextension method calledGetFirstto get the first item of an enumerable collection or a default value if the collection is empty. - Added
isPrimaryActionDisabledandisSecondaryActionDisabledproperties to theAlertDialogcomponent. - Added styling for
AlertDialogcomponent semantic variants.
Changed
- Changed the picking mode of the
DropdownItemcomponent toPositioninstead ofIgnore.
Fixed
- Fixed the
Pickercomponent to avoid to select multiple items if the selection mode is set toSingle. - Fixed
Menu.CloseSubMenusmethod to close sub-menus opened byMenuItemcomponents contained insideMenuSectioncomponents. - Fixed double click handling in
GridViewcomponent.
[0.5.0] - 2023-09-18
Added
- Added
outsideClickStrategyproperty inAnchorPopupcomponent. - Added
DropZonecomponent. - Added
DropTargetmanipulator. - Added a sample for
DropZoneandDropTargetcomponents usage. - Added
--border-stylecustom USS property to supportdottedanddashedborder styles. - Added
--border-speedcustom USS property to animate the border style. - Added
Pickercomponent. - Added
closeOnSelectionproperty forPickerandDropdowncomponents to close the picker when an item is selected.
Changed
- The
Pressablemanipulator nows inherits fromPointerManipulatorinstead ofManipulator. - Changed the
GridView.GetIndexByPositionmethod to use a world-space position instead of a local-space position and renamed it toGetIndexByWorldPosition. - TouchSlider component will now loose focus when a slide interaction has ended.
- When calling
GridView.Reset()method, the selection won't be restored if no customGridView.getItemIdfunction has been provided. - When using
--box-shadow-type: 1(inset box-shadow), the--box-shadow-spreadvalue was interpreted with the same direction as outset box-shadow. This has been fixed so you can use a positive spread value to go inside the element and a negative spread value to go outside the element. - The
Dropdowncomponent inherits fromPickercomponent. Users will be able to create custom dropdown-like components by inheriting fromPickercomponent. - The
Dropdowncomponent now has a selection mode property to choose between single and multiple selection modes. - The
Dropdowncomponent now usesDropdownItemcomponent instead ofMenuItemcomponent. - Removed
default-valueUXML property fromDropdowncomponent. The preferred way to set the default value is by code.
Fixed
- Fixed the
Pressablemanipulator to only handle the Left Mouse Button by default. - Fixed current tooltip element check in
TooltipManipulator. - Fixed incremental value when interacting with keyboard in
ColorSlidercomponent. - Fixed clearing selection in
GridViewwhen a user clicks outside of the grid. - Fixed
itemsChosenevent inGridViewto be fired only when the selection is not empty. - Fixed Navigation keys handling in the
GridViewto clamp the selection to the grid items.
[0.4.2] - 2023-09-07
Added
- Added the
Pickercomponent.
Changed
- Changed
Dropdownimplementation to use the newPickercomponent.
Fixed
- Fixed the soft selection handling on
PointerUpEventin theGridViewcomponent.
[0.4.1] - 2023-08-30
Added
- Added mouse and touchpad mapping presets to the
Canvascomponent. - Added a setting to enable or disable gestures recognition on MacOS.
- Added selection mode in
ActionGroupcomponent.
[0.4.0] - 2023-08-21
Added
- Added the Small scale context to App UI. This context is now the preferred one for desktop platforms.
- Added
RangeSlidercomponent.
Fixed
- Fixed
ValueChangedandValueChangingevents propagation inNumericalFieldand Vector components.
[0.3.9] - 2023-08-17
Added
- Added Context API which is accessible through any
VisualElementinstance. - Added
preventScrollWithModifiersproperty to theGridViewcomponent.
Fixed
- Fixed
autoPlayDurationproperty on PageView component. - Fixed value validation in
NumericalFieldcomponent.
[0.3.8] - 2023-08-09
Added
- Added
tooltip-delay-msproperty to theContextProvidercomponent to customize the tooltip delay. - Added more shortcuts to the
Canvascomponent.
Fixed
- Fixed Editor crash when updating packages from UPM window.
[0.3.5] - 2023-07-26
Fixed
- Regenerated the meta files inside MacOS bundle folder to avoid error messages in the console.
[0.3.4] - 2023-07-19
Changed
- Draggable manipulator now is publicly accessible.
Fixed
- Ensure shaders exist before creating materials.
- Fixed random crashes during domain unload in Unity 2022.3+.
- Fixed cursors variables for Editor context.
[0.3.3] - 2023-07-17
Added
- Added Magic Trackpad gesture support for MacOS.
- Added
PanGestureandMagnificationGestureevents for UITK dispatcher.
Fixed
- Fixed
Pressablepost-processing for disabled targets. - Fixed visual content rendering synchronization in
ProgressandExVisualElementcomponents. - Fixed Animation Recycling in
NavHostcomponent.
[0.3.2] - 2023-06-14
Fixed
- Fixed NavAction being added twice in NavGraph when deleting a linked NavDestination.
[0.2.12] - 2023-06-14
Added
- Added
isExclusiveproperty to theAccordioncomponent. - Added
shortcutproperty to theMenuItemcomponent.
Fixed
- Fixed TextArea input size.
- Fixed ValueChanged events on text based inputs.
- Fixed depth tests in custom shaders for WebGL platform.
[0.3.1] - 2023-05-22
Fixed
- Fixed warning messages about styling.
- Fixed warning messages about GUID conflicts in UI Kit samples.
- Fixed warning messages about unused events in NavController.
[0.2.11] - 2023-05-15
Added
- Added
maxDistanceproperty to the World-Space UI Document component.
[0.2.9] - 2023-05-05
Changed
- Removed
Replicaword from the documentation.
[0.2.7] - 2023-05-03
Added
- Added
Refreshmethod to theDropdowncomponent. - Added AutoPlay to the
SwipeViewcomponent.
Fixed
- Fixed the support of the New Input System.
- Fixed the box-shadow shader with portrait aspect ratio.
- Fixed async operations on LocalizedTextElement.