# lhpamis

**Repository Path**: dragonlhp/lhpamis

## Basic Information

- **Project Name**: lhpamis
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-11
- **Last Updated**: 2025-12-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# lhpamis

#### 介绍

lhpamis 是一个基于百度amis(爱速达)框架的json构建器，吸收了海豚php框架的构建器特性；本构建器只生成amis支持的json数据;

#### 使用说明

表单字段名最后一个字符如果有*代表表单必填，否则为选填;

表单数组中表单项数组
单个调用
->addFormItem('id', '用户ID', 'hidden', '', $id)
->addFormItem(Amis::make()->TextControl($name, $item['label']))
多个调用
->addFormItems([
    ['id', '用户ID', 'hidden', '', $id],
    ['username', '用户名', 'text', '请输入用户名','张三'],
    [Amis::make()->TextControl($name, $item['label']),
])
注：表单构建器字段初始化,前五个分别是name,label,type,desc,value(默认值),后面的字段在指定的表单组件的formBuildField方法中定义了各自的参数，

CRUD表格数组中列项数组
[
    ['id', '用户ID', 'hidden'],
    ['username', '用户名', 'text', '此列是用户名','设置默认值是张三'],
    ['city', '城市', 'select', '此列是城市','设置默认值是1',[['label'=>'成都','value'=>'1']],['search'=>true]],
]

解释:数组第一个值是字段名称,第二个值是字段描述,第三个字段是组件类型,第四个是表单项描述，第五个是默认值,前五个一般都是固定值不变,前两个必填，后面都是选填，第三个参数没填的情况下默认是text组件
第六个开始一般是组件的最常用的参数,根据组件类型会扩展一到三个必要选填参数,
一般最后一个值是属性扩展数组,需要使用组件其他任意支持的属性的时候就写入最后一个数组中;
所有的属性调用方式直接参考amis的开发文档；

以下是表单的各种字段的默认配置:
注意：一般没有特殊处理的表单组件都可以参考文本组件的使用方式，文本组件可以省略掉
文本格式 包含文本 数字 密码 邮箱 使用方式一致
格式：['字段名', '字段标题', '文本组件', '说明','默认值',[其他属性数组]],
例子：['username', '用户名', 'text', '输入用户名','张三',['className'=>"username"]],

文本格式简写
格式：['字段名', '字段标题',],
例子：['username', '用户名'],

日期格式 包含时间 日期 月份 季度 年度使用方式一致
格式：['字段名', '字段标题', '日期组件', '说明','默认值',[其他属性数组]],
例子：['create_time', '创建日期', 'datetime', '系统创建日期','2025-07-18',['valueFormat'=>"YYYY-MM-DD HH:mm:ss"]],



选择格式 下拉 单选  多选 Transfer TransferPicker   
格式：['字段名', '字段标题', '选择组件', '说明','默认值',options选项值,[其他属性数组]],
例子：['data_types', '数据类型', 'select', '项目数据类型','1',[['label'=>'成都','value'=>'1']],['search'=>true]]],


Swich格式 下拉 单选  多选
格式：['字段名', '字段标题', '选择组件', '说明','默认值',[其他属性数组]],
例子：['is_show', '是否显示', 'swich', '是否显示','1',['className'=>'swich']]],



持续跟新中..........

#### 参与贡献

1.  Fork 本仓库
2.  新建 Feat_xxx 分支
3.  提交代码
4.  新建 Pull Request