Skip to content

Latest commit

 

History

History
executable file
·
118 lines (92 loc) · 6.41 KB

README.md

File metadata and controls

executable file
·
118 lines (92 loc) · 6.41 KB
Raw

NewsChannel

Ready

新闻频道栏（网易新闻，新浪新闻，搜狐新闻，今日头条，聚划算，腾讯视频，优酷等类似的频道栏）

支持小红点标识 && 懒加载 && 缓存 && 排序 && 增删等。

一言不合就上图

   

Function Description

  1. 单个频道小红点标识：JhtNewsChannelItemModel中isShowRedPoint为BOOL值，在生成频道栏数据Model时可以一起添加频道是否有小红点标识，在后续调接口设置小红点状态依旧照前述可以实现；
  2. 懒加载：页面不会全部加载（非scrollview），点击或者滑动到哪里加载相应页面，同时可以自己设置缓存的个数；
  3. 频道位置固定：可以设置单个或多个频道位置不可变动；
  4. 频道栏排序：可以在排序界面进行自定义排序（会有颤抖提示）；
  5. 频道增删：可以在排序界面进行自定义的增删频道，同时囊括排序功能；
  6. 说明：排序或者增删之后的相应页面均可在缓存中找到！

GO

How to use

1. podfile

platform:ios, '8.0'

target '*****' do

pod 'JhtNewsChannel'
        
end

2. 个性化设置

 a. JhtNewsChannelItemModel：顶部频道Model，你可以继承这个model，来扩展满足自己需求的model；
 b. JhtChannelBarAndSlideViewConnectParamModel：用于切换频道栏界面中相关设置参数model，包含尾部加号按钮 && 颜色和字号 && 间距和坐标 && 缓存页数 等相关设置；
 c. JhtChannelBarAndSlideViewConnectParamModel中的属性notMoveNameArray（不能移动频道的名字数组）设置频道位置固定, toAddItemArray（用于存储JhtNewsChannelItemModel）属性用于设置待添加的频道数组；
 d. JhtNewsChannelItemEditParamModel：用于排序界面中相关设置参数model，包含文字 && 文字颜色 && 距离 && 背景颜色 类等相关设置。
 e. JhtChannelBarAndSlideViewConnectParamModel和JhtNewsChannelItemEditParamModel结构如下图
 

  • 注：model内部均注有required/optional区分标识
      1. required：必要参数，需要进行相关传递
      2. optional：个性化配置参数，内部均有相应默认值

3. 建立滑频道条和可滑动的view：相关个性化设置均由传递的Model中参数实现

/** 创建ChannelBarAndSliderView和排序删除界面
 *  barAndSlideModel：用于设置sliderView和bar参数model（为了容错，含有部分属性默认值）
 *  itemEditModel：用于排序界面的参数设置（为了容错，含有部分属性默认值）
 *  channelArray：已经添加的频道数组 存储JhtNewsChannelItemModel (必要参数，并且是存储JhtNewsChannelItemModel的数组)
 *  baseViewController：所处于的VC
 *  sortFView：排序界面放入的父view
 *  titleArray：所有的名字数组
 *  delegate：代理
 */
- (id)initSlideViewAndItemEditViewWithBarAndSlideModel:(JhtChannelBarAndSlideViewConnectParamModel *)barAndSlideModel withNewsChannelItemEditModel:(JhtNewsChannelItemEditParamModel *)itemEditModel withChanelArray:(NSMutableArray *)channelArray withBaseViewController:(id)baseViewController withSortFView:(UIView *)sortFView withTitleArray:(NSArray *)titleArray withDelegte:(id<JhtTotalSlideViewDelegate>)delegate;

4. JhtTotalSlideViewDelegate 方法

@protocol JhtTotalSlideViewDelegate <NSObject>
/** VC总数量 */
- (NSInteger)numberOfTabsInJhtTotalSlideView:(JhtTotalSlideView *)sender;
/** 当前index下的VC */
- (UIViewController *)JhtTotalSlideView:(JhtTotalSlideView *)sender controllerAt:(NSInteger)index;

/** 点击VC的index */
- (void)JhtTotalSlideView:(JhtTotalSlideView *)sender didSelectedAt:(NSInteger)index;

/** 排序之后的操作
 *  modelArr：model数组
 *  nameArray：名字数组
 *  selectedIndex：选中的index
 */
- (void)JhtTotalSlideViewWithSortModelArr:(NSArray *)modelArr withNameArray:(NSArray *)nameArray withSelectIndex:(NSInteger)selectedIndex;

5. JhtChannelBarAndSlideViewConnect 方法

 a. 判断频道栏尾部按钮是否可以被点击

/** 判断频道栏尾部按钮是否可以被点击
 *  enable:yes可以被点击 
 */
- (void)judgeChannelBarTailBtnIsEnableClick:(BOOL)enable;

 b. 隐藏或者出现小红点

/** 隐藏或者出现小红点
 *  hidden：yes隐藏
 *  index：topBar 中频道栏的index
 */
- (void)redPonitIsHidden:(BOOL)hidden withIndex:(NSInteger)index;

6. 修改SDK切图资源

 如需替换SDK中的切图资源可以直接将JhtNewsChannelImages.bundle中的切图同名替换即可

  • 注：1. 对一些用户反馈的缓存疑惑统一解释一下，上面提到的缓存指的是，创建频道下的VC后且app未重启的情况下，进行频道编辑后，内部会优先使用之前创建的VC，假使不存在会重新创建新VC
      2. 假使你想做频道编辑后的持久化存储可以在以下方法中实现

    3. 在demo中可以查看相关的使用和配置方法
    4. 最后，感谢大家长久以来的支持！

Remind

  • ARC
  • iOS >= 7.0
  • iPhone \ iPad

Hope

  • If you find bug when used，Hope you can Issues me，Thank you or try to download the latest code of this framework to see the BUG has been fixed or not
  • If you find the function is not enough when used，Hope you can Issues me，I very much to add more useful function to this framework ，Thank you !