README

yii2-editable

在 Yii Framework 2.0 中轻松设置任何显示内容为可编辑。这是一个增强的可编辑小部件，允许轻松编辑显示的数据，使用输入、小部件等，具有多种配置选项。该扩展使用增强的yii2-popover-x扩展作为编辑的弹出模态框。在 v1.7.3 版本中，此扩展还允许您以行内方式渲染可编辑内容，并提供高级行内模板进行配置。此扩展不使用任何外部 jQuery 插件（如 X-Editable），而是使用自己的轻量级且可扩展的 jQuery 可编辑插件 - 该插件精心重用了 Yii Framework 2.0 中可用的功能。

有关最新发布详情，请参阅变更日志。

特性

1. 将任何可读的标记设置在您的视图、DetailView 或 GridView 中，使其可编辑。请参阅 kartik\grid\GridView 中的 EditableColumn 详细信息，以在您的网格中使用可编辑列。
2. 提供两种显示格式来设置您的可编辑内容。
   • 链接：将可编辑内容转换为可点击的链接，用于弹出。
   • 按钮：不将可编辑内容转换为链接，而是在其旁边显示按钮以编辑内容。
3. 能够以 POPOVER 或 行内 方式渲染内容。
4. 高级可配置的行内模板，用于渲染复杂内容。
5. 使用 Yii 2.0 ActiveForm 编辑内容。因此，所有 Yii ActiveForm 的功能都可用，包括模型验证规则。
6. 对于编辑内容，您可以选择使用任何 HTML 输入或小部件（来自 kartik-v/yii2-widgets 或其他输入小部件，例如来自 https://github.com/kartik-v）。此外，您还可以使用 HTML 5 输入或任何自定义输入小部件来编辑您的内容。
7. 完全控制表单内容在弹出窗口中的显示方式。默认情况下，小部件显示要编辑的输入。此外，您还可以在此默认输入之前和之后放置更多表单字段或标记。
8. 使用基于 AJAX 的表单提交来处理数据的快速编辑，并提供无缝的用户体验。
9. 使用yii2-popover-x 扩展的先进功能来控制可编辑弹出窗口表单的显示格式。这使用了 Krajee 的增强 bootstrap-popover-x jQuery 插件。
10. 通过在生成的可编辑输入之前或之后添加更多表单字段，轻松扩展默认的可编辑字段。
11. 可以配置自己的显示值，而不考虑存储的内部值。
12. 可配置 CSS 样式和标签，以便根据您的应用程序或主题渲染可编辑内容。
13. 能够通过Pjax自动渲染和重新初始化小部件。

注意：检查此扩展的依赖和要求，请参阅composer.json。阅读关于为您的应用程序的composer.json设置minimum-stability设置的网络提示/wiki。

演示

您可以在使用说明和示例中看到此扩展的详细信息。

安装

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

注意：检查此扩展的依赖和要求，请参阅composer.json。阅读关于为您的应用程序的composer.json设置minimum-stability设置的网络提示/wiki。

运行以下命令之一：

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

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

"kartik-v/yii2-editable": "@dev"

使用方法

可编辑的

use kartik\editable\Editable;
echo Editable::widget([
    'model' => $model, 
    'attribute' => 'rating',
    'type' => 'primary',
    'size'=> 'lg',
    'inputType' => Editable::INPUT_RATING,
    'editableValueOptions' => ['class' => 'text-success h3']
]);

许可证

yii2-editable是在BSD-3-Clause许可证下发布的。有关详细信息，请参阅捆绑的LICENSE.md文件。