0.4.2 • Published 5 years ago

react-chessboardjs-wrapper v0.4.2

Weekly downloads
9
License
MIT
Repository
github
Last release
5 years ago

WIP Early stages.

A React wrapper for chessboard.js. Requires chessboard.js and jQuery to be available on the window object.

Usage

yarn add react-chessboardjs-wrapper

import ChessboardJs from 'react-chessboardjs-wrapper'

<ChessboardJs
  animate // boolean, chessboard.js piece animations
  blackSquareColour="steelblue" // or hex
  border="10px solid #d3d3d3" // css border property
  config={config} // The chessboard.js config object
  onInitBoard={(board, boardId) => this._board = board} // callback fn, gets passed the chessboard.js board object, and the unique id
  resize // effective if width prop is a string
  showPromotionDialog={ // falsey, or object as shown
    onSelect: piece => { // callback function, runs when a piece is selected
      console.log(piece)
      this.setState({
        showPromotionDialog: false,
      })
    },
    square: 'e8', // the square the select piece dialog appears on
  }
  whiteSquareColour="aliceblue" // or hex
  width="80%" // string (%) || number (px)
/>

Notes:

  • Changing all props WITH THE EXCEPTION OF THE FOLLOWING means a full recreation of the board (as only these are settable via the chessboard.js API):

    • animate
    • blackSquareColour
    • border
    • config.position
    • config.orientation
    • resize
    • showPromotionDialog
    • whiteSquareColour
  • This wrapper is optimised for a modified chessboard.js, based on chessboard.js PR 97 which supports image caching. If using the non-modified published chessboard.js, it works anyway (falls back). fixes flickering in Safari (somewhat, it is still not perfect).

  • chessboard.js config.showErrors doesn't seem to work as advertised?
  • Is chessboard.js is no longer maintained?

Examples

TODO

Dev

We use rollup.js. yarn dev to watch files and rebuild on changes, yarn build to build.

Tests

TODO, but I need to learn myself some React testing libs.

0.4.2

5 years ago

0.4.1

6 years ago

0.4.0

6 years ago

0.3.2

6 years ago

0.3.1

6 years ago

0.3.0

6 years ago

0.2.0

6 years ago