dolphiq / iconpicker
此包已被 放弃 并不再维护。没有建议的替代包。
创建图标选择器字段类型,为最终用户提供从.woff或.ttf字体文件中选择图标/符号的简单方法。
1.0.5
2018-08-07 09:44 UTC
Requires
- craftcms/cms: ^3.0.0-RC2
- phenx/php-font-lib: ^0.5.0
This package is not auto-updated.
Last update: 2024-08-27 17:05:30 UTC
README
目前项目已 停止。但是,欢迎分叉并继续其开发!
Craft 插件,提供一种新字段类型,让用户可以轻松地从.woff或.ttf字体文件中选择图标。您可以轻松使用 ionicons 或 font awesome 图标
注意:当 Craft 插件商店可用时,此插件可能成为付费附加组件。
要求
- Craft 3.0 (beta 20)+
- PHP 7.0+
- PhenX PHP Font Lib
- 一个或多个.ttf或.woff文件
示例
在 CMS 用户模板中使用字段的示例
选择弹出窗口的示例
安装
-
使用 Composer 安装
composer require dolphiq/iconpicker
-
在 Craft 控制面板的“设置”>“插件”下安装插件
-
通过在模板开头添加以下行将插件资产添加到您的应用程序
{% do view.registerAssetBundle("plugins\\dolphiq\\iconpicker\\assets\\sharedAsset") %}
-
将您想要的字体添加到以下目录
/vendor/dolphiq/iconpicker/src/resources-shared/fonts
-
当添加新字段时,
Iconpicker 字段
类型将可用 - 设置 > 字段 > 添加新字段
创建具有图标选择器字段类型的字段
- 选择
Iconpicker 字段
类型 - 添加具有
Iconpicker 字段
类型的新字段时,您可以从下拉菜单中选择为该字段使用哪个字体
使用图标选择器字段类型
- 将字段添加到字段布局中(例如,添加到部分)
- 现在,当创建或更新部分时,您可以选择图标
在 twig 模板中的使用示例
快速示例代码
{% do view.registerAssetBundle("plugins\\dolphiq\\iconpicker\\assets\\sharedAsset") %}
<html style="padding: 0; margin: 0;">
<head>
<title></title>
{{ head() }}
</head>
<body>
{{ beginBody() }}
{% if entry.iconPickerField.icon %}
Hex: {{ entry.iconPickerField.icon }}<br>
{{ entry.iconPickerField.iconSpan|raw }}
{% endif %}
{{ endBody() }}
</body>
</html>
显示具有自定义类的图标
<span class='{{ entry.iconClass }} myCustomClass'>{{ entry.iconChar }}</span>
图标字段属性
-
获取图标 Unicode(十进制)
{{ entry.fieldName.icon }}
-
获取图标 Unicode(十六进制)
{{ entry.fieldName.iconHex }}
-
将图标作为 html 字符
�
显示{{ entry.fieldName.iconChar|raw }}
-
将图标作为 html 字符十六进制

显示{{ entry.fieldName.iconCharHex|raw }}
-
将图标作为带有字符和字体类的 span 显示
{{ entry.fieldName.iconSpan|raw }}
-
获取图标字体类
{{ entry.fieldName.iconClass }}
-
条件示例:仅当图标已设置时显示图标
{% if entry.fieldName.icon %} {{ entry.fieldName.iconSpan|raw }} {% endif %}
Iconpicker 路线图
- 在 UI 中选择和上传字体
- 在选择图标时启用(名称)搜索
贡献者 & 开发者
Lucas Weijers - 原始开发者 Johan Zandstra - 些小改动 由 Dolphiq 提供 info@dolphiq.nl