テキストフィールド

テキストフィールドは文字列を入力するコンポーネントです。

プロパティ

No	項目	入力値	デフォルト値	アクションプロパティ	タイプ	アクションデフォルト値	説明
1	ID	文字列	自動設定	id	string	自動設定	[id]プロパティはアクションで設定はできません。
2	ラベル L	文字列	Text Field	label	string	Text Field	コンポーネントのラベル
3	幅	文字列	222	width	string	222	コンポーネントの幅
4	高さ	文字列	55	height	string	55	コンポーネントの高さ
5	X	文字列		x	string		X座標の位置
6	Y	文字列		y	string		Y座標の位置
7	位置固定	真偽	OFF	lock	boolean	false	ONの場合は画面をスクロールしてもコンポーネントが固定されて表示されます。 OFFの場合は画面をスクロールするとそれに合わせてコンポーネントも動きます。 v4.1.0で追加されたプロパティ
8	サイズ	選択 1.小 2.中 3.指定なし	指定なし	size	string	none	指定なし以外を選択した場合は高さは無効になります。 旧デザインがONの場合はサイズは無効になります。 v4.2.0で追加されたプロパティ
9	スタイル	選択 1.アウトライン 2.フィル 3.スタンダード	アウトライン	variant	string	outlined	コンポーネントのスタイル
10	旧デザイン	真偽	OFF				スタイルがスタンダードの場合のみ有効になります。 ONの場合は旧デザインで表示されます。 OFFの場合は新デザインで表示されます。 v4.1.0で追加されたプロパティ
11	色	文字列 カラーピッカー		color	string		コンポーネントの色
12	背景色	文字列 カラーピッカー		backgroundColor	string		背景色
13	ラベル色	文字列 カラーピッカー		labelColor	string		ラベルの文字色
14	入力文字色	文字列 カラーピッカー		inputColor	string		入力文字の色
15	非アクティブ	真偽	OFF	disabled	boolean	false	コンポーネントの無効/有効状態
16	読み取り専用	真偽	OFF	readOnly	boolean	false	読み取り専用モード
17	必須	真偽	OFF	required	boolean	false	必須入力項目の指定
18	表示	真偽	ON	visibility	boolean	true	コンポーネントの表示/非表示
19	入力位置	選択 1.左揃え 2.中央揃え 3.右揃え	左揃え	inputAlignment	string	left	入力文字の配置 v3.3.0で追加されたプロパティ
20	記号と単位の位置	選択 1.なし 2.先頭 3.末尾	なし	inputAdornmentsPosition	string	none	記号と単位の表示位置
21	記号と単位 L	文字列		inputAdornments	string		表示する記号と単位
22	入力タイプ	選択 1.任意 2.電話番号 3.E メール	任意	inputType	string	any	入力値の検証タイプ
23	国コード	選択	日本	countryCode	string	JA	電話番号の国コード
24	プレースホルダ L	文字列		placeholder	string		プレースホルダテキスト
25	ヘルパーテキスト L	文字列		helperText	string		ヘルパーテキスト
26	入力エラーメッセージ L	文字列	Your input is incomplete	inputErrorMessage	string		入力エラー時のメッセージ
27	値	文字列		value	string		テキストフィールドの値
28	チェンジイベント	選択 1.なし 2. UIスクリプト 3. アクション 4. 切り離されたアクション	なし				値変更時のイベント設定 切り離されたアクションはv4.1.0で選択可能になりました。 UIスクリプトはv4.2.0で選択可能になりました。
29	エラー			error	boolean	false	エラー状態
30	切り離されたアクション	選択 1.[切り離されたアクションのID]		detachedAction	string		切り離されたアクションを設定 v4.1.0で追加されたプロパティ
31	タブによるフォーカス	選択 1.[UIのID]		tabFocus	string		次フォーカスのコンポーネント指定 v3.3.0で追加されたプロパティ

ノート

• ^L：多言語対応プロパティとなります。
• 以下のプロパティはアクションからの多言語値の取得および設定は不可能となります。
  • 記号と単位
  • 入力エラーメッセージ
• [記号と単位の位置]の値が「なし (none)」の場合は、[記号と単位]の設定は無視されます。
• [幅]、[高さ]プロパティ値には下記を入力できます。 px 表示したい場合は数値のみ、%表示したい場合は単位に%を指定してください。
  下記以外を入力した場合の動作はサポート外になります。
  • 数値
  • 数値%
  • calc()関数
• [X]、[Y]プロパティ値には下記を入力できます。
  px 表示したい場合は数値のみを指定してください。
  下記以外を入力した場合の動作はサポート外になります。
  • 数値
  • calc()関数
• calc()関数は CSS の関数で、計算を可能にする関数です。（例：calc(100% - 30px)）
  calc()関数で使用できる単位は 「%」と 「px」です。それ以外の単位（例：em,rem など）はサポート外になります。
• calc()関数を用いてサイズを指定した際は、エディタ上の表示とアプリ上の見た目が異なることがあります。
  プレビューを用いてご確認ください。
• [サイズ]プロパティはアクションから以下の値を設定することが出来ます。
  • small
  • medium
  • none
• [入力エラーメッセージ]プロパティは、[入力タイプ]プロパティに[電話番号][Eメール]を指定した時に設定できるプロパティです。
• 動的コンポーネントとして定義する際に、[入力エラーメッセージ]プロパティは以下のように記述する必要があります。

new $comp.TextField({
  id: "text_field",
  width: 200,
  ...
  inputErrorMessage: "＜デフォルトで表示するメッセージ＞",
  inputErrorMessageLanguages: {
    en: "＜言語が英語の場合に表示するメッセージ＞",
    ja: "＜言語が日本語の場合に表示するメッセージ＞"
  }
})

• [入力タイプ]プロパティが[電話番号]または[Eメール]での入力チェックエラー時、[error]プロパティは true になります。
• [必須]プロパティを ON にした場合、ラベルの横に * マークが付きます。
  必須チェックは自動では行いませんので、アクションを定義してください。

イベント

イベント名	説明
onchange	値の変更が行われ、カーソルが外れた時に発生します。