react-native-drag-sort

react-native-drag-sort

Drag and drop sort control for react-native

Language

• English
• 中文

Download Android example

Update Progress

2020.1 Added auto swipe function

If you do not need the auto-sliding function to use or are not satisfied with the Android effect, you can temporarily use DragSortableView (stable, reliable, long-term no-issus bug), if you want to use auto-sliding please use AutoDragSortableView。

The auto slide function is complete. iOS implements smooth auto-sliding. Android implements sliding an Item at a fixed time. After Android calls scrollTo, the refresh is relatively slow, causing jitter, so using a fixed time to slide 1 Item, this compromise method. You can also pass parameters: autoThrottle (sliding distance per unit time), autoThrottleDuration (time to slide a distance regularly)。

1. It is recommended to use Demo settings: Android automatically slides an item height every 400ms, and iOS automatically slides 2 every 10ms.
2. If you want to achieve the same effect as Android and iOS, you can configure autoThrottle = {2}, autoThrottleDuration = {10}
3. There will be time to optimize in the later period: trigger sliding condition optimization, Android jitter optimization when sliding.

2019.10

Add a new scene based on user needs.

• Add attribute (isDragFreely): Whether to limit the drag space.
• Add property callback function (onDragging)
• Add demo Demo: DragDeletePage

2019.7

The 1.x version ends, the optimizations are optimized, and the problems that have occurred have been resolved. The 2.x version will be written next, and it is expected to add an auto-compatible ScrollView slide, slide delete function, and so on.

• Fix a small problem.
• Add a familiar keyExtractor:(item,index) => key to achieve performance optimization, similar to FlatList's keyExtractor, will not flash (repaint) when deleting Item.
• Add the delayLongPress property: press to the time of the trigger, customize how long to start

2019.6

Added the top fixed function, you can set the start of several consecutive non-dragable functions, similar to today's headlines, this function is the same as today's headline drag and drop, you can compare

2019.3

Add a single-line drag-and-drop demo. In fact, this function is consistent. This drag-and-drop plug-in is inherently adaptive. It will take time to optimize the ScrollView problem and make the control bring the ScrollView function。

2019.2:

Optimize drag and drop automatically when not moving, now this plugin should have no problems. Add a real-world demo example, and there will be time to animate this example. When deleting, the item goes down to the item animation to be selected, and the item to be selected is selected. And automatically slide down the animation when sliding。

Performance

Installation

yarn add react-native-drag-sort
or
npm i react-native-drag-sort --save 

Example

• ScrollView
• View
• Fixed Rows

<DragSortableView
    dataSource={this.state.data}
    parentWidth={parentWidth}
    childrenWidth= {childrenWidth}
    childrenHeight={childrenHeight}
    marginChildrenTop={marginChildrenTop}
    onDataChange = {(data)=>{
        // delete or add data to refresh
        if (data.length != this.state.data.length) {
            this.setState({
                data: data
            })
        }
    }}
    keyExtractor={(item,index)=> item.id}
    onClickItem={(data,item,index)=>{}}
    renderItem={(item,index)=>{
        return this.renderItem(item,index)
    }}/>

API

• dataSource: PropTypes.array.isRequired :

• parentWidth: PropTypes.number //parent width

• childrenHeight: PropTypes.number.isRequired, //Each item height

• childrenWidth: PropTypes.number.isRequired,//Each item width

• marginChildrenTop: PropTypes.number, //So the item's outermost view adds margin, you can only use this method.

• marginChildrenBottom: PropTypes.number,

• marginChildrenLeft : PropTypes.number,

• marginChildrenRight : PropTypes.number,

• sortable: PropTypes.bool, //Do not allow dragging

• onClickItem: PropTypes.func, //click

• onDragStart: PropTypes.func,

• onDragEnd : PropTypes.func,

• onDataChange : PropTypes.func, //This method is called every time the data changes.

• renderItem : PropTypes.func.isRequired, //render item view

• fixedItems:PropTypes.array //no remove

• keyExtractor: keyExtractor: PropTypes.func //(item,index) => key

• delayLongPress: PropTypes.number

• isDragFreely: PropTypes.bool, // Whether to limit the drag space

• onDragging: PropTypes.func

• maxScale: PropTypes.number;

• minOpacity: PropTypes.number;

• scaleDuration: PropTypes.number;

• slideDuration: PropTypes.number;

• autoThrottle: PropTypes.number;

• autoThrottleDuration: PropTypes.number;