BEMCheckBox

BEMCheckBox is modeled after UISwitch. To use it, first import the header in your view controller:

#import "BEMCheckBox.h"

Programmatic Initialization

Initialize the checkbox in your implementation (e.g., viewDidLoad):

BEMCheckBox *myCheckBox = [[BEMCheckBox alloc] initWithFrame:CGRectMake(0, 0, 50, 50)];
[self.view addSubview:myCheckBox];

Interface Builder Initialization

1. Drag a UIView into your UIViewController.
2. Change the class of the UIView to BEMCheckBox.
3. Use the Attributes Inspector to configure customizable properties.

You can install BEMCheckBox using several dependency managers or manually:

• Swift Package Manager: Add https://github.com/Boris-Em/BEMCheckBox as a dependency in your Package.swift or via Xcode's 'Add Package Dependency' menu.
• CocoaPods: Add pod 'BEMCheckBox' to your Podfile.
• Carthage: Add the repository to your Cartfile and run carthage update. Drag the resulting BEMCheckBox.framework into your Xcode project.
• Manual Installation: Drag and drop the Classes folder into your Xcode project. Ensure you check the "Copy items into destination group's folder" box.

# CocoaPods
pod 'BEMCheckBox'

You can group multiple BEMCheckBox instances to behave like radio buttons, where only one checkbox in the group can be selected at a time. You can also require that the group always has a selection.

self.group = [BEMCheckBoxGroup groupWithCheckBoxes:@[self.checkBox1, self.checkBox2, self.checkBox3]];
self.group.selectedCheckBox = self.checkBox2; // Optionally set pre-selection
self.group.mustHaveSelection = YES; // If YES, the group must always have one selection

// Get the current selection
BEMCheckBox *selection = self.group.selectedCheckBox;

// Manually update selection
self.group.selectedCheckBox = self.checkBox1;

To respond to checkbox events, conform to the BEMCheckBoxDelegate protocol. It provides two optional methods:

• didTapCheckBox:: Called every time the checkbox is tapped, after the on property is updated but before animations finish.
• animationDidStopForCheckBox:: Called when the checkbox finishes its animation.

Use the on property or the setOn:animated: method to manage the checkbox state.

• on: A boolean property to get or set the state without animation. Defaults to NO.
• setOn:animated:: Sets the state with an optional animation.
• reload: Redraws the entire checkbox while maintaining the current on value.