2amigos/yii2-editable-widget

此包已废弃,不再维护。未建议替代包。

Yii2 的 X-Editable 小部件。

安装量176,638

依赖项: 9

建议者: 1

安全: 0

星标: 58

关注者: 23

分支: 20

开放问题: 10

类型:yii2-extension

1.1.1 2017-07-27 05:58 UTC

This package is auto-updated.

Last update: 2023-08-16 02:45:17 UTC


README

Latest Version Software License Build Status Coverage Status Quality Score Total Downloads

渲染一个 X-Editable 输入,允许使用 X-Editable 插件 的出色内联功能。

重要说明

由于我们项目的需求,我们决定仅移植 X-Editable 插件 的 Bootstrap 3 功能。我们为此做了大量工作

  • 原始库已被修改以移植到 Yii2。我们认为不属于核心的插件,我们将其提取出来,并作为独立的外部输入类型(地址、combodate、日期选择器、日期时间选择器、select2 和 wysihtml5 插件)实现。我们认为将外部类型分离将有助于每个人隔离问题,并能够更好地改进库。
  • 所有插件都已更新到最新版本
  • 修复了日期选择器和日期时间选择器类型以与 Bootstrap 3 兼容
  • 重构了小部件代码,使其更容易理解
  • 我们没有包含 EditableColumnEditableListViewEditableDetailView,因为我们认为它们对应不同的包。它们将独立开发。

因此,如果您要修复问题,请记住,这并非 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)。请参阅许可证文件获取更多信息。

2amigOS!
定制软件 | 网页和移动软件开发
www.2amigos.us