Skip to content

charettes/django-colorful

Folders and files

NameName
Last commit message
Last commit date
Aug 15, 2018
Aug 15, 2018
Apr 23, 2016
Apr 23, 2016
Aug 19, 2021
Jun 1, 2014
Jan 10, 2011
Sep 8, 2011
May 3, 2016
Mar 1, 2018
Sep 21, 2020
Aug 19, 2021

Repository files navigation

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.