文件上传表单

组件 ID: file

这是一个标准的 SunForm 表单组件，支持可视化配置与低代码生成。

JSON 配置示例

直接复制以下 JSON 到配置文件中即可使用。

{
  "type": "file",
  "props": {
    "label": "文件上传",
    "value": [],
    "apiSet": "{",
    "size": "default",
    "hasLabel": true,
    "required": false,
    "disabled": false,
    "isDetail": false,
    "hideFileName": false,
    "hidePreview": false,
    "hide": false,
    "placeholder": "请上传文件",
    "labelPosition": "top",
    "remark": "",
    "zdname": null,
    "labelAlign": "left"
  }
}

属性配置 (Props)

属性名	类型	默认值	说明
`size`	string	default	组件尺寸 (small/default/large)
`hasLabel`	boolean	true	暂无描述
`required`	boolean	false	是否必填
`disabled`	boolean	false	是否禁用
`isDetail`	boolean	false	暂无描述
`hideFileName`	boolean	false	暂无描述
`hidePreview`	boolean	false	暂无描述
`hide`	boolean	false	是否隐藏该组件
`placeholder`	string	请上传文件	占位提示文本
`labelPosition`	string	top	标签位置 (top/left)
`remark`	string	-	组件备注/说明
`value`	object	[]	表单值 / 绑定值
`zdname`	any	null	暂无描述
`label`	string	文件上传	标签文本/标题
`labelAlign`	string	left	标签对齐方式
`labelWidth`	string	120px	标签宽度
`width`	number	24	宽度
`fileField`	string	file	暂无描述
`fileIdField`	string	id	暂无描述
`fileNameField`	string	name	暂无描述
`fileUrlField`	string	url	暂无描述
`fileSaveType`	string	name,id	暂无描述
`fileDownType`	string	blob	暂无描述
`fileGetUrl`	string	-	暂无描述
`fileDownUrl`	string	-	暂无描述
`accept`	string	-	接受的文件类型
`limit`	number	9	暂无描述
`fileSize`	number	10	暂无描述
`readonly`	boolean	false	是否只读
`multiple`	boolean	true	是否多选
`hideTable`	boolean	false	暂无描述
`fileTypes`	object	['image', 'video']	暂无描述
`validationRules`	object	[]	自定义校验规则
`validationState`	object	{ valid: true, message: '' }	暂无描述
`apiSet`	object	{	API 接口配置对象 (url, method, params)
`method`	string	post	暂无描述
`apiurl`	string	-	暂无描述
`params`	object	[]	暂无描述
`headers`	object	[]	请求头配置
`isQuery`	boolean	false	暂无描述
`contentType`	string	file	暂无描述
`paramsFormat`	string	-	暂无描述
`headersFormat`	string	-	暂无描述
`successFormat`	string	-	暂无描述
`errorFormat`	string	-	暂无描述
`labelField`	string	-	暂无描述
`valueField`	string	-	暂无描述
`beforeSend`	string	-	暂无描述
`onCreated`	any	null	组件创建时触发的事件
`onMounted`	any	null	组件挂载后触发的事件
`onNameFormat`	any	null	事件回调

文件上传 表单

JSON 配置示例

属性配置 (Props)

文件上传表单