水利建设经济定额站网站,简历制作专业模板,官方网站建设教程,怎么做网页设计视频多行文本输入框组件#xff0c;当输入的文本内容超过组件宽度时会自动换行显示。
高度未设置时#xff0c;组件无默认高度#xff0c;自适应内容高度。宽度未设置时#xff0c;默认撑满最大宽度。 说明#xff1a; 该组件从API Version 7开始支持。后续版本如有新增内容当输入的文本内容超过组件宽度时会自动换行显示。
高度未设置时组件无默认高度自适应内容高度。宽度未设置时默认撑满最大宽度。 说明 该组件从API Version 7开始支持。后续版本如有新增内容则采用上角标单独标记该内容的起始版本。 子组件
无
接口
TextArea(value?:{placeholder?: ResourceStr, text?: ResourceStr, controller?: TextAreaController})
参数
参数名参数类型必填参数描述placeholderResourceStr否设置无输入时的提示文本。输入内容后提示文本不显示。 仅设置placeholder属性时手柄依然跟随拖动手柄松开后光标停留在文字开头位置。textResourceStr否设置输入框当前的文本内容。当组件设置stateStyles等刷新属性时建议通过onChange事件将状态变量与文本实时绑定避免组件刷新时TextArea中的文本内容异常。 从API version 10开始该参数支持$$双向绑定变量。controller8TextAreaController否设置TextArea控制器。
属性
除支持通用属性和文本通用属性的fontColor、fontSize、fontStyle、fontWeight、fontFamily外还支持以下属性
名称参数类型描述placeholderColorResourceColor设置placeholder文本颜色。 默认值跟随主题。placeholderFontFont设置placeholder文本样式包括字体大小字体粗细字体族字体风格。目前仅支持默认字体族。textAlignTextAlign设置文本在输入框中的水平对齐方式。 默认值TextAlign.Start说明 支持TextAlign.Start、TextAlign.Center和TextAlign.End。 可通过align属性控制文本段落在垂直方向上的位置此组件中不可通过align属性控制文本段落在水平方向上的位置即align属性中Alignment.TopStart、Alignment.Top、Alignment.TopEnd效果相同控制内容在顶部Alignment.Start、Alignment.Center、Alignment.End效果相同控制内容垂直居中Alignment.BottomStart、Alignment.Bottom、Alignment.BottomEnd效果相同控制内容在底部。 当textAlign属性设置为TextAlign.JUSTIFY时最后一行文本不参与两端对齐为水平对齐首部效果。 从API version 11开始textAlign可设置TextAlign.JUSTIFYcaretColorResourceColor设置输入框光标颜色。 默认值#007DFF。inputFilter8{ value: ResourceStr, error?: (value: string) void }通过正则表达式设置输入过滤器。匹配表达式的输入允许显示不匹配的输入将被过滤。仅支持单个字符匹配不支持字符串匹配。 - value设置正则表达式。 - error正则匹配失败时返回被过滤的内容。copyOption9CopyOptions设置输入的文本是否可复制。 默认值CopyOptions.LocalDevice支持设备内复制。 设置CopyOptions.None时当前TextArea中的文字无法被复制或剪切仅支持粘贴。maxLength10number设置文本的最大输入字符数。 默认不设置最大输入字符数限制。 到达文本最大字符限制将无法继续输入字符同时边框变为红色。showCounter10value: boolean, options11?: InputCounterOptions参数value为true时才能设置options文本框开启计数下标功能需要配合maxlength设置最大字符限制一起使用。字符计数器显示的效果是当前输入字符数/最大可输入字符数。当输入字符数大于最大字符数乘百分比值时显示字符计数器。如果用户设置计数器时不设置InputCounterOptions那么当前输入字符数达到最大字符数时边框将变为红色。用户同时设置参数value为true和InputCounterOptions当thresholdPercentage数值在有效区间内且输入字符数超过最大字符数时边框将变为红色框体抖动。highlightBorder设置为false则不显示红色边框计数器默认显示红色边框。内联模式和密码模式下字符计数器不显示。style10TextContentStyle设置文本框多态样式。 默认值TextContentStyle.DEFAULTenableKeyboardOnFocus10booleanTextArea通过点击以外的方式获焦时是否绑定输入法。 默认值true。从API version 10开始获焦默认绑定输入法。selectionMenuHidden10boolean设置长按输入框或者右键输入框时是否弹出文本选择菜单。 默认值falsebarState10BarState设置内联输入风格编辑态时滚动条的显示模式。 默认值BarState.AutomaxLines10number设置内联输入风格编辑态时文本可显示的最大行数。 默认值3说明 取值范围(0, ∞)。customKeyboard10CustomBuilder设置自定义键盘。说明 当设置自定义键盘时输入框激活后不会打开系统输入法而是加载指定的自定义组件。 自定义键盘的高度可以通过自定义组件根节点的height属性设置宽度不可设置使用系统默认值。 自定义键盘采用覆盖原始界面的方式呈现不会对应用原始界面产生压缩或者上提。 自定义键盘无法获取焦点但是会拦截手势事件。 默认在输入控件失去焦点时关闭自定义键盘开发者也可以通过TextAreaController.stopEditing方法控制键盘关闭。 如果设备支持拍摄输入设置自定义键盘后该输入框会不支持拍摄输入。type11TextAreaType设置输入框类型。 默认值TextAreaType.NormalenterKeyType11EnterKeyType设置输入法回车键类型。 默认值EnterKeyType.NEW_LINE 说明 通用属性padding的默认值为 { top: 8 vp, right: 16 vp, bottom: 8 vp, left: 16 vp } 从API version 11开始多行输入框可设置.width(auto)使组件宽度自适应文本宽度自适应时组件宽度受constraintSize属性以及父容器传递的最大最小宽度限制其余使用方式参考尺寸设置。 事件
除支持通用事件外还支持以下事件
名称功能描述onChange(callback: (value: string) void)输入内容发生变化时触发该回调。 - value当前输入的文本内容。onEditChange(callback: (isEditing: boolean) void)10输入状态变化时触发该回调。有光标时为编辑态无光标时为非编辑态。isEditing为true表示正在输入。onCopy8(callback:(value: string) void)长按输入框内部区域弹出剪贴板后点击剪切板复制按钮触发该回调。 - value复制的文本内容。onCut8(callback:(value: string) void)长按输入框内部区域弹出剪贴板后点击剪切板剪切按钮触发该回调。 - value剪切的文本内容。onPaste(callback:(value: string, event11: PasteEvent) void)长按输入框内部区域弹出剪贴板后点击剪切板粘贴按钮触发该回调。 - value粘贴的文本内容。 - event用户自定义的粘贴事件。onTextSelectionChange(callback: (selectionStart: number, selectionEnd: number) void)10文本选择的位置发生变化时触发该回调。 selectionStart文本选择区域起始位置文本框中文字的起始位置为0。 selectionEnd文本选择区域结束位置。onContentScroll(callback: (totalOffsetX: number, totalOffsetY: number) void)10文本内容滚动时触发该回调。 totalOffsetX文本在内容区的横坐标偏移单位px。 totalOffsetY文本在内容区的纵坐标偏移单位px。onSubmit(callback: (enterKey: EnterKeyType) void)11按下输入法回车键触发该回调。 enterKey输入法回车键类型类型为EnterKeyType.NEW_LINE时不触发onSubmit。具体类型见EnterKeyType枚举说明。
TextAreaController8
TextArea组件的控制器目前可通过它设置TextArea组件的光标位置。
导入对象
controller: TextAreaController new TextAreaController()
caretPosition8
caretPosition(value: number): void
设置输入光标的位置。
参数
参数名参数类型必填参数描述valuenumber是从字符串开始到光标所在位置的字符长度。
setTextSelection10
setTextSelection(selectionStart: number, selectionEnd: number): void
组件在获焦状态下调用该接口设置文本选择区域并高亮显示且只有在selectionStart小于selectionEnd时文字才会被选取、高亮显示。
参数
参数名参数类型必填参数描述selectionStartnumber是文本选择区域起始位置文本框中文字的起始位置为0。 当selectionStart小于0时、按照0处理当selectionStart大于文字最大长度时、按照文字最大长度处理。selectionEndnumber是文本选择区域结束位置。 当selectionEnd小于0时、按照0处理当selectionEnd大于文字最大长度时、按照文字最大长度处理。
stopEditing10
stopEditing(): void
退出编辑态。
getTextContentRect10
getTextContentRect(): RectResult
获取已编辑文本内容区域相对组件的位置和大小返回值单位为像素。
返回值
类型说明RectResult已编辑文本内容的相对组件的位置和大小。 说明 初始不输入文本时返回值中有相对组件的位置信息大小为0。返回值中的位置信息是第一个字符相对于可编辑组件的位置。有输入时返回信息中的宽度是组件编辑的固定宽度。 RectResult10
位置和大小单位均为像素。
参数类型描述xnumber水平方向横坐标。ynumber竖直方向纵坐标。widthnumber内容宽度大小。heightnumber内容高度大小。
getTextContentLineCount10
getTextContentLineCount(): number
获取已编辑文本内容的行数。
返回值
类型说明number已编辑文本内容行数。
TextAreaType11枚举说明
名称描述Normal基本输入模式。 支持输入数字、字母、下划线、空格、特殊字符。Email邮箱地址输入模式。支持数字字母下划线以及字符只能存在一个字符。Number纯数字输入模式。PhoneNumber电话号码输入模式。 支持输入数字、 、-、*、#长度不限。
getCaretOffset11
getCaretOffset(): CaretOffset
返回当前光标所在位置信息。
返回值
类型说明CaretOffset光标相对输入框的位置。 说明 在当前帧更新光标位置同时调用该接口该接口不生效。 示例
示例1
// xxx.ets
Entry
Component
struct TextAreaExample {State text: string State positionInfo: CaretOffset { index: 0, x: 0, y: 0 }controller: TextAreaController new TextAreaController()build() {Column() {TextArea({text: this.text,placeholder: The text area can hold an unlimited amount of text. input your word...,controller: this.controller}).placeholderFont({ size: 16, weight: 400 }).width(336).height(56).margin(20).fontSize(16).fontColor(#182431).backgroundColor(#FFFFFF).onChange((value: string) {this.text value})Text(this.text)Button(Set caretPosition 1).backgroundColor(#007DFF).margin(15).onClick(() {// 设置光标位置到第一个字符后this.controller.caretPosition(1)})Button(Get CaretOffset).backgroundColor(#007DFF).margin(15).onClick(() {this.positionInfo this.controller.getCaretOffset()})}.width(100%).height(100%).backgroundColor(#F1F3F5)}
} 示例2
// xxx.ets
Entry
Component
struct TextAreaExample {State text: string testState counterVisible: boolean falseState maxNumber: number -1controller: TextAreaController new TextAreaController()build() {Column() {TextArea({text: this.text,placeholder: The text area can hold an unlimited amount of text. input your word...,controller: this.controller}).placeholderFont({ size: 16, weight: 400 }).width(336).height(56).margin(20).fontSize(16).fontColor(#182431).maxLength(4).showCounter(true).backgroundColor(#FFFFFF).onChange((value: string) {this.text value})}.width(100%).height(100%).backgroundColor(#F1F3F5)}
} 示例3
// xxx.ets
Entry
Component
struct TextAreaExample {controller: TextAreaController new TextAreaController()State inputValue: string // 自定义键盘组件Builder CustomKeyboardBuilder() {Column() {Button(x).onClick(() {// 关闭自定义键盘this.controller.stopEditing()})Grid() {ForEach([1, 2, 3, 4, 5, 6, 7, 8, 9, *, 0, #], (item: number | string) {GridItem() {Button(item ).width(110).onClick(() {this.inputValue item})}})}.maxCount(3).columnsGap(10).rowsGap(10).padding(5)}.backgroundColor(Color.Gray)}build() {Column() {TextArea({ controller: this.controller, text: this.inputValue})// 绑定自定义键盘.customKeyboard(this.CustomKeyboardBuilder()).margin(10).border({ width: 1 }).height(200)}}
} 示例4
// xxx.ets
Entry
Component
struct TextAreaExample {State text: string controller: TextAreaController new TextAreaController()build() {Column() {TextArea({ text: this.text, controller: this.controller }).placeholderFont({ size: 16, weight: 400 }).width(336).height(56).maxLength(6).showCounter(true, { thresholdPercentage: 50, highlightBorder: true })//计数器显示效果为用户当前输入字符数/最大字符限制数。最大字符限制数通过maxLength()接口设置。//如果用户当前输入字符数达到最大字符限制乘50%thresholdPercentage。字符计数器显示。//用户设置highlightBorder为false时配置取消红色边框。不设置此参数时默认为true。.onChange((value: string) {this.text value})}.width(100%).height(100%).backgroundColor(#F1F3F5)}
} 示例5
// xxx.ets
Entry
Component
struct TextInputExample {State Text: string State enterTypes: ArrayEnterKeyType [EnterKeyType.Go, EnterKeyType.Search, EnterKeyType.Send, EnterKeyType.Done, EnterKeyType.Next, EnterKeyType.PREVIOUS, EnterKeyType.NEW_LINE]State index: number 0build() {Column({ space: 20 }) {TextArea({ placeholder: 请输入用户名, text: this.Text }).width(380).enterKeyType(this.enterTypes[this.index]).onChange((value: string) {this.Text value}).onSubmit((enterKey: EnterKeyType) {console.log(trigger area onsubmit enterKey);})Button(改变EnterKeyType).onClick(() {this.index (this.index 1) % this.enterTypes.length;})}.width(100%)}
} 最后有很多小伙伴不知道学习哪些鸿蒙开发技术不知道需要重点掌握哪些鸿蒙应用开发知识点而且学习时频繁踩坑最终浪费大量时间。所以有一份实用的鸿蒙Harmony NEXT资料用来跟着学习是非常有必要的。
这份鸿蒙Harmony NEXT资料包含了鸿蒙开发必掌握的核心知识要点内容包含了ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等鸿蒙Harmony NEXT技术知识点。
希望这一份鸿蒙学习资料能够给大家带来帮助有需要的小伙伴自行领取限时开源先到先得~无套路领取
获取这份完整版高清学习路线请点击→纯血版全套鸿蒙HarmonyOS学习资料
腾讯T10级高工技术安卓全套VIP内容 →Android全套学习资料
腾讯T10级高工技术安卓全套VIP课程
鸿蒙Harmony NEXT最新学习路线 HarmonOS基础技能 HarmonOS就业必备技能 HarmonOS多媒体技术 鸿蒙NaPi组件进阶 HarmonOS高级技能 初识HarmonOS内核 实战就业级设备开发 有了路线图怎么能没有学习资料呢小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的鸿蒙OpenHarmony 学习手册共计1236页与鸿蒙OpenHarmony 开发入门教学视频内容包含ArkTS、ArkUI、Web开发、应用模型、资源分类…等知识点。
获取以上完整版高清学习路线请点击→纯血版全套鸿蒙HarmonyOS学习资料
《鸿蒙 (OpenHarmony)开发入门教学视频》 《鸿蒙生态应用开发V2.0白皮书》 《鸿蒙 (OpenHarmony)开发基础到实战手册》
OpenHarmony北向、南向开发环境搭建 《鸿蒙开发基础》
ArkTS语言安装DevEco Studio运用你的第一个ArkTS应用ArkUI声明式UI开发.…… 《鸿蒙开发进阶》
Stage模型入门网络管理数据管理电话服务分布式应用开发通知与窗口管理多媒体技术安全技能任务管理WebGL国际化开发应用测试DFX面向未来设计鸿蒙系统移植和裁剪定制…… 《鸿蒙进阶实战》
ArkTS实践UIAbility应用网络案例…… 获取以上完整鸿蒙HarmonyOS学习资料请点击→纯血版全套鸿蒙HarmonyOS学习资料
总结
总的来说华为鸿蒙不再兼容安卓对中年程序员来说是一个挑战也是一个机会。只有积极应对变化不断学习和提升自己他们才能在这个变革的时代中立于不败之地。
