All Projects → ekeric13 → react-ratings-declarative

ekeric13 / react-ratings-declarative

Licence: BSD-3-Clause license
A customizable rating component for selecting x widgets or visualizing x widgets

Programming Languages

javascript
184084 projects - #8 most used programming language
HTML
75241 projects
CSS
56736 projects
Makefile
30231 projects

Projects that are alternatives of or similar to react-ratings-declarative

react-star-ratings
A customizable svg star rating component for selecting x stars or visualizing x stars
Stars: ✭ 128 (+212.2%)
Mutual labels:  input, rating, react-component, svg-icons, star-rating
rater-js
Star rating widget for the browser. Unlimited number of stars. No dependencies. No Jquery required.
Stars: ✭ 66 (+60.98%)
Mutual labels:  rating, rater, star-rating
Raty
🌟 Raty - A Star Rating Plugin
Stars: ✭ 2,292 (+5490.24%)
Mutual labels:  rating, star-rating
react-simple-range
🔉 React slider component for inputting a numeric value within a range.
Stars: ✭ 20 (-51.22%)
Mutual labels:  input, react-component
React Telephone Input
React component for entering and validating international telephone numbers
Stars: ✭ 254 (+519.51%)
Mutual labels:  input, react-component
React Kawaii
Cute SVG React Components
Stars: ✭ 2,709 (+6507.32%)
Mutual labels:  react-component, svg-icons
rating
⭐ A true Bayesian rating system with scope and cache enabled
Stars: ✭ 49 (+19.51%)
Mutual labels:  rating, star-rating
mighty-input
Text input for modern web
Stars: ✭ 20 (-51.22%)
Mutual labels:  input, react-component
React Currency Input Field
React component for an input field
Stars: ✭ 111 (+170.73%)
Mutual labels:  input, react-component
React Code Input
React component for entering and validating PIN code.
Stars: ✭ 207 (+404.88%)
Mutual labels:  input, react-component
React Intl Tel Input
Rewrite International Telephone Input in React.js. (Looking for maintainers, and PRs & contributors are also welcomed!)
Stars: ✭ 212 (+417.07%)
Mutual labels:  input, react-component
React Cassette Player
Simple ReactJS HTML5 audio player component built with SVG icons from The Noun Project.
Stars: ✭ 93 (+126.83%)
Mutual labels:  react-component, svg-icons
animation-wrapper-view
Declarative animations with imperative controls for RN/RNW.
Stars: ✭ 53 (+29.27%)
Mutual labels:  react-component, declarative
react-native-rating-element
A simple rating library for react native supporting: decimal points, direction aware icons, custom icon set from Ionicons, custom images and record rating given by users.
Stars: ✭ 19 (-53.66%)
Mutual labels:  rating, star-rating
react-crud-icons
57 SVG icons for CRUD applications, packaged as a React component with light & dark themes and tooltip.
Stars: ✭ 19 (-53.66%)
Mutual labels:  react-component, svg-icons
Tagify
🔖 lightweight, efficient Tags input component in Vanilla JS / React / Angular / Vue
Stars: ✭ 2,305 (+5521.95%)
Mutual labels:  input, react-component
react-svg-icon-generator
Generate React Icon Component from SVG icons to show, resize and recolor them.
Stars: ✭ 65 (+58.54%)
Mutual labels:  react-component, svg-icons
insect
🛠 Highly customisable, minimalistic input x select field for React.
Stars: ✭ 33 (-19.51%)
Mutual labels:  input, react-component
lua-evdev
Lua module for reading Linux input events from /dev/input/eventXX nodes
Stars: ✭ 31 (-24.39%)
Mutual labels:  input
react-grid
react grid component
Stars: ✭ 17 (-58.54%)
Mutual labels:  react-component

React Ratings Declarative

A customizable rating component for selecting x widgets or visualizing x widgets. SVG stars that show aggregate star ratings to the hundreths decimal point.

Install

npm install --save react-ratings-declarative

Demo

codepen playground

Demo Example Image

Usage

import Ratings from 'react-ratings-declarative';

class Foo extends Component {
    changeRating( newRating ) {
      this.setState({
        rating: newRating
      });
    }

    render() {
      return (
          <Ratings
            rating={this.state.rating}
            widgetRatedColors="blue"
            changeRating={this.changeRating}
          >
            <Ratings.Widget />
            <Ratings.Widget />
            <Ratings.Widget
              widgetDimension="60px"
              svgIconViewBox="0 0 5 5"
              svgIconPath="M2 1 h1 v1 h1 v1 h-1 v1 h-1 v-1 h-1 v-1 h1 z"
            />
            <Ratings.Widget widgetHoverColor="black" />
            <Ratings.Widget />
          </Ratings>
      );
    }
}


class Bar extends Component {
  render() {
    return (
      <Ratings
        rating={3.403}
        widgetDimensions="40px"
        widgetSpacings="15px"
      >
        <Ratings.Widget widgetRatedColor="green" />
        <Ratings.Widget widgetSpacing="30px" widgetDimension="15px" />
        <Ratings.Widget widgetRatedColor="black" />
        <Ratings.Widget widgetRatedColor="rebeccapurple" />
        <Ratings.Widget />
      </Ratings>
    );
  }
}

API

Ratings

Prop Type Default Description Example
rating number 0 The user's rating. Number of widgets to highlight. 3
typeOfWidget string 'Star' The type of widget used as a rating meter Point
changeRating function ()=>{} Callback that will be passed the new rating a user selects const setNewRating = (rating) => this.props.dispatch( fooActions.setRating(rating) )
gradientPathName string '' gradientPathname needed if app's path is not at the root /app/
ignoreInlineStyles boolean false ignore all the inline styles and write your own css using the provided classes true
svgIconPaths string 'm25,1 6,17h18l-14,11 5,17-15-10-15,10 5-17-14-11h18z' Set a path that describes the svg shape for all the children 'm25,1 6,17h18l-14,11 5,17-15-10-15,10 5-17-14-11h18z'
svgIconViewBoxes string '0 0 51 48' Set the view box for a custom svg path you might have for all the children '0 0 51 48'
svgs node none Use a custom svg or react element for all the children <svg><circle /></svg>
widgetRatedColors string 'rgb(109, 122, 130)' Color of widgets that the user has rated, applied to all the children black
widgetEmptyColors string 'rgb(203, 211, 227)' Color of widgets that the use hasn't rated, applied to all the children grey
widgetHoverColors string 'rgb(230, 67, 47)' Color of widget when hovering over it in selection mode, applied to all the children yellow
widgetDimensions string '50px' The width and height of the star, applied to all the children 15px
widgetSpacings string '7px' The spacing between the widgets, applied to all the children 0

Widget

Prop Type Default Description Example
svgIconPath string 'm25,1 6,17h18l-14,11 5,17-15-10-15,10 5-17-14-11h18z' Set a path that describes the svg shape 'm25,1 6,17h18l-14,11 5,17-15-10-15,10 5-17-14-11h18z'
svgIconViewBox string '0 0 51 48' Set the view box for a custom svg path you might have '0 0 51 48'
svg node none Use a custom svg or react element <svg><circle /></svg>
widgetRatedColor string 'rgb(109, 122, 130)' Color of widgets that the user has rated black
widgetEmptyColor string 'rgb(203, 211, 227)' Color of widgets that the use hasn't rated grey
widgetHoverColor string 'rgb(230, 67, 47)' Color of star when hovering over it in selection mode yellow
widgetDimension string '50px' The width and height of the widget 15px
widgetSpacing string '7px' The spacing between the widgets 0

Browser Support

Supports Chrome, safari, firefox, edge, and ie 9+. The widget is SVG, so this library fails for any browser that doesn't support svg.

Potential Gradient Path Name Issue

I use the css property fill: 'url(#starGrad<randomNum>)'; to fill in just a percentage of a star. It has some weird bugs depending on the pathname of the app. Normally SPA's have window.location.pathname === '/', but if you append window.location.origin with the pathname of say app, so that window.location.pathname === '/app/', then you need a gradientPathName of '/app/'.

Here is a stackoverflow post that I found that was related to this issue: http://stackoverflow.com/questions/36774188/svg-internal-url-links-and-iframes-on-wirecloud

Contribute

If you want to contribute: Make changes in the src folder. And then run make build. The make build command compiles react and es6 stuff using babel from src/ into build/.

Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].