深入解析LGSemiModalNavController：打造动态高度半模态视图控制器

admin 3个月前 (02-27) 阅读数 23 #开源软件项目

在移动应用开发中，模态视图控制器（Modal ViewController）是一个常见的界面元素，用于在当前界面之上显示临时界面。而LGSemiModalNavController，作为一个开源项目，提供了一种创建动态高度半模态视图控制器的解决方案。本文将详细介绍这个项目的各个方面。

## 1. 项目介绍

LGSemiModalNavController是一个开源项目，旨在允许开发者在另一个视图控制器之上显示一个动态设置高度的视图控制器。这种自定义的转场效果使得视图从屏幕底部部分弹起，覆盖在下方视图控制器之上，并可以自定义缩放比例。

## 2. 项目及技术应用场景

LGSemiModalNavController适用于需要在应用中实现半模态弹窗的场景，比如选择器、日期时间选择器、用户提示框等。它的设计使得用户界面更加灵活，用户体验更加流畅。

## 3. 核心功能解析

### 3.1 类结构

该项目主要由两个类组成：`LGSemiModalNavViewController` 和 `LGSemiModalTransition`。

- `LGSemiModalNavViewController`：继承自`UIViewController`，实现了`UIViewControllerTransitioningDelegate`接口，负责管理视图控制器的转场动画。
- `LGSemiModalTransition`：实现了`UIViewControllerAnimatedTransitioning`接口，负责具体动画的实现。

### 3.2 转场动画

以下是`LGSemiModalNavViewController`中用于创建转场动画的代码片段：

```objective-c
- (id<UIViewControllerAnimatedTransitioning>)animationControllerForPresentedController:(UIViewController *)presented
                                                                  presentingController:(UIViewController *)presenting
                                                                      sourceController:(UIViewController *)source {
    return [self transitionPresenting:YES];
}

- (id<UIViewControllerAnimatedTransitioning>)animationControllerForDismissedController:(UIViewController *)dismissed {
    return [self transitionPresenting:NO];
}

-(LGSemiModalTransition*)transitionPresenting:(BOOL)presenting{
    LGSemiModalTransition *animator = [LGSemiModalTransition new];
    animator.presenting = presenting;
    animator.tapDismissEnabled = _tapDismissEnabled;
    animator.animationSpeed = _animationSpeed;
    animator.backgroundShadeColor = _backgroundShadeColor;
    animator.scaleTransform = _scaleTransform;
    animator.springDamping = _springDamping;
    animator.springVelocity = _springVelocity;
    animator.backgroundShadeAlpha = _backgroundShadeAlpha;
    return animator;
}
```

### 3.3 动画效果

通过自定义的`LGSemiModalTransition`类，开发人员可以轻松实现视图控制器的弹起和缩放效果，以下是使用该类的示例代码：

```objective-c
LGViewController *lgVC = [[LGViewController alloc]initWithFormat:LGViewControllerFormatGoBack];
LGSemiModalNavViewController *semiModal = [[LGSemiModalNavViewController alloc]initWithRootViewController:lgVC];
semiModal.view.frame = CGRectMake(0, 0, self.view.frame.size.width, 400);
semiModal.backgroundShadeColor = [UIColor blackColor];
semiModal.animationSpeed = 0.35f;
semiModal.tapDismissEnabled = YES;
semiModal.backgroundShadeAlpha = 0.4;
semiModal.scaleTransform = CGAffineTransformMakeScale(.94, .94);
[self presentViewController:semiModal animated:YES completion:nil];
```

## 4. 安装与配置指南

LGSemiModalNavController可以通过[CocoaPods]进行安装。在项目的Podfile文件中添加以下行：

```ruby
pod "LGSemiModalNavController"
```

执行`pod install`后即可使用。

## 5. 实战案例分析

在具体的应用开发中，LGSemiModalNavController可以帮助开发者实现如下效果：

- 在用户点击按钮时弹出一个半模态的日期选择器。
- 在用户需要查看详细信息时，从底部弹出一个半模态的详情页。

这些效果都通过自定义转场动画实现，使得用户体验更加流畅和自然。

## 6. 常见问题解答

- **如何调整半模态视图的高度？** 在初始化`LGSemiModalNavViewController`时，可以通过设置其`view.frame`的`height`属性来调整高度。

- **如何启用点击背景遮罩层关闭半模态视图？** 通过设置`semiModal.tapDismissEnabled = YES;`即可启用。

## 7. 发展历程与未来展望