CrabMen / Cmpagetitleview

• 效果展示

  • 效果展示 - 基本样式
  • 效果展示 - 组合
  • 效果展示 - 其他样式

• 安装

• 示例

• 支持的配置

• 版本记录

• 支持

• 许可

效果展示

效果展示 - 基本样式

基本样式	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;

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

支持的配置

注意： 倘若需要复杂效果，可以通过创建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许可