rsmike / fa
PHP最佳Font Awesome助手库
Requires
- fortawesome/font-awesome: ~4.7.0
README
出色的PHP Font Awesome库。
包含大多数IDE支持的PHPDoc自动完成。
用法
仅图标
echo FA::check();
生成 <i class="fa fa-check">
图标和文字
echo FA::check('Submit');
生成 <i class="fa fa-check"> Submit
注意图标和文字之间有一个空格。
注意事项:如果你的文字基本上是数字,你应该先将其显式转换为字符串,例如
FA::briefcase((string)$id)
。否则,数值将被解析为选项参数。
带有额外填充类的图标
echo FA::check('Submit')->pad();
生成 <i class="fa fa-check fa-pad">Submit
与图标和文字之间的空格不同,这为图标添加了一个 "fa-pad" 填充类。这在链接内部特别有用,因为图标和文本之间的空格在鼠标悬停时不应被下划线。这个类是非标准的,应该单独进行样式设置。示例
.fa.fa-pad:after { content: " "; display: inline-block; width: 0.4em; }
可以将 pad()
函数替换为 FA::FA_PAD 选项。
带有选项的图标
echo FA::check(FA::FA_BORDER | FA::FA_FLIP_H);
生成 <i class="fa fa-check fa-border fa-flip-horizontal">
可能的选项包括:
FA_PULL_LEFT
,FA_PULL_RIGHT
,FA_SIZE_LG
,FA_SIZE_2X
,FA_SIZE_3X
,FA_SIZE_4X
,FA_SIZE_5X
,FA_FIX_WIDTH
,FA_INVERSE
,FA_BORDER
,FA_SPIN
,FA_PULSE
,FA_ROT90
,FA_ROT180
,FA_ROT270
,FA_FLIP_V
,FA_FLIP_H
;
带有文字和选项的图标
echo FA::check('Submit', FA::FA_ROT90);
选项应作为第二个参数。如果第一个参数不是字符串,则被认为是选项,第二个参数将被忽略。
带有额外自定义类的图标
echo FA::check('Submit', FA::FA_ROT90)->class('text-danger my-class');
生成 <i class="fa fa-check fa-rotate-90 text-danger my-class"></i> Submit
类应用于图标本身(而不是文字)
带有Bootstrap兼容的提示的图标
echo FA::exclamation_triangle()->tooltip('数据未验证');
生成 <i class="fa fa-exclamation-triangle" data-toggle="tooltip" title="数据未验证"></i>
带有额外CSS样式的图标
echo FA::check()->css('margin-left: 20px');
生成 <i class="fa fa-check" style="margin-left: 20px"></i>
在构造后应用修饰符
echo FA::check('Submit')->mod(FA::FA_ROT90);
生成 <i class="fa fa-check fa-rotate-90"></i> Submit
使用图标作为对象
$ok = FA::check();
$ko = clone $ok;
$ok->class('text-danger');
$ko->mod(FA_FLIP_H);
echo $ok, $ko;
安装
运行以下命令之一
$ composer require rsmike/fa:~1.0
或者
"rsmike/fa": "~1.0"
将以下内容添加到你的 composer.json
文件的 require
部分中。
"fortawesome/font-awesome" 包是一个依赖项,将会自动安装。
变更日志
v1.4
- 通过 "att" 方法设置任何其他附加属性
- 自定义提示位置和容器
style()
被重命名为css()
v1.2
- 用于链接内部的自定义填充类,而不是空格符号
v1.1
- Bootstrap提示功能
v1.0
- 初始公共版本
- FA图标 4.7
待办事项
- 堆叠支持
- 图标列表