小菜繼續補充日常學習中遇到的很實用的技術點;
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 預設展示一行的圖示,預期是在大部分裝置上展示 4個 item,隨著螢幕的變大盡可能多的展示 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),
複製程式碼
注意事項
- ReorderableListView 沒有類似於 ListView.builder 等構造方法,需要把 List 中所有 item 一次性載入完;
- ReorderableListView 中所有 children item 最外層必須要有唯一的 Key;
- 小菜測試過程中,當拖拽到最後一個時,因為先 remove 掉這個 item 再 insert 新增 item 時,此時 dataList 數量已經減少,newIndex 需要減一處理;
LayoutBuilder 案例嘗試 + ReorderableListView 案例嘗試
小菜還會繼續對日常應用的小知識點進行學習和嘗試;對於底層的研究還不夠深入,如有錯誤,請多多指導!
來源: 阿策小和尚