cornford / bootstrapper
一种简单的方法将Twitter Bootstrap集成到Laravel中。
Requires
- php: >=5.4.0
- illuminate/http: 5.*
- illuminate/support: 5.*
- laravelcollective/html: 5.*
Requires (Dev)
- mockery/mockery: ~0.9.1
- phpspec/phpspec: 2.0.*@dev
README
对于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
- JS
- 垂直
- 水平
- 内联
- 文本
- 密码
- 电话
- 数字
- URL
- 范围
- 搜索
- 文件
- 日期
- 日期时间
- 时间
- 文本区域
- 选择
- 复选框
- 单选按钮
- 提交
- 按钮
- 重置
- 链接
- 安全链接
- 路由链接
- 操作链接
- 邮件链接
- 无提示警报
- 成功警报
- 信息警报
- 警告警报
- 危险警报
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许可证许可。