@univerjs/sheets-conditional-formatting 0.24.0 → 0.25.0-insiders.20260608-e4336f7

package/lib/types/facade/f-conditional-formatting-builder.d.ts

@@ -32,7 +32,8 @@ declare class ConditionalFormatRuleBaseBuilder {
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that highlights cells with no content in red for the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');
@@ -51,7 +52,8 @@ declare class ConditionalFormatRuleBaseBuilder {
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that highlights cells with no content in red for the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');
@@ -92,7 +94,8 @@ declare class ConditionalFormatRuleBaseBuilder {
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that highlights cells with no content in red for the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');
@@ -117,7 +120,8 @@ declare class ConditionalFormatHighlightRuleBuilder extends ConditionalFormatRul
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that highlights cells with no content in red for the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');
@@ -143,7 +147,8 @@ declare class ConditionalFormatHighlightRuleBuilder extends ConditionalFormatRul
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that highlights cells with greater than average values in red for the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');
@@ -162,7 +167,8 @@ declare class ConditionalFormatHighlightRuleBuilder extends ConditionalFormatRul
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that highlights cells with unique values in red for the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');
@@ -181,7 +187,8 @@ declare class ConditionalFormatHighlightRuleBuilder extends ConditionalFormatRul
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that highlights cells with duplicate values in red for the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');
@@ -204,7 +211,8 @@ declare class ConditionalFormatHighlightRuleBuilder extends ConditionalFormatRul
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that highlights the bottom 10% of values in red for the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');
@@ -228,7 +236,8 @@ declare class ConditionalFormatHighlightRuleBuilder extends ConditionalFormatRul
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that highlights cells with no content in red for the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');
@@ -248,7 +257,8 @@ declare class ConditionalFormatHighlightRuleBuilder extends ConditionalFormatRul
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that bolds the text for cells with not empty content in the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');
@@ -268,7 +278,8 @@ declare class ConditionalFormatHighlightRuleBuilder extends ConditionalFormatRul
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that changes the font color to red for cells with not empty content in the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');
@@ -288,7 +299,8 @@ declare class ConditionalFormatHighlightRuleBuilder extends ConditionalFormatRul
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that italicizes the text for cells with not empty content in the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');
@@ -308,7 +320,8 @@ declare class ConditionalFormatHighlightRuleBuilder extends ConditionalFormatRul
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that set text strikethrough for cells with not empty content in the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');
@@ -328,7 +341,8 @@ declare class ConditionalFormatHighlightRuleBuilder extends ConditionalFormatRul
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that underlines the text for cells with not empty content in the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');
@@ -347,7 +361,8 @@ declare class ConditionalFormatHighlightRuleBuilder extends ConditionalFormatRul
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that highlights cells with no content in red for the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');
@@ -366,7 +381,8 @@ declare class ConditionalFormatHighlightRuleBuilder extends ConditionalFormatRul
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that changes the font color to red for cells with not empty content in the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');
@@ -386,7 +402,8 @@ declare class ConditionalFormatHighlightRuleBuilder extends ConditionalFormatRul
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that highlights cells with dates in the last 7 days in red for the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');
@@ -406,7 +423,8 @@ declare class ConditionalFormatHighlightRuleBuilder extends ConditionalFormatRul
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that highlights cells with values greater than 10 in red for the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');
@@ -427,7 +445,8 @@ declare class ConditionalFormatHighlightRuleBuilder extends ConditionalFormatRul
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that highlights cells with values between 10 and 20 in red for the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');
@@ -447,7 +466,8 @@ declare class ConditionalFormatHighlightRuleBuilder extends ConditionalFormatRul
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that highlights cells with values equal to 10 in red for the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');
@@ -467,7 +487,8 @@ declare class ConditionalFormatHighlightRuleBuilder extends ConditionalFormatRul
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that highlights cells with values greater than 10 in red for the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');
@@ -487,7 +508,8 @@ declare class ConditionalFormatHighlightRuleBuilder extends ConditionalFormatRul
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that highlights cells with values greater than or equal to 10 in red for the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');
@@ -507,7 +529,8 @@ declare class ConditionalFormatHighlightRuleBuilder extends ConditionalFormatRul
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that highlights cells with values less than 10 in red for the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');
@@ -527,7 +550,8 @@ declare class ConditionalFormatHighlightRuleBuilder extends ConditionalFormatRul
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that highlights cells with values less than or equal to 10 in red for the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');
@@ -548,7 +572,8 @@ declare class ConditionalFormatHighlightRuleBuilder extends ConditionalFormatRul
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that highlights cells with values not between 10 and 20 in red for the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');
@@ -568,7 +593,8 @@ declare class ConditionalFormatHighlightRuleBuilder extends ConditionalFormatRul
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that highlights cells with values not equal to 10 in red for the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');
@@ -588,7 +614,8 @@ declare class ConditionalFormatHighlightRuleBuilder extends ConditionalFormatRul
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that highlights cells with text containing 'apple' in red for the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');
@@ -608,7 +635,8 @@ declare class ConditionalFormatHighlightRuleBuilder extends ConditionalFormatRul
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that highlights cells with text not containing 'apple' in red for the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');
@@ -628,7 +656,8 @@ declare class ConditionalFormatHighlightRuleBuilder extends ConditionalFormatRul
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that highlights cells with text ending with '.ai' in red for the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');
@@ -648,7 +677,8 @@ declare class ConditionalFormatHighlightRuleBuilder extends ConditionalFormatRul
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that highlights cells with text equal to 'apple' in red for the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');
@@ -668,7 +698,8 @@ declare class ConditionalFormatHighlightRuleBuilder extends ConditionalFormatRul
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that highlights cells with text starting with 'https://' in red for the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');
@@ -689,7 +720,8 @@ declare class ConditionalFormatDataBarRuleBuilder extends ConditionalFormatRuleB
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that adds a data bar to cells with values between -100 and 100 in the range A1:D10.
      * // positive values are green and negative values are red.
@@ -733,7 +765,8 @@ declare class ConditionalFormatDataBarRuleBuilder extends ConditionalFormatRuleB
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that adds a data bar to cells with values between -100 and 100 in the range A1:D10.
      * // positive values are green and negative values are red.
@@ -767,7 +800,8 @@ declare class ConditionalFormatColorScaleRuleBuilder extends ConditionalFormatRu
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that adds a color scale to cells with values between 0 and 100 in the range A1:D10.
      * // The color scale is green for 0, yellow for 50, and red for 100.
@@ -799,7 +833,8 @@ declare class ConditionalFormatColorScaleRuleBuilder extends ConditionalFormatRu
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that adds a color scale to cells with values between 0 and 100 in the range A1:D10.
      * // The color scale is green for 0, yellow for 50, and red for 100.
@@ -824,7 +859,8 @@ declare class ConditionalFormatIconSetRuleBuilder extends ConditionalFormatRuleB
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a 3-arrow icon set conditional formatting rule in the range A1:D10.
      * // The first arrow is green for values greater than 20.
@@ -884,7 +920,8 @@ declare class ConditionalFormatIconSetRuleBuilder extends ConditionalFormatRuleB
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a 3-arrow icon set conditional formatting rule in the range A1:D10.
      * // The first arrow is green for values greater than 20.
@@ -949,7 +986,8 @@ export declare class FConditionalFormattingBuilder {
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that highlights cells with values greater than 10 in red for the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');
@@ -969,7 +1007,8 @@ export declare class FConditionalFormattingBuilder {
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that highlights cells with greater than average values in red for the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');
@@ -988,7 +1027,8 @@ export declare class FConditionalFormattingBuilder {
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that highlights cells with unique values in red for the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');
@@ -1007,7 +1047,8 @@ export declare class FConditionalFormattingBuilder {
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that highlights cells with duplicate values in red for the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');
@@ -1030,7 +1071,8 @@ export declare class FConditionalFormattingBuilder {
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that highlights the bottom 10% of values in red for the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');
@@ -1053,7 +1095,8 @@ export declare class FConditionalFormattingBuilder {
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      * console.log(fWorksheet.newConditionalFormattingRule().getIconMap()); // icons key-value map
      * ```
      */
@@ -1067,7 +1110,8 @@ export declare class FConditionalFormattingBuilder {
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a 3-arrow icon set conditional formatting rule in the range A1:D10.
      * // The first arrow is green for values greater than 20.
@@ -1127,7 +1171,8 @@ export declare class FConditionalFormattingBuilder {
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that adds a color scale to cells with values between 0 and 100 in the range A1:D10.
      * // The color scale is green for 0, yellow for 50, and red for 100.
@@ -1164,7 +1209,8 @@ export declare class FConditionalFormattingBuilder {
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that adds a data bar to cells with values between -100 and 100 in the range A1:D10.
      * // positive values are green and negative values are red.
@@ -1197,7 +1243,8 @@ export declare class FConditionalFormattingBuilder {
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that highlights cells with no content in red for the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');
@@ -1217,7 +1264,8 @@ export declare class FConditionalFormattingBuilder {
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that bolds the text for cells with not empty content in the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');
@@ -1237,7 +1285,8 @@ export declare class FConditionalFormattingBuilder {
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that changes the font color to red for cells with not empty content in the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');
@@ -1257,7 +1306,8 @@ export declare class FConditionalFormattingBuilder {
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that italicizes the text for cells with not empty content in the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');
@@ -1277,7 +1327,8 @@ export declare class FConditionalFormattingBuilder {
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that set text strikethrough for cells with not empty content in the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');
@@ -1297,7 +1348,8 @@ export declare class FConditionalFormattingBuilder {
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that underlines the text for cells with not empty content in the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');
@@ -1316,7 +1368,8 @@ export declare class FConditionalFormattingBuilder {
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that highlights cells with no content in red for the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');
@@ -1335,7 +1388,8 @@ export declare class FConditionalFormattingBuilder {
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that changes the font color to red for cells with not empty content in the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');
@@ -1355,7 +1409,8 @@ export declare class FConditionalFormattingBuilder {
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that highlights cells with dates in the last 7 days in red for the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');
@@ -1375,7 +1430,8 @@ export declare class FConditionalFormattingBuilder {
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that highlights cells with values greater than 10 in red for the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');
@@ -1396,7 +1452,8 @@ export declare class FConditionalFormattingBuilder {
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that highlights cells with values between 10 and 20 in red for the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');
@@ -1416,7 +1473,8 @@ export declare class FConditionalFormattingBuilder {
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that highlights cells with values equal to 10 in red for the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');
@@ -1436,7 +1494,8 @@ export declare class FConditionalFormattingBuilder {
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that highlights cells with values greater than 10 in red for the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');
@@ -1456,7 +1515,8 @@ export declare class FConditionalFormattingBuilder {
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that highlights cells with values greater than or equal to 10 in red for the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');
@@ -1476,7 +1536,8 @@ export declare class FConditionalFormattingBuilder {
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that highlights cells with values less than 10 in red for the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');
@@ -1496,7 +1557,8 @@ export declare class FConditionalFormattingBuilder {
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that highlights cells with values less than or equal to 10 in red for the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');
@@ -1517,7 +1579,8 @@ export declare class FConditionalFormattingBuilder {
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that highlights cells with values not between 10 and 20 in red for the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');
@@ -1537,7 +1600,8 @@ export declare class FConditionalFormattingBuilder {
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that highlights cells with values not equal to 10 in red for the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');
@@ -1557,7 +1621,8 @@ export declare class FConditionalFormattingBuilder {
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that highlights cells with text containing 'apple' in red for the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');
@@ -1577,7 +1642,8 @@ export declare class FConditionalFormattingBuilder {
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that highlights cells with text not containing 'apple' in red for the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');
@@ -1597,7 +1663,8 @@ export declare class FConditionalFormattingBuilder {
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that highlights cells with text ending with '.ai' in red for the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');
@@ -1617,7 +1684,8 @@ export declare class FConditionalFormattingBuilder {
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that highlights cells with text equal to 'apple' in red for the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');
@@ -1637,7 +1705,8 @@ export declare class FConditionalFormattingBuilder {
      * @example
      * ```typescript
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a conditional formatting rule that highlights cells with text starting with 'https://' in red for the range A1:D10.
      * const fRange = fWorksheet.getRange('A1:D10');