VerticalSteppedSlider 0.1.0

VerticalSteppedSlider 0.1.0

×

测试已测试✓
语言语言 SwiftSwift
许可证 MIT
发布最后发布2017年10月
SwiftSwift 版本4.0
SPM支持 SPM✗

由 Mel Ludowise 维护。

VerticalSteppedSlider 0.1.0

  • 由
  • Mel Ludowise




简介

VerticalSteppedSlider 是一个完全可配置的 iOS 滑块，用 Swift 编写。配置自定义轨道宽度、颜色或图像，设置步进值的大小以及垂直方向。

示例

animated demo

要运行示例项目，请克隆仓库，并首先从示例目录中运行 pod install。

安装

VerticalSteppedSlider 通过 CocoaPods 提供。要安装，只需将以下行添加到您的 Podfile 中。

pod 'VerticalSteppedSlider'

使用方法

首先，导入 VerticalSteppedSlider。

import VerticalSteppedSlider

初始化

创建 VSSlider 有两种方法

  • 在故事板中，将 UIView 的类改为 VSSlider，并将模块设置为 VerticalSteppedSlider。
  • 在代码中使用 init(frame:CGRect)

使用增量

属性 increment 决定在滑块上绘制标记的位置，并会在滑动滑块后四舍五入到最近的增量的值。

例如，如果最小值是 -1，最大值是 1，增量是 0.5，则将在 -0.5、0 和 0.5 处绘制标记。同样，滑动滑块时，滑块只允许 -1、-0.5、0、0.5 和 1 的值。

自定义滑块的外观

如果您想更改轨道和指针的颜色，您可以使用 `minimumTrackTintColor`、`maximumTrackTintColor`、`markColor` 和 `thumbTintColor` 属性为滑块的轨道和指针设置自定义的着色颜色。您还可以使用 `trackWidth` 和 `markWidth` 指定轨道的厚度和增量标记的重量。默认情况下，最小轨道着色颜色取决于滑块控制的着色颜色。

您还可以通过指定用于绘制指针和轨道的图像来更精细地控制滑块的外观。

属性 `trackExtendsUnderThumb` 决定轨道的长度。默认情况下，滑块轨道在 minimumValue 和 maximumValue 之前和之后扩展，以便使指针与滑块的起始和结束对齐。这符合 Apple 的 UISlider 的默认行为。为了关闭此行为并查看更精确的滑块，将 `trackExtendsUnderThumb` 设置为 false。

属性

主题 属性 描述 类型 默认值
访问滑块的值 value 滑块的当前原始值，未四舍五入到最接近的增量。有关更多信息，请参阅 UISlider.value。 Float 0
roundedValue 计算属性，返回四舍五入到最接近的增量的值。 Float
访问滑块的值限制 minimumValue 查阅更多关于UISlider.minimumValue的信息。 Float 0
最大值 查阅更多关于UISlider.maximumValue的信息。 Float 1
增量 滑动条的步进增量。如果滑动条应平滑，不四舍五入到最近的增量，则设置为0。 Float 0.5
修改滑动条的行为 isContinuous 一个布尔值，表示滑动条的值变化是否生成连续的更新事件。查阅 UISlider.isContinuous. 布尔值 true
更改滑动条的外观 vertical 如果滑动条的方向应为垂直还是水平。 布尔值 true
ascending ascent 通常定义为
  • 当水平时左到右的本地化布局中的最小值在左，最大值在右。
  • 当水平时右到左的本地化布局中的最小值在右，最大值在左。
  • 当垂直的最小值在顶部，最大值在底部
 布尔值 false
trackWidth 滑动条轨道的厚度（以点为单位）。 CGFloat 2
trackExtendsUnderThumb 定义轨道是否应略微宽于其最小值和最大值，以容纳滑动条拇指的宽度。值 "true" 重复 UISlider 的行为，但增量标记将显示为有更多空间在第一个和最后一个标记之间以及滑动条的两端。 布尔值 true
markWidth 滑动条增量标记的厚度（以点为单位）。 CGFloat 1
markColor 滑动条标记的颜色。 UIColor darkGray
minimumTrackTintColor 用于染色默认最小轨道图像的颜色。如果 minimumTrackImage 非空，则忽略。查阅 UISlider.minimumTrackTintColor 获取更多信息。 UIColor? nil
minimumTrackImage 为指定的控制状态分配最小轨道图像。设置此图像时，会在内部 UISlider 上调用 setMinimumTrackImage()。如果非空，则覆盖 minimumTrackTintColor。查阅 Apple的自定义滑动条外观 获取更多信息。 UIImage? nil
maximumTrackTintColor 用于染色默认最大轨道图像的颜色。如果 minimumTrackImage 非空，则忽略。查阅 UISlider.maximumTrackTintColor 获取更多信息。 UIColor? nil
maximumTrackImage 为指定的控制状态分配最大轨道图像。设置此图像时，会在内部 UISlider 上调用 setMaximumTrackImage()。如果非空，则覆盖 maximumTrackTintColor。查阅 Apple的自定义滑动条外观 获取更多信息。 UIImage? nil
thumbTintColor 用于染色默认拇指图像的颜色。如果 thumbImage 非空，则忽略。查阅 UISlider.thumbTintColor 获取更多信息。 UIColor? nil
thumbImage 为指定的控制状态分配拇指图像。如果非空，则覆盖 thumbTintColor。查阅 Apple的自定义滑动条外观 获取更多信息。 UIImage? nil

许可证

VerticalSteppedSlider 在 MIT 许可证下可用。查阅 LICENSE 文件以获取更多信息。