README

用于在Yii 2.0 PHP框架中选择Font Awesome符号集合的Widget。

SymbolPicker 允许您从Font Awesome中选择符号的类名。它还允许您选择颜色和额外效果的类名。

SymbolPicker widget的演示在此处。

先决条件

SymbolPicker 仅在有Font Awesome加载在您的网站上时才有意义。实现此目的的最简单方法是向网站的AppAsset.php文件的css属性中添加一行（查看assets目录），如下所示

<?php
class AppAsset extends AssetBundle
{
    public $css = [
    	'//maxcdn.bootstrap.ac.cn/font-awesome/4.2.0/css/font-awesome.min.css',
    	'css/site.css'
		...	// other css files
	];
	...
}
?>

还有其他方法使Font Awesome可用于您的网站。

安装

安装 SymbolPicker 的首选方式是通过 Composer。要么将以下内容添加到您的composer.json文件的require部分

"geoffry304/yii2-symbol-picker": "*"

或者运行

$ php composer.phar require geoffry304/yii2-symbol-picker "*"

您可以通过下载ZIP格式的源代码来手动安装 SymbolPicker。

使用SymbolPicker

SymbolPicker 是一个Yii 2.0 InputWidget。像任何其他InputWidget一样，它可以与一个 model 和一个 attribute （或一个 name 和一个 value）关联。

Symbolpicker 位于命名空间 geoffry304\symbolpicker。

例如，要将 SymbolPicker 与表单视图中的 'icon' 属性关联，请使用如下代码

use geoffry304\symbolpicker\SymbolPicker;

...
<?= $form->field($model, 'icon')->widget(SymbolPicker::className()) ?>
...

选项

SymbolPicker 默认即可运行。它有以下选项来修改其行为

• labels：widget使用的标签列表。如果标签设置为 false，则对应的元素将不会渲染。
• icons：可选的Font Awesome图标列表。每个项目是图标的类名，不带 'fa-' 部分。例如，'calculator' 指的是 'fa-calculator' 图标。默认：所有Font Awesome图标，不包括别名。版本4.3。见：http://fontawesome.io/icons/。
• colors：可选的颜色列表。每个项目是颜色名称，将生成一个 'col-***' 颜色类名。例如，'darkblue' 指的是类名 'col-darkblue'。默认：CSS3命名颜色选择。
• effects：可选的Font Awesome效果列表。每个项目是效果的类名，不带 'fa-' 部分。例如，'flip-horizontal' 指的是 'fa-flip-horizontal' 效果。默认：大多数Font Awesome效果。版本4.2。见：http://fontawesome.io/examples/#rotated-flipped。
• buttonOptions：下拉按钮的HTML选项数组。默认：[]（空数组）。您可以使用此选项设置按钮的CSS类。

当然，SymbolPicker 也具有正常的 InputWidget 属性。

颜色类

所有 CSS3 命名颜色的 CSS 颜色类都包含在文件 assets\symbol-colors.css 中。您可以在项目的其他部分使用这些。