kravcik / latte-font-awesome-icon
为 Latte 设计的简单 {icon} 宏,允许快速输入 font-awesome 图标。
Requires
- php: ^8.0
- latte/latte: ^3
- nette/utils: ^4
Requires (Dev)
- modul-is/coding-standard: ^4
- nette/caching: ^3.2
- nette/robot-loader: ^4
- nette/tester: ^2.4
- phpstan/phpstan: ^1
- tracy/tracy: ^2.9
README
新的 font awesome 图标 - latte 生成器。替换旧的 https://github.com/kravcik/nette-macro-fontawesome。
注册扩展
latte: extensions: - Kravcik\LatteFontAwesomeIcon\Extension
您还可以设置默认值,这很简单
latte: extensions: - Kravcik\LatteFontAwesomeIcon\Extension(defaultStyle: far, defaultFixedWidth: false, defaultElement: i)
扩展参数
defaultStyle
- 选择 FA 风格 (fas|far|fal|fab 等。),默认为fal
defaultFixedWidth
- 自动为图标添加fa-fw
,默认为true
defaultElement
- 生成图标的 HTML 元素,默认为span
宏参数
参数可以是命名的,也可以按数字索引排序(见示例)
color
- 当前图标的颜色,生成text-primary
用于 Bootstrap 颜色,其他颜色为color-xxx
size
- 当前图标的大小,数字生成fa-2x
,字符串fa-lg
fw
- 当前图标的固定宽度fa-fw
element
- 当前图标的自定义 HTML 元素style
- 当前图标的样式 (fas|far|fal|fab 等。)class
- 添加到当前 HTML 元素的自定义类
示例
示例取决于默认值,因此我们使用默认设置(fal,fw,span)。
{icon star}
-> <span class="fal fa-star fa-fw"></i>
{icon star, primary}
-> <span class="fal fa-star text-primary fa-fw"></span>
{icon star, red}
-> <span class="fal fa-star color-red fa-fw"></span>
{icon star, null, lg}
-> <span class="fal fa-star fa-lg fa-fw"></span>
{icon star, yellow, 2}
-> <span class="fal fa-star color-yellow fa-2x fa-fw"></span>
{icon star, blue, size: 2, style: far}
-> <span class="fal fa-star color-blue fa-2x"></span>
{icon star, class: foo, color: green}
-> <span class="fal fa-star color-green foo"></span>