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

既存の UXML ドキュメントを UXML ドキュメント内で テンプレートインスタンス としてインスタンス化することができます。

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

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

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

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

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

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

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

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

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

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

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

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

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

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