WKVerticalScrollBar 0.3.3

WKVerticalScrollBar 0.3.3

测试已测试
语言语言 Obj-CObjective C
许可 MIT
发布最后一次发布2014年12月

未声明的所有人 维护。



  • 编者:
  • Brad Taylor

WKVerticalScrollBar in repose WKVerticalScrollBar in action with optional accessory view

一个传统的 iOS 滚动条,可以与现有的 UIScrollView 或 UIScrollView 子类集成。

WKScrollBar 在 UIScrollView 顶部绘制一个持久的滚动条手柄。当被点击并拖动时,WKScrollBar 会按比例移动到屏幕上的位置。这对于展示长列表的项目(如 UITextViewUITableViewAQGridView 等)的 App 来说很有用,因为它使得轻松导航到列表中的任何位置变得简单。

安装

手动

WKVerticalScrollBar.hWKVerticalScrollBar.m 复制到您的项目中。确保您已经将项目链接到 QuartzCore.framework

使用

WKVerticalScrollBar 旨在快速集成使用 UIScrollView 或其子类如 AQGridView 的项目。开始使用很简单

  1. 在 IB 或您的方法 -init 中创建 WKVerticalScrollBar 实例。
  2. WKVerticalScrollBar 添加到父 UIView 中,确保它是最前面的 UIView,无论是通过将其添加到最后,还是通过 -bringSubviewToFront:
  3. 调整 WKVerticalScrollBar 的大小,使其与它将要管理的 UIScrollView 具有相同区域。
  4. 通过 -setScrollView: 告诉 WKVerticalScrollBar 它将要管理的 UIScrollView

外观

可以通过以下方法修改 WKScrollBar 的外观

  • -setHandleColor:forState

    UIControlStateNormalUIControlStateSelected 设置颜色,以控制手柄的正常和选中(手指按下)颜色。

    默认值: UIControlStateNormal:40% 黑色,UIControlStateSelected:60% 黑色

  • -setHandleWidth

    设置正常状态下的手柄宽度。

    默认:5pt。

  • -setHandleSelectedWidth

    设置选中时手柄的宽度。这允许在手柄上有用户手势时扩大手柄。

    默认:15pt。

  • -setHandleHitArea

    设置手柄的点击区域宽度。这将允许您的控件比视觉上展示的有更大的点击区域。Apple 的 iOS 人类界面指南建议设置为 44pt。

    默认:44pt。

  • -setHandleMinimumHeight

    设置手柄的最小高度。

    手柄的高度是基于 contentOffsetframe 的比例计算的。如果 contentOffset 太大,手柄可能会太小,不方便触摸。使用此参数确保保留最小手柄大小。

  • -setHandleCornerRadius:-setHandleSelectedCornerRadius:

    设置手柄在正常和选中模式的圆角。

贡献

欢迎任何想为项目贡献力量的人。基本上,只需几个步骤就可以开始

  1. 在此仓库上创建分支
  2. 进行您的更改
  3. 将您自己添加到AUTHORS文件并提交拉取请求!

版权和许可

WKVerticalScrollBar版权所有(c)2012 litl, LLC,并受MIT许可的许可。有关完整详细信息,请参阅LICENSE文件。