npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@imadkurdi/stars-rating

v1.0.2

Published

This is a 5 star rating component. A standard custom web component written in pure vanilla JS. So it could be used in any framework.

Downloads

12

Readme

stars-rating component

This is a 5-stars rating component. A standard custom web component written in pure vanilla JS. So it could be used in any framework.

Example demonstrating the use of the stars-rating component

Usage:

This component could be used to show current average rating value and the count of ratings. Developers could make the component ready to rating or could wait for users to click a button to start rating process. Users then choose the rating they want and click a button to send that rate. The component then raises an event to inform developers that a rating is sent. After that the component is no more active, meaning that users could not rate any more.

Use the component like any other tag:

  1. In html: <stars-rating id="rater_1" rating="2.6" count="1520"></stars-rating>
  2. In JS: document.createElement("stars-rating") or new StarsRating()
  • To change the words in tooltip for stars alter this static array of the component class: StarsRating.ratingLabels = ["Terrible", "Poor", "Fair", "Good", "Great"];

  • To change the words of the button alter this static array of the component class: StarsRating.ratingBtnLabels = ["Rate", "Send"];

Attributes:

  • rating attribute: <stars-rating rating="2.6" ></stars-rating>
  • count attribute: <stars-rating count="1520"></stars-rating>

Styling:

  1. Define in an element's selector blok one or more of the following custom properties:
  • --rating-text-font: component font
  • --rating-stars-font: stars font
  • --rating-stars-color: stars color
  • --rating-btn-color: button color
  • --rating-btn-bg-color: button background color
  • --rating-btn-shadow: button box-shadow
  • --rating-tip-color: tip background color
  • --rating-tip-width: tip box width
  • --rating-tip-border: tip border
  • --rating-tip-shadow: tip box-shadow

Note: the "line-height" of the stars font control the spaces above & below them (0.8 is recommended)

or

  1. You can reach the following parts of the component:
  • ::part(stars): the stars themseves (styles will be applied on each star)

  • ::part(rateBtn): the rate button

  • ::part(rating): the rating number

  • ::part(count): the counting number

  • ::part(tip): the div that contains the whole tip

  • ::part(tip-text): the p tag (paragraph) that contains the text of the tip

    ex: #rater_1::part(count) { color: red; } to make the count number red

Events:

  • rating: The component defines this event to return the evaluation in event's property event.detail.

    ex: document.body.addEventListener("rating", e => { console.log(e.detail); });