README_cn.md

php-x-editable

可能是史上最好用的X-Editable PHP插件了

---

安装

 $ composer require diana/php-x-editable -vvv

在安装完成后，javascript和css是引用jsdelivr的URL来载入的。 如果您的项目是内网，或者因为其他限制需要本地托管的，请执行下面的命令即可托管在本地。

 $ composer require diana/php-x-editable-assets -vvv
 $ composer run-script post-autoload-dump -d vendor/diana/php-x-editable-assets

其中，第二个命令是发布CSS/JS到项目的WEB目录的。针对laravel(lumen)和thinphp5框架，会发布到public目录。 其他情况默认发布到根目录。 如果框架不满足上面情况，需要手工执行

 $ cp -R ./vendor/diana/php-x-editable-assets/assets/ 你项目的WEB根目录/

使用

<?php
$editable = new \Editable\Editable(
    [
        'id'            => 12,
        'name'          => '张君宝',
        'home'          => '武当山',
        'prefer'        => 'php,html',
        'gender'        => 1,
        'job'           => 2,
        'about'         => 'Throne of the seven kingdoms,<br/> <i>Father of the dragon</i>, <b>stormborn</b>, <u>unburn</u>.',
        'created_at'    => date('Y-m-d H:i:s'),
    ], 
    'id', 
    [], 
    'test.php?action=save'
);

$editable->typeahead('home', null, [
    '武当山',
    '华山',
    '峨眉山',
    '井冈山',
], 0);

$editable->checklist('job', null, [
    ['value' => 1, 'text' => '一代弱鸡'],
    ['value' => 2, 'text' => '一代宗师'],
    ['value' => 3, 'text' => '一代刺客']
], 0);

$editable->select('gender', null, [
    ['value' => 0, 'text' => '未知'],
    ['value' => 1, 'text' => '男'],
    ['value' => 2, 'text' => '女'],
], 0);

$editable->tag('prefer', null, ['css', 'js', 'google']);

$editable->wysiwyg('about');
$editable->datetime('created_at');
echo $editable->render()->getBody();

完整的DEMO例子请见 https://github.com/xiaohuilam/php-x-editable/blob/dev/example/Editable.php

Input[Text]

Typeahead

Tag

Checklist

Select

Wysiwyg(所见即所得)

Datetime(日期时间)

功能进度

功能	描述	状态
text		已完结
select		已完结
tags		已完结
datetime		已完结
wysiwyg		已完结
静态资源本地托管	安装	已完结
后端自动保存	就是你不用写保存的代码，因为你在读取时候已经写了所必要的信息	跳票中
多行编辑	一次编辑多行数据，考虑和datatables插件做支持	跳票中
二次异步加载	select和typeahead的下拉数据，做AJAX加载的支持	部分支持(单选框select已支持)
文件上传	x-editable是不支持上传文件的，我打算支持他	跳票中
追加额外的POST参数	如CSRF_TOKEN	跳票中

特别鸣谢

• x-editable: https://github.com/vitalets/x-editable
• bootstrap: https://github.com/twbs/bootstrap/releases/tag/v3.3.7
• php-html-builder: https://github.com/avplab/php-html-builder

授权

MIT

捐助

您不用捐助我，您只需用 支付宝钱包 APP扫描下面二维码后，买单时您可获得若干毛钱的减免，而我也可获得奖励。