This pod provides a view controller for choosing and creating tags in the style of wordpress or tumblr. This tag picker was originally used in the Intrepid Pursuits app, Slate.
As used in Slate:
From example project:
PARTagPicker is available through CocoaPods. To install it, simply add the following line to your Podfile:
pod 'PARTagPicker'
To run the example project, clone the repo, and run pod install
from the PRTagPicker directory first.
Include #import <PARTagPicker/PARTagPickerViewController.h>
.
The basic setup is to create an instance of PARTagPickerViewController
, add it's view, and then add the controller as a child view controller.
The tags are passed in as NSString
objects in an array. Anytime you change the allTags
array, any existing chosenTags
are updated to use references to the new strings if they contain a match in the updated array. Otherwise they continue to point to the old strings.
- You can customize colors using a PARTagColorReference object.
- You can allow new tags with
allowsNewTags
boolean property on the controller. - You can set the
chosenTags
directly. - Delegate methods for when the chosenTags change and the tag picker changes size.
- (void)tagPicker:(PARTagPickerViewController *)tagPicker visibilityChangedToState:(PARTagPickerVisibilityState)state
- (void)chosenTagsWereUpdatedInTagPicker:(PARTagPickerViewController *)tagPicker
This is still a work in progress. If you have suggestions or run into issues, please create an issue on git or tweet me @ThePaulRolfe.
- v1.0.2 - Including
.xib
s in the pod now. Oops! - v1.0.0 - Added documentation and fixed bug with deselecting chosenTags. Added ability to use custom fonts in the tag cells.
- v0.0.5 - Added expected functionality of chosenTags being removed when pressed.
Paul Rolfe, [email protected], @ThePaulRolfe
PARTagPicker is available under the MIT license. See the LICENSE file for more info.