elvendor/imgjss

Imgjss 为 Laravel 4 提供的包

v0.8 2014-08-20 04:29 UTC

This package is auto-updated.

Last update: 2024-09-05 15:40:16 UTC


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 路径
  • 能够使用外部资源
  • 编写测试用例

许可证

Imgjss 是开源软件,根据 MIT 许可证 发布。