摘要：省市區數據工具包，含有省市區三級數據，支持排序和自定義返回的數據屬性。臺灣香港澳門的數據中相同。默認返回數據對象的全部屬性，支持傳數組或對象，數組元素或對象屬性必須為數據對象中的屬性。地市，必填參數。

https://github.com/cq0122/province-city-area

省市區數據工具包，含有省市區三級數據，支持排序和自定義返回的數據屬性。

$npm install province-city-area --save

province、area 的區號為 null，city 的區號不為空。

臺灣、香港、澳門的 city 數據中 name、full_name、short_name 相同。

數據為個人整理，難免有遺漏和疏忽，如有錯誤，歡迎指正，謝謝。

getProvinces(field, sort)

filed 返回數組元素的屬性，可選參數。默認返回數據對象的全部屬性，支持傳數組或對象，數組元素或對象屬性必須為數據對象中的屬性。例如：["id", "name", "pinyin"]，則返回[{id:"xx1",name:"xx1",pinyin:"xx1"},{id:"xx2",name:"xx2",pinyin:"xx2"}...]。同時也支持傳對象參數更改返回值的對象屬性，例如：{id:"value",name:"label"}，則返回[{value:"xx1",label:"xx1"},{value:"xx2",label:"xx2"}...]。

sort 字段和排序規則對象，可選參數。默認按 id 升序。例如：{id:"desc",pinyin:"desc"}，排序對象的屬性必須為數據對象中的屬性，屬性定義的順序影響排序的結果，值為 asc 或 desc。

getCitys(pid, field, sort)

pid 省 id，必填參數。

filed，參考 getProvinces。

sort，參考 getProvinces。

getAreas(pid, field, sort)

pid 地市 id，必填參數。

filed，參考 getProvinces。

sort，參考 getProvinces。

import { getProvinces, getCitys, getAreas } from "province-city-area";

getProvinces({ id: "key", name: "label" }, { pinyin: "asc" });
//=> [{"key":"34","label":"安徽"},{"key":"82","label":"澳門"},{"key":"11","label":"北京"},{"key":"50","label":"重慶"},{"key":"35","label":"福建"},{"key":"62","label":"甘肅"},{"key":"44","label":"廣東"},{"key":"45","label":"廣西"},{"key":"52","label":"貴州"},{"key":"46","label":"海南"},{"key":"13","label":"河北"},{"key":"41","label":"河南"},{"key":"23","label":"黑龍江"},{"key":"42","label":"湖北"},{"key":"43","label":"湖南"},{"key":"22","label":"吉林"},{"key":"32","label":"江蘇"},{"key":"36","label":"江西"},{"key":"21","label":"遼寧"},{"key":"15","label":"內蒙古"},{"key":"64","label":"寧夏"},{"key":"63","label":"青海"},{"key":"37","label":"山東"},{"key":"14","label":"山西"},{"key":"61","label":"陜西"},{"key":"31","label":"上海"},{"key":"51","label":"四川"},{"key":"71","label":"臺灣"},{"key":"12","label":"天津"},{"key":"54","label":"西藏"},{"key":"81","label":"香港"},{"key":"65","label":"新疆"},{"key":"53","label":"云南"},{"key":"33","label":"浙江"}]

getCitys(42, { id: "i", name: "n" });
//=> [{"i":"4201","n":"武漢"},{"i":"4202","n":"黃石"},{"i":"4203","n":"十堰"},{"i":"4205","n":"宜昌"},{"i":"4206","n":"襄陽"},{"i":"4207","n":"鄂州"},{"i":"4208","n":"荊門"},{"i":"4209","n":"孝感"},{"i":"4210","n":"荊州"},{"i":"4211","n":"黃岡"},{"i":"4212","n":"咸寧"},{"i":"4213","n":"隨州"},{"i":"4228","n":"恩施"},{"i":"429004","n":"仙桃"},{"i":"429005","n":"潛江"},{"i":"429006","n":"天門"},{"i":"429021","n":"神農架"}]

getCitys(42, ["id", "name"]);
//=> [{"id":"4201","name":"武漢"},{"id":"4202","name":"黃石"},{"id":"4203","name":"十堰"},{"id":"4205","name":"宜昌"},{"id":"4206","name":"襄陽"},{"id":"4207","name":"鄂州"},{"id":"4208","name":"荊門"},{"id":"4209","name":"孝感"},{"id":"4210","name":"荊州"},{"id":"4211","name":"黃岡"},{"id":"4212","name":"咸寧"},{"id":"4213","name":"隨州"},{"id":"4228","name":"恩施"},{"id":"429004","name":"仙桃"},{"id":"429005","name":"潛江"},{"id":"429006","name":"天門"},{"id":"429021","name":"神農架"}]

getAreas(4213);
//=> [{"fullName":"曾都區","id":"421303","name":"曾都","pinyin":"zeng_du","pinyinInitial":"Z"},{"fullName":"隨縣","id":"421321","name":"隨縣","pinyin":"sui_xian","pinyinInitial":"S"},{"fullName":"廣水市","id":"421381","name":"廣水","pinyin":"guang_shui","pinyinInitial":"G"}]

orderBy(collection, sort)：數組對象排序方法，支持多個屬性排序，支持中文排序。

collection 對象數組。

sort 字段和排序規則對象，排序對象的屬性必須為數據對象中的屬性，屬性定義的順序影響排序的結果，值為 asc 或 desc。

import { orderBy } from "province-city-area";
const students = [
    {"id":"11","name":"劉一","total":700,"en":150,"pe":"C"},
    {"id":"12","name":"陳二","total":700,"en":149,"pe":"B"},
    {"id":"13","name":"張三","total":700,"en":149,"pe":"A"},
    {"id":"14","name":"李四","total":700,"en":149,"pe":"A"},
    {"id":"15","name":"王五","total":720,"en":150,"pe":"A"},
    {"id":"16","name":"趙六","total":700,"en":150,"pe":"A"},
    {"id":"17","name":"孫七","total":700,"en":149,"pe":"A"},
    {"id":"18","name":"周八","total":700,"en":150,"pe":"B"},
    {"id":"19","name":"吳九","total":720,"en":149,"pe":"A"},
    {"id":"20","name":"鄭十","total":720,"en":150,"pe":"B"}
];

orderBy(students, { total: "desc", en: "asc" });
//=>[{"id":"19","name":"吳九","total":720,"en":149,"pe":"A"},
//=> {"id":"15","name":"王五","total":720,"en":150,"pe":"A"},
//=> {"id":"20","name":"鄭十","total":720,"en":150,"pe":"B"},
//=> {"id":"12","name":"陳二","total":700,"en":149,"pe":"B"},
//=> {"id":"13","name":"張三","total":700,"en":149,"pe":"A"},
//=> {"id":"14","name":"李四","total":700,"en":149,"pe":"A"},
//=> {"id":"17","name":"孫七","total":700,"en":149,"pe":"A"},
//=> {"id":"11","name":"劉一","total":700,"en":150,"pe":"C"},
//=> {"id":"16","name":"趙六","total":700,"en":150,"pe":"A"},
//=> {"id":"18","name":"周八","total":700,"en":150,"pe":"B"}]

orderBy(students, { pe: "asc", name: "asc" });
//=>[{"id":"14","name":"李四","total":700,"en":149,"pe":"A"},
//=> {"id":"17","name":"孫七","total":700,"en":149,"pe":"A"},
//=> {"id":"15","name":"王五","total":720,"en":150,"pe":"A"},
//=> {"id":"19","name":"吳九","total":720,"en":149,"pe":"A"},
//=> {"id":"13","name":"張三","total":700,"en":149,"pe":"A"},
//=> {"id":"16","name":"趙六","total":700,"en":150,"pe":"A"},
//=> {"id":"12","name":"陳二","total":700,"en":149,"pe":"B"},
//=> {"id":"20","name":"鄭十","total":720,"en":150,"pe":"B"},
//=> {"id":"18","name":"周八","total":700,"en":150,"pe":"B"},
//=> {"id":"11","name":"劉一","total":700,"en":150,"pe":"C"}]

Hope you will like !