@hasma/react-drawing-board
v0.5.50
Published
Browser drawing board created with canvas and React.
Downloads
656
Readme
React Drawing board
Browser drawing board created with canvas and React.
Preview
Features
A browser-ready efficient drawing board.
- Support for drawing strokes, shapes, texts and images.
- Built-in support for both redo and clear.
- Easily zoom or pan the board content.
- Ability to save screenshot.
- Ability to be used as a Pictionary board for long distance communication.
- Working for mobile users.
Installation
In NPM
React Drawing board uses a CMD so you can use it in NPM as well. npm install
this package and
const DrawingBoard = require('react-drawing-board');
Basic Use
Basic
<DrawingBoard />
As A Pictionary
const Demo: React.FC = () => {
const [operations, setOperations] = useState<Operation[]>([]);
return (
<DrawingBoard
userId="user1" // identify for different players.
operations={operations}
onChange={(newOperation, afterOperation) => {
console.log(`TODO: send ${newOperation}`);
setOperations(afterOperation);
}}
/>
)
}
Props
| Props | Description | Type | Default | |-----------|------------------------------------------|------------|---------| | userId(optional) | identify for operation source | string | uuid.v4() | | locale(optional) | 'en-US', 'zh-CN', 'tr-TR' | string | navigator.language | | operations(optional) | operations on drawing board | Operation[] | undefined | | onChange(optional) | called when user draw some operations | (newOperaton: Operation, operationsAfter: Operation[]) => void | undefined | | onSave(image) | called when user click save button for saving current view | (image: { canvas: HTMLCanvasElement, dataUrl: string }) => void | undefined | | style(optional) | element style | CSSProperties | undefined | | className(optional) | element classname | string | undefined | | toolbarPlacement(optional) | the position of toolbar | 'top' or 'left' or 'right' | 'top' | | viewMatrix(optional) | control the current perspective | undefined | | onViewMatrixChange(optional) | (viewMatrix: ViewMatrix) => void | undefined |