【Flutter 專題】98 易忽略的【小而巧】的技術點彙總 (六)

阿策小和尚發表於2021-07-11

      小菜繼續補充日常學習中遇到的很實用的技術點;

LayoutBuilder

      小菜在一些場景下需要根據父類佈局大小不同展示不同的子類 Widget,例如小菜在適配大尺寸平板或橫豎屏切換等場景時,此時需要用到 LayoutBuilder 小菜理解為尺寸佈局構造器;

原始碼分析

      簡單分析原始碼可得,LayoutBuilder 是一個繼承自 ConstrainedLayoutBuilder 的構造器;通過 builder 獲取一個 BoxConstraints 物件,之後通過檢查 constraints 來確定要展示的內容;

class LayoutBuilder extends ConstrainedLayoutBuilder<BoxConstraints> {
  const LayoutBuilder({
    Key key,
    LayoutWidgetBuilder builder,
  }) : super(key: key, builder: builder);
}
複製程式碼

案例嘗試

      小菜通過 GridView 預設展示一行的圖示,預期是在大部分裝置上展示 4item,隨著螢幕的變大盡可能多的展示 item,當螢幕允許展示所有 item 時為上限;於是小菜設定了單個 item 寬基礎為 90,根據 size.maxWidth 進行判斷;

LayoutBuilder(builder: (context, size) {
  if (size.maxWidth ~/ 90 >= 4 &&
      size.maxWidth ~/ 90 <= _dataList.length) {
    _length = size.maxWidth ~/ 90;
  } else if (size.maxWidth ~/ 90 > _dataList.length) {
    _length = _dataList.length;
  } else {
    _length = 4;
  }
  return _gridWid();
}  

_gridWid() {
  return GridView.builder(
      physics: ScrollPhysics(),
      primary: false, shrinkWrap: true,
      gridDelegate: SliverGridDelegateWithFixedCrossAxisCount(
          crossAxisCount: _length, mainAxisSpacing: 8.0,
          crossAxisSpacing: 8.0, childAspectRatio: 1),
      itemCount: _showMore ? _dataList.length : _length,
      itemBuilder: (context, index) {
        var dataItem = _dataList[index];
        if (index < _length - 1 || _showMore) {
          dataItem = _dataList[index];
        } else {
          dataItem = _dataList[_dataList.length - 1];
        }
        return GestureDetector(
            child: Container( color: Colors.white70,
                child: Column(mainAxisAlignment: MainAxisAlignment.center,
                    children: <Widget>[
                      Icon(dataItem.icon),
                      SizedBox(height: 4),
                      Text(dataItem.text)
                    ])),
            onTap: () {
              if (_length < _dataList.length && dataItem.text == '更多') {
                _showMore = !_showMore; setState(() {});
              }
              Toast.show(dataItem.text == '更多' ? '更多' : _dataList[index].text, context, duration: Toast.LENGTH_SHORT, gravity: Toast.BOTTOM);
            });
      });
}
複製程式碼

ReorderableListView

      小菜剛嘗試了 Draggable + DragTarget 實現的基本的拖拽 GridView,今天嘗試一下系統提供的 ReorderableListView 拖拽列表;

原始碼分析

      簡單分析原始碼可得 ReorderableListView 主要實現 children 子類 item 載入與 onReorder 拖拽子 item 到新的位置時回撥;

ReorderableListView({
  Key key,
  this.header,              // 列表頭部標題
  @required this.children,  // 列表子類 item
  @required this.onReorder, // 拖拽到新位置時回撥
  this.scrollDirection = Axis.vertical, // 滑動方向,水平或豎直
  this.padding,             // 內邊距,僅用於 children
  this.reverse = false,     // 是否反轉
})
複製程式碼

案例嘗試

1. onReorder

      onReorder 是當 item 拖拽到新的位置時 ReorderCallback 回撥,其中回撥中返回新舊兩個陣列下標用於標記;

@override
Widget build(BuildContext context) {
  return Scaffold(
      appBar: AppBar(title: Text('ReorderableListView Page')),
      body: ReorderableListView(
          header: Container(height: 200.0,
              child: ACEWave(waveWidth, waveHeight, 200.0,
                  startOffsetXList: startOffsetX, startOffsetYList: startOffsetY,
                  durationList: duration, waveColorList: colorList)),
          reverse: false,
          children: _listWid(),
          onReorder: (oldIndex, newIndex) {
            if (newIndex == _dataList.length) --newIndex;
            final temp = _dataList.removeAt(oldIndex);
            _dataList.insert(newIndex, temp);
            setState(() {});
          }));
}

_listData(index) {
  return Padding(
      key: ValueKey(_dataList[index]),
      padding: EdgeInsets.all(20.0),
      child: Row(children: <Widget>[
        Icon(_dataList[index].icon, color: Colors.black38),
        SizedBox(width: 10.0),
        Expanded(child: Text(_dataList[index].text)),
        Icon(Icons.arrow_right, color: Colors.black38)
      ]));
}

_listWid() => <Widget>[for (int i = 0; i < _dataList.length; i++) _listData(i)];
複製程式碼

2. scrollDirection

      scrollDirection 為列表滑動方向,與普通 ListView 一致,分為 Axis.horizontal 橫行和 Axis.vertical 縱向兩種;

scrollDirection: Axis.horizontal,
複製程式碼

3. header

      header 為當前列表標題頭部;

_headerWid(horizontal) {
  return horizontal
      ? Container()
      : Container(height: 200.0,
          child: ACEWave(waveWidth, waveHeight, 200.0,
              startOffsetXList: startOffsetX,
              startOffsetYList: startOffsetY,
              durationList: duration,
              waveColorList: colorList));
}
複製程式碼

4. reverse

      reverse 為是否反轉,即初始時是否是從最後開始;

reverse: true,
複製程式碼

5. padding

      padding 為內邊距,但僅針對列表 children 部分,對於頭部 header 並不起效果;

padding: EdgeInsets.all(40.0),
複製程式碼

注意事項

  1. ReorderableListView 沒有類似於 ListView.builder 等構造方法,需要把 List 中所有 item 一次性載入完;
  2. ReorderableListView 中所有 children item 最外層必須要有唯一的 Key
  3. 小菜測試過程中,當拖拽到最後一個時,因為先 remove 掉這個 iteminsert 新增 item 時,此時 dataList 數量已經減少,newIndex 需要減一處理;

      LayoutBuilder 案例嘗試 + ReorderableListView 案例嘗試


      小菜還會繼續對日常應用的小知識點進行學習和嘗試;對於底層的研究還不夠深入,如有錯誤,請多多指導!

來源: 阿策小和尚

相關文章