React Box Selection

React component for making box selections on elements.

Gif

Installation

npm install || yarn 

Usage

import Selection from 'react-box-selection'
 
const content = [...Array(7)].map((item, row) => {
  return [...Array(14)].map((item, col) => {
    const data = Math.floor(Math.random() * 100 + 1)
    const tmp = <h3 key={`${row}-${col}`}>{data}</h3>
    return tmp
  })
})
 
class App extends React.Component {
  state = {}
 
  componentWillUnmount () {
    this.setState = () => { }
  }
 
  mounted = all => { //all items(dom)
    console.log(all)
  }
  selected = (positions, items, all) => { //data-position(array of string),selected items(array of dom)
    console.log(positions)
  }
  singleSelected = (position, item, all) => { //data-position(string),selected items(dom)
    console.log(position)
  }
  hovered = (position, item) => {
    console.log(position)
  }
  leaved = (position, item) => {
    console.log(position)
  }
 
  render () {
 
    return (
      <div>
        <Selection
          cols={24} 
          rows={48} 
          width={30} 
          height={50} 
          gap={10} 
          wrapperScroll={undefined}
          onMounted={this.mounted}
          onHovered={this.hovered}
          onLeaved={this.leaved}
          onSelected={this.selected}
          onSingleSelected={this.singleSelected}
          itemClass='selection_item'
          extraClass={['extra_1', 'extra_2']}
          activeClass='selection_item_active'
        >
          {content}
        </Selection>
      </div>
    )
  }
}
 

params

name	defaultValue	must	Effect
cols	24	×	columns
rows	7	×	rows
height	50px	×	item's height
width	30px	×	item's width
gap	0	×	item's spacing
wrapperScroll	window scrollTop & scrollLeft	×	outer dom scrollTop & scrollLeft
Children	-	×	item's dom or text
onMounted	-	×	mounted callback
onHovered	-	×	overed callback
onLeaved	-	×	leaved callback
onSelected	-	×	selected callback
onSingleSelected	-	×	select or click on a single callback
itemClass	selection_item	×	items' class
extraClass	[]	×	items' extra class
activeClass	selection_item_active	×	items' active class