CMPageTitleView: An Objective-C repository from CrabMen

效果展示
安装
示例
支持的配置
版本记录
支持
许可

效果展示

效果展示 - 基本样式

基本样式	GIF
00-00.颜色效果 - RGB渐变
00-01.颜色效果 - 填充渐变
00-02.颜色效果 - 无渐变
00-03.切换样式 - 字体放大
00-04.切换样式 - 下划线
00-05.切换样式 - 遮罩
00-06.切换样式 - 字体放大 - 延迟
00-07.切换样式 - 下划线 - 延迟
00-08.切换样式 - 遮罩 - 延迟
00-09.附加效果 - 标题栏下方分割线
00-10.附加效果 - 标题文字之间分割线
00-11.对齐方式 -- 左对齐
00-12.对齐方式 -- 右对齐
00-13.对齐方式 -- 居中
00-14.对齐方式 -- SpaceAround
00-15.字体放大效果时对其方式 -- 居中对齐
00-16.字体放大效果时对其方式 -- 上对齐
00-17.字体放大效果时对其方式 -- 下对齐

效果展示 - 组合样式

根据上方的基本样式可以进行自由组合，从而达到你想要的效果；因组合样式过多，下方列出了部分

组合样式	GIF
01-00.字体放大 - 颜色RGB渐变
01-01.字体放大 - 颜色填充渐变
01-02.字体放大 - 颜色无渐变
01-03.字体放大(延迟) - 颜色RGB渐变
01-04.字体放大(延迟) - 颜色填充渐变
01-05.字体放大(延迟) - 颜色无渐变
01-06.下划线 - 颜色RGB渐变
01-07.下划线 - 颜色填充渐变
01-08.下划线 - 颜色无渐变
01-09.下划线(延迟) - 颜色RGB渐变
01-10.下划线(延迟) - 颜色填充渐变
01-11.下划线(延迟) - 颜色无渐变
01-12.下划线（固定宽度）- 颜色RGB渐变
01-13.下划线（固定宽度）- 颜色填充渐变
01-14.下划线（固定宽度）- 颜色无渐变
01-15.下划线（延迟 && 固定宽度）- 颜色RGB渐变
01-16.下划线（延迟 && 固定宽度）- 颜色填充渐变
01-17.下划线（延迟 && 固定宽度）- 颜色无渐变
01-18.下划线（比例宽度）- 颜色RGB渐变
01-19.下划线（比例宽度）- 颜色填充渐
01-20.下划线（比例宽度）- 颜色无渐变
01-21.下划线（延迟 && 比例宽度）- 颜色RGB渐变
01-22.下划线（延迟 && 比例宽度）- 颜色填充渐变
01-23.下划线（延迟 && 比例宽度）- 颜色无渐变
01-24.下划线（延展）- 颜色RGB渐变
01-25.下划线（延展）- 颜色填充渐变
01-26.下划线（延展）- 颜色无渐变
01-27.下划线（延展 && 固定宽度）- 颜色RGB渐变
01-28.下划线（延展 && 固定宽度）- 颜色填充渐变
01-29.下划线（延展 && 固定宽度）- 颜色无渐变
01-30.下划线（延展 && 比例宽度）- 颜色RGB渐变
01-31.下划线（延展 && 比例宽度）- 颜色填充渐变
01-32.下划线（延展 && 比例宽度）- 颜色无渐变
01-33.遮罩 - 颜色RGB渐变
01-34.遮罩 - 颜色填充渐变
01-35.遮罩 - 颜色无渐变
01-36.遮罩(延迟) - 颜色RGB渐变
01-37.遮罩(延迟) - 颜色填充渐变
01-38.遮罩(延迟) - 颜色无渐变
01-39.遮罩（固定宽度）- 颜色RGB渐变
01-40.遮罩（固定宽度）- 颜色填充渐变
01-41.遮罩（固定宽度）- 颜色无渐变
01-42.遮罩（延迟 && 固定宽度）- 颜色RGB渐变
01-43.遮罩（延迟 && 固定宽度）- 颜色填充渐变
01-44.遮罩（延迟 && 固定宽度）- 颜色无渐变
01-45.字体放大 && 下划线 - 颜色填充渐变
01-46.字体放大 && 下划线 && 延迟 - 颜色无渐变
01-47.字体放大 && 下划线（延展）- 颜色填充渐变
01-48.字体放大 && 下划线（延展 && 固定宽度）- 颜色填充渐变
01-49.字体放大 && 下划线（延展 && 比例宽度）-颜色填充渐变
01-50.字体放大 && 下划线（延展 && 放大时下对齐）-颜色填充渐变
01-51.字体放大 && 下划线（延展 && 放大时下对齐 && 左对齐）-颜色填充渐变

效果展示 - 其他样式

其他样式	GIF
02-00.标题栏背景色
02-01.标题栏背景图片
02-02.rightView
02-03.全屏穿透样式

安装

CocoaPods安装:

For iOS8+:

use_frameworks!
target '<Your Target Name>' do
    pod 'CMPageTitleView'
end

手动安装:

将 CMPageTitleView/CMPageTitleView/Class 路径下的所有文件拖拽到你的项目中.

示例

首先, 先要导入.h头文件.

如果cocoaposd安装:

#import <CMPageTitleView/CMPageTitleView.h>

如果手动安装:

#import "CMPageTitleView.h"

创建CMPageTitleView 后，创建CMPageTitleConfig 对象并设置所需配置：

    CMPageTitleView *pageView = [[CMPageTitleView alloc] initWithFrame:frame];
    pageView.delegate = self;
    
    CMPageTitleConfig *config = [CMPageTitleConfig defaultConfig];
    config.cm_childControllers = self.childControllers; //必传参数
    pageView.cm_config = config;

    [self.view addSubview:pageView];

同样支持Masonry布局，代码如下：

    CMPageTitleView *pageView = [[CMPageTitleView alloc] init];
    [self.view addSubview:pageView];
    
    [pageView mas_makeConstraints:^(MASConstraintMaker *make) {
        make.left.right.mas_equalTo(0);
        make.top.mas_equalTo(CM_NAVI_BAR_H);
        make.height.mas_equalTo(CM_SCREEN_H - CM_NAVI_BAR_H);
        
    }];
    pageView.delegate = self;
    
    CMPageTitleConfig *config = [CMPageTitleConfig defaultConfig];
    config.cm_childControllers = self.childControllers;//必传参数
    
    pageView.cm_config = config;

按照上方代码，你已经创建了一个最简单的菜单栏🎉

支持的配置

配置	描述
cm_gradientStyle	颜色渐变样式 `CMTitleColorGradientStyle_None`（颜色无渐变） `CMTitleColorGradientStyle_RGB`（RGB颜色渐变） `CMTitleColorGradientStyle_Fill`（填充色颜色渐变）
cm_switchMode	标题切换样式 `CMPageTitleSwitchMode_Scale`(字体放大) `CMPageTitleSwitchMode_Underline`（下划线样式） `CMPageTitleSwitchMode_Cover` （遮罩样式） `CMPageTitleSwitchMode_Delay`（滑动切换时延迟，配合其他样式使用）
cm_additionalMode	标题栏附加样式 `CMPageTitleAdditionalMode_Seperateline`（标题栏下方的分割线） `CMPageTitleAdditionalMode_Splitter`（标题文字之间的分割线）
cm_contentMode	对齐方式 `CMPageTitleContentMode_Center`（左右边距与标题间距一致） `CMPageTitleContentMode_SpaceAround`(左右边距等于标题间距的一半) `CMPageTitleContentMode_Left`（左对齐） `CMPageTitleContentMode_Right`（右对齐）
cm_scaleGradientContentMode	垂直方向上的对齐方式 `CMPageTitleScaleGradientContentMode_Center`（居中） `CMPageTitleScaleGradientContentMode_Top`（上对齐） `CMPageTitleScaleGradientContentMode_Bottom`（下对齐） `注意：`只有属性`cm_switchMode`包含`CMPageTitleSwitchMode_Scale`下才有效果
cm_childControllers	子视图控制器数组
cm_titles	标题数组
cm_font	标题正常字体默认字体大小：`[UIFont systemFontOfSize:15]`
cm_selectedFont	标题选中字体默认选中字体大小：`cm_font`的1.15倍
cm_backgroundColor	视图的背景色默认颜色：`[UIColor whiteColor]`
cm_normalColor	标题正常颜色默认颜色：`[UIColor blackColor]`
cm_selectedColor	标题选中颜色默认颜色：`[UIColor redColor]`
cm_titleHeight	标题高度默认高度：44
cm_titleTop	标题视图距离上方的偏移量默认高度：0
cm_slideGestureEnable	是否支持侧滑默认值：`YES`
cm_titleMargin	标题之间的间隔
cm_minTitleMargin	最小的标题间距默认值为 20
cm_defaultIndex	默认选中的index 默认选择第0个
cm_seperaterLineColor	标题栏下方分割线的颜色默认颜色：`[UIColor grayColor]`
cm_seperateLineHeight	标题分割线的高度默认值：1px
cm_splitterColor	标题之间的分割线颜色默认为：`[UIColor lightGrayColor]`
cm_splitterSize	标题之间的分割线size 默认宽度：1px 默认高度：标题栏高度的一半
cm_animationDruction	下划线和遮罩，在点击标题时，动画的时间间隔默认值为：0.25 `注意：`取值范围 0.25~0.8(超出范围会使用默认值)
cm_rightView	垂直方向上的对齐方式默认值：`CMPageTitleVerticalContentMode_Center` `注意：`只有属性`cm_switchMode`包含`CMPageTitleSwitchMode_Scale`下有效果
cm_parentController	父视图控制器
cm_fullScreen (getter=cm_isFullScreen)	是否全屏显示默认值：`NO`
cm_scale	标题的缩放等级默认为 1.15 `注意：`不建议依赖该属性，后期可能会废弃，可以使用`cm_selectedFont`配合`cm_font`属性进行设置）
cm_titleWidths	标题宽度数组 `注意：readonly`
cm_minContentWidth	标题的总宽度 + 左右边距 + 所有的标题最小间距 `注意：readonly`
cm_titlesWidth	所有标题的总宽度 `注意： readonnly`）
cm_underlineBorder	下划线视图是否圆角默认值:`NO`
cm_underlineHeight	下划线高度默认值：2
cm_underlineWidth	下划线宽度默认情况下跟随文字宽度，但是设置该属性后下划线会固定使用该宽度
cm_underlineWidthScale	下划线跟随文字宽度 * `cm_underlineWidthScale` `注意：`比例范围 0 ~ 1.3（超出 1.3 按 1.0 处理）
cm_underlineColor	下划线颜色默认跟随标题的选中颜色
cm_underlineStretch	下划线是否延长默认值：`NO` （具体效果可以看github效果展示）
cm_coverColor	遮罩颜色
cm_coverRadius	遮罩圆角半径默认为 cover高度的一半
cm_coverWidth	遮罩固定宽度 `注意：`未做最大最小限制，请根据实际情况妥善设置
cm_coverVerticalMargin	遮罩垂直方向边距 `注意：`未做最大最小限制，请根据实际情况妥善设置
cm_coverHorizontalMargin	遮罩水平方向边距 `注意：`未做最大最小限制，请根据实际情况妥善设置

注意： 倘若需要复杂效果，可以通过创建CMPageTitleConfig对象中的 cm_gradientStyle（颜色渐变样式）、cm_switchMode（标题切换样式）、cm_additionalMode（附加效果）、cm_contentMode（对齐方式）、cm_scaleGradientContentMode（放大效果时的对齐样式）等基本样式的组合实现各种复杂效果，可以下载Demo查看具体效果，但是能实现的组合远远不止这些，更多组合可以集成到项目中尝试😊

版本

2018-08-13 初始化项目
2019-04-26 版本 0.3.0 新增下划线比例宽度跟随标题文字宽度
2019-05-03 版本 0.3.1
- cm_scale可以继续使用，新增cm_selectedFont属性，便于设置选中字体大小；
- 支持Masonry
2019-05-09 版本 0.4.0
- 新增设置标题分割线Size以及Color功能
- 新增对外暴露的代理方法，便于用户做对应处理
- 新增断言异常提示；新增设置是否允许侧滑功能
2019-05-16 版本 0.4.1 修复cm_seperateLineHeight为0时无效的问题
2019-05-17 版本 0.4.2 新增cm_animationDruction属性，便于用户设置动画时间
2019-05-23 版本 0.5.0
- 新增cm_verticalContentMode，可以设置标题文字垂直方向的对齐方式
- 新增cm_additionalMode，便于设置分割线
- 优化cm_backgroundColor效果；
- 优化相关代码调用时机
~~2019-07-13 版本 0.5.1 CMPageTitleView中新增-(void)cm_reloadConfig方法，便于用户刷新配置~~
2019-07-13 版本 0.5.2
- CMPageTitleView中新增-(void)cm_reloadConfig方法，便于用户刷新配置；
- 修复0.5.1中的布局bug；修复部分情况下CMPageTitleContentView对象尺寸不准确问题
2019-08-14 版本 0.6.0
- 新增cm_rightView属性
- 使用NSLayoutConstraint优化界面布局
- 优化CMPageTitleConfig类的getter方法，大幅提高三方库性能
- 解决与导航栏侧滑手势冲突的问题
- 修复设置cm_defaultIndex为非0时，界面动画闪动问题
- 新增示例
2019-12-21 版本 0.6.1
- 手动管理childController的生命周期
- 优化rightView展示样式
- 新增childController中跳转逻辑demo
2019-05-10 版本 0.6.2
- 紧急修复iOS10机型标题栏的NSLayoutConstraint偏移问题
2020-06-07 版本 0.7.0
- 新增全屏穿透样式
2020-07-15 版本 0.7.1
- 紧急修复iOS11 在滑动内容视图时,Cell向上偏移的问题
- 适配MJRefresh
2020-10-15 版本 0.7.2
- 适配横竖屏切换
2020-10-29 版本 0.7.3
- 新增 cm_titleTop属性
2020-12-17 版本 0.7.4 * 修复设置 cm_titleTop时,rightview偏移问题

注意

1. UIScrollView、UITableView、UICollectionView 在标题栏切换时，下沉问题 在UIScrollView、UITableView、UICollectionView视图所在的Controller中添加如下代码，（具体可以参考Demo中CMChildTableController.m的第95行）

  if (@available(iOS 11.0, *)) {
        self.tableView.contentInsetAdjustmentBehavior = UIScrollViewContentInsetAdjustmentNever;
    } else {
        self.automaticallyAdjustsScrollViewInsets = NO;
    }

2. 0.7.0版本中新增的全屏穿透样式 全屏穿透样式在使用MJRefresh作为视图的下拉刷新时，透过标题栏是可以看到下拉刷新的布局的，请合理使用。目前暂未想到良好的解决方案，如果你有好的方案，可以提PR

支持

如果觉得该三方库还不错，可以★Star支持一下你的★Star就是我最大的动力
如果发现bug或想有其他的新功能，可以 issue 我

许可

CMPageTitleView 基于MIT许可

CrabMen/CMPageTitleView