ONLYOFFICE 表單可以輕松收集結構化輸入，但空的、非必填字段經常會被忽略。在本篇博文中，我們將演示如何構建一個宏，用于突出顯示表單中所有空的、非必填字段，或者僅突出顯示包含特定提示文本的字段。

ONLYOFFICE Docs 最新下載

構建宏

1. 檢索表單數據和實時表單對象

該宏首先使用 Api.GetDocument() 訪問活動文檔。然后，我們檢索兩組信息：

• 表單數據：使用 doc.GetFormsData()，我們獲取所有表單字段的 JSON 表示。此 JSON 包含諸如鍵、類型、值、提示以及字段是否必填等屬性。
• 活動表單對象：我們使用 doc.GetAllForms() 來檢索與這些表單字段對應的活動對象。

    var doc = Api.GetDocument();
    var forms = doc.GetAllForms();
    var formsData = JSON.parse(JSON.stringify(doc.GetFormsData()));

2. 可選的基于提示的驗證

有時您可能只想檢查那些帶有特定提示文本的空字段。在我們的宏中，您可以通過切換 checkSpecificTip 變量來啟用或禁用此功能。例如，您可能需要只驗證提示為“請輸入您的第二個地址”的字段。

   // Optional: set to true to check only fields with a specific tip text.
    var checkSpecificTip = false;
    var requiredTipText = "Please enter your second address"; // Change this as needed.

3. 循環遍歷每個表單字段

然后，該宏會遍歷 JSON 數據中的每個表單字段。我們只關注文本表單字段（類型為“text”）。對于每個未標記為必填的文本字段，我們會檢查其值是否為空。

forms.forEach(function(form) {
        if (form.GetFormType() === "textForm") {
            var key = form.GetFormKey();
            var required = form.IsRequired()
            // Find corresponding form data by key.
            var formData = formsData.find(function(fd) {
                return fd.key === key;
            });
            if (formData) {
                // A field is considered empty if its value is missing or only whitespace.
                var isEmpty = !formData.value || formData.value.trim() === "";
                // Use the live form's GetTip() to get the tip (if available).
                var tip = form.GetTipText() ? form.GetTipText() : "";
                
                var shouldCheck = !checkSpecificTip || (checkSpecificTip && tip.trim() === requiredTipText.trim());


                if (shouldCheck && isEmpty && !required) {
                    form.SetBorderColor(0,255,127); // spring green border.
                    form.SetBackgroundColor(171, 242, 255); // Light blue background.
                    invalidCount++;
                }
            }
        }
    });

• 檢查字段值：
  如果字段的 JSON“值”屬性缺失或僅存在空格，則該字段被視為空。
• 提示過濾：
  如果啟用了 checkSpecificTip，我們只檢查提示與 requiredTipText 匹配的字段。
• 高亮：
  對于符合條件的字段，我們找到對應的實時表單對象（通過匹配鍵），并設置春綠色邊框和淺藍色背景。

4.記錄結果

最后，宏記錄突出顯示的空的不需要的文本字段的總數。

console.log("Form Field Validator complete. " + invalidCount + " empty unrequired text field(s) highlighted.");

完整的宏代碼

(function () {
    // Optional: set to true to check only fields with a specific tip text.
    var checkSpecificTip = false;
    var requiredTipText = "Please enter your second address"; // Change this as needed.


    var doc = Api.GetDocument();
    var forms = doc.GetAllForms();
    var formsData = JSON.parse(JSON.stringify(doc.GetFormsData()));
    var invalidCount = 0;



    forms.forEach(function(form) {
        if (form.GetFormType() === "textForm") {
            var key = form.GetFormKey();
            var required = form.IsRequired()
            // Find corresponding form data by key.
            var formData = formsData.find(function(fd) {
                return fd.key === key;
            });
            if (formData) {
                // A field is considered empty if its value is missing or only whitespace.
                var isEmpty = !formData.value || formData.value.trim() === "";
                // Use the live form's GetTip() to get the tip (if available).
                var tip = form.GetTipText() ? form.GetTipText() : "";
                
                var shouldCheck = !checkSpecificTip || (checkSpecificTip && tip.trim() === requiredTipText.trim());


                if (shouldCheck && isEmpty && !required) {
                    form.SetBorderColor(0,255,127); // spring green border.
                    form.SetBackgroundColor(171, 242, 255); // Light blue background.
                    invalidCount++;
                }
            }
        }
    });
    console.log("Form Field Validator complete. " + invalidCount + " empty unrequired text field(s) highlighted.");
})();

現在，讓我們運行宏并看看它是如何工作的！

此宏會自動檢測并高亮顯示包含預定義占位符文本的空文本字段，從而節省時間并減少重復工作。我們希望它能夠幫助您優化 ONLYOFFICE 表單并提升整體工作流程效率。

關于慧都科技：

慧都科技是一家行業數字化解決方案公司，長期專注于軟件、油氣與制造行業。公司基于深入的業務理解與管理洞察，以系統化的業務建模驅動技術落地，幫助企業實現智能化運營與長期競爭優勢。在軟件工程領域，我們提供開發控件、研發管理、代碼開發、部署運維等軟件開發全鏈路所需的產品，提供正版授權采購、技術選型、個性化維保等服務，幫助客戶實現技術合規、降本增效與風險可控。慧都科技ONLYOFFICE在中國的官方授權代理商，提供ONLYOFFICE系列產品免費試用，咨詢，正版銷售等于一體的專業化服務。ONLYOFFICE是文檔在線編輯領域的優秀產品，幫助企業實現高效的文檔協同處理。

下載|體驗更多ONLYOFFICE產品，請咨詢，或撥打產品熱線：023-68661681