zh-address-parse

China's delivery address parse
===========

New Feature

> 增加自定义解析国家统计局数据，数据更新至 2020-11-20，代码：https://github.com/ldwonday/zh-address-parse/blob/master/app/lib/getMcaGovData.js

Preview

Test page

Syntax

> AddressParse(address[, [option|0|1]])

option可选参数属性列表

|参数名| 说明 | 类型 | 是否必填 | 默认值 |
|----|----------|------------------------------------------------------------|------|-----|
|type| 解析方式 | Number | 否 | 0 |
|textFilter| 预过滤字段 | Array | 否 | [] |
|nameMaxLength| 中文名最大长度 | Number | 否 | 4 |
|extraGovData| 额外的省市区数据 | { city?: GovData[]; area: GovData[]; province: GovData[] } | 否 | - |

extraGovData 定义如下：

``ts
type GovData = {
code: string;
provinceCode?: string;
cityCode?: string;
name: string;
}
`

Usage


> npm
`sh
npm i zh-address-parse -s

import AddressParse from 'zh-address-parse'
`
> import

`js
import AddressParse from './dist/zh-address-parse.min.js'
// options为可选参数，不传默认使用正则查找
const options = {
type: 0, // 哪种方式解析，0：正则，1：树查找
textFilter: [], // 预清洗的字段
nameMaxLength: 4, // 查找最大的中文名字长度
extraGovData: { city: [{ name: 'name', code: 'code', provinceCode: 'provinceCode' }], province: [{ name: 'name', code: 'code' }], area: [{ name: 'name', code: 'code', provinceCode: 'provinceCode', cityCode: 'cityCode' }] }
}
// type参数0表示使用正则解析，1表示采用树查找, textFilter地址预清洗过滤字段。
const parseResult = AddressParse('your address', options)
// The parseResult is an object contain { province: '', name: '', city: '', area: '', detail: '', phone: '', postalCode: '' }
`
> script引入

`html


`

Setup


Install dependencies
`sh
$ npm install
`

Development

Run the local webpack-dev-server with livereload and autocompile on http://localhost:8080/
`sh
$ npm run dev
`

Deployment

Build the current application
`sh
$ npm run build
``

Donate

> 您的支持是我前进的动力，更好的支持开源事业！~

Developed with Open Source Licensed WebStorm