CheckmarkView - iOS
适用于 iOS 的像素完美的勾选视图,适用于任何您想要的尺寸
屏幕截图
要求
- iOS 11.0+
- Xcode 10.0+
安装
依赖管理器
CocoaPods
CocoaPods 是 Cocoa 项目的依赖管理器,您可以按照以下命令安装它
$ gem install cocoapods
要在使用 CocoaPods 的 Xcode 项目中集成 CheckmarkView,在您的 Podfile
中指定它
source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '10.0'
use_frameworks!
pod 'CheckmarkView-iOS', '~> 0.0.3'
然后,运行以下命令
$ pod install
Carthage
Carthage 是一个去中心化的依赖管理器,可自动化将框架添加到您的 Cocoa 应用程序的过程。
您可以使用以下命令通过 Homebrew 安装 Carthage
$ brew update
$ brew install carthage
要使用 Carthage 将 CheckmarkView 集成到您的 Xcode 项目中,请在您的 Cartfile
中指定它
github "BeeWise/CheckmarkView-iOS" ~> 0.0.3
Swift 包管理器
要将 CheckmarkView 作为 Swift 包管理器 包使用,只需在您的 Package.swift 文件中添加以下内容。
// swift-tools-version:5.0
import PackageDescription
let package = Package(
name: "HelloCheckmarkView",
dependencies: [
.package(url: "https://github.com/BeeWise/CheckmarkView-iOS.git", .upToNextMajor(from: "0.0.3"))
],
targets: [
.target(name: "HelloCheckmarkView", dependencies: ["CheckmarkView"])
]
)
手动
如果您不希望使用上述任一依赖管理器,您可以将 CheckmarkView 手动集成到项目中。
Git 子模块
- 在终端中,使用
cd
命令进入您的顶级项目目录,如果您的项目尚未初始化为 Git 仓库,则运行以下命令
$ git init
- 使用以下命令将 CheckmarkView 作为 Git 子模块 添加
$ git submodule add https://github.com/BeeWise/CheckmarkView-iOS.git
$ git submodule update --init --recursive
-
打开新的
CheckmarkView
文件夹,将CheckmarkView.xcodeproj
拖放到您应用程序的 Xcode 项目的 Project Navigator 中。它应该出现在您应用程序蓝色项目图标下方。它是在所有其他 Xcode 组之上还是之下无关紧要。
-
在 Project Navigator 中选择
CheckmarkView.xcodeproj
,并验证部署目标与您的应用程序目标匹配。 -
接下来,在 Project Navigator 中(蓝色项目图标)选择您的应用程序项目,导航到目标配置窗口,并在侧边栏的“Targets”标题下选择应用程序目标。
-
在窗口顶部的选项卡栏中,打开“General”面板。
-
在“Embedded Binaries”部分下面单击
+
按钮。 -
您将看到两个不同的
CheckmarkView.xcodeproj
文件夹,每个文件夹内部都有一个不同的CheckmarkView.framework
版本,嵌套在Products
文件夹中。您选择哪个
Products
文件夹都无关紧要。 -
选择
CheckmarkView.framework
。 -
就这样!
CheckmarkView.framework
将自动添加为目标依赖关系,链接框架和嵌入式框架,在复制文件构建阶段,这正是您在模拟器和设备上构建所需的内容。
嵌入二进制文件
- 从 https://github.com/BeeWise/CheckmarkView-iOS/releases 下载最新版本。
- 接下来,在 Project Navigator 中(蓝色项目图标)选择您的应用程序项目,导航到目标配置窗口,并在侧边栏的“Targets”标题下选择应用程序目标。
- 在窗口顶部的选项卡栏中,打开“General”面板。
- 在“Embedded Binaries”部分下面单击
+
按钮。 - 添加下载的
CheckmarkView.framework
。 - 就这样!
使用
创建 CheckmarkView 很简单。您可以在代码中以编程方式或在 XIB 中完成。您可以创建三种类型的勾选标记:variant1
、variant2
和 variant3
。不同版本之间的区别与勾选标记的绘制点相关。查看截图以了解所有类型的勾选标记。通过控制 isChecked
属性来完成勾选或取消勾选。
let checkmarkView = CheckmarkView()
checkmarkView.checkmarkColor = UIColor.white // default is clear
checkmarkView.checkmarkWidth = 5 // default is 3
checkmarkView.checkmarkCapStyle = .round // default is .butt
checkmarkView.checkmarkJoinStyle = .round // default is .miter
checkmarkView.checkmarkType = CheckmarkView.checkmarkType.variant1.rawValue // default is 0 (variant1)
checkmarkView.checkedFillColor = UIColor.blue // default is clear
checkmarkView.uncheckedFillColor = UIColor.white // default is clear
checkmarkView.borderWidth = 5 // default is 3
checkmarkView.checkedBorderColor = UIColor.white // default is clear
checkmarkView.uncheckedBorderColor = UIColor.white // default is clear
checkmarkView.isChecked = true // default is false
贡献
欢迎问题和 Pull 请求!
作者
许可证
CheckmarkView已在MIT许可证下发布。有关详细信息,请参阅LICENSE。