react-native树形结构选择组件

Posted 2022-09-06 suwu150

react-native-tree-select

react-native-tree-select,树结构选择组件,通过层级展示数据,能够进行多选和单选,进行自定义节点样式等.

---

=

项目结构

--components： treeSelect组件
--treeSelectExample： 组件演示代码
--.gitignore：git忽略文件
--README.md：说明文档

1.使用说明:

1.基本用法

首先能够通过如下命令进行安装

npm i react-native-tree-select

然后通过下面命令进行导入：

import TreeSelect from 'react-native-tree-select';

如下代码是简单的使用

import TreeSelect from 'react-native-tree-select';

   ...
  render() 
    return (
        <TreeSelect
            data=treeselectData
            // isOpen
            // openIds=['A01']
            defaultSelectedId=['B062']
            isShowTreeId=false
            // selectType="single"
            selectType="multiple"
            itemStyle=
              // backgroudColor: '#8bb0ee',
              fontSize: 12,
              color: '#995962'
            
            selectedItemStyle=
              backgroudColor: '#f7edca',
              fontSize: 16,
              color: '#171e99'
            
            onClick=this._onClick
            onClickLeaf=this._onClickLeaf
            treeNodeStyle=
              // openIcon: <Icon size=18 color="#171e99" style= marginRight: 10  name="ios-arrow-down" />,
              // closeIcon: <Icon size=18 color="#171e99" style= marginRight: 10  name="ios-arrow-forward" />
              openIcon: <Image
                resizeMode="stretch"
                style= width: 18, height: 18 
                source=require('./images/down-circle.png') />,
              closeIcon: <Image
                resizeMode="stretch"
                style= width: 18, height: 18 
                source=require('./images/right-circle.png') />
            
          />
    );
  

注意：数据结构如下面形式：

[
  
    "id":"A",
    "name":"农、林、牧、渔业",
    "sortNo":"A",
    "parentId":"0",
    "children": [
      
        "id":"A01",
        "name":"农业",
        "sortNo":"A01",
        "parentId":"A",
        "children": [
          
            "id":"A011",
            "name":"谷物种植",
            "sortNo":"A011",
            "parentId":"A01"
          ,
          
            "id":"A012",
            "name":"豆类、油料和薯类种植",
            "sortNo":"A012",
            "parentId":"A01"
          ,
          
            "id":"A013",
            "name":"棉、麻、糖、烟草种植",
            "sortNo":"A013",
            "parentId":"A01"
          ,
          
            "id":"A014",
            "name":"蔬菜、食用菌及园艺作物种植",
            "sortNo":"A014",
            "parentId":"A01"
          ,
          
            "id":"A015",
            "name":"水果种植",
            "sortNo":"A015",
            "parentId":"A01"
          ,
          
            "id":"A016",
            "name":"坚果、含油果、香料和饮料作物种植",
            "sortNo":"A016",
            "parentId":"A01"
          ,
          
            "id":"A017",
            "name":"中药材种植",
            "sortNo":"A017",
            "parentId":"A01"
          
        ]
      
    ]
  ,
  
    "id":"B",
    "name":"采矿业",
    "sortNo":"B",
    "parentId":"0",
    "children": [
      
        "id":"B06",
        "name":"煤炭开采和洗选业",
        "sortNo":"B06",
        "parentId":"B",
        "children": [
          
            "id":"B061",
            "name":"烟煤和无烟煤开采洗选",
            "sortNo":"B061",
            "parentId":"B06"
          ,
          
            "id":"B062",
            "name":"褐煤开采洗选",
            "sortNo":"B062",
            "parentId":"B06"
          ,
          
            "id":"B069",
            "name":"其他煤炭采选",
            "sortNo":"B069",
            "parentId":"B06"
          
        ]
      
    ]
  
]

2.传递的Props:

Props	Explain	type	require	default
data	数据，树结构数据	array	yes	[]	-
onClick	点击时的事件，返回点击的节点和节点路径 item, routes, currentNode	function	no	no	currentNode为当前选中的节点
onClickLeaf	点击叶子节点时的事件，返回点击的节点和节点路径 item, routes, currentNode	function	no	no	currentNode为当前选中的节点
isOpen	是否默认打开所有的节点,优先级高于openIds，当true时忽略openIds	boolean	no	false	-
openIds	指定默认打开的节点id	array	no	[]	-
defaultSelectedId	指定默认选中的节点id	array	no	[]	-
selectType	指定选择的类型	string	no	‘single’,可传递single/multiple	-
leafCanBeSelected	指定只能够选择叶子节点	boolean	false	-	-
isShowTreeId	指定是否显示节点id	boolean	no	false	-
itemStyle	指定item项的样式,其中包含三个子项backgroudColor：背景的颜色, fontSize：字体大小, color：字体的颜色	css style	no		-
selectedItemStyle	指定点击按钮选中时的样式,其中包含三个子项backgroudColor：选中时的颜色, fontSize：选中时的字体大小, color：选中时字体的颜色	css style	no		-
treeNodeStyle	指定节点处的图标样式，包含两个属性openIcon，closeIcon,支持传icon和image类型	object	no	null	-

3.本地运行

在本地运行，首先得克隆该项目，使用下面命令进行克隆，克隆地址
先克隆该项目

git clone https://github.com/suwu150/react-native-tree-select.git

然后进入项目，cd treeSelectExample进入到演示项目，通过以下命令安装依赖

npm install

通过以下命令运行项目

react-native run-ios

4.组件简介

能够按照数据结构进行展开树状结构，通常用来进行展示具有明显层级关系的数据结构,展示的同时,能够进行指定默认值展开和默认选中值,能够进行单选和多选操作,进行通过传递props禁止选择等功能.