Flutter 117: 图解 Dismissible 滑动清除 Widget

    和尚在尝试在项目中实现类似于 iOS 邮箱邮件左右滑动删除对应邮件时,参考到 Flutter 提供的 Dismissible,虽与理想的有差别,但还是值得研究一下。

Dismissible

源码分析

const Dismissible({
    @required Key key,
    @required this.child,
    this.background,            // 滑动背景展示 Widget
    this.secondaryBackground,   // 与background相反滑动背景展示 Widget
    this.confirmDismiss,        // 是否确定清除当前 Widget
    this.onResize,              // 重新修改尺寸回调
    this.onDismissed,           // 确定清除回调
    this.direction = DismissDirection.horizontal,   // 滑动关闭方向
    this.resizeDuration = const Duration(milliseconds: 300),       // 修改尺寸时长
    this.dismissThresholds = const <DismissDirection, double>{},  // 各方向滑动清除阀值
    this.movementDuration = const Duration(milliseconds: 200),    // 清除过程时长
    this.crossAxisEndOffset = 0.0,
    this.dragStartBehavior = DragStartBehavior.start,
})

    分析源码可得,其中 key 是必须参数,key 作为 Widget 的唯一标识,对应滑动删除的组件,在列表中不建议直接用索引作为 key 的唯一标识,因为关闭窗口小部件可能会更改其他窗口小部件的索引;

案例源码

_listWid() => ListView.builder(itemCount: 20, itemBuilder: (context, index) => _disItem(index));

_listItem(index) {
  return Column(children: <Widget>[
    Container( height: 55.0,
        margin: EdgeInsets.symmetric(horizontal: 20),
        child: Row(children: <Widget>[
          Expanded(child: Text('当前 item = ${(index + 1)}', style: TextStyle(fontSize: 16.0))),
          Padding(child: Icon(Icons.lock_open, size: 14.0), padding: EdgeInsets.only(left: 10.0))
        ])),
    Container(height: 0.5, color: Colors.grey)
  ]);
}

_disItem(index) => Dismissible(key: UniqueKey(), child: _listItem(index));

1. background

    background 为堆叠在 Dismissible 设置的 child 元素后的 Widget,在滑动过程中展示的背景 Widget;对于未设置 secondaryBackground 时,各个方向的滑动展示的背景均为 background

_backgroundWid() {
  return Container( color: Colors.red,
      child: Align( alignment: Alignment.centerRight,
          child: Padding( padding: EdgeInsets.symmetric(horizontal: 20.0),
              child: Column( mainAxisAlignment: MainAxisAlignment.center, mainAxisSize: MainAxisSize.min,
                  children: <Widget>[
                    Icon(Icons.delete_forever, color: Colors.white, size: 18.0),
                    SizedBox(height: 5.0),
                    Text('Delete', style: TextStyle(color: Colors.white))
                  ]))));
}

2. secondaryBackground

    secondaryBackgroundbackground 类似,仅支持在向上滑动或从右向左滑动方向上展示的背景 Widget

_secondBackgroundWid() {
    return Container( color: Colors.green,
      child: Align( alignment: Alignment.centerLeft,
          child: Padding( padding: EdgeInsets.symmetric(horizontal: 20.0),
              child: Column( mainAxisAlignment: MainAxisAlignment.center, mainAxisSize: MainAxisSize.min,
                  children: <Widget>[
                    Icon(Icons.edit, color: Colors.white, size: 18.0),
                    SizedBox(height: 5.0),
                    Text('Edit', style: TextStyle(color: Colors.white))
                  ]))));
}

3. direction

    direction 为限制滑动关闭方向,在 onDismissed / confirmDismiss 中也可以进行判断;

  • DismissDirection.vertical 竖直方向,包括 up / down 两种
  • DismissDirection.horizontal 水平方向,包括 endToStart / startToEnd 两种
  • DismissDirection.endToStart 结束到开始方向(与语言设置的 rtlltr 相关),汉英等日常方向一般是从右至左
  • DismissDirection.startToEnd 开始到结束方向(与语言设置的 rtlltr 相关),汉英等日常方向一般是从左至右
  • DismissDirection.up 由下向上
  • DismissDirection.down 由上向下
return Padding(padding: EdgeInsets.symmetric(vertical: 10.0, horizontal: 20.0),
    child: Dismissible(
      key: Key('${_direction.toString()}'),
      child: Container(height: 100.0,
          child: Center(child: Text('${_direction.toString()}', style: TextStyle(color: Colors.white, fontSize: 16.0))),
          decoration: BoxDecoration(color: _color, shape: BoxShape.rectangle, borderRadius: BorderRadius.circular(20.0))),
      direction: _direction,
      background: Container(decoration: BoxDecoration(color: Colors.grey, shape: BoxShape.rectangle, borderRadius: BorderRadius.circular(20.0))),
    ));

4. confirmDismiss & onDismissed & onResize

    confirmDismiss 返回的是 Future<bool> 类型的数据,用于判断是否清除当前 Widget,返回 true 时清除此 Widget,否则将其移回到其原始位置;当返回 false / null 时,均不会进入 onDismissed / onResize 回调;其中 onDismissed 为确认清除当前 Widget 的回调,onResize 为当前 Widget 改变尺寸时的回调;在 confirmDismiss / onDismissed 中可以根据 direction 滑动方向进行单独判断;

_itemDialog(context, _direction) {
  bool _value = false;
  return showDialog<bool>(context: context,
      builder: (context) {
        return AlertDialog(
          title: Row(children: <Widget>[
            Icon(Icons.settings), SizedBox(width: 8),
            Text(_direction == DismissDirection.endToStart ? 'Delete' : 'Edit')
          ]),
          content: Icon(_direction == DismissDirection.endToStart ? Icons.delete_forever : Icons.edit, color: _direction == DismissDirection.endToStart ? Colors.red : Colors.green),
          actions: <Widget>[
            FlatButton(child: const Text('No'),
                onPressed: () { Navigator.pop(context, true); _value = false; }),
            FlatButton(child: const Text('Yes'),
                onPressed: () { Navigator.pop(context, true); _value = true; })
          ]); }).then((val) {
    val = _value; return val;
  });
}

5. dismissThresholds

    dismissThresholds 可根据各方向设置不同的阀值,对应的是一个 Map 集合;范围在(0.0, 1.0) 之间,设置的阀值越大,代表滑动范围越大才可以触发 onDismissed 回调;

dismissThresholds: {
  DismissDirection.startToEnd: 0.8,
  DismissDirection.endToStart: 0.3
},

6. crossAxisEndOffset

    crossAxisEndOffset 用于定义当前清除 Widget 在滑动过程中,沿主轴方向最后的偏移量,根据定义的值来确定最后位置;

crossAxisEndOffset: -5.0,

    Dismissible 案例源码


    和尚对于 Dismissible 的研究还不够深入,如有错误,请多多指导!

来源: 阿策小和尚

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 218,755评论 6 507
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 93,305评论 3 395
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 165,138评论 0 355
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,791评论 1 295
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,794评论 6 392
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,631评论 1 305
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,362评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,264评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,724评论 1 315
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,900评论 3 336
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 40,040评论 1 350
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,742评论 5 346
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,364评论 3 330
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,944评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 33,060评论 1 270
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 48,247评论 3 371
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,979评论 2 355

推荐阅读更多精彩内容