鴻蒙（HarmonyOS）項目方舟框架（ArkUI）之TextInput輸入框組件
一、操作環(huán)境
操作系統(tǒng):? Windows 10 專業(yè)版
IDE:DevEco Studio 3.1
SDK:HarmonyOS 3.1
二、TextInput
接口
TextInput(value?:{placeholder?: ResourceStr, text?: ResourceStr, controller?: TextInputController})
參數(shù)：
| 參數(shù)名 |
參數(shù)類型 |
必填 |
參數(shù)描述 |
|---|---|---|---|
| placeholder |
ResourceStr |
否 |
無輸入時的提示文本。 |
| text |
ResourceStr |
否 |
設(shè)置輸入框當前的文本內(nèi)容。 |
| controller |
TextInputController |
否 |
光標控制器，設(shè)置光標的下標位置。 |
示例：
TextInput({
placeholder: "Hello, Harmony"
})
TextInput({
placeholder: "Hello, Harmony",
text: "I'm OpenHarmony"
})
屬性
除支持通用屬性外，還支持以下屬性：
| 名稱 |
參數(shù)類型 |
描述 |
|---|---|---|
| type |
InputType |
設(shè)置輸入框類型。 默認值：InputType.Normal |
| placeholderColor |
ResourceColor |
設(shè)置placeholder顏色。 |
| placeholderFont |
Font |
設(shè)置placeholder文本樣式： - size: 設(shè)置文本尺寸，Length為number類型時，使用fp單位。 - weight: 設(shè)置文本的字體粗細，number類型取值[100, 900]，取值間隔為100，默認為400，取值越大，字體越粗。 - family: 設(shè)置文本的字體列表。使用多個字體，使用','進行分割，優(yōu)先級按順序生效。例如：'Arial, sans-serif'。 - style: 設(shè)置文本的字體樣式。 |
| enterKeyType |
EnterKeyType |
設(shè)置輸入法回車鍵類型。 默認值：EnterKeyType.Done |
| caretColor |
ResourceColor |
設(shè)置輸入框光標顏色。 |
| maxLength |
number |
設(shè)置文本的最大輸入字符數(shù)。 |
| inputFilter8+ |
{ value:?ResourceStr8+, error?: (value: string) => void } |
正則表達式，滿足表達式的輸入允許顯示，不滿足正則表達式的輸入被忽略。僅支持單個字符匹配，不支持字符串匹配。例如：^(?=.*\d)(?=.*[a-z])(?=.*[A-Z]).{8,10}$，8到10位的強密碼不支持過濾。 - value：設(shè)置正則表達式。 - error：正則匹配失敗時，返回被忽略的內(nèi)容。 |
EnterKeyType枚舉說明
| 名稱 |
描述 |
|---|---|
| Go |
顯示Go文本。 |
| Search |
顯示為搜索樣式。 |
| Send |
顯示為發(fā)送樣式。 |
| Next |
顯示為下一個樣式。 |
| Done |
標準樣式。 |
InputType枚舉說明
| 名稱 |
描述 |
|---|---|
| Normal |
基本輸入模式。 |
| Password |
密碼輸入模式。 |
| |
e-mail地址輸入模式。 |
| Number |
純數(shù)字輸入模式。 |
事件
| 名稱 |
功能描述 |
|---|---|
| onChange(callback: (value: string) => void) |
輸入發(fā)生變化時，觸發(fā)回調(diào)。 |
| onSubmit(callback: (enterKey: EnterKeyType) => void) |
回車鍵或者軟鍵盤回車鍵觸發(fā)該回調(diào)，參數(shù)為當前軟鍵盤回車鍵類型。 |
| onEditChanged(callback: (isEditing: boolean) => void)(deprecated) |
輸入狀態(tài)變化時，觸發(fā)回調(diào)。 |
| onEditChange(callback: (isEditing: boolean) => void)?8+ |
輸入狀態(tài)變化時，觸發(fā)回調(diào)。 |
| onCopy8+(callback:(value: string) => void) |
長按輸入框內(nèi)部區(qū)域彈出剪貼板后，點擊剪切板復制按鈕，觸發(fā)回調(diào)。 value：復制的文本內(nèi)容。 |
| onCut8+(callback:(value: string) => void) |
長按輸入框內(nèi)部區(qū)域彈出剪貼板后，點擊剪切板剪切按鈕，觸發(fā)回調(diào)。 value：剪切的文本內(nèi)容。 |
| onPaste8+(callback:(value: string) => void) |
長按輸入框內(nèi)部區(qū)域彈出剪貼板后，點擊剪切板粘貼按鈕，觸發(fā)回調(diào)。 value：粘貼的文本內(nèi)容。 |
好了就寫到這吧！
你有時間常去我家看看我在這里謝謝你啦...
我家地址:亞丁號
最后送大家一首詩:
山高路遠坑深,
大軍縱橫馳奔,文章來源：http://www.zghlxwxcb.cn/news/detail-763147.html
誰敢橫刀立馬？
惟有點贊加關(guān)注大軍。文章來源地址http://www.zghlxwxcb.cn/news/detail-763147.html
到了這里，關(guān)于鴻蒙（HarmonyOS）項目方舟框架（ArkUI）之TextInput輸入框組件的文章就介紹完了。如果您還想了解更多內(nèi)容，請在右上角搜索TOY模板網(wǎng)以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持TOY模板網(wǎng)！
