README

DaData的jQuery小部件包装器

安装

1. 下载

安装此扩展的首选方法是通过 composer。

运行以下命令

$ composer require corpsepk/yii2-dadata-suggestions-widget:~0.3

2. 获取API密钥

在 DaData.ru 注册，并获取API密钥。

3. 配置（可选）

如果您不想在每次小部件中使用API密钥，可以设置容器定义。将以下行添加到主配置文件中

'container' => [
    'definitions' => [
        'corpsepk\DaData\SuggestionsWidget' => [
            'token' => 'my-dadata-api-key',
        ],
    ],
],

使用方法

use corpsepk\DaData\SuggestionsWidget;

<?= SuggestionsWidget::widget([
    'model' => $model,
    'attribute' => 'inn',
    'token' => 'your apiKey'
]) ?>

以下示例将使用name属性

<?= SuggestionsWidget::widget([
    'name' => 'inn',
    'token' => 'your apiKey'
]) ?>

您还可以使用此小部件在 yii\widgets\ActiveForm 中，通过 yii\widgets\ActiveField::widget() 方法，例如如下

<?= $form->field($model, 'inn')->widget(SuggestionsWidget::class, [
    'token' => 'your apiKey'
]) ?>

有用链接

DaData - https://dadata.ru
jQuery插件选项 - https://confluence.hflabs.ru/pages/viewpage.action?pageId=466681916
提示 - https://dadata.userecho.com/topics/2090

测试

$ ./vendor/bin/phpunit

nikovonlas / yii2-dadata-suggestions-widget

维护者

详细信息