forked from AdamRobertHall/react-native-tree
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
65c666e
commit 3adba1d
Showing
9 changed files
with
280 additions
and
230 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,7 +1,9 @@ | ||
| import TreeSelect from './TreeSelect'; | ||
| const {treeData} = require('./treeData'); | ||
| export default class TestTreeSelect extends React.Component { | ||
| render () { | ||
| return <View style={{flex:1, flexDirection: 'row', alignItems: 'center', justifyContent: 'center'}}> | ||
| <Text style={{fontSize: 20}}>什么都没有</Text> | ||
| return <View style={{flex:1, marginTop: 80}}> | ||
| <TreeSelect treeData={treeData} checkable multiple/> | ||
| </View> | ||
| } | ||
| } |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,69 @@ | ||
| export const treeData = [ | ||
| { | ||
| key: 'food', | ||
| label: '食品', | ||
| children: [ | ||
| { | ||
| key: 'mainfood', | ||
| label: '主食', | ||
| children: [ | ||
| { | ||
| key: 'noodle', | ||
| label: '面', | ||
| }, | ||
| { | ||
| key: 'rice', | ||
| label: '米饭', | ||
| }, | ||
| { | ||
| key: 'chaocai', | ||
| label: '炒菜', | ||
| children: [ | ||
| { | ||
| key: 'chuan', | ||
| label: '川菜', | ||
| }, | ||
| { | ||
| key: 'xiang', | ||
| label: '湘菜', | ||
| }, | ||
| { | ||
| key: 'yue', | ||
| label: '粤菜', | ||
| } | ||
| ] | ||
| } | ||
| ] | ||
| }, | ||
| { | ||
| key: 'fruit', | ||
| label: '水果', | ||
| children: [ | ||
| { | ||
| key: 'apple', | ||
| label: '苹果', | ||
| }, | ||
| { | ||
| key: 'xigua', | ||
| label: '西瓜', | ||
| }, | ||
| { | ||
| key: 'putao', | ||
| label: '葡萄', | ||
| children: [ | ||
| { | ||
| key: 'hutai', | ||
| label: '沪太8号', | ||
| }, | ||
| { | ||
| disabled: true, | ||
| key: 'hutai9', | ||
| label: '沪太9号', | ||
| } | ||
| ] | ||
| } | ||
| ] | ||
| } | ||
| ] | ||
| } | ||
| ]; |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,128 +1,52 @@ | ||
| # React Native Router [](https://gitter.im/aksonov/react-native-router-flux?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) [](https://www.codacy.com/app/aksonov-github/react-native-router-flux) [](http://badge.fury.io/js/react-native-router-flux) [](https://circleci.com/gh/aksonov/react-native-router-flux) | ||
|
|
||
| [](https://nodei.co/npm/react-native-router-flux/) | ||
| Router for React Native based on new React Native Navigation API. | ||
|
|
||
| ## Documentation | ||
|
|
||
| - [Mini-Tutorial](docs/MINI_TUTORIAL.md) | ||
| - [API and Configuration](docs/API_CONFIGURATION.md) | ||
| - Available Imports | ||
| - Router API | ||
| - Scene API | ||
| - [Detailed Example](docs/DETAILED_EXAMPLE.md) | ||
| - [Reactive/Redux/Flux](docs/REDUX_FLUX.md) | ||
| - [Other Info](docs/OTHER_INFO.md) | ||
| - Modals | ||
| - Tabbar | ||
| - Custom navbar | ||
| - Switch | ||
| - Splitting Scenes | ||
| - Drawer (side-menu) | ||
| - Sub-Scenes | ||
| - [Changelog](docs/CHANGELOG.md) | ||
| - [Migrating from 2.x](docs/MIGRATION.md) | ||
|
|
||
| ## Features | ||
|
|
||
| `react-native-router-flux` is a routing package that allows you to: | ||
|
|
||
| - Define scene transitions in one central location | ||
| - Without having to pass navigator objects around, and allow you to | ||
| - Call transitions anywhere in your code with a simple syntax (e.g. `Actions.login({username, password})` or `Actions.profile({profile})` or even `Actions.profile(123)` - all params will be part of `this.props` for given Scene component). | ||
|
|
||
| ### New Features and Highlights | ||
|
|
||
| - **Highly Customizable Navigation Bar** - Show/hide the navbar depending on Scene or even the state of a Scene (e.g. Edit/Save navbar for edit mode). | ||
|
|
||
| - **Tab Bar Support** using [react-native-tabs](https://github.com/aksonov/react-native-tabs) (see Example app). | ||
|
|
||
| - **Nested Navigators** (e.g. Each tab can have its own navigator, nested in a root navigator). | ||
|
|
||
| - **Custom Scene Renderers** for action sheet, native TabBarIOS or anything else. See built-in `Modal` renderer (to display popups) for example. *Call for PRs!* let's build some custom renderers for ActionSheet, Drawer, etc. Let's make an awesome library! Currently, if you want to use Action Sheets you'll need to use a 3rd party module. | ||
|
|
||
| - **Dynamic Routing** allows you to choose which scene to render depending on application state (see the `Switch` renderer, useful for authentication). | ||
|
|
||
| - **Bring Your Own Reducer** for navigation state. | ||
|
|
||
| - **Reset History Stack** - The new [`reset`](docs/API_CONFIGURATION.md#scene)type for clearing the history stack and eliminating the navbar back button. | ||
|
|
||
| - **More Powerful State Control** - Support for having different states while on the same screen. For example, "View My Account" could allow in-place editing of fields and "Save", "Cancel" navigation bar buttons should appear. | ||
|
|
||
| ## Getting Started | ||
|
|
||
| Check out the [mini-tutorial](docs/MINI_TUTORIAL.md) for a quick walkthrough of the routing system. | ||
|
|
||
| ## Supported configurations | ||
|
|
||
| While ExperimentalNavigation API is not stable, RNRF uses separated fork of ExperimentalNavigation API to avoid dependency from React Native version. | ||
| So 3.30 version of RNRF doesn't depend from React Native version, but from that fork (now it is based on 0.26 API). | ||
| You could use this component with RN0.26+ | ||
|
|
||
| ## Installation | ||
| ``` | ||
| npm i react-native-router-flux --save | ||
| ``` | ||
|
|
||
| ## Usage | ||
| In your top-level `index.js`, define your scenes using the `Scene` component and pass it into the `Router` as children: | ||
| ```js | ||
| import {Scene, Router} from 'react-native-router-flux'; | ||
|
|
||
| class App extends React.Component { | ||
| render() { | ||
| return <Router> | ||
| <Scene key="root"> | ||
| <Scene key="login" component={Login} title="Login"/> | ||
| <Scene key="register" component={Register} title="Register"/> | ||
| <Scene key="home" component={Home}/> | ||
| </Scene> | ||
| </Router> | ||
| } | ||
| } | ||
| ``` | ||
| Alternatively, you could define all of your scenes during compile time and use it later within `Router`: | ||
| ```js | ||
| import {Actions, Scene, Router} from 'react-native-router-flux'; | ||
|
|
||
| const scenes = Actions.create( | ||
| <Scene key="root"> | ||
| <Scene key="login" component={Login} title="Login"/> | ||
| <Scene key="register" component={Register} title="Register"/> | ||
| <Scene key="home" component={Home}/> | ||
| </Scene> | ||
| ); | ||
|
|
||
| /* ... */ | ||
|
|
||
| class App extends React.Component { | ||
| render() { | ||
| return <Router scenes={scenes}/> | ||
| } | ||
| } | ||
| ``` | ||
|
|
||
| On any Scene, you can also call the following functions by first importing the `Actions` object: | ||
| ```js | ||
| import {Actions} from 'react-native-router-flux' | ||
| --- | ||
| category: Components | ||
| type: Data Display | ||
| title: Tree | ||
| subtitle: 树形控件 | ||
| --- | ||
|
|
||
| ## 何时使用 | ||
|
|
||
| 组织架构、分类、国家地区等等，都是树形结构。使用`树控件`可以完整展现其中的层级关系，并具有展开收起选择等交互功能。 | ||
|
|
||
| ## API | ||
|
|
||
| ### Tree props | ||
|
|
||
| | 参数 | 说明 | 类型 | 默认值 | | ||
| |-----------|------------------------------------------|------------|--------| | ||
| |treeData | 创建树的数据 | TreeNode[] | [] | | ||
| |multiple | 支持点选多个节点（节点本身） | boolean | false | | ||
| |checkable | 节点前添加 Checkbox 复选框 | boolean | false | | ||
| |defaultExpandAll | 默认展开所有树节点 | boolean | false | | ||
| |defaultExpandRoot | 默认树根节点 | boolean | false | | ||
| |defaultExpandedKeys | 默认展开指定的树节点 | string[] | [] | | ||
| |expandedKeys | （受控）展开指定的树节点 | string[] | [] | | ||
| |defaultSelectedKeys | 默认选中的树节点 | string[] | [] | | ||
| |selectedKeys | （受控）选中的树节点（注意：checkable为true时，父子节点有关联，如果传入父节点key，则子节点自动选中 | string[] | [] | | ||
| |checkStrictly | 父子节点选中状态不再关联 | boolean | false | | ||
| |onExpand | 展开/收起节点时触发 | function(expandedKeys, {expanded: bool, node}) | - | | ||
| |onSelect | 点击树节点触发 | function(selectedKeys, e:{selected: bool, selectedNodes, node}) | - | | ||
| |showLine | 是否展示连接线 | boolean | false | | ||
| |expandIconSize | 展开收起图标大小 | number | 11 | | ||
| |iconSize | 复选框和文本前自定义图标大小 | number | 15 | | ||
| |treeStyle | 组件最外层由ScrollView包裹，请传入该组件的style | StyleSheet | { padding: 10,height: ScreenHeight - 90} | | ||
|
|
||
| ### TreeNode props | ||
|
|
||
| | 参数 | 说明 | 类型 | 默认值 | | ||
| |-----------|------------------------------------------|------------|--------| | ||
| |disabled | 禁止选中 | boolean | false | | ||
| |label | 标题 | string\|ReactNode | '---' | | ||
| |key | 被树的 (default)ExpandedKeys / (default)CheckedKeys / (default)SelectedKeys 属性所用。注意：整个树范围内的所有节点的 key 值不能重复！ | string | 内部计算出的节点位置 | | ||
| |icon | 文本前自定义图标 | string | null | | ||
| |children | 树节点的子节点 | TreeNode[] | null | | ||
|
|
||
| ## 注意 | ||
|
|
||
| 树节点可以有很多，但在设置`checkable`时，将会花费更多的计算时间，因此我们缓存了一些计算结果（`this.treeNodesStates`）来复用，避免多次重复计算，以此提高性能。但这也带来了一些限制，当你异步加载树节点时，你需要这样渲染树： | ||
|
|
||
| ## 使用 | ||
| ```jsx | ||
| <Tree treeData={[]}/> | ||
| ``` | ||
| And then: | ||
|
|
||
| * `Actions.ACTION_NAME(PARAMS)` will call the appropriate action and params will be passed to the scene. | ||
| * `Actions.pop()` will pop the current screen. It accepts following optional params: | ||
| * `{popNum: [number]}` allows to pop multiple screens at once | ||
| * `{refresh: {...propsToSetOnPreviousScene}}` allows to refresh the props of the scene that it pops back to | ||
| * `Actions.refresh(PARAMS)` will update the properties of the current screen. | ||
|
|
||
| ## Production Apps using react-native-router-flux | ||
| + Buddify ([iOS](https://itunes.apple.com/app/id1149011372), [Android](https://play.google.com/store/apps/details?id=com.buddify)) - helps travelers discover fun things to do locally. | ||
| + GuavaPass.com ([iOS](https://itunes.apple.com/en/app/guavapass-one-pass-fitness/id1050491044?l=en&mt=8), Android) - offers convenient access to top classes at boutique fitness studios across Asia. | ||
| + Epic Fail Videos ([iOS](https://itunes.apple.com/us/app/epic-fail-videos-best-fail/id1115219339), [Android](https://play.google.com/store/apps/details?id=com.hazuu.epicfailvideos)) - The best Fail Videos Collection, never miss a laugh with your friends! | ||
| + Junk Free ([iOS](https://itunes.apple.com/us/app/junk-free-by-junk-free-june/id1109940159)) - A simple way to find, share, and save recipes, workouts, and other healthy content with your friends, family and workmates. | ||
| + chozun ([iOS](https://itunes.apple.com/au/app/chozun/id1097365167), [Android](https://play.google.com/store/apps/details?id=com.chozun)) - Your travel companion, matching your lifestyle on the go! | ||
| + Snappatizer ([iOS](https://itunes.apple.com/us/app/snappatizer-find-rank-best/id1147400405?mt=8)) - Find and rank the best food around you. | ||
| + Look Lock ([GitHub](https://github.com/7kfpun/PhotosReactNative), [iOS](https://itunes.apple.com/us/app/look-lock-show-photos-without/id1151863742), [Android](https://play.google.com/store/apps/details?id=com.kfpun.photos)) - Show photos without worries. | ||
| + BusDue, ([iOS](https://itunes.apple.com/gb/app/busdue/id1185327843?mt=8), [Android](https://play.google.com/store/apps/details?id=com.busdue)) - London bus arrival time app | ||
|
|
||
| ## Support | ||
| Thanks to all who submitted PRs to 2.x release. If you like the component and want to support it, feel free to donate any amount or help with issues. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.