sameiddin / bootstrap-bundle
v0.1.3
2014-08-05 08:41 UTC
Requires
- symfony/config: ~2.3
- symfony/dependency-injection: ~2.3
- symfony/form: ~2.3
- symfony/http-kernel: ~2.3
- symfony/twig-bridge: ~2.3
This package is not auto-updated.
Last update: 2022-02-01 13:13:14 UTC
README
此包提供对 Bootstrap 3 的非侵入式支持。这里的“非侵入式”意味着除非您明确要求,否则不会强制应用某些特定的样式。例如,默认情况下,表单会得到默认的 Bootstrap 布局——不是水平布局或其他布局。
安装
该包假设您会自行安装 Bootstrap,方式不限,无论是通过 Composer 包还是通过 Bower。
要安装该包,请将以下内容添加到您的 composer.json
{
"require": {
"elnur/bootstrap-bundle": "~0.1"
}
}
然后告诉 Composer 安装该包
$ php composer.phar update elnur/bootstrap-bundle
然后通过在您的 AppKernel.php
中添加以下内容来启用该包
public function registerBundles()
{
$bundles = array(
// ...
new Elnur\Bundle\BootstrapBundle\ElnurBootstrapBundle,
);
// ...
}
表单
要使用默认的 Bootstrap 布局渲染表单,只需做以下操作
{{ form(form) }}
如果您想使用其他布局——比如水平布局——请明确指出
{{ form(form, {layout: 'horizontal'}) }}
支持的布局有
- 默认布局
水平布局
,行内布局
和导航栏布局
.
按钮
上下文
要设置按钮的上下文,请使用 context
选项
$builder->add('submit', 'submit', array(
'context' => 'primary',
));
Bootstrap 提供以下上下文
默认
,主要
,成功
,信息
,警告
,危险
,以及链接
.
输入组
要为输入添加前置或后置文本附加项,请分别使用 prepend
和 append
选项
$builder->add('price', 'integer', array(
'prepend' => '$',
'append' => '.00',
));
将标签转换为占位符
如果您想将标签转换为占位符,请将 labels_to_placeholders
选项设置为 true
{{ form(form, {labels_to_placeholders: true}) }}
闪存消息
要渲染闪存消息,只需将以下内容添加到您的布局模板中
{% include 'ElnurBootstrapBundle::flash.html.twig' %}