https://github.com/xieyezi/xyz-city-picker
flutter 地址选择器
https://github.com/xieyezi/xyz-city-picker
addresspicker dart flutter flutter-apps flutter-package flutter-ui
Last synced: about 2 months ago
JSON representation
flutter 地址选择器
- Host: GitHub
- URL: https://github.com/xieyezi/xyz-city-picker
- Owner: xieyezi
- License: mit
- Created: 2020-07-15T09:01:20.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2021-05-31T03:45:50.000Z (almost 4 years ago)
- Last Synced: 2025-04-13T12:28:22.611Z (about 2 months ago)
- Topics: addresspicker, dart, flutter, flutter-apps, flutter-package, flutter-ui
- Language: Dart
- Homepage: https://pub.dev/packages/xyz_city_picker/versions/2.0.0-nullsafety.0
- Size: 1.84 MB
- Stars: 16
- Watchers: 2
- Forks: 6
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# xyz_city_picker
### 已经迁移至空安全
一个支持地图四级下钻的地址选择器
### 效果预览
### 如何使用
#### 添加xyz_city_picker
打开pubspec.yaml文件
添加如下代码
``` dart
xyz_city_picker : ^2.0.0-nullsafety
```
添加后打开`Terminal`，执行 `flutter packages get`
#### 代码中引入
```dart
import 'package:xyz_city_picker/xyz_city_picker.dart';
```
#### 使用
**建议先clone下仓库，查看example目录的示例**
必须传入的参数有:
| 参数 | 含义 | 类型 | 例 |
| ----------- | ---------- | ------------- | ------------- |
| province | 选择的省份 | Map | {'name': '', 'id': ''} |
| city | 选择的城市 | Map | {'name': '', 'id': ''} |
| district | 选择的区县 | Map | {'name': '', 'id': ''} |
| street | 选择的街道 | Map | {'name': '', 'id': ''} |
代码使用如下：
```dart
GestureDetector(
behavior: HitTestBehavior.translucent,
onTap: () => XYZCityPicker.showPicker(
province: province,
city: city,
district: district,
street: street,
context: context,
onChange: (int index, Map checkedItem) {
switch (index) {
case 0:
province = checkedItem;
break;
case 1:
city = checkedItem;
break;
case 2:
district = checkedItem;
break;
case 3:
street = checkedItem;
break;
}
setState(() {});
}),
child: Container()
)
```
在`onChanged`回调函数里面把选择的值带回，`onChanged`的函数签名如下：
```dart
typedef OnChange = Function(int index, Map checkedItem);
```
其中`index` 为`0`、`1`、`2`、`4`，分别标识`province`、`city`、`district`、`street` ，`checkedItem`则为选择的值.