https://github.com/danie1s/dnspageview-objc

DNSPageView 的 Objective-C 版本
https://github.com/danie1s/dnspageview-objc

cocoapods ios objective-c pageview xcode

Last synced: 7 months ago
JSON representation

DNSPageView 的 Objective-C 版本

• Host: GitHub
• URL: https://github.com/danie1s/dnspageview-objc
• Owner: Danie1s
• License: mit
• Created: 2018-09-21T10:13:27.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2020-08-17T16:23:35.000Z (over 5 years ago)
• Last Synced: 2025-08-19T12:06:16.094Z (7 months ago)
• Topics: cocoapods, ios, objective-c, pageview, xcode
• Language: Objective-C
• Homepage:
• Size: 1.31 MB
• Stars: 31
• Watchers: 1
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# DNSPageView-ObjC

[![Version](https://img.shields.io/cocoapods/v/DNSPageView-ObjC.svg?style=flat)](http://cocoapods.org/pods/DNSPageView-ObjC)

[![License](https://img.shields.io/cocoapods/l/DNSPageView-ObjC.svg?style=flat)](http://cocoapods.org/pods/DNSPageView-ObjC)

[![Platform](https://img.shields.io/cocoapods/p/DNSPageView-ObjC.svg?style=flat)](http://cocoapods.org/pods/DNSPageView-ObjC)

DNSPageView 的 Objective-C 版本，是一个灵活且易于使用的 pageView 框架，titleView 和 contentView 可以布局在任意地方，可以纯代码初始化，也可以使用 xib 或者 storyboard 初始化，并且提供了常见样式属性进行设置。

如果你使用的开发语言是 Swift，请使用 [DNSPageView](https://github.com/Danie1s/DNSPageView)

- [Features](#features)

- [Requirements](#requirements)

- [Installation](#installation)

- [Example](#example)

- [Usage](#usage)

  - [直接使用 DNSPageView 初始化](#直接使用-dnspageview-初始化) 

  - [使用 xib 或者 storyboard 初始化](#使用-xib-或者-storyboard-初始化)

  - [使用 DNSPageViewManager 初始化](#使用-dnspageviewmanager-初始化)

  - [样式](#样式)

  - [事件回调](#事件回调)

  - [常见问题](#常见问题)

- [License](#license)

## Features:

- [x] 使用简单

- [x] 多种初始化方式

- [x] 灵活布局

- [x] 常见的样式

- [x] 双击 titleView 的回调

- [x] contentView 滑动监听

- [x] 适配 iOS 13 Dark Mode

- [x] 动态改变样式

## Requirements

- iOS 8.0+

- Xcode 9.0+

## Installation

### CocoaPods

[CocoaPods](http://cocoapods.org) is a dependency manager for Cocoa projects. You can install it with the following command:

```bash

$ gem install cocoapods

```

> CocoaPods 1.1+ is required to build DNSPageView.

To integrate DNSPageView into your Xcode project using CocoaPods, specify it in your `Podfile`:

```ruby

source 'https://github.com/CocoaPods/Specs.git'

platform :ios, '8.0'

target '' do

    pod 'DNSPageView-ObjC'

end

```

Then, run the following command:

```bash

$ pod install

```

### Manually

If you prefer not to use any of the aforementioned dependency managers, you can integrate DNSPageView-ObjC into your project manually.

## Example

To run the example project, clone the repo, and run `DNSPageView.xcodeproj` .









## Usage

### 直接使用 DNSPageView 初始化

```objective-c

// 创建 DNSPageStyle，设置样式

DNSPageStyle *style = [[DNSPageStyle alloc] init];

style.titleViewScrollEnabled = YES;

style.titleScaleEnabled = YES;

// 设置标题内容

NSArray *titles = @[@"头条", @"视频", @"娱乐", @"要问", @"体育", @"科技", @"汽车", @"时尚", @"图片", @"游戏", @"房产"];

// 创建每一页对应的 controller

for (int i = 0; i < titles.count; i++) {

    ContentViewController *controller = [[ContentViewController alloc] init];

    [self addChildViewController:controller];

}

CGFloat y = [UIApplication sharedApplication].statusBarFrame.size.height + self.navigationController.navigationBar.frame.size.height;

CGSize size = [UIScreen mainScreen].bounds.size;

// 创建对应的 DNSPageView，并设置它的 frame

DNSPageView *pageView = [[DNSPageView alloc] initWithFrame:CGRectMake(0, y, size.width, size.height - y) style:style titles:titles childViewControllers:self.childViewControllers currentIndex:7];

[self.view addSubview:pageView];

```

### 使用 xib 或者 storyboard 初始化

 在 `xib` 或者 `storyboard` 中拖出 2 个 `UIView`，让它们分别继承 `DNSPageTitleView` 和 `DNSPageContentView`，拖线到代码中

```objective-c

@property (weak, nonatomic) IBOutlet DNSPageTitleView *titleView;

@property (weak, nonatomic) IBOutlet DNSPageContentView *contentView;

```

对 DNSPageTitleView 和 DNSPageContentView 进行设置

```objective-c

// 创建 DNSPageStyle，设置样式

DNSPageStyle *style = [[DNSPageStyle alloc] init];

style.titleViewBackgroundColor = [UIColor redColor];

style.showCoverView = YES;

// 设置标题内容

NSArray *titles = @[@"头条", @"视频", @"娱乐", @"要问", @"体育"];

// 设置默认的起始位置

NSInteger startIndex = 2;

// 创建每一页对应的 controller

for (int i = 0; i < titles.count; i++) {

    ContentViewController *controller = [[ContentViewController alloc] init];

    [self addChildViewController:controller];

}

// 创建 DNSPageViewManager 来设置它们的样式和布局

DNSPageViewManager *pageViewManager = [[DNSPageViewManager alloc] initWithStyle:style

                                                     titles:titles

                                       childViewControllers:self.childViewControllers

                                               currentIndex:currentIndex

                                                  titleView:self.titleView

                                                contentView:self.contentView];

```

### 使用 DNSPageViewManager 初始化

创建 DNSPageViewManager

```objective-c

- (DNSPageViewManager *)pageViewManager {

    if (!_pageViewManager) {

        // 创建 DNSPageStyle，设置样式

        DNSPageStyle *style = [[DNSPageStyle alloc] init];

        style.showBottomLine = YES;

        style.titleViewScrollEnabled = YES;

        style.titleViewBackgroundColor = [UIColor clearColor];

        

        // 设置标题内容

        NSArray *titles = @[@"头条", @"视频", @"娱乐", @"要问", @"体育"];

        

        // 创建每一页对应的 controller

        for (int i = 0; i < titles.count; i++) {

            ContentViewController *controller = [[ContentViewController alloc] init];

            [self addChildViewController:controller];

        }

        _pageViewManager = [[DNSPageViewManager alloc] initWithStyle:style titles:titles childViewControllers:self.childViewControllers];

    }

    return _pageViewManager;

}

```

布局 titleView 和 contentView

```objective-c

// 单独设置 titleView 的 frame

self.navigationItem.titleView = self.pageViewManager.titleView;

self.pageViewManager.titleView.frame = CGRectMake(0, 0, 180, 44);

// 单独设置 contentView 的大小和位置，可以使用 autolayout 或者 frame

DNSPageContentView *contentView = self.pageViewManager.contentView;

[self.view addSubview:contentView];

[contentView makeConstraints:^(MASConstraintMaker *make) {

    make.edges.equalTo(self.view);

}];

```

### 样式

`DNSPageStyle` 中提供了常见样式的属性，可以按照不同的需求进行设置，包括可以设置初始显示的页面

### 事件回调

DNSPageView 提供了常见事件监听的代理，它属于 `DNSPageTitleViewDelegate` 的中的属性

```objective-c

/**

 DNSPageView 的事件回调，如果有需要，请让对应的 childViewController 遵守这个协议

 */

@protocol DNSPageEventHandlerDelegate 

@optional

/**

 重复点击 pageTitleView 后调用

 */

- (void)titleViewDidSelectSameTitle;

/**

 pageContentView 的上一页消失的时候，上一页对应的 controller 调用

 */

- (void)contentViewDidDisappear;

/**

 pageContentView 滚动停止的时候，当前页对应的 controller 调用

 */

- (void)contentViewDidEndScroll;

@end

```

### 常见问题

- `style.isTitleViewScrollEnabled`

  如果标签比较少，建议设置 `style.titleViewScrollEnabled = NO`，`titleView` 会固定，`style.titleMargin` 不起作用，每个标签平分整个 `titleView` 的宽度，下划线的宽度等于标签的宽度。

  如果标签比较多，建议设置 `style.titleViewScrollEnabled = YES`，`titleView` 会滑动，下划线的宽度随着标签文字的宽度变化而变化

- 标签下划线的宽度跟随文字的宽度

  设置 `style.titleViewScrollEnabled = YES`，可以参考 demo 中的第四种样式。

- 由于 `DNSPageView` 是基于 `UIScrollView` 实现，那么就无法避免它的一些特性：

  - 当控制器被 `UINavigationController` 管理，且 `navigationBar.isTranslucent = YES` 的时候，当前控制器的 `view` 是从 `y = 0` 开始布局的，所以为了防止部分内容被 `navigationBar` 遮挡，系统默认会给 `UIScrollView` 添加 offset。如果想取消这个特性：

    - iOS 11 以前，在控制器中设置 `self.automaticallyAdjustsScrollViewInsets = NO`

    - iOS 11 以后引入 `SafeArea` 概念，设置 `UIScrollView` 的属性 `contentInsetAdjustmentBehavior = UIScrollViewContentInsetAdjustmentNever`

    - 其实这个效果还与 `UIViewController` 的其他属性有关系，但因为各种组合的情景过于复杂，所以不在此一一描述

  - `DNSPageContentView` 用 `UICollectionView` 实现，所以这个特性有机会造成 `UICollectionView` 的高度小于它的 `item` 的高度，造成奇怪的 Bug。

  - 以上只是可能出现的 Bug 之一，由于 `Demo` 不能覆盖所有的场景，不同的布局需求可能会引起不同的 Bug，开发者需要明确了解自己的布局需求，注意细节，了解 iOS 布局特性，并且作出对应的调整，不能完全参照 `Demo`。

## License

DNSPageView-ObjC is available under the MIT license. See the LICENSE file for more info.