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.
[2.2.7] - 2026-11-15
Fixed
MaskFieldshows its localized Nothing text when Unity Localization is installed, like its Everything and Mixed texts.- The Linux TextMateLib plugin exports only its
textmate_*C API. It used to export about 1,100 symbols (oniguruma, libstdc++ instantiations, rapidjson) into the Editor process, which could interfere with the Editor's own native code.
[2.3.2] - 2026-11-15
Fixed
MaskFieldshows its localized Nothing text when Unity Localization is installed, like its Everything and Mixed texts.- The Linux TextMateLib plugin exports only its
textmate_*C API. It used to export about 1,100 symbols (oniguruma, libstdc++ instantiations, rapidjson) into the Editor process, which could interfere with the Editor's own native code.
[3.0.0-pre.2] - 2026-11-14
Changed
Breaking:
App UI - Alias.ussdefines--appui-alias-field-padding-horizontal-sm,-mdand-lgin place of--appui-alias-control-padding-horizontal-*, following the design-token rename. The values are unchanged (var(--appui-sizing-200)). No UITK component reads them, so nothing changes size.AssetTargetFieldandAssetReferenceare now public, and the class covers both the registry'sasset-target-fieldandobject-field— the two registry files are identical apart fromobject-fielddropping the size prop and the clear button, so a separateObjectFieldtype would have been a strict subset duplicate. AddsshowClearButton,emptyLabel,customPicker,pickRequested,cleared,ClearValue()andOpenPicker(), and removes the type label the registry does not have.typeno longer nulls the value on a mismatch: it comparedAssetReference's runtime type against the filter and so could never match.Icon.primarynow defaults tofalse, matching the registry'sicon.tsx. Every component in the package that builds its own icons asks forprimary = trueexplicitly, so nothing in the package or the samples changes appearance; the difference is visible only to callers who construct a bareIconthemselves, which is exactly the case the registry governs.InputLabelnow covers the registry'sPropertyField: it gainsiconandcapValue, and its deadsizeUssClassNameconstant is removed (it was declared, never applied and matched by no USS rule). No newPropertyFieldtype was added —InputLabelalready was one,draggablealready published theDragContextthe registry callsscrub, and a duplicate class would have been the worse outcome.ButtonVariantnow matches the registry's six variants:Default,Destructive,Outline,Secondary,Ghost,Link. Thequietbool folds intoGhost, which is the same treatment under the registry's name. Note thatDefaultnow means the registry'sdefault, the solid accent button — the old neutralDefaultbecameSecondaryandAccentis gone, so every existingnew Button()changes appearance.The design sizing axis is now density (
normal/compact/comfort) instead of scale (small/medium/large).Panel.scalebecomesPanel.density,ScaleContextbecomesDensityContext, and the per-elementscaleOverridebecomesdensityOverride(UXML attributedensity). This fixes a live bug rather than only renaming: the tokens package moved to a theme × density matrix some time ago, soPanelwas writing anappui--mediumclass that no stylesheet had defined and the sizing axis was inert at runtime.Platform.scaleFactoris display DPI, is unrelated, and is unchanged.Sizemembers are renamedS/M/L→Sm/Md/Lg, emitting--size-sm/--size-md/--size-lg. This matches the shadcn registry's control sizes and the--appui-alias-control-sizing-{sm,md,lg}-*tokens the USS already consumed, so the class names were the last place the two vocabularies disagreed.Spacingis a separate axis with no registry counterpart and is unchanged.Textgains a colour axis and its sizes match the registry.bool primaryis replaced byTextVariant { Default, Secondary, Muted }bound to--appui-alias-text-{primary,secondary,disabled}, andTextSizedropsXXSand re-binds{XS, S, M, L, XL, XXL, XXXL}(names unchanged from 2.3,Mthe default), each step binding tovar(--appui-font-sizes-N)so the ramp responds to density.The font-size steps have a 10px floor in every density.
--appui-font-sizes-25(was 7px) and--appui-font-sizes-50(was 9px) are 10px at normal and comfort density. In compact, steps 25, 50 and 75 (were 5, 7 and 9px) are 10px and step 100 is 12px (was 10px), level with step 200. Steps 200 and up are unchanged, so text that reads the small steps, such asbody.xxs,body.xs,body.smin compact andheading.xxs, gets larger.Icons are now Vector Graphics assets. The 3,750 PNGs under
PackageResources/Icons/are replaced by the SVGs they were generated from, imported by Unity's built-inSVGImporterinto UI ToolkitVectorImageassets. Icons are now resolution independent — they stay sharp at everyIconSizeand on high-DPI displays, where the 64x64 PNGs used to soften. Tracked size drops from 19.7 MB to 7.7 MB, most of that saving coming from theTextureImportermetas.The Icon Browser accepts and previews
VectorImageassets, not just textures. Textures still work for custom icon sets.Custom icons are authored as SVG. Two importer constraints are worth knowing, since both fail quietly rather than loudly:
currentColoris rejected by the importer and its geometry is dropped, and monochrome glyphs must be authored white so--unity-image-tint-colorcan recolor them. Both are documented inDocumentation~/custom-icons.md. The@2xhigh-DPI guidance is gone — it no longer applies.Known limitation: Unity's SVG importer ignores
<filter>elements, so a handful of icons that relied on one lose that effect and render flat —ArvrArvr,EditorUiPin,EditorUiPinned,ScriptsShader,ScriptsShaderVariantCollection, the fiveMachineLearningMl*glyphs, and theird_dark variants. They import and draw, just without the filtered detail. This is an importer limitation rather than something the icon set can work around.The colored Editor icons' dark artwork now rides in
Icons.ussunder those marker classes, and the unusedIcons-Dark.ussis deleted. That sheet declared its overrides under a bare.appui, so it could only apply by being loaded afterIcons.ussand could not be scoped to a dark theme; nothing imported it.Icons.ussis instead partitioned - icons with a single artwork under.appui, icons with both under.lightand.darkand nowhere else - so no icon variable is declared twice and the outcome does not depend on USS declaration order.Icons - Minimal.uss, the set the package actually loads, is unaffected: none of its monochrome glyphs has dark artwork.The Icon Browser generates the same shape. A custom icon with a
d_-prefixed sibling is emitted into.light/.darkblocks, and a sheet whose icons have no dark counterpart is generated exactly as before. Reading a sheet back no longer mistakes its.darkblock for extra icons.Timelineclips now paint from--appui-alias-editor-clip, and frame clips from the--appui-alias-editor-track-*set, instead of the generic accent. These tokens are deliberately the same value in every theme mode, so a clip's identity does not change when the accent does.Field-shaped controls take their left and right padding from
--appui-alias-field-padding-horizontal-*instead of--appui-alias-control-gap-md, as the registry's fields do.TextFieldandNumericalFieldread the size-matched variant,DropdownandMaskFieldreadsmatSmandmdotherwise,TextAreareadsmd, andColorFieldreadsmdon its text edge and a step 2px tighter on its swatch edge, swapped under RTL. This widens these controls: the inset goes from 5px to 10px at Normal density (4px to 8px Compact, 6px to 12px Comfort), and from 8px to 10px forTextArea.Buttontakes its left and right padding from--appui-alias-actions-padding-horizontal-{sm,md,lg}by size andActionButtonfrom--appui-alias-actions-compact-padding-horizontal-{sm,md,lg}, as the registry does. AButton's icon and title containers no longer pad the outer edges with their own margins; the gap now sits only between two visible parts. Labelled buttons get wider: a NormalMdButtongoes from a 5px to a 16px inset, and anMdActionButtonfrom 8px to 12px. Icon-only buttons stay square.Field text takes the step the registry's field reads,
--appui-font-sizes-100(itstext-sm) or-200(itstext-base), instead ofbody-mdat every size. Values and placeholders grow one step atMdandLg: 12px to 14px at Normal density, 10px to 12px Compact, inTextField,NumericalFieldand every composite built on it (vector, rect and bounds fields,IntField,FloatField),DateField,TimeField,DateTimeField,SearchBar, theAssetTargetFieldlabel, theColorFieldhex and alpha readout, and theDropdown,MaskFieldandEnumFieldtrigger. AtSmthey stay at-100; forSearchBar,AssetTargetFieldandColorFieldthis departs from the registry, which keepstext-basethere, because atext-baseline does not fit a compactSmcontrol.Dropdownrows read-200at every size, as the registry'sMenuItemrows do. ATextFieldsuffix and aNumericalFieldunit read-100at every size.TextAreapins-100, the registry's desktop step.Breaking:
BaseDialog.size(soDialog,AlertDialogandConfirmDialog) is now aDialogSize(Sm,Md,Lg,Xl) instead of the sharedSize, andBaseDialogno longer implementsISizeableElement. ReplaceSize.Sm/Md/LgwithDialogSize.Sm/Md/Lg; UXMLsize="Sm|Md|Lg"is unchanged. The newXlis the registry's 48rem dialog (768px), and every width now reads its--appui-dialog-width-*token.ClampedContent fades with a real gradient drawn through
generateVisualContent, coloured by--clamped-content-fade-color.The test suite now uses the built-in
com.unity.ui.test-frameworkfor interaction coverage, through a newUIComponentTests<T>fixture hosting an App UIPanel, alongside the existingVisualElementTests<T>story and snapshot harness. Input goes through the framework'ssimulateAPI, whose calls are synchronous becauseFrameUpdate()runs the real UI Toolkit updater pass against a simulated clock rather than waiting on real frames; interaction tests are therefore plain[Test]methods with noyield return nulland noTimeUtils.timeOverride. ActionButton, AccordionItem, Tabs, Dropdown, TouchSliderFloat and SplitView are converted, which retires the two placeholderAccordionevent tests. A second snapshot harness,UISnapshotTests<T>, is built on the framework fixture and compiles only where the bundled package is 6.7 or newer, which is the first version that pins a runtime panel's size and scale topanelSize. Snapshots are now filed under a subdirectory ofSNAPSHOTS_OUTPUT_DIRnamed for the running editor, and there is exactly one set per editor: a component with a fixture in the new harness setscapturesSnapshotsElsewheresoVisualElementTestsstands down for it there, leaving every other component on the existing harness. Story file names are unchanged and identical across both, so two editors' folders can be compared image for image. Both keepWaitForEndOfFrame, becauseScreenCaptureneeds a real frame that simulated time cannot produce.The
com.unity.ui.test-frameworkharnesses now cover the whole component library rather than the six components that piloted them. Every component fixture that captures stories has aUISnapshotTests<T>counterpart carrying the same story list, and setscapturesSnapshotsElsewheresoVisualElementTestsstands down for it where the framework path compiles; the pair is verified in both directions, since an editor bundling the package below 6.7 keeps capturing everything on the old harness. Interaction coverage moves from a handful of components to every one with a reachable input surface, as<Component>BehaviourTestsfixtures onUIComponentTests<T>.UIComponentTests.testPanelSizeis now clamped to the screen:simulatebuilds its events in screen space, so a panel wider than the screen laid out fine and reported a validworldBoundwhile everything past the screen edge silently received no pointer event at all, which in a 640x480 batchmode editor put every right-aligned control — a field's picker icon, a SplitButton's caret, a card's close button — out of reach and failed their tests as though the components were broken. Card, TweakMenu and ZoomTriggerButton stay on the old harness because their stories wait on transitions throughWaitUntil/WaitForTransition, which the framework fixture does not provide and which simulated time would otherwise resolve into a capture of a half-finished animation.AppUIServiceCollectionand its baseServiceCollectionnow throwInvalidOperationExceptiononAdd,Insert,Remove,RemoveAt,Clearand indexer changes onceIsReadOnlyistrue, andICollection<ServiceDescriptor>.IsReadOnlyreportstruethen. Services added afterAppBuilder.BuildWith, for example inOnAppInitialized, now throw.HelpBox defaults to the Md size.
ChatTodoList's in-progress glyph is now a static filled ring rather than aCircularProgressspinner, matching the registry. A checklist shows several rows at once, and a spinning one pulls the eye away from the text, which is the part that actually changes.The story and snapshot harness now captures states it previously could not. A story is a coroutine rather than a synchronous element factory, and it is handed the capture container, so it can mount, yield for layout, then select a generated row, open an overlay, take focus or raise a pointer state before the frame is captured. The container itself now fills the themed
Panelinstead of hugging its content, which is what an absolutely positioned component —Toaster,FloatingWindow,TweakMenu— is framed against;Toasterwas clipping its whole stack against an effectively zero-height box. Fixtures can also opt out of the inherited barenew T()capture, for a component that paints nothing without content or a host. Both harnesses share the contract, andUISnapshotTestsdrives the coroutine off the test framework's updater pass.Menuarrow keys now wrap, as the registry's menu and dropdown-menu do: Down on the last row moves to the first and Up on the first moves to the last. Home and End jump to the first and last rows, and disabled rows are skipped because they cannot take focus. Up or End on the menu surface itself starts from the last row.
Fixed
Link.sizenow actually styles the link.Link.ussdefined no--size-*rules at all, so the property was dead. It also typedsizeas the 7-memberTextSizewhile the registry'slinkVariantsoffers onlysm | base | lg— keeping the wider enum with three rules would have left four steps matching no rule, the same silent bug that had brokenIcon.sizeis now a newLinkSize { Sm, Base, Lg }, defaultBase, with each step bound to the matching--appui-font-sizes-*token so the ramp is density-aware.Three of
Icon's five size steps, including the default, rendered with no width or height.Icon.ussdefines--size-{xxs,xs,sm,md,lg}butIconSizewas{XXS, XS, S, M, L}, and the[EnumName]generator lowercases member names, soS/M/Lproduced--size-s/-m/-land matched no rule.IconSizeis renamed to{Xxs, Xs, Sm, Md, Lg}and every step now binds to its--appui-alias-control-sizing-icon-*token rather than a raw--appui-sizing-*step.ToSize()throws forXxs/Xs, which have no control-size equivalent.SwitchBuilderruns every matching reducer case on the state returned by the previous one, so a slice no longer keeps only the last case's result. SeveralAddDefaultcalls now chain the same way.Action<TPayload>instances with different payloads, and async thunk actions with differentmetaor creators, no longer compare as equal throughIEquatable<Action>.Action.Equals(Action)is nowvirtual.StoreFactory.ComposeEnhancersreturns the identity enhancer when it is called with no enhancers instead of throwing.The Redux DevTools no longer keep committed actions in
actionsByIdwhenmaxAgeis set, andDispatchaccepts amaxAgeof 0 or 1.Async thunks run when DevTools is enabled through
StoreFactory.DefaultEnhancer.IThunkAPI.Abortcancels the async thunk instead of throwing when it is called on the main thread or from another thread, and so doRejectWithValueandFulFillWithValue.TryAddTransientregisters a transient service, andTryAddTransient(Type)andTryAddScoped(Type)add it only once.NavController.Navigate(Uri)resolves deep links with two or more path segments.GradientExtensions.TryParsereturns false for a gradient key with a single value instead of throwing, and accepts keys with surrounding spaces.PinchGesture.GetHashCodeis equal for gestures that compare equal.paper-plane-tiltwas missing from the Icon Browser's required-icons list while being present inIcons - Minimal.uss, so regenerating that sheet through the browser silently dropped it.Icon USS class names, the
--appui-icon-*variables and theIconcomponent's API are all unchanged. Custom stylesheets that reference the icon PNG paths directly need to swap the.pngextension for.svg.Samples, VisualDoc and skill examples read removed
--appui-spacing-*variables, so Storybook stories lost their padding and the console filled with warnings. They read--appui-sizing-*now, and a new editor test fails on anyvar(--appui-*)that nothing defines.Slider and RangeSlider thumbs disappeared outside Editor Dark because they read
--appui-color-dark-gray-*tokens. They read alias tokens defined in every theme.ColorSlider thumb sits on a checkerboard so a translucent value never leaves it looking transparent.
ChatActivityTimeline rows used
clockandwrenchicons missing from the minimal icon set, so they rendered blank.CodeEditor drew its text twice. The input glyphs are now hidden through USS and the caret blinks again.
ContextCounter is a pill instead of an ellipse, ChoiceList badge letters are centered, and the selected ChatConversationListItem text is readable.
VuMeter marker arrow points at the meter, and the CanvasEdge midpoint caret has the right orientation on level step edges.
The Toggle thumb uses the full width of the pill in both densities.
Toaster looks like Toast: shadows are no longer clipped, toasts wrap, and entries update in place and fade in and out.
The first drag of a FloatingWindow keeps the pointer offset instead of jumping.
Checkbox and Toggle sizes follow the web components. The checkbox box is 12, 16 and 17px at normal density with a 4px radius, the md toggle is 30 x 17px, and compact rescales them through the sizing ramp. The Checkbox and Toggle label gap is
sizing-160(8px), matching the webgap-2.MaskFieldshows its localized Nothing text when Unity Localization is installed, like its Everything and Mixed texts.Rect.IsValidandVisualElement.IsOnScreenno longer treat a zero-area rect as valid on engine builds whereMathf.Epsilonevaluates to 0.The Styling manual page now says how to style a disabled state:
SetEnabled(false)puts the whole subtree in:disabled, so anopacityrule multiplies down the tree, and a disabled rule reads the role's*-disabledcolour variables instead.EnumField(Enum defaultEnumValue)now populates its items. The constructor guarded the call toInitondefaultValuerather than on its owndefaultEnumValueparameter, anddefaultValueresolves to the inheritedPicker.defaultValue, the array of default selected indices. Since the constructor chains throughbase(null, ...), that array was always null, the guard was never true, andPopulateDataFromTypenever ran — so the constructor the class documents as the preferred one produced a field whose menu had no items and could not open, becausePicker.OnClickedbails out whensourceItemsis empty.FloatingWindowTestsno longer depends on the display's DPI scale. The clamp test asserted an absolute starting position for a window restored at 400,300 with a 200x150 box, but the host it is clamped against fills the panel, whose size is the screen divided by its DPI scale — so a 1200x600 screen is a 1200x600 host on a 1x display and only 600x300 on a 2x one. On a 2x display the saved position no longer fit,ClampPositionpulled the window up to y=150, and the test failed in a player while passing in the editor.Mountnow takes an optional host size, which that test pins, withflexShrinkdisabled so a panel shorter than the requested host does not pull it back down.The Linux TextMateLib plugin exports only its
textmate_*C API. It used to export about 1,100 symbols (oniguruma, libstdc++ instantiations, rapidjson) into the Editor process, which could interfere with the Editor's own native code.A navigation destination with no template set no longer throws
ArgumentNullExceptionfromDefaultDestinationTemplate.CreateScreen.Type.GetType(null)throws rather than returning null, so an unset template crashed instead of falling back to the default screen, and the "template type is not set" warning was only ever reachable via an empty string.The native platform P/Invoke declarations that return a
boolnow pin one-byte marshalling with[return: MarshalAs(UnmanagedType.I1)]. Without it a[DllImport]returningboolmarshals as the 4-byteUnmanagedType.Bool, while everyNativeAppUI_*entry point returns a 1-byte C++bool; on x86-64setcc %alwrites only the low byte, so register residue in bits 8-31 could read back astruewhen the native answer wasfalse.The theme dropdown shown for
Panel.themeandBaseVisualElement.themeOverrideoffered only four of the six shipped themes:cloud-darkandcloud-lightwere missing, despite both shipping as.class.ussfiles and being wired intoApp UI.tss. All six are now listed, hyphenated names render as "Editor Dark" rather than "Editor-dark", and a theme name the dropdown does not recognise — one defined by a hand-written stylesheet, say — is preserved instead of being silently rewritten to the first entry.A
Thread's action menu button can now be shown.Thread.usssetdisplay: noneon.appui-thread__actionsand never lifted it, so the button was unreachable no matter what: assigningmakeActionMenuItemscleared the hidden class, but the USS rule still kept the element out of layout, leaving the menu impossible to open. The stylesheet now carries the hover and--actions-openreveal rule thatThreadMessage.ussalready had, so the button appears while the thread is hovered and stays visible while its menu is open.Store.Dispatchno longer throwsInvalidOperationExceptionwhen a listener subscribes or unsubscribes while it is being notified. Subscribers are now notified from a snapshot, and a subscription that is unsubscribed while it is being notified no longer throwsNullReferenceException. Its listener may still be called once.IDisposableSubscription.IsValid()returnsfalseinstead of throwing aNullReferenceExceptiononce the subscription or its store is disposed.The
Optional<float>,Optional<double>andOptional<Rect>UXML converters,RectExtensions.TryParse,GradientExtensions.TryParseand the float sliders now read and write numbers with the invariant culture, so0.5is no longer read as5under a decimal comma culture. Values saved with the current culture by earlier versions, such as0,5underde-DE, still load, and the sliders' input field still accepts them. TheOptional<int>andOptional<long>converters read the same way.DateConverterandDateRange.TryParsenow parse serialized dates with the invariant culture, so dates no longer swap day and month or shift calendars under other cultures.DatePickerrebuilds its day grid for months before 1970, and keeps it valid at the first and last supported month, where the outward month, year and decade arrows are now disabled instead of throwing.Sliderarrow keys withrestrictedValuesset toSteporCtrlStepnow move by the right step with Shift, step without Ctrl forCtrlStep, and no longer throw with Ctrl.Dragging with touch and pen pointers works again on
Draggable-based controls such as sliders,SplitViewandTray.ActionGroupchildren and its overflow button now follow an inheritedvisibility: hiddeninstead of forcing themselves visible.Radioregisters with itsRadioGroupagain when it is re-attached to a panel, so radio buttons keep working and keep their selection in content that is shown more than once, such as aPopoverorDialogTrigger.Setting
UndoStack.indextoUndoStack.count, or to0on an empty stack, now throwsArgumentOutOfRangeExceptioninstead of hanging.UndoStack.isCleanno longer reportstrueafter the clean state was reset withResetClean, dropped by aPushor evicted byundoLimit, including when the clean state was the initial one. APushthat drops the clean command now raisescleanStateChanged, andResetCleanraises it only whenisCleanorcleanIndexchanges.AsyncRelayCommand<T>withAllowConcurrentExecutionsnow cancels the previous run whenExecuteAsyncis called again, soCancel()reaches every run.AsyncRelayCommandandAsyncRelayCommand<T>now raiseCanExecuteChangedand their completionPropertyChangednotifications when a run is cancelled, instead of throwingTaskCanceledExceptionand leaving bound buttons disabled. A faulted run also raises them now, and its exception is still logged, including anOperationCanceledExceptionthat did not come from cancelling the run.App.currentis no longer cleared when a differentAppinstance is disposed or finalized.Handler.RemoveCallbacksAndMessagesno longer removes messages sent through other handlers that share the sameLooper. Messages whose target is not the calling handler, such as one fromMessage.Obtain(null, ...), are no longer removed by it either.Message.Obtainkeeps reusing pooled messages after more than 50 messages have been recycled.NavDestination.MergeArgumentsnow replaces a default argument with a provided argument of the same name instead of keeping both.NavGraphViewAsset.FindDestinationByRouteno longer throwsInvalidCastExceptionwhen the route names a navigation action. It returnsnull, or the destination of that name if there is one.ColorFieldno longer throwsArgumentExceptionwhenhdristrueand a channel is above 1.ColorExtensions.ColorToRgbaHexnow clamps each channel.The
Breadcrumbsseparator no longer shrinks. A cramped bar squashed the/separators to nothing instead of ellipsizing the crumb labels, which is the one thing in the trail that cannot afford to lose width.The component design tokens now reach the UPM package.
generate-uss.jscopies the tokens'components.usstoThemes/App UI - Components.uss, and every theme's.tssimports it after the Alias sheet and before the component sheets, so a value a component sheet already defines still wins and nothing changes on screen. UITK's Slider progress now reads--appui-slider-progress-background-color, which resolves to the same accent as before in every theme.Eight icons no longer lose their outline in UI Toolkit.
AnimationAnimationClip,AnimationAnimator,AnimationAvatarMask,AnimationLegacyAnimation,AnimationPlayableDirector,AnimationTimeline,EditorUiLogandMachineLearningMlBrainPlayerwere Figma "outside stroke" exports, where the expanded stroke is a separate path carryingmask="url(#path-N-outside-N)". Unity's importer implements<mask>as a geometric clip, so that path was dropped and each glyph rendered as a thin skeleton of itself. They are reauthored as plain filled paths; measured against a player capture the eight regain between 18% and 77% of their ink, and each rasterizes to within a per-channel delta of 1 or 2 of the original artwork. Reported upstream as UUM-153815.IconContactSheetTestspins its ownPanelSettingstoConstantPixelSizeat scale 1 instead of inheriting the shared fixture'sConstantPhysicalSize. That mode scales the panel byScreen.dpi / referenceDpi, which a headless CI agent resolves to 1 but a Retina workstation resolves to 2, so half the grid fell outside the capture and every cell held a different icon than the oracle's. The sheets still came out the right size and nothing failed, so the comparison simply reported several hundred icons broken. The grid is a pixel contract with the oracle rasterizer, so the fixture now fixes the scale rather than inheriting the display's.PlatformAdsandEditorUiMarkerrender whole in UI Toolkit.PlatformAdscarried a stray zero-area path far outside itsviewBox, and the importer sizes aVectorImagefrom tessellated geometry rather than the declaredviewBox, so the glyph was squashed into a third of its cell.EditorUiMarkerwas a Figma "outside stroke" export whose outline path was masked, and the importer implements<mask>as a geometric clip (SVGParser.ParseMaskassigns the mask's shapes toSceneNode.Clipper), which dropped two thirds of the artwork. Both are reauthored as plain filled paths that rasterize identically to the originals. Reported upstream as UUM-153815.Dialog secondary, cancel and close buttons follow their semantic variants again instead of all rendering accent.
Popovers no longer dismiss as soon as they open, and ZoomableThumbnail opens a dismissable Modal.
ContextCounter is a true pill, ChoiceList badge letters are centered, and DropZone and VuMeter samples render with spacing.
Component text sizes follow the web registry tiers (for example Button, Tabs, Menu and HelpBox text is 14px at normal density instead of 12px).
Component gaps, paddings and icon sizes match the web registry at every density: Button, ActionButton, SplitButton and Dropdown icon gaps, TextField adornments, Tabs, Menu items, HelpBox, Toast, Badge, Chip, Kbd and ActionGroup.
The panel root text size is 14px at normal density (12px compact) like the web, so unsized labels no longer render one tier smaller.
App UI shaders no longer fail to compile on Unity 7000, where the
UnityCG.hlsl/UnityUI.hlslincludes they expected do not exist; they now includeUnityCG.cgincon every Unity version.Fixed Tabs throwing "Cannot scroll to a VisualElement that's not a child of the ScrollView content-container" when TabItems are deleted from it in UI Builder. Tabs now picks up TabItems added to or removed from its item container directly, and keeps the same tab selected when it can (UUM-154224).
AssetTargetField's leading icon had no styling at all. The stylesheet targeted__leading-iconwhile the C# added__icon, so no rule ever applied. A test now pins that every class the C# adds has a matching USS rule.CardGridnow lays out correctly under.appui--rtl. It computes its column arithmetic in C# because UI Toolkit has no CSS grid, and the gap was written only asmargin-right, so a right-to-left panel flowed from the wrong edge. It now tracksDirContextthe waySplitViewdoes, flips the row in USS the wayBreadcrumbsdoes, and always writes both margins so a runtime direction change leaves nothing stale.The documentation now describes the v3 API. The UITK code panes still showed
Size.S/M/L,TextSize.XS…XXXL,ButtonVariant.AccentandText.primary, and Button's variants pane listed three while the prose above it promised six. The "Platform Scale" fundamentals page is retitled "Density" — its body already documented density, only the title and the pages linking to it still said scale.GradientEditorno longer reports its own internals' change events as its value changing.ColorSwatch's setter sends a bubblingChangeEvent<Gradient>, and the editor refreshes two swatch-based children on every edit, so a single change reached a consumer three times and merely selecting a stop reached it once — carrying the swatch's gradient rather than the edited one.ObjectPickerno longer leaks its internals' change events to consumers. Its value is an item id, and so is what the search field and every preview text element report as they bubble — a consumer saw four change events for one selection, with preview metadata reading as selection changes. The picker now stops foreign string events at its boundary.Fixed the navigation graph code generator emitting node names without escaping. Names containing
-,., a leading digit, a C# keyword, or a double quote previously produced a file that either failed to compile or injected arbitrary members into the generated source. Node names are now converted to valid, unique C# identifiers and emitted as properly escaped string literals.The AI Agent Skills panel in the Package Manager now only appears for the App UI package, instead of for any installed package that happens to ship a
Plugins~/skills.json. Skill installation is also now confined to the project: the search for a.claudedirectory no longer walks above the project root, so skills are installed to<project>/.claude/skillsrather than potentially to a shared~/.claude/skills.DrawerHeaderandThreadComposerrender correctly at normal and comfort density again.DrawerHeader.usssetsmin-width: var(--appui-sizing-3000)andThreadComposer.usssetsmax-height: var(--appui-sizing-2000), but neither step existed outside.appui--compact, so both properties silently resolved to nothing for anyone on the default density. Picked up by regenerating the theme USS after the tokens ramp was made uniform.TimeSpanandDateTimeUXML attribute converters are now registered. Unity ships neither, so avalue=attribute on a time or date-time field silently did nothing.Fixed XML documentation on
AssetTargetField,AudioWaveform,AnimationCurveField,CurveEditor,ColorGradientField,GradientEditor,ObjectPicker,Timeline,TreeListandVuMeter, which failed PVP-150-1. Loose prose and<list>elements sitting directly under<remarks>are now wrapped in<para>,Timeline.zoomno longer nests<see>inside<c>, andTreeList's two<example>blocks are merged into one.The UI Kit sample's TWEAK MENU section no longer fails the player build. It set
min-heightthrough an inlinestyle="min-height: var(--appui-alias-control-sizing-lg-height);"attribute, but UI Toolkit resolvesvar()against the element's stylesheets and an inline style has no stylesheet context, so the variable resolved to null andVisualTreeAsset.CloneTreethrew aNullReferenceExceptionout ofStyleVariableResolver.ResolveVariable. The scene failed to open with "The UXML file set for the UIDocument could not be cloned", which took the StandaloneLinux64 player build down with it. The value now comes from an.example-section-min-control-lgrule inExamples.uss, where the token resolves.Timeline'sfitWidthnow divides the width left after the fixedoriginandendPaddinginsets rather than the whole viewport, so a fitted axis actually fits instead of overflowing by 40 px and staying pannable.A fixed-size
FloatingWindowis re-clamped when only its container resizes.GeometryChangedEventwas registered on the window itself and does not bubble down from the parent, so a window whose own geometry never changed could be left hanging off the edge of a shrunken container.ObjectPickerkeeps previewing the selected item when the current search or tab filters its row out of the list. The preview resolved the item from the visible rows, so filtering appeared to clear an assignment that was still set.Removing a selected
TreeViewItemnow goes through the normal selection path: the detached row loses itsselectedflag instead of coming back highlighted when reused, anallowNoSelection = falsetree falls back to a visible row instead of reporting an empty selection, andselectionChangedis raised.Arrow-key stepping in
DateTimeFieldno longer throws atDateTime.MinValueorDateTime.MaxValue, both of which are legal values for the field. Stepping past the boundary saturates.GradientEditorandCurveEditorreport the loaded value aspreviousValueon the first interactive edit.SetValueWithoutNotifycleared the baseline, so the first change after initialization — including the normalShow(..., initialValue)path — handed consumers a null previous gradient or curve.A queued
ConfirmDialogrequest whose host element left the panel before its turn no longer strands the queue.Modal.Buildthrew with the queue already marked busy, so that request never resolved and every later confirmation stayed queued forever. Detached hosts are now skipped and resolved, and a failure to show releases the queue.ImageLightboxshows aVectorImageinstead of its fallback.hasImageaskedNaturalSize(), which deliberately reports zero for a vector image because it has no pixel resolution to cap against — a sizing question that was deciding whether an image existed at all.Seven capture cases that were blank or duplicated another story.
TweakMenu.CloudDarkset its theme and density before mounting, whichOnAttachedToPanelthen overwrote with the host panel's, so it photographed the same closed trigger asDefault; it now sets them after attachment and opens the menu.ListBox.MultipleSelectionandTreeList.Multipleonly setselectionType, which has no resting appearance, and now select two items once the rows exist.Card.Interactivewas pixel-identical toDefault, sinceinteractiveonly changes the cursor at rest, and now carries its hover state.ZoomTriggerButtonrests atopacity: 0, so its standaloneDefaultcould only ever be blank; it is replaced byAlwaysVisibleandFocused, the latter waiting out the 125 ms reveal transition.BreadcrumbsandAccordioncaptured empty containers and now carry content,HeadingandLocalizedTextElementcaptured empty text and now carry some, andSpacerandExVisualElement— which paint nothing in any theme — contribute no capture at all. Each of these is now pinned by a test that asserts the story establishes the state it is named for, since a capture asserts nothing on its own.A story that lays out to nothing now fails instead of writing a blank capture. Auditing the fixtures once would only have held until the next empty container, so the harness refuses the capture and names the fixture; a component that genuinely paints nothing at any size says so through
hasDefaultStory. That turned up 21 more fixtures inheriting a contentlessnew T():Menu,MenuSection,RadioGroup,AvatarGroup,StackView,SplitView,PageView,SwipeView,CanvasandMarkdownViewcaptured empty containers,BreadcrumbItem,FieldLabel,HelpTextandInputLabelcaptured empty text,PageIndicatorcaptured no pages, andColorWheel,SVSquareandMaskare shader-drawn with no intrinsic size, so an unsized one had no box to draw into. All now carry content or a size.NavHost,DialogTriggerandMenuTriggerare anchors and handlers with no visual of their own and contribute no capture.Three stories were captured mid-transition, which the earlier fix for
ZoomTriggerButton.Focusedhad only found in that one place.TweakMenu.CloudDarkyielded once after opening its menu, but aPopoverfades in over 150ms, so the capture caught it at 18% opacity;Card.Interactiveyielded once after raising its hover class, against a 200ms background-color transition. The harness now offersWaitUntilandWaitForTransition, both bounded by wall clock rather than a frame count, because a headless frame is a fraction of a millisecond and no plausible number of them adds up to a transition.Card's counter-check also compared the attached card against a freshly built, unattached one, whose styles never resolved — it would have passed with the hover rule deleted; it now compares the same card before and after.A disabled
DropdownorMaskFielditem dimmed with 0.5 opacity, which compounds down a disabled subtree. It now takes--appui-alias-text-disabledfor its text, glyphs and checkmark, at full opacity.Disabled
MenuItem,Chip,Sliderand theDatePickermonth and year buttons now paint the role's*-disabledcolour tokens instead of dimming with opacity. A disabled subtree matches a:disabledrule at every level, so the opacity compounded, andMenuItemapplied it on top of its disabled colours. Menu rows read--appui-alias-text-disabled(a selected row keeps--appui-alias-actions-selected-background-color-disabled), chips read--appui-alias-actions-{background,border,foreground}-color-disabled, and the month and year buttons read--appui-alias-text-disabled. The slider's track reads--appui-alias-field-background-color-disabled, its range and thumb--appui-alias-text-disabled, and the thumb rim and marks--appui-alias-control-border-color-disabled.ColorSliderstill dims with opacity, because its track and thumb show a colour value. A menu row's shortcut now reads--appui-alias-text-tertiarywhile enabled, rather than a disabled colour.InputLabel's label now reads--appui-alias-inspector-label-sizeand--appui-alias-inspector-label-color, as the registry'sPropertyFieldlabel does, instead of the form-label size a standaloneFieldLabeluses. At normal density it renders at 14px rather than 12px. A standaloneFieldLabelis unchanged. The inspector label line-height has no USS equivalent and is not read.A hovered
Toastaction now fills with--appui-alias-actions-quiet-background-color-hover, the hover of a transparent action, as the registry's toast action does, instead of the raw--appui-color-transparent-black-100palette step. That fill is opaque, so the hovered action text takes--appui-alias-actions-quiet-foreground-color-hoverwith it, keeping it readable on the coloured variants in a light theme. A pressed action pairs--appui-alias-actions-quiet-background-color-activewith its quiet foreground the same way, in place of--appui-color-transparent-black-300.The
ColorFieldopacity readout was as wide as anLgcontrol is tall, 30px at Normal density, which once the field inset was added left the value no room at all. It now reads--appui-sizing-1350, the step nearest the registry'sw-16, so a full100fits at every size and density.ColorPicker's hex field is nowSm, as the registry's value field is.A
Chipwith a long label now cuts the label on one line with an ellipsis and stays inside a narrower parent, as the registry's chip does. Before, the chip refused to shrink and overflowed its parent with the whole label.A pan on a
Canvasno longer reaches the content under the pointer, as the registry's canvas does. A middle-button press, or a primary press with Space held (Alt in the Editor control scheme), is now taken in the capture phase, so whatever sits under it is never pressed, selected or dragged. Before, a child that handles the press, such as a draggable element, took the press first and the canvas never panned.DialogandAlertDialogkeep their actions inside the dialog, as the registry's dialogs do. Actions too wide for one row now wrap onto another instead of running past the dialog's edge, content taller than the modal scrolls between the heading and the actions instead of pushing them out of reach, and the title wraps a long unbroken token such as a URL instead of clipping it, up to about four lines. The content now sits in aScrollViewwith the classappui-dialog__content-scroll, which carries the content's top margin, and the dialog's horizontal padding is split between the dialog and a 4px gutter on each part so a focused control's outline is not clipped; a stylesheet that targeted.appui-dialog > .appui-dialog__contentor its margin needs to target the scroll view instead.An emphasized
Checkboxthat is checked or indeterminate now paints its box and mark from--appui-checkbox__box-checked-{background,border,foreground}-color, as the registry checkbox does, instead of the raw--appui-accent-100step. Cloud Light and Editor Light, whose accent alias is not that step, now show the intended fill, and a theme that overrides the checked-box tokens reaches UITK.ColorPickerbrackets a drag on its wheel, saturation-value square or any channel slider as one gesture, as the registry's color picker does. It now implementsINotifyValueChanging<Color>and sendsChangingEvent<Color>while the pointer is down and a singleChangeEvent<Color>at release, so undo and value-changed callbacks see one change per drag instead of one per pointer move. A key press on a sub-control is still a discrete edit and commits at once. AColorFieldpicker, inline or in a popover, still previews live through the changing events, and a drag that loses the pointer to another element (aSwipeView, say) still commits.
Added
- Added
ListBox, the containerListViewItemwas missing. It is a single-columnGridView, so it inherits the App UI collection contract —itemsSource,makeItem/bindItemrecycling, row virtualization,selectionType(single by default, matching the registry'sselectedIdmodel) and keyboard navigation — rather than wrappingUnityEngine.UIElements.ListView.ListBox.sizepublishes aSizeContextso every realizedListViewItemadopts it, and with nomakeItemthe list buildsListViewItemrows titled from the data item. NewListBox.ussbinds each size step to the control-sizing height aliases, andListViewItem.ussnow takes its hover and selected backgrounds from the control and actions-selected aliases instead of a raw background step. It is namedListBox, notListView, so a file that imports bothUnity.AppUI.UIandUnityEngine.UIElementsstill resolvesListViewto UI Toolkit's. - Added
TreeList, the containerTreeViewItemwas missing: expand/collapse, the three selection modes, and keyboard navigation over the visible rows (arrows, Home/End, Right to expand or step in, Left to collapse or jump to the parent, shift-extend, action+A, Escape). Selection matches the registry —selectedItemsis primary-first, a shift-range puts the clicked item first, and the anchor holds across repeated shift-clicks. LikeListBox, it is namedTreeList, notTreeView, so it never shadowsUnityEngine.UIElements.TreeView. - Closed the remaining
TreeList/TreeViewItemgaps against the registry.TreeListgains drag-to-reorder — anonReparenthandler that gates the whole surface, aDraggerbuilt the wayBaseGridViewbuilds its own, before/after/inside drop positions read from the row's 25% edge bands, per-row drop indicators, and a typedTreeListDragPayloadcarryingTreeList.treeItemMimeType(application/x-appui-tree-item) in place of the web'sTREE_ITEM_MIME— plusonDeleteSelectionon Delete/Backspace with no default behaviour.TreeViewItemgains aniconslot, a publiclabelElementin place of the web'slabelClassName, atrailingslot withtrailingVisible, hover reveal, a measured label reserve and a narrow-row overflow that collapses the strip into aPopover,caretPosition(Startby default, matching the registry, where UITK previously hardcoded an end caret) anddraggable. Breaking: the caret now sits in a leading gutter by default rather than after the label, and the row markup gained a__caret-gutter,__icon,__trailing-container,__overflow-buttonand drop-indicator elements. The web's gradient label fade has no UI Toolkit equivalent, so an over-long label ellipsises and the row reserves the measured strip width instead of letting text run under the actions. - Factory registration for the dependency injection container:
ServiceDescriptor.Singleton,ScopedandTransientaccept aFunc<IServiceProvider, object>(or a genericFunc<IServiceProvider, TService>), andAddSingleton,AddScopedandAddTransienthave matching overloads. A factory can forward to another registration, so one singleton can be exposed under two interfaces.ServiceDescriptor.Singleton<TService>(TService instance), a publicServiceDescriptor(Type, Func<IServiceProvider, object>, ServiceLifetime)constructor and theServiceDescriptor.implementationFactoryproperty were added too. components.dialog.width.{sm,md,lg,xl}(--appui-components-dialog-width-{sm,md,lg,xl},--appui-dialog-width-{sm,md,lg,xl}in USS), the widths of a small, medium, large and extra-large Dialog: 400px, 500px, 640px and 768px.RichTextUtils.EscapeandRichTextUtils.NeutralizeNoParsefor safely embedding untrusted text in UI Toolkit rich text, andHrefUtils.IsSafeHreffor validating markdown link destinations against an allow-list of schemes.IMentionProvider.ConvertToRichTextimplementations should useRichTextUtils.Escapeon every user-supplied segment.- A ScriptedImporter for
.appuitheme.jsonfiles exported by the App UI Theme Builder. Dropping one into a project produces anAppUIThemeAssetcarrying a compiledStyleSheetandThemeStyleSheet, so a custom theme no longer has to be hand-written USS. Apply one withpanel.styleSheets.Add(theme.styleSheet)followed bypanel.theme = theme.themeName, which layers over the active App UI theme so undefined tokens keep their base values, or assign itsthemeStyleSheettoPanelSettingsto replace the theme file outright. Imported themes also appear in the theme dropdown in the inspector. A Theme Builder theme is a family exported as one file per appearance (ocean-dark,ocean-light); besides App UI's tokens a file can carry the consumer's own custom properties under their full--name, and values that are lengths, numbers or a singlevar()reference, which is how a density-relative metric such asvar(--appui-sizing-500)reaches USS. ColorFieldgainsshowAlphaValue, an opacity readout beside the hex as an editable, scrubbable percentage that rewrites the value's alpha, so the readout and the picker's alpha slider always agree. It needsshowAlpha: a field with no alpha channel has no opacity to show, so clearingshowAlphahides the readout whatever the flag says, while the flag itself survives the channel going away. The registry's hex-shorthand expansion has no counterpart here because the value is aColor, not a string; what does carry over is that a readout event matching the current percent is ignored, so editing another channel cannot quantize an alpha nobody touched. The readout rides the field's own rim with a single hairline rather than drawing a second one.App UI - Alias.ussdefines--appui-alias-control-padding-horizontal-sm,-mdand-lg(allvar(--appui-sizing-200)), the control horizontal inset added to the design tokens. No UITK component reads them yet: UITK fields still take their inset from--appui-alias-control-gap-md, so nothing changes size.InputLabel, the package's property row, gainsrowLayoutwith anInputLabelRowLayout.Gridmode pluscolumnsandtall, matching the registry'sPropertyField layout="grid". The row sits on the inspector column grid from the newalias.inspector.*tokens, so labels and controls line up down a whole panel and a long label truncates instead of pushing its control out of column. The property isrowLayoutrather thanlayoutbecauseVisualElement.layoutalready exists and hiding it would be a bug, not a rename. UI Toolkit has neither CSS grid norcalc(), so the label cell's share of the row is computed from the two column-count tokens and applied as a percentage basis — the column edges still coincide across rows, and the gap comes out of the control cell, which is the one that grows. A grid row moves its leading icon inside the label cell, since an icon beside it would put that row's control one icon-width off the column above.columns = InputLabelColumns.Evenshares the control cell evenly between the children rather than handing out subgrid spans, which UI Toolkit has no equivalent for; a child that needs a bigger share sets its ownflex-grow.- The theme stylesheets carry the six new
alias.inspector.*variables:--appui-alias-inspector-row-height,-row-gap,-section-gap,-grid-gap,-grid-columnsand-grid-label-columns. They state the inspector rhythm once, so every property row and every group in a panel resolves the same values, and the four sizing-backed ones rescale with density like the rest of the ramp. Regenerated from@unity/app-ui-tokensrather than hand-edited. - Added
PropertyGroupandPropertyGroupStack, the collapsible group an inspector panel is built from. The title sits on the text line with no caret and a closed group that holds rows shows an ellipsis instead, so a folded section still says it holds something; an empty group is not a disclosure at all, so its toggle is disabled and shows no ellipsis rather than claiming to be open.trailingContaineris the slot at the end of the header line, outside the toggle, and the hover fill moves from the toggle to the header row when it is used, so hovering the actions lights the same pill as hovering the title. UI Toolkit has nogap, so both the row rhythm and the section rhythm are a leading margin with the first child tagged, refreshed on layout the waySidebarSlotdoes it. - Every slider built on
BaseSlidergainsscrubStartedandscrubEnded, plus ascrubbingflag: the bracket around one pointer drag that a caller needs to open and close a single undo group while the value streams. An end always follows a start. A pointer released off-window, a capture stolen by another element, a cancelled gesture and the slider leaving the panel mid-drag all close the bracket, because thePressabledeactivation paths never reach the track's own pointer-up handler and an undo group would otherwise stay open for the rest of the session. Keyboard steps are not a gesture and raise neither, and a drag that ends on the value it started from still closes its bracket. - Added
SplitButton, one bordered control in two parts with the secondaryButton's chrome, so a toolbar row of plain buttons and split buttons reads as one row. The registry ships three components because the caret is almost always somebody else's trigger; here it is one element with two press targets, because the trigger contract does not exist in UI Toolkit:clickedruns the action,caretClickedis the cue to show the options, andcaretElementis what aPopoveror a menu anchors to.selectedmakes the main part a toggle and the element never flips it itself, so the state stays the caller's, and the selected fill stops at the main part since the caret offers options and carries none of the state. The registry's adjacent-sibling rule for the glyph-to-label gap becomes a class the component sets, because an unsupported USS selector fails the whole stylesheet rather than its own rule. TreeListgainscaretIcon, the disclosure glyph every row in the tree draws, so a denser tree can ask for a shallower chevron in place of the default caret. The glyph still rotates with the row's expansion and the caret gutter keeps its width, so this is a swap inside the existing row anatomy. The tree hands the name down as a context rather than walking its rows, which is what makes a row added later draw it too, andTreeViewItem's caret is now anIconso the glyph comes from an icon name instead of a hardcoded background image.TreeViewItemgainslabelBadgeandlabelBadgeLabel: a glyph that belongs to the name — a startup-scene star, a dirty marker — sitting right after the label so it follows the name's length, unliketrailingContainer, which pins to the row's end. A badged row stops its label from growing, or the badge would be carried out to the trailing edge and read as an action. The reserve that keeps text clear of the trailing strip moves onto the badge when there is one, since leaving it on the label would push the badge under the very strip the reserve exists to avoid.labelBadgeLabelis the words for what the badge means, carried as its tooltip, because a glyph on its own tells a first-time reader nothing and the badge is too small to label in place.com.unity.modules.vectorgraphicsas a dependency. It is a built-in module shipped with the Editor since Unity 6, and the package already required Unity 6000.3, so there is nothing extra for consumers to install.darkandlightcontext USS classes, applied alongsideappui--<theme>by every element that provides a theme context -Panel,ContextProviderand any component withthemeOverrideset.appui--editor-darksays which theme is active;darksays what kind of surface it is, so a single selector covers every dark theme instead of enumeratingappui--dark, appui--editor-dark, appui--cloud-darkand still missing custom ones. A theme counts as dark when its name ends indark, so a consumer'sacme-darkworks with no registration. The two markers are mutually exclusive, and they sit on the providing element, so a nestedContextProvideroverriding the theme carries its own and USS variables resolve from the nearest ancestor - a light island inside a dark panel gets light artwork.- Added
AudioWaveformandVuMeter, both drawn withPainter2D.VuMeter's bar fill is a banded safe/warning/clip gradient that USS cannot express, so it is drawn as three filled rects per bar; the registry's controlled/uncontrolled fader triple collapses to one clamped property plus an event. Both bind every painted colour to a token by meaning rather than by hue — the registry hardcodes the Tailwind palette for these, which does not adapt to theme. - Added
CanvasNode,CanvasEdge,SelectionRectandRectAnchorPresets. They live inside the existingCanvasand add no second pan/zoom system — the registry'szoomprop is dropped because it exists only so the web can divide pointer deltas by hand, whileWorldToLocalalready carries the transform.CanvasEdgepicks against the sampled curve rather than its bounding box, so a click near the line hits and a click in the bend's empty space does not.CanvasNode's exported layout constants are drawn from the static sizing ramp, which no density class overrides, because compile-time constants would otherwise drift under.appui--compact. - Added
Card(withCardMedia,CardHeader,CardTitle,CardDescription,CardContent,CardFooter) andCardGrid.Cardcarries the registry'sinteractiveandselectedstates plus an additiveelevationthat defaults to0, so out-of-the-box parity holds.CardGridreproducesrepeat(auto-fill, minmax(minItemWidth, 1fr))by computing the column count on resize, since UI Toolkit has no CSS grid; note that it writeswidth,marginRightandmarginBottomon its children, and is LTR-only for now. The registry'sring-2selected treatment becomes a permanently-reserved 1px border that turns accent when selected, because UI Toolkit has no ring and no 2px length token. - Added the display half of the chat suite:
ChatMessageBubble,ChatStreamingIndicator,ChatTodoList,ChatActivityTimeline,ChatPlan,ChatBudget(withLoadingDots,CreditsPillandBudgetIndicator),ContextCounter,ChatConversationListItem,ChatAssetRowandChatMessageActions. These compose existing components rather than reimplementing them —ChatStreamingIndicatordrivesUnityLogo's existing animated variant instead of adding a second animation driver, and every spinner and ring isCircularProgress. React callbacks become C# events,ReactNodeslots become container properties, and optional controls become booleans since C# has no "omit the prop to hide it". The interactive half of the suite remains deferred to #1235. - Added
ChatMessages, the conversation container, composing the chat display components already in the package. It exposes anIChatToolRendererseam so the deferred tool-renderer plugin model (#1235) has something to plug into, modelled on howColorGradientFieldexposes its picker interface. Sincemarkdown-rendereris deferred (#1231), a text part renders as rich text rather than a Markdown tree. - Added
ChoiceListandChoiceListItem, built onRadioGroup/Radioso the whole selection contract is inherited. The only addition isletter, which auto-assigns A…Z then AA, AB…; an explicit letter is pinned and does not consume a sequence slot, and an empty one hides the badge. - Added
ClampedContent, which clips its content tomaxHeightand reveals an expand toggle only when it actually overflows. The fade is a flat translucent band rather than the web's gradient, since USS has nolinear-gradient;fadeVisiblelets a host on a non-default surface turn it off. - Added
CodeEditor:CodeBlock's TextMate highlighting overTextArea's editing, so focus, caret, selection, undo, context menu and the field chrome all come from the existing component. The registry's scroll-sync is deliberately not ported — it exists because a DOM textarea scrolls its own fixed box, whereas here both layers are content-height and there is no independent offset. Put the editor in aScrollViewfor long documents. - Added
ConfirmDialog, the registry's imperative confirm helper:ConfirmDialog.Show(...)andConfirmDialog.ConfirmDelete(...)returnTask<bool>, matching the package's existing async style rather than importing a promise idiom. It derives from the existingAlertDialogand shows through the existingModal, so no new popup machinery was introduced. Concurrent calls queue, and each answer resolves exactly once so a dismiss arriving after a confirm cannot flip the result. - Added
FloatingWindow, a draggable and resizable window with persisted layout, plusIWindowLayoutStorageand aPlayerPrefsimplementation.viewDataKeywas deliberately not used for persistence: it is keyed by serialized hierarchy position rather than a host-chosen name and cannot be injected, so it cannot honour the registry'sstorageKey/storageprops. The web version's Tab focus trap and window stacking are not ported — the package has no shared window-stack service, so stacking follows hierarchy order. - Added
GradientEditorandCurveEditor, which implement theICustomColorGradientFieldPickerandICustomAnimationCurveFieldPickerinterfaces an earlier slice left open —field.customPicker = new GradientEditor()is the whole integration, with no change to the fields. The gradient strip is aColorSwatch, soGradientMode.Fixedand the checkerboard render identically to the field's own preview, and stops are edited with the existingColorFieldandColorSlider.TangentModeis a new App UI enum becauseAnimationUtility.TangentModeis editor-only andKeyframestores tangent values without the intent behind them. - Added
ColorGradientFieldandAnimationCurveField, following theColorFieldpattern of separating the field from its editor behind an interface (ICustomColorGradientFieldPicker,ICustomAnimationCurveFieldPicker) plus apickRequestedevent, so both are correct displays before their editors exist.ColorGradientField's preview is aColorSwatch, so the gradient-over-checkerboard composite reuses the existing shader rather than adding a second render path;AnimationCurveFieldstrokes withPainter2D, since a stroked curve needs no fill. - Added
ImageLightbox, built on the existingModal. UI Toolkit has no viewport units and percentages cannot be used here — the lightbox's parent is the modal content box, whose size is what the lightbox itself determines, so a percentage would be circular. It measures the panel instead and sizes the image tonatural × min(1, budgetW/natW, budgetH/natH), which preserves aspect by construction and never upscales past natural size. - Declared the
MVVM And Navigationsample inpackage.json. The sample's files were already inSamples~but nosamplesentry pointed at them, so they shipped as unreachable dead weight and tripped PVP-84-2. - Added
NumericProperty<TValue, TField>withNumericPropertyFloatandNumericPropertyInt, the registry'snumeric-property-field: a label row whose label scrubs the value. It exists because wiring it by hand does not work —InputLabel { draggable = true }around aFloatFieldsilently does not scrub, sinceNumericalField.acceptDraggingdefaults tofalse.NumericPropertysets both halves. - Added
ObjectPickerandObjectPickerPreview, composed fromSearchBar,Tabs,SplitViewandScrollViewand frameless like the registry's, so it drops into aPopover,DialogorFloatingWindowrather than bringing its own modal. - Added
OverflowToolbar, which collapses items that no longer fit into an overflow menu on resize. The menu is the existingMenu/MenuBuilder; collapsed items are re-parented into it and returned to the bar on dismiss, so a single element tree is maintained rather than two. - Added
OverflowTooltip, which shows its tooltip only when the text is actually truncated. It measures withMeasureTextSizeagainst the content box and re-checks on geometry and text changes, which is the UI Toolkit equivalent of the web version's ResizeObserver. - Added
SidebarwithSidebarHeader,SidebarContent,SidebarFooter,SidebarSection,SidebarSectionHeadingandSidebarItem. The registry's controlled/uncontrolledselectedId/defaultSelectedIdpair collapses to a singleselectedIdplus aselectionChangedevent, which is the UI Toolkit idiom.widthis a C# property rather than a token because the registry'sw-60is 240px and the App UI sizing ramp tops out at 154px — the same reasoningCardGrid.minItemWidthalready uses. - Added
Skeleton,KbdandUnityLogo.Skeletonreproduces the web'sanimate-pulse(2000 ms, opacity 1.0 → 0.5) with a scheduled driver, since USS has no keyframes; it stops on detach and restores full opacity.Kbdrenders one cap per key and accepts eithertextor akeyscollection, which round-trips through UXML askeys="Ctrl,K".UnityLogorenders through the existingIconcomponent using the brand asset the package already ships atPackageResources/Logos/, so it inherits the icon sizing ramp and density rescaling; itsAnimatedvariant is a linear fill ramp rather than the web's radial sweep, because UI Toolkit has no image masking. - Added
TimeField,TimePickerwithTimePickerColumn, andDateTimeField. Time of day is modelled as aSystem.TimeSpannormalized into[00:00:00, 24:00:00): the package had no time type, and a newTimestruct could not carry that name without colliding withUnityEngine.Time, whileTimeSpanis already whatDateTime.TimeOfDayreturns.DateTimeFieldcomposes the existingDateFieldbehaviour with the new time field rather than adding a second parser, and culture handling copiesDateFieldexactly instead of introducing a second approach. - Added the
Timelinecompound:Timeline,TimelineTrack,TimelineTrackGroup,TimelineClip,TimelineKeyframe,TimelineRuler,TimelineGrid,TimelineMarker,TimelineRangeandTimelinePlayhead. The registry'suseTimelineContextbecomes aTimelineAxisContextprovided through the package's own context system.PanAndZoomableis deliberately not reused — it applies a uniform scale that would stretch lane heights and ruler text vertically, where a timeline zooms the time axis only — but its control-scheme predicates are reused verbatim, andTimelineControlSchememirrorsCanvasControlSchememember for member so one preference can drive both. Managed multi-keyframe selection andinfiniteadaptive tick thinning are not ported. - Added
Toasterand theToastManagerstore, mirroring the registry'suse-toastsemantics: a limit that clamps to at least one and trims the oldest when lowered, plus add, update, dismiss and clear. The host renders the existing internal toast element, so the popup and stacked channels are styled identically and nothing was duplicated; it owns no queue of its own and unsubscribes on detach. FeedbackTray, a thumbs up / thumbs down rating row with optional regenerate and copy actions, matching the registry'sfeedback-tray.MenuItemgainsvariant(MenuItemVariant.Default/Destructive),indicator(MenuItemIndicator.Checkmark/Radio) andkey, so a menu row can carry the registry's destructive tint and can report its selection as a radio bullet instead of a checkmark.MenuRadioGroup, the UI Toolkit counterpart of the registry'sDropdownMenuRadioGroup/ContextMenuRadioGroup. It groupsMenuItemrows into a mutually exclusive set keyed onMenuItem.key, and an already-selected row can no longer be toggled off.TextFieldgainsselectAllOnFocus(defaulttrue) andsuffix, a static text slot for a unit or currency. The registry'stext-fielddocumentedselectTextOnFocusas mirroring UITK, but the property did not exist andTextFieldExtensions.RuntimeContextMenu()hard-set the underlying value tofalse, so the behaviour was the opposite of the documented default.TweakMenu, a floating gear menu that switches the hostPanel's theme (all six) and density (normal/compact/comfort) live, matching the registry'stweak-menu.- Added
UserAvatarandUserSwitcher.UserAvatarsubclasses the existingAvatarand adds aUserIdentity, deriving initials and an identity ring;UserSwitcherbuilds its account rows as realMenuItems inside the existingMenu, so the selected checkmark is the menu's own rather than a second implementation, and itscontentContaineris the menu tail so callers can append settings or sign-out items withAdd. - Added
ZoomableThumbnailandZoomTriggerButton, withtriggerModecovering the registry's corner control and whole-image variants. The reveal keys off the thumbnail's hover plus the button's own:focus, because:focus-withinis not a USS selector. - Added
Shimmer, aLocalizedTextElementthat brightens and dims on a two second loop to mark indeterminate progress. The registry sweeps a gradient through the glyphs withbackground-clip: text; USS has neither gradient text fills nor keyframes, so the port keeps the intent and travels the text colour between its resting value and--shimmer-highlight-colorinstead, driven from C# the waySkeletondrives its pulse. The resting colour is whatever the surrounding USS gives the element, so only the highlight belongs to the package. SlidergainsfieldLowValueandfieldHighValue, the input-field bounds that widen past the track's, which is what the registry's newSliderFieldexposes asfieldMin/fieldMax. Widening only, so a drag can never reach a number the field would then refuse to take back; a value outside the track pins the thumb at the end while the field keeps the number, and arrow keys on the track still stop at the track's ends.SliderFielditself needs no new type:Slideralready pairs a track with its own numeric field on one value binding throughshowInputField.- Added
AudioPreview, which auditions a single clip: an envelope drawn by the existingAudioWaveform, a play/stop control and a length readout. Purely presentational — the caller owns the peak data, the playback state and every string, sotoggledreports the intent and never flipsplayingby itself. The body has a precedence order:messagereplaces the envelope outright, thenloadingshows aSkeleton, then a null envelope with afallbackIcondraws that symbol, and otherwise a null envelope still draws as a flat baseline, because a clip nobody has analysed is still playable and an empty box would read as a broken component. TreeViewItemgainsdropIndicator, which draws the row's drop highlight from the outside for a drag the tree is not running itself. A pointer-driven drag produces none of the events the tree's own drag handling watches for, so feeding the position in keeps such a drop looking exactly like a native one instead of growing a second set of highlight styles. The tree's own drop target wins while it is targeting the row, so the two can never contradict each other.NumericalFieldgainsscrubSuffix, which turns the unit glyph's drag-to-scrub off.Slidersets it on the field it mounts throughshowInputField, because the track is already that row's drag surface and a unit that also scrubbed would be a second gesture, at a different rate, on something that does not look draggable.ChatStreamingIndicatorgainsstartTime, so the elapsed time survives the element being rebuilt: a host that refreshes its message list mid-turn no longer restarts the count from zero.ChatMessagesthreads the message's owncreatedAtin. The verb is now aShimmerwhile the turn runs and settles once it is over; the stats deliberately do not sweep, because they are figures to read rather than a progress cue.ChatAssetRowgainsfallbackIcon,mediaandcreatorLink.fallbackIconreplaces the hardcoded cube so an item with no picture still reads as what it is; clearing it restores the cube rather than leaving the row blank.mediaputs a caller-supplied element in the thumbnail's place, for a row whose content is not an image.creatorLinkoffers the creator label as a link and raisescreatorRequested; the registry'screatorUrlhas to check for an absolute http(s) URL before building anhref, and with nohrefhere there is nothing to guard.ChatTodoListgainscollapsible, asizeofSmorMd, and optionalshowMaximize/showCloseheader actions raisingmaximizeRequested/closeRequested. Turning offcollapsibleforces the body open and drops the caret, rather than stranding a list closed with no way to open it. The registry shows each action only when its handler is passed; C# cannot omit a prop, so the controls are explicit flags.ChatActivityTimelinegainsisFollowedByTextandstartTime, and its collapsed header now reports what the run did — "3 thoughts, 2 tools" — instead of repeating the label. While the activity runs the header shows the label, sweeps as aShimmerand counts live fromstartTime, so a list rebuilt mid-turn does not restart the count.isFollowedByTextfinalizes the run as soon as the answer's own prose begins, rather than leaving it counting while the reader is already reading.ChatMessagesthreads both in.ChatMessageslets a host pull chosen message parts out of the bubble and render them itself, throughstandalonePartandrenderStandalonePartplus aChatStandalonePartContext. A picked part is excluded from the activity group whether or not the host draws it, so the same tool call can never show twice, and it closes the activity run it followed so the block lands in reading order. Tool results are exempt: they are folded onto their call, and pulling one out alone would orphan it.TimelinegainsminPxPerUnit,maxPxPerUnit,fitWidth,fitDurationandadaptiveTicks;TimelineClipgainsframe,frameColor,frameHeightanddoubleClicked;TimelineKeyframegainsmuted. The zoom bounds were compile-time constants, so a host with a different time unit could not widen them; they keep their old values as defaults.fitWidthderives the base scale from the measured viewport, so the content fills the strip at any panel width.adaptiveTickschooses the tick interval from the current pixel density on the 1/2/5 ladder, staying on whole multiples of the configured interval so an adaptive ruler still lands on the caller's beats;infiniteimplies it, since an axis with no end cannot have a fixed tick count. Aframeclip is a translucent placement marker whose body lets pointers through to the lane behind it and which drags only by its handle strip.Timelinealso gains the rest of the registry's #1415 set:labelResizableandminLabelWidthwith alabelWidthChangedevent (the gutter now always leaves 120px for the lanes),hoverLine,timeLabelandtimeSuffixfor a corner time,laneExtent,keySize,minTickStep,ticksAt, an overlayscrollbarandRevealTime;TimelineTrackgainslane,laneStartandlaneEnd;TimelineClipgainsvariant(Bar,Handle,Surface);TimelineKeyframegainssize; andTimelineHandleis new. A keyboard-moved playhead pans into view, the pan stays inside a shrinking axis, and past 10,000 fixed ticks the step coarsens instead of the ruler going blank.- Added
IconButton.selected, the pressed or toggle state of an icon button such as an active panel toggle, as a UXML attribute and a bindable property. A selected IconButton paints--appui-alias-actions-selected-background-color-default, and--appui-alias-actions-selected-background-color-hoverunder the pointer, as the registry's icon-button does. A disabled selected IconButton drops the selected fill. InputLabelgrid rows takecolumns = InputLabelColumns.Pair, the registry'sPropertyField columns="pair": the control cell splits into two equal halves with the inspector grid gap between them, and a lone control keeps to the first half so it still lines up with the pair rows around it.columnsis anInputLabelColumnsenum (None,Even,Pair) rather than a bool, since a bool cannot hold three states. Controls in a gridInputLabelrow and in aPropertyGroupbody take their medium height from--appui-alias-inspector-row-height, which resolves to the same value by default.InputLabel.labelFornames the control the row labels, so a click on the label operates it, like the registry'sPropertyField labelForand an HTML<label for>. The control is looked up in the row, then in the panel, and must beIPressable, such as aCheckbox,ToggleorRadio. A disabled control is left alone, and the click is ignored whiledraggableis on, so a scrub ending on the label never toggles anything.- Added
DropdownItem.description, a secondary line under an option's label, matching the registryselectoption'sdescription. Set it frombindItem; it reads--appui-alias-text-secondaryat--appui-font-sizes-100, hides while empty, stays out of the trigger, and the menu grows past the field so it is not clipped. MaskFieldgains the registry mask field's sentinels:everythingValue(0 keeps the OR of the items; set -1 for a mask whose every bit means everything),summary(MaskFieldSummary.Mixedby default, orListto name the set items), andnothingLabel,everythingLabelandmixedLabelfor the summary and sentinel rows. A set bit no item names now stays invalueand reads as mixed instead of being dropped.- An enabled control's tooltip now opens when it takes keyboard focus and closes on blur, matching the registry's tooltip trigger. Any key, Escape included, still dismisses it, focus from a pointer click does not open it, and hover behaviour is unchanged. Disabled controls keep their hover tooltip and get no focus tooltip, since UI Toolkit cannot focus a disabled element and no soft-disabled state was added.
ImageLightboxcan step through a set of images, like the registry'snavigation: setnavigationCountabove 1 andnavigationIndex, and previous and next buttons (caret-left/caret-right, named bypreviousLabelandnextLabel) sit either side of the caption, Left / Right arrow keys step too, and the caption leads with the position ("2 / 5"). Stepping never wraps; each step raisesnavigationIndexChangedso the caller swapssrcandcaption. A step that disables the focused button moves focus to the other one. An image more thantallRatio(1.25) times taller than wide is now shown at full width and scrolls instead of being shrunk.AudioPreviewgainspreviewLayout(UXMLlayout), like the registry'slayout:AudioPreviewLayout.Overlay(the default, unchanged) orStrip, one compact row with the play/stop control first, a short envelope, then the length, styled through theappui-audio-preview--stripclass. A strip draws the flat baseline for a null envelope even whenfallbackIconis set.- Added
SplitView.indicator, which picks how each splitter shows: the full-length line (Stretch, the default) or a centered grip spanning a quarter of the splitter that appears on hover and drag (Centered), matching the registry'sResizableHandle. Both shapes are always in the tree, so a theme can pick instead by setting--appui-resizable-handle-stretch-displayand--appui-resizable-handle-centered-displaytoflexornone. CanvasNode.lodandCanvasEdge.lodtake aCanvasLevelOfDetail, like the registry'slod:Compacthides a node's port labels and body,Boxalso hides its title and port targets and leaves an edge its line only, with no hit area or arrow. Port rows keep their geometry at every level.CanvasCulling.LevelOfDetailForZoompicks the level from the zoom (compact under 0.5, box under 0.3), andCanvas.TryGetVisibleContentRectwithCanvasCulling.IsVisibleculls nodes and edges outside the viewport plus a 200 px margin, always keeping selected ones.ChatMessagesgainsrenderActivity, aFunc<ChatActivityRenderContext, VisualElement>that replaces the activity timeline for every activity group (with the group's parts, index, live state, whether text follows, and start time), andshowStreamingIndicator, which hides the live indicator under a streaming message when the host reports progress elsewhere. Both match the registry'schat-messages.ChatActivityTimelinegains the #1460 options: a running header names the newest tool call in flight (ChatActivityPart.toolName,activeToolNames),stats,headerPlacement(a status chip at the foot whose rows open upward),foldRowsByKindwith a pager through each folded row, andpinEntries/maxPinnedShare, which lay rows out as one-line entries and mark the ones that pin within a six-entry cap and a share of the enclosingScrollView. USS has noposition: sticky, so the marked entries still scroll. Pressing the header now sends aChangeEvent<bool>.ChatMessagesforwards them asactivityHeaderPlacement,activityFoldRowsByKind,activityPinEntries,activityMaxPinnedShareandactivityOpenplusactivityOpenChanged. A live group with its header at the foot carriesstreamingStatsand replaces the streaming indicator.- Added
TreeListVirtualandTreeListFlatten.Flatten, the registry'sTreeViewVirtualandflattenTree.Flattenlays a lazily loaded tree out as flatTreeListRows with level, parent, set size and position, plus placeholders for unloaded or partly loaded levels, and emits each id once.TreeListVirtualdraws those rows by recycling a small pool ofTreeViewItems, so only the rows near the view exist, and selects by row id with the same click, Shift-range, action-toggle, release-to-select and keyboard rules asTreeList. Expansion goes throughonExpandedChange. The lead selected row stays realised when scrolled away.TreeListitself is unchanged. Drag to reparent is not supported yet in the virtual view. CodeBlockandCodeEditorhighlighthlslandwgsl, the two shader languages the registry's highlighter loads. The grammars come from Visual Studio Code (HLSL) and vscode-wgsl (WGSL), both MIT.PropertyGroup.expandablekeeps the header toggle and the closed-state ellipsis for a group whose rows another element lays out, and drops the row gap below its header.TreeList.keyboardNavigationturns a tree into a selection provider for rows a host lays out and keys itself (the registry'sTreeViewProvider), where each caret row opens and closes itself on Right and Left. Right on ashowCaretrow with no nested children now expands it, and steps only into a nested child.IconContactSheetTestscaptures the whole icon library as grid "contact sheets" — around 300 icons per sheet, ten sheets per theme — so the move to SVG-backedVectorImageicons has visual regression coverage without one capture per icon. Unity tessellates icons at runtime and can silently drop a subpath, invert a fill or blank an icon outright on complex geometry, none of which CI could previously see. The layout is read fromicon-sheets.jsonrather than computed, because a second renderer outside the package rasterizes the same grid from the source SVGs as an oracle, and the two have to place the same icon in the same cell. Sheets render white-on-black with the icon tint pinned in both themes, so the only thing varying between them is which artwork an icon resolves to; the dark theme exercises thed_*artwork. Captures go toSNAPSHOTS_OUTPUT_DIRalongside the component snapshots. The fixture loads the fullIcons.usscatalogue from a test-onlyResourcesstylesheet, sinceIcon.ussimports only the minimal subset andIconresolves artwork purely through USS.
Removed
ChatActivityTimelineno longer appends a synthetic "Done" row when the turn ends, anddoneLabelis gone with it. The collapsed summary already says the activity is finished, so the extra row was a second and weaker way of saying the same thing.- TweakMenu section from the Kit sample, and icons missing from the minimal set in the Kit sample.
Security
- The markdown renderers no longer emit inline HTML tags verbatim, and only link destinations using
http,https,mailtoor a site-relative path are made clickable. Inline tags now render as literal text, and destinations such asfile:,data:,javascript:or a custom app scheme render as plain, non-clickable text. DefaultDestinationTemplate.CreateScreennow checks that the serialized template type is aNavigationScreenbefore instantiating it. Previously any type named in the navigation graph had its constructor run, and the resulting object was only rejected afterwards.- The AI Agent Skills panel in the Package Manager is now offered only for an App UI copy resolved from the default Unity registry.
PackageSource.Registryalone is not enough, since a project can serve any package name from a scoped registry it controls. The package name alone is attacker-controllable, so a repackaged or hand-added copy could previously present third-party agent instructions through first-party UI. The install dialog also shows the resolved source and destination paths. - Debug symbols are no longer published with the package. The Windows native plugin
.pdbfiles added roughly 42 MB to every release and embedded the absolute build paths and account name of the machine that produced them. The Windows plugin is also linked with/PDBALTPATH:%_PDB%so the DLL itself records only the symbol file name instead of that full path. ThreadMessageno longer interprets untrusted message text as rich text when no mention provider is set. The previous<noparse>wrapper could be closed early by a message containing its own</noparse>(in any casing, or with inner whitespace), which re-enabled<b>,<color>,<size>and sprite tags for the rest of the message and allowed spoofing an official-looking notice.- The UXML clone-tree source generator now emits attribute values through
SymbolDisplay.FormatLiteralinstead of hand-quoting them, so a quote, backslash, newline or Unicode line separator in a[UxmlFilePath]or element name can no longer terminate the generated string literal early. VisualDocPageBuilder.BuildGuidePagenow resolves the requested file and confirms it is still inside the package documentation root, so a rooted or..-bearing file name can no longer read a file outside it.- The WebGL clipboard read callbacks now bound the JavaScript-supplied buffer length before allocating and use a checked conversion, so an out-of-range length fails loudly instead of wrapping.
[2.2.6] - 2026-11-05
Fixed
SwitchBuilderruns every matching reducer case on the state returned by the previous one, so a slice no longer keeps only the last case's result. SeveralAddDefaultcalls now chain the same way.Action<TPayload>instances with different payloads, and async thunk actions with differentmetaor creators, no longer compare as equal throughIEquatable<Action>.StoreFactory.ComposeEnhancersreturns the identity enhancer when it is called with no enhancers instead of throwing.- The Redux DevTools no longer keep committed actions in
actionsByIdwhenmaxAgeis set, andDispatchaccepts amaxAgeof 0 or 1. - Async thunks run when DevTools is enabled through
StoreFactory.DefaultEnhancer. IThunkAPI.Abortcancels the async thunk instead of throwing when it is called on the main thread or from another thread, and so doRejectWithValueandFulFillWithValue.TryAddTransientregisters a transient service, andTryAddTransient(Type)andTryAddScoped(Type)add it only once.NavController.Navigate(Uri)resolves deep links with two or more path segments.GradientExtensions.TryParsereturns false for a gradient key with a single value instead of throwing, and accepts keys with surrounding spaces.PinchGesture.GetHashCodeis equal for gestures that compare equal.
[2.1.16] - 2026-11-05
Fixed
SwitchBuilderruns every matching reducer case on the state returned by the previous one, so a slice no longer keeps only the last case's result. SeveralAddDefaultcalls now chain the same way.Action<TPayload>instances with different payloads, and async thunk actions with differentmetaor creators, no longer compare as equal throughIEquatable<Action>.StoreFactory.ComposeEnhancersreturns the identity enhancer when it is called with no enhancers instead of throwing.- The Redux DevTools no longer keep committed actions in
actionsByIdwhenmaxAgeis set, andDispatchaccepts amaxAgeof 0 or 1. - Async thunks run when DevTools is enabled through
StoreFactory.DefaultEnhancer. IThunkAPI.Abortcancels the async thunk instead of throwing when it is called on the main thread or from another thread, and so doRejectWithValueandFulFillWithValue.TryAddTransientregisters a transient service, andTryAddTransient(Type)andTryAddScoped(Type)add it only once.NavController.Navigate(Uri)resolves deep links with two or more path segments.GradientExtensions.TryParsereturns false for a gradient key with a single value instead of throwing, and accepts keys with surrounding spaces.PinchGesture.GetHashCodeis equal for gestures that compare equal.
[2.3.1] - 2026-11-03
Fixed
SwitchBuilderruns every matching reducer case on the state returned by the previous one, so a slice no longer keeps only the last case's result. SeveralAddDefaultcalls now chain the same way.Action<TPayload>instances with different payloads, and async thunk actions with differentmetaor creators, no longer compare as equal throughIEquatable<Action>.StoreFactory.ComposeEnhancersreturns the identity enhancer when it is called with no enhancers instead of throwing.- The Redux DevTools no longer keep committed actions in
actionsByIdwhenmaxAgeis set, andDispatchaccepts amaxAgeof 0 or 1. - Async thunks run when DevTools is enabled through
StoreFactory.DefaultEnhancer. IThunkAPI.Abortcancels the async thunk instead of throwing when it is called on the main thread or from another thread, and so doRejectWithValueandFulFillWithValue.TryAddTransientregisters a transient service, andTryAddTransient(Type)andTryAddScoped(Type)add it only once.NavController.Navigate(Uri)resolves deep links with two or more path segments.GradientExtensions.TryParsereturns false for a gradient key with a single value instead of throwing, and accepts keys with surrounding spaces.PinchGesture.GetHashCodeis equal for gestures that compare equal.
[2.3.0] - 2026-10-30
Added
- Factory registration for the dependency injection container:
ServiceDescriptor.Singleton,ScopedandTransientaccept aFunc<IServiceProvider, object>(or a genericFunc<IServiceProvider, TService>), andAddSingleton,AddScopedandAddTransienthave matching overloads. A factory can forward to another registration, so one singleton can be exposed under two interfaces.ServiceDescriptor.Singleton<TService>(TService instance), a publicServiceDescriptor(Type, Func<IServiceProvider, object>, ServiceLifetime)constructor and theServiceDescriptor.implementationFactoryproperty were added too.
[2.1.15] - 2026-10-29
Fixed
Store.Dispatchno longer throwsInvalidOperationExceptionwhen a listener subscribes or unsubscribes while it is being notified. Subscribers are now notified from a snapshot, and a subscription that is unsubscribed while it is being notified no longer throwsNullReferenceException. Its listener may still be called once (UUM-157944).IDisposableSubscription.IsValid()returnsfalseinstead of throwing aNullReferenceExceptiononce the subscription or its store is disposed (UUM-157918).- The
Optional<float>,Optional<double>andOptional<Rect>UXML converters,RectExtensions.TryParse,GradientExtensions.TryParseand the float sliders now read and write numbers with the invariant culture, so0.5is no longer read as5under a decimal comma culture. Values saved with the current culture by earlier versions, such as0,5underde-DE, still load, and the sliders' input field still accepts them. TheOptional<int>andOptional<long>converters read the same way (UUM-157942). DateConverterandDateRange.TryParsenow parse serialized dates with the invariant culture, so dates no longer swap day and month or shift calendars under other cultures (UUM-157919).DatePickerrebuilds its day grid for months before 1970, and keeps it valid at the first and last supported month, where the outward month, year and decade arrows are now disabled instead of throwing (UUM-157611).Sliderarrow keys withrestrictedValuesset toSteporCtrlStepnow move by the right step with Shift, step without Ctrl forCtrlStep, and no longer throw with Ctrl (UUM-157601).ActionGroupchildren and its overflow button now follow an inheritedvisibility: hiddeninstead of forcing themselves visible (UUM-145391).Radioregisters with itsRadioGroupagain when it is re-attached to a panel, so radio buttons keep working and keep their selection in content that is shown more than once, such as aPopoverorDialogTrigger(UUM-144282).- Setting
UndoStack.indextoUndoStack.count, or to0on an empty stack, now throwsArgumentOutOfRangeExceptioninstead of hanging (UUM-158333). UndoStack.isCleanno longer reportstrueafter the clean state was reset withResetClean, dropped by aPushor evicted byundoLimit, including when the clean state was the initial one. APushthat drops the clean command now raisescleanStateChanged, andResetCleanraises it only whenisCleanorcleanIndexchanges (UUM-158398).AsyncRelayCommand<T>withAllowConcurrentExecutionsnow cancels the previous run whenExecuteAsyncis called again, soCancel()reaches every run (UUM-158357).AsyncRelayCommandandAsyncRelayCommand<T>now raiseCanExecuteChangedand their completionPropertyChangednotifications when a run is cancelled, instead of throwingTaskCanceledExceptionand leaving bound buttons disabled. A faulted run also raises them now, and its exception is still logged, including anOperationCanceledExceptionthat did not come from cancelling the run (UUM-158369).App.currentis no longer cleared when a differentAppinstance is disposed or finalized (UUM-158373).Handler.RemoveCallbacksAndMessagesno longer removes messages sent through other handlers that share the sameLooper. Messages whose target is not the calling handler, such as one fromMessage.Obtain(null, ...), are no longer removed by it either (UUM-158403).Message.Obtainkeeps reusing pooled messages after more than 50 messages have been recycled (UUM-158417).NavDestination.MergeArgumentsnow replaces a default argument with a provided argument of the same name instead of keeping both (UUM-158420).NavGraphViewAsset.FindDestinationByRouteno longer throwsInvalidCastExceptionwhen the route names a navigation action. It returnsnull, or the destination of that name if there is one (UUM-158351).ColorFieldno longer throwsArgumentExceptionwhenhdristrueand a channel is above 1.ColorExtensions.ColorToRgbaHexnow clamps each channel (UUM-158350).Rect.IsValidandVisualElement.IsOnScreenno longer treat a zero-area rect as valid on engine builds whereMathf.Epsilonevaluates to 0.
Changed
AppUIServiceCollectionand its baseServiceCollectionnow throwInvalidOperationExceptiononAdd,Insert,Remove,RemoveAt,Clearand indexer changes onceIsReadOnlyistrue, andICollection<ServiceDescriptor>.IsReadOnlyreportstruethen. Services added afterAppBuilder.BuildWith, for example inOnAppInitialized, now throw (UUM-158414).
[2.2.5] - 2026-10-28
Fixed
Rect.IsValidandVisualElement.IsOnScreenno longer treat a zero-area rect as valid on engine builds whereMathf.Epsilonevaluates to 0.Store.Dispatchno longer throwsInvalidOperationExceptionwhen a listener subscribes or unsubscribes while it is being notified. Subscribers are now notified from a snapshot, and a subscription that is unsubscribed while it is being notified no longer throwsNullReferenceException. Its listener may still be called once (UUM-157944).IDisposableSubscription.IsValid()returnsfalseinstead of throwing aNullReferenceExceptiononce the subscription or its store is disposed (UUM-157918).- The
Optional<float>,Optional<double>andOptional<Rect>UXML converters,RectExtensions.TryParse,GradientExtensions.TryParseand the float sliders now read and write numbers with the invariant culture, so0.5is no longer read as5under a decimal comma culture. Values saved with the current culture by earlier versions, such as0,5underde-DE, still load, and the sliders' input field still accepts them. TheOptional<int>andOptional<long>converters read the same way (UUM-157942). DateConverterandDateRange.TryParsenow parse serialized dates with the invariant culture, so dates no longer swap day and month or shift calendars under other cultures (UUM-157919).DatePickerrebuilds its day grid for months before 1970, and keeps it valid at the first and last supported month, where the outward month, year and decade arrows are now disabled instead of throwing (UUM-157611).Sliderarrow keys withrestrictedValuesset toSteporCtrlStepnow move by the right step with Shift, step without Ctrl forCtrlStep, and no longer throw with Ctrl (UUM-157601).- Dragging with touch and pen pointers works again on
Draggable-based controls such as sliders,SplitViewandTray(UUM-154905). ActionGroupchildren and its overflow button now follow an inheritedvisibility: hiddeninstead of forcing themselves visible (UUM-145391).Radioregisters with itsRadioGroupagain when it is re-attached to a panel, so radio buttons keep working and keep their selection in content that is shown more than once, such as aPopoverorDialogTrigger(UUM-144282).- Setting
UndoStack.indextoUndoStack.count, or to0on an empty stack, now throwsArgumentOutOfRangeExceptioninstead of hanging (UUM-158333). UndoStack.isCleanno longer reportstrueafter the clean state was reset withResetClean, dropped by aPushor evicted byundoLimit, including when the clean state was the initial one. APushthat drops the clean command now raisescleanStateChanged, andResetCleanraises it only whenisCleanorcleanIndexchanges (UUM-158398).AsyncRelayCommand<T>withAllowConcurrentExecutionsnow cancels the previous run whenExecuteAsyncis called again, soCancel()reaches every run (UUM-158357).AsyncRelayCommandandAsyncRelayCommand<T>now raiseCanExecuteChangedand their completionPropertyChangednotifications when a run is cancelled, instead of throwingTaskCanceledExceptionand leaving bound buttons disabled. A faulted run also raises them now, and its exception is still logged, including anOperationCanceledExceptionthat did not come from cancelling the run (UUM-158369).App.currentis no longer cleared when a differentAppinstance is disposed or finalized (UUM-158373).Handler.RemoveCallbacksAndMessagesno longer removes messages sent through other handlers that share the sameLooper. Messages whose target is not the calling handler, such as one fromMessage.Obtain(null, ...), are no longer removed by it either (UUM-158403).Message.Obtainkeeps reusing pooled messages after more than 50 messages have been recycled (UUM-158417).NavDestination.MergeArgumentsnow replaces a default argument with a provided argument of the same name instead of keeping both (UUM-158420).NavGraphViewAsset.FindDestinationByRouteno longer throwsInvalidCastExceptionwhen the route names a navigation action. It returnsnull, or the destination of that name if there is one (UUM-158351).ColorFieldno longer throwsArgumentExceptionwhenhdristrueand a channel is above 1.ColorExtensions.ColorToRgbaHexnow clamps each channel (UUM-158350).
Changed
AppUIServiceCollectionand its baseServiceCollectionnow throwInvalidOperationExceptiononAdd,Insert,Remove,RemoveAt,Clearand indexer changes onceIsReadOnlyistrue, andICollection<ServiceDescriptor>.IsReadOnlyreportstruethen. Services added afterAppBuilder.BuildWith, for example inOnAppInitialized, now throw (UUM-158414).
[2.1.14] - 2026-09-27
Fixed
- Fixed Tabs throwing "Cannot scroll to a VisualElement that's not a child of the ScrollView content-container" when TabItems are deleted from it in UI Builder. Tabs now picks up TabItems added to or removed from its item container directly, and keeps the same tab selected when it can (UUM-154226).
[2.2.4] - 2026-09-26
Fixed
- Fixed Tabs throwing "Cannot scroll to a VisualElement that's not a child of the ScrollView content-container" when TabItems are deleted from it in UI Builder. Tabs now picks up TabItems added to or removed from its item container directly, and keeps the same tab selected when it can (UUM-154225).
[2.2.3] - 2026-09-19
Fixed
- The native platform P/Invoke declarations that return a
boolnow pin one-byte marshalling with[return: MarshalAs(UnmanagedType.I1)]. Without it a[DllImport]returningboolmarshals as the 4-byteUnmanagedType.Bool, while everyNativeAppUI_*entry point returns a 1-byte C++bool; on x86-64setcc %alwrites only the low byte, so register residue in bits 8-31 could read back astruewhen the native answer wasfalse. - App UI shaders no longer fail to compile on Unity 7000, where the
UnityCG.hlsl/UnityUI.hlslincludes they expected do not exist; they now includeUnityCG.cgincon every Unity version.
[2.1.13] - 2026-09-16
Fixed
- The native platform P/Invoke declarations that return a
boolnow pin one-byte marshalling with[return: MarshalAs(UnmanagedType.I1)]. Without it a[DllImport]returningboolmarshals as the 4-byteUnmanagedType.Bool, while everyNativeAppUI_*entry point returns a 1-byte C++bool; on x86-64setcc %alwrites only the low byte, so register residue in bits 8-31 could read back astruewhen the native answer wasfalse. - App UI shaders no longer fail to compile on Unity 7000, where the
UnityCG.hlsl/UnityUI.hlslincludes they expected do not exist; they now includeUnityCG.cgincon every Unity version.
[2.2.2] - 2026-08-24
Fixed
- Fixed
Unity.AppUI.Markdownfailing whenAPPUI_ENABLE_MARKDOWNis defined. The bundledMarkdig.dllwas thenetstandard2.0build, which references theSystem.Runtime.CompilerServices.Unsafe,System.MemoryandSystem.Buffersfacades. Unity ships shims for the latter two but not forUnsafe, so parsing markdown threwFileNotFoundExceptionat runtime. Replaced it with Markdig'snetstandard2.1build, which targets the same profile Unity uses and references nothing butnetstandarditself. - Fixed ArgumentOutOfRangeException in Tabs when all items are disabled, and cancelled pending indicator refreshes when the selection is cleared.
- Fixed Tabs arrow-key navigation throwing ArgumentOutOfRangeException and not skipping disabled tabs (it scanned the empty content container instead of the tab items).
- Fixed
TextField.isPassword = truethrowing aNullReferenceExceptionon Unity versions before 6000.0. Enabling UITK'sisPasswordFieldforces multiline off, and that setter callstext.Replace("\n", "")with no null check on those versions.TextFieldseeded the underlying UITK field with a null value, sonew TextField { isPassword = true }— and anyisPasswordtoggle after the value was cleared — threw. The underlying field is now never given a null text, which also meansTextField.valuereturns an empty string rather than null for an empty field.
Changed
- The
[UxmlFilePath]source generator now emitsUxmlCloneTree(VisualElement parent = null)instead of a parameterless method. Passing a container clones the UXML tree (and resolves[UxmlElementName]bindings) into that container rather than onto the element itself, lettingNavigationScreensubclasses and other custom elements direct authored content into a chosen part of their hierarchy. Existing parameterlessUxmlCloneTree()calls keep working unchanged.
[3.0.0-pre.1] - 2026-08-21
Changed
- The minimum supported Unity version is now 6000.3 LTS (previously 2021.3). The package manifest declares
"unity": "6000.3", and the CI editor matrix (validation, API validation, preview APV, package/project tests and player tests) now covers 6000.3, 6000.5, 6000.6 and trunk only. This is a major bump because the new floor drops Unity 6000.0 LTS, which is still under support — raising the minimum editor is only a non-breaking change when every dropped release line is already past end-of-support. - The
[UxmlFilePath]source generator now emitsUxmlCloneTree(VisualElement parent = null)instead of a parameterless method. Passing a container clones the UXML tree (and resolves[UxmlElementName]bindings) into that container rather than onto the element itself, lettingNavigationScreensubclasses and other custom elements direct authored content into a chosen part of their hierarchy. Existing parameterlessUxmlCloneTree()calls keep working unchanged.
Removed
- The APIs that were marked
[Obsolete]are now gone, as part of the 3.0 major release.Badge.content,Badge.maxandBadge.showZerohave been removed — a Badge can hold any content, so useBadge.labelfor textual content or add child elements. TheTextFieldExtensions.BlinkingCursor()extension method has been removed in favour of theUnity.AppUI.UI.BlinkingCursormanipulator (textField.AddManipulator(new BlinkingCursor())).AppUISettings.autoOverrideAndroidManifesthas been removed; it had no effect, since App UI applies the changes it needs to the existing Android manifest during the build instead of shipping its own. - Conditional compilation for editor versions below the new 6000.3 minimum. The
versionDefinesthat can no longer change value at 6000.3+ were dropped from the.asmdeffiles and the#ifbranches they guarded were resolved in place:ENABLE_UXML_TRAITSandENABLE_ENABLED_UXML_PROPERTY(never defined at 6000.3+) were deleted along with the code they guarded, whileENABLE_UXML_SERIALIZED_DATA,ENABLE_RUNTIME_DATA_BINDINGS,ENABLE_VALUEFIELD_INTERFACE,ENABLE_UITK_TEXT_SELECTION,UITK_NESTED_INTERACTION_KIND,UITK_SELECTED_INDICES_CHANGED,UITK_MAKE_NONE_ELEMENT,CONDITIONAL_WEAK_TABLE_IL2CPP,UI_DOCUMENT_ROOT_ELEMENT_TYPE_EXISTS,UNITY_ENABLE_TABVIEWandUNITY_ENABLE_SLIDER_FILL(always defined at 6000.3+) are now unconditional. Legacy#if !UNITY_2022_*and#if !UNITY_2023_*fallbacks were removed too. Because every one of these symbols already had a fixed value on 6000.3, the compiled API surface is unchanged for supported editors.
Added
- Added App UI Visual Documentation window. This window builds its pages dynamically from the XML documentation of the components (extracted at compile time by a Roslyn source generator) and from the package's markdown documentation, instead of loading pre-generated UXML pages. The Visual Documentation window requires the
APPUI_ENABLE_MARKDOWNscripting define. - Add display scale factor and DPI support on Linux, exposing
scaleFactor,textScaleFactorandreferenceDpion the Linux platform via new native plugin display-info APIs. - Added a Linux native plugin, bringing the TextMate syntax highlighter and DPI scale factor support to the Linux Editor and player.
Fixed
- Fixed
Unity.AppUI.Markdownfailing whenAPPUI_ENABLE_MARKDOWNis defined. The bundledMarkdig.dllwas thenetstandard2.0build, which references theSystem.Runtime.CompilerServices.Unsafe,System.MemoryandSystem.Buffersfacades. Unity ships shims for the latter two but not forUnsafe, so parsing markdown threwFileNotFoundExceptionat runtime. Replaced it with Markdig'snetstandard2.1build, which targets the same profile Unity uses and references nothing butnetstandarditself. - Fixed ArgumentOutOfRangeException in Tabs when all items are disabled, and cancelled pending indicator refreshes when the selection is cleared.
- Fixed Tabs arrow-key navigation throwing ArgumentOutOfRangeException and not skipping disabled tabs (it scanned the empty content container instead of the tab items).
- Fixed a crash (SIGABRT) on Linux when the TextMate syntax highlighter handled invalid input (e.g.
Registry.AddGrammarFromJsonwith malformed JSON). The Linux native plugin was built with a statically-linked libgcc unwinder that collided with the one loaded by the Unity player, so C++ exceptions aborted during unwinding instead of being caught. It is now linked dynamically and built on an old-glibc base (Ubuntu 18.04) for portability. - Fixed
TextField.isPasswordthrowing aNullReferenceExceptionwhen set before the field is attached to a panel, which madenew TextField { isPassword = true }unusable. Enabling UITK'sisPasswordFieldforces multiline off and walks text backing that only exists once the field belongs to a panel, so the value is now stored and applied on attach.
[2.2.1] - 2026-07-19
Fixed
- Fixed a crash (SIGABRT) on Linux when the TextMate syntax highlighter handled invalid input (e.g.
Registry.AddGrammarFromJsonwith malformed JSON). The Linux native plugin was built with a statically-linked libgcc unwinder that collided with the one loaded by the Unity player, so C++ exceptions aborted during unwinding instead of being caught. It is now linked dynamically and built on an old-glibc base (Ubuntu 18.04) for portability.
[2.1.12] - 2026-07-16
Fixed
- Fix headless Windows IL2CPP build crash caused by the native plugin activating WinRT settings objects at static scope on Windows Server Core (game-ci/unity-builder#702)
[2.2.0] - 2026-07-15
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
sizeModifiercallback property toResizeHandleto allow custom size adjustments during resize. - Added Thread UI components including Thread, ThreadMessage, ThreadComposer, ThreadReaction, ThreadReactionBar, ThreadResolveMessage, ThreadUnresolveMessage, MentionPicker, and ReactionPicker, along with their associated interfaces (IEmojiProvider, IMentionProvider, IThreadAttachment), base classes, enums, and USS styles. Renamed ThreadMessage
contentproperty tomessage, removedisEditingproperty in favor ofstate = Draft, movedemojiProviderandmentionProviderfrom ThreadMessage to ThreadContext, removedActivemessage state, and exposed explicitattachmentscontainer on ThreadMessage and ThreadComposer - Added new icons (arrow-up, paperclip, pen, paper-plane-tilt, smiley, thumbs-up, thumbs-down) to the minimal icon set and IconBrowser required icons list
- Added TextMate grammar-based syntax highlighting support via native TextMateLib integration, including C# bindings (Registry, Grammar, Theme, Token), ScriptableObject assets (TextMateGrammarAsset, TextMateThemeAsset), ScriptedImporters for .tmLanguage and .tmTheme files, and a high-level TextMateSyntaxHighlighter API
- Added support of DevicePixelRatio in WebGL native plugin to determine the current ScaleFactor applied to the canvas.
- Added
UxmlTraitssupport forResizeHandlecomponent. - Added Edit and Delete text action constants with localization support in TextActions
- Added Uxml cloneTree and element binding by name source generators. See the documentation for more information.
- Added Conditional Resolution in Dependency Injection system.
- Add
destroyItemcallback to BaseGridView and fix doc comments - Added HelpBox UI element
- Added runtime data binding support to
BaseGridViewcomponent. - Added the support of custom ColorPicker inside the ColorField element via customPicker property.
- Added
disableAnimationproperty on Popup elements in order to force disable display animation for a given Popup UI Element. - New
CodeBlockUITK component (Unity.AppUI.UI.CodeBlock): rounded card with a header row (language label + hover-revealed copy button usingPlatform.SetPasteboardData) above a monospaced body. Syntax highlighting is configured declaratively from USS via twoCustomStyleProperty<string>values (--codeblock-grammar,--codeblock-theme) holding TextMate asset GUIDs; setting thelanguageproperty toggles aappui-code-block--lang-<value>modifier class so per-language grammar mappings can be expressed in the design system. When aTextMateThemeAssetresolves, the body's background and foreground colors are pulled fromTheme.GetDefaultBackground()/GetDefaultForeground()so the card adopts the theme's palette. IServiceCollection.AddSingleton<T>(T instance)andAddSingleton(Type, object)overloads (plus matchingAddSingletonWhen(Type, object, ContextMatch)) for registering pre-existing instances as singletons in the MVVM DI container. The supplied instance is returned as-is on every resolution; the container does not invoke a constructor or apply[Service]field/property injection on it.- Added
SetPositionandSetSizemethods toPopoverfor programmatic positioning and sizing. - Added
movableproperty toPopoverUI elements. - Shipped Roboto Mono (
PackageResources/Fonts/RobotoMono-Regular.ttf) as a runtime font asset and exposed it as a new design token--appui-code-font-family(declared inComponents/CodeBlock.uss). The font was previously buried underEditor/Editor Default Resources/Fonts/and only reachable from editor windows; the Redux DevTools--mono-fontreference was migrated to the new token. - SplitViewSplitterCountChangedEvent dispatched when the number of splitters changes in a SplitView, allowing consumers to defer collapse/expand operations until splitters are ready
- Added
movableproperty toDialogTriggerto support movable popovers via UXML. - Bundled TextMate grammars (csharp, lua, css, xml, json) and themes (dark-plus, light-plus) under
PackageResources/SyntaxHighlighting/. The XML and Lua grammars were stripped of their cross-languagesource.java/source.cincludes so they tokenize standalone in our single-grammarRegistry. Used by the newCodeBlockcomponent for syntax highlighting whenAPPUI_ENABLE_SYNTAX_HIGHLIGHTINGis enabled. - Added support of system theme in WebGL. Use
Platform.darkModeor register your callback on thePlatform.darkModeChangedevent to make changes in your application based on the current system theme. - Added SortingOrder proeprty in Popups. This enable the possibility to insert popups in behind others exisiting ones.
- PanelRenderer support in UIToolkitAppBuilder
for hosting MVVM apps on Unity 6.5+ - Added support of drag-to-increment-value feature in
InputLabelUI element. - Added support of system clipboard in WebGL platform for text fields.
- New
MarkdownViewUITK component (Unity.AppUI.Markdownnamespace) gated behind theAPPUI_ENABLE_MARKDOWNscripting symbol. It parses CommonMark + GFM via the bundled Markdig 0.37.0 (Runtime/Markdown/Plugins/Markdig.dll) and renders into App UI components only —Heading,Quote,Divider,LocalizedTextElement,Link, plus the newCodeBlock— through a customRendererBase(UITKMarkdownRenderer) with one object-renderer per CommonMark node type. - Added AI Agent Skills pane in Unity Package Manager UI: You can now install/remove App UI skills for AI Agents in your workspace from the Package Manager window.
- Added support of Unity 6000.6
- UxmlCloneTreeGenerator now collects UxmlElementNameAttribute bindings from inherited base classes, respecting C# shadowing rules.
CodeBlock.showLineNumbersproperty: when enabled, a 1-based line-number gutter appears on the left of the body. Both the gutter and the body live inside the sameScrollView, so vertical and horizontal scrolling keep the numbers aligned with their corresponding source lines.- Added
check-circleandx-circleicons as part of the minimal icons set - Added support of CoreCLR for the migration from Mono scripting backend for Unity 6.5+
- Added support for the new EntityId API in Unity 6000.3.0a1 and newer.
- Registered the
copyicon (regular variant) inIcons - Minimal.ussandIconBrowser's required-icons list, so any consumer using the App UI minimal icon set has access to it. Used by the newCodeBlockcomponent's hover-revealed copy-to-clipboard button. - Added documentation about getting started using UI Builder.
Removed
- Removed Android Activity (AppUIActivity, AppUIGameActivity) and AndroidManifest.xml from the App UI package. The Android platform integration now operates without a custom Activity or manifest.
Changed
AnchorPopup.RefreshPositionis nowpublicinstead ofprotected.- Streamlined AI skill content by removing duplicated sections from the main skill, consolidating reference documentation pointers, and fixing a Task/TodoItem naming conflict in the MVVM example
ColorFieldpopover is now movable by default.- Improved AI skill descriptions with richer trigger phrases for more reliable skill activation
- Default
resizeDirectionforDialogTriggerchanged fromVerticaltoFree. - Added CSS transition animations for background-color, border-color, and color properties on Button and ActionButton components
- Switch CodeBlock syntax highlighting to themed batch tokenization (TextMateLib v0.2.0) for faster rendering and reduced GC allocations
Fixed
- Fixed the AppUI settings assets search and auto-assignation before building a project.
- Fix theme color matching in syntax-highlighted code blocks
- Fixed runtime bindings for
DateFieldandDateRangeFieldvalueproperty. - Composite Numerical fields (such as Vector fields, Bounds fields, etc) previous value returned in the ChangeEvent is now the correct one.
- Fixed UpHandler calls in Draggable manipulator.
- Fixed the help url in the inspector for App UI Settings assets.
- Fixed exception thrown on Tabs element when refreshing the indicator with an out of range value.
- Fixed columns size and added more info in Storybook window.
- Added missing
[CreateProperty]attribute onclickableproperty across all pressable components to fix runtime data binding forclickable.commandpath (UUM-138492) - Fixed the search bar in the Icon Browser remaining enabled when filtering yields no results
- Disable "Delete selected icons" context menu option in Icon Browser when only required icons are selected
- Set minimum window sizes for IconBrowser, NavigationGraphWindow, and DevToolsWindow to prevent layout issues when resized too small
- Fixed an issue when trying to dismiss ColorPicker popup consecutively from ColorField
- Fixed the use of obsolete API in Trackpad sample
- Fixed
VisualElementExtensions.IsOnScreenmethod which gave wrong result in world-space panels. - Fixed applying anchored popup positions only if the computed values are different than the existing ones to avoid floating point precision issues in the layout.
- Build the Linux x86_64 TextMateLib native plugin against an older glibc baseline with a statically linked C++ runtime, so it loads on Unity 2021.3 Linux (resolves the
GLIBC_2.32 not foundload error) - Fixed TextArea auto-resize calculation to use explicit padding/border/margin measurements and trigger resize on geometry changes
- Added
CreatePropertyattribute to generated command properties for Unity 2023.2+ to enable Unity Properties Serialization support in the MVVM CommandGenerator. - Fixed overlapping scrollbar arrow icons that appeared when resizing the Properties section in the App UI Storybook window
- Fixed code path activation for native plugins depending on target platform
- Fixed ActionButton CSS selector ordering for
.is-selectedto follow BEM conventions and corrected--appui-alias-actions-border-color-selectedto reference the selected background color alias instead of a hardcoded base token - Fixed iOS Simulator linker errors by shipping separate Device and Simulator native plugin binaries (libAppUINativePlugin.a and libAppUITextMateLib.a with bundled oniguruma)
- Fixed exception thrown inside the MVVM & Redux sample.
- Fixed sending ChangeEvent in numerical fields as soon as they are attached to a panel if their value has been changed already even without notification.
- App UI Icons StyleSheet Asset now has a StyleSheet icon in the Project window when creating the StyleSheet Asset.
- Fixed coordinates conversion in AnchorPopupUtils.ComputePosition method
- Fix Icon Browser "Add icons" button not working on Unity 6000.4+ due to ObjectSelector.Show API change (List<int> to List<EntityId>)
- Fixed a NullReferenceException in MenuItem.OpenSubMenu when Menu/MenuItem are declared inline in UXML without a MenuTrigger or MenuBuilder.Build() wrapper.
- Fix headless Windows IL2CPP build crash caused by the native plugin activating WinRT settings objects at static scope on Windows Server Core (game-ci/unity-builder#702)
Deprecated
- Deprecated Badge
content,max, andshowZeroproperties in favor of using child elements for badge content
[2.2.0-pre.12] - 2026-07-07
Fixed
- Fix theme color matching in syntax-highlighted code blocks
- Build the Linux x86_64 TextMateLib native plugin against an older glibc baseline with a statically linked C++ runtime, so it loads on Unity 2021.3 Linux (resolves the
GLIBC_2.32 not foundload error) - Fix headless Windows IL2CPP build crash caused by the native plugin activating WinRT settings objects at static scope on Windows Server Core (game-ci/unity-builder#702)
Changed
- Switch CodeBlock syntax highlighting to themed batch tokenization (TextMateLib v0.2.0) for faster rendering and reduced GC allocations
[2.2.0-pre.11] - 2026-06-04
Added
IServiceCollection.AddSingleton<T>(T instance)andAddSingleton(Type, object)overloads (plus matchingAddSingletonWhen(Type, object, ContextMatch)) for registering pre-existing instances as singletons in the MVVM DI container. The supplied instance is returned as-is on every resolution; the container does not invoke a constructor or apply[Service]field/property injection on it.
Fixed
- Disable "Delete selected icons" context menu option in Icon Browser when only required icons are selected
- Fixed iOS Simulator linker errors by shipping separate Device and Simulator native plugin binaries (libAppUINativePlugin.a and libAppUITextMateLib.a with bundled oniguruma)
- Fix Icon Browser "Add icons" button not working on Unity 6000.4+ due to ObjectSelector.Show API change (List<int> to List<EntityId>)
[2.1.11] - 2026-06-04
Fixed
- Improve Icon Browser selection visibility and tile contrast in light theme
- Disable "Delete selected icons" context menu option in Icon Browser when only required icons are selected
- Fixed iOS Simulator linker errors by shipping separate Device and Simulator native plugin binaries
- Fix Icon Browser "Add icons" button not working on Unity 6000.4+ due to ObjectSelector.Show API change (List<int> to List<EntityId>)
Added
- PanelRenderer support in UIToolkitAppBuilder
for hosting MVVM apps on Unity 6.5+
[2.0.6] - 2026-05-25
Fixed
- Fixed a NullReferenceException in MenuItem.OpenSubMenu when Menu/MenuItem are declared inline in UXML without a MenuTrigger or MenuBuilder.Build() wrapper.
[2.1.10] - 2026-05-22
Fixed
- Fixed a NullReferenceException in MenuItem.OpenSubMenu when Menu/MenuItem are declared inline in UXML without a MenuTrigger or MenuBuilder.Build() wrapper.
[2.2.0-pre.9] - 2026-05-20
Added
- Added Thread UI components including Thread, ThreadMessage, ThreadComposer, ThreadReaction, ThreadReactionBar, ThreadResolveMessage, ThreadUnresolveMessage, MentionPicker, and ReactionPicker, along with their associated interfaces (IEmojiProvider, IMentionProvider, IThreadAttachment), base classes, enums, and USS styles. Renamed ThreadMessage
contentproperty tomessage, removedisEditingproperty in favor ofstate = Draft, movedemojiProviderandmentionProviderfrom ThreadMessage to ThreadContext, removedActivemessage state, and exposed explicitattachmentscontainer on ThreadMessage and ThreadComposer - Added new icons (arrow-up, paperclip, pen, paper-plane-tilt, smiley, thumbs-up, thumbs-down) to the minimal icon set and IconBrowser required icons list
- Added TextMate grammar-based syntax highlighting support via native TextMateLib integration, including C# bindings (Registry, Grammar, Theme, Token), ScriptableObject assets (TextMateGrammarAsset, TextMateThemeAsset), ScriptedImporters for .tmLanguage and .tmTheme files, and a high-level TextMateSyntaxHighlighter API
- Added Edit and Delete text action constants with localization support in TextActions
- New
CodeBlockUITK component (Unity.AppUI.UI.CodeBlock): rounded card with a header row (language label + hover-revealed copy button usingPlatform.SetPasteboardData) above a monospaced body. Syntax highlighting is configured declaratively from USS via twoCustomStyleProperty<string>values (--codeblock-grammar,--codeblock-theme) holding TextMate asset GUIDs; setting thelanguageproperty toggles aappui-code-block--lang-<value>modifier class so per-language grammar mappings can be expressed in the design system. When aTextMateThemeAssetresolves, the body's background and foreground colors are pulled fromTheme.GetDefaultBackground()/GetDefaultForeground()so the card adopts the theme's palette. - Shipped Roboto Mono (
PackageResources/Fonts/RobotoMono-Regular.ttf) as a runtime font asset and exposed it as a new design token--appui-code-font-family(declared inComponents/CodeBlock.uss). The font was previously buried underEditor/Editor Default Resources/Fonts/and only reachable from editor windows; the Redux DevTools--mono-fontreference was migrated to the new token. - Bundled TextMate grammars (csharp, lua, css, xml, json) and themes (dark-plus, light-plus) under
PackageResources/SyntaxHighlighting/. The XML and Lua grammars were stripped of their cross-languagesource.java/source.cincludes so they tokenize standalone in our single-grammarRegistry. Used by the newCodeBlockcomponent for syntax highlighting whenAPPUI_ENABLE_SYNTAX_HIGHLIGHTINGis enabled. - New
MarkdownViewUITK component (Unity.AppUI.Markdownnamespace) gated behind theAPPUI_ENABLE_MARKDOWNscripting symbol. It parses CommonMark + GFM via the bundled Markdig 0.37.0 (Runtime/Markdown/Plugins/Markdig.dll) and renders into App UI components only —Heading,Quote,Divider,LocalizedTextElement,Link, plus the newCodeBlock— through a customRendererBase(UITKMarkdownRenderer) with one object-renderer per CommonMark node type. CodeBlock.showLineNumbersproperty: when enabled, a 1-based line-number gutter appears on the left of the body. Both the gutter and the body live inside the sameScrollView, so vertical and horizontal scrolling keep the numbers aligned with their corresponding source lines.- Registered the
copyicon (regular variant) inIcons - Minimal.ussandIconBrowser's required-icons list, so any consumer using the App UI minimal icon set has access to it. Used by the newCodeBlockcomponent's hover-revealed copy-to-clipboard button.
Deprecated
- Deprecated Badge
content,max, andshowZeroproperties in favor of using child elements for badge content
Fixed
- Fixed TextArea auto-resize calculation to use explicit padding/border/margin measurements and trigger resize on geometry changes
- Fixed ActionButton CSS selector ordering for
.is-selectedto follow BEM conventions and corrected--appui-alias-actions-border-color-selectedto reference the selected background color alias instead of a hardcoded base token - Fixed a NullReferenceException in MenuItem.OpenSubMenu when Menu/MenuItem are declared inline in UXML without a MenuTrigger or MenuBuilder.Build() wrapper.
Changed
- Added CSS transition animations for background-color, border-color, and color properties on Button and ActionButton components
[2.1.9] - 2026-04-07
Fixed
- Added missing
[CreateProperty]attribute onclickableproperty across all pressable components to fix runtime data binding forclickable.commandpath (UUM-138492)
[2.0.5] - 2026-04-07
Fixed
- Added missing
[CreateProperty]attribute onclickableproperty across all pressable components to fix runtime data binding forclickable.commandpath (UUM-138492)
[2.2.0-pre.8] - 2026-04-06
Added
- Added
sizeModifiercallback property toResizeHandleto allow custom size adjustments during resize. - Added
UxmlTraitssupport forResizeHandlecomponent. - Added
SetPositionandSetSizemethods toPopoverfor programmatic positioning and sizing. - Added
movableproperty toPopoverUI elements. - Added
movableproperty toDialogTriggerto support movable popovers via UXML.
Changed
AnchorPopup.RefreshPositionis nowpublicinstead ofprotected.ColorFieldpopover is now movable by default.- Default
resizeDirectionforDialogTriggerchanged fromVerticaltoFree.
Fixed
- Added missing
[CreateProperty]attribute onclickableproperty across all pressable components to fix runtime data binding forclickable.commandpath (UUM-138492)
[2.2.0-pre.7] - 2026-03-25
Removed
- Removed Android Activity (AppUIActivity, AppUIGameActivity) and AndroidManifest.xml from the App UI package. The Android platform integration now operates without a custom Activity or manifest.
Added
- Added AI Agent Skills pane in Unity Package Manager UI: You can now install/remove App UI skills for AI Agents in your workspace from the Package Manager window.
- Added support of Unity 6000.6
Changed
- Streamlined AI skill content by removing duplicated sections from the main skill, consolidating reference documentation pointers, and fixing a Task/TodoItem naming conflict in the MVVM example
- Improved AI skill descriptions with richer trigger phrases for more reliable skill activation
[2.1.8] - 2026-03-25
Added
- Added support of Unity 6000.6
[2.1.7] - 2026-03-20
Fixed
- Fixed the use of deprecated EndNameEditAction in IconBrowser
[2.2.0-pre.6] - 2026-03-02
Added
- Add
destroyItemcallback to BaseGridView and fix doc comments - Added HelpBox UI element
- Added
disableAnimationproperty on Popup elements in order to force disable display animation for a given Popup UI Element. - Added SortingOrder proeprty in Popups. This enable the possibility to insert popups in behind others exisiting ones.
- UxmlCloneTreeGenerator now collects UxmlElementNameAttribute bindings from inherited base classes, respecting C# shadowing rules.
- Added
check-circleandx-circleicons as part of the minimal icons set
Fixed
- Fixed UpHandler calls in Draggable manipulator.
- Fixed exception thrown on Tabs element when refreshing the indicator with an out of range value.
- Fixed sending ChangeEvent in numerical fields as soon as they are attached to a panel if their value has been changed already even without notification.
[1.3.6] - 2026-02-18
Fixed
- Fixed overlapping scrollbar arrow icons that appeared when resizing the Properties section in the App UI Storybook window
[1.3.5] - 2026-01-31
Fixed
- Fixed the help url in the inspector for App UI Settings assets.
[2.2.0-pre.5] - 2026-01-30
Fixed
- Fixed the help url in the inspector for App UI Settings assets.
- Fixed the search bar in the Icon Browser remaining enabled when filtering yields no results
- Set minimum window sizes for IconBrowser, NavigationGraphWindow, and DevToolsWindow to prevent layout issues when resized too small
- Fixed the use of obsolete API in Trackpad sample
- Fixed overlapping scrollbar arrow icons that appeared when resizing the Properties section in the App UI Storybook window
- Fixed exception thrown inside the MVVM & Redux sample.
[2.1.6] - 2026-01-30
Fixed
- Fixed type name conflict for MaskField in the UI Kit sample.
- Fixed the help url in the inspector for App UI Settings assets.
- Fixed the search bar in the Icon Browser remaining enabled when filtering yields no results
- Set minimum window sizes for IconBrowser, NavigationGraphWindow, and DevToolsWindow to prevent layout issues when resized too small
- Fixed the use of obsolete API in Trackpad sample
- Fixed overlapping scrollbar arrow icons that appeared when resizing the Properties section in the App UI Storybook window
- Fixed exception thrown inside the MVVM & Redux sample.
[2.0.4] - 2026-01-30
Fixed
- Fixed type name conflict for MaskField in the UI Kit sample.
- Fixed the help url in the inspector for App UI Settings assets.
- Fixed the search bar in the Icon Browser remaining enabled when filtering yields no results
- Set minimum window sizes for IconBrowser, NavigationGraphWindow, and DevToolsWindow to prevent layout issues when resized too small
- Fixed overlapping scrollbar arrow icons that appeared when resizing the Properties section in the App UI Storybook window
- Fixed exception thrown inside the MVVM & Redux sample.
[2.0.3] - 2026-01-25
Fixed
- Composite Numerical fields (such as Vector fields, Bounds fields, etc) previous value returned in the ChangeEvent is now the correct one.
- Fixed the use of obsolete API in Trackpad sample
- Fixed applying anchored popup positions only if the computed values are different than the existing ones to avoid floating point precision issues in the layout.
- Fixed the usage of obsolete InstanceId API.
- App UI Icons StyleSheet Asset now has a StyleSheet icon in the Project window when creating the StyleSheet Asset.
[1.3.4] - 2026-01-25
Fixed
- Fixed the usage of obsolete InstanceId API.
- Fixed the trackpad sample.
[2.1.5] - 2026-01-24
Fixed
- Fixed the usage of obsolete InstanceId API.
[2.2.0-pre.4] - 2026-01-23
Added
- Added support of DevicePixelRatio in WebGL native plugin to determine the current ScaleFactor applied to the canvas.
- Added Uxml cloneTree and element binding by name source generators. See the documentation for more information.
- Added runtime data binding support to
BaseGridViewcomponent. - Added the support of custom ColorPicker inside the ColorField element via customPicker property.
- Added support of system theme in WebGL. Use
Platform.darkModeor register your callback on thePlatform.darkModeChangedevent to make changes in your application based on the current system theme. - Added support of drag-to-increment-value feature in
InputLabelUI element. - Added support of system clipboard in WebGL platform for text fields.
Fixed
- Composite Numerical fields (such as Vector fields, Bounds fields, etc) previous value returned in the ChangeEvent is now the correct one.
- Fixed applying anchored popup positions only if the computed values are different than the existing ones to avoid floating point precision issues in the layout.
- App UI Icons StyleSheet Asset now has a StyleSheet icon in the Project window when creating the StyleSheet Asset.
[2.1.4] - 2026-01-23
Fixed
- Composite Numerical fields (such as Vector fields, Bounds fields, etc) previous value returned in the ChangeEvent is now the correct one.
- Fixed applying anchored popup positions only if the computed values are different than the existing ones to avoid floating point precision issues in the layout.
- App UI Icons StyleSheet Asset now has a StyleSheet icon in the Project window when creating the StyleSheet Asset.
[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+
[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.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. - Use
resolvedStyle.scaleinstead oftransform.scaleto scale elements such as theCanvascontainer. - 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.
- Use
resolvedStyle.scaleinstead oftransform.scaleto scale elements such as theCanvascontainer. - 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.