README

此包不再维护！请参阅fewagency/fluent-form和fewagency/fluent-html以获取我们使用的替代品！

用于显示Twitter Bootstrap html元素和组件的Laravel Blade模板集合。

配置

将此添加到config/app.php中的提供者列表

'FewAgency\TwbsBlade\TwbsBladeServiceProvider',

使用示例

单个输入字段

示例

@include('bsb::input.text', ['name'=>'test', 'label'=>'Your email address'])

打印完整表单

示例

@include('bsb::form', ['action' => action('ExampleController@update', $model->getKey()), 'model' => $model, 'groups' => [
    'title' => ['label' => 'Name'],
    'content' => ['label' => 'Text', 'help_text' => 'This is displayed next to the input and connected to it with aria-describedby'],
    'number' => ['label' => "A number", 'type'=>'number'],
    'currency_code' => ['type' => 'select', 'label' => "Currency", 'options' => ['SEK' => 'Svenska kronor', 'GBP' => 'British Pounds']],
    '<button type="submit" class="btn btn-default">Save</submit>'
]])

表单选项

每个表单将包含一个隐藏的csrf字段，并且默认情况下将在每个输入旁边显示验证信息。

groups

要在表单中显示的输入（或其他元素）数组。数组键是输入name，每个条目通常是输入选项的数组。

条目也可以是单个字符串或非关联数组字符串，如果是这样，它们将作为.form-group元素内的html字符串显示。

model（可选）

如果提供，输入将预先填充此对象对应的属性值。

action（可选）

直接映射到表单的action属性。如果省略，表单通常将回发到当前页面。

method（可选）

直接映射到表单的method属性。默认为POST，可以设置为GET。

role（可选）

直接映射到表单的role属性。默认为form。

form_id（可选）

设置表单的id属性。如果省略，默认为生成的id。

group_form_errors（可选）

默认为false，但如果为true，所有错误消息将一起显示在表单顶部，而不是显示在其相关输入旁边。这对于验证消息与特定输入不直接相关的表单很有用，例如登录表单。

输入选项

名称

输入名称，将与表单一起发布。如果使用 bsb::form 模板，则此选项将从数组键中获取。

类型

如果省略，默认为 text。实现类型包括：

• text
• checkbox
• select
• multiselect
• password

此外，大多数 HTML5 输入类型都可以正常工作，例如 number、email 等。多选类型将自动将括号添加到表单输入的名称中，以便在服务器端以数组形式访问选定的值。

标签/html_label

显示在输入之前，并通过元素的 id 与其连接。如果没有提供，则默认为 name。

帮助文本/html_help_text

在输入之后显示，并通过 aria-describedby 与其连接。

帮助块标签

可以覆盖包含帮助文本的 HTML 元素的类型。如果没有设置，则在 help_text 周围使用 span，在 html_help_text 周围使用 div。

无标签

将此设置为 true 以不显示任何标签。

组标签

将此设置为 true 在复选框上显示组标签，而不是在输入标签内显示标签。

无组

设置为 true 以不向输入的分组 div 应用 .form-group 类。对于使复选框列表更紧凑很有用。

值

可用于特别设置输入的 value 属性。值通常自动从旧输入或模型中获取。复选框的默认值为 1。

已选择值

可用于选择和多重选择，以指定预选值或预选值的数组。这通常自动从旧输入或模型中获取。

已选中

在复选框上设置为 true 以使其为预选。否则，选中状态将从旧输入或模型中获取。

选项/选项_html

可用于选择和多重选择，以指定可用的选项列表。在 select 标签内使用 options_html 作为原始输出。 options 可以是一个包含标签字符串的数组，其对应的值作为键。如果没有指定选项，则将检查提供的 model 中是否存在名为 inputname_options 的属性。

输入属性

在输入元素上添加的额外HTML属性（键和值）数组。布尔属性（如disabled）可以设置为true以达到期望的效果。如果在此处设置了class属性，其值将与任何其他已自动设置的类合并。

可选的包配置

如果您的应用中扩展了服务提供器类并设置了所需的$package_reference_name（如果您这样做，请记住在您的config/app.php中引用您自己的服务提供器而不是本包提供的服务提供器），则可以更改bsb前缀。

您可以将Blade模板发布到项目的views/vendor目录中进行编辑和覆盖原始模板。

php artisan vendor:publish --provider="FewAgency\TwbsBlade\TwbsBladeServiceProvider"