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_themes 支持的关键字以替换 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 如果有 hread 属性，则使用 url 选项 (由 bigfoot90)
#392 使用不同图标集的图标辅助器（由 bigfoot90 提供）
#393 将 twig 扩展更改为使用 SimpleFunction/SimpleFilter（由 dkisselev 提供）
#394 为常见方法添加 Twig 集成测试（由 dkisselev 提供）
#395 为图标、parse_icons、按钮、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 将 danger() 方法添加到 FlashMessage（由 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中向checkbox_row和radio_row传递label_attr（由florianeckerstorfer完成）
#241 当集合为空时删除错误的按钮间距（由sandello-alkr完成）
#241 使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 已不再提供非响应式版本
添加了 boostrap_money 表单类型，该类型使用 Bootstraps prepend 或 append 风格来显示货币
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：修复复选框小部件的class属性（由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：使用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许可证授权

braincrafted / bootstrap-bundle

维护者

详细信息