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.2.0 (2016年1月23日)

#331 翻译菜单标签 (由 kamiramix 完成)
#364 更新受支持的表单主题关键字以替换 form.resources 关键字 (由 cordoval 完成)
#367 为列表列表添加缺少的 ul 标签 (由 ocetnik 完成)
#374 更新到与 Symfony 2.6 兼容的表单扩展 (由 kralos 完成)
#376 升级到与 Symfony 2.6 兼容的表单类型 (由 althaus 完成)
#382 使用 choice_translation_domain 选项 (由 Restless-ET 完成)
#383 添加按钮 Twig 函数 (由 bigfoot90 完成)
#384 修复 ScriptHandler 以正确与 HHVM 一起工作 (由 mdurys 完成)
#385 使用url选项代替hread属性（由bigfoot90提交）
#392 使用不同图标集的图标助手（由bigfoot90提交）
#393 将twig扩展切换到使用SimpleFunction/SimpleFilter（由dkisselev提交）
#394 为常见方法添加Twig集成测试（由dkisselev提交）
#395 为图标、parse_icons、button、button_link Twig扩展添加集成测试（由bigfoot90提交）
#397 将JS removeField事件更改为允许在移除元素后捕获（由DarekTw提交）
#399 Twig弃用（由benr77提交）
#404 修复bc-bootstrap-collection.js .size()弃用（由jounisuo提交）
#414 修复与Symfony 3.0的兼容性（由lashus提交）
#417 将sameas替换为same（由bartwesselink提交）

版本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 为FlashMessage添加danger()方法（由florianeckerstorfer提交）
#316 修复嵌套子表单设置（由vith提交）
#320 调整bootstrap.scss的路径（由mioduszewski提交）
#328 为bootstrap_collection按钮添加parse_icons函数（由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 添加对静态表单控件的 support（由 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 不为 null 时添加空的 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 添加了重置闪存袋的方法（由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-beta2（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 集合表单类型
#155: 在安装图标字体时使用 braincrafted_bootstrap.output_dir 选项
#52: 为分页添加类选项
#148: 为整个表单添加 label_col 和 widget_col 选项（由 florianeckerstorfer 和 dirkluijk 提供）
#156: 添加对带有参数的错误消息的支持（由 thanosp 提供）
#157: 使用 print 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 许可证许可

philetaylor / bootstrap-bundle

维护者

详细信息