在小程序中,picker选择器提供了几种基础的数据格式,如时间,日期,地区等,已经基本满足绝大多数需求了。
但面对脑洞打开的客户和产品经理,官方也留给了我们个性化的空间,在picker属性中,将值设定为multiSelector
,再传入一个长度不限二维数组数据,就实现了一个个性化的多项选择器。
数据量不大的时候,我们可以直接要求后端传一个长度为3或者更长的二维数组,塞入到range中。但大多联动选择器需求都是产品分类,自定义的地区数据等,此类的数据量都非常大,而且是越来越大,一次将数据全部请求过来,可能就不太合适了。
比如一个产品分类数据有一级分类,二级,还不是特别多,但里面还有三级,四级分类,这数据量就成集合增加,再加上携带的相关数据,可能一个接口就轻则100多kb,重则500+kb,这时候一级一级的获取就显得很有必要了。
一、先看逻辑
逻辑大概就是以下这样,黄色方块上为赋值,下为选择。
一般进入页面时会有2种状态,picker有值或空值,也就是新建表单的时候是空值,修改的时候是有值并需要回显。
展示
数据接口
getRangeData({parentCode:''}
: 传入code获得下级数据列表,不传返回顶级数据列表
- 不管怎么样,第一步都要通过后端提供的接口(
getRangeData({parentCode:''})
)获取第一列数据c1
。 - 如果是新建,直接通过
c1
的第一个值的code,即将c1[0].code
传入接口获取二级数据c2
,获取第三列数据也是同样操作。 - 如果是修改,这传进来一个这样的值,分别对应三列选中的值,将value的第一个值的code传入接口,即通过
selected[0].code
获取第二列数据,第三列也同样操作。
const selected = [
{name: 'xxx',code: 0},
{name: 'xxx',code: 01},
{name: 'xxx',code: 012}
]
- 获取的数据都为数组,将获取到的数据组合为一个二维数组并进行赋值,即
setRange([c1,c2,c3])
,这时候picker的基本功能已经算完成了,可以进行展示了。
操作
能展示的话,用户可以点击操作了,功能也就完成一半了。当滚动每一列的时候,还需要继续获取数据,动态修改下一列的数据,这里就更简单的了。
- 通过
onColumnChange
方法,获取当前滚动的列(column
)和滚动到的索引值(value
),则可以通过range[column][value].code
获取并修改下一列的值。 - 点击确定的时候,出发
onChange
方法,得到当前三列选中的索引值(value
),通过这个索引和range数据组合[range[0][value[0]],range[1][value[1]],range[2][value[2]]]
,就得到了选中的值。
逻辑整体上就这么多,最蛋疼的就是各种组合,比较弯弯绕。
二、上代码
view部分
当值为空的时候,展示请选择,有值的时候展示选中的值
<Picker
mode="multiSelector"
range={range}
rangeKey="name"
value={pickerValue.current}
onChange={e => onChange(e)}
onColumnChange={e => colChange(e)}
>
{selected ? (
<Text>{selected.map(i => i.name).join()}</Text>
) : (
<Text style={{ color: "#686868" }}>请选择</Text>
)}
</Picker>
js部分
在这里使用的是taro-react框架来实现这个方法,我用vue也同样实现了一次,代码结构基本上大差不差。
初始化数据
const pickerValue = useRef([0, 0, 0]); // 选择器的索引值
const [range, setRange] = useState<Array<any>>([]); // 选择器的值
const [selected, setSelected] = useState<Array<any>>([]); // 选中的值
useEffect(() => {
const init = async () => {
const p = await getRangeData({});
if (typeof params.selected === "undefined") {
// 当值为空的时候,通过分类第一个值获取下一列的值
const pp = await getRangeData({parentCode: p.data[0].code});
const ppp = await getRangeData({parentCode: pp.data[0].code});
setRange([p.data, pp.data, ppp.data]);
} else {
// 当有值的时候,通过选中的值获取下一列的值
const s = params.selected
const pp = await getRangeData({parentCode: s[0].code});
const ppp = await getAddrList({parentCode: c[1].code});
setRange([p.data, pp.data, ppp.data]);
setSelected(s);
}
};
init();
}, []);
列选择
这时候,picker的默认值就成功插进去了,下一步就是切换的时候再动态获取值
const colChange = e => {
const { column, value } = e.detail;
pickerValue.current[column] = value;
if (column === 0) { // 滑动列一
let c0 = range[0][value]; // 获取列一选中的值
const p = await getRangeData({ parentCode: c0.code });
setRange(v => [v[0], p.data, v[2]]);
} else if (column === 1) {
let c1 = range[1][value]; // 同上
const p = await getRangeData({ parentCode: c1.code });
setRange(v => [v[0], v[1], p.data]);
}
};
当pciker切换的时候,获取滚动的列和位置,再通过索引得到当前列选择的值获取下列值
这里有个点需要注意,我们的
range
数据是一个数组,属于引用类型,如果使用下面这种方法修改值
setRange(v => { v[1] = p.data return v });
可以成功修改,但无法触发页面刷新,即第二列的值不会变,必须使用深拷贝的方法来触发页面刷新
确认选择
点击确定的是,可以得到三列的索引值,并与现有range数据进行一一对应,就得到了3个选择的值,讲选中的值筛入selected中,即完成了所有功能
const onChange = e => {
let v = e.detail.value;
let s0 = range[0][v[0]];
let s1 = range[1][v[1]];
let s2 = range[2][v[2]];
setSelected([
{name: s0.name, code: s0.code}
{name: s1.name, code: s1.code}
{name: s2.name, code: s2.code}
]);
};
总结
功能比较简单,但第一次写的话有不少坑,半天才写好,又优化了半天,在这个小功能上花费了一天时间,后面其他项目有这种动态加载列表的需要,就可以用这一套方法了。