门户开发-组件介绍-文本字段、多行文本、地址、组合框
O2OA(翱途)开发平台[下称O2OA开发平台或者O2OA]拥有门户页面定制与集成的能力，平台通过门户定制，可以根据企业的文化，业务需要设计符合企业需要的统一信息门户，系统首页等UI界面。从本篇讲的是页面设计器元素组件中文本字段、多行文本、地址和组合框这几个组件。
1、先决条件
1、O2Server服务器正常运行，系统安装部署请参考文档《如何在服务器上安装部署O2OA》
2、以拥有管理员权限或拥有门户管理员（PortalManager角色）的用户账号登录O2OA(翱途)开发平台，如：xadmin
3、可以进入门户管理平台并且有开发权限，请参考《门户开发-门户设计开发入口和权限说明》
二、文本字段
文本字段就是一个输入框，用于文本输入。
1. 文本字段属性
文本字段特有的基本属性如下：
属性 | 描述 | 备注 |
显示图标 | 是否显示文本字段图标 | |
Input样式 | 通过css定义input元素的样式 | 文本字段在html的直接dom结构为<div><input /></div>，所以样式属性调整的是div的样式，input样式渲染input对象的样式。 |
计算 | 可以通过脚本计算出文本字段的默认值 | 在页面中，“创建“、”保存“和”显示“的表现都是一样的，这个选项在表单中有区别。 |
校验 | 此字段在页面中无效 | 在流程表单中用于提交时的数据校验 |
区段属性在门户页面中无效，只在流程表单中生效。
2. 文本字段事件
除了DOM事件之外，文本字段的系统事件如下：
事件名 | 描述 |
queryLoad | 元素被载入之前执行 |
load postLoad | 元素被载入之后执行 |
change | 输入框内容变化时触发 |
3. 文本字段方法
文本字段对象可以通过以下脚本获取：
var el = this.page.get(name); //name为文本字段的标识
获取的对象有以下方法可以使用：
方法名（属性） | 用法 | 描述 |
show | el.show() | 显示元素 |
hide | el.hide() | 隐藏元素 |
addEvent | el.addEvent(name, fun) | 给元素绑定系统事件。 name：事件按名称 fun： 执行的方法 |
node | var dom= el.node | 获取html原生Dom对象 |
setData | el.setData(str) | 设置文本字段的值 |
getData | var value = el.getData() | 获取文本字段的值 |
三、多行文本
多行文本的属性、事件和方法都和文本字段一致，它可以输入多行内容。
四、地址
地址组件是一个地市选择器，可以选择省份、地区等内容。
1. 地址属性
地址特有的基本属性如下：
属性 | 描述 | 备注 |
是否只读 | 如果选“是“则不允许编辑 | |
Address样式 | 通过css定义地址选择器内部的样式 | |
选择范围 | 地址可选层级，省、省市、省市县 | |
计算 | 可以通过脚本计算出文本字段的默认值 | 在页面中，“创建“、”保存“和”显示“的表现都是一样的，这个选项在表单中有区别。 |
校验 | 此字段在门户页面中无效 | 在流程表单中用于提交时的数据校验 |
区段属性在门户页面中无效，只在流程表单中生效。
2. 地址事件
与文本字段事件一致
3. 地址方法
与文本字段一致
五、组合框
组合框是一个文本输入框并且会有下拉可选项进行选择。
1. 组合框属性
组合特有的基本属性如下：
属性 | 描述 | 备注 |
是否只读 | 如果选“是“则不允许编辑 | |
分隔符 | 可选值的数据分割符号，可用正则表达式 | |
显示分隔符 | 页面上多选值的时候，显示的分割符 | |
可选数量 | 最多可选的选项数，0表示不限制 | |
显示选项 | 下拉选项列表什么时候显示出来 | |
可选值 | 固定值，在下面可选值中直接配置。 脚本，在下面脚本框中输入生成可选值数组的脚本 动态计算，可通过脚本异步请求后台api来获取可选值数组 | 通过脚本返回选择项时，需要返回一个字符串数组，每个元素为一个选择项。每个字符串值格式：“text|value”，其中text为显示的文本；value为真正的值。 |
Input样式 | 通过css定义input元素的样式 | 文本字段在html的直接dom结构为<div><input /></div>，所以样式属性调整的是div的样式，input样式渲染input对象的样式。 |
计算 | 可以通过脚本计算出文本字段的默认值 | 在页面中，“创建“、”保存“和”显示“的表现都是一样的，这个选项在表单中有区别。 |
校验 | 此字段在门户页面中无效 | 在流程表单中用于提交时的数据校验 |
区段属性在门户页面中无效，只在流程表单中生效。
2. 组合框事件
与文本字段事件一致
3. 组合框方法
与文本字段一致
以上是门户设计器中文本字段、多行文本、地址和组合框组件的简单说明，希望对您有帮助，关于门户页面开发的更多介绍请参考以下文章：
《门户开发-快速入门开发一个门户实例》
《门户开发-组件介绍-容器、通用元素》
《门户开发-组件介绍-数据源、子数据源、数据文本》
《门户开发-组件介绍-文本、图片、按钮》
《门户开发-组件介绍-表格》
《门户开发-组件介绍-iframe、HTML》
《门户开发-组件介绍-嵌入视图、嵌入统计、嵌入查询视图》
《门户开发-组件介绍-文本字段、多行文本、地址、组合框》
《门户开发-组件介绍-人员组织》
《门户开发-组件介绍-日期选择》
《门户开发-组件介绍-下拉框、单选框、多选框》
《门户开发-组件介绍-平台应用》
《门户开发-组件介绍-数据表格》
《门户开发-组件介绍-ElementUI组件》
《门户开发-组件介绍-部件、部件元素》
浙公网安备 33010602009829号