codein / ez-color-picker
eZplatform 颜色选择字段类型
2.0.0
2021-07-09 15:08 UTC
Requires
- php: ^7.1.3
- ext-json: *
- ezsystems/ezpublish-kernel: ^7.5
Requires (Dev)
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 许可证。