Acrobat DC 文本域表单验证中的 js 使用

探讨如何在Adobe Acrobat中使用JavaScript进行表单字段验证，包含详细代码示例和实用技巧

引言：表单验证的重要性

在PDF表单开发中，字段内容验证 是确保数据质量和完整性的关键环节。Adobe Acrobat为开发者提供了强大的JavaScript验证脚本功能，允许对表单字段实施灵活的自定义验证规则。

根据Adobe官方文档，表单验证可以在用户输入数据时实时检查其有效性，防止错误数据进入系统，提高数据采集的准确性和效率。

基础验证脚本入门

简单的文本字段验证

让我们从一个基础示例开始：创建一个文本字段，只允许输入"AAAA"或"BBBB"这两个值。

// 设置验证默认通过
event.rc = true;

// 检查字段值是否为AAAA或BBBB
if (event.value != "AAAA" && event.value != "BBBB") {
    // 显示错误提示
    app.alert("输入的值必须为'AAAA'或'BBBB'");
    // 设置验证不通过
    event.rc = false;
}

验证脚本的工作原理

在Acrobat的事件对象中，有几个关键属性用于验证：

• event.value: 包含字段的当前值
• event.rc: 返回代码，决定验证是否通过
• event.target: 指向当前字段对象

验证脚本在用户离开字段 时触发，只有当event.rc设置为true时，输入才会被接受。

高级验证技巧

视觉反馈替代严格验证

有时，我们不想阻止用户继续填写表单，而是通过视觉提示来标识需要修正的字段：

// 始终允许字段值改变
event.rc = true;

// 检查值是否有效
if (event.value != "AAAA" && event.value != "BBBB") {
    // 显示警告但不阻止继续操作
    app.alert("输入的值必须为'AAAA'或'BBBB'");
    // 将文本颜色改为红色作为视觉提示
    event.target.textColor = color.red;
} else {
    // 有效值时恢复黑色文本
    event.target.textColor = color.black;
}

这种方法特别适用于复杂表单，用户可以先完成整体填写，再返回修正特定字段。

在表单中显示错误消息

为了避免用户忘记错误提示，可以将错误消息直接嵌入表单：

event.rc = true;
if (event.value != "AAAA" && event.value != "BBBB") {
    // 设置错误字段的值
    this.getField("ErrorField").value = "输入的值必须为'AAAA'或'BBBB'";
    event.target.textColor = color.red;
} else {
    this.getField("ErrorField").value = "";
    event.target.textColor = color.black;
}

实用验证脚本示例

电子邮件地址验证

// 电子邮件验证脚本
function validateEmail(email) {
    var re = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
    return re.test(email);
}

event.rc = true;
if (event.value != "" && !validateEmail(event.value)) {
    app.alert("请输入有效的电子邮件地址");
    event.target.textColor = color.red;
} else {
    event.target.textColor = color.black;
}

电话号码格式验证

// 电话号码格式验证 (XXX-XXX-XXXX)
var phonePattern = /^\d{3}-\d{3}-\d{4}$/;
event.rc = true;

if (event.value != "" && !phonePattern.test(event.value)) {
    app.alert("电话号码格式应为: XXX-XXX-XXXX");
    event.rc = false;
}

日期范围验证

// 日期范围验证
var inputDate = util.scand("mm/dd/yyyy", event.value);
var startDate = util.scand("mm/dd/yyyy", this.getField("StartDate").value);
var endDate = util.scand("mm/dd/yyyy", this.getField("EndDate").value);

event.rc = true;
if (inputDate < startDate || inputDate > endDate) {
    app.alert("日期必须在 " + 
              util.printd("mm/dd/yyyy", startDate) + 
              " 和 " + 
              util.printd("mm/dd/yyyy", endDate) + 
              " 之间");
    event.rc = false;
}

字段依赖验证

// 当复选框选中时，验证相关字段
var checkbox = this.getField("SpecialDiscount");
var discountField = this.getField("DiscountAmount");

event.rc = true;
if (checkbox.value != "Off" && event.value == "") {
    app.alert("当选择特别折扣时，必须填写折扣金额");
    event.target.fillColor = color.red;
    event.rc = false;
} else {
    event.target.fillColor = color.white;
}

表单验证架构设计

验证系统组件关系

以下UML图展示了表单验证系统中各组件的关系：
1 * 1 * generates AcroForm +String title +Array<Field> fields +validateForm() Field +String name +String type +String value +validate() +onBlur() ValidationRule +String type +String pattern +String message +checkValue(value) EventObject +String value +Boolean rc +Object target

表单级验证实现

除了字段级验证，还可以实现表单级验证，在提交时检查所有字段：

// 表单提交时的全局验证
function validateForm() {
    var errorFields = [];
    var fieldNames = [];
    
    // 获取所有字段名
    for (var i = 0; i < this.numFields; i++) {
        fieldNames.push(this.getNthFieldName(i));
    }
    
    // 检查每个字段
    for (var i = 0; i < fieldNames.length; i++) {
        var field = this.getField(fieldNames[i]);
        
        // 检查必填字段
        if (field.required && field.value == "") {
            errorFields.push(fieldNames[i]);
            field.fillColor = color.red;
        } else {
            field.fillColor = color.white;
        }
    }
    
    // 如果有错误，显示提示
    if (errorFields.length > 0) {
        app.alert("以下字段必须填写: " + errorFields.join(", "));
        return false;
    }
    
    return true;
}

// 在提交按钮中使用
if (validateForm()) {
    this.submitForm({
        cURL: "https://example.com/submit",
        cSubmitAs: "PDF"
    });
}

高级技巧与最佳实践

使用正则表达式进行复杂验证

// 使用正则表达式验证多种格式
function validateRegistration(number) {
    // 允许格式: 999999 或 99A9999A 或 AA999999 或 9999999
    var patterns = [
        /^\d{6}$/,           // 999999
        /^\d{2}[A-Z]\d{4}[A-Z]$/, // 99A9999A
        /^[A-Z]{2}\d{6}$/,   // AA999999
        /^\d{7}$/            // 9999999
    ];
    
    // 检查是否匹配任一模式
    for (var i = 0; i < patterns.length; i++) {
        if (patterns[i].test(number)) {
            return true;
        }
    }
    return false;
}

event.rc = true;
if (event.value != "" && !validateRegistration(event.value)) {
    app.alert("注册号格式无效，请使用以下格式之一:\n" +
              "999999, 99A9999A, AA999999 或 9999999");
    event.rc = false;
}

动态字段验证

根据其他字段的值动态调整验证规则：

// 根据用户类型动态调整验证
var userType = this.getField("UserType").value;
var emailField = this.getField("Email");

event.rc = true;

if (userType == "Admin") {
    // 管理员需要公司邮箱
    var companyPattern = /@company\.com$/;
    if (!companyPattern.test(event.value)) {
        app.alert("管理员必须使用公司邮箱地址");
        event.target.textColor = color.red;
        event.rc = false;
    }
} else {
    // 普通用户可以使用任何有效邮箱
    var emailPattern = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
    if (!emailPattern.test(event.value)) {
        app.alert("请输入有效的电子邮件地址");
        event.target.textColor = color.red;
        event.rc = false;
    }
}

if (event.rc) {
    event.target.textColor = color.black;
}

性能优化技巧

1. 避免过度验证：只在必要时进行复杂验证
2. 使用延迟验证：对实时性要求不高的检查可以在提交时进行
3. 缓存字段引用：避免重复获取字段对象

// 优化版本 - 缓存字段引用
var userTypeField = this.getField("UserType");
var userType = userTypeField.value;

// 只在值改变时验证
if (event.value != event.prevValue) {
    // 验证逻辑...
}

常见问题与解决方案

1. 验证触发时机问题

问题 ：验证脚本只在焦点离开字段时触发
解决方案：使用键盘事件进行实时验证

// 实时验证示例
function onKeyPress() {
    var value = event.value;
    // 实时验证逻辑
    if (value.length > 10) {
        event.target.textColor = color.red;
    } else {
        event.target.textColor = color.black;
    }
}

2. 多字段依赖验证

问题 ：字段验证依赖于其他字段的值
解决方案：使用计算脚本或文档级函数

// 文档级验证函数
function validateDependentFields() {
    var fieldA = this.getField("FieldA").value;
    var fieldB = this.getField("FieldB").value;
    
    if (fieldA > fieldB) {
        app.alert("字段A不能大于字段B");
        return false;
    }
    return true;
}

3. 验证与格式化冲突

问题 ：验证脚本与格式化脚本产生冲突
解决方案：确保执行顺序正确，必要时合并功能

// 合并验证和格式化
event.rc = true;

// 验证部分
if (event.value < 0) {
    app.alert("数值不能为负");
    event.rc = false;
    return;
}

// 格式化部分
if (event.value == 0) {
    event.value = "";
} else {
    event.value = "$" + event.value;
}

总结

Acrobat表单的JavaScript验证功能提供了强大的数据质量控制手段。通过合理运用字段级和表单级验证，可以创建用户体验良好、数据准确性高的智能表单。

关键要点：

• 理解event对象和验证流程是基础
• 视觉反馈比强制验证在某些场景下更友好
• 正则表达式是复杂验证的利器
• 考虑性能影响，避免过度验证

通过本文介绍的技巧和最佳实践，您应该能够创建出功能丰富、用户友好的PDF表单验证系统。

---

附录

单词与短语表

单词/短语	音标	词性	词根/词缀	释义	搭配	例句
validate	/ˈvælɪdeɪt/	v.	val- (价值) + -id + -ate	验证，确认	validate field, validate input	We need to validate the user's email address.
infrastructure	/ˈɪnfrəstrʌktʃər/	n.	infra- (下面) + structure	基础设施，基础结构	technical infrastructure	Adobe provided the infrastructure for form validation.
validation	/ˌvælɪˈdeɪʃən/	n.	val- + -id + -ation	验证，确认	validation script, data validation	Field validation ensures data quality.
communicate	/kəˈmjuːnɪkeɪt/	v.	commun- (共同) + -ic + -ate	通信，传达	communicate back, communicate value	The event object communicates the field value.
restore	/rɪˈstɔːr/	v.	re- (重新) + store	恢复，还原	restore value, restore previous	The previous value is restored if validation fails.
implication	/ˌɪmplɪˈkeɪʃən/	n.	im- (向内) + plic- (折叠) + -ation	含义，影响	important implications	This method has implications on form submission.
submission	/səbˈmɪʃən/	n.	sub- (下面) + miss- (发送) + -ion	提交，呈递	form submission, data submission	The submission function needs validation.
highlight	/ˈhaɪlaɪt/	v.	high + light	突出，强调	highlight field, highlight text	We can highlight the field in question.
navigation	/ˌnævɪˈɡeɪʃən/	n.	nav- (船) + ig- (驱动) + -ation	导航，航行	navigation pane, web navigation	Click the button to display the navigation pane.