CWLateralSlide 开源项目教程

1. 项目介绍

CWLateralSlide 是一个 iOS 侧滑抽屉框架，旨在打破传统的 LeftVC、RightVC、CenterVC 模式，通过自定义转场动画实现 0 耦合、0 侵入、0 污染的抽屉效果。该框架支持 iOS 7 及以上版本，抽屉控制器拥有完整的生命周期函数调用，关闭抽屉时抽屉不会展示在屏幕外或根控制器下边。最重要的是，只需一行代码即可集成一个侧滑抽屉。

2. 项目快速启动

2.1 安装

你可以通过 CocoaPods 安装 CWLateralSlide：

platform :ios, '7.0'
target 'TargetName' do
  pod 'CWLateralSlide', '~> 1.6.3'
end

2.2 使用

2.2.1 导入分类

在需要使用侧滑抽屉的控制器中导入分类：

#import "UIViewController+CWLateralSlide.h"

2.2.2 显示默认抽屉

调用以下方法显示默认抽屉：

UIViewController *vc = [[UIViewController alloc] init];
[self cw_showDefaultDrawerViewController:vc];

或者使用自定义配置：

[self cw_showDrawerViewController:vc animationType:CWDrawerAnimationTypeDefault configuration:nil];

2.2.3 注册手势驱动

在 viewDidLoad 中注册手势驱动：

__weak typeof(self)weakSelf = self;
[self cw_registerShowIntractiveWithEdgeGesture:NO transitionDirectionAutoBlock:^(CWDrawerTransitionDirection direction) {
    if (direction == CWDrawerTransitionDirectionLeft) {
        [weakSelf leftClick];
    } else if (direction == CWDrawerTransitionDirectionRight) {
        [weakSelf rightClick];
    }
}];

3. 应用案例和最佳实践

3.1 自定义抽屉效果

你可以通过配置 CWLateralSlideConfiguration 来自定义抽屉效果：

RightViewController *vc = [[RightViewController alloc] init];
CWLateralSlideConfiguration *conf = [CWLateralSlideConfiguration configurationWithDistance:0 maskAlpha:0.4 scaleY:0.8 direction:CWDrawerTransitionDirectionRight backImage:[UIImage imageNamed:@"back.jpg"]];
[self cw_showDrawerViewController:vc animationType:0 configuration:conf];

3.2 抽屉内 Push 和 Present 操作

在侧滑的控制器内进行 Push 操作：

NextViewController *vc = [NextViewController new];
[self cw_pushViewController:vc];

进行 Present 操作：

[self cw_presentViewController:vc];
[self cw_dismissViewController];

4. 典型生态项目

CWLateralSlide 是一个独立的侧滑抽屉框架，适用于需要侧滑抽屉效果的 iOS 应用。它不依赖于其他特定的生态项目，但可以与其他 UI 组件和框架（如导航控制器、TabBar 控制器等）结合使用，以实现更复杂的用户界面和交互效果。

通过 CWLateralSlide，开发者可以轻松实现类似 QQ 的侧滑抽屉效果，提升应用的用户体验。