Light

der-gabe / django-colorinput Goto Github PK

View Code? Open in Web Editor NEW

0.0 1.0 0.0 29 KB

Model and form fields to store RGB colors as hex strings and widget to render the native HTML5 color input element

License: GNU General Public License v3.0

Python 99.00% HTML 1.00%

python django html5

django-colorinput's Introduction

django-colorinput

Color fields for forms and models using HTML5's native input element of type color.

Quickstart

Install django-colorinput and add it to your INSTALLED_APPS:

INSTALLED_APPS = (
    …
    'colorinput.apps.ColorInputConfig',
    …
)

Now you can use ColorField in your models:

from django.db import models

from colorinput.models import ColorField

class MyModel(models.Model):
    …
    color = ColorField(default="d0d0d0")
    …

In forms, the color field will be displayed using HTML5's native color type input element. In your own templates, you could use the value stored in the field like this:

<span style="color: #{{ object.color }}">

… or however you want, really. Just keep in mind that the value is stored as RGB in triple HEX format without the leading "#" (hash symbol).

django-colorinput's People

Contributors

Watchers

django-colorinput's Issues

Add setup.py

Add LICENCE

Move source code into `src` subdirectory

Add MANIFEST

Templates missing in package

It appears the package, as published on PyPI, is missing the template subdirectory, which is needed for correct rendering of the input element, of course.

Suggest a limited number of colors to the user

This can be done with the list attribute (although it seems that using list with the color type input element is currently unsupported on Firefox).

The selection of colors should be configurable via settings.py.

Color field is not displayed correctly in the admin

In the admin of models that use the color field, it's shown like a char field i.e. with a text type input field.

Oddly enough, the hash mark ("#") is displayed in the field, even though it's never stored in the DB.

A clue, perhaps?

Add README

Model stores value as six characters when three bytes would do

By their very nature, the RGB values used in HTML consist of 3 bytes (octets) and are only represented by 6 characters.

Storing the character representation , rather than the actual value, is (ever so) slightly wasteful and I believe the overhead introduced by the conversion is (even more) negligible.

Changing this will require a migration, however, so it might not be worth it.

Add CONTRIBUTING file

Recommend Projects

React

A declarative, efficient, and flexible JavaScript library for building user interfaces.
Vue.js

🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
Typescript

TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
TensorFlow

An Open Source Machine Learning Framework for Everyone
Django

The Web framework for perfectionists with deadlines.
Laravel

A PHP framework for web artisans
D3

Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

javascript

JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
web

Some thing interesting about web. New door for the world.
server

A server is a program made to process requests and deliver data to clients.
Machine learning

Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Visualization

Some thing interesting about visualization, use data art
Game

Some thing interesting about game, make everyone happy.

Recommend Org

Facebook

We are working to build community through open source technology. NB: members must have two-factor auth.
Microsoft

Open source projects and samples from Microsoft.
Google

Google ❤️ Open Source for everyone.
Alibaba

Alibaba Open Source for everyone
D3

Data-Driven Documents codes.
Tencent

China tencent open source team.