meysampg / yii2-formbuilder
此包已被弃用,不再维护。没有建议的替代包。
基于 jQuery 的 Yii2 拖放表单构建器
v1.2.7
2021-06-19 13:03 UTC
Requires
README
🟥⚠️ 此包已弃用。请选择其他包或在 Packagist 中引用您的包,请将您的包 Fork 至 p.g.meysam [at] Gmail [dot] com 通知我 ⚠️🟥
这是一个基于 jQuery 的 Yii2 拖放表单构建器,它基于 jQuery FormBuilder 插件构建。
安装
通过 composer 安装此扩展是首选方式。
运行以下命令之一:
composer.phar require meysampg/yii2-formbuilder "*"
或者
"meysampg/yii2-formbuilder": "*"
将以下内容添加到您的 composer.json
文件的 require 部分。
使用方法
扩展安装后,只需在您的代码中使用它即可
use meysampg\formbuilder\FormBuilder;
并作为小部件使用
<?= FormBuilder::widget(); ?>
配置
有一些属性可以帮助您轻松控制表单构建器。
属性 | 类型 | 描述 | 默认值 |
---|---|---|---|
accessVariableName | 字符串 | JavaScript 变量名,用于在 JS 代码中访问表单构建器内容 | 'formBuilderJsVariable' |
data | 数组 | 要作为表单构建器默认元素渲染的元素列表 | |
dataType | 字符串 | 指示输入和输出数据必须是 XML 或 JSON | 'xml' |
elementType | 字符串 | 表单构建器构造器的 HTML 标签 | 'div' |
messages | 数组 | 所需语言上的标签字符串列表 | |
language | 字符串 | 显示表单构建器所需的语言(请参阅翻译部分) | |
options | 数组 | 插件选项列表,请参阅 FormBuilder 文档 | |
showActionButtons | 布尔值 | 指示是否显示控制按钮 | false |
示例
<?= FormBuilder::widget([ 'data' => [ [ "type" => "header", "subtype" => "h1", "label" => "Header", "class" => "header", ], [ "type" => "button", "label" => "Button", "subtype" => "button", "class" => "button-input btn btn-warning", "name" => "button-1475845417456", "style" => "warning", ], ], ]); ?>
<?= FormBuilder::widget([ 'dataType' => 'json' ]); ?>
<?= FormBuilder::widget([ 'messages' => [ "autocomplete" => "Autocomplete 23", ], ]); ?>
<?= FormBuilder::widget([ 'language' => 'fa-IR', ]); ?>
翻译
只需将 messages
文件夹中的 en.php
文件复制并重命名为您的语言(例如 ar
,fr
,fa
,fa-IR
...),翻译字符串,提交您的更改,并发送拉取请求。