Getting Started

npm install sprd

How it looks

or

Demo Video

Available features

1. Keyboard navigation using arrow keys or page up and page down
2. Copy and Paste
3. Infinite scrolling vertically and horizontally
4. Custom cell formatting
5. Drag highlighting

Loading inital data

import {SprdContainer} from 'sprd';

let data = [
  ['Name', 'Age'], 
  ['sam', 20], 
  ['Mike', 30], 
  ['Greg', 40], 
  ['Monroe', 50],
  ['sam', 20], 
  ['Mike', 30], 
  ['Greg', 40], 
  ['Monroe', 50],
  ['sam', 20], 
  ['Mike', 30], 
];

<SprdContainer 
  width={800}
  height={600}
  data={data}/>

Listening to events

import {SprdContainer} from 'sprd';

<SprdContainer 
  width={800}
  height={600}
  onEvent={(eventType, range, data) => {
     console.log(eventType, range, data) 
     if(range) console.log(range.getAddress())
  }}
  data={data}/>

Overriding the cells with custom ones

import {SprdContainer} from 'sprd';

<SprdContainer 
  width={800}
  height={600}
  cellOverride={(cellInfo, innerCell, outerCell) => {
    if(cellInfo.row === 0){
      innerCell = (
        <select {...innerCell.props} style={{padding: 3}} ref={innerCell.ref}>
          <option>Hello</option>
          <option>World</option>
        </select>
      )
    }
    if(cellInfo.row === 0){
      outerCell = <span {...outerCell.props} style={{fontWeight: 'bold'}}/>
    }

    if(cellInfo.row > 5 && cellInfo.row < 10){
      outerCell = <span {...outerCell.props} style={{color: 'green'}}/>
    }

    if(cellInfo.dataType === "number"){
      outerCell = <span {...outerCell.props} style={{color: 'blue', fontSize: 11}} key={outerCell.key}/>
    }
    return {innerCell, outerCell}}
  }
  data={data}/>

Getting all data currently in the spreadsheet

import {Store} from 'sprd';

console.log(Store.getData());

This will return a json object with the top level keys corresponding to the row indices and the keys in the nested json objects corresponding to column indices e.g

{
  0:{0: "Name", 1: "Age"},
  1:{0: "sam", 1: 20},
  2:{0: "Mike", 1: 30},
  3:{0: "Greg", 1: 40}
}

NB: Any cells without data are not captured

Props and meaning

1. showHeaderLetters - whether to show the excel like header letters at the top of columns, default is true
2. showFooter - whether to show the footer that displays the cell address, default is true
3. infiniteScroll - whether to scroll infinitely both vertically and horizontally, default is true
4. width - the width in pixels of the grid, default is 1000
5. height - the height in pixels of the grid, default is 800
6. onEvent - javascript function to listen to events in the spreadsheet
7. columnDataTypes - an array containing the list of column data types
8. cellOverride - a callback to override default cells with your own custom cells
9. data - an array of arrays containing the default data