HarmonyOS プロジェクト ArkUI の TextInput 入力ボックス コンポーネント

HarmonyOS プロジェクト ArkUI の TextInput 入力ボックス コンポーネント

1. 動作環境

オペレーティング システム: Windows 10 プロフェッショナル

IDE:DevEco スタジオ 3.1

SDK:HarmonyOS 3.1

二、TextInput

インターフェース

TextInput(値?:{プレースホルダー?: ResourceStr, テキスト?: ResourceStr, コントローラー?: TextInputController})

パラメータ:

パラメータ名	パラメータの種類	必須	パラメータの説明
プレースホルダー	リソース文字列	いいえ	入力がない場合のプロンプトテキスト。
文章	リソース文字列	いいえ	入力ボックスの現在のテキストの内容を設定します。
コントローラ	テキスト入力コントローラー	いいえ	カーソル コントローラー。カーソルの下付き文字の位置を設定します。

例：

TextInput({
          placeholder: "Hello, Harmony"
        })

        TextInput({
          placeholder: "Hello, Harmony",
          text: "I'm OpenHarmony"
        })

属性

共通プロパティのサポートに加えて、次のプロパティもサポートされます。

名前	パラメータの種類	説明する
タイプ	入力方式	入力ボックスの種類を設定します。 デフォルト値：InputType.Normal
プレースホルダーの色	リソースカラー	プレースホルダーの色を設定します。
プレースホルダーフォント	フォント	プレースホルダーのテキスト スタイルを設定します。 - size: 文字サイズを設定します(Lengthが数値型の場合はfp単位を使用します)。 - 太さ: テキストのフォントの太さを設定します。数値型の値は [100, 900] です。値の間隔は 100 です。デフォルトは 400 です。値が大きいほどフォントが太くなります。 - family: テキストのフォントリストを設定します。複数のフォントを使用し、「,」で区切ると、優先順位が順番に有効になります。例: 「Arial、サンセリフ」。 - スタイル: テキストのフォント スタイルを設定します。
EnterKeyType	EnterKeyType	入力方法 Enterキーの種類を設定します。 デフォルト値: EnterKeyType.Done
キャレットの色	リソースカラー	入力ボックスのカーソルの色を設定します。
最大長さ	番号	テキストの最大入力文字数を設定します。
入力フィルター8+	{ 値:  ResourceStr 8+、 エラー?: (値: 文字列) => void }	正規表現。その式を満たす入力は表示を許可され、正規表現を満たさない入力は無視されます。単一文字の一致のみがサポートされており、文字列の一致はサポートされていません。例: ^(?=.*\d)(?=.*[az])(?=.*[AZ]).{8,10}$、8 ～ 10 文字の強力なパスワードはフィルタリングをサポートしません。 - 値: 正規表現を設定します。 - エラー: 通常の一致が失敗した場合、無視されたコンテンツが返されます。

EnterKeyType 列挙型の説明

名前	説明する
行く	Go テキストを表示します。
検索	検索スタイルとして表示されます。
送信	送信スタイルとして表示されます。
次	次のスタイルとして表示されます。
終わり	スタンダードなスタイル。

InputType 列挙体の説明

名前	説明する
普通	基本的な入力モード。
パスワード	パスワード入力モード。
Eメール	メールアドレス入力モードです。
番号	純粋なデジタル入力モード。

イベント

名前	機能説明
onChange(コールバック: (値: 文字列) => void)	入力が変化すると、コールバックがトリガーされます。
onSubmit(コールバック: (enterKey: EnterKeyType) => void)	コールバックは Enter キーまたはソフト キーボードの Enter キーによってトリガーされ、パラメータは現在のソフト キーボードの Enter キーのタイプです。
onEditChanged(callback: (isEditing: boolean) => void)(非推奨)	入力状態が変化すると、コールバックがトリガーされます。
onEditChange(callback: (isEditing: boolean) => void) 8+	入力状態が変化すると、コールバックがトリガーされます。
onCopy8+(callback:(value: string) => void)	入力ボックスの内側の領域を長押ししてクリップボードをポップアップ表示した後、クリップボードのコピー ボタンをクリックしてコールバックをトリガーします。 value: コピーされたテキストの内容。
onCut8+(コールバック:(値:文字列) => void)	入力ボックスの内側の領域を長押ししてクリップボードをポップアップ表示した後、クリップボードのカット ボタンをクリックしてコールバックをトリガーします。 値: 切り取られたテキストの内容。
onPaste8+(callback:(value: string) => void)	入力ボックスの内側の領域を長押ししてクリップボードをポップアップ表示した後、クリップボードの貼り付けボタンをクリックしてコールバックをトリガーします。 値: 貼り付けられたテキストの内容。

はい、これを書くのはやめましょう！

暇なときによく家に遊びに来てください。ここに来てくれてありがとう...

私の自宅住所:アデン

最後に詩を紹介します。

山は高く、道は遠く、穴は深く、
軍隊はあらゆる方向に疾走しています。

誰が敢えて直立するでしょうか？
軍隊が好きで従ってください。