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.0.6] - 2024-03-15
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-10
Fixed
- Fixed Hero banner in the documentation homepage
[1.0.4] - 2024-03-08
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-01
Fixed
- Use equlity check while setting a new
text
value 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-26
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
LangContext
propagation.
[1.0.1] - 2024-02-14
Fixed
- Fixed ColorSwatch shader to support Shader Model older than 5.0
[1.0.0] - 2024-02-12
Changed
- Color related components, such as
ColorSlider
orColorSwatch
, support now a value of typeUnityEngine.Gradient
instead ofUnityEngine.Color
for more flexibility. - Removed the
disabled
boolean property on App UI components from the public C# API. Thedisabled
attribute in UXML has been replaced byenabled
UXML attribute. This change has been made in order to be more consistent with Unity 2023.3, whereenabled
UXML attribute is provided by UI Toolkit on any VisualElement. - Replaced
Nullable<T>
properties in components by a custom serializable implementation calledOptional<T>
- Renamed
Panel.dir
property withPanel.layoutDirection
. - Replaced the
Divider.vertical
property byDivider.direction
enum property. - Removed the
ApplicationContext
class andVisualElementExtensions.GetContext()
method, replaced by the neProvideContext
andRegisterContextChangedCallback
API. - Replaced
ActionGroup.vertical
property byActionGroup.direction
enum property. - Migrated code into the App UI monorepo at https://github.com/Unity-Technologies/unity-app-ui
- Renamed
format
UXML Attribute toformat-string
to bind correctly in UIBuilder - Readjusted font sizes used on components to follow new design tokens
- Changed assembly definition files to support new UXML Serialization starting Unity 2023.3.0a1
- Removed
size
property from Checkbox and Toggle components. - In Numerical fields and sliders, the string formatting for percentage values follows now the C# standard. The formatted string of the value
1
using0P
or0%
will give you100%
. If you want the user to be able to type100
in order to get a100%
as a formatted string in a numerical field, we suggest to use0\%
string format (be sure that thehighValue
of your field is set to100
too). - Previously the Panel Constructor set the default scale context to "large" on mobile platforms, now the default scale context for any platform is "medium".
- 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).
- The
MacroCommand.Flush
method will now callUndoCommand.Flush
on its child commands from the most recent to the oldest one. This is the same order as the one used by theMacroCommand.Undo
method. - Most App UI component styling now use component-level design tokens for background and border colors
- Renamed CircularProgress and LinearProgress
color
Uxml Attribute tocolor-override
to bind correctly in UIBuilder - Runtime Tooltips won't be displayed if the picked element has
.is-open
USS class currently applied. - Use the ConditionalWeakTable for new releases of Unity where a fix from IL2CPP has landed.
- Float Fields using a string format set on Percentage (P) will now use the same value as what you typed
- Use ConditionalWeakTable whenever possible (Editor and no IL2CPP builds)
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
BaseVisualElement
andBaseTextElement
classes 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 Layout Direction
dir
context in the App UIApplicationContext
. - Added
maxLength
property in TextArea and TextField components. - Added
isPassword
andmaskChar
properties to TextField component. - Added Editor-Dark and Editor-Light themes.
- Added others Inter font variants
- Added the support of
Fixed
gradient blend mode in ColorSwatch shader. - Added
.appui-row
USS classes which support current layout direction context. - Added new IInputElement interface in the public API
- Added missing API documentation
- Added new methods to push sub-menus in
MenuBuilder
class. - Added monitoring of AccordionItem content size to make AccordionItem fit its content when it is already open.
- 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
Spacer
component. - 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
submit-on-enter
property inTextArea
component. - Added more tests
- Added support of LTR and RTL layout direction in most App UI components
- Added
submit-modifiers
property inTextArea
component. - 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
submitted
event property inTextArea
component. - Added mention about full integration of UI Toolkit with the New Input System starting 2023.2 in the documentation
- Added
subMenuOpened
event property inMenuItem
UI component. - Added
accent
property to theFloatingActionButton
component. - Added
isReadonly
property to TextArea and TextField components. - Added
isOpen
property setter to be able to set the open state of theDrawer
component without animation.
Removed
- Starting Unity 2023.3, App UI will not provide any
UxmlFactory
orUxmlTraits
implementation, as they become obsolete and replaced by the new UITK Uxml serialization system. - Removed Relocations folder from MacOS native plugin debug symbols bundle
- Removed the
margin
property from the Tray component. - Removed the
size
property of theTray
component. The Tray component will fit its content in the screen automatically and doen't need anymore any specific size to be set. - Removed the
expandable
property 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 Unity crashes when polling TabItem elements inside Tabs component.
- Fixed Scroller styling.
- Fixed TextField and NumericalField text offset during FocusOut event
- Fixed auto scrolling to follow text edition's cursor in TextArea 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
TextArea
component. - Fixed styling on BottomNavBar items
- Fixed Sliders handles to not exceed the range of track element.
- Fixed Selection handling in ActionGroup.
- Fixed styling for Disabled Quiet Button component.
- Fixed color blending in the ColorSwatch custom shader.
- Fixed ColorSwatch refresh when the Gradient reference value didn't change but Gradient keys have changed
- Fixed compilation errors while not having the new Input System installed but the Input Manager setting is set to 'New' in the Project Settings.
- Added support of Windows 11 for ARM
- Fixed layout for Bounds, Rect and Vector fields
- Fixed the height of Toast components to be
auto
. - Fixed
AppBar
story in Storybook samples. - Fixed UI Kit Sample with Progress components' color overrides.
- Fixed
border-radius
usage inExVisualElement
component. - Fixed some styling issues on different components.
- Fixed USS icons to match with App UI Symbols names
- 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.
- Fixed some examples in the UI Kit Sample
- Fixed refresh of the
ActionGroup
component - Fixed MacOS Native plugin to support Intel 64bits architecture with IL2CPP
- Fixed typo in App UI Elevation's USS selector.
- Fixed box-shadows border-radius calculation
- Fixed border gap in TouchSlider component.
- Fixed margins on Checkbox component without label.
- Fixed ColorPicker Alpha channel slider refresh when the picked color has changed
- Fixed
isPrimaryActionDisabled
andisSecondaryActionDisabled
property setters - Fixed calls for ContextChanged callbacks registered by the context provider itself
- Fixed some unit tests
- Fixed Tooltip maximum size
- Fixed
MacroCommand.Undo
andMacroCommand.Redo
methods.
[1.0.0-pre.15] - 2024-02-09
Removed
- Removed the
margin
property from the Tray component. - Removed the
size
property of theTray
component. The Tray component will fit its content in the screen automatically and doen't need anymore any specific size to be set. - Removed the
expandable
property 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
ActionGroup
component - 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-30
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-14
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-03
Changed
- Color related components, such as
ColorSlider
orColorSwatch
, support now a value of typeUnityEngine.Gradient
instead ofUnityEngine.Color
for more flexibility. - Removed the
disabled
boolean property on App UI components from the public C# API. Thedisabled
attribute in UXML has been replaced byenabled
UXML attribute. This change has been made in order to be more consistent with Unity 2023.3, whereenabled
UXML attribute is provided by UI Toolkit on any VisualElement. - Replaced
Nullable<T>
properties in components by a custom serializable implementation calledOptional<T>
- Renamed
Panel.dir
property withPanel.layoutDirection
. - Replaced the
Divider.vertical
property byDivider.direction
enum property. - Removed the
ApplicationContext
class andVisualElementExtensions.GetContext()
method, replaced by the neProvideContext
andRegisterContextChangedCallback
API. - Replaced
ActionGroup.vertical
property byActionGroup.direction
enum 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
BaseVisualElement
andBaseTextElement
classes 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
Fixed
gradient blend mode in ColorSwatch shader. - Added
.appui-row
USS classes which support current layout direction context.
Removed
- Starting Unity 2023.3, App UI will not provide any
UxmlFactory
orUxmlTraits
implementation, 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
AppBar
story 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
size
property from Checkbox and Toggle components.
[1.0.0-pre.10] - 2023-12-12
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
maxLength
property in TextArea and TextField components. - Added
isPassword
andmaskChar
properties to TextField component. - Added Editor-Dark and Editor-Light themes.
- Added
isReadonly
property 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-05
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
1
using0P
or0%
will give you100%
. If you want the user to be able to type100
in order to get a100%
as a formatted string in a numerical field, we suggest to use0\%
string format (be sure that thehighValue
of your field is set to100
too).
Added
- Added
isOpen
property setter to be able to set the open state of theDrawer
component 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
TextArea
component. - Fixed UI Kit Sample with Progress components' color overrides.
- Fixed
border-radius
usage inExVisualElement
component. - Fixed typo in App UI Elevation's USS selector.
- Fixed box-shadows border-radius calculation
- Fixed
isPrimaryActionDisabled
andisSecondaryActionDisabled
property setters
Added
- Added new methods to push sub-menus in
MenuBuilder
class. - Added
submit-on-enter
property inTextArea
component. - Added
submit-modifiers
property inTextArea
component. - Added
submitted
event property inTextArea
component. - Added
subMenuOpened
event property inMenuItem
UI component. - Added
accent
property to theFloatingActionButton
component.
Changed
- Runtime Tooltips won't be displayed if the picked element has
.is-open
USS 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
dir
context 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-15
Changed
- Migrated code into the App UI monorepo at https://github.com/Unity-Technologies/unity-app-ui
- Renamed
format
UXML Attribute toformat-string
to bind correctly in UIBuilder - The
MacroCommand.Flush
method will now callUndoCommand.Flush
on its child commands from the most recent to the oldest one. This is the same order as the one used by theMacroCommand.Undo
method. - Renamed CircularProgress and LinearProgress
color
Uxml Attribute tocolor-override
to 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
disabled
property on every components that needed it in order to bind correctly with UIBuilder - Added
Spacer
component.
Fixed
- Fixed the height of Toast components to be
auto
. - Fixed
MacroCommand.Undo
andMacroCommand.Redo
methods.
[1.0.0-pre.4] - 2023-11-08
Changed
- The
Canvas
component now listens toPointerDownEvent
inTrickleDown
phase to avoid to miss the event when the pointer is over a child element.
[1.0.0-pre.3] - 2023-11-06
Added
- Added public access to
Pressable.InvokePressed
andPressable.InvokeLongPressed
methods. - Added
trailingContainer
property to theAccordionItem
component.
Fixed
- Fixed warning message about Z-axis scale in the
AnchorPopup
component. - Fixed styling of the
AccordionItem
header component. - Fixed the
not-allowed
(disabled) cursor texture for Windows support at Runtime. - Fixed images in the package documentation.
Changed
- The
Pressable
manipulator now uses thekeepPropagation
property also in itsPointerUpEvent
callback to avoid to propagate the event to the parent element.
[1.0.0-pre.2] - 2023-11-04
Added
- Added missing XML documentation parts for the public API of the package.
[1.0.0-pre.1] - 2023-10-31
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-04
Added
- Added missing XML documentation parts for the public API of the package.
- Added the
primaryManipulator
property to theCanvas
component to get the primary pointer manipulator used by the canvas when no modifier is pressed. - Added the
autoResize
property to theTextArea
component to grow the text area when the text overflows. - Added the handling of double-click in the
TextArea
resizing handle to re-enable the auto-resize feature. - Added the
outsideScrollEnabled
property to theAnchorPopup
components to enable or disable the outside scroll handling. The default value isfalse
. - Added a smoother animation for the
AnchorPopup
components when the popup is about to be shown.
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
ChangeEvent
ofNumericalField
,VectorField
andPicker
(Dropdown) components. - Improved the synchronization of the
AnchorPopup
components to refresh their position in the layout faster.
Changed
- Changed the USS selector for component-level aliases to use directly
:root
selector instead of<component_main_uss_class>
selector.
[0.6.4] - 2023-10-31
Fixed
- Fixed
NullReferenceException
when testing accept drag inGridView
component.
[0.6.3] - 2023-10-31
Added
- Added
getItemId
property to theGridView
component to get the id of an item.
Fixed
- Fixed items selection persistence between refreshes in
GridView
component.
[0.6.2] - 2023-10-27
Added
- Added
closeOnSelection
property to theMenuTrigger
component. - Added
closeOnSelection
property to theActionGroup
component to close the popover menu (if any) when an item is selected.
Fixed
- Fixed
closeOnSelection
property inMenuBuilder
component. - Fixed
TextInput
styling for Unity 2023.1+ - Fixed
InvalidCastException
at startup of santandlone builds (in both Mono and IL2CPP) - Fixed
NullReferenceException
when dismissing a Popup from a destroyed UI-Toolkit panel. - Fixed sub-menu indicator icon in
MenuItem
component. - Fixed context click handling in
GridView
component.
[0.6.1] - 2023-10-20
Added
- Added
allowNoSelection
property to theGridView
component to enable or disable the selection of no items.
Fixed
- Fixed the support of nested components inside the
Button
component. - Fixed the reset of the previous selection when
GridView.SetSelectionWithoutNotify
method is called.
[0.6.0] - 2023-09-20
Added
- Added the
Quote
component. - Added
FieldLabel
component. - Added
HelpText
component. - Added
AvatarGroup
component. - Added
required
property to theInputLabel
component. - Added
indicatorType
property to theInputLabel
component. - Added
helpMessage
property to theInputLabel
component. - Added
helpVariant
property to theInputLabel
component. - Added
variant
property to theAvatar
component to supportsquare
,rounded
andcircular
variants.
Changed
- Added the
Button
variant
property and removed theprimary
property. - Updated App UI icons with a default size of 256x256 and moved into a folder named
Regular
. - The
InputLabel
component uses theFieldLabel
andHelpText
components to display the label and the help text. - The
Avatar
component now listens toAvatarVarianContext
andSizeContext
changes to update the variant and size of the avatar.
Removed
- Removed the
size
property from theInputLabel
component.
[0.5.5] - 2023-10-27
Added
- [Backport] Added
closeOnSelection
property to theMenuTrigger
component. - [Backport] Added
closeOnSelection
property to theActionGroup
component to close the popover menu (if any) when an item is selected.
Fixed
- [Backport] Fixed
closeOnSelection
property inMenuBuilder
component. - [Backport] Fixed
TextInput
styling for Unity 2023.1+ - [Backport] Fixed
InvalidCastException
at startup of santandlone builds (in both Mono and IL2CPP) - [Backport] Fixed
NullReferenceException
when dismissing a Popup from a destroyed UI-Toolkit panel. - [Backport] Fixed context click handling in
GridView
component.
[0.5.4] - 2023-10-19
Added
- Added
allowNoSelection
property to theGridView
component to enable or disable the selection of no items.
Fixed
- Fixed the support of nested components inside the
Button
component. - Fixed the reset of the previous selection when
GridView.SetSelectionWithoutNotify
method is called.
[0.5.3] - 2023-10-16
Added
- Added
useSpaceBar
property inCanvas
component to enable or disable the handling of the space bar key.
Fixed
- Removed the handling of the space bar key in the
Canvas
component when the used control scheme isEditor
.
[0.5.2] - 2023-10-12
Added
- Added
acceptDrag
property to theGridView
component to enable or disable the drag and drop feature. - Added
menu
icon. - Added
AddDivider
andAddSection
methods to theMenuBuilder
component.
Fixed
- Fixed handling
acceptDrag
property inDragger
manipulator. - 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
Dragger
manipulator. Now the pointer is captured only if theDragger
manipulator is active (i.e. the threshold has been reached).
[0.5.1] - 2023-09-20
Added
- Added
selectedIndex
property to thePicker
component to get or set the selected index for a single selection mode. - Added a new
Enumerable
extension method calledGetFirst
to get the first item of an enumerable collection or a default value if the collection is empty. - Added
isPrimaryActionDisabled
andisSecondaryActionDisabled
properties to theAlertDialog
component. - Added styling for
AlertDialog
component semantic variants.
Fixed
- Fixed the
Picker
component to avoid to select multiple items if the selection mode is set toSingle
. - Fixed
Menu.CloseSubMenus
method to close sub-menus opened byMenuItem
components contained insideMenuSection
components. - Fixed double click handling in
GridView
component.
Changed
- Changed the picking mode of the
DropdownItem
component toPosition
instead ofIgnore
.
[0.5.0] - 2023-09-15
Added
- Added
outsideClickStrategy
property inAnchorPopup
component. - Added
DropZone
component. - Added
DropTarget
manipulator. - Added a sample for
DropZone
andDropTarget
components usage. - Added
--border-style
custom USS property to supportdotted
anddashed
border styles. - Added
--border-speed
custom USS property to animate the border style. - Added
Picker
component. - Added
closeOnSelection
property forPicker
andDropdown
components to close the picker when an item is selected.
Fixed
- Fixed the
Pressable
manipulator to only handle the Left Mouse Button by default. - Fixed current tooltip element check in
TooltipManipulator
. - Fixed incremental value when interacting with keyboard in
ColorSlider
component. - Fixed clearing selection in
GridView
when a user clicks outside of the grid. - Fixed
itemsChosen
event inGridView
to be fired only when the selection is not empty. - Fixed Navigation keys handling in the
GridView
to clamp the selection to the grid items.
Changed
- The
Pressable
manipulator nows inherits fromPointerManipulator
instead ofManipulator
. - Changed the
GridView.GetIndexByPosition
method 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.getItemId
function has been provided. - When using
--box-shadow-type: 1
(inset box-shadow), the--box-shadow-spread
value 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
Dropdown
component inherits fromPicker
component. Users will be able to create custom dropdown-like components by inheriting fromPicker
component. - The
Dropdown
component now has a selection mode property to choose between single and multiple selection modes. - The
Dropdown
component now usesDropdownItem
component instead ofMenuItem
component. - Removed
default-value
UXML property fromDropdown
component. The preferred way to set the default value is by code.
[0.4.2] - 2023-09-01
Added
- Added
FrameWorldRect
method to theCanvas
component. - Added
frameContainer
property to theCanvas
component.
Fixed
- Fixed the soft selection handling on
PointerUpEvent
in theGridView
component.
Added
- Added the
Picker
component.
Changed
- Changed
Dropdown
implementation to use the newPicker
component.
[0.4.1] - 2023-08-24
Added
- Added mouse and touchpad mapping presets to the
Canvas
component. - Added a setting to enable or disable gestures recognition on MacOS.
- Added selection mode in
ActionGroup
component.
[0.4.0] - 2023-08-18
Added
- Added the Small scale context to App UI. This context is now the preferred one for desktop platforms.
- Added
RangeSlider
component.
Fixed
- Fixed
ValueChanged
andValueChanging
events propagation inNumericalField
and Vector components.
[0.3.9] - 2023-08-17
Added
- Added Context API which is accessible through any
VisualElement
instance. - Added
preventScrollWithModifiers
property to theGridView
component.
Fixed
- Fixed
autoPlayDuration
property on PageView component. - Fixed value validation in
NumericalField
component.
[0.3.8] - 2023-08-08
Added
- Added
tooltip-delay-ms
property to theContextProvider
component to customize the tooltip delay. - Added more shortcuts to the
Canvas
component.
Fixed
- Fixed Editor crash when updating packages from UPM window.
[0.3.7] - 2023-08-07
Added
- Added
tooltipTemplate
property (by code only) onVisualElement
to customize the tooltip content.
Fixed
- Fixed Canvas manipulators for mouse devices and generic touchpads.
- Fixed Tooltip manipulator coordinates to pick elements under the cursor.
- Fixed Tooltip display for Editor context.
- Fixed random crashes when switching focused window.
[0.3.6] - 2023-07-28
Added
- Added
autoPlayDuration
property to thePageView
component. - Added
variant
property to theIconButton
component. - Added
Canvas
component. - Added
GridView
component.
Changed
- Changed the calibration values for Magic Trackpad gestures recognition.
Fixed
- Fixed horizontal ScrollView styling.
[0.3.5] - 2023-07-24
Fixed
- Regenerated the meta files inside MacOS bundle folder to avoid error messages in the console.
[0.3.4] - 2023-07-17
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-06
Added
- Added Magic Trackpad gesture support for MacOS.
- Added
PanGesture
andMagnificationGesture
events for UITK dispatcher.
Fixed
- Fixed
Pressable
post-processing for disabled targets. - Fixed visual content rendering synchronization in
Progress
andExVisualElement
components. - Fixed Animation Recycling in
NavHost
component.
[0.3.2] - 2023-06-01
Fixed
- Fixed NavAction being added twice in NavGraph when deleting a linked NavDestination.
[0.3.1] - 2023-05-17
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.3.0] - 2023-05-17
Added
- Added defaultMessage property on Dropdown component.
- Added ChangingEvent on TextField, TextArea and NumericalField components.
- Added the AppBar navigation component.
- Added the variant property on the Icon component.
- Added the support of Phosphor Icons through the
com.unity.replica.phosphor-icons
package. - Added the BottomNavBar component.
- Added the FAB component.
- Added the DrawerHeader component.
- Added the NavHost component.
- Added a ListViewItem component.
- Added the Navigation System under the
Unity.AppUI.Navigation
namespace (in its own non auto-referenced assembly). - Added the support of nested Navigation graphs.
- Added the INavVisualController interface to control the content of the navigation components.
- Added the NavController, core component of the navigation system.
- Added a sample called Navigation to demonstrate the navigation system.
- Added the support of Enum properties in the Storybook editor window.
- Added ObservableObject class to implement the INotifyPropertyChanged interface.
- Host and App interfaces to create MVVM apps based on specific hosts.
- Added UITK implementations of the Host and App interfaces.
- Added Dependency Injection support for MVVM Toolkit via constructor injection.
- Added an implementation of a ServiceProvider for MVVM Toolkit.
- Added an App Builder utility MonoBehaviour to create MVVM apps as Unity component in a scene.
- Added RelayCommand and RelayCommand
classes to implement the ICommand interface. - Added AsyncRelayCommand and AsyncRelayCommand
classes to implement the ICommand interface. - Added a sample project to show how to use MVVM Toolkit with App UI.
- Added the MVVM implementation under the
Unity.AppUI.MVVM
namespace (in its own non auto-referenced assembly). - Added a Redux implementation under the
Unity.AppUI.Redux
namespace (in its own non auto-referenced assembly). - Added the UndoRedo system under the
Unity.AppUI.Undo
namespace (in its own non auto-referenced assembly).
Changed
- The namespaces used by the package has changed from
UnityEngine.Dt.AppUI
toUnity.AppUI
. See the migration guide in the documentation for more information. Header
component is now namedHeading
. The old name is still supported but will be removed in a future release.- CircularProgress innerRadius property is now publicly accessible.
- App UI main Looper instance is now publicly accessible.
- Improved StackView logic to support the navigation system.
- Refactored Avatar component, there are no more containers for notifications and icons.
- Refactored Badge component.
[0.2.13] - 2023-06-28
Fixed
- Fixed RenderTextures destruction to avoid memory leaks.
[0.2.12] - 2023-06-01
Added
- Added
isExclusive
property to theAccordion
component. - Added
shortcut
property to theMenuItem
component.
Fixed
- Fixed TextArea input size.
- Fixed ValueChanged events on text based inputs.
- Fixed depth tests in custom shaders for WebGL platform.
[0.2.11] - 2023-05-12
Added
- Added
maxDistance
property to the World-Space UI Document component.
[0.2.10] - 2023-05-08
Added
- Added resistance property to the
SwipeView
component.
Fixed
- Fixed
Pressable
PointerDown event propagation.
[0.2.9] - 2023-05-04
Changed
- Removed
Replica
word from the documentation.
[0.2.8] - 2023-04-30
Added
- Added transition animations to sliders components.
- Added a
swipeable
property to theSwipeView
component to be able to disable swipe interaction. - Added
Preloader
component to the UI Kit sample. - Added
Link
component. - Added
Breadcrumbs
component to the UI Kit sample. - Added
Toolbar
component to the UI Kit sample.
Fixed
- Fixed
Pressable
event propagation.
Changed
- Updated USS vars to use the new version of App UI Design Tokens.
[0.2.7] - 2023-04-24
Added
- Added
Refresh
method to theDropdown
component. - Added AutoPlay to the
SwipeView
component.
Fixed
- Fixed the support of the New Input System.
- Fixed the box-shadow shader with portrait aspect ratio.
- Fixed async operations on LocalizedTextElement.
[0.2.6] - 2023-04-17
Added
- Added
innerRadius
property to theCircularProgress
component.
Fixed
- Fixed the RenderTexture format of the World-Space UI Kit sample.
[0.2.5] - 2023-03-30
Added
- Added
SnapTo
andGoTo
methods in the SwipeView component. - Added
startSwipeThreshold
property in the SwipeView component. - Added Scrollable Manipulator which uses a threshold before beginning to scroll.
- Added Pressable Manipulator which can be used to capture a pointer during press but can continue propagation of Move and Up events.
Fixed
- Removed the use of System.Linq in the App UI package.
Changed
- SwipeView now uses the Scrollable Manipulator instead of Draggable.
[0.2.4] - 2023-03-23
Fixed
- Fixed Localization initialization for WebGL platform.
- Fixed ScrollView tracker styling.
- Fixed Focusable property in constructor for newer versions of Unity.
- Fixed UnityEngine namespace import for newer versions of Unity.
[0.2.3] - 2023-03-22
Fixed
- Fixed styling on Scroller.
- Fixed max-height on Dropdown menu.
- Fixed dismissible dialogs in UI Kit sample.
- Fixed flex-shrink value on multiple components.
- Fixed TextField UXML construction.
[0.2.2] - 2023-03-20
Fixed
- Fixed NullReferenceException in invalid AnchorPopup updates.
[0.2.1] - 2023-03-07
Fixed
- Fixed the localization of the Dropdown component.
- Fixed the sizing of Progress UI components.
- Fixed OutOfBounds dismiss on cascading Popovers.
- Fixed the blocking of placeholder events on TextField and TextArea.
- Fixed compilation error on 2022.2.0a8.
[0.2.0] - 2023-03-05
Added
- Added support of Native features such as system themes and scale. The support has been done for Android, iOS, MacOS, and Windows.
- Added support of the Unity Localization package. You can localize strings from the Application Context or use a LocalizedTextElement component to localize strings from the UI.
- Added a global UI component property
preferred-tooltip-position
to set the default tooltip position. The property is available by code and UXML. - Added a App UI manager with a singleton pattern to manage the App UI configuration and lifecycle.
- Added an option in the App UI Settings to auto-override the Android manifest file (Android builds only).
- Added an option in the App UI Settings to enable or disable the usage of a custom loop frequency (Editor only).
- Added a World Space UI Document component to display UI elements in the world space.
- Added Avatar UI component to display an avatar with a name and a status.
- Added a Badge UI component to display a badge with a number.
- Added a BoundsField UI component to define a three-dimensional bounding box.
- Added a BoundsIntField UI component to define a three-dimensional bounding box with integer values.
- Added a Chip UI component to display a chip with a label and an icon.
- Added a CircularProgress UI component to display a circular progress bar.
- Added a LinearProgress UI component to display a linear progress bar.
- Added a ColorField UI component to define a color.
- Added a ColorSlider UI component to choose a value from a range of colors.
- Added a ColorSwatch UI component to display a color.
- Added a ColorWheel UI component to choose a hue from a color wheel.
- Added a ColorPicker UI component to choose a color from a color wheel and a color slider.
- Added a DoubleField UI component to define a double value.
- Added a Drawer UI component to display additional content from the sides of the screen.
- Added the support of
box-shadow
andoutline
using custom USS properties (see ExVisualElement). - Added a IconButton UI component to display an icon button.
- Added a LocalizedTextElement UI component to display a localized text. Most of the App UI components have been updated to use this component.
- Added a LongField UI component to define a long value.
- Added a Mask UI component to fill an area with a solid color.
- Added a PageIndicator UI component to display dots in a pagination system.
- Added a RectField UI component to define a two-dimensional rectangular area.
- Added a RectIntField UI component to define a two-dimensional rectangular area with integer values.
- Added a TextArea UI component to display a scrollable text area.
- Added the support of expression evaluation in numeric fields (see ExpressionEvaluator).
- Added an ActionTriggered UITK event that can be triggered by Menu items.
- Added a StackView UI component to display and animate a stack of items.
- Added a SwipeView UI component to display a list of items that can be swiped in a direction.
- Added a PageView UI component which is the combination of a SwipeView and a PageIndicator.
- Added the
Submittable
UI-Toolkit manipulator to handle the submission of Action UI elements via keyboard/mouse/pointer. - Added the KeyboardFocusController UI-Toolkit manipulator to differentiate the focus of a UI element from the keyboard or the pointer.
- Added a MenuBuilder class to create a Menu from code.
- Added the ability for Popover element to use a modal backdrop (Pointer events are blocked).
- Added a simple implementation of a Storybook-like tool to display and test UI components.
Changed
- The Application UI element is now called Panel.
- Improved the Slider UI component to display the current value.
- Improved the Tray UI element to be resizable.
- Ability to use the Modal component with any content derived from VisualElement.
- The App UI main Looper is now part of the App UI manager and is not present in the Application UI element anymore.
Fixed
- Fixed the Notification system when the Notificiation UI element has been destroyed without being dismissed.
- Fixed the Menu system to handle sub-menus.
- Fixed the position calculator of Popups.
- Fixed the Popup system to be able to dismiss a popup when clicking outside of it in an area that is not handled by UI-Toolkit.
- Fixed the formatting of numerical fields.
- Fixed the handle of some edge-cases in TooltipManipulator.
[0.1.0] - 2022-08-19
Added
- Package Structure
- First draft of User Manual documentation
- Accordion UI Component
- ActionBar UI Component
- ActionButton UI Component
- ActionGroup UI Component
- Button UI Component
- Checkbox UI Component
- Divider UI Component
- Dropdown UI Component
- NumericalField UI Components
- Header UI Component
- Icon UI Component
- Radio UI Component
- Slider UI Component
- Stepper UI Component
- Tabs UI Component
- Text UI Component
- TextField UI Component
- Toggle UI Component
- TouchSlider UI Component
- VectorField UI Components
- Dialogs & Alerts UI System
- Menu UI System
- Popup UI System
- Notification Manager & Toasts
- Message Queue System (Looper & Handler)
- ContextProvider System
- Tooltip System