メインコンテンツまでスキップ

入力欄

YauiInputField は編集可能なテキストです。テキストを YauiText に、キャレットと選択範囲と一緒に表示し、次の機能に対応しています。

  • クリップボードを含むキーボードでの編集
  • IME の変換
  • モバイルプラットフォームのオンスクリーンキーボード

入力欄を選択すると編集が始まります。Enter (1 行の入力欄の場合)、Escape、または選択の解除で編集が終わります。

セットアップ​

InputField        YauiElement (the frame), YauiInputField
└─ TextArea       YauiElement (ClipChildren)
   ├─ Placeholder YauiText
   └─ Text        YauiText (the TextComponent)

入力欄は、キャレットと選択範囲をテキストの隣 (その親の中) に要素として作成します (保存はされません)。長いテキストがその中でスクロールするように、その親で子をクリップしてください (ClipChildren)。

プロパティ​

メンバー説明
Textテキスト。SetTextWithoutNotify は OnValueChanged を呼び出さずに変更します。
TextComponentテキストを表示する YauiText
Placeholderテキストが空の間に表示されます (不透明度は入力欄が操作します)
CharacterLimit最大の文字数。0 なら制限なし
LineTypeSingleLine、MultiLineSubmit (折り返し、Enter でサブミット)、MultiLineNewline (折り返し、Enter で改行)
ContentTypeStandard、IntegerNumber、DecimalNumber、Alphanumeric、Password (アスタリスクで表示し、コピーされない)
KeyboardTypeオンスクリーンキーボードの種類
ReadOnlyテキストを選択できるが変更できないかどうか
SelectAllOnFocus編集の開始時にテキスト全体を選択するかどうか
CaretColor, CaretWidth, CaretBlinkRate, SelectionColorキャレットと選択範囲の見た目

イベント​

イベント呼び出されるとき
OnValueChangedテキストが変わったとき
OnEndEdit編集が終わったとき
OnSubmitTextEnter (またはオンスクリーンキーボードの完了) で編集が終わったとき

スクリプティング​

メンバー説明
ActivateInputField(), DeactivateInputField()編集を開始・終了します
IsFocused編集中かどうか
CaretPosition, SelectionAnchorキャレットと、選択範囲のもう一方の端。文字のインデックスです
SelectAll(), SelectedTextテキスト全体を選択します。選択中のテキスト
注記

キャレットの位置は ATG のテキスト選択サービスから得ます。それがない場合でもテキストは編集できますが、キャレットは表示されません。