Search Unity

  1. Unity 2020.1 has been released.
    Dismiss Notice
  2. Good news ✨ We have more Unite Now videos available for you to watch on-demand! Come check them out and ask our experts any questions!
    Dismiss Notice

Unity UI Builder - Latest Version: 1.0.0-preview.3

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:
    854
    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
  2. uDamian

    uDamian

    Unity Technologies

    Joined:
    Dec 11, 2017
    Posts:
    854
    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:
    854
    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:
    854
    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:
    854
    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:
    854
    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:
    854
    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:
    854
    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:
    854
    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.
     
Thread Status:
Not open for further replies.
unityunity