PHP最佳Font Awesome助手库

1.4.1 2017-12-15 05:39 UTC

This package is auto-updated.

Last update: 2024-09-18 21:45:31 UTC


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_LEFTFA_PULL_RIGHTFA_SIZE_LGFA_SIZE_2XFA_SIZE_3XFA_SIZE_4XFA_SIZE_5XFA_FIX_WIDTHFA_INVERSEFA_BORDERFA_SPINFA_PULSEFA_ROT90FA_ROT180FA_ROT270FA_FLIP_VFA_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

待办事项

  • 堆叠支持
  • 图标列表