跳到主要内容

文件选择

本节主要介绍 AppStudio 控件库里的文件选择控件。

文件选择控件
文件选择控件

属性

CloudPSS 提供了一套统一的控件属性参数

通用样式

参数名键值 (key)单位备注类型描述
是否隐藏hidden选择是否隐藏控件选择选择隐藏或者显示隐藏当前控件,或者显示当前控件,默认为显示状态
透明度style/opacity输入透明度常量输入透明度值,控件按照透明度值变化,范围为0~1 ,默认为 1

样式

参数名键值 (key)单位备注类型描述
布局layout选择控件布局选择垂直或者水平布局,默认为垂直
安静quiet选择是否安静选择选择或者,默认为状态

标签样式

参数名键值 (key)单位备注类型描述
文字字体style/font-family选择文字字体选择标签文字字体样式,字体类型包括:默认、宋体、黑体、楷体、微软雅黑、Georgia、Palatino Linotype、Times New Roman、Arial、Arial Black、Verdana、Courier New、Trebuchet MS
文字字号style/--spectrum-global-dimension-font-size-100输入文字字号常量输入文字字号
文字颜色style/--spectrum-alias-label-text-color选择文字颜色颜色选择器点击文字颜色,弹出颜色选择器自定义颜色
文字粗细style/--spectrum-alias-body-text-font-weight选择文字粗细选择选择标签文字粗细,默认、100、200、300、400、500、600、700、800、900、1000

内容

参数名键值 (key)单位备注类型描述
标签label内容标签常量输入框控件文字标签
文件格式accept文件格式字符串逗号分隔的拓展名列表
禁用disabled禁用开关开关禁用选择或者,开启后控件禁止点击和交互,默认为
文件处理preference首选的文件处理方式常量嵌入:将文件嵌入输入数据中;存储:将文件上传到 CloudPSS 存储服务器;链接:以外部链接的形式引用文件。默认为嵌入
value文件选择控件默认内容Data URL / 字符串文件选择控件默认内容。 嵌入链接格式形如 data:[<mediatype>][;base64],<data>存储格式形如 api/storage/...

事件

参数名键值 (key)单位备注类型描述
更改@change输入结束时触发事件函数采用更新方式触发,失去焦点后控件的值才会更新

案例介绍

上传一张 jpg 格式的图片

  1. 创建一个文件选择控件,在右侧的属性配置区内给文件选择命名为 A

  2. 创建一个 Markdown 文本框控件用来显示上传的文件的 url 或者存储地址,在右侧的属性配置区内给文件选择命名为 B,将 B 的内容/值属性切换到 fx 表达式模式,设置为 A.value。详情查看 MarkDown 文本框控件

  3. 创建一个图片控件用来显示图片,在右侧的属性配置区内给文件选择命名为 C, 将 C 的内容/值属性切换到 fx 表达式模式,设置为 A.value。详情查看图片控件

  4. 点击工具栏的预览快捷按钮(或者 Ctrl + P ),进入预览模式,在预览模式下上传文件

创建文件选择控件
创建文件选择控件
接入其他控件,左 Markdown 文本框控件,右图片控件
接入其他控件,左 Markdown 文本框控件,右图片控件
嵌入/链接模式
嵌入/链接模式
存储模式
存储模式
典型应用使用详情

上传 CSV 文件,接入 FuncStudio 函数调用

  1. 创建一个文件选择控件,在右侧的属性配置区内给文件选择命名为 A

  2. 创建函数资源 asset2,选择资源类型为函数

  3. 配置函数资源 asset2,点击选择资源,绑定 ridfunction/Maxwell/demo 的示例函数,示例函数存在一个参数 a

  4. 鼠标选中文件选择 A 的事件/更改属性栏,按下 Ctrl 输入 $asset2.args.a = A.value; $asset2.start()

  5. 点击工具栏的预览快捷按钮(或者 Ctrl + P ),进入预览模式,在预览模式下上传文件

创建文件选择控件
创建文件选择控件
创建函数资源
创建函数资源
绑定示例函数
绑定示例函数
示例函数详情
示例函数详情
更改文件选择属性
更改文件选择属性
预览模式
预览模式
FuncStudio 函数使用详情

常见问题

上传的文件是否有格式限制?

无格式限制

上传的文件是否有数据大小限制?

有数据大小限制,默认限制为 32 MB

什么是事件触发机制?

AppStudio 场景标签页内控件的属性有两种输入模式,一种是 (x) 值输入模式,另一种是 f(x) 表达式输入模式。 值输入模式是通过在属性框内直接输入值来配置控件属性,表达式输入模式则是在属性框内输入由变量/函数资源键名、控件属性键名构成的 math.js 表达式,通过表达式解析器计算出表达式的值来配置控件属性值。详情参见 控件属性的表达式输入

(x) 与 f(x) 的区别

事件是指对控件操作后产生的效果,事件触发使用 HTML 元素事件触发的回调函数结合 math.js 的表达式解析器进行控件属性或者资源的调用。详情参考 事件触发机制