Cell References in a Formula

A formula can refer to constant values or cell references. If a value in any of the referenced cells changes, the result of the formula changes. If you use constant values in the formula instead of references to the cells, the result changes only if you modify the formula (or values in the formula).

With SpreadJS, you can convert the specific cell range to a formula string using the formulaToRanges method. For instance - returning an "A1" address from the row and column numbers.

For more information on using cell references in a formula, refer to Use Cell References.

If a new row is added right before or after a cell range in a formula then the range does not include the new row.

The following topics describe the different notation styles and reference types:

• A1 Notation

• R1C1 Notation

• Relative and Absolute

A1 Notation

Each cell can be referenced by a combination of its column letter (A through Z, then AA to ZZ, AAA to ZZZ, etc.) and row number (1 and beyond) for a total of 2,147,483,648 rows and columns. For example, D50 refers to the cell at the intersection of column D and row 50. To refer to a range of cells, enter the reference for the cell in the upper-left corner of the range, a colon (:), and then the reference to the cell in the lower-right corner of the range.

R1C1 Notation

Each cell can be referenced by its row and column number by preceding each by the letter "R" for row and the letter "C" for column. For example, R1C3 is the cell in the first row and third column.

Relative and Absolute

A relative cell reference is a reference to a cell relative to the position of the cell with the formula. An absolute reference is a cell reference that always refers to a cell by its exact location in the sheet and not concerning the present cell.

Relative references automatically adjust when you copy them and absolute references do not. The widget can use absolute or relative cell references. You can define the cell reference style for each sheet by using the ReferenceStyle property. The formula does not support a range reference that contains both absolute and relative row or column references. In other words, the start and end rows in a range reference have to match (both absolute or both relative). The following table contains examples of valid relative cell references in formulas.

For A1 notation, use a dollar sign ($) preceding the row or column (or both) to indicate an absolute reference. For example

For R1C1 notation, use brackets [ ] around the row or column number (or both) to indicate a relative reference. For example

In this notation, the number inside the brackets is an offset from the current cell. This number may be a negative or positive integer or zero. Leaving off the offset entirely is a short-hand way of indicating a zero offset. So,

RC2 is equivalent to R[0]C2

R[3]C is equivalent to R[3]C[0]

Dynamic References

SpreadJS provides the dynamicReferences flag to support minimal memory usage and better performance while using calculation-related formula functions. With this flag, the process of calculation using formula functions across worksheets becomes faster.

The dynamicReferences flag accepts Boolean values to enable or disable the dynamic reference mode for CalcEngine. It helps in enhancing the performance of formula functions like IF, CHOOSE, SUMIF, SUMIFS, AVERAGEIF, AVERAGEIFS, MAXIFS, MINIFS, COUNTIFS, VLOOKUP, and HLOOKUP.

By default, the value for the dynamicReferences flag is true. To increase the performance of calculations, the flag should be set to false.

Note: The dynamicReferences flag should be set before setting the formula or fromJSON.

The following code snippet shows how the circular reference gets affected when dynamicReferences option is set to false or true.

spread.options.dynamicReferences = false;
spread.options.iterativeCalculation = false;
sheet.setFormula(0, 1, '=SUMIF(A:A,"a*",B:B)');
sheet.setValue(1, 0, "aaa");
sheet.setValue(1, 1, 123); // Here, formula B1 result won't change. Because B1 have listener of A:A, B:B, it's circular reference and iterativeCalculation is false.

spread.options.dynamicReferences = true;
spread.options.iterativeCalculation = false;
sheet.setFormula(0, 1, '=SUMIF(A:A,"a*",B:B)');
sheet.setValue(1, 0, "aaa");
sheet.setValue(1, 1, 123); // Here, formula B1 result will change. Because B1 have listener of A:A, B2, not B:B, it's not circular reference, can calculate when the iterativeCalculation is false