大家有没有写资源(如商品等)列表页面的时候呢?
大家是怎么生成资源列表的筛选器链接的?
在项目中我发现无论是通过path还是param带入筛选/排序条件,好像都需要手动的为每个筛选条件的a标签写上uri。
如果筛选条件很少还好,但是一旦筛选条件变多,或则筛选需求会有变动,那么也是很郁闷的事情。
于是我想一劳永逸的解决上述问题,于是就有了自己写个筛选条件管理器的想法,FilterManger,它可以非常优雅灵活的生成筛选器url。
筛选条件 (参数) 管理器 for Laravel 5
筛选参数管理器包主要用于页面资料列表,可以让我们优雅灵活的生成筛选链接。
这个页面就使用了该包:kiteme.cn/list
安装
{
"require": {
// ...
"toplan/filter-manager": "dev-master",
}
}
打开姿势
请先通过第一步(准备工作)完成服务提供器的注册。
1. 准备工作
请在 config/app.php 文件中找到名为 providers 的key ,然后为FilterManager的服务提供器。
'providers' => array(
// ...
'Toplan\FilterManager\FilterManagerServiceProvider',
)
然后请在 config/app.php 文件中找到名为 aliases 的key , 然后为FilterManger添加别名。
'aliases' => array(
// ...
'FilterManager' => 'Toplan\FilterManager\Facades\FilterManager',
)
2. Then, just enjoy it!
更多的详细用法参见: demo_temp_for_laravel.blade.php
常用方法
基本上所有常用用法都在该文件中: demo_temp_for_laravel.blade.php
1. 获得FilterManager对象
create($filters,$baseUrl,$blackList);
$filters: 参数数组,例:['gender'=>'male','city'=>'beijing']
$baseUrl: 可以根据自己情况进行设置, 如果设置了完整的服务器名和路径,则返回的是url
$blackList: 筛选条件/参数黑名单, 例:['pageindex'].
2. 设置筛选条件黑名单
可以在每次生成uri/url的时候过滤掉你不想要的筛选条件/参数(比如分页参数等)
FilterManager::setBlackList(['page','pageindex']);
3. 是否有指定筛选条件
如果有指定条件,会返回该过滤添加的值,否则返回false
FilterManager::has('gender');
4. 指定的筛选条件是否包含指点值
isActive($filter_name, $filter_value, $trueReturn, $falseReturn)
FilterManager::isActive('gender','male');#将会返回true 或 false;
FilterManager::isActive('gender','male','active','not active');#将会返回 'active' 或 'not active';
5. 生成 uri/url
url($filter_name,$filter_value,$multi,$LinkageRemoveFilters,$blackList)
参数介绍:
$filter_name: 筛选条件/参数
$filter_value: 筛选条件/参数的值, 默认值为:\Toplan\FilterManager\FilterManager::ALL , 表示为所有
$multi: 是否支持多个参数值? true 为支持, 默认为false
$LinkageRemoveFilters: 需要联动删除的筛选条件/参数
$blackList: 临时黑名单,可以临时覆盖默认的黑名单。
FilterManager::url('gender',\Toplan\FilterManager\FilterManager::ALL);//将会删除gender参数
FilterManager::url('gender','male',false);//gender只能有一个值
FilterManager::url('cities','成都',true);#
FilterManager::url('cities','绵阳',true);#支持cities有多个值
//一个省有多个城市,如果要取消选中‘省’这个条件,那么我们还可以通过第四个参数设置联动取消‘市’以及更多你想取消的筛选条件。
FilterManager::url('province','四川',false,['cities']);//联动删除cities条件