|
Window Framework v1.2.4
Window Framework for Unity UI Toolkit
|
The Panel settings asset is a required item that setup links to default stylesheets along with many other settings.
See the Panel Settings Asset section lower in the page
The source asset for the WIndowFramework is simply a blank UXML document that serves as a root for the display. We have included one for you but any blank document will work.
When using multiple layers (panels) then you may have to adjust this setting to get the render order correct. Higher numbers are rendered in front.
The controller will attempt to find the attached UI document component as it is a required component, however it is also available here for manual assignment in case you have issues with scene changes.
When checked this option will Enable tooltips for window frame elements, including content. Tooltips will be auto assigned, all you have to do is specify some text in the element tooltip filed and the system will do the rest.
Tooltips are auto applied on creation but must be applied to instatiated content with WindowFrameController.Instance.ApplyTooltips(doc_root);
When checked this option will Enable window and settings memory.
Individual windows will still need to be set with WindowMemoryEnabled=true and must be a dedicated type.
Filename for the settings memory, stored in the projects persistent data folder.
The default stylesheet is used when no theme data is available, that is the only time that this file is every called and can safely be ignored, however it is useful in dev builds that have changing file structures as you can make an error theme to offer quick obvious feedback on any problems. This is also a perfectly viable choice for a single theme project and can be a assigned to a Theme Stylesheet or Standard Stylesheet.
This is a perfectly viable choice for a single theme project and can be a assigned to a Theme Stylesheet or Standard Stylesheet.
The Global Stylesheet can also be a Stylesheet (USS) OR a Unity Theme Stylesheet (TSS) asset, all Global stylesheets / theme files should be kept in a Resources folder, our default recommended location is Assets/Resources/[Your-Project-Name]/Themes/Global but any resources that fits your project structure will work.
This recommended theme folder is also where we sugest you save any custom themes you make so that asset updates do not effect your project.
This setting allows you to set a shared ThemeStylesheet or standard Stylesheet to load first or last.
In the USS system applies in a cascading format, this means that the order in which you load your files matter.
Theme data is stored as a serializable scriptable object so everything is placed into your build. The currently active theme is handled by the memory system allowing reset to the default theme at any time.
And some small print.
Themes can be applied to Windows, The Panel assigned to the controller, or All active panels in the scene. When the system applies the style sheets from the theme it removes the sheets related to the previous theme.
This means that you can add additional stylesheets without the Window Framework Theme System effecting them.
The Runtime Theme needs to be attached here so that the base style commands for the Window Framework can be loaded. If you have an existing project with existing runtime theme you can just attach the WindowFramework Default Styling and Default Theme Settings to your existing runtime theme similar to ours as shown in the image below