UXML から他のファイルを参照する

UXML ファイルでは、<Template> 要素と <Style> 要素を使用して、他の UXML ファイルまたは USS ファイルを参照できます。2 つの要素は両方とも、src 属性または path 属性のいずれかを受け入れます。

src 属性

src 属性には以下の構文を使用します。

src="<path-to-file>/<file-name-with-extension>"

ファイルの欠落など、インポート中のエラーはエラーメッセージをトリガーします。

相対パスまたは絶対パスを使用できます。

• 絶対パスは、プロジェクトの Assets フォルダーから開始し、先頭に / または project://database/ が付加されています。例えば /Assets/myFolder/myFile.uss または project://database/Assets/myFolder/myFile.uss です。
• 相対パスは現在のファイルから開始し、/ を除外します。例えば ../myFolder/myFile.uss です。

ノート: パッケージからファイルを参照するには、Packages フォルダーから始まるパッケージファイルの絶対パスを使用します。例えば、/Packages/com.unity.package.name/file-name.uss または project://database/Packages/com.unity.package.name/file-name.uss です。パッケージ名には package name 形式ではなく、com.unity.package.name 形式を使用する必要があります。

path 属性

path 属性は Unity Resources メカニズムを使用しますが、インポート時にエラーレポートを提示せず、相対パスを許可しません。

path 属性は、以下のルールに基づいて Resources フォルダーまたは Editor Default Resources フォルダーにあるファイルを受け入れます。

• ファイルが Resources フォルダーにある場合は、ファイル拡張子が付加されていません。例えば、Assets/Resources/template.uxml にあるファイルに path="template" を書き込みます。
• ファイルが Editor Default Resources フォルダーにある場合は、ファイル拡張子を付加する必要があります。例えば、Assets/Editor Default Resources/template.uxml にあるファイルに path="template.uxml" を書き込みます。

追加リソース

• UXML へのスタイルの追加
• UXML ファイルの再利用