prodcd/yii2-region

Yii2中国省市区三级联动

1.0 2022-12-20 10:56 UTC

Requires

• yiisoft/yii2: *

BSD-3-Clause

• region
• city
• yii2
• province
• district

README

Yii2 中国省市区三级联动(https://github.com/prodcd/yii2-region)

安装

添加到你的composer.json文件

"prodcd/yii2-region": "dev-master"

配置

1、在地区的Model中添加以下方法

    public static function getRegion($parentId=0)
    {
        $result = static::find()->where(['parent_id'=>$parentId])->asArray()->all();
        return ArrayHelper::map($result, 'id', 'name');
    }

2、在controller中添加以下action

    public function actions()
    {
        $actions=parent::actions();
        $actions['get-region']=[
            'class'=>\prodcd\region\RegionAction::className(),
            'model'=>\app\models\Region::className()
        ];
        return $actions;
    }

3、启用urlManager的enablePrettyUrl的，即隐藏index.php

使用

$url=\yii\helpers\Url::toRoute(['get-region']);

echo $form->field($model, 'province')->widget(\prodcd\region\Region::className(),[
    'model'=>$model,
    'url'=>$url,
    'province'=>[
        'attribute'=>'province',
        'items'=>Region::getRegion(),
        'options'=>['class'=>'form-control form-control-inline','prompt'=>'选择省份']
    ],
    'city'=>[
        'attribute'=>'city',
        'items'=>Region::getRegion($model['province']),
        'options'=>['class'=>'form-control form-control-inline','prompt'=>'选择城市']
    ],
    'district'=>[
        'attribute'=>'district',
        'items'=>Region::getRegion($model['city']),
        'options'=>['class'=>'form-control form-control-inline','prompt'=>'选择县/区']
    ]
]);

province为省份配置，可用的选项可以查看Html::dropdownList。如果不需要县/区，可以把district删除。

demo