Giter Club home page Giter Club logo

react-custom-roulette's Introduction

React Custom Roulette

npm version Types npm downloads

Customizable React roulette wheel with spinning animation

React Custom Roulette

Features

  • Customizable design
  • Prize selection by props
  • Spinning animation
  • [NEW!] Multiple spins (see Multi Spin)
  • Compatible with TypeScript

Install

$ npm install react-custom-roulette

or

$ yarn add react-custom-roulette

Quickstart

Wheel Component

import React from 'react'
import { Wheel } from 'react-custom-roulette'

const data = [
  { option: '0', style: { backgroundColor: 'green', textColor: 'black' } },
  { option: '1', style: { backgroundColor: 'white' } },
  { option: '2' },
]

export default () => (
  <>
    <Wheel
      mustStartSpinning={mustSpin}
      prizeNumber={3}
      data={data}
      backgroundColors={['#3e3e3e', '#df3428']}
      textColors={['#ffffff']}
    />
  </>
)

Props

Prop Type Default Description
mustStartSpinning (required) boolean - Sets when the roulette must start the spinning animation
prizeNumber (required) number - Sets the winning option. It's value must be between 0 and data.lenght-1
data (required) Array<WheelData> - Array of options. Can contain styling information for a specific option (see WheelData)
onStopSpinning function () => null Callback function that is called when the roulette ends the spinning animation
backgroundColors Array<string> ['darkgrey', 'lightgrey'] Array of colors that will fill the background of the roulette options, starting from option 0
textColors Array<string> ['black'] Array of colors that will fill the text of the roulette options, starting from option 0
outerBorderColor string 'black' Color of the roulette's outer border line
outerBorderWidth number 5 Width of the roulette's outer border line (0 represents no outer border line)
innerRadius number [0..100] 0 Distance of the inner radius from the center of the roulette
innerBorderColor string 'black' Color of the roulette's inner border line
innerBorderWidth number 0 Width of the roulette's inner border line (0 represents no inner border line)
radiusLineColor string 'black' Color of the radial lines that separate each option
radiusLineWidth number 5 Width of the radial lines that separate each option (0 represents no radial lines)
fontSize number 20 Font size of the option string
perpendicularText boolean false When 'true', sets the option texts perpendicular to the roulette's radial lines
textDistance number [0..100] 60 Distance of the option texts from the center of the roulette

Types

WheelData

interface WheelData {
  option: string;
  style?: StyleType; // Optional
}

StyleType

interface StyleType {
  backgroundColor?: string; // Optional
  textColor?: string; // Optional
}

Multi Spin

Example (using useState)

import React, { useState } from 'react'
import { Wheel } from 'react-custom-roulette'

const data = [
  { option: '0' },
  { option: '1' },
  { option: '2' },
]

export default () => {
  const [mustSpin, setMustSpin] = useState(false);
  const [prizeNumber, setPrizeNumber] = useState(0);

  const handleSpinClick = () => {
    const newPrizeNumber = Math.floor(Math.random() * data.length)
    setPrizeNumber(newPrizeNumber)
    setMustSpin(true)
  }

  return (
    <>
      <Wheel
        mustStartSpinning={mustSpin}
        prizeNumber={prizeNumber}
        data={data}

        onStopSpinning={() => {
          setMustSpin(false)
        }}
      />
      <button onClick={handleSpinClick}>SPIN</button>
    </>
  )
}

Contributors

This project exists thanks to all the people who contribute!

License

This project is licensed under the MIT license, Copyright (c) 2020 Effectus Software. [License]

react-custom-roulette's People

Contributors

luchozamora1 avatar nazabalm avatar dependabot[bot] avatar

Watchers

James Cloos avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.