跳转到主要内容

django模型的美观颜色选择器。

项目描述

django-colorfield

为您的模型提供简单颜色字段和美观的颜色选择器的admin界面。

django-colorfield-hex django-colorfield-hexa


安装

  • 运行 pip install django-colorfield
  • colorfield 添加到 settings.INSTALLED_APPS
  • 运行 python manage.py collectstatic
  • 重新启动您的应用程序服务器

使用方法

设置

此软件包不需要任何设置。

模型

只需像这样将颜色字段添加到您的模型中

from colorfield.fields import ColorField
from django.db import models

class MyModel(models.Model):
    color = ColorField(default='#FF0000')

字段选项

以下为支持的自定义选项:formatimage_fieldsamples

format

以下格式受支持:hex (默认)hexargbrgba

from colorfield.fields import ColorField
from django.db import models

class MyModel(models.Model):
    color = ColorField(format="hexa")

image_field

可以使用image_field选项从图像自动填充字段值以获取颜色。

每次模型实例保存时,颜色将从图像的左上角像素颜色计算得出。

from colorfield.fields import ColorField
from django.db import models

class MyModel(models.Model):
    image = models.ImageField(upload_to="images")
    color = ColorField(image_field="image")

samples

可以使用samples选项向小部件提供一系列颜色供选择。

此选项不是限制性的(与choices选项相反),还可以从光谱中选择其他颜色。

django-colorfield-samples

from colorfield.fields import ColorField
from django.db import models

class MyModel(models.Model):

    COLOR_PALETTE = [
        ("#FFFFFF", "white", ),
        ("#000000", "black", ),
    ]

    # not restrictive, allows the selection of another color from the spectrum.
    color = ColorField(samples=COLOR_PALETTE)

    # restrictive, it is mandatory to choose a color from the palette
    color = ColorField(choices=COLOR_PALETTE)

管理

管理界面将为所有颜色字段提供友好的颜色选择器。 :)


测试

# clone repository
git clone https://github.com/fabiocaccamo/django-colorfield.git && cd django-colorfield

# create virtualenv and activate it
python -m venv venv && . venv/bin/activate

# upgrade pip
python -m pip install --upgrade pip

# install requirements
pip install -r requirements.txt -r requirements-test.txt

# install pre-commit to run formatters and linters
pre-commit install --install-hooks

# run tests
tox
# or
python runtests.py
# or
python -m django test --settings "tests.settings"

鸣谢

最初由Jared Forsyth开发。


许可证

MIT许可证下发布。


支持

  • :star: 在GitHub上星此项目
  • :octocat: 在GitHub上关注我
  • :blue_heart: 在Twitter上关注我
  • :moneybag: 在Github上赞助我

另请参阅

  • django-admin-interface - 默认管理界面,由管理界面本身进行自定义。用模态对话框替换弹出窗口。 🧙 ⚡

  • django-extra-settings - 使用Django管理界面配置和管理类型化额外设置。 ⚙️

  • django-maintenance-mode - 当维护模式开启时显示503错误页面。 🚧 🛠️

  • django-redirects - 完全控制的跳转。 ↪️

  • django-treenode - 可能是最佳抽象模型/管理界面,适用于基于树的结构。 🌳

  • python-benedict - 具有键列表/键路径支持的字典子类,I/O快捷方式(base64、csv、json、pickle、plist、查询字符串、toml、xml、yaml)以及许多实用工具。 📘

  • python-codicefiscale - 编码/解码意大利税号 - codifica/decodifica del Codice Fiscale。 🇮🇹 💳

  • python-fontbro - 友好的字体操作工具。🧢

  • python-fsutil - 懒人开发者文件系统工具。🧟‍♂️

项目详情


下载文件

下载适用于您平台的文件。如果您不确定选择哪个,请了解有关安装包的更多信息。

源代码分发

django-colorfield-0.11.0.tar.gz (55.3 kB 查看哈希值)

上传时间 源代码

构建分发

django_colorfield-0.11.0-py3-none-any.whl (53.2 kB 查看哈希值)

上传时间 Python 3

由以下机构支持

AWSAWS 云计算和安全赞助商 DatadogDatadog 监控 FastlyFastly CDN GoogleGoogle 下载分析 MicrosoftMicrosoft PSF赞助商 PingdomPingdom 监控 SentrySentry 错误日志 StatusPageStatusPage 状态页面