利用Axure中继器实现多选树组件

编辑导语:多选树组件也是我们常见的组件之一,那么,我们如何利用Axure中继器来实现多选树组件?本篇文章里,作者就如何利用Axure来实现多选树组件一事做了流程梳理,一起来看一下。

一、效果预览

超级产品经理

二、名词定义

1. 节点

  • 节点:每层内容被看作为一个节点;

  • 父节点:该级以上内容被视为该级内容的父节点;

  • 子节点:该级以下内容被视为该级内容的子节点;

  • 分支节点:有下级内容的节点;

  • 叶子节点:无下级内容的节点。

举例说明:

超级产品经理

以闽侯县为例,闽侯县为一个节点,福州市、福建省为闽侯县的父节点,上街镇、南屿镇为闽侯县的子节点。在该图中,福建省、福州市、闽侯县均为分支节点,上街镇、南屿镇均为叶子节点。

2. 多选树

具备2个功能:

  1. 展开/收起:可展开或收起其子节点(本文实现的是只能展开一级,且无记忆功能);

  2. 选择:通过复选框进行复选。

当选中某节点时,其子节点均被选中;反之均不被选中。

当某节点所在层级均被选中时,其上级自动选中;当某节点所在层级均不被选中时,其上级自动取消勾选;当某节点所在层级选中情况不等时,其上级呈待选中状态。

以上说明恐非标准说法,但为了读者便于理解本文可先代入,有错误也欢迎大家指正!

三、整体思路

以中继器包裹节点,通过更新中继器中的一些列来改变节点形态(如位置、展开/收起按钮展示、多选框状态),根据中继器中的列“id”可知道其父节点、子节点有哪些。

  1. 展开/收起实现:点击时获取节点id,通过判断id能够获取其子节点有哪些,通过更新行操作展示或收起其所有子节点。

  2. 选择实现:中继器中记录节点的子节点总数和选中的子节点数量。点击时获取节点id,通过判断id能够获取其父节点、子节点有哪些。当该节点选中时,其子节点均被选中;其父节点选中的子节点数量增加,当父节点的子节点总数和选中的子节点数量相同时,父节点即被选中。当该节点取消选中时,其子节点均取消选中;其父节点选中的子节点数量减少,当父节点选中的子节点数量为0时,父节点即取消选中。

四、基础元件

超级产品经理

1. 主体元件

  1. 文本标签“层级名称”:用于展示你要展示的内容。

  2. 图标“triangle”:一个箭头造型的iconfont(也可以是个图片),作为展开/收起的状态展示。

  3. 复选框:一个动态面板,有“未勾选”、“部分选中”、“已勾选”3种状态。当该节点的子节点均选中时,复选框状态为“已勾选”;当该节点的子节点部分选中时,复选框状态为“部分选中”;当该节点的子节点均未被选中时,复选框状态为“未勾选”。叶子节点则没有“部分选中”的状态。

  4. 动态面板“主体”:用于包裹上述元件,便于触发triangle的交互。

  5. 中继器:用于包裹动态面板“主体”。

2. 辅助元件

二级按钮、三级按钮、四级按钮、五级按钮均为辅助按钮(最终隐藏起来即可),点击某层级的复选框时会触发对应层级的辅助元件,这是为了让交互看起来更加清晰。

五、具体实现

1. 中继器初始化工作

1)中继器字段定义

  • id:节点编号。1级节点2位、2级节点4位…n级节点2n位。从01开始编号,前2*(n-1)位为上级节点编号,如上图闽侯县的编号为010101,其下级节点上街镇、南屿镇的编号分别为01010101、01010102。

  • grade:节点层级。1级节点为1,2级节点为2…n级节点为n。

  • children:节点的叶子节点总数。如上图闽侯县、福州市、福建省的children均为2(上街镇、南屿镇)。

节点的children为其下级节点的children之和。

  • content:节点内容。

  • visible:节点是否可见。1为可见,0为不可见。

  • triangle:箭头是否可见。1为可见,0为不可见。

  • point:箭头方向。1为展开(向下),0为收起(向右)。

  • select:节点是否被选中。2为其子节点选中,1为其子节点部分被选中,0为未被选中。

  • childrenSelect:节点的叶子节点中被选中的数量。

2)中继器交互

① 每项加载时,设置“层级名称”为中继器的列“content”。

超级产品经理

根据“grade”的值判断“主体”的位置(此处仅5级,读者可自行拓展)。

超级产品经理

根据“triangle”的值判断是否展示箭头。

超级产品经理

根据“point”的值判断箭头方向。

超级产品经理

根据“select”的值判断选中状态。

超级产品经理

每个判断类型的第一个条件为if,这是因为每个判断类型都需被执行。

2)载入时,将“visible”为1的行添加筛选。

超级产品经理

2. 展开收起

1)思路:点击箭头时判断箭头方向,方向在展开、收起间切换,若要展开就将其子节点的visible设为1,反之设为0。

  • 子节点如何界定:当前行子节点的id是在当前行id的基础上继续编号的,故获取当前行的id位数即可得知其他节点id的前几位需要和该行id相同,即TargetItem.id.substr(0,grade*2)==id。

  • 上述界定方式同样适用于当前行本身,所以还需剔除当前行,即TargetItem.grade!=grade。

  • 要遍历所有行必须用TargetItem而非Item。

2)具体实现:单击箭头时:

① 获取该行的id、grade分别存于全局变量id、grade(本文所有全局变量的设置均是为了便于调试)。

② 判断该行的point的值:

  • 若为1:更新当前行的point=0,更新当前行子节点[[TargetItem.id.substr(0,grade*2)==id && TargetItem.grade!=grade]]的visible==0

  • 若为0:更新当前行的point=1,更新当前行下一级的visible==1(若想要其子节点全部展开即和为1时的规则一样即可)

超级产品经理

3)设置动态面板“主体”单击时触发箭头的单击交互。

超级产品经理

3. 向下全选

1)思路:点击复选框时判断选中状态,若需要取消勾选则将当前行和其子节点的select设为2,反之设为0。

2)具体实现:单击复选框时:

① 获取该行的id、grade分别存于全局变量id、grade。

② 判断面板状态:

  • 若非已勾选(即需要取消勾选):更新当前行及其子节点[[TargetItem.id.substr(0,grade*2)==id]]的select==2、childrenSelect==TargetItem.children(向上选中时使用)

  • 若为已勾选(即需要勾选):更新当前行及其子节点[[TargetItem.id.substr(0,grade*2)==id]]的select==0、childrenSelect==0(向上选中时使用)

超级产品经理

4. 向上选中

1)思路

点击复选框时判断选中状态,若需要选中则将其父节点的“childrenSelect”的值加上多出来的叶子节点数量(当前行“children”的值-当前行“childrenSelect”的值),反之将其父节点的“childrenSelect”的值减去当前行“children”的值。

每次执行完以上时判断“childrenSelect”的值,若与其“children”相等,就说明这个节点的子节点都被选中了;若=0,就说明这个节点的子节点均未被选中;否则即其子节点部分被选中。

① 为了提高易读性,把除设置变量以外的交互都写在了辅助元件中。

② 由于叶子节点的children==0且无子节点,故点击叶子节点的复选框时,其父节点“childrenSelect”的值直接加/减1即可。

③ 父节点如何界定:当前行的id是在其父节点id的基础上继续编号的,故获取检索行的id位数即可得知当前行id的前几位需要和检索行id相同,即TargetItem.id==id.substr(0,grade*2)。

由于暂未找到Axure自动轮询的方法,故须对每级节点单独写交互。

若当前行为3级节点,仅1级节点、2级节点均为其父节点,即TargetItem.id==id.substr(0,2) || TargetItem.id==id.substr(0,4)。

若当前行为4级节点,仅1级节点、2级节点、3级节点均为其父节点,即TargetItem.id==id.substr(0,2) || TargetItem.id==id.substr(0,4) || TargetItem.id==id.substr(0,6)…

2)具体实现

① 单击复选框时获取该行的select、children、childrenSelect分别存于全局变量select、children、childrenSelect,触发4个辅助元件的单击事件。

超级产品经理

② 二级按钮交互

若为分支节点,且非选中状态(即需要勾选。判断条件:select!=2 并且 grade==2 并且 children!=0):

更新当前行父节点[[TargetItem.id==id.substr(0,2)]]的select==1、childrenSelect==TargetItem.childrenSelect+children-childrenSelect;

更新“children==childrenSelect”的非叶子节点所在行[[TargetItem.children==TargetItem.childrenSelect && TargetItem.children!=0]]的select==2。

超级产品经理

若为叶子节点,且非选中状态(即需要勾选)。区别仅在于判断条件的children==0,更新当前行父节点的childrenSelect==TargetItem.childrenSelect+1。

实际上,叶子节点的select只有0、2两种状态。

超级产品经理

若为分支节点,且为选中状态,即需要取消勾选。

判断条件:select==2 并且 grade==2 并且 children!=0):

更新当前行父节点[[TargetItem.id==id.substr(0,2)]]的select==1、childrenSelect==TargetItem.childrenSelect-children。

更新“childrenSelect==0”的非叶子节点所在行[[TargetItem.children!=0 && TargetItem.childrenSelect==0]]的select==0。

超级产品经理

若为叶子节点,且为选中状态(即需要取消勾选)。区别仅在于判断条件的children==0,更新当前行父节点的childrenSelect==TargetItem.childrenSelect-1

超级产品经理

③ 三级按钮交互:与二级按钮交互的区别在于单击时的判断条件上(grade==3)和当前行父节点的判断条件上,三级按钮的当前行父节点为[[TargetItem.xuhao==id.substr(0,2) || TargetItem.xuhao==id.substr(0,4)]]

其他级按钮以此类推。

六、写在后面的话

1. 不足之处/可优化的点

由于该设计为工具类,应尽量减少使用者的使用成本。中继器中可不填写grade,grade可通过id位数来确定。

仅支持5层的树,若想要更高层级需读者自行写交互(但在理解的基础上复制修改即可,在箭头的交互上已经实现了无层级差异的)。

每层仅支持99个节点,若需更多节点要修改id编号及交互。

还未实现选择后的回填效果,如“送货地区”栏选择了多个省、市后点击确认把选择的省、市回填到输入框中。

2. 遇到的坑

辅助元件的单击交互中,一开始是直接判断复选框的状态变化,但永远获取到的状态都是“!=选中”(即使区分为“==未选中”或“==部分选中”也都是“!=选中”),故改成了判断全局变量“select”的值。

复选框的交互中,一开始想通过以下方式实现遍历,但无法触发状态变化时的交互,故改成了在单击时的交互中做处理(如此更麻烦的,且无法实现无层级差异的处理)。

  • 中继器中不是记录叶子节点的数量,而是记录直接下级的总数(这样既好计算,后期也好维护)。

  • 单击时设置一些全局变量并修改当前行“select”的值,状态变化时根据状态修改当前行直接上级的已选中直接下级数量,当已选中直接下级数量==直接下级总数时,勾选当前行。

3. 鸣谢

本人在设计过程中部分思路参考了《Axure教程:Axure中继器实现动态树结构控件详解》(作者:Pershing)、《Axure教程:可增删改的树型结构》(作者:梓贤vigo),感谢大佬们!

欢迎大家指正问题或提议!万分感谢!

作者 @Air

版权声明

本文来自互联网用户投稿,文章观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处。如若内容有涉嫌抄袭侵权/违法违规/事实不符,请点击 举报 进行投诉反馈!

立即
投稿

微信公众账号

微信扫一扫加关注

返回
顶部