テーマスタイルシート (Theme Style Sheet、TSS) ファイルは通常の USS ファイルです。UI Toolkit は TSS を別のアセットタイプとして扱い、管理の目的で使用します。
TSS ファイルには通常の USS 構文と形式が適用されますが、通常、テーマファイルには @import
規則を通じて他の USS ファイルへの参照が含まれます。
ノート: USS ファイルは @import
規則もサポートしています。
You can create different TSS files for different themes and switch between them at runtime. Typically, you should use USS for styles. Consider TSS when you customize the look and feel for different platforms or devices, or when you use different fonts for different languages if your games or applications support multiple languages.
Note: When you add your first UIDocument to a GameObject in your project, it generates a default runtime theme asset at Assets/UI Toolkit/UnityThemes/UnityDefaultTheme.tss
. Although you can create a TSS from scratch, to get all the default UI controls to work, you must import the default runtime theme, and then overwrite or add new styles to create your custom theme.
新しい TSS の作成は、以下のように行います。
Create one or more USS files with your custom styles.
以下のいずれかを行ってください。
Import your style USS files to your theme.
Your custom theme also appears in the theme list of the Viewport in UI Builder. To preview your theme, select it from the Viewport.
USS と同じように、UXML で TSS を参照する または C# で TSS を参照する ことができます。
Panel Setting アセットのデフォルトテーマとして TSS を設定することもできます。複数のパネル設定がある場合、それぞれ異なる TSS ファイルを使用できます。
Note: If you set a TSS for a Panel Setting asset, it doesn’t make the TSS a global style for the whole project. You still need to reference the TSS in UXML or C#.
You can use the TSS asset’s Inspector window or the @import
rule to import a theme.
Note: If you define the USS variables or styles in both the current TSS and the imported style sheet, the current TSS overrides the imported style sheet.
@import
ruleTo import the default Unity runtime theme, you must use the following syntax:
@import url("unity-theme://default");
Note: This URL in this syntax is a special case and it refers the built-in default theme inside the engine. You can’t use this syntax for any other themes.
@import
ruleTo import a theme other than the default theme, or a USS file, use the following syntax:
@import url("<path-to-file>/<file-name-with-extension>");
You can use a relative or an absolute path:
Assets
folder and begin with a /
or project://database/
. For example, /Assets/myFolder/myFile.uss
or project://database/Assets/myFolder/myFile.uss
./
. For example, ../myFolder/myFile.uss
.Note: To reference a file from packages, use the absolute path of the package file that starts from the Packages
folder. For example, /Packages/com.unity.package.name/file-name.uss
or project://database/Packages/com.unity.package.name/file-name.uss
. you must use the format of com.unity.package.name
rather than package name
for the package name.
Did you find this page useful? Please give it a rating:
Thanks for rating this page!
What kind of problem would you like to report?
Thanks for letting us know! This page has been marked for review based on your feedback.
If you have time, you can provide more information to help us fix the problem faster.
Provide more information
You've told us this page needs code samples. If you'd like to help us further, you could provide a code sample, or tell us about what kind of code sample you'd like to see:
You've told us there are code samples on this page which don't work. If you know how to fix it, or have something better we could use instead, please let us know:
You've told us there is information missing from this page. Please tell us more about what's missing:
You've told us there is incorrect information on this page. If you know what we should change to make it correct, please tell us:
You've told us this page has unclear or confusing information. Please tell us more about what you found unclear or confusing, or let us know how we could make it clearer:
You've told us there is a spelling or grammar error on this page. Please tell us what's wrong:
You've told us this page has a problem. Please tell us more about what's wrong:
Thank you for helping to make the Unity documentation better!
Your feedback has been submitted as a ticket for our documentation team to review.
We are not able to reply to every ticket submitted.