JavaScript Data Grid CellCoords

Description

The CellCoords class holds the coordinates (row, col) of a single cell.

It also contains methods for validating the coordinates and retrieving them as an object.

To import the CellCoords class:

import Handsontable, { CellCoords } from '/handsontable';

// or, using modules
import Handsontable, { CellCoords } from '/handsontable/base';

Members

col

Source code (opens new window)

cellCoords.col : number

A visual column index.

row

Source code (opens new window)

cellCoords.row : number

A visual row index.

Methods

assign

Source code (opens new window)

cellCoords.assign(coords) ⇒ CellCoords

Assigns the coordinates from another CellCoords instance (or compatible literal object) to your CellCoords instance.

Param Type Description
coords CellCoords
Object
The CellCoords instance or compatible literal object.

clone

Source code (opens new window)

cellCoords.clone() ⇒ CellCoords

Clones your CellCoords instance.

isCell

Source code (opens new window)

cellCoords.isCell() ⇒ boolean

Checks if the coordinates point to the cells range. If all axis (row and col) point to the cell (positive value) then method returns true.

isEqual

Source code (opens new window)

cellCoords.isEqual(coords) ⇒ boolean

Checks if another set of coordinates (coords) is equal to the coordinates in your CellCoords instance.

Param Type Description
coords CellCoords Coordinates to check.

isHeader

Source code (opens new window)

cellCoords.isHeader() ⇒ boolean

Checks if the coordinates point to the headers range. If one of the axis (row or col) point to the header (negative value) then method returns true.

isNorthEastOf

Source code (opens new window)

cellCoords.isNorthEastOf(testedCoords) ⇒ boolean

Checks if another set of coordinates (testedCoords) is north-east of the coordinates in your CellCoords instance.

Param Type Description
testedCoords CellCoords Coordinates to check.

isNorthWestOf

Source code (opens new window)

cellCoords.isNorthWestOf(testedCoords) ⇒ boolean

Checks if another set of coordinates (testedCoords) is north-west of the coordinates in your CellCoords instance.

Param Type Description
testedCoords CellCoords Coordinates to check.

isRtl

Source code (opens new window)

cellCoords.isRtl() ⇒ boolean

Checks if the coordinates runs in RTL mode.

isSouthEastOf

Source code (opens new window)

cellCoords.isSouthEastOf(testedCoords) ⇒ boolean

Checks if another set of coordinates (testedCoords) is south-east of the coordinates in your CellCoords instance.

Param Type Description
testedCoords CellCoords Coordinates to check.

isSouthWestOf

Source code (opens new window)

cellCoords.isSouthWestOf(testedCoords) ⇒ boolean

Checks if another set of coordinates (testedCoords) is south-west of the coordinates in your CellCoords instance.

Param Type Description
testedCoords CellCoords Coordinates to check.

isValid

Source code (opens new window)

cellCoords.isValid([tableParams]) ⇒ boolean

Checks if the coordinates in your CellCoords instance are valid in the context of given table parameters.

The row index:

  • Must be an integer.
  • Must be higher than the number of column headers in the table.
  • Must be lower than the total number of rows in the table.

The col index:

  • Must be an integer.
  • Must be higher than the number of row headers in the table.
  • Must be lower than the total number of columns in the table.
Param Type Default Description
[tableParams] object optional An object with a defined table size.
[tableParams.countRows] number 0 optional The total number of rows.
[tableParams.countCols] number 0 optional The total number of columns.
[tableParams.countRowHeaders] number 0 optional A number of row headers.
[tableParams.countColHeaders] number 0 optional A number of column headers.

Returns: boolean - true: The coordinates are valid.

normalize

Source code (opens new window)

cellCoords.normalize() ⇒ CellCoords

Normalizes the coordinates in your CellCoords instance to the nearest valid position.

Coordinates that point to headers (negative values) are normalized to 0.

toObject

Source code (opens new window)

cellCoords.toObject() ⇒ Object

Converts your CellCoords instance into an object literal with row and col properties.

Returns: Object - An object literal with row and col properties.

Last update: Feb 27, 2024