Search Unity

  1. Megacity Metro Demo now available. Download now.
    Dismiss Notice
  2. Unity support for visionOS is now available. Learn more in our blog post.
    Dismiss Notice

Official UI Builder - Latest Version: 1.0.0-preview.18

Discussion in 'UI Toolkit' started by uDamian, Feb 6, 2020.

Thread Status:
Not open for further replies.
  1. uDamian

    uDamian

    Unity Technologies

    Joined:
    Dec 11, 2017
    Posts:
    1,231
    UI Builder has been out as a preview package for a while now and we've kept working on it since we revealed it at Unite Copenhagen 2019. Going forward, we will post new version updates in this thread so if you want to be notified, just follow this thread.

    To install, you may need to enable Preview packages in your project. This is diffferent depending how new your Unity version is:
    1. Enable in the Package Manager:
    upload_2020-5-8_16-28-52.png

    2. (if 1 is not available) Enable in Project Settings:
    upload_2020-5-8_16-26-59.png

    To upgrade, just open the Package Manager, find the UI Builder package, and press the Update button in the bottom-right corner.

    If you have comments, questions, or bugs, please open a new thread.

    Full CHANGELOG can be found here:
    https://docs.unity3d.com/Packages/com.unity.ui.builder@0.11/changelog/CHANGELOG.html
     
    Last edited: May 8, 2020
    makaka-org likes this.
  2. uDamian

    uDamian

    Unity Technologies

    Joined:
    Dec 11, 2017
    Posts:
    1,231
    0.10.1 - 2020-02-06
    • Improved handling of external changes made to the currently open UXML or USS asset. Unsaved changes will still be lost for now but the UI Builder will at least refresh itself properly after an external change.
    • Added character validation for new style selector in the StyleSheets pane.
    • Improved character validation when adding a style class to an element in the Inspector pane.
    • Added character validation to the Name, Binding Path, and View Data Key attributes of an element in the Inspector pane as you type.
    • Added type validation to the Type attribute, like on the ObjectField, with a bit of auto-completion.
    • Added multi-line support to the Text attribute in the Inspector.
    • Added the style fields' right-click menu option to Set a style (inline in UXML or in StyleSheet) at whatever default or inherited value it is at without having to modify it explicitly.
    • Style fields' right-click menu options Set and Unset will be grayed out if the respective action is not applicable (can't Set something that is already Set).
    • Added IMGUIContainer and all Toolbar controls to the Library.
    • Added better (looking) default values for Gradient Field and Curve Field when hovering them in the Library and when adding them to the document.
    • Copy/Paste and Duplicate will now focus the newly created element.
    • Dragging an element from the Library into the Canvas will now focus the Viewport, letting you immediately delete it.
    • When the Save Dialog appears, the UXML path field will automatically get focus.
    • Pressing Enter in the UXML or USS fields of the Save Dialog will be equivalent to pressing the Save button.
    • When editing name of element in Hierarchy, clicking somewhere else will now commit the change (if the new name is valid).
    • Removed Reset button from Toolbar.
    • Removed UI Builder's own assets and types from showing up in the Library.
    • Element highlight while hovering the StyleSheets and Hierarchy pane will now be clipped by the Viewport and will no longer show on top of other panes.
    • Fixed a bug where the UXML or USS Preview pane header would appear duplicated.
    • Fixed special symbols in attribute values, like \t \n & < > ' ", not being escaped properly when generating the UXML.
    • Fixed extracting local style overrides to new USS selector not properly extracting resource()-type paths.
    • Fixed console errors when turning on Camera render texture background mode for the Canvas on new documents.
    • Fixed SliderInt console errors when added to document and having the Step Size attribute not working.
    • Fixed Opacity style percent field incorrectly casting the integer input values to float, causing a 5 to turn into a 4.
    • Fixed ProgressBar Low Value and High Value attributes not being read properly from the element when displaying the Attributes inspector.
    • Fixed display: none in a StyleSheet rule not being properly read by the Builder, causing console errors when showing the Inspector of the rule.
    • Fixed the Type attribute on the ObjectField immediately invalidating the UXML on first input character, causing import errors, and making it unusable.
    • Fixed Slider default label saying SliderInt.
    • Fixed tooltip and drag preview for Bounds and Bounds (Int) to not appear squished.
    • Fixed zoom and pan not being remembered per document.
    • Fixed being able to delete and move elements inside a C# element or UXML template instance.
    • Fixed canvas theme not being re-applied when loading a document.
    • Fixed Toolbar document name not getting the * for unsaved changes right after a save and a modification to inline styles.
    • Fixed no preview showing up while dragging a ListView, ScrollView, or IMGUIContainer.
    • Fixed double-clicking the .uxml document entry in the Hierarchy causing an error in the Console.
    • Fixed asset rename/move warning dialogs to show the type of action being done (was always showing as a move).
    • Fixed dragging from Hierarchy using right-click causing the preview tooltip to stay on screen when mouse button is released.
     
  3. uDamian

    uDamian

    Unity Technologies

    Joined:
    Dec 11, 2017
    Posts:
    1,231
    0.10.2 - 2020-03-11
    • Moved Hierarchy "hamburger/3-dots" options menu from a dedicated toolbar to the Hierarchy pane header.
    • Newly created empty VisualElements will now auto-size themselves when given a background image, provided no other styles have already been overridden.
    • The Inspector will now be blank when nothing is selected to match the Unity Inspector Window.
    • Fixed handling of built-in resources assets when set via the Inspector. USS does not support such paths and this is now properly indicated with an message.
    • Fixed background color style alpha value being reset to 255 if all other components were set to 0.
    • Fixed ghosting of some inspector controls when the inspector was disabled.
    • Fixed text overlapping controls in Library hover and drag tooltips.
    • Fixed null-ref exception when deselecting an element after having made a change to style but not committed the change.
    • Fixed Overflow style not being visually applied in the canvas when changed as an inline style.
    • Fixed Canvas not being centered the first time the UI Builder window is opened with no UXML document loaded.
    • Fixed escaping of `&` in image file paths inside inlined styles in UXML.
    • Fixed canvas background settings like Camera view being reset when saving file for the first time.
    • Fixed the unsaved changes marker `*` not appearing beside file names in the StyleSheet, Hierarchy, UXML Preview, and USS Preview panes.
    • (mac) Fixed macOS playing the "bad key-press" sound when the Delete key is used to delete an item from the inspector.
    • (2020.1+) Fixed showing a blank 3rd button in the Overflow style options in the Inspector.
     
    sniffle63 and renem like this.
  4. uDamian

    uDamian

    Unity Technologies

    Joined:
    Dec 11, 2017
    Posts:
    1,231
    0.11.0 - 2020-05-05
    • Multi-USS Support:
      • Added support for attaching zero and more than one USS file to your UXML document.
      • By default, new UXML documents will now start with zero USS files attached.
      • From the StyleSheets pane, you can right-click to:
        • add an existing USS file to your UXML document,
        • create a new empty USS file,
        • or remove a USS from the UXML document.
      • In order to add a USS file to the document, there has to be at least one element in the UXML document to contain the `<Style>` tag.
      • There is now the concept of an "active" USS file (marked with **bold** text). This will be the file new selectors are added via:
        • the toolbar field,
        • copy/paste,
        • or the Inspector's Extract Inline Styles feature.
    • Re-designed Library Pane:
      • Library items now have icons! These icons also appear in the Hierarchy.
      • New Library pane view with large icons in a grid.
      • Elements that are only supported for writing Editor Extensions are now marked "Editor Only" in the Library.
      • UXML files in the Library "Open" button replaced with icon that only appears on hover.
      • Library is split into two tabs:
        • "Standard" tab is where all standard Unity controls are located.
        • "Project" tab is where all project UXML and custom C# controls can be found.
    • Re-designed Selection Overlays:
      • Improved the look of the selection overlay to not obscure the element. It's just a blue border now.
      • The size/border/padding/margin overlays will appear only when editing size/border/padding/margin style properties in the Inspector.
      • Added header on selected element with type or name being displayed.
    • Other:
      • Added support for editing of text in-place directly in the Canvas by double clicking on a text element.
      • Added ability to hide the UXML and USS Preview panes.
      • Added checkerboard-style background for the Runtime Theme to better visualize transparent elements.
      • Added support for the system Rename command in the Hierarchy (which can optionally be given a hotkey, like F2, via the Shortcut Manager).
      • Added right-click menu on Inspector Styles section category foldouts with option to Unset all style properties in a category at once.
      • Added an icon to the UI Builder window tab.
      • Added support for the vector image type (enabled if the optional Vector Graphics package is installed).
      • (2020.2+) Added horizontal scrollbar to Hierarchy and StyleSheets panes.
      • (2020.2+) Added support for the MissingReference style property type to allow users to fix broken paths in USS inside the UI Builder.
    • Fixed
      • Fixed invalid type conversion error when placing down a LayerMaskField.
      • Fixed Wrap style "nowrap" generating incorrect USS with the wrong keyword, "no-wrap".
      • Fixed ESC key not cancelling the Rename of an element in the Hierarchy.
      • Fixed clicking somewhere else while renaming an element in the Hierarchy (de-focusing the Rename field) not committing the rename.
      • Fixed background image and cursor style properties generating invalid USS if set to "none".
      • Fixed extra fields being visible behind numeric StyleFields when the Inspector pane was really wide.
      • Fixed extra escape characters being added to the style attribute in the generated UXML.
      • Fixed having the ability to remove an un-removable style class that was not added in UXML in the Inspector.
      • Fixed line endings used in saved UXML and USS to use Unity's project setting and/or OS-defaults.
      • Fixed undo/redo history being cleared when entering playmode.
      • (2019.3+) Fixed exceptions when opening a USS file with use of color keywords.
     
    Last edited: May 13, 2020
    sniffle63, Flipps, mrSaig and 3 others like this.
  5. uDamian

    uDamian

    Unity Technologies

    Joined:
    Dec 11, 2017
    Posts:
    1,231
    0.11.1 - 2020-05-12
    • Added a "+" menu to the StyleSheets pane toolbar to make adding USS assets to the current document more discoverable.
    • Fixed UI Builder not being able to display if loaded UXML or USS have invalid or unsupported syntax, even after a Unity restart.
    • Fixed regression where changes made to USS or UXML in external editor would be undone when the UI Builder refreshed.
    • Fixed hover preview overlay in the Library not disappearing when opening a UXML document via the Library open icon.
    • Fixed reloading the scene causing Canvas camera background to go blank.
    • Fixed extracting of inline styles from the Inspector when there are no USS files attached to the UXML document. A dialog with options will now be shown.
     
    Lahcene, Kan15hkSMT and DonLoquacious like this.
  6. uDamian

    uDamian

    Unity Technologies

    Joined:
    Dec 11, 2017
    Posts:
    1,231
    0.11.2 - 2020-05-14
    • Fixed stack overflow error when deleting USS selector via right-click > Delete in the StyleSheets pane.
    • Fixed name and icon of UI Builder window being reset to just "Builder" (and no icon) after a domain reload.
    • (2020.1+) Fixed UXML Instance elements (TemplateContainers) not showing any attribute fields in the Inspector (like Name).
     
    Lahcene and sundayhd5 like this.
  7. uDamian

    uDamian

    Unity Technologies

    Joined:
    Dec 11, 2017
    Posts:
    1,231
    1.0.0-preview.1 - 2020-06-18

    MINIMUM REQUIREMENTS:
    • 2019.3.15f1 or newer
    • 2019.4.0f1 or newer
    • 2020.1.0b12 or newer
    • 2020.2.0a14 or newer
    CHANGELOG:
    • Unity 2019.2 is no longer supported.
    • (2020.1+) Multi-Selection Support:
      • Can now select more than one element or USS selector at the same time via Shift+Click or Ctrl+Click in the Hierarchy.
      • When multiple elements or USS selectors are selected, the Inspector will not display any controls. Editing of a multi-selection is not yet supported.
      • Can copy/paste/duplicate/delete a multi-selection as long as all items in the selection are of the same type. This includes copy/pasting from UI Builder into a text file.
      • Can drag-reparent or drag-reorder a multi-selection in the Hierarchy and the StyleSheets pane as long as all items in the selection are of the same type.
    • New Editor Extension Authoring:
      • UI Builder is now configured by default to be used for runtime UI. As such, many Editor-Only controls will not be available in the Library.
      • To see Editor-Only controls and controls meant for use within the Editor, you can enable Editor Extension Authoring from the new Document settings Inspector by selecting the Canvas header or .uxml document in the Hierarchy.
      • The Editor Extension Authoring setting is saved inside the UXML asset and therefore version controlled. This is unlike the Canvas settings which are temporary preferences.
      • You can enable Editor Extension Authoring for all new documents or documents not opened by UI Builder before in the Project Settings > UI Builder settings.
    • (2019.3+) Variables Support:
      • If a style is getting its value from a USS variable, its style field label in the Inspector will appear highlighted.
      • Can now click on the label of a style field using a USS variable to see where the variable value is coming from (via a tooltip popup).
      • Selectors can now use USS variables for their style values via a new per-field variable mode. This is not supported on elements via inline styles.
      • Style field variable mode can be activated by double-clicking on its label or via a button in the tooltip popup.
    • Sub-Documents:
      • Added option in Hierarchy to open a UXML instance as a sub-document via the right-click menu on a TemplateContainer.
      • Can return to parent document by right-clicking on the sub-document's .uxml root item in the Hierarchy and selecting Return to Parent Document.
      • Sub-documents and their parents will all be grayed-out and disabled in the Library pane.
      • A breadcrumb toolbar will appear when currently viewing a sub-document. Can click on parent documents to return to them.
    • Other:
      • Improved clarity of Library pane by moving Editor-Only tags to category headers instead of per-item.
      • Re-designed Canvas Background settings. Custom background is not enabled/disabled via checkbox on Foldout header and Opacity is now remembered per type of custom background.
      • The StyleSheets pane "States" menu has been moved inside the new selector field with the new label: ":".
      • The StyleSheets pane "Add" menu has been removed. New selectors can now only be added by pressing Enter in the new selector field.
      • Can now drag-and-drop selectors in the StyleSheets pane to reorder them or move them to another StyleSheet.
      • Active StyleSheet will no have to be manually switched via right-click menu on the StyleSheet. It is no longer driven by current selection.
      • Canvas now has a header displaying the open UXML file name (which is no longer listed in the Viewport's header).
      • Canvas and document settings in the Inspector can now be accessed also by clicking on the new Canvas header.
      • List-based attributes, like the Mask field's choices attribute, now show and edit properly in the Inspector's Attributes section as comma-separated strings.
      • Instanced UXML templates inside main UXML document from the Library will now have their name initialized to be their .uxml asset name.
      • Added right-click option to open a TemplateContainer's UXML asset directly from the Hierarchy.
    • Fixed:
      • Fixed right-click Unset on an Inspector category (ie. Margin & Padding) not properly un-setting all style properties within the category.
      • Fixed initial size of the UI Builder window being too small the first time it's installed.
      • Fixed removing of a USS from the document sometimes reloading the UXML immediately after and re-adding the removed USS.
      • Fixed USS files not being added or removed properly to/from the document if all root elements were TemplateContainers.
     
  8. uDamian

    uDamian

    Unity Technologies

    Joined:
    Dec 11, 2017
    Posts:
    1,231
    1.0.0-preview.2 - 2020-07-16

    MINIMUM REQUIREMENTS:
    • 2019.3.15f1 or newer
    • 2019.4.3f1 or newer
    • 2020.1.0b15 or newer
    • 2020.2.0a17 or newer
    CHANGELOG:
    • Added ability to lock the Canvas to the size of the Game view via the Canvas settings inspector.
    • Hierarchy and StyleSheets panes no longer expand all tree items by default.
    • Added back value click-and-drag dragger on style fields.
    • Activating Variable Mode on a Style Field and showing variable info are both now accessible via the right-click context menu on a field.
    • Creating a new selector via the New Selector Field in the StyleSheets pane will now select it right after. This will also expand its StyleSheet if it is collapsed.
    • Added ability to enable/disable Editor Extensions Authoring via the Library top-right 3-dots menu.
    • Improved performance of the Inspector and selection changing.
    • Added checks for circular dependency injection for UXML templates.
    • Fixed Invalid Asset Type message dialog not displaying the path to the asset being added.
    • Fixed ReadOnly attribute value not being read by the Builder Inspector correctly.
    • Fixed removing class via Inspector class pill creating a new empty selector.
    • Fixed double-clicking on a class pill in Inspector throwing errors and duplicating existing selector.
    • Fixed extra newline added to USS if a selector is selected when saving.
    • Fixed active USS being forgotten when saving or domain reloading.
    • Fixed dragging from folder/section in Library throwing null references exception.
    • Fixed setting Border Width (combined) to 0px only setting Border Width Left to 0px, but the not Right/Top/Bottom.
    • Fixed extra context menu separators being added to Hierarchy right-click menu on elements inside template.
    • Fixed generated UXML with inline styles being written with newlines on Windows.
    • Fixed adding a new selector expanding all USS files in the StyleSheets pane.
    • Fixed saving resetting the expanded states of USS files in the StyleSheets pane.
     
  9. uDamian

    uDamian

    Unity Technologies

    Joined:
    Dec 11, 2017
    Posts:
    1,231
    1.0.0-preview.3 - 2020-07-17

    MINIMUM REQUIREMENTS:
    • 2019.3.15f1 or newer
    • 2019.4.3f1 or newer
    • 2020.1.0b15 or newer
    • 2020.2.0a17 or newer
    CHANGELOG:
    • Fixed errors when instantiating a UXML template via drag-and-drop.
     
  10. uDamian

    uDamian

    Unity Technologies

    Joined:
    Dec 11, 2017
    Posts:
    1,231
    1.0.0-preview.4 - 2020-08-27

    MINIMUM REQUIREMENTS:
    • 2019.3.15f1 or newer
    • 2019.4.7f1 or newer
    • 2020.1.1f1 or newer
    • 2020.2.0a19 or newer
    CHANGELOG:
    • Sub-Documents:
      • Opening a sub-document will now display the parent USS files (as read-only) after the sub-document's own USS files in the StyleSheets pane.
      • Can now also open a sub-document directly from the Viewport right-click menu.
      • Can now open sub-documents "in-place" by right-clicking on a TemplateContainer (UXML Instance), either in the Hierarchy or the Viewport.
      • Opening sub-documents "in-place" allows editing of child UXML instances in the context of their parent UXML document.
      • Opening sub-documents "in-place" will show all elements not part of the sub-document (belonging to a parent document) faded in the Hierarchy and Canvas.
    • Other:
      • Added dismissible notification in the Viewport for when no UI Toolkit package (`com.unity.ui`) is installed in the current project.
      • Added option to see attached StyleSheets on each element in the Hierarchy via the Hierarchy's **...** menu.
      • Added support for live-reloading of UI in the Game view, assuming the version of the UI Toolkit package (`com.unity.ui`) with live-reloading support is installed.
      • Renamed Library/Project tab's "Assets" section to "UI Documents (UXML)" for clarity. This is different than the actual "Assets" folder entry in this tree view.
      • Renamed Library/Project tab's "Custom Controls" section to "Custom Controls (C#)" for clarity.
    • Fixes:
      • Fixed dragging of unselected USS Selector in StyleSheets pane not working, requiring the user to select it first before dragging.
      • Fixed Viewport panning hot keys on macOS to match the same keys used for the Scene view: command+option.
      • Fixed exceptions related to `element.Add(child)` now requiring `contentContainer` to not be null in newer versions of Unity 2020.2.
      • Fixed compilation errors when using newer versions of `com.unity.ui` package due to changes to `computedStyles` API.
      • Fixed possible corruption of parent document UXML (all Template src attributes removed) when saving child sub-document.
      • Fixed not being able to create the `*` selector from the StyleSheets pane "Add New Selector..." field.
      • Fixed double-clicking on class pills in the StyleSheet section of the Inspector to create a new selector not working when no StyleSheets have been added to document.
      • Fixed extracting inline styles to new selector that contain keywords such as Auto creating invalid USS (properties with missing values).
      • Fixed Library/Project tab's "Assets" section's expanded state conflicting with the actual "Assets" folder item's expanded tree state.
     
  11. uDamian

    uDamian

    Unity Technologies

    Joined:
    Dec 11, 2017
    Posts:
    1,231
    1.0.0-preview.5 - 2020-08-28

    MINIMUM REQUIREMENTS:
    • 2019.3.15f1 or newer
    • 2019.4.9f1 or newer
    • 2020.1.3f1 or newer
    • 2020.2.0a21 or newer
    CHANGELOG:
    • Fixed potential Unity Editor freeze needing restart while dragging an element to re-parent in the Hierarchy.
    • Fixed changes made to document before using "Save As" to create a new document still (wrongly) appearing in the original document.
    • Fixed incorrect ability to drag a new element from the Library just above the root UXML item in the Hierarchy, leading to a corrupt UI Builder state.
     
    sniffle63 likes this.
  12. uDamian

    uDamian

    Unity Technologies

    Joined:
    Dec 11, 2017
    Posts:
    1,231
    1.0.0-preview.6 - 2020-09-03

    MINIMUM REQUIREMENTS:
    • 2019.3.15f1 or newer
    • 2019.4.9f1 or newer
    • 2020.1.3f1 or newer
    • 2020.2.0a21 or newer
    CHANGELOG:
    • Fixed potential crash when dragging selectors between StyleSheets.
     
    Filip8429 likes this.
  13. uDamian

    uDamian

    Unity Technologies

    Joined:
    Dec 11, 2017
    Posts:
    1,231
    1.0.0-preview.7 - 2020-09-18

    MINIMUM REQUIREMENTS:
    • 2019.4.10f1 or newer
    • 2020.1.6f1 or newer
    • 2020.2.0b2 or newer
    CHANGELOG:
    • Unity 2019.3 is no longer supported. Please use 2019.4 LTS.
    • Fixed null ref exception when going into playmode while having StyleSheets open in the UI Builder.
    • Fixed exception when selecting built-in image asset using the Asset Picker window on the Background Image style field.
    • Fixed dragging inside the Hierarchy being unstable if the Canvas was zoomed/panned behind the Hierarchy pane.
     
    Filip8429 likes this.
  14. uDamian

    uDamian

    Unity Technologies

    Joined:
    Dec 11, 2017
    Posts:
    1,231
    1.0.0-preview.9 - 2020-10-15

    MINIMUM REQUIREMENTS:
    • 2019.4.10f1 or newer
    • 2020.1.6f1 or newer
    • 2020.2.0b2 or newer
    CHANGELOG:
    • (2020.1+) UI Builder will now add all "document level" StyleSheets as root `<Style>` tags in the UXML document, instead of adding them as `<Style>` tags under each root VisualElement.
    • (2020.1+) It is now possible to have no elements in the document but still attach a StyleSheet to the document (was not before). Deleting the last element in the document will no longer remove all document StyleSheets as well.
    • Added project setting to disable viewport zooming via mouse/trackpad to alleviate accidental zooming on Mac.
    • (2020.1+) Fixed styles being removed from root elements if those elements were adding their own local StyleSheet as part of their constructor or custom logic - such as Toolbar elements.
    • Fixed inline styles not working in built Player after saving asset in Builder.
    • Fixed being able to drag elements from Library to inside a black box C# element, like ListView, causing other problems.
    • Fixed Tab Index attribute field label in the Attributes Inspector.
    • Fixed Font Style field not appearing bold when overridden.
    • Fixed no right-click menu appearing on Font property in styles Inspector.
    • Fixed custom Canvas background image being partly under the Canvas header.
    • Fixed lack of contrast in disabled class pills in Inspector.
    • Fixed blue row highlight in Hierarchy for selected element not staying blue unless mouse was on top.
    • Fixed selected Hierarchy item not having text color inverted in Light theme.
    • Fixed being able to open read-only assets inside installed packages, leading to errors on save or dirtying the package cache.
    • Fixed the grid background of the Canvas (when using Runtime Theme) not working when using the UI Toolkit package.
    • Fixed errors around text mesh generation due to previews of really large UXML/USS documents.
     
    Filip8429, Timboc, JohngUK and 2 others like this.
  15. uDamian

    uDamian

    Unity Technologies

    Joined:
    Dec 11, 2017
    Posts:
    1,231
    1.0.0-preview.10 - 2020-11-26

    Please note: This release is a bit special in that the below Minimum Required versions are _hard_ minimums. This version of the package will not work with earlier builds of each supported major version of Unity.

    MINIMUM REQUIREMENTS:
    • 2019.4.15f1 or newer
    • 2020.1.14f1 or newer
    • 2020.2.0b12 or newer
    • 2021.1.0a7 or newer
    • If using com.unity.ui, you will need version 1.0.0-preview.13 or newer
    CHANGELOG:
    • As of 2021.1.0a8, UI Builder is now a built-in module and no longer needs this package to be installed. We will still release new versions of the package, which is able to override the built-in version in Unity when installed, that will be slightly ahead of Unity for testing and validation.
    • Canvas Style Controls:
      • Selected element blue border header will now have quick toggles for flex and text alignment styles.
      • Selected element with children will get toggles for `flex-direction`, `align-items`, and `justify-content`.
      • Selected element that is a TextElement will get toggles for `white-space` and `-unity-text-align`.
    • Clicking Through to Select Parent in Canvas:
      • If you pick an element in the Canvas and then click again in the same spot, you'll select its parent element.
      • You can click multiple times to select parent, grand-parent, etc. until the root of the Canvas after which it cycles back to the top-most element.
    • Drag and Drop In Canvas:
      • Can now start a drag operation from inside the Canvas.
      • Canvas-starting drags can be dropped both in the Hierarchy and back in the Canvas.
      • Can now drag elements in-between existing elements (siblings of the same parent) in the Canvas.
      • A yellow line will appear where the element will be created or moved to.
      • Elements are no longer re-positioned during a drag operation (faded previews). They will move or be placed when the drag is finished.
    • USS Variable Search:
      • On a USS selector, right-clicking on a style field will show the option to "Edit Variable".
      • When editing a variable, a search dialog will appear.
      • The search dialog will allow search all variables in the current theme that match the USS style property data type.
      • If in Editor Extensions mode, additional Editor-Only variables will be displayed with an indicator that they are Editor-Only.
      • Like before, "Edit Variable" mode can be enabled on a style property by just typing "--" without having to right-click.
      • Details about the currently selected variable, like where it comes from, it's current value (with a preview if it's an image), will be show at the bottom of the search dialog.
      • When editing inline-styles, details about a variable will display the same but in a read-only mode. Inline styles cannot be assigned a variable in UI Toolkit.
    • (2021.1+) 2D Sprites Support:
      • Can switch the type of background asset in the Inspector from Texture to Sprite.
      • When in Sprite mode, a button will appear to open the 2D Sprite Editor with the currently assigned Sprite, assuming the 2D Sprite package is installed.
    • (2021.2+ or 2021.1 with com.unity.ui package installed) Rich Text Support:
      • New Font Asset style property in the Inspector now allows use of the new FontAsset asset.
      • If the FontAsset supports it, there are new Text Outline and Text Shadow styling options available.
      • Text elements get a new attribute: "Enable Rich Text", which decides whether Rich Text tags are parsed.
      • The "Text" attribute on text elements now supports Rich Text tags which will style the text in the Canvas.
    • (2021.2+ or 2021.1 with com.unity.ui package installed) Theme StyleSheet Support:
      • UI Builder now looks for and allows use of the new Theme StyleSheet assets (.tss).
      • Any discovered .tss assets in the Project are listed in the Theme dropdown in the main Viewport Toolbar.
      • Allows previewing of user-made UI Toolkit themes, in addition to the default themes.
    • Other:
      • (2021.1+) Added support for the new ScrollView Scroller Visibility attributes, replacing the boolean Show/Hide Scroller attributes.
    • - Fixes:
      • Fixed re-importing of a child UXML asset that is instanced by a parent UXML asset causing the parent to be unusable via the Library pane.
      • Fixed possible instability inside in-place sub-document editing mode after selecting elements belonging to a parent document.
      • Fixed regression where the blue line between Hierarchy elements would no longer appear while dragging an element to re-parent.
      • Fixed closing of no UI Toolkit installed warning disabling Viewport zoom.
      • Fixed being able to drag elements onto existing elements outside the currently active sub-document.
      • Fixed being able to drag or create elements onto empty space in the Canvas while editing a child sub-document in-place, leading to elements being added to the wrong document.
      • Fixed unsaved changes * indicator not being reset when going inside a child sub-document while discarding changes in the parent.
      • Fixed potentially losing assigned StyleSheets in parent document when discarding changes before going inside a sub-document.
      • Fixed dragging on the label of the Canvas width/height fields not updating the Canvas size live.
      • (2020.2+) Fixed ListView Horizontal Scrolling attribute value not being reflected properly in the Inspector.
      • (2021.1+) Fixed element renaming field in the Hierarchy not responding to Enter or Esc.
     
    Last edited: Dec 9, 2020
  16. uDamian

    uDamian

    Unity Technologies

    Joined:
    Dec 11, 2017
    Posts:
    1,231
    1.0.0-preview.11 - 2020-12-04

    Please note: This release is a bit special in that the below Minimum Required versions are _hard_ minimums. This version of the package will not work with earlier builds of each supported major version of Unity.

    MINIMUM REQUIREMENTS:
    • 2019.4.15f1 or newer
    • 2020.1.15f1 or newer
    • 2020.2.0b13 or newer
    • 2021.1.0a7 or newer
    • If using com.unity.ui, you will need version 1.0.0-preview.13 or newer
    CHANGELOG:
    • Package documentation has been fully updated to reflect the current state of the UI Builder.
    • (2021.1+) Fixed Rich Text controls not properly hidden when the Text Core package was not installed.
    • (2021.1+) Fixed UI Builder not automatically installing the 2D Sprite Editor package when required.
     
    makaka-org likes this.
  17. uDamian

    uDamian

    Unity Technologies

    Joined:
    Dec 11, 2017
    Posts:
    1,231
    1.0.0-preview.12 - 2021-01-16

    Friendly reminder that for Unity 2021.x and onwards, UI Builder is built-in and no longer requires the installation of the package.
    Install the package only if you want to use the bleeding edge or you are on an older version of Unity.

    MINIMUM REQUIREMENTS:
    • 2019.4.17f1 or newer
    • 2020.1.17f1 or newer
    • 2020.2.1f1 or newer
    • 2021.1.0b1 or newer
    CHANGELOG:
    • Added support for renaming USS Selectors directly inside the StyleSheets pane via double-click or the right-click menu.
    • Added settings search support for UI Builder settings in the Project Settings window.
    • Fixed not being able to create a single-character selector.
    • Fixed exception thrown when selecting the currently open UXML asset in the Project Window.
    • Fixed non-whole pixel size and position values resulting from resizing or moving elements in the Viewport with the zoom set to 75%.
    • Fixed the InvalidCastException thrown when assigning a built-in image asset to a Texture2D in the UI Builder inspector.
    • Fixed float and double attributes not being stored correctly in UXML as CultureInvariant.
    • Fixed element highlight overlay not being reset after deleting the element.
    • Fixed clicking in empty space in Hierarchy pane not deselecting a USS Selector and vice-versa for the StyleSheets pane.
    • Fixed null reference exception when using the Align style properties on a USS Selector.
    • Fixed handling of a deleted StyleSheet that is being used by the currently open UXML UI Document.
    • Fixed being able to paste USS Selectors from the Hierarchy pane and elements from the StyleSheets pane. Paste now works based on which pane is currently active.
    • Fixed document settings (like Canvas background and zoom) being reset when editing a sub-document in-place.
     
  18. sebastiend-unity

    sebastiend-unity

    Unity Technologies

    Joined:
    Nov 9, 2015
    Posts:
    184
    1.0.0-preview.13 - 2021-03-17

    Friendly reminder that for Unity 2021.x and onwards, UI Builder is built-in and no longer requires the installation of the package.
    Install the package only if you want to use the bleeding edge or you are on an older version of Unity.

    MINIMUM REQUIREMENTS:
    • 2019.4.17f1 or newer
    • 2020.1.17f1 or newer
    • 2020.2.1f1 or newer
    • 2020.3.1f1 or newer
    • 2021.1.0b1 or newer
    CHANGELOG:
    • Fixed compiler issues on 2020LTS and other possible editor-package combinations.
    • Fixed assembly build order when UI Toolkit package is present.
    • (2020.2+) Fixed Rich Text controls availability when Text Core package is installed.
    Note: The change to README.md was omitted in the 1.0.0-preview.13 release; more specifically, the mention to 2020.3.1f1 (aka 2020 LTS) or newer is missing from the file. The package is, however, compatible with that version.
     
    Filip8429, ModLunar and makaka-org like this.
  19. sebastiend-unity

    sebastiend-unity

    Unity Technologies

    Joined:
    Nov 9, 2015
    Posts:
    184
    1.0.0-preview.14 - 2021-03-30

    Friendly reminder that for Unity 2021.x and onwards, UI Builder is built-in and no longer requires the installation of the package.
    Install the package only if you want to use the bleeding edge or you are on an older version of Unity.

    MINIMUM REQUIREMENTS:
    • 2019.4.17f1 or newer
    • 2020.1.17f1 or newer
    • 2020.2.1f1 or newer
    • 2020.3.1f1 or newer
    • 2021.1.0f1 or newer
    CHANGELOG:
    • Fixed compiler issues on 2021.1f1 with the UI Builder package when UI Toolkit package is NOT installed.
    Note: This specific UI Builder release is aimed at users who are:
    • Running Unity 2021.1
    • Not using the UI Toolkit package
    • Using the UI Builder as a package
    For most users, this release does not bring anything new. While the above setup is not necessary or even suggested, it is not prohibited. The release is a patch for users who would still want to use Unity 2021.1 with the default version of the UI Toolkit (editor support only) and the latest UI Builder package. As a general rule however, users will want to either (1) use the default, no package installation or (2) use both packages at the same time.
     
    Filip8429, SudoCat and makaka-org like this.
  20. sebastiend-unity

    sebastiend-unity

    Unity Technologies

    Joined:
    Nov 9, 2015
    Posts:
    184
    1.0.0-preview.15 - 2021-08-05

    Friendly reminder that for Unity 2021.x and onwards, UI Builder is built-in and no longer requires the installation of the package. Install the package only if you want to use the bleeding edge or you are on an older version of Unity.

    MINIMUM REQUIREMENTS:
    • 2019.4: 2019.4.27f1 or newer
    • 2020.3: 2020.3.12f1 or newer
    • 2021.1: 2021.1.16f1 or newer
    • 2021.2: 2021.2.0b5 or newer
    • 2022.1: 2022.1.0a2 or newer
    CHANGELOG:
    • Fixed many issues that span across various editor versions (2019.4 through latest 2021.2 beta)
    • Added support for the UI Toolkit 1.0.0-preview.15 package
    • The following compatibility matrix can be used to find out if/when you can use this package:
    Code (csharp):
    1.  Editor version | Builder version        | UI Toolkit version
    2. ----------------+------------------------+-----------------------------
    3.  2019.4/LTS     | pkg (1.0.0-preview.15) | built-in (editor only)
    4.  2020.3/LTS     | pkg (1.0.0-preview.15) | built-in (editor only)
    5.  2020.3/LTS     | pkg (1.0.0-preview.15) | pkg (1.0.0-preview.15)
    6.  2021.1         | pkg (1.0.0-preview.15) | built-in
    7.  2021.1         | pkg (1.0.0-preview.15) | pkg (1.0.0-preview.15)
    8.  2021.2 beta+   | pkg (1.0.0-preview.15) | built-in (editor & runtime)
    9.  2022.1 alpha+  | pkg (1.0.0-preview.15) | built-in (editor & runtime)
    Note that this UI Builder package (com.unity.ui.builder 1.0.0-preview.15) is only compatible with the UI Toolkit package of the same version number (com.unity.ui 1.0.0-preview.15). Any other combination is not supported.
     
    makaka-org likes this.
  21. sebastiend-unity

    sebastiend-unity

    Unity Technologies

    Joined:
    Nov 9, 2015
    Posts:
    184
    1.0.0-preview.16 - 2021-08-12

    Friendly reminder that for Unity 2021.x and onwards, UI Builder is built-in and no longer requires the installation of the package. Install the package only if you want to use the bleeding edge or you are on an older version of Unity.

    MINIMUM REQUIREMENTS:
    • 2019.4: 2019.4.27f1 or newer
    • 2020.3: 2020.3.12f1 or newer
    • 2021.1: 2021.1.16f1 or newer
    • 2021.2: 2021.2.0b5 or newer
    • 2022.1: 2022.1.0a2 or newer

    CHANGELOG:
    • Fixed GUID errors with UI Builder preview-15
    • Fixed System.ArgumentException: A factory for the type Unity.UI.Builder.BuilderPane+UxmlFactory
    • The following compatibility matrix can be used to find out if/when you can use this package:
    Code (CSharp):
    1.  Editor version | Builder version        | UI Toolkit version
    2. ----------------+------------------------+-----------------------------
    3. 2019.4/LTS     | pkg (1.0.0-preview.16) | built-in (editor only)
    4. 2020.3/LTS     | pkg (1.0.0-preview.16) | built-in (editor only)
    5. 2020.3/LTS     | pkg (1.0.0-preview.16) | pkg (1.0.0-preview.16)
    6. 2021.1         | pkg (1.0.0-preview.16) | built-in
    7. 2021.1         | pkg (1.0.0-preview.16) | pkg (1.0.0-preview.16)
    8. 2021.2 beta+   | pkg (1.0.0-preview.16) | built-in (editor & runtime)
    9. 2022.1 alpha+  | pkg (1.0.0-preview.16) | built-in (editor & runtime)
    Note that this UI Builder package (com.unity.ui.builder 1.0.0-preview.16) is compatible with the UI Toolkit package of version number 1.0.0-preview.15+, but we recommend to use the UI Toolkit package of the same version number (com.unity.ui 1.0.0-preview.16)
     
    makaka-org likes this.
  22. sebastiend-unity

    sebastiend-unity

    Unity Technologies

    Joined:
    Nov 9, 2015
    Posts:
    184
    1.0.0-preview.17 - 2021-09-01

    Friendly reminder that for Unity 2021.x and onwards, UI Builder is built-in and no longer requires the installation of the package. Install the package only if you want to use the bleeding edge or you are on an older version of Unity.

    MINIMUM REQUIREMENTS:
    • 2019.4: 2019.4.27f1 or newer
    • 2020.3: 2020.3.12f1 or newer
    • 2021.1: 2021.1.16f1 or newer
    • 2021.2: 2021.2.0b5 or newer
    • 2022.1: 2022.1.0a2 or newer

    CHANGELOG:
    • Fixed: The UI Builder's Attributes section was empty for editor versions 21.1 and earlier (this was an oversight and unfortunately got through 1.0.0-preview.15)
    • Fixed: The package.json was not allowing latest package installs on 2019.4 from the Package Manager
    • Fixed: The 'src' attribute was missing in Template UXML tag for 21.1 and earlier
    • Fixed: The active theme was not applied to the document when a USS is added to the document (case 1358872)
    • Fixed: Ensure that only modified files are saved to disk
    • Fixed: No longer display '*' characters next to filename in the Hierarchy and StyleSheet panes (case 1355591).
    • The following compatibility matrix can be used to find out if/when you can use this package:
    Code (CSharp):
    1.  Editor version | Builder version        | UI Toolkit version
    2. ----------------+------------------------+-----------------------------
    3. 2019.4/LTS      | pkg (1.0.0-preview.17) | built-in (editor only)
    4. 2020.3/LTS      | pkg (1.0.0-preview.17) | built-in (editor only)
    5. 2020.3/LTS      | pkg (1.0.0-preview.17) | pkg (1.0.0-preview.17)
    6. 2021.1          | pkg (1.0.0-preview.17) | built-in
    7. 2021.1          | pkg (1.0.0-preview.17) | pkg (1.0.0-preview.17)
    8. 2021.2 beta+    | pkg (1.0.0-preview.17) | built-in (editor & runtime)
    9. 2022.1 alpha+   | pkg (1.0.0-preview.17) | built-in (editor & runtime)
    Note that this UI Builder package (com.unity.ui.builder 1.0.0-preview.17) is compatible with the UI Toolkit package of version number 1.0.0-preview.17.
     
    makaka-org and JG-Denver like this.
  23. sebastiend-unity

    sebastiend-unity

    Unity Technologies

    Joined:
    Nov 9, 2015
    Posts:
    184
    1.0.0-preview.18 - 2021-09-29

    Friendly reminder that for Unity 2021.x and onwards, UI Builder is built-in and no longer requires the installation of the package. Install the package only if you want to use the bleeding edge or you are on an older version of Unity.

    MINIMUM REQUIREMENTS:
    • 2019.4: 2019.4.29f1 or newer
    • 2020.3: 2020.3.15f2 or newer
    • 2021.1: 2021.1.16f1 or newer
    • 2021.2: 2021.2.0b7 or newer
    • 2022.1: 2022.1.0a2 or newer
    CHANGELOG:
    • Backported fix for: [UI Builder] Text Shadow Color resets to clear after reopening the project
    • Backported fix for: ArgumentException: Unhandled type ScalaleImage” error is thrown when Dropdown Element’s VisualElement is selected
    • The following compatibility matrix can be used to find out if/when you can use this package:
    Code (CSharp):
    1.  Editor version | Builder version        | UI Toolkit version
    2. ----------------+------------------------+-----------------------------
    3. 2019.4/LTS      | pkg (1.0.0-preview.17) | built-in (editor only)
    4. 2020.3/LTS      | pkg (1.0.0-preview.17) | built-in (editor only)
    5. 2020.3/LTS      | pkg (1.0.0-preview.17) | pkg (1.0.0-preview.17)
    6. 2021.1          | pkg (1.0.0-preview.17) | built-in
    7. 2021.1          | pkg (1.0.0-preview.17) | pkg (1.0.0-preview.17)
    8. 2021.2 beta+    | pkg (1.0.0-preview.17) | built-in (editor & runtime)
    9. 2022.1 alpha+   | pkg (1.0.0-preview.17) | built-in (editor & runtime)
    Note that this UI Builder package (com.unity.ui.builder 1.0.0-preview.18) is compatible with the UI Toolkit package of version number 1.0.0-preview.18.
     
    makaka-org likes this.
Thread Status:
Not open for further replies.