parker/laravel-betterhtml

Laravel 4 的更好用的 HtmlBuilder(包括对原始、未转义的 HTML 以及更多标签的支持)

dev-master 2014-09-11 04:26 UTC

This package is not auto-updated.

Last update: 2024-09-24 04:09:53 UTC


README

Laravel 4 的扩展版、向后兼容的 HtmlBuilder,具有原始 HTML(以及嵌套构建方法)、用于 所有 HTML5 标签 的方法、方便的函数用于创建 <meta name="description"> 标签,以及简单的包装功能。

用法

{{ Html::div(Html::linkAction('HomeController@index', 'Back to Home'), ['class' => 'home-link']) }}

{{ Html::nav(Html::ul([

    Html::linkAction('HomeController@index', 'Home'),
    Html::linkAction('AboutUsController@index', 'About Us'),
    Html::linkAction('BlogController@index', 'Blog'),
    Html::linkAction('ContactController@form', 'Contact Us'),

], ['class' => 'navigation-list'])) }}

安装

首先,将以下行添加到您的 composer.json 中的 "require"

"parker/laravel-betterhtml": "~0.1"

接下来,从命令行运行 composer update。之后,需要替换您的 app.php 配置文件中的以下服务提供者(您可以自由地将其注释掉)

'Illuminate\Html\HtmlServiceProvider',

使用这个

'Parker\BetterHtml\Html\HtmlServiceProvider',

为了能够通过 HTML 外观访问 Better HtmlBuilder,您需要替换 app.php 配置文件中的以下别名(您可以自由地将其注释掉)

'HTML' => 'Illuminate\Support\Facades\HTML',

使用这个

'HTML' => 'Parker\BetterHtml\Support\Facades\HTML',

另外,由于 Laravel 的 e() 辅助函数的定义和使用方式(参见 laravel/framework PR #4783),您还需要在 app/start/global.php 中包含 BetterHtml 的自定义 e() 辅助函数

/*
|--------------------------------------------------------------------------
| Load the Better HtmlBuilder helpers
|--------------------------------------------------------------------------
|
| Here we load helpers for the Better HtmlBuilder so that they can
| override ones provided by laravel in Illuminate\Support\helpers.php.
|
*/

$betterHtmlVendor = $app['path.base'] . '/vendor/parker/laravel-betterhtml';

require $betterHtmlVendor . '/src/Parker/BetterHtml/Support/helpers.php';

贡献

您知道如何使 Laravel 的 HtmlBuilder 更加出色吗?请以问题的形式提交您的想法,并在该存储库中附上您的提案和示例用法。非常欢迎提交错误拉取请求(但如果您找不到原因,报告也行)。

要求

  • PHP >= 5.4.0
  • Laravel 4.2

许可证

BetterHtmlBuilder for Laravel 4 是开源软件,在 MIT 许可证 下发布。