@univerjs/sheets-data-validation 0.24.0 → 0.25.0-insiders.20260608-e4336f7

package/lib/locale/zh-CN.js

@@ -0,0 +1,138 @@
+//#region src/locale/zh-CN.ts
+const locale = { "sheets-data-validation": {
+	operators: {
+		between: "介于",
+		greaterThan: "大于",
+		greaterThanOrEqual: "大于或等于",
+		lessThan: "小于",
+		lessThanOrEqual: "小于或等于",
+		equal: "等于",
+		notEqual: "不等于",
+		notBetween: "未介于",
+		legal: "是合法类型"
+	},
+	ruleName: {
+		between: "介于 {FORMULA1} 和 {FORMULA2} 之间",
+		greaterThan: "大于 {FORMULA1}",
+		greaterThanOrEqual: "大于或等于 {FORMULA1}",
+		lessThan: "小于 {FORMULA1}",
+		lessThanOrEqual: "小于或等于 {FORMULA1}",
+		equal: "等于 {FORMULA1}",
+		notEqual: "不等于 {FORMULA1}",
+		notBetween: "在 {FORMULA1} 和 {FORMULA2} 范围之外",
+		legal: "是一个合法的 {TYPE}"
+	},
+	errorMsg: {
+		between: "值必须介于 {FORMULA1} 和 {FORMULA2} 之间",
+		greaterThan: "值必须大于 {FORMULA1}",
+		greaterThanOrEqual: "值必须大于或等于 {FORMULA1}",
+		lessThan: "值必须小于 {FORMULA1}",
+		lessThanOrEqual: "值必须小于或等于 {FORMULA1}",
+		equal: "值必须等于 {FORMULA1}",
+		notEqual: "值必须不等于 {FORMULA1}",
+		notBetween: "值必须在 {FORMULA1} 和 {FORMULA2} 范围之外",
+		legal: "值必须是一个合法的 {TYPE}"
+	},
+	date: {
+		operators: {
+			between: "介于",
+			greaterThan: "晚于",
+			greaterThanOrEqual: "晚于或等于",
+			lessThan: "早于",
+			lessThanOrEqual: "早于或等于",
+			equal: "等于",
+			notEqual: "不等于",
+			notBetween: "未介于",
+			legal: "是合法日期"
+		},
+		ruleName: {
+			between: "介于 {FORMULA1} 和 {FORMULA2} 之间",
+			greaterThan: "晚于 {FORMULA1}",
+			greaterThanOrEqual: "晚于或等于 {FORMULA1}",
+			lessThan: "早于 {FORMULA1}",
+			lessThanOrEqual: "早于或等于 {FORMULA1}",
+			equal: "等于 {FORMULA1}",
+			notEqual: "不等于 {FORMULA1}",
+			notBetween: "在 {FORMULA1} 和 {FORMULA2} 范围之外",
+			legal: "是一个合法的日期"
+		},
+		errorMsg: {
+			between: "必须为有效日期且介于 {FORMULA1} 和 {FORMULA2} 之间",
+			greaterThan: "必须为有效日期且晚于 {FORMULA1}",
+			greaterThanOrEqual: "必须为有效日期且晚于或等于 {FORMULA1}",
+			lessThan: "必须为有效日期且早于 {FORMULA1}",
+			lessThanOrEqual: "必须为有效日期且早于或等于 {FORMULA1}",
+			equal: "必须为有效日期且等于 {FORMULA1}",
+			notEqual: "必须为有效日期且不等于 {FORMULA1}",
+			notBetween: "必须为有效日期且在 {FORMULA1} 和 {FORMULA2} 范围之外",
+			legal: "值必须是一个合法的日期"
+		},
+		title: "日期"
+	},
+	textLength: {
+		errorMsg: {
+			between: "文本长度必须介于 {FORMULA1} 和 {FORMULA2} 之间",
+			greaterThan: "文本长度必须大于 {FORMULA1}",
+			greaterThanOrEqual: "文本长度必须大于或等于 {FORMULA1}",
+			lessThan: "文本长度必须小于 {FORMULA1}",
+			lessThanOrEqual: "文本长度必须小于或等于 {FORMULA1}",
+			equal: "文本长度必须等于 {FORMULA1}",
+			notEqual: "文本长度必须不等于 {FORMULA1}",
+			notBetween: "文本长度必须在 {FORMULA1} 和 {FORMULA2} 范围之外"
+		},
+		title: "文本长度"
+	},
+	custom: {
+		ruleName: "自定义公式 {FORMULA1}",
+		title: "自定义公式",
+		validFail: "请输入合法的公式",
+		error: "此单元格的内容违反了验证规则"
+	},
+	validFail: {
+		value: "请输入一个合法值",
+		common: "请输入值或公式",
+		number: "请输入合法的数字或公式",
+		formula: "请输入合法的公式",
+		integer: "请输入合法的整数或公式",
+		date: "请输入合法的日期或公式",
+		list: "请输入至少一个合法选项",
+		listInvalid: "列表源必须是分隔列表或对单行或列的引用。",
+		checkboxEqual: "为勾选和未勾选的单元格内容输入不同的值。",
+		formulaError: "引用范围内包含不可见的数据，请重新调整范围",
+		listIntersects: "所选范围不能和规则范围相交",
+		primitive: "自定义勾选和未勾选值不允许使用公式。"
+	},
+	any: {
+		title: "任意值",
+		error: "此单元格的内容违反了验证规则"
+	},
+	list: {
+		title: "下拉菜单",
+		name: "值必须是列表中的值",
+		error: "输入必须在指定的范围内",
+		emptyError: "请输入一个值",
+		add: "添加选项",
+		dropdown: "单选",
+		options: "选项来源",
+		customOptions: "自定义",
+		refOptions: "引用数据",
+		formulaError: "列表源必须是划定分界后的数据列表,或是对单一行或一列的引用。",
+		edit: "编辑"
+	},
+	listMultiple: {
+		title: "下拉菜单-多选",
+		dropdown: "多选"
+	},
+	decimal: { title: "数字" },
+	whole: { title: "整数" },
+	checkbox: {
+		title: "复选框",
+		error: "此单元格的内容违反了验证规则",
+		tips: "在单元格内使用自定义值",
+		checked: "选中值",
+		unchecked: "未选中值"
+	}
+} };
+
+//#endregion
+export { locale as default };

package/lib/locale/zh-HK.js

@@ -0,0 +1,138 @@
+//#region src/locale/zh-HK.ts
+const locale = { "sheets-data-validation": {
+	operators: {
+		between: "介於",
+		greaterThan: "大於",
+		greaterThanOrEqual: "大於或等於",
+		lessThan: "小於",
+		lessThanOrEqual: "小於或等於",
+		equal: "等於",
+		notEqual: "不等於",
+		notBetween: "未介於",
+		legal: "是合法類型"
+	},
+	ruleName: {
+		between: "介於 {FORMULA1} 和 {FORMULA2} 之間",
+		greaterThan: "大於 {FORMULA1}",
+		greaterThanOrEqual: "大於或等於 {FORMULA1}",
+		lessThan: "小於 {FORMULA1}",
+		lessThanOrEqual: "小於或等於 {FORMULA1}",
+		equal: "等於 {FORMULA1}",
+		notEqual: "不等於 {FORMULA1}",
+		notBetween: "在 {FORMULA1} 和 {FORMULA2} 範圍之外",
+		legal: "是一個合法的 {TYPE}"
+	},
+	errorMsg: {
+		between: "值必須介於 {FORMULA1} 和 {FORMULA2} 之間",
+		greaterThan: "值必須大於 {FORMULA1}",
+		greaterThanOrEqual: "值必須大於或等於 {FORMULA1}",
+		lessThan: "值必須小於 {FORMULA1}",
+		lessThanOrEqual: "值必須小於或等於 {FORMULA1}",
+		equal: "值必須等於 {FORMULA1}",
+		notEqual: "值必須不等於 {FORMULA1}",
+		notBetween: "值必須在 {FORMULA1} 和 {FORMULA2} 範圍之外",
+		legal: "值必須是一個合法的 {TYPE}"
+	},
+	date: {
+		operators: {
+			between: "介於",
+			greaterThan: "晚於",
+			greaterThanOrEqual: "晚於或等於",
+			lessThan: "早於",
+			lessThanOrEqual: "早於或等於",
+			equal: "等於",
+			notEqual: "不等於",
+			notBetween: "未介於",
+			legal: "是合法日期"
+		},
+		ruleName: {
+			between: "介於 {FORMULA1} 和 {FORMULA2} 之間",
+			greaterThan: "晚於 {FORMULA1}",
+			greaterThanOrEqual: "晚於或等於 {FORMULA1}",
+			lessThan: "早於 {FORMULA1}",
+			lessThanOrEqual: "早於或等於 {FORMULA1}",
+			equal: "等於 {FORMULA1}",
+			notEqual: "不等於 {FORMULA1}",
+			notBetween: "在 {FORMULA1} 和 {FORMULA2} 範圍之外",
+			legal: "是一個合法的日期"
+		},
+		errorMsg: {
+			between: "日期必須介於 {FORMULA1} 和 {FORMULA2} 之間",
+			greaterThan: "日期必須晚於 {FORMULA1}",
+			greaterThanOrEqual: "日期必須晚於或等於 {FORMULA1}",
+			lessThan: "日期必須早於 {FORMULA1}",
+			lessThanOrEqual: "早於或等於 {FORMULA1}",
+			equal: "日期必須等於 {FORMULA1}",
+			notEqual: "日期必須不等於 {FORMULA1}",
+			notBetween: "日期必須在 {FORMULA1} 和 {FORMULA2} 範圍之外",
+			legal: "值必須是一個合法的日期"
+		},
+		title: "日期"
+	},
+	textLength: {
+		errorMsg: {
+			between: "文字長度必須介於 {FORMULA1} 和 {FORMULA2} 之間",
+			greaterThan: "文字長度必須大於 {FORMULA1}",
+			greaterThanOrEqual: "文字長度必須大於或等於 {FORMULA1}",
+			lessThan: "文字長度必須小於 {FORMULA1}",
+			lessThanOrEqual: "文字長度必須小於或等於 {FORMULA1}",
+			equal: "文字長度必須等於 {FORMULA1}",
+			notEqual: "文字長度必須不等於 {FORMULA1}",
+			notBetween: "文字長度必須在 {FORMULA1} 和 {FORMULA2} 範圍之外"
+		},
+		title: "文字長度"
+	},
+	custom: {
+		ruleName: "自訂公式 {FORMULA1}",
+		title: "自訂公式",
+		validFail: "請輸入合法的公式",
+		error: "此儲存格的內容違反了驗證規則"
+	},
+	validFail: {
+		value: "請輸入一個合法值",
+		common: "請輸入數值或公式",
+		number: "請輸入合法的數字或公式",
+		formula: "請輸入合法的公式",
+		integer: "請輸入合法的整數或公式",
+		date: "請輸入合法的日期或公式",
+		list: "請輸入至少一個合法選項",
+		listInvalid: "清單來源必須是分隔清單或單列或欄的參考。 ",
+		checkboxEqual: "為勾選和未勾選的儲存格內容輸入不同的值。 ",
+		formulaError: "引用範圍內包含不可見的數據，請重新調整範圍",
+		listIntersects: "所選範圍不能和規則範圍相交",
+		primitive: "自訂勾選和未勾選值不允許使用公式。 "
+	},
+	any: {
+		title: "任意值",
+		error: "此儲存格的內容違反了驗證規則"
+	},
+	list: {
+		title: "下拉選單",
+		name: "值必須是列表中的值",
+		error: "輸入必須在指定的範圍內",
+		emptyError: "請輸入一個值",
+		add: "新增選項",
+		dropdown: "單選",
+		options: "選項來源",
+		customOptions: "自訂",
+		refOptions: "引用資料",
+		formulaError: "列表來源必須是劃定分界後的資料列表,或是對單一列或欄的引用。",
+		edit: "編輯"
+	},
+	listMultiple: {
+		title: "下拉式選單-多選",
+		dropdown: "多選"
+	},
+	decimal: { title: "數字" },
+	whole: { title: "整數" },
+	checkbox: {
+		title: "複選框",
+		error: "此儲存格的內容違反了驗證規則",
+		tips: "在儲存格內使用自訂值",
+		checked: "選取值",
+		unchecked: "未選取值"
+	}
+} };
+
+//#endregion
+export { locale as default };

package/lib/locale/zh-TW.js

@@ -0,0 +1,138 @@
+//#region src/locale/zh-TW.ts
+const locale = { "sheets-data-validation": {
+	operators: {
+		between: "介於",
+		greaterThan: "大於",
+		greaterThanOrEqual: "大於或等於",
+		lessThan: "小於",
+		lessThanOrEqual: "小於或等於",
+		equal: "等於",
+		notEqual: "不等於",
+		notBetween: "未介於",
+		legal: "是合法類型"
+	},
+	ruleName: {
+		between: "介於 {FORMULA1} 和 {FORMULA2} 之間",
+		greaterThan: "大於 {FORMULA1}",
+		greaterThanOrEqual: "大於或等於 {FORMULA1}",
+		lessThan: "小於 {FORMULA1}",
+		lessThanOrEqual: "小於或等於 {FORMULA1}",
+		equal: "等於 {FORMULA1}",
+		notEqual: "不等於 {FORMULA1}",
+		notBetween: "在 {FORMULA1} 和 {FORMULA2} 範圍之外",
+		legal: "是一個合法的 {TYPE}"
+	},
+	errorMsg: {
+		between: "值必須介於 {FORMULA1} 和 {FORMULA2} 之間",
+		greaterThan: "值必須大於 {FORMULA1}",
+		greaterThanOrEqual: "值必須大於或等於 {FORMULA1}",
+		lessThan: "值必須小於 {FORMULA1}",
+		lessThanOrEqual: "值必須小於或等於 {FORMULA1}",
+		equal: "值必須等於 {FORMULA1}",
+		notEqual: "值必須不等於 {FORMULA1}",
+		notBetween: "值必須在 {FORMULA1} 和 {FORMULA2} 範圍之外",
+		legal: "值必須是一個合法的 {TYPE}"
+	},
+	date: {
+		operators: {
+			between: "介於",
+			greaterThan: "晚於",
+			greaterThanOrEqual: "晚於或等於",
+			lessThan: "早於",
+			lessThanOrEqual: "早於或等於",
+			equal: "等於",
+			notEqual: "不等於",
+			notBetween: "未介於",
+			legal: "是合法日期"
+		},
+		ruleName: {
+			between: "介於 {FORMULA1} 和 {FORMULA2} 之間",
+			greaterThan: "晚於 {FORMULA1}",
+			greaterThanOrEqual: "晚於或等於 {FORMULA1}",
+			lessThan: "早於 {FORMULA1}",
+			lessThanOrEqual: "早於或等於 {FORMULA1}",
+			equal: "等於 {FORMULA1}",
+			notEqual: "不等於 {FORMULA1}",
+			notBetween: "在 {FORMULA1} 和 {FORMULA2} 範圍之外",
+			legal: "是一個合法的日期"
+		},
+		errorMsg: {
+			between: "日期必須介於 {FORMULA1} 和 {FORMULA2} 之間",
+			greaterThan: "日期必須晚於 {FORMULA1}",
+			greaterThanOrEqual: "日期必須晚於或等於 {FORMULA1}",
+			lessThan: "日期必須早於 {FORMULA1}",
+			lessThanOrEqual: "早於或等於 {FORMULA1}",
+			equal: "日期必須等於 {FORMULA1}",
+			notEqual: "日期必須不等於 {FORMULA1}",
+			notBetween: "日期必須在 {FORMULA1} 和 {FORMULA2} 範圍之外",
+			legal: "值必須是一個合法的日期"
+		},
+		title: "日期"
+	},
+	textLength: {
+		errorMsg: {
+			between: "文字長度必須介於 {FORMULA1} 和 {FORMULA2} 之間",
+			greaterThan: "文字長度必須大於 {FORMULA1}",
+			greaterThanOrEqual: "文字長度必須大於或等於 {FORMULA1}",
+			lessThan: "文字長度必須小於 {FORMULA1}",
+			lessThanOrEqual: "文字長度必須小於或等於 {FORMULA1}",
+			equal: "文字長度必須等於 {FORMULA1}",
+			notEqual: "文字長度必須不等於 {FORMULA1}",
+			notBetween: "文字長度必須在 {FORMULA1} 和 {FORMULA2} 範圍之外"
+		},
+		title: "文字長度"
+	},
+	custom: {
+		ruleName: "自訂公式 {FORMULA1}",
+		title: "自訂公式",
+		validFail: "請輸入合法的公式",
+		error: "此儲存格的內容違反了驗證規則"
+	},
+	validFail: {
+		value: "請輸入一個合法值",
+		common: "請輸入數值或公式",
+		number: "請輸入合法的數字或公式",
+		formula: "請輸入合法的公式",
+		integer: "請輸入合法的整數或公式",
+		date: "請輸入合法的日期或公式",
+		list: "請輸入至少一個合法選項",
+		listInvalid: "清單來源必須是分隔清單或單列或欄的參考。 ",
+		checkboxEqual: "為勾選和未勾選的儲存格內容輸入不同的值。 ",
+		formulaError: "引用範圍內包含不可見的數據，請重新調整範圍",
+		listIntersects: "所選範圍不能和規則範圍相交",
+		primitive: "自訂勾選和未勾選值不允許使用公式。 "
+	},
+	any: {
+		title: "任意值",
+		error: "此儲存格的內容違反了驗證規則"
+	},
+	list: {
+		title: "下拉選單",
+		name: "值必須是列表中的值",
+		error: "輸入必須在指定的範圍內",
+		emptyError: "請輸入一個值",
+		add: "新增選項",
+		dropdown: "單選",
+		options: "選項來源",
+		customOptions: "自訂",
+		refOptions: "引用資料",
+		formulaError: "列表來源必須是劃定分界後的資料列表,或是對單一列或欄的引用。",
+		edit: "編輯"
+	},
+	listMultiple: {
+		title: "下拉式選單-多選",
+		dropdown: "多選"
+	},
+	decimal: { title: "數字" },
+	whole: { title: "整數" },
+	checkbox: {
+		title: "複選框",
+		error: "此儲存格的內容違反了驗證規則",
+		tips: "在儲存格內使用自訂值",
+		checked: "選取值",
+		unchecked: "未選取值"
+	}
+} };
+
+//#endregion
+export { locale as default };

package/lib/types/facade/f-data-validation-builder.d.ts

@@ -23,7 +23,8 @@ import { FDataValidation } from './f-data-validation';
  * ```typescript
  * // Set the data validation for cell A1 to require a value from B1:B10
  * const fWorkbook = univerAPI.getActiveWorkbook();
- * const fWorksheet = fWorkbook.getActiveSheet();
+ * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+ * if (!fWorksheet) return;
  * const fRange = fWorksheet.getRange('B1:B2');
  * fRange.setValues([
  *   ['Yes'],
@@ -52,7 +53,8 @@ export declare class FDataValidationBuilder {
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a new data validation rule that requires a number between 1 and 10 for the range A1:B10
      * const fRange = fWorksheet.getRange('A1:B10');
@@ -74,7 +76,8 @@ export declare class FDataValidationBuilder {
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a new data validation rule that requires a number between 1 and 10 for the range A1:B10
      * const fRange = fWorksheet.getRange('A1:B10');
@@ -155,7 +158,8 @@ export declare class FDataValidationBuilder {
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Set the data validation for cell A1:A10 to require a checkbox with default 1 and 0 values
      * const fRange = fWorksheet.getRange('A1:A10');
@@ -180,7 +184,8 @@ export declare class FDataValidationBuilder {
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Set some date values in the range A1:B2
      * const fRange = fWorksheet.getRange('A1:B2');
@@ -208,7 +213,8 @@ export declare class FDataValidationBuilder {
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Set some date values in the range A1:B2
      * const fRange = fWorksheet.getRange('A1:B2');
@@ -237,7 +243,8 @@ export declare class FDataValidationBuilder {
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Set some date values in the range A1:B2
      * const fRange = fWorksheet.getRange('A1:B2');
@@ -265,7 +272,8 @@ export declare class FDataValidationBuilder {
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Set some date values in the range A1:B2
      * const fRange = fWorksheet.getRange('A1:B2');
@@ -298,7 +306,8 @@ export declare class FDataValidationBuilder {
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Set some date values in the range A1:B2
      * const fRange = fWorksheet.getRange('A1:B2');
@@ -326,7 +335,8 @@ export declare class FDataValidationBuilder {
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Set some date values in the range A1:B2
      * const fRange = fWorksheet.getRange('A1:B2');
@@ -354,7 +364,8 @@ export declare class FDataValidationBuilder {
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Set some date values in the range A1:B2
      * const fRange = fWorksheet.getRange('A1:B2');
@@ -382,7 +393,8 @@ export declare class FDataValidationBuilder {
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Set some values in the range A1:B2 and C1:D2
      * const cell = fWorksheet.getRange('A1:B2');
@@ -421,7 +433,8 @@ export declare class FDataValidationBuilder {
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a new data validation rule that requires a number between 1 and 10 for the range A1:B10
      * const fRange = fWorksheet.getRange('A1:B10');
@@ -445,7 +458,8 @@ export declare class FDataValidationBuilder {
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a new data validation rule that requires a number equal to 10 for the range A1:B10
      * const fRange = fWorksheet.getRange('A1:B10');
@@ -469,7 +483,8 @@ export declare class FDataValidationBuilder {
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a new data validation rule that requires a number greater than 10 for the range A1:B10
      * const fRange = fWorksheet.getRange('A1:B10');
@@ -493,7 +508,8 @@ export declare class FDataValidationBuilder {
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a new data validation rule that requires a number greater than 10 or equal to 10 for the range A1:B10
      * const fRange = fWorksheet.getRange('A1:B10');
@@ -517,7 +533,8 @@ export declare class FDataValidationBuilder {
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a new data validation rule that requires a number less than 10 for the range A1:B10
      * const fRange = fWorksheet.getRange('A1:B10');
@@ -541,7 +558,8 @@ export declare class FDataValidationBuilder {
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a new data validation rule that requires a number less than 10 or equal to 10 for the range A1:B10
      * const fRange = fWorksheet.getRange('A1:B10');
@@ -566,7 +584,8 @@ export declare class FDataValidationBuilder {
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a new data validation rule that requires a number not between 1 and 10 for the range A1:B10
      * const fRange = fWorksheet.getRange('A1:B10');
@@ -590,7 +609,8 @@ export declare class FDataValidationBuilder {
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a new data validation rule that requires a number not equal to 10 for the range A1:B10
      * const fRange = fWorksheet.getRange('A1:B10');
@@ -616,7 +636,8 @@ export declare class FDataValidationBuilder {
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a new data validation rule that requires the user to enter a value from the list ['Yes', 'No'] for the range A1:B10
      * const fRange = fWorksheet.getRange('A1:B10');
@@ -642,7 +663,8 @@ export declare class FDataValidationBuilder {
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Set the values in the range B1:B2
      * const fRange = fWorksheet.getRange('B1:B2');
@@ -674,7 +696,8 @@ export declare class FDataValidationBuilder {
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Set the data validation for cell A1:B2 to allow invalid data, so A1:B2 will display a warning when invalid data is entered
      * const fRange = fWorksheet.getRange('A1:B2');
@@ -702,7 +725,8 @@ export declare class FDataValidationBuilder {
      * ```typescript
      * // Assume current sheet is empty data
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Set the data validation for cell A1:B2 to allow blank values
      * const fRange = fWorksheet.getRange('A1:B2');
@@ -729,7 +753,8 @@ export declare class FDataValidationBuilder {
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a new data validation rule that requires the user to enter a value from the list ['Yes', 'No'] for the range A1:B10
      * const fRange = fWorksheet.getRange('A1:B10');