网站建设与维护内容,河南省网站集约化建设,上海最新新闻发布会,设计免费搜索框组件#xff0c;适用于浏览器的搜索内容输入框等应用场景。 说明#xff1a; 该组件从API Version 8开始支持。后续版本如有新增内容#xff0c;则采用上角标单独标记该内容的起始版本。 子组件
无
接口
Search(options?: { value?: string, placeholder?: Reso…搜索框组件适用于浏览器的搜索内容输入框等应用场景。 说明 该组件从API Version 8开始支持。后续版本如有新增内容则采用上角标单独标记该内容的起始版本。 子组件
无
接口
Search(options?: { value?: string, placeholder?: ResourceStr, icon?: string, controller?: SearchController })
参数:
参数名参数类型必填参数描述valuestring否设置当前显示的搜索文本内容。 从API version 10开始该参数支持$$双向绑定变量。placeholderResourceStr10否设置无输入时的提示文本。iconstring否设置搜索图标路径默认使用系统搜索图标。说明 icon的数据源支持本地图片和网络图片。 - 支持的图片格式包括png、jpg、bmp、svg、gif和pixelmap。 - 支持Base64字符串。格式data:image/[png|jpeg|bmp|webp];base64,[base64 data], 其中[base64 data]为Base64字符串数据。 如果与属性searchIcon同时设置则searchIcon优先。controllerSearchController否设置Search组件控制器。
属性
除支持通用属性外还支持以下属性
名称参数类型描述searchButton10value: string, option?: SearchButtonOptions搜索框末尾搜索按钮文本内容默认无搜索按钮。placeholderColorResourceColor设置placeholder文本颜色。 默认值#99182431。placeholderFontFont设置placeholder文本样式包括字体大小字体粗细字体族字体风格。目前仅支持默认字体族。textFontFont设置搜索框内输入文本样式包括字体大小字体粗细字体族字体风格。目前仅支持默认字体族。textAlignTextAlign设置文本在搜索框中的对齐方式。目前支持的对齐方式有Start、Center、End。 默认值TextAlign.StartcopyOption9CopyOptions设置输入的文本是否可复制。 默认值CopyOptions.LocalDevice支持设备内复制。 设置CopyOptions.None时当前Search中的文字无法被复制或剪切仅支持粘贴。searchIcon10IconOptions设置左侧搜索图标样式。cancelButton10{ style? : CancelButtonStyle icon?: IconOptions }设置右侧清除按钮样式。 默认值 { styleCancelButtonStyle.INPUT }fontColor10ResourceColor设置输入文本的字体颜色。 默认值#FF182431。说明文本通用属性fontSize、fontStyle、fontWeight和fontFamily在textFont属性中设置。caretStyle10CaretStyle设置光标样式。 默认值 { width: 1.5vp, color: #007DFF }enableKeyboardOnFocus10booleanSearch获焦时是否绑定输入法 默认值true。从API version 10开始获焦默认绑定输入法。selectionMenuHidden10boolean设置长按输入框或者右键输入框时是否弹出文本选择菜单。 默认值falsecustomKeyboard10CustomBuilder设置自定义键盘。说明 当设置自定义键盘时输入框激活后不会打开系统输入法而是加载指定的自定义组件。 自定义键盘的高度可以通过自定义组件根节点的height属性设置宽度不可设置使用系统默认值。 自定义键盘采用覆盖原始界面的方式呈现不会对应用原始界面产生压缩或者上提。 自定义键盘无法获取焦点但是会拦截手势事件。 默认在输入控件失去焦点时关闭自定义键盘开发者也可以通过stopEditing方法控制键盘关闭。 如果设备支持拍摄输入设置自定义键盘后该输入框会不支持拍摄输入。type11SearchType设置输入框类型。 默认值SearchType.NormalmaxLength11number设置文本的最大输入字符数。 默认不设置最大输入字符数限制。 到达文本最大字符限制将无法继续输入字符。
IconOptions10对象说明
参数名参数类型必填参数描述sizeLength否图标尺寸不支持百分比。colorResourceColor否图标颜色。srcResourceStr否图标/图片源。
CaretStyle10对象说明
参数名参数类型必填参数描述widthLength否光标尺寸不支持百分比。colorResourceColor否光标颜色。
SearchButtonOptions10对象说明
参数名参数类型必填参数描述fontSizeLength否文本按钮字体大小不支持百分比。fontColorResourceColor否文本按钮字体颜色。
CancelButtonStyle10枚举说明
名称描述CONSTANT清除按钮常显样式。INVISIBLE清除按钮常隐样式。INPUT清除按钮输入样式。
SearchType11枚举说明
名称描述Normal基本输入模式。 支持输入数字、字母、下划线、空格、特殊字符。Email邮箱地址输入模式。支持数字字母下划线以及字符只能存在一个字符。Number纯数字输入模式。PhoneNumber电话号码输入模式。 支持输入数字、 、-、*、#长度不限。
事件
除支持通用事件外还支持以下事件
名称功能描述onSubmit(callback: (value: string) void)点击搜索图标、搜索按钮或者按下软键盘搜索按钮时触发该回调。 -value: 当前搜索框中输入的文本内容。onChange(callback: (value: string) void)输入内容发生变化时触发该回调。 -value: 当前搜索框中输入的文本内容。onCopy(callback: (value: string) void)长按搜索框弹出剪切板之后点击剪切板的复制按钮触发该回调。 -value: 复制的文本内容。onCut(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。
SearchController
Search组件的控制器目前通过它可控制Search组件的光标位置。
导入对象
controller: SearchController new SearchController()
caretPosition
caretPosition(value: number): void
设置输入光标的位置。
参数:
参数名参数类型必填参数描述valuenumber是从字符串开始到光标所在位置的长度。
stopEditing10
stopEditing(): void
退出编辑态。
getTextContentRect10
getTextContentRect(): RectResult
获取已编辑文本内容区域相对组件的位置和大小返回值单位为像素。
返回值
类型说明RectResult已编辑文本内容的相对组件的位置和大小。 说明 返回的位置信息是相对Search组件中搜索图标的偏移值。不输入文本时返回值中有相对Search组件的位置信息但大小为0。返回值中的位置信息是第一个字符相对于可编辑组件的位置。 RectResult10
位置和大小单位均为像素。
参数类型描述xnumber水平方向横坐标。ynumber竖直方向纵坐标。widthnumber内容宽度大小。heightnumber内容高度大小。
getTextContentLineCount10
getTextContentLineCount(): number
获取已编辑文本内容的行数。
返回值
类型说明number已编辑文本内容行数。
getCaretOffset11
getCaretOffset(): CaretOffset
返回当前光标所在位置信息。
返回值
类型说明CaretOffset光标相对输入框的位置。 说明 返回的位置信息是相对Search组件中搜索图标的偏移值。不输入文本时返回值中有相对Search组件的位置信息。返回值中的位置信息是光标相对于可编辑组件的位置。在当前帧更新光标位置同时调用该接口该接口不生效。 示例
示例1
// xxx.ets
Entry
Component
struct SearchExample {State changeValue: string State submitValue: string State positionInfo: CaretOffset { index: 0, x: 0, y: 0 }controller: SearchController new SearchController()build() {Column({space: 10}) {Text(onSubmit: this.submitValue).fontSize(18).margin(15)Text(onChange: this.changeValue).fontSize(18).margin(15)Search({ value: this.changeValue, placeholder: Type to search..., controller: this.controller }).searchButton(SEARCH).width(95%).height(40).backgroundColor(#F5F5F5).placeholderColor(Color.Grey).placeholderFont({ size: 14, weight: 400 }).textFont({ size: 14, weight: 400 }).onSubmit((value: string) {this.submitValue value}).onChange((value: string) {this.changeValue value}).margin(20)Button(Set caretPosition 1).onClick(() {// 设置光标位置到输入的第一个字符后this.controller.caretPosition(1)})Button(Get CaretOffset).onClick(() {this.positionInfo this.controller.getCaretOffset()})}.width(100%)}
} 示例2
// xxx.ets
Entry
Component
struct SearchExample {State changeValue: string State submitValue: string build() {Column() {Text(onSubmit: this.submitValue).fontSize(18).margin(15)Search({ value: this.changeValue, placeholder: Type to search... }).searchButton(SEARCH).searchIcon({src: $r(app.media.search)}).cancelButton({style: CancelButtonStyle.CONSTANT,icon: {src: $r(app.media.cancel)}}).width(90%).height(40).maxLength(20).backgroundColor(#F5F5F5).placeholderColor(Color.Grey).placeholderFont({ size: 14, weight: 400 }).textFont({ size: 14, weight: 400 }).onSubmit((value: string) {this.submitValue value}).onChange((value: string) {this.changeValue value}).margin(20)}.width(100%)}
} 示例3
// xxx.ets
Entry
Component
struct SearchExample {controller: SearchController new SearchController()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() {Search({ controller: this.controller, value: this.inputValue})// 绑定自定义键盘.customKeyboard(this.CustomKeyboardBuilder()).margin(10).border({ width: 1 })}}
} 最后有很多小伙伴不知道学习哪些鸿蒙开发技术不知道需要重点掌握哪些鸿蒙应用开发知识点而且学习时频繁踩坑最终浪费大量时间。所以有一份实用的鸿蒙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学习资料
总结
总的来说华为鸿蒙不再兼容安卓对中年程序员来说是一个挑战也是一个机会。只有积极应对变化不断学习和提升自己他们才能在这个变革的时代中立于不败之地。
