跳到主要内容

输入框

本节主要介绍 AppStudio 控件库里的输入框控件。

该控件的主要作用包括:

  • 作为 FuncStudio 函数资源的输入输出接口,用于给函数传参接收输出结果
  • 作为 EMTLab 中实时电磁暂态仿真任务的输入输出接口,用于修改虚拟输入端口的值接收虚拟输出端口的值
输入框控件
输入框控件

属性

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)单位备注类型描述
文字字体style/--spectrum-alias-body-text-font-family选择文字字体选择输入框内容文字字体样式,字体类型包括:默认、宋体、黑体、楷体、微软雅黑、Georgia、Palatino Linotype、Times New Roman、Arial、Arial Black、Verdana、Courier New、Trebuchet MS
文字字号style/--spectrum-textfield-m-text-size输入文字字号常量输入文字字号
文字颜色style/--spectrum-alias-text-color选择文字颜色颜色选择器点击文字颜色,弹出颜色选择器自定义颜色
高度style/--spectrum-textfiled-m-heightpx输入高度常量输入控件形状高度

内容

参数名键值 (key)单位备注类型描述
标签label输入内容标签常量输入框控件文字标签
输入格式type选择输入格式选择输入格式:字符串、实数、整数
禁用disabled禁用开关开关禁用选择或者,开启后控件禁止点击和交互,默认为
占位符placeholder输入框占位符常量输入框内容为空时显示的提示性内容,仅用于占位
value输入框默认内容常量输入框默认内容
后缀suffix输入框后缀常量输入框最右侧显示的内容,一般为单位符号

事件

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

案例介绍

  1. 创建两个输入框,在右侧的属性配置区内给输入框命名为 A 和 B

  2. 创建静态资源 asset1,值设置为 2

  3. 将输入框 A 的内容/值属性设置为 1,输入框 B 的内容/值属性切换到 fx 表达式模式,设置为 A.value + $asset1.value

  4. 点击工具栏的预览快捷按钮(或者 Ctrl P),进入预览模式,在预览模式下修改输入框 A 的值,输入框 B 的值自动发生变化

创建输入框控件
创建输入框控件
创建静态资源
创建静态资源
配置输入框属性
配置输入框属性
预览模式
预览模式
典型应用使用详情

常见问题

什么是事件触发机制?

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

(x) 与 f(x) 的区别

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