flutter_custom_dropdown
创建命令
flutter create --org com.example --template=plugin --platforms=android,ios -a java -i objc flutter_custom_dropdown
本组件由Github作者best-flutter插件flutter_dropdown_menu更改而来,由于更新问题,以及使用上不满足业务问题自己修改了相关bug做了更新迭代,所以重新集成为新插件
DefaultDropdownMenuController
功能：包裹页面提供默认Controller
| 功能参数 | 是否必要 | 类型 | 备注 |
|---|---|---|---|
| onSelected | true | bool | 选中时，触发controller.selected时会回调此方法 |
| child | true | widget | 包裹内容 |
DropdownHeader
功能：下拉头部模块
| 功能参数 | 是否必要 | 类型 | 备注 |
|---|---|---|---|
| isSideline | false | bool | 是否需要分割线 |
| onTap | false | func | 触发头部回调,内部自动提供,自定义头部事件需自定义 |
| titles | true | List | 头部显示title列表 |
| selectIsChangingColor | false | bool | 选中是否更改回显title字段可specialModules联合使用 |
| specialModules | false | List | 选中是否只改变title颜色不更改title文字,此功能selectIsChangingColor必须为true,权重大于selectIsChangingColor功能 |
DropdownMenu
功能：悬停筛选模块
| 功能参数 | 是否必要 | 类型 | 备注 |
|---|---|---|---|
| menus | true | List | list长度必须与titles长度一致 |
| packUpHeight | false | double | 收起长度不够时可自行添加 |
| hideDuration | false | Duration | 收起时自定义时长 |
| showDuration | false | Duration | 展开时自定义时长 |
| showCurve | false | Curve | 自定义动画 |
| hideCurve | false | Curve | 自定义动画 |
| blur | false | double | 蒙层透明值 |
| onHide | false | VoidCallback | 蒙层触发操作回调 |
| switchStyle | false | DropdownMenuShowHideSwitchStyle | 菜单样式 |
| maxMenuHeight | false | double | 最大高度,未提供自动计算时,需要指定最大高度 |
DropdownMenuBuilder
功能：menus内容
| 功能参数 | 是否必要 | 类型 | 备注 |
|---|---|---|---|
| builder | true | WidgetBuilder | 下拉内容 |
| screenHeight | false | double | 最大高度,默认屏幕高度,自动计算时必须填写 |
| draughtHeight | true | double | 内容高度, |
| bottomSpacingHeight | false | double | 距离屏幕底部高度,自动计算时必须填写 |
单选图片功能详解
| 功能 | 实现功能 | 内容 |
|---|---|---|
| 交易类型 | 单选选中,不提供title变色,不提供title更改 | 条件:剔除元数据title字段 |
| 范围 | 单选选中,提供title变色,不提供title更改 | 条件:添加元数据title字段,将header下标放入specialModules,开启selectIsChangingColor |
| 排序 | 单选选中,提供title变色,提供title更改 | 条件:添加元数据title字段,禁止将header下标放入specialModules,开启selectIsChangingColor |
DropdownListMenu
多功能tempalte,单选+多选+自定义按钮+自定义输入
| 功能参数 | 是否必要 | 类型 | 备注 |
|---|---|---|---|
| selectedIndex | false | Object | 默认选中 |
| isOperatingButton | false | bool | 是否需要按钮 |
| isCustomInput | false | bool | 是否需要自定义输入 |
| customInput | false | CustomInputClass | 定义自定义输入回显值的key与输入框HintText |
| keyWords | true | String | 数据是否重复判断依据 |
| valueKey | false | String | 当元数据没有title字段时,显示内容的key需要传入|也可以自定义itemBuilder内容 |
| isMultiple | false | bool | 是否多选 |
| data | true | List | 元数据内容 |
| itemBuilder | true | MenuItemBuilder | 展示item布局,可自定义 |
| 功能实现 | 实现功能 | 内容 |
|---|---|---|
| 交易金额 | 多选+自定义输入+自定义按钮 | 看图 |
| 范围 | 多选 | 看图 |
| 排序 | 多选+自定义按钮 | 看图 |
DropdownMenuCustomize
功能：自定义下拉内容
| 功能参数 | 是否必要 | 类型 | 备注 |
|---|---|---|---|
| data | false | List | 传入内容 |
| itemBuilder | true | BlankMenuItemBuilder | 内容整个布局 |
额外使用功能:
DropdownMenuController controller; 控制显示关闭,可以配合WillPopScope返回时监听是否关闭并进行关闭之后再进行页面退出 onWillPop: () async{ if(controller == null || controller.event == DropdownEvent.HIDE){ Navigator.pop(context); } controller.hide(); return; } GlobalKey _globalKey;获取context,必须有变化的组件下,绝对布局或者滚动,需要获取绝对布局的context ScrollController scrollController;控制动画的controller.assignment({'title': '更多---'}, menuIndex);///自定义内容时没有用到select传输数据可以由次方法重新更改title
贴段代码吧
/// TODO : 单选实例
/// @param
/// @return
/// @author 丁平
/// created at 2021/1/12 11:06
///
class MotionlessScreeningFilter extends StatefulWidget {
@override
_MotionlessScreeningFilterState createState() => _MotionlessScreeningFilterState();
}
class _MotionlessScreeningFilterState extends State<MotionlessScreeningFilter> {
String value1;
String value2;
String value3;
@override
Widget build(BuildContext context) {
return Container(
child:DefaultDropdownMenuController(
onSelected: ({int menuIndex, dynamic data}) {
print("int menuIndex, dynamic data = $menuIndex,$data");
if(menuIndex == 0){
value1 = '选中下标$menuIndex,\n选中内容$data';
}
if(menuIndex == 1){
value2 = '选中下标$menuIndex,\n选中内容$data';
}
if(menuIndex == 2){
value3 = '选中下标$menuIndex,\n选中内容$data';
}
setState(() {});
},
child: Stack(
children: [
Column(
children: [
Container(
color: Colors.white,
child: buildDropdownHeader()
),
Expanded(
child: Center(
child: Column(
mainAxisAlignment: MainAxisAlignment.center,
children: [
Text('交易类型选中 : ${value1??''}'),
const SizedBox(height: 10.0,),
Text('范围选中 : ${value2??''}'),
const SizedBox(height: 10.0,),
Text('排序选中 : ${value3??''}'),
],
),
)
),
Container(
alignment: Alignment.centerLeft,
color:const Color(0XFF00CCA9),
child: Text(
'交易类型筛选：单选,不提供选中头部回显,在元数据中剔除title字段即可 \n\n范围筛选：单选，不提供选中头部回显，但是提供选中头部颜色更改，使用specialModules属性标注，\n\n排序类型筛选：单选，提供选中内容头部回显不剔除title字段，设置selectIsChangingColor属性',
style: TextStyle(
color: Colors.white
),
),
)
],
),
Padding(
padding: const EdgeInsets.only(top: 40),
child: buildDropdownMenu(context))
],
),
)
);
}
DropdownHeader buildDropdownHeader({DropdownMenuHeadTapCallback onTap}) {
return DropdownHeader(
isSideline : false,
onTap: onTap,
titles: ['交易类型','范围','排序'],
selectIsChangingColor: true,
specialModules: [1] ,///特殊模块,选中数据只亮起,不需要更改头部title,下标为1
);
}
DropdownMenu buildDropdownMenu(BuildContext context) {
return new DropdownMenu(
menus: [
DropdownMenuBuilder(
builder : (BuildContext context) {
return DropdownListMenu(
selectedIndex: FilterData.housingTypes[0],
isOperatingButton : false,
keyWords : "key",
data: FilterData.housingTypes,
valueKey: 'value',
itemBuilder: buildCheckItem,
);
},
screenHeight : MediaQuery.of(context).size.height,
draughtHeight : 60 * 2.5,
bottomSpacingHeight : 168.0
),
DropdownMenuBuilder(
builder : (BuildContext context) {
return DropdownListMenu(
selectedIndex: FilterData.ranges[0],
isOperatingButton : false,
keyWords : "key",
data: FilterData.ranges,
itemBuilder: buildCheckItem,
);
},
screenHeight : MediaQuery.of(context).size.height,
draughtHeight : 60 * 2.5,
bottomSpacingHeight : 168.0
),
DropdownMenuBuilder(
builder : (BuildContext context) {
return DropdownListMenu(
selectedIndex: FilterData.sort[0],
isOperatingButton : false,
keyWords : "key",
data: FilterData.sort,
itemBuilder: buildCheckItem,
);
},
screenHeight : MediaQuery.of(context).size.height,
draughtHeight : 60 * 6.66,
bottomSpacingHeight : 168.0 + 50.0
),
]
);
}
}
flutter_custom_dropdown
创建命令
flutter create --org com.example --template=plugin --platforms=android,ios -a java -i objc flutter_custom_dropdown
本组件由Github作者best-flutter插件flutter_dropdown_menu更改而来,由于更新问题,以及使用上不满足业务问题自己修改了相关bug做了更新迭代,所以重新集成为新插件
DefaultDropdownMenuController
功能：包裹页面提供默认Controller
| 功能参数 | 是否必要 | 类型 | 备注 |
|---|---|---|---|
| onSelected | true | bool | 选中时，触发controller.selected时会回调此方法 |
| child | true | widget | 包裹内容 |
DropdownHeader
功能：下拉头部模块
| 功能参数 | 是否必要 | 类型 | 备注 |
|---|---|---|---|
| isSideline | false | bool | 是否需要分割线 |
| onTap | false | func | 触发头部回调,内部自动提供,自定义头部事件需自定义 |
| titles | true | List | 头部显示title列表 |
| selectIsChangingColor | false | bool | 选中是否更改回显title字段可specialModules联合使用 |
| specialModules | false | List | 选中是否只改变title颜色不更改title文字,此功能selectIsChangingColor必须为true,权重大于selectIsChangingColor功能 |
DropdownMenu
功能：悬停筛选模块
| 功能参数 | 是否必要 | 类型 | 备注 |
|---|---|---|---|
| menus | true | List | list长度必须与titles长度一致 |
| packUpHeight | false | double | 收起长度不够时可自行添加 |
| hideDuration | false | Duration | 收起时自定义时长 |
| showDuration | false | Duration | 展开时自定义时长 |
| showCurve | false | Curve | 自定义动画 |
| hideCurve | false | Curve | 自定义动画 |
| blur | false | double | 蒙层透明值 |
| onHide | false | VoidCallback | 蒙层触发操作回调 |
| switchStyle | false | DropdownMenuShowHideSwitchStyle | 菜单样式 |
| maxMenuHeight | false | double | 最大高度,未提供自动计算时,需要指定最大高度 |
DropdownMenuBuilder
功能：menus内容
| 功能参数 | 是否必要 | 类型 | 备注 |
|---|---|---|---|
| builder | true | WidgetBuilder | 下拉内容 |
| screenHeight | false | double | 最大高度,默认屏幕高度,自动计算时必须填写 |
| draughtHeight | true | double | 内容高度, |
| bottomSpacingHeight | false | double | 距离屏幕底部高度,自动计算时必须填写 |
单选图片功能详解
| 功能 | 实现功能 | 内容 |
|---|---|---|
| 交易类型 | 单选选中,不提供title变色,不提供title更改 | 条件:剔除元数据title字段 |
| 范围 | 单选选中,提供title变色,不提供title更改 | 条件:添加元数据title字段,将header下标放入specialModules,开启selectIsChangingColor |
| 排序 | 单选选中,提供title变色,提供title更改 | 条件:添加元数据title字段,禁止将header下标放入specialModules,开启selectIsChangingColor |
DropdownListMenu
多功能tempalte,单选+多选+自定义按钮+自定义输入
| 功能参数 | 是否必要 | 类型 | 备注 |
|---|---|---|---|
| selectedIndex | false | Object | 默认选中 |
| isOperatingButton | false | bool | 是否需要按钮 |
| isCustomInput | false | bool | 是否需要自定义输入 |
| customInput | false | CustomInputClass | 定义自定义输入回显值的key与输入框HintText |
| keyWords | true | String | 数据是否重复判断依据 |
| valueKey | false | String | 当元数据没有title字段时,显示内容的key需要传入|也可以自定义itemBuilder内容 |
| isMultiple | false | bool | 是否多选 |
| data | true | List | 元数据内容 |
| itemBuilder | true | MenuItemBuilder | 展示item布局,可自定义 |
| 功能实现 | 实现功能 | 内容 |
|---|---|---|
| 交易金额 | 多选+自定义输入+自定义按钮 | 看图 |
| 范围 | 多选 | 看图 |
| 排序 | 多选+自定义按钮 | 看图 |
DropdownMenuCustomize
功能：自定义下拉内容
| 功能参数 | 是否必要 | 类型 | 备注 |
|---|---|---|---|
| data | false | List | 传入内容 |
| itemBuilder | true | BlankMenuItemBuilder | 内容整个布局 |
额外使用功能:
DropdownMenuController controller; 控制显示关闭,可以配合WillPopScope返回时监听是否关闭并进行关闭之后再进行页面退出 onWillPop: () async{ if(controller == null || controller.event == DropdownEvent.HIDE){ Navigator.pop(context); } controller.hide(); return; } GlobalKey _globalKey;获取context,必须有变化的组件下,绝对布局或者滚动,需要获取绝对布局的context ScrollController scrollController;控制动画的controller.assignment({'title': '更多---'}, menuIndex);///自定义内容时没有用到select传输数据可以由次方法重新更改title
贴段代码吧
import 'package:flutter/cupertino.dart';
import 'package:flutter/material.dart';
import 'package:flutter_cunstimize_dropdown/flutter_cunstomize_dropdown.dart';
import 'package:flutter_cunstimize_dropdown_example/config/filter_data.dart';
/// TODO : 单选实例
/// @param
/// @return
/// @author 丁平
/// created at 2021/1/12 11:06
///
class MotionlessScreeningFilter extends StatefulWidget {
@override
_MotionlessScreeningFilterState createState() => _MotionlessScreeningFilterState();
}
class _MotionlessScreeningFilterState extends State<MotionlessScreeningFilter> {
String value1;
String value2;
String value3;
@override
Widget build(BuildContext context) {
return Container(
child:DefaultDropdownMenuController(
onSelected: ({int menuIndex, dynamic data}) {
print("int menuIndex, dynamic data = $menuIndex,$data");
if(menuIndex == 0){
value1 = '选中下标$menuIndex,\n选中内容$data';
}
if(menuIndex == 1){
value2 = '选中下标$menuIndex,\n选中内容$data';
}
if(menuIndex == 2){
value3 = '选中下标$menuIndex,\n选中内容$data';
}
setState(() {});
},
child: Stack(
children: [
Column(
children: [
Container(
color: Colors.white,
child: buildDropdownHeader()
),
Expanded(
child: Center(
child: Column(
mainAxisAlignment: MainAxisAlignment.center,
children: [
Text('交易类型选中 : ${value1??''}'),
const SizedBox(height: 10.0,),
Text('范围选中 : ${value2??''}'),
const SizedBox(height: 10.0,),
Text('排序选中 : ${value3??''}'),
],
),
)
),
Container(
alignment: Alignment.centerLeft,
color:const Color(0XFF00CCA9),
child: Text(
'交易类型筛选：单选,不提供选中头部回显,在元数据中剔除title字段即可 \n\n范围筛选：单选，不提供选中头部回显，但是提供选中头部颜色更改，使用specialModules属性标注，\n\n排序类型筛选：单选，提供选中内容头部回显不剔除title字段，设置selectIsChangingColor属性',
style: TextStyle(
color: Colors.white
),
),
)
],
),
Padding(
padding: const EdgeInsets.only(top: 40),
child: buildDropdownMenu(context))
],
),
)
);
}
DropdownHeader buildDropdownHeader({DropdownMenuHeadTapCallback onTap}) {
return DropdownHeader(
isSideline : false,
onTap: onTap,
titles: ['交易类型','范围','排序'],
selectIsChangingColor: true,
specialModules: [1] ,///特殊模块,选中数据只亮起,不需要更改头部title,下标为1
);
}
DropdownMenu buildDropdownMenu(BuildContext context) {
return new DropdownMenu(
menus: [
DropdownMenuBuilder(
builder : (BuildContext context) {
return DropdownListMenu(
selectedIndex: FilterData.housingTypes[0],
isOperatingButton : false,
keyWords : "key",
data: FilterData.housingTypes,
valueKey: 'value',
itemBuilder: buildCheckItem,
);
},
screenHeight : MediaQuery.of(context).size.height,
draughtHeight : 60 * 2.5,
bottomSpacingHeight : 168.0
),
DropdownMenuBuilder(
builder : (BuildContext context) {
return DropdownListMenu(
selectedIndex: FilterData.ranges[0],
isOperatingButton : false,
keyWords : "key",
data: FilterData.ranges,
itemBuilder: buildCheckItem,
);
},
screenHeight : MediaQuery.of(context).size.height,
draughtHeight : 60 * 2.5,
bottomSpacingHeight : 168.0
),
DropdownMenuBuilder(
builder : (BuildContext context) {
return DropdownListMenu(
selectedIndex: FilterData.sort[0],
isOperatingButton : false,
keyWords : "key",
data: FilterData.sort,
itemBuilder: buildCheckItem,
);
},
screenHeight : MediaQuery.of(context).size.height,
draughtHeight : 60 * 6.66,
bottomSpacingHeight : 168.0 + 50.0
),
]
);
}
}