README

BraincraftedBootstrapBundle 帮助您将 Bootstrap 集成到您的 Symfony2 项目中。BootstrapBundle 还支持 Bootstrap 的官方 Sass 版本和 Font Awesome。

安装

首先，您需要将 braincrafted/bootstrap-bundle 添加到 composer.json

{
   "require": {
        "braincrafted/bootstrap-bundle": "dev-master"
    }
}

请注意，dev-master 指向最新版本。如果您想使用最新开发版本，请使用 dev-develop。当然，您也可以使用显式版本号，例如，2.1.*。

您还必须将 BraincraftedBootstrapBundle 添加到您的 AppKernel.php

// app/AppKernel.php
//...
class AppKernel extends Kernel
{
    //...
    public function registerBundles()
    {
        $bundles = array(
            ...
            new Braincrafted\Bundle\BootstrapBundle\BraincraftedBootstrapBundle()
        );
        //...

        return $bundles;
    }
    //...
}

此外，您还必须将 Bootstrap 和 jQuery 作为依赖项安装，并配置 Assetic 以编译 LESS 文件。您可以在文档的入门部分中找到更多信息。

兼容性

此捆绑包有两个主要依赖项，Symfony 和 Bootstrap。下表显示了 BraincraftedBootstrapBundle 的哪个版本与 Symfony 和 Bootstrap 的哪个版本兼容。

变更日志

版本 2.1.2（2015年3月6日）

在恢复表单设置时，如果没有要恢复的设置，不要抛出异常（由 florianeckerstorfer）
#356 添加缺少的 responsive-embed.less（由 blaues0cke）

版本 2.1.1（2015年1月31日）

#301 修复了为 Symfony v2.5 生成的命令（由 mumia）
#311 在集合的添加和移除中触发事件（由 tiagobrito）
#315 将 danger() 方法添加到 FlashMessage（由 florianeckerstorfer）
#316 修复嵌套子表单设置（由 vith）
#320 调整到 bootstrap.scss 的路径（由 mioduszewski）
#328 为 bootstrap_collection 按钮添加解析图标函数（由 kamiramix）
#329 删除无效语句（由 KatharinaSt）
#337 无效的类名 .btn-small （由 tmilos 提出）
#342 修正PHPCS的一些小错误（由 acrobat 提出）
#344 排除可迭代表达式的值显示（由 b-b3rn4rd 提出）
#345 添加可关闭的警告样式（由 althaus 提出）
#350 修复当标签为空时行内样式不显示占位符的问题（由 florianeckerstorfer 提出）
#309 在顶部包含默认变量文件（由 florianeckerstorfer 提出）

版本 2.1.0 （2014年8月31日）

#298 修复bootstrap-sass v3.2中资源目录的路径（由 florianeckerstorfer 提出）

版本 2.1.0-beta2 （2014年8月21日）

#237 在choice_widget_expanded中将label_attr传递给checkbox_row和radio_row（由 florianeckerstorfer 提出）
#241 当集合为空时移除错误的按钮间距（由 sandello-alkr 提出）
#242 使install命令中的web目录可配置（由 florianeckerstorfer 提出）
#245 添加对symfony-bin-dir的支持（由 nifr 提出）
#249 根据深度添加基于nav类的样式（由 bkosborne 提出）
#251 添加对静态表单控件的支撑（由 bdm-benzor 提出）
#252 修复当label = false时的行为（由 rdohms 提出）
#254 移除菜单根块中的空格（由 dirkluijk 提出）
#260 更新默认jQuery路径（由 sprankhub 提出）
#263 修复全局错误CSS类（由 althaus 提出）
#266 修复标签列大小为false的问题（由 jeroenvds 提出）
#274 在 `bootstrap-collection` 中添加缺失的空格（由 bdm-benzor 贡献）
#275 为单选框和单选按钮添加帮助文本（由 bostaf 贡献）
#276 添加对 leafo/scssphp 的支持（由 stefanosala 贡献）
#279 不要在 file 小部件中渲染值（由 florianeckerstorfer 贡献）
#281 为图标添加额外的 CSS 类（由 wodka 贡献）
#283 使图标标签可配置（由 wodka 贡献）
#286 添加对表单动作的支持（由 derpue 贡献）
#287 添加对输入组按钮的支持（由 rdohms 贡献）
#289 移除复选框和单选按钮小部件末尾的空白字符（由 morticue 贡献）
#290 为静态控件添加表单类型（由 derpue 贡献）

版本 2.1.0-beta1（2014年5月29日）

#238 当选择字段中的 `empty_value` 不为空时，添加空 value 字段
#239 从错误消息中移除 translation_domain
#214 检查 preSubmit 错误（由 sandello-alkr 贡献）
#240 在默认布局中包含 head 块

版本 2.1.0-alpha1（2014年5月16日）

#203 添加对 bootstrap-sass 的支持（由 sandello-alkr 和 florianeckerstorfer 贡献）
#160 添加对 Font Awesome 的支持（由 florianeckerstorfer 贡献）
#229 修复默认布局中的 bootstrap.js 路径（由 nonlux 贡献）
#221 修复嵌套集合生成的键（由 sandello-alkr 贡献）
#220 添加配置图标前缀的选项（由 llwt 贡献）
#206 为表单标签使用 raw 过滤器（由 sandello-alkr 贡献）
#209 修复了与 KnpMenu 的兼容性问题（由 mbutkereit 提供）

版本 2.0.1（2014年4月3日）

#168 从 form-group 中移除了 CSS 类 row
#182 添加了对表单操作（带有多个按钮的行）的支持（由 rdohms 提供）
#187 使默认按钮类可更改（由 sandello-alkr 提供）
#188 为表单按钮添加了图标（由 mvrhov 提供）
#190 添加了对堆叠标签的支持（由 aur1mas 提供）
#192 添加了重置 flash bag 的方法（由 JulienRamel 提供）
#196 从子元素中移除了 CSS 类 nav（由 dylanschoenmakers 提供）
#198 在 prepend 和 append 输入组中添加了对图标的解析（由 yvh 提供）
修复了 file 表单类型（由 hsz 提供）

版本 2.0.0-alpha1

更新到 Symfony v2.3.6
更新到 Bootstrap v3.0.1
更新到 jQuery v1.10.2
移除 include_responsive 选项，因为 Bootstrap 3.0 不再具有非响应版本
添加了使用 Bootstraps prepend 或 append 风格显示货币的 boostrap_money 表单类型
percent 表单类型使用 Bootstraps append 风格显示百分比符号
将命名空间改回 Braincrafted\Bundle\BootstrapBundle
支持自定义 variables.less
几个 Twig 过滤器现在为函数
添加了用于全局设置表单样式的 bootstrap_set_style 和 bootstrap_get_style Twig 函数
添加了生成自定义 bootstrap.less 文件的命令
添加了将图标字体复制到 web/ 目录的命令
添加了用于复制图标字体的 Composer 脚本处理器
分页现在支持禁用链接
添加了 badge Twig 函数
移除了 badge_* Twig 过滤器（Bootstrap v3.0 不包括多个徽章样式）
label_* Twig 过滤器现在是 Twig 函数
icon Twig 过滤器现在是 Twig 函数
添加了 braincrafted_collection 表单类型

版本 2.0.0-alpha2

修复了与 PHP 5.3 的兼容性（修复了 #111）
将 braincrafted_collection 重命名为 bootstrap_collection
在表单构建器中定义了 widget_col、label_col 和 simple_col（修复了 #113）
添加了对输入组的支持
修复了没有定义占位符时内联表单的 bug

版本 2.0.0-alpha3

修复了表单构建器中输入组的配置（修复了 #115）
修复了 braincrafted_bootstrap.output_dir 选项中的尾部斜杠
修复了分页模板中的未定义变量
进行了更好的测试

版本 2.0.0-beta1

修复了 choice_widget_expanded 中的重复 div.form-group（修复了 #131）
在不使用 LESS 时使用正确的资源（修复了 #128） [amcgowanca]
添加了用于设置表单小部件列大小的 col_size 选项（修复了 #127）
在 textarea_widget 中添加了对 simple_col 选项的支持
重命名了视图
在 checkbox_row 和 radio_widget 中添加了错误信息（修复了 #118）

版本 2.0.0-rc2（2013年12月9日）

#133：修复集合小部件中的 label_col、widget_col、col_size 和 simple_col 选项
#136：添加了 bootstrap_collection 小部件的翻译
#137：从默认的 Assetic 配置中删除了 cssrewrite 过滤器
#139：修复了嵌套 bootstrap_collection 小部件的 JavaScript（由 wizart 提供）
#140：改进了 composer.json 中的依赖关系列表（由 hason 提供）
#142：添加了帮助块和错误信息的翻译
#143：添加了闪存信息模板的翻译（由 rdohms 提供）
#144：修复了复选框小部件的类属性（由 squaye85 提供）
#145：添加了全局错误信息的样式选项
将配置选项 customize_variables 重命名为 customize

版本 2.0.0-stable（2014年1月2日）

#152：添加表单名称属性（由 nonlux 提供）
#154：修复了嵌套类型中的 Bootstrap Collection 表单类型
#155：安装图标字体时使用 braincrafted_bootstrap.output_dir 选项
#52：添加分页的类选项
#148：为整个表单添加了 label_col 和 widget_col 选项（由 florianeckerstorfer 和 dirkluijk 提供）
#156：添加了对带有参数的错误信息的支持（由 thanosp 提供）
#157：使用打印 shiv 而不是标准 shiv（由 mvrhov 提供）
#161：在 FormBuilder 中设置 style 选项
#162：设置导航深度。

版本 1.5.0

与新的 Bootstrap 仓库 twbs/bootstrap 兼容
对 Bootstrap v3.0 基本支持
允许在菜单中覆盖选项
从基本表单布局扩展
修复了 JavaScript 集合表单类型中删除元素的问题
其他各种错误修复

版本 1.4.0

将命名空间更改为 Bc\Bundle\BootstrapBundle
自动配置 Twig
自动配置 KnpMenuBundle
自动配置 KnpPaginatorBundle
自动配置 Assetic
改进了复合字段中错误信息的布局
改进了代码样式（使用 PHP_CodeSniffer 和 PHPMD）
支持集合字段中的 data-prototype 选项
闪存信息的辅助器和模板

版本 1.2.0

添加了对 Assetic 的支持

许可

该捆绑包根据 MIT 许可证许可
Twitter Bootstrap 的 CSS 和 JavaScript 文件在 3.1 版本之前的所有版本中根据 Apache License 2.0 许可
Twitter Bootstrap 的 CSS 和 JavaScript 文件从 3.1 版本开始根据 MIT 许可证许可

meniam / bootstrap-bundle

维护者

详细信息