前言

最近在日常開發過程中，需要實現城市選擇功能，同時支持模糊搜索。看似簡單的功能動手實現起來卻有很多難點。本篇文章詳細記錄開發過程中遇到的問題和對應的解決方法，希望能夠幫助你，建議點贊收藏！

實現效果

需求分析

處理城市列表中的多音字。
城市列表要按照字母表的順序排列
將首字母相同的城市分組。

技術實現

在日常開發中，城市數據一般由接口獲取或從本地 json 文件讀取，畢竟城市數量和城市編碼是固定不變的。不管是哪種方式獲取城市數據，都無法保證數據的順序符合需求，在處理數據順序之前，首先要處理數據中的多音字，對常見多音字手動添加拼音字母，其余城市直接獲取首字母，這里需要借助一個三方庫pinyin4js 獲取漢字的第一個拼音字母。

data?.forEach((city) = > {
            if (city.cityName?.includes("長沙")) {
              city.letter = "CHANGSHASHI"
            } else if (city.cityName?.startsWith("重慶")) {
              city.letter = "CHONGQING"
            } else if (city.cityName?.startsWith("廈門")) {
              city.letter = "XIAMENSHI"
            } else {
              city.letter = pinyin4js.convertToPinyinString(city.cityName, '', pinyin4js.FIRST_LETTER).toUpperCase()
            }

          })

得到城市的字母后，這時就需要對城市數據按字母排序進行處理，借助系統通過collator 類的 compare 方法，對數據的字母進行排序。

let collator = new intl.Collator();
        data.sort((firstCity: HotCityBean, secondCity: HotCityBean) = > {
          return collator.compare(firstCity.letter, secondCity.letter)
        })

得到排序后的數據，需要對數據進行分組，將首字母相同的城市放在同一個數組里，這一步有點復雜，需要慢慢看。

let target = data[0].letter?.charAt(0) ?? ""
        let cityType = new HotCityTypeBean()
        cityType.name = target;
        data.forEach((value, number) = > {
          if (value.letter?.charAt(0) != target) {
            this.cityList.push(cityType)
            target = value.letter?.charAt(0) ?? ""
            cityType = new HotCityTypeBean()
            cityType.name = target
            cityType.city.push(value)
          } else {
            cityType.city.push(value)
          }
      
          .......
        })

**首先得到第一條城市的首字母 A 作為目標項，然后使用 forEach 遍歷數據，如果遍歷的對象的首字母和目標項 A 不相等，則先認為首字母 A 的城市遍歷結束，直接將相同字母 A 的數據放入集合，否則將相同字母 A 的數據放在一起(cityType.city.push(value))。 **

遍歷到最后一條數據時，需要對最后一條數據進行處理，結束后將最后一個字母相同的數據存入城市集合。

if (number == data.length - 1) {
            if (!cityType.city.includes(value)) {
              cityType.city.push(value)
            }
            this.cityList.push(cityType)
          }

經過以上對數據的處理，終于得到了完整的城市數據，接下來就是直接展示列表即可。

List({ space: 14, initialIndex: 0, scroller: this.scroller }) {
          ForEach(this.cityList, (bean: HotCityTypeBean, index: number) = > {
            if (index == 0) {
              ListItem() {
                Text() {
                  Span("當前城市: ")
                    .fontSize($r("app.float.sp_t5"))
                    .fontColor($r("app.color.color_S5"))
                  Span(this.cityName)
                    .fontSize($r("app.float.sp_t5"))
                    .fontColor($r("app.color.color_S7"))
                }
              }.margin({ top: $r("app.float.vp_10") })

            }
            ListItemGroup({ header: this.headView(bean.name) }) {
              ForEach(bean.city, (item: HotCityBean, childIndex: number) = > {
                ListItem() {
                  Column() {
                    Text(`${item.cityName}`)
                      .height(44)
                      .fontSize($r('app.float.sp_t4'))
                      .width(FULL_WIDTH)
                      .onClick(() = > {
                       
                      })
                    if (childIndex == bean.city.length - 1) {
                      Divider()
                        .color($r('app.color.color_S3'))
                        .height(0.5)
                        .vertical(false)
                    }
                  }.alignItems(HorizontalAlign.Start)
                }
              }, (item: HotCityBean, childIndex: number) = > `${childIndex}${new Date()}`)
            }
          }, (bean: HotCityTypeBean, index: number) = > `${index}${new Date()}`)
        } .sticky(StickyStyle.Header)