codein/ez-color-picker

eZplatform 颜色选择字段类型

2.0.0 2021-07-09 15:08 UTC

This package is auto-updated.

Last update: 2024-09-09 22:21:55 UTC


README

Symfony 扩展,为 eZ Platform 添加颜色管理功能。

注意:这是 eZ Platform 2.5(ezsystems/ezpublish-kernel:7.5)的兼容分支。对于 Ibexa Platform 兼容版本,请检查此存储库:https://github.com/Codein-Labs/ibexa-color-picker

安装

composer require codein/ez-color-picker:dev-develop

在 AppKernel.php 中激活扩展

new Codein\eZColorPicker\eZColorPickerBundle()

编译管理界面资产

./bin/console ezplatform:encore:compile

用法

默认值

您可以为您的字段设置一个默认颜色。如果没有设置颜色,系统将向用户建议默认颜色。如果字段为必填,则默认颜色将被分配为默认值。如果不是,则不会分配颜色。

Twig

在 Twig 中渲染的默认颜色格式为 RGBa。您可以将额外选项传递给 ez_render_field。

  • 格式:RGBa, HEXa, HSVa, RGB, HEX
  • 默认值:如果字段为空返回的默认值。如果未设置,ez_render_field 将返回空字符串
{{ ez_render_field(content, 'color2', {'parameters': {'format': 'HEX', 'default': 'none'}}) }}

迁移

方法 \Codein\eZColorPicker\FieldType\ColorPicker\Type::acceptValue 将接受单个字符串并将其转换为颜色。以下格式将转换为有效值对象:

HSVa: hsva(0, 86%, 69%, 0.69)
RGBa: rgba(176, 25, 25, 0.69)
HEXa: #B01919B0
RGB: rgb(176, 25, 25)
HEX: #B01919

您可以在编写迁移时使用此功能。

我们还为您提供了颜色转换服务:这里

致谢

此扩展使用 Pickr (https://github.com/Simonwep/pickr),基于 MIT 许可证。