Extension to the Django web framework that provides database and form color fields
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 6 commits behind charettes:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
colorful
tests
.coveragerc
.gitignore
.travis.yml
AUTHORS
LICENSE
MANIFEST.in
README.rst
setup.cfg
setup.py
tox.ini

README.rst

django-colorful

An extension to the Django web framework that provides a database and form field to accept and store colors in the RGB format.

https://travis-ci.org/charettes/django-colorful.svg?branch=master https://coveralls.io/repos/charettes/django-colorful/badge.svg?branch=master&service=github

Installation

>>> pip install django-colorful

Make sure 'colorful' is in your INSTALLED_APPS:

INSTALLED_APPS.append('colorful')

Usage

In order to use a color field you just have to add it to your model definition:

from django.db import models
from colorful.fields import RGBColorField

class Tag(models.Model):
    color = RGBColorField()

The RGBColorField class also accepts a color keyword argument which can be set to a list of colors that should be visible as preset color palette:

color = RGBColorField(colors=['#FF0000', '#00FF00', '#0000FF'])

The ColorFieldWidget should take care of providing a JavaScript based shim on browsers that don't support the HTML5 color input.

Note

To enable HTML5 color input with Django Grappelli ensure that GRAPPELLI_CLEAN_INPUT_TYPES is set to False in your settings file.