THIS PROJECT IS NO LONGER MAINTAINED. HERE ARE SOME SUITABLE ALTERNATIVES:
Bohr allows you to set up a settings screen for your app with three principles in mind: ease, customization and extensibility.
By default, Bohr supports multiple setting types such as strings, booleans or times. However, this framework has been built with extensibility in mind, meaning you can build your own custom classes to support any kind of setting type you want.
Why "Bohr"?
"Bohr" comes from Niels Bohr, conceiver of an atomic model which introduces the concept of electronic configuration, a way to organize electrons by layers around the atom nucleus.
True story.
Installation
Carthage
github "DavdRoman/Bohr"
CocoaPods
pod 'Bohr'
Manual
Drag and copy all files in the Bohr folder into your project.
At a glance
Basic setup
The settings screen you're going to set up is represented by a UITableViewController
subclass called BOTableViewController
. Such controller manages BOTableViewSection
instances, and each one of those manages a set of BOTableViewCell
instances.
Here's an example of a really simple setup included in the demo project. Please check it out to see the full implementation. Please notice the code below belongs inside the setup
method of a subclassed BOTableViewController
.
- (void)setup {
[self addSection:[BOTableViewSection sectionWithHeaderTitle:@"Section 1" handler:^(BOTableViewSection *section) {
[section addCell:[BOSwitchTableViewCell cellWithTitle:@"Switch 1" key:@"bool_1" handler:nil]];
}]];
}
Built-in BOTableViewCell's
There's a bunch of built-in BOTableViewCell
subclasses ready to be used:
BOSwitchTableViewCell
: managesBOOL
values through aUISwitch
control.BOTextTableViewCell
: managesNSString
values through aUITextField
control.BONumberTableViewCell
: managesNSNumber
values through aUITextField
control.BODateTableViewCell
: managesNSDate
values representing a certain date. A revealingUIDatePicker
is used to set the time.BOTimeTableViewCell
: managesNSDate
values representing a certain time. A revealingUIDatePicker
is used to set the time.BOChoiceTableViewCell
: managesNSInteger
values (which you can understand as "options" from aNS_ENUM
) through taps on the cell itself.BOOptionTableViewCell
: manages a singleNSInteger
value (which you can understand as an "option" from aNS_ENUM
), by default depending on its position in its table view section but the setting value can be overridden. When selected, a checkmark appears on the right side.BOButtonTableViewCell
: allows the user to perform an action when the cell is tapped.BOStepperTableViewCell
: allows the user to change numeric values by tapping on a +- control.
Subclassing BOTableViewCell
Building a BOTableViewCell
subclass is fairly straightforward.
First of all, the framework contains a header file called BOTableViewCell+Subclass.h
. You must import that header in your subclass implementation file:
#import <Bohr/BOTableViewCell+Subclass.h>
That way you'll be able to access all the possible elements for you to implement in your subclass.
Please take a look to some of the built-in cells for a more detailed demonstration on how to subclass BOTableViewCell
.
License
Bohr is available under the MIT license.