kravcik/latte-font-awesome-icon

为 Latte 设计的简单 {icon} 宏,允许快速输入 font-awesome 图标。

v1.0.1 2023-09-18 08:57 UTC

This package is auto-updated.

Last update: 2024-09-18 11:06:56 UTC


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)

扩展参数

  1. defaultStyle - 选择 FA 风格 (fas|far|fal|fab 等。),默认为 fal
  2. defaultFixedWidth - 自动为图标添加 fa-fw,默认为 true
  3. defaultElement - 生成图标的 HTML 元素,默认为 span

宏参数

参数可以是命名的,也可以按数字索引排序(见示例)

  1. color - 当前图标的颜色,生成 text-primary 用于 Bootstrap 颜色,其他颜色为 color-xxx
  2. size - 当前图标的大小,数字生成 fa-2x,字符串 fa-lg
  3. fw - 当前图标的固定宽度 fa-fw
  4. element - 当前图标的自定义 HTML 元素
  5. style - 当前图标的样式 (fas|far|fal|fab 等。)
  6. 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>