搜索框組件，適用于瀏覽器的搜索內(nèi)容輸入框等應(yīng)用場景。

說明：

該組件從API Version 8開始支持。后續(xù)版本如有新增內(nèi)容，則采用上角標單獨標記該內(nèi)容的起始版本。

子組件

無

接口

Search(options?: { value?: string, placeholder?: ResourceStr, icon?: string, controller?: SearchController })

參數(shù):

屬性

除支持通用屬性外，還支持以下屬性：

IconOptions10+對象說明

CaretStyle10+對象說明

SearchButtonOptions10+對象說明

CancelButtonStyle10+枚舉說明

SearchType11+枚舉說明

事件

除支持通用事件外，還支持以下事件：

SearchController

Search組件的控制器，目前通過它可控制Search組件的光標位置。

導(dǎo)入對象

controller: SearchController = new SearchController()

caretPosition

caretPosition(value: number): void

設(shè)置輸入光標的位置。

參數(shù):

stopEditing10+

stopEditing(): void

退出編輯態(tài)。

getTextContentRect10+

getTextContentRect(): RectResult

獲取已編輯文本內(nèi)容區(qū)域相對組件的位置和大小，返回值單位為像素。

返回值：

說明：

• 返回的位置信息是相對Search組件中搜索圖標的偏移值。
• 不輸入文本時，返回值中有相對Search組件的位置信息，但大小為0。
• 返回值中的位置信息是第一個字符相對于可編輯組件的位置。

RectResult10+

位置和大小，單位均為像素。

getTextContentLineCount10+

getTextContentLineCount(): number

獲取已編輯文本內(nèi)容的行數(shù)。

返回值：

getCaretOffset11+

getCaretOffset(): CaretOffset

返回當前光標所在位置信息。

返回值：

說明：

• 返回的位置信息是相對Search組件中搜索圖標的偏移值。
• 不輸入文本時，返回值中有相對Search組件的位置信息。
• 返回值中的位置信息是光標相對于可編輯組件的位置。
• 在當前幀更新光標位置同時調(diào)用該接口，該接口不生效。

示例

示例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(() => {
          // 設(shè)置光標位置到輸入的第一個字符后
          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(() => {
        // 關(guān)閉自定義鍵盤
        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 })
    }
  }
}

最后，有很多小伙伴不知道學(xué)習(xí)哪些鴻蒙開發(fā)技術(shù)？不知道需要重點掌握哪些鴻蒙應(yīng)用開發(fā)知識點？而且學(xué)習(xí)時頻繁踩坑，最終浪費大量時間。所以有一份實用的鴻蒙（Harmony NEXT）資料用來跟著學(xué)習(xí)是非常有必要的。?

這份鴻蒙（Harmony NEXT）資料包含了鴻蒙開發(fā)必掌握的核心知識要點，內(nèi)容包含了（ArkTS、ArkUI開發(fā)組件、Stage模型、多端部署、分布式應(yīng)用開發(fā)、音頻、視頻、WebGL、OpenHarmony多媒體技術(shù)、Napi組件、OpenHarmony內(nèi)核、Harmony南向開發(fā)、鴻蒙項目實戰(zhàn)等等）鴻蒙（Harmony NEXT）技術(shù)知識點。

希望這一份鴻蒙學(xué)習(xí)資料能夠給大家?guī)韼椭?，有需要的小伙伴自行領(lǐng)取，限時開源，先到先得~無套路領(lǐng)?。?！

獲取這份完整版高清學(xué)習(xí)路線，請點擊→純血版全套鴻蒙HarmonyOS學(xué)習(xí)資料

鴻蒙（Harmony NEXT）最新學(xué)習(xí)路線

• ?HarmonOS基礎(chǔ)技能

• HarmonOS就業(yè)必備技能?
• ?HarmonOS多媒體技術(shù)

• 鴻蒙NaPi組件進階

• HarmonOS高級技能

• 初識HarmonOS內(nèi)核?
• 實戰(zhàn)就業(yè)級設(shè)備開發(fā)

有了路線圖，怎么能沒有學(xué)習(xí)資料呢，小編也準備了一份聯(lián)合鴻蒙官方發(fā)布筆記整理收納的一套系統(tǒng)性的鴻蒙（OpenHarmony ）學(xué)習(xí)手冊（共計1236頁）與鴻蒙（OpenHarmony ）開發(fā)入門教學(xué)視頻，內(nèi)容包含：ArkTS、ArkUI、Web開發(fā)、應(yīng)用模型、資源分類…等知識點。

獲取以上完整版高清學(xué)習(xí)路線，請點擊→純血版全套鴻蒙HarmonyOS學(xué)習(xí)資料

《鴻蒙 (OpenHarmony)開發(fā)入門教學(xué)視頻》

《鴻蒙生態(tài)應(yīng)用開發(fā)V2.0白皮書》

《鴻蒙 (OpenHarmony)開發(fā)基礎(chǔ)到實戰(zhàn)手冊》

OpenHarmony北向、南向開發(fā)環(huán)境搭建

?《鴻蒙開發(fā)基礎(chǔ)》

• ArkTS語言
• 安裝DevEco Studio
• 運用你的第一個ArkTS應(yīng)用
• ArkUI聲明式UI開發(fā)
• .……

?《鴻蒙開發(fā)進階》

• Stage模型入門
• 網(wǎng)絡(luò)管理
• 數(shù)據(jù)管理
• 電話服務(wù)
• 分布式應(yīng)用開發(fā)
• 通知與窗口管理
• 多媒體技術(shù)
• 安全技能
• 任務(wù)管理
• WebGL
• 國際化開發(fā)
• 應(yīng)用測試
• DFX面向未來設(shè)計
• 鴻蒙系統(tǒng)移植和裁剪定制
• ……

《鴻蒙進階實戰(zhàn)》

• ArkTS實踐
• UIAbility應(yīng)用
• 網(wǎng)絡(luò)案例
• ……

?獲取以上完整鴻蒙HarmonyOS學(xué)習(xí)資料，請點擊→純血版全套鴻蒙HarmonyOS學(xué)習(xí)資料

總結(jié)

總的來說，華為鴻蒙不再兼容安卓，對中年程序員來說是一個挑戰(zhàn)，也是一個機會。只有積極應(yīng)對變化，不斷學(xué)習(xí)和提升自己，他們才能在這個變革的時代中立于不敗之地。?

文章來源地址http://www.zghlxwxcb.cn/news/detail-843028.html

到了這里，關(guān)于鴻蒙Harmony應(yīng)用開發(fā)—ArkTS聲明式開發(fā)（基礎(chǔ)手勢：Search）的文章就介紹完了。如果您還想了解更多內(nèi)容，請在右上角搜索TOY模板網(wǎng)以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持TOY模板網(wǎng)！