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类型
  • 复选框列表
  • wysihtml5
  • 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以获取详细信息。

鸣谢

• Antonio Ramirez
• 所有贡献者

许可证

BSD许可证（BSD）。请参阅许可证文件获取更多信息。

定制软件 | 网络与移动软件开发
www.2amigos.us