Version: 2023.2
言語: 日本語
Bind custom controls to data
要素管理のベストプラクティス

Define a namespace prefix

After you have defined a custom control element, you can use it in your UXML files. To categorize elements, create the class in a namespace. When you define a new namespace, you can define a prefix for the namespace. You must define namespace prefixes as attributes of the root <UXML> element and replace the full namespace name when scoping elements.

名前空間プレフィックスを定義するには、それぞれの名前空間プレフィックスのアセンブリに 例えば以下のような UxmlNamespacePrefix 属性を加えます。

[assembly:UxmlNamespacePrefix( "My.First.Namespace"、 "first")]
[assembly:UxmlNamespacePrefix( "My.Second.Namespace"、 "second")]

これは、アセンブリの C# ファイルのルートレベル (任意の名前空間の外側) で行います。

スキーマ生成システムは以下を行います。

  • これらの属性を確認し、それらを使用してスキーマを生成します。
  • 新しく作成された UXML ファイルの <UXML> 要素の属性として名前空間プレフィックスの定義を加えます。
  • xsi:schemaLocation 属性に名前空間のスキーマファイルの場所を含めます。

テキストエディターで新しい要素を確実に認識するには、Assets > Update UXML Schema を選択してスキーマ定義を更新します。

接頭辞付きの新しい UXML ドキュメントを作成するには、Assets > Create > UI Toolkit > UI Document を選択します。

その他の参考資料

Bind custom controls to data
要素管理のベストプラクティス