2amigos / yii2-editable-widget
此包已废弃,不再维护。未建议替代包。
Yii2 的 X-Editable 小部件。
1.1.1
2017-07-27 05:58 UTC
Requires
- bower-asset/select2: ~4.0
- yiisoft/yii2: ~2.0.5
- yiisoft/yii2-bootstrap: ~2.0.0
Requires (Dev)
- friendsofphp/php-cs-fixer: ^2.0
- phpunit/phpunit: 4.*
- scrutinizer/ocular: ~1.1
README
渲染一个 X-Editable 输入,允许使用 X-Editable 插件 的出色内联功能。
重要说明
由于我们项目的需求,我们决定仅移植 X-Editable 插件 的 Bootstrap 3 功能。我们为此做了大量工作
- 原始库已被修改以移植到 Yii2。我们认为不属于核心的插件,我们将其提取出来,并作为独立的外部输入类型(地址、combodate、日期选择器、日期时间选择器、select2 和 wysihtml5 插件)实现。我们认为将外部类型分离将有助于每个人隔离问题,并能够更好地改进库。
- 所有插件都已更新到最新版本
- 修复了日期选择器和日期时间选择器类型以与 Bootstrap 3 兼容
- 重构了小部件代码,使其更容易理解
- 我们没有包含 EditableColumn、EditableListView 或 EditableDetailView,因为我们认为它们对应不同的包。它们将独立开发。
因此,如果您要修复问题,请记住,这并非 X-Editable 的精确副本,这是一个移植到 Yii2 的 Bootstrap 3 增强 X-Editable 插件。
我们欢迎每个人都通过他们惊人的 Pull Requests 改进这个库,并希望这将提高您使用 Yii2 的生产力。
所以请记住这一点
- 小部件基于 X-Editable,而不是基于 X-Editable for Yii
- 它不与 JQuery UI 或纯 JQuery 一起使用,仅与 Bootstrap 和最新版本一起使用(抱歉不是 2.3.2)
- 如果您希望帮助改进库,请这样做,但不要更新库,认为这与 X-Editable 源相同,它已被修改。
- 支持的类型有
- 文本
- 文本区域
- 选择
- 日期
- 日期时间
- combodate
- HTML5 类型
- 复选框列表
- WYSIWYG 编辑器
- select2
- 没有 typeaheadJs - 想接受挑战吗?
安装
安装此扩展的首选方式是通过 composer。
运行以下命令:
composer require 2amigos/yii2-editable-widget:~1.0
或将其添加到您应用程序 composer.json
文件的 require 部分:
"2amigos/yii2-editable-widget" : "~1.0"
使用方法
Vitaliy Potapov 制作了一个惊人的网站,展示了如何配置小部件。我们不会再次解释如何使用每个小部件,我们鼓励您访问 插件网站的文档部分
<?php
use dosamigos\editable\Editable;
// as a widget with a model and a datetime type
?>
<?= Editable::widget( [
'model' => $model,
'attribute' => 'created_at',
'url' => 'site/test',
'type' => 'datetime',
'mode' => 'pop',
'clientOptions' => [
'placement' => 'right',
'format' => 'yyyy-mm-dd hh:ii',
'viewformat' => 'dd/mm/yyyy hh:ii',
'datetimepicker' => [
'orientation' => 'top auto'
]
]
]);?>
<?php
// as a widget without a model and a select2 type
?>
<?= Editable::widget( [
'name' => 'country_code',
'value' => '',
'url' => 'site/test',
'type' => 'select2',
'mode' => 'pop',
'clientOptions' => [
'pk' => 2,
'placement' => 'right',
'select2' => [
'width' => '124px'
],
'source' => [
['id' => 'gb', 'text' => 'Great Britain'],
['id' => 'es', 'text' => 'Spain'],
],
]
]);?>
<?php
// with an ActiveForm instance displayed as a address input
use dosamigos\editable\Editable;
?>
<?= $form->field($model, 'address')->widget(Editable::className(), [
'url' => 'site/test',
'type' => 'address'
]);?>
<?php
// as datetime type input
<?= $form->field($model, 'created_at')->widget(Editable::className(), [
'url' => 'site/test',
'type' => 'datetime',
'mode' => 'pop',
'clientOptions' => [
'placement' => 'right',
'format' => 'yyyy-mm-dd hh:ii',
'viewformat' => 'dd/mm/yyyy hh:ii',
'datepicker' => [
'orientation' => 'top auto'
]
]
]);?>
测试
为了测试扩展,最好在你的电脑上克隆此仓库。然后,进入扩展文件夹,执行以下操作(假设你在电脑上已安装 composer
)
$ composer install --no-interaction --prefer-source --dev
一旦所有必需的库都安装完毕,然后执行
$ vendor/bin/phpunit
更多信息
请查看X-Editable 插件文档以获取有关其配置选项的更多信息。
贡献
请参阅CONTRIBUTING以获取详细信息。
鸣谢
许可证
BSD 许可证(BSD)。请参阅许可证文件获取更多信息。
定制软件 | 网页和移动软件开发
www.2amigos.us