マスク付きテキスト

ユーザーは、指定されたフォーマットに準拠しなければならないテキストを入力する必要があります。 例えば、郵便番号やクレジット・カード番号などです。

このビューをストリング変数にバインドできます。 また、動作構成プロパティーと外観構成プロパティーを定義することもできます。

構成プロパティー

「構成」で、ビューの外観および動作プロパティーを設定または変更します。

画面サイズ
プロパティー名の横に画面サイズ・アイコン 画面サイズ・アイコン がある構成プロパティーは、画面サイズごとに異なる値を持つことができます。 値を設定しない場合、画面サイズはそのデフォルト値として次に大きい画面サイズの値を継承します。
テーマ定義
テーマ定義は、ビューの色およびスタイルを指定し、その外観を決定します。 ビューのルック・アンド・フィールをテーマ・エディターでプレビューできます。 テーマを参照してください。
以下の表に、マスク付きテキスト・ビューの外観構成プロパティーを示します。
表 1. マスク付きテキストの外観構成プロパティー
外観構成プロパティー 説明 データ・タイプ
モノスペース テキストの入力中にマスクが動かないようにします。 Boolean
幅 画面サイズ・アイコン ビューの幅です。 幅の単位は px (ピクセル)、% (パーセント)、または em で指定できます。 例えば、50px、20%、または 0.4em のようにします。 単位タイプが指定されていない場合は、px と見なされます。 String
サイズ・スタイル 画面サイズ・アイコン マスク付きテキストのサイズを指定します。 String
ラベルの配置 大画面アイコン 格納されたテキストを基準としたラベルの配置を指定します (「上部」または「左」)。

デフォルトのラベルの配置は上部です。

 String
ラベルの幅 大画面アイコン ラベルの幅です。 幅の単位は px (ピクセル)、% (パーセント)、または em で指定できます。 例えば、50px、20%、または 0.4em のようにします。 単位タイプが指定されていない場合は、px と見なされます。 String
以下の表に、マスク付きテキスト・ビューの動作構成プロパティーをリストします。
表 2. マスク付きテキストの動作構成プロパティー
動作構成プロパティー 説明 データ・タイプ
タブ・インデックス フィールドを介したタブ・シーケンスのインデックスを定義します。 タブ・インデックスは 1 から始まります。 これらの値は、1、5、10など、不連続に追加できます。 Integer
プレースホルダーのテキスト 値が入力されなかった場合に表示するプレースホルダー・テキストを指定します。 多くの場合、このプレースホルダー・テキストはマスク・テキストと同じです。 String
マスク 入力できる文字のタイプを示すために、数字の場合は # 記号、アルファベット文字の場合は a の文字を使用します。
ヒント: 疑問符 (?) は予約文字であり、疑問符 (?) の後の文字はオプションです。
 String
無効テキストの自動クリア 無効なテキストを自動的に削除するには、このオプションを選択します。 Boolean

数値のマスク付きテキスト・ビューの例

電話番号のビューを作成するには、構成プロパティーを以下のように設定します。
  1. 「構成」 ウィンドウの 「外観」 部分で、 「幅」 を 200 px に、 「サイズ・スタイル」 を 「大」に、 「ラベルの配置」 を 「上部」に設定します。
  2. 「動作」部分で、「プレースホルダー・テキスト」を、ロケーションのダイヤル規則に準拠した偽の電話番号 (例えば、(555) 555 - 5555) に設定し、「マスク」フィールドに、同じパターンで # 文字のストリング (例えば、(###) ### - ####) を入力します。

    その他のオプションはブランクのままにします。

アルファベット文字のマスク付きテキスト・ビューの例

状態値のビューを作成するには、構成プロパティーを以下のように設定します。
  1. 「構成」 ウィンドウの 「外観」 部分で、 「幅」 を 200 px に、 「サイズ・スタイル」 を 「大」に、 「ラベルの配置」 を 「上部」に設定します。
  2. 「動作」 部分で、 「プレースホルダー・テキスト」 を State に設定し、 「マスク」 フィールドに aaと入力します。

    その他のオプションはブランクのままにします。

イベント

「イベント」タブでビューのイベント・ハンドラーの設定や変更を行います。 イベントをプログラムでトリガーするかユーザーがビューと対話したときにトリガーするように設定できます。 イベントを定義およびコーディングする方法については、 ユーザー定義イベントを参照してください。
マスク付きテキスト・ビューでは、以下のタイプのイベント・ハンドラーをアクティブ化できます。
  • ページがロードされたときの On load (例: me.setMask(${CountryCodeData}.getValue() == "uk" ? "(###) ####-####" : (###) ###-####) )
  • ビュー内のデータが変更されたときの On change (例: me.setValid(@validNumber(newText),"Please enter a valid phone number") )
  • ビューにフォーカスが移動したときの On focus (例: me.setSizeStyle("L") )
  • On blur ユーザーがビューをクリックしたとき、またはビューからタブで移動したとき (例: me.setSizeStyle("D") )
  • ユーザーがビューにデータを入力したときの On input (例: return potential.substr(0,3) != "555" )

方法

使用可能なメソッドについて詳しくは、 マスク・テキスト JavaScript API を参照してください。

その他のリソース

Coach またはページの作成方法については、 Coach の作成を参照してください。
標準プロパティー (「一般」、 「構成」、 「位置決め」、 「可視性」、および 「HTML 属性」) について詳しくは、 「プロパティーの表示」を参照してください。