這篇文章跟大家分享一個UniApp實戰,動手實作一個複雜場景的表格元件(UniApp),希望對大家有幫助!
是一個成熟的程式猿了,要懂得自己造輪子(uniApp的插件市場找了一遍都沒發現符合需求的插件,沒有辦法了,只能自己動手造輪子)。本文旨在複盤 記錄。
使用場景: uniApp 、 行動裝置(相容小程式、App、H5)
#依需求整理下特定功能:
#表格名稱
可配置背景
字體樣式可修改(大小、顏色)
選單按鈕(需要對外暴露事件)
#表頭
支援多層表頭
表頭固定
表頭行支援自訂名稱
#表格
支援設定單元格寬度
#固定首列
#支援樹形資料
內容支援圖片、連結
參數比較多,怎樣更優雅的管理,減少上手難度? -> 設定檔config.js並在其中設定預設值,起到欄位說明
技術實作困難由於使用環境限制:
uniApp實現的表格相關元件比較簡單,對於非H5環境限制比較大(例如無法設定
rowspan
colspan),使用起來也顯得比較麻煩,達不到專案的需求,最後決定自己造個輪子。
表頭部分主要困難在於
多層表頭的處理,怎麼樣做到根據資料來驅動顯示。剛開始是打算按
html table的方式實現,開發過程中遇到的問題比較多,首先資料處理比較麻煩,要計算有多少行、每行單元格的
colspan、
rowspan
td, tr等元件,需要自己額外實作。
columns的資料是樹狀的,如下
columns = [ { "title": "区域", "dataIndex": "区域" }, { "title": "广州一区", "children": [ { "title": "销售", "dataIndex": "广州一区销售"}, { "title": "计划销售", "dataIndex": "广州一区计划销售" }, { "title": "达成", "dataIndex": "广州一区达成"} ] }, // ... ]
flex
佈局就能實現了
每個格子設定垂直居中,如果存在children
則遍歷
遞歸渲染
,由於需要遞歸呼叫渲染,把遞歸的部分在分出來一個元件:titleColumn
。先貼個程式碼(程式碼已發佈到社區,有興趣可以去看看
傳送門):
titleColumn.vue
#這裡有個坑:
在正常的
vue
uniApp
#則需要。// titleColumn.vue import titleColumn from "./title-column.vue"
#表格內容
這裡先要處理下
columns
// 根据Column 获取body中实际渲染的列 fmtColumns(list) { // 保存叶子节点 this.dataIndexs = [] if (!list || !list.length) return // 获取实际行 this.columnsDeal(list) }, // columnsDeal(list, level = 0) { list.forEach(item => { let { children, ...res } = item if (children && children.length) { this.columnsDeal(children, level + 1) } else { this.dataIndexs.push({ ...res }) } }) },
接下来就是处理列表数据中的树形结构了。
先看看数据结构tableData
:
tableData = [ { "key": 1, "区域": "广州", "销售": 100, "计划销售": 200, "达成": "50.0%", "达成排名": 1, "GroupIndex": 1, "GroupLayer": 1, "GroupKey": "广州", "children": [{ "key": 11, "区域": "广州一区", "小区": "广州一区", "销售": 60, "计划销售": 120, "达成": "50.0%", "达成排名": 1, children: [{ "key": 111, "区域": "广州一区1", "小区": "广州一区1", "销售": 60, "计划销售": 120, "达成": "50.0%", "达成排名": 1, }] }, { "key": 12, "区域": "广州二区", "小区": "广州二区", "销售": 40, "计划销售": 80, "达成": "50.0%", "达成排名": 1 }, ], }, ]
树形的结构,key
是唯一值。
有想过使用递归组件的方式实现,但是考虑到会涉及到展开、收起的操作。也是比较麻烦。
最终的方案是把数据扁平化处理,为每条数据添加 层级、是否子数据、父级ID 等属性。并通过一个数组变量来记录展开的行,并以此控制子数据的显示与否。处理后的数据存放在dataList
中
扁平化处理函数:
// 递归处理数据,tree => Array listFmt(list, level, parentIds = []) { return list.reduce((ls, item) => { let { children, ...res } = item // 错误提示 if (res[this.idKey] === undefined || !res[this.idKey] === null) { // console.error(`tableData 数据中存在 [idKey] 属性不存在数据,请检查`) } let nowItem = { ...res, level, hasChildren: children && children.length, parentIds, children, [this.idKey]: res[this.idKey] && res[this.idKey].toString() } ls.push(nowItem) if (children && children.length) { this.isTree = true ls = ls.concat(this.listFmt(children, level + 1, [...parentIds, nowItem[this.idKey]])) } return ls }, []) },
最终得到的数据如下:
数据处理完可以渲染了,
需要嵌套两层遍历:
第一层 遍历dataList
得到行
第二层 遍历dataIndexs
得到列
最终完成渲染:
固定首列,固定表头
使用css
属性:position: sticky
实现。粘性定位元素(stickily positioned element)。大家都是成熟的前端程序猿啦~~,就不具体介绍了。说说一些需要注意的细节:
兼容性
uniapp中小程序模式、App模式是支持的!!!
限制
设置了position:sticky
之后必现指定top left right bottom
其中任一,才会生效。不设置的话表现和相对定位相同。top
和bottom
或者left
和right
同时设置的情况下,top
、left
的优先级高。
设定为position:sticky
元素的任意父节点的overflow
属性必须是visible
,否则 不会生效 (都不能滚动还能咋办)。
造个轮子不难,造个好用的轮子不易。
涉及一些布局上和css部分的东西在文章中不好表达,不细说了,有兴趣的可以拉代码看看。传送门
开发过程中也遇到过不少的问题,都是一路修修补补过来,前期没有构思好会导致后面的开发磕磕碰碰(刚开始模块、参数没有划分好,整个东西逻辑都比较乱,后面停下来从新思考调整了,有种豁然开朗的痛快)
搬砖去了~
原文地址:https://juejin.cn/post/7083401121486045198
作者:沐夕花开
推荐:《uniapp教程》
以上是UniApp實戰之開發一個複雜場景的表格組件的詳細內容。更多資訊請關注PHP中文網其他相關文章!