likes
comments
collection
share

【Taro】小程序picker动态获取数据

作者站长头像
站长
· 阅读数 25

在小程序中,picker选择器提供了几种基础的数据格式,如时间,日期,地区等,已经基本满足绝大多数需求了。

但面对脑洞打开的客户和产品经理,官方也留给了我们个性化的空间,在picker属性中,将值设定为multiSelector,再传入一个长度不限二维数组数据,就实现了一个个性化的多项选择器。

数据量不大的时候,我们可以直接要求后端传一个长度为3或者更长的二维数组,塞入到range中。但大多联动选择器需求都是产品分类,自定义的地区数据等,此类的数据量都非常大,而且是越来越大,一次将数据全部请求过来,可能就不太合适了。

比如一个产品分类数据有一级分类,二级,还不是特别多,但里面还有三级,四级分类,这数据量就成集合增加,再加上携带的相关数据,可能一个接口就轻则100多kb,重则500+kb,这时候一级一级的获取就显得很有必要了。

一、先看逻辑

逻辑大概就是以下这样,黄色方块上为赋值,下为选择。

【Taro】小程序picker动态获取数据

一般进入页面时会有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的基本功能已经算完成了,可以进行展示了。

操作

能展示的话,用户可以点击操作了,功能也就完成一半了。当滚动每一列的时候,还需要继续获取数据,动态修改下一列的数据,这里就更简单的了。

【Taro】小程序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}
    ]);
  };

总结

功能比较简单,但第一次写的话有不少坑,半天才写好,又优化了半天,在这个小功能上花费了一天时间,后面其他项目有这种动态加载列表的需要,就可以用这一套方法了。