cornford/bootstrapper

一种简单的方法将Twitter Bootstrap集成到Laravel中。

v2.6.0 2020-05-03 07:56 UTC

README

Latest Stable Version Total Downloads Build Status Scrutinizer Code Quality

对于Laravel 4.x,请查看版本1.5.1

Bootstrap可以被视为一种简单的方式将Bootstrap集成到Laravel 4中,提供各种辅助工具以加快开发速度。这包括

  • Bootstrap::css
  • Bootstrap::js
  • Bootstrap::vertical
  • Bootstrap::horizontal
  • Bootstrap::inline
  • Bootstrap::text
  • Bootstrap::password
  • Bootstrap::email
  • Bootstrap::telephone
  • Bootstrap::number
  • Bootstrap::url
  • Bootstrap::range
  • Bootstrap::search
  • Bootstrap::file
  • Bootstrap::date
  • Bootstrap::datetime
  • Bootstrap::time
  • Bootstrap::textarea
  • Bootstrap::select
  • Bootstrap::checkbox
  • Bootstrap::radio
  • Bootstrap::submit
  • Bootstrap::button
  • Bootstrap::reset
  • Bootstrap::link
  • Bootstrap::secureLink
  • Bootstrap::linkRoute
  • Bootstrap::linkAction
  • Bootstrap::mailto
  • Bootstrap::none
  • Bootstrap::success
  • Bootstrap::info
  • Bootstrap::warning
  • Bootstrap::danger

安装

首先通过Composer安装此包。编辑项目的composer.json文件,以需求cornford/bootstrapper

"require": {
	"laravelcollective/html": "5.*",
	"cornford/bootstrapper": "2.*"
}

接下来,在终端中更新Composer

composer update

此操作完成后,下一步是添加所需的服务提供者。打开app/config/app.php,并将新项目添加到提供者数组中。

'Collective\Html\HtmlServiceProvider',
'Cornford\Bootstrapper\BootstrapServiceProvider',

最后一步是引入所需的门面。打开app/config/app.php,并将新项目添加到别名数组中。

'Form'            => 'Collective\Html\FormFacade',
'HTML'            => 'Collective\Html\HtmlFacade',
'Bootstrap'       => 'Cornford\Bootstrapper\Facades\Bootstrap',

如果您想引入包的JavaScript和CSS,请运行以下命令以将其拉入您的项目。

php artisan vendor:publish --provider="Cornford\\Bootstrapper\\BootstrapServiceProvider"

这就完成了!您可以开始使用了。

使用方法

为了包含Bootstrap依赖项,您需要在布局/页面模板的头部部分使用Bootstrap::css()和Bootstrap:js()方法。

这非常简单,就像在任何Controller/Model/文件中使用Bootstrap类一样

Bootstrap:

这将为您提供访问权限

CSS

css方法通过CDN/本地文件包含Bootstrap CSS,并传递可选属性。

Bootstrap::css();
Bootstrap::css('local', ['type' => 'text/css']);

JS

js方法通过CDN/本地文件包含Bootstrap JS,并传递可选属性。

Bootstrap::js();
Bootstrap::js('local', ['type' => 'text/javascript']);

垂直

vertical方法允许表单以垂直方式设置。这是默认的表单类型。垂直方法可以在添加任何表单元素之前进行链接,并将继续用于后续的表单元素,直到被覆盖。

Bootstrap::vertical();
Bootstrap::vertical()->text('text', 'Text', 'Value');

水平

水平方法允许将表单以水平方式设置。此表单类型接受输入类和标签类。可以在添加任何表单元素之前链式调用水平方法,并将在后续表单元素中继续,直到被覆盖。

Bootstrap::horizontal('col-sm-10', 'col-sm-2');
Bootstrap::horizontal('col-sm-10', 'col-sm-2')->text('text', 'Text', 'Value');

内联

行内方法允许将表单以行内方式设置。此表单类型仅接受标签类。可以在添加任何表单元素之前链式调用行内方法,并将在后续表单元素中继续,直到被覆盖。

Bootstrap::inline('sr-only');
Bootstrap::inline('sr-only')->text('text', 'Text', 'Value');

文本

文本方法从错误和选项生成一个可选标签的文本字段。

Bootstrap::text('text', 'Text', 'Value', $errors);

密码

密码方法从错误和选项生成一个可选标签的密码字段。

Bootstrap::password('password', 'Password');

电子邮件

电子邮件方法从错误和选项生成一个可选标签的电子邮件字段。

Bootstrap::email('email', 'Email address', 'Value');

电话

电话方法从错误和选项生成一个可选标签的tel字段。

Bootstrap::telephone('telephone', 'Telephone Number', 'Value', $errors, array('pattern' => '^(?:(?:\(?(?:0(?:0|11)\)?[\s-]?\(?|\+)44\)?[\s-]?(?:\(?0\)?[\s-]?)?)|(?:\(?0))(?:(?:\d{5}\)?[\s-]?\d{4,5})|(?:\d{4}\)?[\s-]?(?:\d{5}|\d{3}[\s-]?\d{3}))|(?:\d{3}\)?[\s-]?\d{3}[\s-]?\d{3,4})|(?:\d{2}\)?[\s-]?\d{4}[\s-]?\d{4}))(?:[\s-]?(?:x|ext\.?|\#)\d{3,4})?$'));

数字

数字方法从错误和选项生成一个可选标签的数字字段。

Bootstrap::number('number', 'Number', 'Value', $errors, array('min' => 1, 'max' => 10, 'step' => 2));

URL

网址方法从错误和选项生成一个可选标签的url字段。

Bootstrap::url('url', 'URL', 'Value', $errors, array('pattern' => '^(http[s]?:\\/\\/(www\\.)?|ftp:\\/\\/(www\\.)?|www\\.){1}([0-9A-Za-z-\\.@:%_\+~#=]+)+((\\.[a-zA-Z]{2,3})+)(/(.)*)?(\\?(.)*)?'));

范围

范围方法从错误和选项生成一个可选标签的数字字段。

Bootstrap::range('range', 'Range', 'Value', $errors, array('min' => 1, 'max' => 10, 'step' => 2));

搜索

搜索方法从错误和选项生成一个可选标签的搜索字段和图标。

Bootstrap::number('search', 'Search', 'Value');

文件

文件方法从错误和选项生成一个可选标签的文件字段。

Bootstrap::file('file', 'File');

日期

日期方法从错误、输入选项和JavaScript参数生成一个带日期选择器的日期字段,可选标签。

Bootstrap::date('date', 'Date');
Bootstrap::date('date', 'Date', date('d-m-Y'), $errors, [], ['format' => 'DD-MM-YYYY']);

日期时间

日期时间方法从错误、输入选项和JavaScript参数生成一个带日期时间选择器的日期字段,可选标签。

Bootstrap::datetime('datetime', 'Date');
Bootstrap::datetime('datetime', 'Date', date('d-m-Y H:i:s'));

时间

时间方法从错误、输入选项和JavaScript参数生成一个带时间选择器的日期字段,可选标签。

Bootstrap::time('time', 'Time');
Bootstrap::time('time', 'Time', date('H:i:s'));

文本区域

文本区域方法从错误和选项生成一个可选标签的文本区域字段。

Bootstrap::textarea('file', 'File', 'Value');

选择

选择方法从错误和选项生成一个带有项目和支持可选标签的select字段,选中的项。

Bootstrap::select('select', 'Select', ['1' => 'Item 1', '2' => 'Item 2'], 2);

复选框

复选框方法从值和支持可选标签的复选框字段生成,选中和选项。

Bootstrap::checkbox('checkbox', 'Checkbox', 1, true);

单选按钮

单选按钮方法从值和支持可选标签的单选按钮字段生成,选中和选项。

Bootstrap::checkbox('radio', 'Radio', 1);

提交

提交方法生成一个带有值和可选属性的提交按钮。

Bootstrap::submit('Submit');

按钮

按钮方法生成一个带有值和可选属性的按钮。

Bootstrap::button('Button');

重置

重置方法生成一个带有值和可选属性的重置按钮。

Bootstrap::reset('Reset');

链接

链接方法生成一个带有url、标题和可选属性以及安全链接的链接按钮。

Bootstrap::link('/', 'Link');

安全链接

secureLink方法生成一个带有url、标题和可选属性以及安全链接的安全链接按钮。

Bootstrap::secureLink('/', 'Link');

路由链接

linkRoute方法生成一个带有路由、标题和可选参数、属性的链接按钮。

Bootstrap::linkRoute('home', 'Home');

操作链接

linkAction方法生成一个带有操作、标题和可选参数、属性的链接按钮。

Bootstrap::linkAction('index', 'Home');

邮件链接

mailto方法生成一个带有电子邮件地址、标题和可选属性的mailto链接按钮。

Bootstrap::mailto('test@test.com', 'Email');

无提示警报

none方法生成一个带有内容、可选强调、可选可关闭和可选属性的none警告。

Bootstrap::none('A message', null, true);

成功警报

success方法生成一个带有内容、可选强调、可选可关闭和可选属性的成功警告。

Bootstrap::success('A success message', 'Well done!', true);

信息警报

info方法生成一个带有内容、可选强调、可选可关闭和可选属性的信息警告。

Bootstrap::info('An info message', 'Heads up!', true);

警告警报

warning方法生成一个带有内容、可选强调、可选可关闭和可选属性的警告警告。

Bootstrap::warning('A warning message', 'Warning!', true);

危险警报

《danger》方法生成一个包含内容且可选具有强调效果的危险警告,可选可关闭,并可选具有属性。

Bootstrap::danger('A danger message', 'Oh snap!', true);

许可证

Bootstrapper是一个开源软件,受MIT许可证许可。