README

描述

此扩展允许您快速将功能齐全的模态表单添加到您的应用程序中。主要功能包括

基于 Bootstrap 模态表单。
允许快速添加与模态对话框中查看和更新数据交互的行为。
捕获表单提交事件，将其转换为 AJAX 请求，并在同一模态对话框中显示结果。

安装

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

要安装，请运行

$ php composer.phar require conquer/modal "*"

或将其添加到您的 composer.json 文件的 require 部分：

"conquer/modal": "*"

用法

在主布局的某处

\conquer\modal\ModalForm::widget([
    'selector' => '.modal-form',
]);

您想要给标签 a 添加行为时，只需添加类 'modal-form'

    echo Html::a('Some modal action', ['controller/action'], ['class' => 'modal-form']);

为了改善流量数据和错误异常，您需要在 AJAX 请求时控制布局渲染。我建议您在控制器中覆盖默认的渲染。

class Controller extends \yii\web\Controller
{
    /**
     * Exclude layout rendering when ajax requests
     */
    public function render($view, $params = [])
    {
        if (\Yii::$app->request->isAjax) {
            return $this->renderPartial($view, $params);
        }
        return parent::render($view, $params);
    }
}

客户端选项

要添加客户端选项，请使用 clientOptions 键。可用的客户端选项有：id、class、tabindex。

Id 键替换现有的自动生成的 id 属性。
Class 键添加类到 HTML 类属性。
Tabindex 键替换现有的默认 tabindex HTML 属性 (-1)，当为 false 时，则不出现 tabindex 属性。

\conquer\modal\ModalForm::widget([
    'selector' => '.modal-form',
    'clientOptions' => [
        'id' => 'sample-unique-id',
        'class' => 'sample-class1 sample-class2',
        'tabindex' => false
    ]
]);

许可证

conquer/modal 在 MIT 许可证下发布。有关详细信息，请参阅捆绑的 LICENSE 文件。

conquer / modal

维护者

详情

README

描述

安装

用法

客户端选项

许可证