1.2.4 • Published 3 years ago
risk-dice-roll v1.2.4
react-dice-roll
A highly customizable dice roll package built in react.
Live Demo
Installation
Use the package manager yarn to install react-dice-roll.
yarn add react-dice-rollor using npm
npm install react-dice-rollUsage
import Dice from 'react-dice-roll';<Dice onRoll={(value) => console.log(value)} />Usage
| Prop | Type | Default | Description |
|---|---|---|---|
| rollingTime | number | 1000 | Rolling time for dice in milliseconds |
| onRoll | (value) => void | - | Function which receives the values between 1 - 6 after the dice roll |
| triggers | string[] | 'click' | Accepts an array of key strings which replaces the default trigger of dice roll onClick. Multiple key strings can be passed as an array including the click to use multiple triggers for dice roll key. eg: 'Enter', 'a', 'click' |
| defaultValue | number (1-6) | 6 | Default value of the dice before rolling |
| size | number | 250 | Dimensions of the dice in pixels |
| sound | string | - | URL for the sound to play on dice roll |
| disabled | boolean | - | Whether the dice is disabled or not |
| faces | string[] | - | Array of image urls for custom sides of the dice |
| faceBg | string | - | Custom background color for the dice face |
| placement | top-left, top-right, bottom-left, bottom-right | - | Placement of the device if put inside a relative positioned element |
| cheatValue | number (1-6) | - | Cheat Value for the dice. If passed, dice will always roll to this value |
| externalTrigger | boolean | - | Whether to use an external button to trigger or not, use useState to set it dynamically |
Contributing
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
License
MIT