itlized / mopa-bootstrap-bundle
轻松将Twitter Bootstrap集成到symfony2
Requires
- mopa/composer-bridge: ~1.3
- symfony/console: ~2.3
- symfony/form: ~2.3
- symfony/framework-bundle: ~2.3
- symfony/twig-bundle: ~2.3
Suggests
- craue/formflow-bundle: ~2.0
- jlong/sass-twitter-bootstrap: dev-master
- knplabs/knp-menu-bundle: ~2.0@dev
- knplabs/knp-paginator-bundle: ~2.3
- mopa/bootstrap-sandbox-bundle: ~2.3
- twbs/bootstrap: >2.0,<4.0-dev
This package is not auto-updated.
Last update: 2024-09-24 01:26:36 UTC
README
MopaBootstrapBundle 是一个代码集合,旨在尽可能容易地将Twitter的Bootstrap (http://twitter.github.com/bootstrap/) 集成到您的symfony2 (http://www.symfony.com) 项目中。
Bootstrap 3 的支持现在主要完成。查看 Beta-3
要在项目中使用 MopaBootstrapBundle 和 Twitter Bootstrap 3,请通过 composer 添加
注意
最近的BC(向后兼容)中断
- dc4fd12: [BC Break] 完全移除了内联
- add75e9: 将配置 mopa_bootstrap.navbar 重命名为 mopa_bootstrap.menu
BS3(此包的master分支)几乎稳定,请参阅 Beta-3 BS2(v2.3.x)相当稳定
BC中断变化可能不会移植到2.3。
分支
要使用此包与Bootstrap 3一起使用,请使用master分支
{ "require": { "mopa/bootstrap-bundle": "v3.0.0-beta3", "twbs/bootstrap": "v3.0.0" } }
对于Bootstrap 2,请使用v2.3.x分支
If you want to use bootstrap 2: { "require": { "mopa/bootstrap-bundle": "2.3.x-dev", "twbs/bootstrap": "v2.3.2" } }
要了解当前需要哪些版本,请查看 BRANCHES.md
文档
大部分文档存储在此包的 Resources/doc/index.md
文件中。无论如何,如果在更新后某些功能不按预期工作
最近的向后兼容中断变化
- c892cd9: 改变了创建导航栏的方式,请阅读 文档
- a4b78d5: 添加了BS2或BS3的版本检测
- 5f1200f: 将 widget_addon 表单参数更改为使用类型(prepend/append)而不是 append(true/false)
实时展示
要查看此包,其功能和一些文档,请查看
其他资源
- MopaBootstrapSandboxBundle - 将代码与代码分离的独立实时文档
- symfony-bootstrap 也可用
安装
安装说明位于
包含的功能
- 通过Composer桥检测Bootstrap版本
- 用于与symfony2表单组件一起使用的Twig扩展和模板
- 通过表单构建器或模板引擎控制您的表单
- 控制几乎所有bootstrap2表单功能
- 用于动态集合的javascript和twig块
- 一个通用的Navbar类,用于在模板外生成您的Navbar
- 下拉菜单、分隔符等辅助函数
- 一个通用的Tab类,用于管理Bootstrap标签页
- 为 KnpPaginatorBundle (https://github.com/knplabs/KnpPaginatorBundle) 提供的twig模板
- 为 CraueFormFlowBundle (https://github.com/craue/CraueFormFlowBundle) 提供的twig模板
- 为 KnpMenuBundle (https://github.com/KnpLabs/KnpMenuBundle) 提供的twig模板
- 菜单链接上的图标支持
最近添加的功能
标签页
这里需要添加更多信息Bootstrap 3
我们现在正式在主分支中支持Bootstrap 3,默认是通过composer确定版本,这意味着,MopaBootstrapBundle会尝试确定您已安装的版本,并配置自己使用它。这是在编译器过程中完成的,并存储在本地缓存中。如果由于任何原因这不适合您,您可能需要设置
我们为bs2和bs3提供了一些单独的文件,以便能够支持两者,例如表单
- https://github.com/phiamo/MopaBootstrapBundle/blob/master/Resources/views/Form/fields_bs_2.html.twig
- https://github.com/phiamo/MopaBootstrapBundle/blob/master/Resources/views/Form/fields_bs_3.html.twig 或 JS
- https://github.com/phiamo/MopaBootstrapBundle/blob/master/Resources/public/js/eyecon-bootstrap-datepicker.js
- https://github.com/phiamo/MopaBootstrapBundle/blob/master/Resources/public/js/eyecon-bootstrap-3-datepicker.js
bs3功能集尚未完成,但我们希望它很快就会完成,在您的帮助下!例如,表单有一些已知问题,JS集合等
动态子导航栏
为了启动您的导航,Navbar组件进行了一些外观提升。集成动态子导航栏(您可能在twitter bootstrap文档中看到过)变得更加容易。
要了解如何使用此功能,请阅读Navbar文档(4-navbar-generation)。
还可以查看沙盒。
initializr
为了让您的HTML5基础更好,并让您使用我们添加到这个捆绑包中的良好实践,我们添加了来自HTML5 BoilerPlate项目的功能。集成是通过使用Initializr预先生成的设置来完成的。实际上,我们支持HTML5 BoilerPlate v3.0.3与Modernizr v2.5.3和Respond。
要了解如何使用这些功能,请阅读Initializr文档(50-Initializr.md)。
警告
分支策略已经调整以更灵活
- 旧版本的bootstrap 1.x分支(v1.x)仍然存在。
- v2.0.x(以前为v2.x_sf2.0)分支遵循Symfony 2.0.x和bootstrap 2.x
- 主分支遵循Symfony主分支和bootstrap 2.x
- master-crud分支遵循Symfony主分支和bootstrap 2.x,但仍然有CRUD生成器,它依赖于SensioGeneratorBundle
翻译
如果您使用KnpPaginatorBundle与MopaBootstrapBundle一起,您可以将标签翻译成您的语言。为此,请添加新文件
Resources/translations/pagination.[YOUR LOCALE CODE].yml
例如,您有波兰语翻译。
贡献
如果您想为MopaBootstrapBundle贡献代码,请确保您的PR符合Symfony2.1编码标准。您可以使用PHP-CS-Fixer工具自动修复您的代码。
您可以在贡献者页面查看已经为此项目做出贡献的人。
许可证
此捆绑包受MIT许可证的约束。有关更多信息,请参阅捆绑包中的完整LICENCE文件。