SpreadJS Documentation
GC.Spread.Sheets.ConditionalFormatting Namespace / Condition type / ignoreBlank Method
Whether to ignore the blank cell.
In This Topic
    ignoreBlank Method
    In This Topic
    Gets or sets whether to ignore the blank cell.
    Syntax
    var instance = new GC.Spread.Sheets.ConditionalFormatting.Condition(conditionType, args);
    var returnValue; // Type: any
    returnValue = instance.ignoreBlank(value);
    function ignoreBlank( 
       value : boolean
    ) : any;

    Parameters

    value
    Whether to ignore the blank cell.

    Return Value

    If no value is set, returns whether to ignore the blank cell; otherwise, returns the condition.
    Example
    The following examples use the ignoreBlank method.
    var nCondition = new GC.Spread.Sheets.ConditionalFormatting.Condition(GC.Spread.Sheets.ConditionalFormatting.ConditionType.dateCondition, {compareType: GC.Spread.Sheets.ConditionalFormatting.DateCompareType.before, expected: new Date(2012, 11, 31)});
    nCondition.ignoreBlank(true);
    var validator = new GC.Spread.Sheets.DataValidation.DefaultDataValidator(nCondition);
    validator.type(GC.Spread.Sheets.DataValidation.CriteriaType.custom);
    activeSheet.getCell(0, 0, GC.Spread.Sheets.SheetArea.viewport).validator(validator);
    spread.options.highlightInvalidData = true;
    activeSheet.setValue(0, 0, new Date(2012, 12, 12));
    var nCondition = new GC.Spread.Sheets.ConditionalFormatting.Condition(GC.Spread.Sheets.ConditionalFormatting.ConditionType.textCondition);
    nCondition.compareType(GC.Spread.Sheets.ConditionalFormatting.TextCompareType.contains);
    nCondition.expected("te?t");
    nCondition.ignoreBlank(true);
    nCondition.ignoreCase(true);
    nCondition.useWildCards(true);
    var validator = new GC.Spread.Sheets.DataValidation.DefaultDataValidator(nCondition);
    validator.type(GC.Spread.Sheets.DataValidation.CriteriaType.custom);
    activeSheet.getCell(0, 0, GC.Spread.Sheets.SheetArea.viewport).validator(validator);
    spread.options.highlightInvalidData = true;
    activeSheet.setValue(0, 0, "testing");
    var nCondition = new GC.Spread.Sheets.ConditionalFormatting.Condition(GC.Spread.Sheets.ConditionalFormatting.ConditionType.formulaCondition, {customValueType: GC.Spread.Sheets.ConditionalFormatting.CustomValueType.formula, formula: "A1>0"});
    nCondition.ignoreBlank(false);
    var validator = new GC.Spread.Sheets.DataValidation.DefaultDataValidator(nCondition);
    validator.type(GC.Spread.Sheets.DataValidation.CriteriaType.custom);
    activeSheet.getCell(0, 0, GC.Spread.Sheets.SheetArea.viewport).validator(validator);
    spread.options.highlightInvalidData = true;
    activeSheet.setValue(0, 0, -4);
    See Also

    Reference

    Condition type