元件校驗

1.1 版本

1.2 應用場景

填報元件是可以設定校驗規則的，使用者在元件中錄入的內容如果不滿足規則，會彈出校驗出錯的提示資訊。

如下圖是正文元件設定了手機號校驗，如果填寫的內容不滿足手機號格式，那麼校驗不予通過，如下圖所示。

對於滿足手機號格式的內容，在確認後校驗予以通過。

1.3 功能入口

不是所有元件都能設定校驗，只有部分元件在屬性面板下會有校驗設定項，如下圖所示。

• 11.0.9之前（未安裝文字元件校驗國際化插件）

• 11.0.9（及11.0.9之前安裝了文字元件校驗國際化插件）

校驗規則	規則說明	圖示	支援的元件
允許爲空	是否允許元件內容為空 支援自訂錯誤提示		文字元件 文字域元件 數字元件 密碼元件 單選按鈕組元件 複選按鈕組元件 下拉框元件 下拉複選框元件 日期元件 檔案元件 列儲存格件 下拉樹元件 檢視表樹元件
長度	可以限制正文的字數 可以設定最小和最大字數 支援自訂錯誤提示		文字元件 文字域元件 密碼元件
郵件	填寫內容必須是郵件格式 支援自訂錯誤提示		文字元件
身分證	填寫內容必須是身分證格式 支援自訂錯誤提示		文字元件
郵派區號	填寫內容必須是郵派區號格式 支援自訂錯誤提示		文字元件
電話	填寫內容必須是電話格式 可以選擇電話的資料型別 支援自訂錯誤提		文字元件
手機	填寫內容必須是手機格式 支援自訂錯誤提示		文字元件
自訂	使用正則表式自訂規則 詳細介紹參見：正則表式定義規則 支援自訂錯誤提示		文字域元件 密碼元件
允許小數	是否允許數字帶小數 可以設定最多的小數位數		數字元件
允許負數	是否允許數字為負數		數字元件
需要最大值 需要最小值	將數字限定在某個範圍內 可以設定最大數和最小數 支援自訂錯誤提示		數字元件
允許直接編輯	下拉框內能否直接填寫內容		下拉框元件 下拉複選框元件 日期元件 下拉樹元件
允許自訂值	元件儲存格中能否輸入不在下拉選單選項中的值。不能輸入時，若直接在元件所在的儲存格中填寫內容，當填入值不包含在下拉選單選項中，下拉框會自動清除輸入值，並會彈出提示框【值不在下拉欄表內】； 11.0.2 及之後不通過直接填寫，如 Excel 匯入、值通過公式計算所得、從Excel 中複制貼補、值通過JS 給儲存格指派所得也會觸發校驗，【提交】和【資料校驗】時若不滿 足則彈窗提醒【不允許自訂值】。		下拉框元件 下拉複選框元件 下拉樹元件
特殊 （文字元件校驗國際化插件）	11.0.9之前版本若需使用此功能，請安裝正文元件校驗國際化插件。 點選下載：文字元件校驗國際化插件 11.0.9版本此功能已內建，可直接使用。 注：此功能支援的區域有中國大陸、中國台灣、美國、日本、南韓，不同區域支援驗證的資料型別可能不同，中國大陸、中國台灣和南韓支援驗證手機、身分證、郵遞區號；美國支援驗證手機、郵遞區號、社會安全碼；日本支援驗證手機、郵遞區號。 以往的文字元件的內建校驗規則僅支援中國大陸的郵遞區號、身分證、手機等，而臺灣在地的特有資料校驗則需要寫正則運算式來實現。 文字元件校驗規則增強插件可以支援校驗臺灣在地的身分證、手機、郵遞區號，無需再設定正則運算式。		文字元件

3.1 單個元件校驗

當設定了元件填寫規則，如下圖所示：

在填報時，元件會進行失焦校驗。當不符合規則則元件標紅，出現錯誤提示。如下圖所示：

3.2 整體校驗

行動端元件在校驗設定不允許為空時。

報錯會提示有「校驗失敗」且校驗失敗的元件標紅，預設報錯提示為「錯誤的輸入值」。如下圖所示：

如果設定了錯誤提示。

效果如下圖所示：

1）填寫不符合校驗條件的資料後，元件會自動傳回上一次填寫的內容。

2）填報提交時，也會根據元件的校驗條件來檢查提交資料。

3）Excel 匯入時不會觸發元件自身設定的校驗，11.0.2 及之後會觸發【允許自訂值】的校驗。

4）行動端也是支援元件校驗的，效果如下圖所示。