elvendor / imgjss
Imgjss 为 Laravel 4 提供的包
v0.8
2014-08-20 04:29 UTC
Requires
- php: >=5.4.0
- illuminate/support: ~4
README
Imgjss 是一个简单的 Laravel 4 包,它提供了一个方便的方法将资源包含到您的 .blade.php
文件中。现在您可以使用简短的 Blade 语法来使用 HTML::style()
、HTML::script()
和 HTML::image()
。
加入我们的 俄罗斯 Laravel 社区 的 Gitter 聊天室!
特性
避免放置 js & css 文件的扩展名,包会自动添加
@js('js/jquery.js')
等同于
@js('js/jquery')
但对于图像,您 必须 使用文件扩展名
@img('uploads/cat.jpg')
将属性数组作为第二个参数传递
@css('css/print', ['media' => 'print'])
默认情况下,包会自动将文件的最后修改时间戳作为查询字符串附加。您可以在配置文件中更改/禁用此行为,或者简单地传递 true/false 作为第三个参数
@js('js/translations', ['charset' => 'utf-8'], false) // disabled timestamp appending
当使用 Laravel 的 HTML::image()
时,您将 alt
属性作为第二个参数传递,并将其他属性作为第三个参数传递。我认为这不是一个好主意。使用这个包提供的 @img
语法,您可以一次性传递所有内容到一个数组中
@img('img/logo.png', ['alt' => 'Alternative text', 'class' => 'brand-logo'])
第四个参数用于从网站的受保护位置包含资源,例如 https://...
。默认为 false
。
最后,请注意,当资源不存在时,包 不会 抛出 NotFoundException。
要求
- PHP >= 5.4
- Laravel >= 4.0
安装
- 您可以通过将
elvendor/imgjss
包含在您的composer.json
文件中,通过 Composer 安装 Imgjss 包
{ "require": { "laravel/framework": "4.*", "elvendor/imgjss": "0.*" }, "minimum-stability": "dev" }
- 将服务提供者添加到提供者列表中
'providers' => [ // ... 'Elvendor\Imgjss\ImgjssServiceProvider', ],
- 如果您计划更改包的默认设置,您还可以发布配置文件
php artisan config:publish elvendor/imgjss
路线图
- 通过在给定路径上查找文件来避免图像扩展名(可能不是一个好主意)
- 设置默认的 js、css、img 路径
- 能够使用外部资源
- 编写测试用例