README

yii2-editable      

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