Name セレクター

USS Name セレクターは、名前に基づいて要素を特定します。USS Name セレクターは、特定の id 属性を持つ要素を特定する CSS ID セレクターに類似しています。

要素の名前を設定するには、次の手順に従います。

• C# スクリプトでは、VisualElement.name を使用します。
• UXML では、name 属性を使用します。例えば <VisualElement name="my-nameName"> です。

予期しない特定を避けるために、パネル内で一意の名前を要素に付けてください。

構文

Name セレクターは、要素に割り当てられた名前の前に番号記号 (#) を付けたものです。

#ElementName { ... }

ノート: 番号記号 (#) は、USS ファイルでセレクターを記述するときのみ使用します。UXML や C# ファイルで要素に名前を割り当てるときには使わないでください。番号記号を含む要素名は無効です。例えば、<Button name="#OK" /> は無効です。

例

単純セレクターによる要素の照合方法を示すために、UI Document の例を紹介します。

<UXML xmlns="UnityEngine.UIElements">
  <VisualElement name="container1">
    <VisualElement name="container2" class="yellow">
      <Button name="OK" class="yellow" text="OK" />
      <Button name="Cancel" text="Cancel" />
    </VisualElement>
  </VisualElement>
</UXML>

スタイルを適用しない場合、UI は以下のようになります。

以下の Name セレクターのスタイルルールは、2 つ目の Button 要素に適用されます。

#Cancel {
    border-width: 2px;
    border-color: DarkRed;
    background-color: pink;
}

このスタイルを適用する UI は以下のようになります。

追加リソース

• USS のベストプラクティス