最受欢迎的三方库之china_area
2025-06-24 22:28:32
105次阅读
0个评论
china_area
🏆简介与推荐
china_area 中国区域数据,省市县三级数据。
harmony-utils 一款功能丰富且极易上手的HarmonyOS工具库,借助众多实用工具类,致力于助力开发者迅速构建鸿蒙应用。
harmony-dialog 一款极为简单易用的零侵入弹窗,仅需一行代码即可轻松实现,无论在何处都能够轻松弹出。
🌞下载安装
ohpm i @nutpi/china_area
OpenHarmony ohpm 环境配置等更多内容,请参考如何安装 OpenHarmony ohpm 包
📚API详解 使用案例
AreaHelper方法 | 介绍 |
---|---|
getAreaStrSync getAreaStr |
获取省市县的JSON字符串 |
getAreaSync getArea |
获取省市县的数据 |
getCityByNameSync getCityByName |
根据省名获取下面的市 |
getDistrictByNameSync getDistrictByName |
根据市名获取下面的区县 |
📚示例代码
//获取省市县的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}`);
}
}
});
🍎沟通与交流🙏
使用过程中发现任何问题都可以提 Issue给我们;
当然,我们也非常欢迎你给我们发 PR 。
🌏开源协议
本项目基于 Apache License 2.0 ,在拷贝和借鉴代码时,请大家务必注明出处。
00