kartik-v / yii2-field-range
使用Bootstrap 3插件标记轻松管理Yii 2 ActiveField范围(从/到)
v1.3.5
2019-05-25 07:21 UTC
Requires
- kartik-v/yii2-helpers: >=1.3.9
- kartik-v/yii2-widget-activeform: >=1.5.7
This package is auto-updated.
Last update: 2024-08-25 18:57:13 UTC
README
yii2-field-range
这是一个Yii 2扩展,允许您轻松使用Bootstrap 3插件标记设置ActiveField范围字段。这允许您将属性组合在一起作为一个单独的字段,使用bootstrap插件分隔它们。此外,它还允许您将字段验证错误消息显示为一个单独的块,而不是两个字段的单独验证错误。
注意
- FieldRange验证例程只显示验证中遇到的第一个错误。
- 要了解使用此扩展设置模型验证规则时如何设置属性,请参考这篇维基
此小部件扩展支持的关键功能包括
- 使用Bootstrap 3插件将两个范围字段显示为一个单独的分组块
- 调整yii active form验证,以显示验证错误作为一个单独的块,而不是每个字段下的单独错误块。这允许您更好地为各种表单布局样式化字段范围输入。不再由于yii验证错误消息而导致相邻字段错位。
- 可以使用yii\helpers中的任何输入或任何小部件类来渲染从和到字段。
- 通过增强使用
\kartik\widgets\ActiveField
,允许您添加自定义插件到输入前缀和后缀。 - 默认支持所有
\kartik\widgets
下的小部件。对\kartik\widgets\DatePicker
的特殊增强支持以渲染日期范围。 - 可以使用kartik\datecontrol\DateControl小部件,它可以进一步使用任何日期或时间小部件。
演示
您可以在这里找到有关使用此扩展的详细说明和演示。
发布更改
注意:有关各种版本更改的详细信息,请参阅变更日志
安装
安装此扩展的最佳方式是通过composer。
注意:请检查此扩展的composer.json以了解其要求和依赖关系。阅读有关设置应用程序composer.json中的
minimum-stability
设置的网络提示/维基。
运行以下命令之一:
$ php composer.phar require kartik-v/yii2-field-range "dev-master"
或添加以下内容到您的composer.json
文件的require
部分:
"kartik-v/yii2-field-range": "dev-master"
使用方法
FieldRange
use kartik\field\FieldRange; use kartik\widgets\ActiveForm; $form = ActiveForm::begin(); echo FieldRange::widget([ 'form' => $form, 'model' => $model, 'label' => 'Enter start and end points', 'attribute1' => 'start_point', 'attribute2' => 'end_point', 'type' => FieldRange::INPUT_TEXT, ]); ActiveForm::end();
许可证
yii2-field-range在BSD-3-Clause许可证下发布。有关详细信息,请参阅附带LICENSE.md。