UXML インスタンスをテンプレートとして使用する

****Unity でのプレハブの機能と同様に、既存の UXML ドキュメントを UXML ドキュメント内でテンプレートインスタンスとしてインスタンス化することができます。

UXML ドキュメントをテンプレートとして使用する

プロジェクト内の既存の UXML ドキュメントをテンプレートとして使用するには、以下を行います。

Library の Project タブで、インスタンス化したい UXML アセット (.uxml) を見つけます。
Library 内の要素のように、Hierarchy 内にドラッグします。

テンプレートインスタンスは TemplateContainer タイプの通常の要素のように Hierarchy に表示されます。.uxml ファイル名は、右側にグレイアウトの状態で表示されます。テンプレートインスタンスを展開すると、インスタンスの内部階層を見ることができます。この内部階層は、要素を使うで説明したように、読み取り専用で、参照用です。

テンプレートとしてサブドキュメントを作成する

UXML ドキュメント内に、テンプレートインスタンスとしてサブドキュメントを作ることができ、それを再利用できます。

サブドキュメントを右クリックします。
Create Template を選択します。
ファイルの保存場所を選択します。

これはまた、サブドキュメントを既存のドキュメント内のテンプレートインスタンスとしてインスタンス化します。

UXML ドキュメントテンプレートのインスタンスを編集する

テンプレートインスタンスとして使用される元の UXML ドキュメントを編集するには、テンプレートインスタンスを右クリックし、以下のオプションのいずれかを選択します。

Open in UI Builder: 現在の UXML ドキュメントをアンロードし、テンプレートインスタンスをロードします。

UI Builder で開く例
Open Instance in Isolation: テンプレートインスタンスをロードしている間、現在の UXML ドキュメントをバックグラウンドでロードしたままにします。Hierarchy と Canvas にはテンプレートインスタンスのコンテンツのみが表示され、StyleSheets ペインには背景の親 UXML ドキュメントのスタイルシートが読み取り専用で表示されます。これは、スタイルシートがまだテンプレートインスタンスに適用されているためです。

分離してインスタンスを開く例
Open Instance in Context: 現在の UXML ドキュメントをロードしたまま、そのすべての要素を読み取り専用にし、Hierarchy と Canvas にグレーアウトした状態で表示します。親 UXML ドキュメントのコンテキスト内でテンプレートインスタンスのコンテンツを編集できます。このオプションを使用すると、ホストドキュメントのコンテキストを失うことなく、テンプレートインスタンスのコンテンツを更新することができます。

コンテキストでインスタンスを開く例
Show in Project: Project ウィンドウにテンプレートインスタンスファイルの場所を表示します。