目录
#AARatingBar
##描述
AARatingBar 是一个简单、轻量且易于使用的评分条,用于在 iOS 中获取和设置评分,使用 Swift 编写。它是一个基于自定义 Storyboard 的 UIView
类,允许在 Storyboard 中进行自定义,无需编写代码。
##演示
要运行示例项目,请克隆仓库,然后首先从 Example 目录运行 pod install
。
##要求
- iOS 8.0+
- Xcode 8.0+
- Swift 3+
安装
AARatingBar
可以使用 CocoaPods、Carthage 或手动方式安装。
##CocoaPods
AARatingBar
通过 CocoaPods 提供。要安装 CocoaPods,运行以下命令:
$ gem install cocoapods
然后创建一个包含以下内容的 Podfile:
source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '8.0'
use_frameworks!
target '<Your Target Name>' do
pod 'AARatingBar'
end
最后,运行以下命令来安装它
$ pod install
##Carthage
要安装 Carthage,请使用 Homebrew 运行以下命令:
$ brew update
$ brew install carthage
然后向您的 Cartfile 添加以下行:
github "EngrAhsanAli/AARatingBar" "master"
然后导入所有使用该库的文件中
import AARatingBar
##手动安装
如果您不想使用上述任何依赖管理器,可以通过将 Classes 文件夹中的文件添加到您的项目中,手动将 AARatingBar
集成到您的项目中。
入门
##创建评分条对象
将UIView
对象从对象库拖动到Storyboard中的UIViewController
中。
##设置视图对象为评分条
在身份检查器中将视图的类设置为AARatingBar
。确保模块属性也设置为AARatingBar
。
##自定义评分条
您可以在属性检查器中自定义评分条的样式。
注意:如果Storyboard中没有显示星星,请从编辑菜单中选择刷新所有视图。
##通过回调函数获取评分
您可以通过ratingDidChange
闭包获取评分的更改。
ratingBar.ratingDidChange = { ratingValue in
// get current selected rating
}
customRatingBar.starFont = UIFont.init(name: "AARatingBar", size: 10)! // sets custom font icon
您可以使用简单的属性
ratingBar.isEmpty
检查评分是否为空。
##设置可选值
您可以使用以下变体
评分选项 | 类型 | 描述 |
---|---|---|
isEnabled |
布尔值 |
评分设置启用 |
canAnimate |
布尔值 |
评分填充动画 |
isEmpty |
布尔值 |
选定的评分是空的 |
isAbsValue |
布尔值 |
精确评分或绝对值 |
filledIcon |
字符串 |
填充星形图标 |
unFilledIcon |
字符串 |
空星形图标 |
value |
CGFloat |
当前评分值 |
color |
UIColor |
评分星星颜色 |
starFont |
UIFont |
评分星星字体图标文件 |
animationInterval |
TimeInterval |
评分更改动画 |
##贡献与许可
AARatingBar
在MIT许可下提供。更多信息请参见LICENSE文件。
欢迎提交拉取请求!最佳贡献将是替换或配置那些在典型应用程序生命周期中会阻塞主线程的类/方法。
如果您的应用程序中使用了AARatingBar
,请发邮件给Engr. Ahsan Ali。