鸿蒙开发HarmonyOS（ Beta5版）定位解决焦点最佳实践

问题场景：

开发者通常在输入的场景需要通过走焦唤醒键盘。但是在某些场景涉及组件如何主动获焦，监听走焦状态等有疑问。不理解走焦规则，出现实际效果与预期不符合，无法排查组件的走焦状态。

定位手段：

焦点相关概念属性参见gitee：焦点事件

焦点默认行为变更

API 11之前，未配置defaultFocus属性的情况下，当页面首次打开时，原先默认第一个可获焦的非容器组件会立即获取焦点。API 11及之后变更后，该组件不会在此刻获取到焦点，此时焦点在当前页面的根容器上。

焦点基础能力：

1、一次区分defaultFocus、focusable、enableKeyboardOnfocus

defaultFocus：设置当前组件是否为当前页面上的默认焦点，仅在初次创建的页面第一次进入时生效。

• 若页面内无任何组件设置defaultFocus为true，页面的默认焦点就是页面的根容器

• 若页面内有多个组件设置defaultFocus为true，则以组件树深度遍历找到的第一个组件为默认焦点

focusable：设置当前组件是否可以获焦。是获焦的能力，不一定当前焦点就在设置的组件上。

• 存在默认交互逻辑的组件例如button、TextInput等，默认即为可获焦。

• Text、Image等组件默认状态为不可获焦。不可获焦状态下，无法触发焦点事件

如图：Text开启了获焦能力，想要焦点在Text上，要触发主动走焦。

enableKeyboardOnfocus：通过点击以外方式获焦时，控制是否弹出键盘。针对Search、TextInput、TextArea组件的获焦时绑定输入法的行为。

比如：页面初次构建完成时，使TextInput默认获取焦点，但不希望弹出键盘，则可以设置enableKeyboardOnfocus为false。

2、主动获取焦点

若组件本身有获焦能力，默认可获焦。以下方法直接使用；

若组件本身有获焦能力，默认不可获焦。可以添加onClick事件让组件可获焦；

• requestFocus

主动让焦点转移至参数指定的组件上

// 写法一【推荐写法】： 
// 更能保障焦点的主动获焦以及有错误码返回 
this.getUIContext().getFocusController().requestFocus("testButton") 
// 写法二： 
focusControl.requestFocus("width_input")

getFocusController是API12新增的UIContext上的方法，有错误码返回

Text(this.text) 
  .margin({ 
    top: 100 
  }) 
  .id('TextInput1') 
  .focusable(true) 
  .onFocus(() => { 
    console.log('Text 触发 走焦') 
  }) 
Button('设置焦点') 
  .margin({ 
    top: 200 
  }) 
  .onClick(() => { 
    this.getUIContext().getFocusController().requestFocus("TextInput1") 
  })

现象：用requestFocus即可让Text获取当前焦点，并触发焦点事件。

• focusOnTouch

设置当前组件是否支持点击获焦能力。若组件本身不可获焦，则此功能无效。

Text('focusable' )    // Text设置了focusable初始为true，focusableOnTouch为true 
  .borderColor(this.color2) 
  .borderWidth(2) 
  .width(300) 
  .height(70) 
  .focusable(true) 
  .focusOnTouch(true) 
  .onFocus(() => { 
    this.color2 = Color.Blue; 
  }) 
  .onBlur(() => { 
    this.color2 = Color.Yellow; 
  })

现象：焦点在Text上，触发了onFocus监听的获焦回调。

3、主动清除输入框焦点

方法一：设置当前获焦的输入框focusable为false，焦点会转移至页面内下一个可获焦节点。

方法二：clearFocus转移焦点至页面根节点。

清除当前层级页面中的焦点，最终焦点停留在根容器上

this.getUIContext().getFocusController().clearFocus()

4、监听走焦状态

onFocus：组件获取焦点时触发的回调

onBlur：组件失去焦点时触发的回调

一个节点获焦了，说的是它所在的焦点链获焦，也就是它和它的祖先节点都会触发onFocus。

定位FAQ

1、显隐切换时焦点控制

TextInput控件的defaultFocus为true时，进入包含该控件的界面就会自动获得焦点。如果该控件在自定义view中，view被if包裹控制显示隐藏，当显示时需要控件获得默认焦点需要怎么样处理？defaultFocus在此种场景不生效。

问题分析：没有理解defaultFocus触发走焦场景。defaultFocus只在页面初次创建且第一次进入才会生效。

解决办法：

// 组件显隐切换时主动控制组件走焦 
// 其中testButton为组件id，一定要确保id在应用里具有唯一性 
this.getUIContext().getFocusController().requestFocus('testButton')

2、主动获取焦点问题

问题分析：查看二级页面的焦点树，确定跳转到二级页面TextInput没有获焦。场景是版本升级后出现的问题。

解决办法：

二级页面的TextInput组件添加defaultFocus为true的属性，

或者在二级页面用 this.getUIContext().getFocusController().requestFocus('test') 主动获焦。

查看焦点状态

1、获取当前获焦窗口的winId

• 执行 hdc shell hidumper -s WindowManagerService -a '-a'

• 结果如下图，记住红框内的 Focus window ，在步骤2的命令中会用上​​​​​

2、输出普通应用焦点树

• 执行 hdc shell "hidumper -s WindowManagerService -a '-w  winId -focus'"

3、规则如下：

• 带* 号的节点都是当前获焦节点​​​​

• 带(-)的节点，表示该节点不可获焦

• 不带(-)的节点，表示该节点可获焦

查看焦点与键盘联动日志

实际更复杂的焦点场景，包括了焦点和窗口的联动、焦点唤醒键盘等

• 真机上测试，根据关键词AceFocus|AceKeyboard，过滤出焦点和键盘的日志
• 针对TextInput、TextArea等获焦与键盘联动的场景

  

查看焦点与键盘联动日志

实际更复杂的焦点场景，包括了焦点和窗口的联动、焦点唤醒键盘等

• 真机上测试，根据关键词AceFocus|AceKeyboard，过滤出焦点和键盘的日志

• 针对TextInput、TextArea等获焦与键盘联动的场景

最后

小编在之前的鸿蒙系统扫盲中，有很多朋友给我留言，不同的角度的问了一些问题，我明显感觉到一点，那就是许多人参与鸿蒙开发，但是又不知道从哪里下手，因为资料太多，太杂，教授的人也多，无从选择。有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以有一份实用的鸿蒙（HarmonyOS NEXT）文档用来跟着学习是非常有必要的。 

为了确保高效学习，建议规划清晰的学习路线，涵盖以下关键阶段：

 →【纯血版鸿蒙全套最新学习文档】希望这一份鸿蒙学习文档能够给大家带来帮助~

---

 鸿蒙（HarmonyOS NEXT）最新学习路线

​

该路线图包含基础技能、就业必备技能、多媒体技术、六大电商APP、进阶高级技能、实战就业级设备开发，不仅补充了华为官网未涉及的解决方案

路线图适合人群：

IT开发人员：想要拓展职业边界
零基础小白：鸿蒙爱好者，希望从0到1学习，增加一项技能。
技术提升/进阶跳槽：发展瓶颈期，提升职场竞争力，快速掌握鸿蒙技术

2.学习视频+学习PDF文档

HarmonyOS Next 最新全套视频教程 （鸿蒙语法ArkTS、TypeScript、ArkUI教程……）

​​

 纯血版鸿蒙全套学习文档（面试、文档、全套视频等）

                   

​​​​鸿蒙APP开发必备

​​

总结

【纯血版鸿蒙全套最新学习文档】

总的来说，华为鸿蒙不再兼容安卓，对程序员来说是一个挑战，也是一个机会。只有积极应对变化，不断学习和提升自己，才能在这个变革的时代中立于不败之地。