README

获取文件扩展名的字体图标的小部件

安装

运行命令

composer require black-lamp/yii2-file-icons

或添加

"black-lamp/yii2-file-icons": "^1.0.0"

到你的composer.json的require部分。

使用

使用示例

$widget = \bl\files\icons\FileIconWidget::begin([
    'icons' => [
        'txt' => [
            'icon' => \yii\helpers\Html::tag('i', '', ['class' => 'icon-file-txt'])
        ],
        'groups' => [
            [
                'extensions' => ['jpg', 'png', 'gif'],
                'icon' => \yii\helpers\Html::tag('i', '', ['class' => 'icon-picture'])
            ],
        ]
    ]
]);
echo $widget->getIcon('image.jpg');
$widget->end();

方法FileIconWidget::getIcon()接受文件扩展名、文件名或文件的完整路径，并返回文件扩展名的图标。图标从配置数组中获取。如果在配置数组中未找到图标，则方法返回空图标。空图标值从emptyIcon小部件选项中获取。

小部件配置属性

默认图标集

如果您将小部件选项useDefaultIcons设置为true，则方法FileIconWidget::getIcon()将返回文件扩展名的默认图标。此外，如果您不想为当前文件扩展名使用默认图标，您还可以覆盖默认图标。请参阅。

<i class="file-text"></i>
<i class="file-pdf"></i>
<i class="file-power-point"></i>
<i class="file-archive"></i>
<i class="file-word"></i>
<i class="file-excel"></i>
<i class="file-picture"></i>
<i class="file-video"></i>
<i class="file-code"></i>

或使用\bl\files\icons\helpers\IconHelper

IconHelper::icon('text');
IconHelper::icon('pdf');
IconHelper::icon('power-point');
IconHelper::icon('archive');
IconHelper::icon('word');
IconHelper::icon('excel');
IconHelper::icon('picture');
IconHelper::icon('video');
IconHelper::icon('code');

black-lamp / yii2-file-icons

维护者

详细信息

README

安装

使用

小部件配置属性

默认图标集