README

DaData的jQuery插件的包装器

安装

1. 下载

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

运行以下命令

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

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'
]) ?>

以下示例将使用名称属性

<?= 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://github.com/hflabs/suggestions-jquery
jQuery插件选项 - https://confluence.hflabs.ru/pages/viewpage.action?pageId=204669097
提示 - https://dadata.userecho.com/topics/2090

测试

$ ./vendor/bin/phpunit

corpsepk / yii2-dadata-suggestions-widget

维护者

详细信息