ウィジェットの操作 > 2D > ラベル
  
ラベル
このウィジェットの機能
「ラベル」ウィジェットは、テキストの整列方法やスタイルの適用方法に応じて、フォームラベルと同様に使用することも、領域ヘッダーとして使用することもできます。
このウィジェットを使用するケース
エクスペリエンス内にテキストを含める場合は、ラベルを使用します。「ラベル」ウィジェットは、1 語や 2 語のシンプルなラベルで使用することも、大量のテキストで使用することもできます。
このウィジェット固有のプロパティ、サービス、イベント、操作
一般的なウィジェットのプロパティ、サービス、イベントのリストについては、共通のウィジェットプロパティ、サービス、イベントを参照してください。
次の表に、このウィジェット固有のプロパティ、サービス、イベントを示します。
プロパティ
JavaScript
タイプ
説明
状態ベースのフォーマットを有効化
enableStateFormatting
boolean
ThingWorx で設定されている状態定義に基づいて、ウィジェットのフォーマットを設定することができます。
このチェックボックスをオンにすると、次のプロパティが表示されます。
依存フィールド
状態定義
たとえば、ラベルの「状態定義」の値が「error」になっている場合、そのラベルの色が赤になります。
ThingWorx のスタイル定義と状態定義の詳細については、ThingWorx ヘルプセンターでスタイルと状態の定義を参照してください。
依存フィールド
* 
「状態ベースのフォーマットを有効化」が有効になっている場合に表示されます。
stateFormatValue
string
このプロパティは、「状態ベースのフォーマットを有効化」チェックボックスがオンになっている場合に表示されます。ThingWorx のスタイル定義と状態定義の詳細については、ThingWorx ヘルプセンターでスタイルと状態の定義を参照してください。
状態定義
* 
「状態ベースのフォーマットを有効化」が有効になっている場合に表示されます。
stateFormat
boolean
このプロパティは、「状態ベースのフォーマットを有効化」チェックボックスがオンになっている場合に表示されます。ThingWorx のスタイル定義と状態定義の詳細については、ThingWorx ヘルプセンターでスタイルと状態の定義を参照してください。
ラベルテキストを折り返し
wrap
boolean
このチェックボックスをオンにすると、ラベルテキストを折り返しできます。
動作中のウィジェット
ウィジェットがどのように表示されるか、以下に例を示します。
使用時に必要な最小ステップ
外観
1. 「ラベル」ウィジェットをキャンバス上にドラッグアンドドロップします。この例では、「グリッドレイアウト」ウィジェットのセル内にラベルを配置します。
2. 「テキスト」フィールドに、表示するテキストを入力します。
* 
ラベルのスタイルを設定するには、エクスペリエンスに以下の項目を追加します。
「プロジェクト」枠の「スタイル」 > 「アプリケーション」 -
.my-label {
font-family: Century Gothic;
font-color: black;
font-size: 12pt;
font-weight: normal;
font-style: normal;
}
各ラベルの「クラス」フィールド - my-label
CSS でのウィジェットのスタイル設定
CSS を使用して、ウィジェットのスタイルを設定できます。作成および適用できる CSS クラスの例を次に示します。
* 
クラスに一意の名前を付けて、別のクラスや OOTB プロパティと競合しないようにすることをお勧めします。
CSS の例
外観
.ptc-label {
font-size: 16px;
font-family: Century Gothic;
font-weight: bold;
color: Red;
};
CSS クラスの実装の詳細については、アプリケーションのスタイルを参照してください。