docs: update readme

#101

Author: gxxgcn

docs/props.md

@@ -54,8 +54,8 @@
 
 | name            | types                                       | description            |
 | --------------- | ------------------------------------------- | ---------------------- |
-| prev            | (count?: number)=>void                      | Scroll to previous item, it takes one optional argument (count), which allows you to specify how many items to cross      |
-| next            | (count?: number)=>void                      | Scroll to next item, it takes one optional argument (count), which allows you to specify how many items to cross      |
-| scrollTo        | (value: number, animated?: boolean) => void | Use value to scroll to a position where relative to the current position, scrollTo(-2) is equivalent to prev(2), scrollTo(2) is equivalent to next(2)            |
+| prev            | ({ count = 1, animated = false, onFinished?: () => void }) => void                      | Scroll to previous item, it takes one optional argument (count), which allows you to specify how many items to cross      |
+| next            | ({ count = 1, animated = false, onFinished?: () => void }) => void                      | Scroll to next item, it takes one optional argument (count), which allows you to specify how many items to cross      |
+| scrollTo        | ({ count = 1, animated = false, onFinished?: () => void }) => void | Use count to scroll to a position where relative to the current position, scrollTo(-2) is equivalent to prev(2), scrollTo(2) is equivalent to next(2)            |
 | goToIndex       | (index: number, animated?: boolean) => void | Go to index            |
 | getCurrentIndex | ()=>number                                  | Get current item index |

docs/props.zh-CN.md

@@ -54,8 +54,8 @@
 
 | name            | types                                       | description        |
 | --------------- | ------------------------------------------- | ------------------ |
-| prev            | (count?: number = 1)=>void                  | 切换至上一项，可以指定`count`决定切换的数量 |
-| next            | (count?: number = 1)=>void                  | 切换至下一张，可以指定`count`决定切换的数量 |
-| scrollTo        | (value: number, animated?: boolean)=>void   | 切换到距离当前相对位置为`value`的位置，`scrollTo(-2)`等价于`prev(2)`，`scrollTo(2)`等价于`next(2)` |
+| prev            | ({ count = 1, animated = false, onFinished?: () => void }) => void                  | 切换至上一项，可以指定`count`决定切换的数量 |
+| next            | ({ count = 1, animated = false, onFinished?: () => void }) => void                  | 切换至下一张，可以指定`count`决定切换的数量 |
+| scrollTo        | ({ count = 1, animated = false, onFinished?: () => void }) => void   | 切换到距离当前相对位置为`count`的位置，`scrollTo(-2)`等价于`prev(2)`，`scrollTo(2)`等价于`next(2)` |
 | （弃用）goToIndex | (index: number, animated?: boolean) => void | 切换至指定下标元素 |
 | getCurrentIndex | ()=>number                                  | 获得当前轮播图下标 |

example/src/advanced-parallax/index.tsx

@@ -52,6 +52,7 @@ function Index() {
                     );
                 }}
                 customAnimation={animationStyle}
+                scrollAnimationDuration={1200}
             />
             <SButton
                 onPress={() => {

example/src/pause-advanced-parallax/index.tsx

@@ -52,6 +52,7 @@ function Index() {
                     );
                 }}
                 customAnimation={animationStyle}
+                scrollAnimationDuration={1200}
             />
             <SButton
                 onPress={() => {

src/hooks/useCarouselController.tsx

@@ -226,15 +226,15 @@ export function useCarouselController(options: IOpts): ICarouselController {
 
     const scrollTo = React.useCallback(
         (opts: TCarouselActionOptions = {}) => {
-            const { count, animated = false } = opts;
+            const { count, animated = false, onFinished } = opts;
             if (!count) {
                 return;
             }
             const n = Math.round(count);
             if (n < 0) {
-                prev({ count: Math.abs(n), animated });
+                prev({ count: Math.abs(n), animated, onFinished });
             } else {
-                next({ count: n, animated });
+                next({ count: n, animated, onFinished });
             }
         },
         [prev, next]