最受欢迎的三方库之 china_area
作者：桃花镇童长老
- 2025-06-26 安徽
本文字数：2414 字
阅读完需：约 8 分钟
china_area
🏆简介与推荐
china_area 中国区域数据，省市县三级数据。
harmony-utils一款功能丰富且极易上手的 HarmonyOS 工具库，借助众多实用工具类，致力于助力开发者迅速构建鸿蒙应用。
harmony-dialog一款极为简单易用的零侵入弹窗，仅需一行代码即可轻松实现，无论在何处都能够轻松弹出。
🌞下载安装
ohpm i @nutpi/china_areaOpenHarmony ohpm 环境配置等更多内容，请参考如何安装 OpenHarmony ohpm 包
📚API 详解 使用案例
📚示例代码
//获取省市县的JSON字符串let txtStr = await AreaHelper.getAreaStr();let areaList = JSONUtil.jsonToArray<AreaEntity>(txtStr);
//获取省市县的数据let areas = AreaHelper.getAreaSync();
//根据省名获取下面的市let citys = await AreaHelper.getCityByName("安徽省");
//根据市名获取下面的区县let list = AreaHelper.getDistrictByNameSync("合肥市");
//配合‘@pura/harmony-dialog’的\nshowTextPickerDialog()方法使用let data = AreaHelper.getAreaSync();DialogHelper.showTextPickerDialog({ title: "请选择", range: data, onChange: (value: string | string[], index: number | number[]) => { LogUtil.error(`value: ${value} --- index: ${index}`); }, onAction: (action: number, dialogId: string, value: string | string[]) => { if (action === DialogAction.SURE) { DialogHelper.showToast(`已选择：${value}`); } }});
复制代码
import { router } from '@kit.ArkUI';import { AreaEntity, AreaHelper } from '@nutpi/china_area';import { JSONUtil, LogUtil, StrUtil } from '@pura/harmony-utils';import { TitleBarView } from '../../component/TitleBarView';import { DescribeBean } from '../../model/DescribeBean';import { JSON } from '@kit.ArkTS';import { DialogAction, DialogHelper } from '@pura/harmony-dialog';
/** * @nutpi/china_area，使用案例 */@Entry@ComponentV2export struct ChinaAreaPage { private scroller: Scroller = new Scroller(); @Local describe: DescribeBean = router.getParams() as DescribeBean; @Local txtStr: string = "";
build() { Column() { TitleBarView({ describe: this.describe }) Divider() Scroll(this.scroller) { Column({ space: 5 }) { Button("getAreaStr()") .btnStyle() .onClick(async () => { this.txtStr = await AreaHelper.getAreaStr(); let data = JSONUtil.jsonToArray<AreaEntity>(this.txtStr); DialogHelper.showToast(`${data.length}`); }) Button("getAreaStr()") .btnStyle() .onClick(async () => { let list = await AreaHelper.getArea(); LogUtil.error(`长度：${list.length}`); this.txtStr = JSON.stringify(list,null,2); }) Button("getCityByName()") .btnStyle() .onClick(async () => { let citys = await AreaHelper.getCityByName("安徽省"); this.txtStr = JSON.stringify(citys, null, 2); }) Button("getDistrictByNameSync()") .btnStyle() .onClick(() => { let list = AreaHelper.getDistrictByNameSync("合肥市"); this.txtStr = JSON.stringify(list, null, 2); }) Button("配合‘@pura/harmony-dialog’的\nshowTextPickerDialog()方法使用") .labelStyle({ maxLines: 3 }) .padding({ top: 10, bottom: 10 }) .btnStyle() .onClick(() => { this.txtStr = ""; let data = AreaHelper.getAreaSync(); DialogHelper.showTextPickerDialog({ title: "请选择", range: data, onChange: (value: string | string[], index: number | number[]) => { LogUtil.error(`value: ${value} --- index: ${index}`); }, onAction: (action: number, dialogId: string, value: string | string[]) => { if (action === DialogAction.SURE) { DialogHelper.showToast(`已选择：${value}`); } } }); })
Blank().layoutWeight(1)
Text(this.txtStr) .visibility(StrUtil.isNotEmpty(this.txtStr) ? Visibility.Visible : Visibility.None) .textStyle()
Blank().layoutWeight(1) } .margin({ top: 5, bottom: 5 }) } .layoutWeight(1) } .width('100%') .height('100%') .backgroundColor($r('app.color.main_background')) }}
@Stylesfunction btnStyle() { .width('90%') .margin({ top: 10, bottom: 5 })}
@Stylesfunction textStyle() { .width('95%') .padding(10) .shadow(ShadowStyle.OUTER_DEFAULT_XS) .margin({ top: 5, bottom: 10 }) .border({ width: 1, color: Color.Grey, radius: 10, style: BorderStyle.Dashed })}复制代码
🍎沟通与交流🙏
使用过程中发现任何问题都可以提 Issue给我们；
当然，我们也非常欢迎你给我们发 PR 。
🌏开源协议
本项目基于 Apache License 2.0 ，在拷贝和借鉴代码时，请大家务必注明出处。
划线
评论
复制
发布于: 2025-06-26阅读数: 411
桃花镇童长老
关注
还未添加个人签名 2025-05-14 加入
还未添加个人简介
评论