Skip to main content

A no-frills Django form widget for rating stars

Project description

Description

This is a simple widget rendering so-called rating stars as input for an integer field. It is based solely on CSS 3, as laid out by Martin Ivanov.

This is different from other star rating applications in that it provides only a widget returning its selction to any IntegerField. It is not a complete rating application, just a presentational widget for integer input. It is also different in that it depends only on CSS3, without any JavaScript.

In contrast to others (and to the original work credited above), this widget also works on browsers that do not support CSS (like text-mode browsers). In that case, it renders as basic radio buttons with numbers.

Usage

Just add the Stars widget to any IntegerField in a Django form.

from django import forms
from django_starfield import Stars

class StarsExampleForm(forms.Form):
    rating = forms.IntegerField(widget=Stars)

The following aspects are configurable, both in the Django settings and when creating the widget (by passing an argument to Stars):

Aspect

Format

Default

Setting name

Argument

Number of stars

integer

5

STARFIELD_STARS

stars

Character used as star

hexadecimal codepoint

2605

STARFIELD_CODEPOINT

codepoint

Colour of stars

HTML colour

#f5b301

STARFIELD_COLOUR

colour

Please note that some browsers render some Unicode characters, especially emojis, as images, so changing the font colour will not work.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-starfield-1.0.post2.tar.gz (10.1 kB view details)

Uploaded Source

File details

Details for the file django-starfield-1.0.post2.tar.gz.

File metadata

  • Download URL: django-starfield-1.0.post2.tar.gz
  • Upload date:
  • Size: 10.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.3.0 pkginfo/1.6.1 requests/2.25.1 setuptools/51.1.0 requests-toolbelt/0.9.1 tqdm/4.51.0 CPython/3.9.1+

File hashes

Hashes for django-starfield-1.0.post2.tar.gz
Algorithm Hash digest
SHA256 9bbc59870b958b439a2e52e3d44592ef6d80af4d57b36528292274c499f7df91
MD5 a8b43555ed846e733f0221018f7ef83a
BLAKE2b-256 1fc4d9a101f5c418233e52f7d77806585ba96f0026a5f753738e85ab680fd5f5

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page