E9表单建模API:复写浏览按钮与日期范围控制
需积分: 44 200 浏览量
更新于2024-08-06
收藏 1.2MB PDF 举报
"复写浏览按钮组件的props-cisco 中型项目实战"
在“复写浏览按钮组件的props-cisco 中型项目实战”中,我们关注的是如何在泛微OA E9平台上的表单开发中控制特定功能。这个实战主要涉及两个关键知识点:1) 控制日期浏览按钮的可选日期范围,以及2) 复写浏览按钮组件的props。
首先,对于控制日期浏览按钮的可选日期范围,开发者可以使用`controlDateRange`函数来限制用户在手动选择日期时能选取的日期范围。这个函数需要三个参数:`fieldMark`,`start`,和`end`。`fieldMark`是一个字符串,表示字段的标识,格式为`field {字段ID}_ {明细行号}`。`start`参数设定最小日期,可以是标准日期格式(如'2019-05-28')或者相对于当前日期的天数(如-5代表往前5天)。`end`参数可选,用于设定最大日期,格式与`start`相同。例如:
- `ModeForm.controlDateRange("field111", -5, 10)` 将允许用户选取从当前日期往前5天到往后10天内的日期。
- `ModeForm.controlDateRange("field111", 0, '2019-12-31')` 仅允许选择当前日期到2019年的最后一天。
- `ModeForm.controlDateRange("field222_0", '2019-05-01', '2019-05-31')` 对于明细字段,限制用户选择五月的日期。
其次,复写浏览按钮组件的props允许开发者自定义浏览按钮的行为。通过`overrideBrowserProp`函数,开发者可以完全重写覆盖浏览按钮的props。然而,这个功能需要谨慎使用,因为它是直接传递props给组件,具体实现何种需求由组件内部逻辑处理。这个函数接受两个参数:`fieldMark`和`jsonParam`,其中`fieldMark`仍然是字段标识,`jsonParam`是一个JSON对象,包含要传递给组件的属性。
整个E9表单建模前端接口API是封装在全局对象`window.ModeForm`中的,推荐使用API接口进行操作,避免直接使用jQuery或原生JS操作DOM,以保持代码的整洁和高效。一些常用的基础操作接口包括:
- `convertFieldNameToId`:将字段名称转换成字段id,适用于多表单和多环境场景,能够实现代码解耦。
- `getFieldValue`:获取指定字段标示的字段值。
- `changeFieldValue`:修改字段值,修改后会自动触发联动规则。
举例来说,`convertFieldNameToId`函数可以通过提供字段名称、表单标示(默认为'main')和是否需要前缀(默认为true)来生成字段id。而`getFieldValue`和`changeFieldValue`则分别用于读取和修改字段值,其中`changeFieldValue`接受一个JSON对象,包含新的值和可能的特殊对象(如浏览按钮信息)。
这些API接口的使用,结合对`controlDateRange`和`overrideBrowserProp`的理解,可以帮助开发者更灵活地控制和定制泛微OA E9中的表单交互,从而满足复杂业务需求。
2011-05-05 上传
2019-07-28 上传
2013-06-06 上传
2021-03-13 上传
2021-05-14 上传
2021-02-04 上传
2021-05-30 上传
2021-05-30 上传
2021-05-30 上传