wang9262 / koloda-objc Goto Github PK

#KolodaView-ObjC This is a Objective-C version of KolodaView.You can see more info at that page.

中文版

First of all,thanks to the great work of Yalantis.Recently I have been work with the similar things,but mine is not so elegant.So I tried some tinder-like repositories,however they can't satisfy my demand.And then I found KolodaView,but it written in Swift, but my project was under ObjC,so I rewrite this using ObjC.

• More Customizable

• Translate this two articles which explain more details about how this framework works.

  1.如何创建一个类似 Tinder 的交互动画[译]

  2.Koloda动画第二版[译]

• Supported build target - iOS 8.0 (Xcode 6.2)
• You can try it on iOS7,it should be work.

KolodaView-Objc requires ARC.

The SwipeView has the following properties:

@property (nonatomic, weak) IBOutlet id<SwipeViewDataSource> dataSource;

An object that supports the SwipeViewDataSource protocol and can provide views to populate the SwipeView.

@property (nonatomic, weak) IBOutlet id<SwipeDelegate> delegate;

An object that supports the SwipeViewDelegate protocol and can respond to SwipeView events.

@property (nonatomic, readonly) NSUInteger currentCardNum;

The index of front card in the SwipeView (read only).

@property (nonatomic, readonly) NSUInteger cardsCount;

The count of cards in the SwipeView (read only). To set this, implement the swipeViewNumberOfCards: dataSource method.

@property (nonatomic, readonly) NSUInteger visibleCardsCount;

The count of displayed cards in the SwipeView.

The SwipeView class has the following methods:

- (void)reloadData;

This reloads all SwipeView item views from the dataSource and refreshes the display.

- (void)revertAction;

Applies undo animation and decrement currentCardNumber.

- (void)applyAppearAnimation;

Applies appear animation.

- (void)swipeLeft;

Applies swipe left animation and action, increment currentCardNumber.

- (void)swipeRight;

Applies swipe right animation and action, increment currentCardNumber.

- (CGRect)frameForCardAtIndex:(NSUInteger)index; 

Calculates frames for cards. Useful for overriding. See example to learn more about it.

The SwipeView follows the Apple convention for data-driven views by providing two protocol interfaces, SwipeDataSource and SwipeViewDelegate. You can set them through Xib/StoryBoard/Code.All are fine.The SwipeViewDataSource protocol has the following methods:

- (NSUInteger)swipeViewNumberOfCards:(SwipeView *)swipeView;

Return the number of items (views) in the SwipeView.

- (UIView *)swipeView:(SwipeView *)swipeView
          cardAtIndex:(NSUInteger)index;

Return a view to be displayed at the specified index in the SwipeView.

- (OverlayView *)swipeView:(SwipeView *)swipeView
        cardOverlayAtIndex:(NSUInteger)index;

Return a view for card overlay at the specified index. For setting custom overlay action on swiping(left/right), you should override didSet of overlayState property in OverlayView. (See Example)

The SwipeViewDelegate protocol has the following methods:

 - (void)swipeView:(SwipeView *)swipeView didSwipeCardAtIndex:(NSUInteger)index inDirection:(SwipeDirection)direction;

This method is called whenever the SwipeView swipes card. It is called regardless of whether the card was swiped programatically or through user interaction.

- (void)swipeViewDidRunOutOfCards:(SwipeView *)swipeView;

This method is called when the SwipeView has no cards to display.

- (void)swipeView:(SwipeView *)swipeView didSelectCardAtIndex:(NSUInteger)index;

This method is called when one of cards is tapped.

- (BOOL)swipeViewShouldApplyAppearAnimation:(SwipeView *)swipeView;

This method is fired on reload, when any cards are displayed. If you return YES from the method, the koloda will apply appear animation.

- (BOOL)swipeViewShouldMoveBackgroundCard:(SwipeView *)swipeView;

This method is fired on start of front card swipping. If you return YES from the method, the koloda will move background card with dragging of front card.

- (BOOL)swipeViewShouldTransparentizeNextCard:(SwipeView *)swipeView;

This method is fired on koloda's layout and after swiping. If you return YES from the method, the koloda will transparentize next card below front card.

- (POPPropertyAnimation *)swipeViewBackgroundCardAnimation:(SwipeView *)swipeView;

Return a pop frame animation to be applied to backround cards after swipe. This method is fired on swipping, when any cards are displayed. If you don't return frame animation, or return nil, the koloda will apply default animation.

#中文

现在这个框架KolodaView已经支持 Objective-C 了，详见这个issue。所以如果想紧跟这个项目更新的话，可以尝试使用原框架。这边会继续维护，然后添加一些后续的自定义功能，敬请期待！Have Fun！

感谢Yalantis出了个这么屌的框架，由于之前也有在做类似的事情，也尝试了 GitHub 上一些类似 Tinder 的框架，但是封装的不够好，无法满足自己需求，而自己实现的有点生硬。恰巧看到KolodaView，但是它是用swift写的，而自己的工程用的是ObjC，本来想通过头文件桥接方式，但是由于其引入了 pod不太好弄就直接按照这个**写了个 ObjC版的。总的来说，我仅仅只是搬运工。

• 用的是 Xcode6.4，iOS8.4
• 按道理来说 iOS6 以上都能用，只要 pop 支持的 SDK 版本都能用。未亲测，纯属 YY，如果您有测试，请告诉我以下

必须使用 ARC

属性如下：

//用来填充 SwipeView 的数据源协议
@property (nonatomic, weak) IBOutlet id<SwipeViewDataSource> dataSource;

//用来响应 UI 事件的代理
@property (nonatomic, weak) IBOutlet id<SwipeDelegate> delegate;

//最前的卡片的 index（只读）
@property (nonatomic, readonly) NSUInteger currentCardNum;

//SwipeView 的卡片数目（只读），可通过实现数据源中的swipeViewNumberOfCards:方法来设置
@property (nonatomic, readonly) NSUInteger cardsCount;

//当前可见卡片数
@property (nonatomic, readonly) NSUInteger visibleCardsCount;

//重新加载，类似 TableView
- (void)reloadData;

//撤销动画，同时减少currentCardNumber
- (void)revertAction;

//显示动画
- (void)applyAppearAnimation;

- (void)swipeLeft;

- (void)swipeRight;

//计算处于 index 位置的卡片 frame
- (CGRect)frameForCardAtIndex:(NSUInteger)index;

使用类似 TableView 的数据源驱动、带代理方法的方式。可通过 XIB/Storyboard/代码来设置

SwipeViewDataSource 数据源方法（必须实现）

- (NSUInteger)swipeViewNumberOfCards:(SwipeView *)swipeView;

- (UIView *)swipeView:(SwipeView *)swipeView
          cardAtIndex:(NSUInteger)index;

- (OverlayView *)swipeView:(SwipeView *)swipeView
        cardOverlayAtIndex:(NSUInteger)index;

SwipeViewDelegate代理方法

- (void)swipeView:(SwipeView *)swipeView didSwipeCardAtIndex:(NSUInteger)index inDirection:(SwipeDirection)direction;

- (void)swipeViewDidRunOutOfCards:(SwipeView *)swipeView;

- (void)swipeView:(SwipeView *)swipeView didSelectCardAtIndex:(NSUInteger)index;

- (BOOL)swipeViewShouldApplyAppearAnimation:(SwipeView *)swipeView;

- (BOOL)swipeViewShouldMoveBackgroundCard:(SwipeView *)swipeView;

- (BOOL)swipeViewShouldTransparentizeNextCard:(SwipeView *)swipeView;

- (POPPropertyAnimation *)swipeViewBackgroundCardAnimation:(SwipeView *)swipeView;

• 高度自定义化

• 翻译其官方的讲解该框架细节的两篇博客

  1.如何创建一个类似 Tinder 的交互动画[译] 2.Koloda动画第二版[译]

The MIT License (MIT)

Copyright © 2015 Vong

Permission is hereby granted free of charge to any person obtaining a copy of this software and associated documentation files (the "Software") to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.