4.6.4 长文本
长文本组件用于输入和展示多行文本。通过绑定数据列属性和数据集组件实现双向绑定,感知数据和规则。和输入框组件的区别是:输入框组件中的文本不会换行显示,只会在一行中显示,而长文本组件中的文本在超出一行后,会换行显示。与文本组件的区别是:文本组件只能显示,不能输入,而长文本组件既能显示也能输入。运行效果如图4-51所示。
图4-51 长文本组件
1、基础属性
长文本组件提供8个基础属性
l 绑定数据列:设置长文本组件和数据集中某列的绑定关系,绑定后,长文本显示数据集中某列的值,同时,用户在长文本中的修改会存储到数据集的某列中去
l 提示信息:长文本为空时显示的信息,可用于提示用户在长文本中应该输入什么内容
l 最大长度:设置最大输入长度,设置为-1时表示不限长度,默认为140,表示最多输入140个字。长文本组件中的数据通常存储在“文本”类型的列中,“文本”类型的列,默认长度为254,表示最多能存储254个字,保存数据时,如果长文本中超过254个字,保存会报错。因此,长文本的最大长度必须小于等于“文本”列的长度。设置列长度的方法是切换到数据制作区,打开数据集,单击列的高级按钮,在弹出的高级设置对话框中设置列的长度,如图4-52所示
l 自动聚焦:设置为true,打开页面时,自动获得焦点,拉起键盘
l 获取焦点:设置为true,长文本获得焦点
l 自动增高:设置区域高度是否自适应,自适应就不出现滚动条
l 在fixed区域:当长文本组件需要在固定布局的区域中显示,必须设置为true
l 光标键盘距离:设置光标与键盘的距离
图4-52 数据列的高级设置
2、事件
长文本组件提供1个事件:值改变事件,长文本中的值变化时触发。