README

yii2-widget-activeform      

扩展并增强了 Yii ActiveForm widget。简化了 Bootstrap 中所有三种表单布局的设置，即 垂直、水平 和 内联。允许在水平表单布局中对标签和输入进行偏移。与扩展的 ActiveField 组件紧密协作。此外，此扩展还增强并扩展了 Yii ActiveField 组件。允许将 Bootstrap 样式的 输入组附加组件 预加或后加到文本输入框中。根据上下文状态实现输入中的 反馈图标。自动调整水平表单中的复选框和单选输入框的偏移量。允许根据表单布局样式（例如，隐藏标签并显示为内联表单的占位符）控制标签和占位符。扩展的 ActiveField 功能包括

• 附加组件
  • 预加附加组件
  • 后加附加组件
  • 图标附加组件
  • 输入附加组件
  • 按钮附加组件
  • 按钮下拉附加组件
  • 分段按钮附加组件
  • 预加和后加
  • 输入组设置
  • 多个附加组件配置（自 v1.4.9 以来新增）
• 输入反馈图标
• 输入提示管理
• 输入
  • 复选框
  • 单选框
  • 复选框列表
  • 单选框列表
  • 静态输入
  • HTML 5 输入
  • 复选框按钮组
  • 单选按钮组
• 多选
  • 垂直表单
  • 水平表单
  • 单选框列表
  • 显示选项

注意：此扩展是 yii2-widgets 的子仓库分离出来的。自 2014 年 11 月 8 日起进行分离，以便开发者在需要时可以单独安装此特定小部件。也可以以前的方式使用此扩展，与 yii2-widgets 的整个套件一起使用。

安装

安装此扩展的首选方法是使用 composer。请查看此扩展的需求和依赖项，见 composer.json。阅读有关为您的应用设置 minimum-stability 的 网络提示。

安装方法如下：

$ php composer.phar require kartik-v/yii2-widget-activeform "@dev"

或者将以下内容添加到您的 composer.json 文件的 require 部分中：

"kartik-v/yii2-widget-activeform": "@dev"

到

发布更改

注意：有关各个版本更改的详细信息，请参阅 变更日志。

演示

以下链接提供了详细文档和演示，您可以了解扩展的使用方法：

• ActiveForm
• ActiveField
• Html5Input

使用方法

ActiveForm

// add this in your view
use kartik\form\ActiveForm;

// Vertical Form
$form = ActiveForm::begin([
    'id' => 'form-signup',
    'type' => ActiveForm::TYPE_VERTICAL
]);

// Inline Form
$form = ActiveForm::begin([
    'id' => 'form-login', 
    'type' => ActiveForm::TYPE_INLINE,
    'fieldConfig' => ['autoPlaceholder'=>true]
]);

// Horizontal Form Configuration
$form = ActiveForm::begin([
    'id' => 'form-signup', 
    'type' => ActiveForm::TYPE_HORIZONTAL,
    'formConfig' => ['labelSpan' => 3, 'deviceSize' => ActiveForm::SIZE_SMALL]
]);

ActiveField

// Implement a feedback icon
echo $form->field($model, 'email_2', [
    'feedbackIcon' => [
        'default' => 'envelope',
        'success' => 'ok',
        'error' => 'exclamation-sign',
        'defaultOptions' => ['class'=>'text-primary']
    ]
])->textInput(['placeholder'=>'Enter a valid email address...']);

// Prepend an addon text
echo $form->field($model, 'email', ['addon' => ['prepend' => ['content'=>'@']]]);

// Append an addon text
echo $form->field($model, 'amount_paid', [
    'addon' => ['append' => ['content'=>'.00']]
]);

// Formatted addons (like icons)
echo $form->field($model, 'phone', [
    'addon' => [
        'prepend' => [
            'content' => '<i class="fas fa-phone"></i>'
        ]
    ]
]);

// Formatted addons (inputs)
echo $form->field($model, 'phone', [
    'addon' => [
        'prepend' => [
            'content' => '<input type="radio">'
        ]
    ]
]);

// Formatted addons (buttons)
echo $form->field($model, 'phone', [
    'addon' => [
        'prepend' => [
            'content' => Html::button('Go', ['class'=>'btn btn-primary']),
            'asButton' => true
        ]
    ]
]);

许可证

yii2-widget-activeform 采用 BSD-3-Clause 许可证发布。有关详细信息，请参阅捆绑的 LICENSE.md 文件。