テキスト領域ウィジェットを使用することで、マッシュアップユーザーがマッシュアップに複数行のテキストを入力できるようになります。

テキスト領域ウィジェットのサイズは、ThingWorx のバージョンによって異なります。

ThingWorx 9.3.2 以降に移行すると、コンテナ内の 1 つのウィジェットとして表示されるテキスト領域ウィジェットがコンテナ内の使用可能なスペース全体に拡張されます。この変更は、マッシュアップのレイアウトに影響を与える可能性があります。レイアウトを更新するには、マッシュアップのレイアウトを調整してください。詳細については、以下のセクションを参照してください。

デフォルトでは、テキスト領域はデフォルトの幅と高さの寸法を使用して表示されます。幅は固定値に設定されています。高さは Autosize に設定されており、ウィジェットは縦方向に拡張されます。入力時、テキストが使用可能なスペースを超えると、ウィジェットは拡張され、MaxNumberOfCharacters プロパティで定義されている値に達するまで追加の文字を表示します。「レイアウト」パネルの整列オプションと配分オプションを使用して、追加のウィジェットを追加し、レイアウトを制御できます。次の図は、マッシュアップレイアウトのウィジェットを示しています。

レイアウトは次のように分割されています。

ウィジェットの幅は固定値に設定されています。高さは Autosize に設定されており、文字数が使用可能なスペースより多い場合、ウィジェットは縦方向に展開されます。Width および Height プロパティを使用して、ウィジェットのサイズを調整できます。省略記号が表示されます。

新規または既存のマッシュアップにウィジェットを追加するとき、そのコンテナのサイズに従ってそのデフォルトの寸法が設定されます。ウィジェットは、コンテナ内の使用可能なスペース全体に自動的に拡張されます。レイアウトを基準にしてウィジェットの寸法を調整するには、Layout パネルを使用してコンテナレイアウトを設定しなければなりません。コンテナでウィジェットが展開されているとき、Width および Height プロパティは「プロパティ」パネルにリストされません。テキスト領域コンテナにウィジェットを追加すると、以前のサイズが復元されます。次の図は、バージョン9.3.2 以降の ThingWorx プラットフォームのレスポンシブコンテナ内のウィジェットを示しています。

レイアウトは次のように分割されています。

別のコンテナを使用してウィジェットを表示することで、よりレスポンシブなレイアウトを作成できます。次のイメージは、マッシュアップに使用できるスペースが多い場合の前のフォームを示しています。テキスト領域はそのコンテナとともに拡張され、テキストフィールドは同じサイズのままです。

テキスト領域ウィジェットのプロパティを以下に示します。

共通の検証プロパティに加えて、プロパティ MaxLength および MinLength を使用して、テキスト領域ウィジェット内の文字数を検証できます。

プロパティ MaxLengthFailureMessage および MinLengthFailureMessage を使用して、デフォルトの失敗メッセージをカスタマイズできます。パラメータ ${value} を使用して最大値と最小値がメッセージ内に表示されます。

共通の検証プロパティの使用の詳細については、ウィジェットへの検証の適用を参照してください。

次の表に、「検証」パネルで使用可能な検証プロパティを示します。