综合编程

每个APP都用得上的SegmentedView(Swift版本)

微信扫一扫,分享到朋友圈

每个APP都用得上的SegmentedView(Swift版本)
0

Logo

腾讯新闻、今日头条、QQ音乐、网易云音乐、京东、爱奇艺、腾讯视频、淘宝、天猫、简书、微博等所有主流APP分类切换滚动视图

与其他的同类三方库对比的优点:

  • 指示器逻辑面向协议编程(Protocol Oriented Programming),可以为所欲为的扩展指示器效果;
  • 提供更加全面丰富效果,几乎支持所有主流APP效果;
  • 使用子类化管理cell样式,逻辑更清晰,扩展更简单;

Github地址

下载源码,一睹为快!

JXSegmentedView

效果预览

指示器效果预览

说明 Gif
Line固定宽度

image

Line与cell等宽

image

Line延长

image

Line延长+偏移

image

RainbowLine:rainbow:彩虹

image

DotLine点线

image

DoubleLine双线

image

Triangle三角形底部

image

Triangle三角形顶部

image

Background椭圆形

image

Background椭圆形+阴影

image

Background遮罩有背景

image

Background遮罩无背景

image

Background渐变色

(渐变是固定的)

image

Gradient渐变色

(渐变随着位置变动)

image

Image底部

image

Image背景

image

混合使用

image

以下指示器支持上下位置切换:

JXSegmentedIndicatorLineViewJXSegmentedIndicatorRainbowLineViewJXSegmentedIndicatorDotLineViewJXSegmentedIndicatorDoubleLineViewJXSegmentedIndicatorTriangleViewJXSegmentedIndicatorImageView

Cell样式效果预览

说明 Gif
颜色渐变

image

文字渐变

image

大小缩放

image

大小缩放+字体粗细

image

大小缩放+点击动画

image

大小缩放+cell宽度缩放

image

TitleImage_Top

image

TitleImage_Left

image

TitleImage_Bottom

image

TitleImage_Right

image

TitleImage_只有图片

image

TitleOrImage(高仿腾讯视频)

image

数字

image

红点

image

多行富文本

image

多种cell混用

image

特殊效果预览

说明 Gif

数据源过少

isItemSpacingAverageEnabled为true

image

数据源过少

isItemSpacingAverageEnabled为false

image

SegmentedControl

参考 SegmentedControlViewController

image

导航栏使用

参考 NaviSegmentedControlViewController

image

嵌套使用

参考 NestViewController

image

个人主页(上下左右滚动、header悬浮)

参考 PagingViewController

更多样式请点击查看 JXPagingView库

image

数据加载&刷新

参考 LoadDataViewController

image

要求

  • iOS 8.0+
  • Xcode 9+
  • Swift 4.2

安装

手动

Clone代码,把Sources文件夹拖入项目,就可以使用了;

CocoaPods

target '<Your Target Name>' do
    pod 'JXSegmentedView'
end

先执行 pod repo update ,再执行 pod install

使用

JXSegmentedView 使用示例

1.初始化JXSegmentedView

self.segmentedView = JXSegmentedView()
self.delegate = self
self.view.addSubview(self.segmentedView)

2.初始化dataSource

dataSouce 类型为 JXSegmentedViewDataSource 协议。使用单独的类实现 JXSegmentedViewDataSource 协议,实现代码隔离。选择不同的类赋值给 dataSource ,就可以控制 JXSegmentedView 显示效果,实现插件化。比如选择 JXSegmentedTitleImageDataSource 类作为 dataSource 就选择了文字图片的显示效果;选择 JXSegmentedNumberDataSource 类作为 dataSource 就选择了文字加数字的显示效果;

//segmentedDataSource一定要通过属性强持有,不然会被释放掉
self.segmentedDataSource = JXSegmentedTitleDataSource()
//配置数据源相关配置属性
self.segmentedDataSource.titles = ["猴哥", "青蛙王子", "旺财"]
self.segmentedDataSource.isTitleColorGradientEnabled = true
//reloadData(selectedIndex:)方法一定要调用,方法内部会刷新数据源数组
self.segmentedDataSource.reloadData(selectedIndex: 0)
//关联dataSource
self.segmentedView.dataSource = self.segmentedDataSource

3.初始化指示器indicator

let indicator = JXSegmentedIndicatorLineView()
indicator.indicatorWidth = 20
self.segmentedView.indicators = [indicator]

4.实现 JXSegmentedViewDelegate 代理

//点击选中或者滚动选中都会调用该方法。适用于只关心选中事件,而不关心具体是点击还是滚动选中的情况。
func segmentedView(_ segmentedView: JXSegmentedView, didSelectedItemAt index: Int) {}

// 点击选中的情况才会调用该方法
func segmentedView(_ segmentedView: JXSegmentedView, didClickSelectedItemAt index: Int) {}

// 滚动选中的情况才会调用该方法
func segmentedView(_ segmentedView: JXSegmentedView, didScrollSelectedItemAt index: Int) {}

// 正在滚动中的回调
func segmentedView(_ segmentedView: JXSegmentedView, scrollingFrom leftIndex: Int, to rightIndex: Int, percent: CGFloat) {}

contentScrollView 列表容器使用示例

直接使用 UIScrollView 自定义使用示例

因为代码比较分散,而且代码量也比较多,所有不推荐使用该方法。要正确使用需要注意的地方比较多,尤其对于刚接触iOS的同学来说不太友好。

不直接贴代码了,具体点击 LoadDataCustomViewController 查看源代码了解。

作为替代,官方使用&强烈推荐使用下面这种方式:point_down::point_down::point_down:。

配合 JXSegmentedListContainerView 封装类使用示例

JXSegmentedListContainerView 是对列表视图高度封装的类,具有以下优点:

UIScrollView

1.初始化 JXSegmentedListContainerView

self.listContainerView = JXSegmentedListContainerView(dataSource: self)
self.view.addSubview(self.listContainerView)
//关联cotentScrollView,关联之后才可以互相联动!!!
self.segmentedView.contentScrollView = self.listContainerView.scrollView

2.实现 JXSegmentedListContainerViewDataSource 代理方法

//返回列表的数量
func numberOfLists(in listContainerView: JXSegmentedListContainerView) -> Int {
    return self.segmentedDataSource.titles.count
}
//返回遵从`JXSegmentedListContainerViewListDelegate`协议的实例
func listContainerView(_ listContainerView: JXSegmentedListContainerView, initListAt index: Int) -> JXSegmentedListContainerViewListDelegate {
    return ListBaseViewController()
}

3.列表实现 JXSegmentedListContainerViewListDelegate 代理方法

不管列表是UIView还是UIViewController都可以,提高使用灵活性,更便于现有的业务接入。

/// 如果列表是VC,就返回VC.view
/// 如果列表是View,就返回View自己
/// - Returns: 返回列表视图
func listView() -> UIView {
    return view
}

//可选使用,列表显示的时候调用
func listDidAppear() {}

//可选使用,列表消失的时候调用
func listDidDisappear() {}

4.将关键事件告知 JXSegmentedListContainerView

在下面两个 JXSegmentedViewDelegate 代理方法里面调用对应的代码,一定不要忘记这一条:exclamation:️:exclamation:️:exclamation:️

func segmentedView(_ segmentedView: JXSegmentedView, didClickSelectedItemAt index: Int) {
    //传递didClickSelectedItemAt事件给listContainerView,必须调用!!!
    listContainerView.didClickSelectedItem(at: index)
}

func segmentedView(_ segmentedView: JXSegmentedView, scrollingFrom leftIndex: Int, to rightIndex: Int, percent: CGFloat) {
    //传递scrolling事件给listContainerView,必须调用!!!
    listContainerView.segmentedViewScrolling(from: leftIndex, to: rightIndex, percent: percent, selectedIndex: segmentedView.selectedIndex)
}

具体点击 LoadDataViewController 查看源代码了解

使用总结

因为 JXSegmentedView 本身支持许多特性:指示器、cell样式、列表容器等,如何有序管理好代码成了一个难题。借助于协议、继承、封装类极大的简化了使用难度,而且提高了灵活性,扩展相当容易。

  • 核心主类: JXSegmentedView
  • 数据源&cell样式定制类:遵从 JXSegmentedViewDataSource 协议的类
  • 指示器类:遵从 JXSegmentedIndicatorProtocol 协议的 UIView
  • 列表容器:官方推荐 JXSegmentedListContainerView 类,特殊情况可以使用 UIScrollView 自定义

指示器样式自定义

  • 需要继承 JXSegmentedIndicatorProtocol 协议,点击参看 JXSegmentedIndicatorProtocol
  • 提供了继承 JXSegmentedIndicatorProtocol 协议的基类 JXSegmentedIndicatorBaseView ,里面提供了许多基础属性。点击参看 JXSegmentedIndicatorBaseView
  • 自定义指示器,请参考已实现的指示器视图,多尝试、多思考,再有问题请提Issue或加入反馈QQ群

dataSource和Cell自定义

  • 需要继承 JXSegmentedViewDataSource 协议,点击参看 JXSegmentedViewDataSource
  • 提供了继承 JXSegmentedViewDataSource 协议的基类 JXSegmentedBaseDataSource ,里面提供了许多基础属性。点击参看 JXSegmentedBaseDataSource
  • 任何自定义需求,dataSource、cell、itemModel三个都要子类化。即使某个子类cell什么事情都不做。用于维护继承链,以免以后子类化都不知道要继承谁了;
  • dataSource和Cell自定义,请参考已实现的dataSource,多尝试、多思考,再有问题请提Issue或加入反馈QQ群

常用属性说明

常用属性说明文档地址

其他使用注意事项

其他使用注意事项文档地址

补充

该仓库保持及时更新,对于主流新的分类选择效果会第一时间支持。使用过程中,有任何建议或问题,可以通过以下方式联系我:</br>

邮箱: 317437084@qq.com </br>

QQ群: 112440276

image

Github地址

下载源码,一睹为快!

JXSegmentedView

阅读原文...


简书

著名分析师Ben Thompson:从Spotify进军播客,谈音乐流媒体如何转型

上一篇

第88节:Java中的Ajax和ASP.NET和TCP/IP 教程和JSON

下一篇

您也可能喜欢

评论已经被关闭。

插入图片
每个APP都用得上的SegmentedView(Swift版本)

长按储存图像,分享给朋友