介绍

本示例介绍城市选择场景的使用：通过AlphabetIndexer实现首字母快速定位城市的索引条导航。

效果图预览

使用说明

分两个功能

• 在搜索框中可以根据城市拼音模糊搜索出相近的城市，例如输入"a"，会出现"阿尔山"、“阿勒泰地区”、“安庆”、“安阳”。
• 下方城市列表通过AlphabetIndexer组件实现拼音索引条，通过滑动选择城市首拼，快速定位相关首拼城市。

实现思路

场景：通过AlphabetIndexer实现索引条导航

城市列表中的右侧首拼索引条，通过AlphabetIndexer组件实现首字母快速定位城市的索引条导航。

• 通过AlphabetIndexer的selected属性与城市列表中List组件onScrollIndex事件绑定，源码参考

AlphabetIndexer({ arrayValue: TAB_VALUE, selected: this.stabIndex })
  .height('100%')
  .selectedColor($r('app.color.alphabet_select_color')) // 选中项文本颜色
  .popupColor($r('app.color.alphabet_pop_color')) // 弹出框文本颜色
  .selectedBackgroundColor($r('app.color.alphabet_selected_bgc')) // 选中项背景颜色
  .popupBackground($r('app.color.alphabet_pop_bgc')) // 弹出框背景颜色
  .popupPosition({ x: $r('app.integer.pop_position_x'), y: $r('app.integer.pop_position_y') })
  .usingPopup(true) // 是否显示弹出框
  .selectedFont({ size: $r('app.integer.select_font'), weight: FontWeight.Bolder }) // 选中项字体样式
  .popupFont({ size: $r('app.integer.pop_font'), weight: FontWeight.Bolder }) // 弹出框内容的字体样式
  .alignStyle(IndexerAlign.Right) // 弹出框在索引条左侧弹出
  .onSelect((tabIndex: number) => {
    this.scroller.scrollToIndex(tabIndex);
  })

• 当用户滑动List组件，list组件onScrollIndex监听到firstIndex的改变，绑定赋值给AlphabetIndexer的selected属性，从而定位到字母索引。
• 当点击AlphabetIndexer的字母索引时，通过scrollToIndex触发list组件滑动并指定firstIndex，从而实现List列表与AlphabetIndexer组件首字母联动吸顶展示，源码参考。

List({ space: 14, initialIndex: 0, scroller: this.scroller }) {
  .onScrollIndex((firstIndex: number, lastIndex: number) => {
     this.stabIndex = firstIndex;
  })
}

高性能知识点

由于需要通过搜索按钮频繁的控制自定义组件的显隐状态，源码详见，因此推荐使用显隐控制替代条件渲染，参考合理选择条件渲染和显隐控制文章。

工程结构&模块类型

citysearch                                      // har类型
|---src/main/ets/view
|   |---CitySearch.ets                          // 视图层-主页 
|   |---CityView.ets                            // 视图层-城市列表组件
|   |---SearchView.ets                          // 视图层-搜索组件
|---src/main/ets/model
|   |---DetailData.ets                          // 模型层-数据模块 

模块依赖

依赖har包-common库中UX标准

参考资料

AlphabetIndexer参考文档

为了能让大家更好的学习鸿蒙（HarmonyOS NEXT）开发技术，这边特意整理了《鸿蒙开发学习手册》（共计890页），希望对大家有所帮助：https://qr21.cn/FV7h05

《鸿蒙开发学习手册》：

如何快速入门：https://qr21.cn/FV7h05

1. 基本概念
2. 构建第一个ArkTS应用
3. ……

开发基础知识：https://qr21.cn/FV7h05

1. 应用基础知识
2. 配置文件
3. 应用数据管理
4. 应用安全管理
5. 应用隐私保护
6. 三方应用调用管控机制
7. 资源分类与访问
8. 学习ArkTS语言
9. ……

基于ArkTS 开发：https://qr21.cn/FV7h05

1. Ability开发
2. UI开发
3. 公共事件与通知
4. 窗口管理
5. 媒体
6. 安全
7. 网络与链接
8. 电话服务
9. 数据管理
10. 后台任务(Background Task)管理
11. 设备管理
12. 设备使用信息统计
13. DFX
14. 国际化开发
15. 折叠屏系列
16. ……

鸿蒙开发面试真题（含参考答案）：https://qr21.cn/FV7h05

腾讯T10级高工技术，安卓全套VIP课程全网免费送：https://qr21.cn/D2k9D5