README_History.md

react-native-drag-sort

Drag and drop sort control for react-native

Language

• English
• 中文

Installation

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

export { DragSortableView, AutoDragSortableView }

important hint

1. Download Android example
2. You must write the attribute keyExtractor = {(item, index) => item.id} id is the unique identification of your data, there is no index to replace item.id.
3. If Android Debug mode is compared to the card. Please package and install and test, release will not get stuck. Or test animation is very smooth under iOS.

2020.2 New Demo Fixed Add Button Demo

ScrollFixedAddPage

2020.2 Removed componentWillReceiveProps / componentWillMount method

Using Fiber after React 16.3, React rendering has become asynchronous rendering. For details, please Google React Fiber.

• React <16.3 Please quote [email protected]
• React> 16.3 Please quote react-native-drag-sort@ latest

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.

AutomaticSlidingOnePage

AutomaticSlidingThreePage

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

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

SortAndFixedPage

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。

OneRowsPage

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。

CommonSortPage

Performance

ScrollPage

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

isRequired if there is a * in the name field

name	Proptypes	Description
dataSource *	array
parentWidth	number	parent width
childrenHeight *	number	Each item height
childrenWidth *	number	Each item width
marginChildrenTop	number	So the item's outermost view adds margin, you can only use this method.
marginChildrenBottom	number
marginChildrenLeft	number
marginChildrenRight	number
sortable	bool	Do not allow dragging
onClickItem	func	click
onDragStart	func
onDragEnd	func
onDataChange	func	This method is called every time the data changes.
renderItem *	func	render item view
fixedItems	array	no remove
keyExtractor	func	(item,index) => key
delayLongPress	number
isDragFreely	bool	Whether to limit the drag space
onDragging	func
maxScale	number
minOpacity	number
scaleDuration	number
slideDuration	number
autoThrottle	number
autoThrottleDuration	number