本项目是 Apple 提供的传统 UISwitch 的健壮、纯 Swift、高质量的“直接替换”方案。它派生自 UISwitch，并提供几乎与 UISwitch 相同的 API。

问题在于 UISwitch 是一个大型的、形状相当笨拙的元素。它是“菱形”的，并且始终是水平的，因此在将其安装到 UI 中时可能需要一些创造力。此外，它具有特定的设计美学，并且很难自定义（公平地说，Apple 不鼓励我们自定义任何 UI，所以这并不奇怪）。

如果您使用“标签按钮”（就像我一样）更是如此（运行测试工具即可看到它们的实际效果）。另外，滑块外观似乎要求滑动姿势，而不是点击姿势（这才是我们真正想要的），这也有些“奇怪”。这意味着该姿势还需要一些“心理准备”。 RVS_Checkbox 允许正方形外观和无方向（点击）动作，就像常规复选框一样。

UISwitch 还具有严格的“二进制”动作。如果您有三个选择，则应该使用 UISegmentedControl，这实际上非常合理。 Apple 显然对他们的 UX 进行了大量研究，并且有充分的理由。移动界面充其量只是一种折衷。

很高兴您问了这个问题。 RVS_Checkbox 带有两种“内置”外观：一个默认的圆形复选框，以及一个相当“经典”的外观，它使用内置的 SF Symbols 来模仿 Mac 复选框的显示方式。

图像很简单。它们始终以 “模板”模式渲染，因此它们是“轮廓”，并由控件的色调着色。

此外，RVS_Checkbox 将 Mac 中的“三态”复选框引入 iOS。这意味着可以具有“OFF”、“ON”和“不确定”模式（我称之为“CLEAR”）。默认外观是圆形复选框，默认模式是“二进制”，就像 UISwitch 一样。

“DEFAULT”和“SF SYMBOLS”图像已“烘焙到”类中，而“USER-PROVIDED”图像是在情节提要中添加的三个任意图像（您可以在测试工具中看到这些图像）。

图像将随控件一起调整大小，但会保留其纵横比（纵横比填充模式）。

该模块没有依赖项。如果您要运行测试工具，则还需要加载 RVS_Generic_Swift_Toolbox 项目。同样，使用此软件包不是必需的。仅用于测试工具！

该控件以 Swift Package Manager 软件包的形式提供，并且可以使用 Carthage 进行安装。您也可以简单地将该项目直接从本地存储库拖到您自己的项目中，甚至只需包含单个源文件（我喜欢将这些类型项目的源文件数量保持在最低限度）。

您应该与 SPM 一起包含的存储库是 git@github.com:RiftValleySoftware/RVS_Checkbox.git。

可以通过直接编辑 Package.swift 文件，或使用项目 GUI 添加软件包

步骤 1：在主项目的“Swift Packages”选项卡中，选择“+”按钮以添加软件包。

步骤 2：在弹出的模式屏幕中，输入 GitHub URI：git@github.com:RiftValleySoftware/RVS_Checkbox.git。

步骤 3：输入当前版本（如果您使用了 URI，则已经设置了）。

步骤 4：将软件包添加到您的目标。此时，您只能将软件包添加到单个目标。

如果已经导入了该软件包，您现在可以像任何其他框架一样使用它，并且可以使用“通用”选项卡手动将其添加到任何目标

import RVS_Checkbox

github "RiftValleySoftware/RVS_Checkbox"

然后，打开“终端”并导航到项目目录的顶部，然后在“终端”中输入以下内容

它将在与 Cartfile 相同的级别创建一个名为“Carthage”的目录。在此目录中，将有另一个名为“Checkouts”的目录。在该目录中，将有另一个名为“RVS_Checkbox”的目录。您要进入“Sources/RVS_Checkout”并访问 RVS_Checkbox.swift 文件。将其拖到您的项目中，并将其与您的应用程序构建目标相关联。

您可以直接访问并克隆此代码仓库，或者将其作为Git子模块添加到您的项目中。

如果您这样做，请注意您只需要将**一个**文件添加到您的项目中：RVS_Checkbox.swift文件。

建议您直接将此文件集成到您的项目中，而不是构建一个库。因为它只有一个源文件，直接集成是最简单的方法。

如果直接集成，则无需导入模块。RVS_Checkbox类将直接在模块命名空间中可用。

此自述文件提供了主要的文档，但也有一个代码文档站点，可能对实现RVS_Checkbox有所帮助。

要使用RVS_Checkbox，我们需要在Interface Builder中添加它，或者以编程方式创建实例。

如果我们使用Interface Builder来实现RVS_Checkbox的实例，我们首先在IB中打开我们的视图控制器，然后点击右上角的“+”按钮。

将其拖到视图控制器中（1），并按照您喜欢的方式排列它。然后选择它，并选择“Identity Inspector”选项卡。选择后，输入RVS_Checkbox作为对象类（2）。

如果我们使用Swift Package Manager添加该类，我们应该将“Module”字段设置为“RVS_Checkbox”（3）。否则，我们应该选中“Inherit Module From Target”复选框，并让应用程序模块被选择。

最后，我们应该选择“Properties Inspector”，并将各种可检查的属性设置为我们想要的值。

动态实例化并不困难。只需以与UIView相同的方式创建RVS_Checkbox的实例即可。

/* ################################################################## */
/**
 This sets up the three checkboxes along the bottom of the screen.
 
 We set up a center box, using SF Symbols, then add one to its left, using the default, and one to its right, using some custom images.

 We use programmatic Auto-Layout for this.
 */
func setUpDynamicCheckBoxes() {
    if let dynamicContainer = dynamicContainer {    // Make sure we have the container.
        let gap: CGFloat = 8
        let dynamicControlSize: CGFloat = 64
        let testImageFormat = "TestImage-%d"

        let centerDynamicCheckbox = RVS_Checkbox()  // Create the instance
        dynamicContainer.addSubview(centerDynamicCheckbox)  // Add it to the container.
        centerDynamicCheckbox.backgroundColor = .clear      // Nothing behind us (Just to be sure).
        centerDynamicCheckbox.tintColor = checkboxObject?.tintColor // We steal the tint color from the IB-instantiated checkbox.
        centerDynamicCheckbox.isUsingSFSymbols = true
        centerDynamicCheckbox.isThreeState = true
        centerDynamicCheckbox.translatesAutoresizingMaskIntoConstraints = false

        NSLayoutConstraint.activate([
                                    centerDynamicCheckbox.centerXAnchor.constraint(equalTo: dynamicContainer.centerXAnchor, constant: 0),
                                    centerDynamicCheckbox.widthAnchor.constraint(equalToConstant: dynamicControlSize),
                                    centerDynamicCheckbox.heightAnchor.constraint(equalToConstant: dynamicControlSize)
                                    ])
        
        let leftDynamicCheckbox = RVS_Checkbox()
        dynamicContainer.addSubview(leftDynamicCheckbox)
        leftDynamicCheckbox.backgroundColor = .clear
        leftDynamicCheckbox.tintColor = checkboxObject?.tintColor
        leftDynamicCheckbox.isThreeState = true
        leftDynamicCheckbox.translatesAutoresizingMaskIntoConstraints = false
        
        NSLayoutConstraint.activate([
                                    leftDynamicCheckbox.trailingAnchor.constraint(equalTo: centerDynamicCheckbox.leadingAnchor, constant: -gap),
                                    leftDynamicCheckbox.widthAnchor.constraint(equalToConstant: dynamicControlSize),
                                    leftDynamicCheckbox.heightAnchor.constraint(equalToConstant: dynamicControlSize)
                                    ])
        
        let rightDynamicCheckbox = RVS_Checkbox()
        dynamicContainer.addSubview(rightDynamicCheckbox)
        rightDynamicCheckbox.backgroundColor = .clear
        rightDynamicCheckbox.tintColor = checkboxObject?.tintColor
        rightDynamicCheckbox.offImage = UIImage(named: String(format: testImageFormat, 0))
        rightDynamicCheckbox.clearImage = UIImage(named: String(format: testImageFormat, 1))
        rightDynamicCheckbox.onImage = UIImage(named: String(format: testImageFormat, 2))
        rightDynamicCheckbox.isThreeState = true
        rightDynamicCheckbox.translatesAutoresizingMaskIntoConstraints = false
        
        NSLayoutConstraint.activate([
                                    rightDynamicCheckbox.leadingAnchor.constraint(equalTo: centerDynamicCheckbox.trailingAnchor, constant: gap),
                                    rightDynamicCheckbox.widthAnchor.constraint(equalToConstant: dynamicControlSize),
                                    rightDynamicCheckbox.heightAnchor.constraint(equalToConstant: dynamicControlSize)
                                    ])
    }
}

上面的代码片段直接取自Test Harness项目。它展示了我们如何在屏幕底部创建三个动态实例化的复选框。

这是复选框的默认操作。它有两种状态：OFF或ON（值为0或1）。

如果我们将useThreeState复选框选项设置为ON，则控件有三种状态：OFF (-1)，CLEAR (0) 和 ON (1)。CLEAR可以用作“不确定”状态，并且在连续驱动控件时（OFF-CLEAR-ON或ON-CLEAR-OFF），在其他两种状态之间选择。

如果此选项为ON（默认为OFF），则控件将显示近似于Mac复选框的图像。

如果选择了此项，则忽略“Use OFF Image for CLEAR”选项（因为Mac复选框有一种特定的工作方式，并且它们已经这样做了）。

如果选择此项（默认为OFF），那么，在默认外观或自定义图像外观中，用于三态“OFF”状态的图像将用于两态“CLEAR”（也为OFF）。

默认情况下，控件使用与UISwitch相同的微妙触感反馈。如果关闭此选项，则不使用触感反馈。

即使开启此选项，以编程方式设置值时也不会使用触感反馈。

复选框始终处于某种状态：OFF、CLEAR或ON。如果在两态模式下，则OFF和CLEAR是同义词。

可以通过checkboxState属性（使用RVS_Checkbox.States枚举），或者通过value属性（使用整数-1、0或1）来访问状态。您可以修改其中任何一个，控件都会改变其状态*（**注意：**以编程方式更改控件状态不会发送操作消息或触发触感反馈）*

value属性允许您以数字方式影响控件状态。负数将为OFF（或CLEAR，如果在两态模式下）。0为CLEAR，正数为ON。

它也不支持Mac Catalyst的Mac风格复选框功能。这将在Mac Catalyst中工作，但与在iOS中完全相同的方式。

虽然不是实现RVS_Checkbox所必需的，但Test Harness App对于演示其功能并为使用该控件提供指导非常有用。

强烈建议，如果您对RVS_Checkbox的实现有任何疑问或疑虑，请首先运行测试工具并检查其代码库。

该应用程序本身非常简单。它是一个单屏幕iOS应用程序，可在iPod、iPhone和iPad上运行。

除了框架目标（RVS_Checkbox）之外，还有四个应用程序目标。所有目标都共享源代码，但Direct和Carthage目标除外。它们使用相同的源代码，但使用单独的情节提要。这是因为它们对RVS_Checkbox的实现直接编译到应用程序中，因此没有单独的模块。

此目标直接将RVS_Checkbox.swift文件导入到项目中，没有包管理器或库/框架。该文件在应用程序命名空间中编译。

此目标使用内置的 RVS_Checkbox 动态框架目标来构建框架，并将该动态库导入到项目中。

根据不同的目标，RVS_Checkbox 框架/源文件可能是一个依赖项。

RVS_Checkbox

简介

解决了什么问题？

那么，问题是什么？

为什么 RVS_Checkbox 可以解决这个问题？

要求

依赖项

安装

Swift Package Manager

直接将软件包添加到单个目标

将软件包添加到另一个目标

包含软件包或库之后

Carthage

直接访问 GitHub 仓库

文档

用法

设置

Interface Builder

动态实例化

选项

三态（默认关闭）

两态（默认）

三态

使用SF Symbols（默认关闭）

将OFF图像用于CLEAR（默认关闭）

使用触感反馈 (默认开启)

图像

OFF图像

CLEAR图像

ON图像

复选框状态

不支持

测试应用

应用程序构建目标

RVS_Checkbox_Test_Harness (Direct)

RVS_Checkbox_Test_Harness (Framework)

RVS_Checkbox_Test_Harness (SPM)

RVS_Checkbox_Test_Harness (Carthage)

应用程序运行方案

依赖关系和要求

	默认	SF 符号	用户提供
开
关
清除