slide_item 1.0.7

Flutter Android iOS web

The Flutter ListView's Item sliding component. You don’t need to change the existing code, you only need to wrap the original Widget with two widgets provided by this package

简介 #

english documentation is here,translate by google translate

Flutter列表Item侧滑菜单组件, flutter_slidable_list_view github,pub的优化重构版 部分实现借鉴了Provider

每个Item的菜单Action数量、Widget可以自由定制,相比于之前的flutter_slidable_list_view,不再与ListView绑定,同时优化了性能,之前滑动一个整个列表所有元素重建,现在仅会重建极小的一部分,目前刷新范围已经控制到最小,后续如有优化空间会继续优化

example

使用 #

在原有ListView的基础上,外层使用SlideConfiguration包裹侧滑菜单的相关配置信息,然后将 原有item使用SlideItem进行包裹即可,使用方法请参考示例程序的代码,涉及到的类的参数含义将在下面解释

因为用到了InheritedWidget,本package开发环境使用的是flutter -v1.12版本,已使用最新的dependOnInheritedWidgetOfExactType等方法获取 InheritedWidget,若老版本需要使用可使用带有后缀-adapt的版本

参数含义 #

SlideConfiguration
参数含义类型
child子WidgetWidget
configSlideConfig类型的配置BeanSlideConfig
controller控制列表元素滑动状态SlideController
SlideConfig
参数含义类型默认值
supportElasticity是否支持弹性滑动(即滑动打开菜单时是否可以超过设定值然后反弹)BoolTrue
closeOpenedItemOnTouch已经打开的Item在触摸其左侧的内容区域的时候是否直接关闭菜单Boolfal
slideProportion每个菜单Item的宽度所占的比例(相对于整个ListItem的宽度)double0.25
elasticityProportion弹性滑动的额外可越界值double0.1
actionOpenCloseThreshold打开/关闭 菜单所需要的最低的侧滑比例double0.5
backgroundColorItem的背景颜色(因为使用Stack实现的菜单Item,所以如果列表元素透明会导致重叠),不可为Colors.transparentColorColors.white
slideOpenAnimDuration打开侧边菜单的动画持续时间,这里的时间时从0到完全打开的总时间,实际手指抬起后的动画时间会根据已运动比例来获取实际所需时间Duration200ms
slideCloseAnimDuration关闭侧边菜单动画的持续时间(规则同上)Duration200ms
deleteStep1AnimDuration删除动画第一阶段(删除按钮Widget大小扩展为整个列表Item大小)持续时间Duration200ms
deleteStep2AnimDuration删除动画第二阶段(Item的高度变化)持续时间Duration200ms
slideWidth每个菜单Item的宽度(此参数不为空时会以此参数为准)doublenull
SlideItem
参数含义类型默认值
indexInList当前Item在列表中的位置intnull
actions菜单Item的元素列表List[]
childchildWidgetnull
slidable是否可以滑动booltrue
leftActions从左向右滑动的菜单ItemList[]
SlideAction
参数含义类型默认值
isDeleteButton是否是删除按钮,用于标记删除Widget执行动画boolfalse
actionWidget侧边菜单的Item的WidgetWidgetnull
tapCallbackAction被点击时的回调,会提供Slide对象可用于执行关闭、删除等操作的动画ActionTapCallaackNull
Slide
方法/成员含义参数返回值
close关闭侧滑菜单🈚️void
delete执行删除动画可选参数,useAnim,默认值true,Future,返回动画执行的future
indexInListitem在列表中的位置int
2
likes
95
pub points
61%
popularity

The Flutter ListView's Item sliding component. You don’t need to change the existing code, you only need to wrap the original Widget with two widgets provided by this package

Repository (GitHub)
View/report issues

Documentation

API reference

Uploader

tsx1453@gmail.com

License

MIT (LICENSE)

Dependencies

flutter

More

Packages that depend on slide_item