APPCUBE-上传
下载APPCUBE用户手册完整版
上传
文件选择上传控件，用于上传文件。
上传组件说明如下。
- 默认是一个Button组件，可以自定义修改内容。
- 可以通过数据绑定模型，上传文件列表会保存在绑定的模型中。
- 该组件在移动端支持调用摄像头接口。
向工作区域中拖入一个上传组件，单击“上传”页签，显示可配置属性页面。
参数名 |
说明 |
|---|---|
默认已上传的文件列表 |
默认已上传的文件列表。 |
存储 |
上传文件的存储类型。单击该参数后的齿轮图标，可进行配置。
|
过滤文件类型 |
接受上传的文件类型，为文件原生的属性，会在选择文件时按照文件类型过滤，多个类型格式间以“,”符号隔开，如：“image/jpeg,application/msword,text/plain”。 |
支持文件类型 |
支持的文件类型，与“过滤文件类型”不同的是，该参数是识别文件的后缀名，“过滤文件类型”为原生的属性，会在选择文件时过滤，可以两者结合使用。如：jpg,doc,txt |
支持多文件 |
是否支持多选文件。 |
自定义文件名 |
上传的单个文件时，可自定义上传的文件名。 |
同名处理 |
防止同名文件覆盖，同名文件名后自动增加随机数，也可在“on-before-upload”事件中自定义处理文件名。 |
上传路径 |
自定义服务器端上传路径，默认uistudio/upload，上传路径不能是以“./”或“../”等开头的相对路径。 |
文件数量 |
多文件上传时，最大文件数量限制，即允许上传的文件数量，超过此数量后，将不允许上传。 |
文件大小(kb) |
单个文件大小限制，单位kb。 |
文件大小错误描述 |
当文件超过限制大小时，提示的错误描述。支持多种语言配置。 |
公开读 |
上传到服务器上，是否可以公开读。 |
可选择 |
是否设置文件列表中选择设置。文件列表中可以带遮罩层选择或者复选框选择。 |
是否多选 |
当“可选择”开关打开时，该参数才会显示。是否支持文件列表的多文件的选择。 |
选择类型 |
当“可选择”开关打开时，该参数才会显示。选择类型包含“遮罩层选择”或者“选择框选择”两种类型。 |
选择框内容 |
当“选择类型”设置为“选择框选择”时，该参数才会显示。可设置选择框内容。 |
选中时显示内容 |
当“选择类型”设置为“选择框选择”时，该参数才会显示。表示是否选中时显示选择框内容。 |
九宫格 |
九宫格形态展示图片列表，仅当上传全部为图片时开启效果较好，移动端每行展示4个并且大小自适应。 |
列表展示位置 |
相对于上传按钮，上传列表的展示位置，默认在下方。 |
展示方向 |
上传列表中多张图片时，控制图片展示排列方向。 |
图片宽度 |
上传列表中单个图片的宽高，单位像素。 |
最大宽度 |
限制最大的宽度。 |
连接器配置请参考了解连接器。
配置完上传属性后，需要在“事件”页签可进行事件编排，具体请参见事件编排器说明。
事件名 |
说明 |
返回值 |
|---|---|---|
数据改变 |
已上传文件列表改变时触发 |
当前已上传文件列表 |
文件上传 |
开始上传文件时触发 |
|
操作成功 |
上传成功后触发 |
上传成功文件的地址 |
选中文件 |
文件列表选中时或取消选中时触发 |
|
文件上传前 |
文件上传前触发 在“文件上传前”事件后单击齿轮图标，在“自定义JS代码”中增加“$current.showUploadList = false”语句，可取消上传预览。 |
|
系统为上传组件预置了clearFiles()方法。该方法用于清除上传文件列表。在上传组件的事件编排JS代码中可使用该方法，示例JS代码如下：
var _component = context.$component.get('upload_0');_component.clearFiles();
