This pod provides a view controller for choosing and creating tags in the style of wordpress or tumblr.
Clone or download
Latest commit aad7a1a Dec 22, 2017

README.md

PARTagPicker

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.

DEMO

As used in Slate:

DEMO IN SLATE DEMO IN SLATE

From example project:

DEMO IN EXAMPLE DEMO IN EXAMPLE

Installation

PARTagPicker is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod 'PARTagPicker'

Usage

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.

Swift

override func viewDidLoad() {
    super.viewDidLoad()
    // Add the controller and view.
    let tagController = PARTagPickerViewController()
    addChildViewController(tagController)
    tagController.view.frame = CGRect(x: 0, y: 64, width: view.bounds.width, height: COLLECTION_VIEW_HEIGHT)
    view.addSubview(tagController.view)
    tagController.didMove(toParentViewController: self)

    // Customize appearance and data.
    tagController.delegate = self
    tagController.allTags = ["one fish","two fish"," red fish", "blue fish"]
    tagController.chosenTags = ["with a fox", "in a box", "anywhere"]
    tagController.allowsNewTags = true
    tagController.view.backgroundColor = .orange
    let colors = PARTagColorReference()
    colors.highlightedTagTextColor = .white
    colors.highlightedTagBackgroundColor = .blue
    tagController.tagColorRef = colors
}

func tagPicker(_ tagPicker: PARTagPickerViewController!, visibilityChangedTo state: PARTagPickerVisibilityState) {
    var newHeight: CGFloat = 0
    if state == .topAndBottom {
        newHeight = 2 * COLLECTION_VIEW_HEIGHT
    } else if state == .topOnly {
        newHeight = COLLECTION_VIEW_HEIGHT
    }

    var frame = tagPicker.view.frame
    frame.size.height = newHeight

    UIView.animate(withDuration: 0.3) {
        tagPicker.view.frame = frame
    }
}

Obj-C

See example with pod try PARTagPicker or check the example view controller here: https://github.com/paulrolfe/PARTagPicker/blob/master/PARTagPicker/ViewController.m

Options

  • 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
  • tapToEraseTags Defaults to YES. If set to NO, tapping a cell will just select it (not delete it).
  • placeholderText - The default text to have as placeholder text in each tag cell. Default value is @"Add a tag".

Notes

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.

Updates

  • v1.4.0 - Swift example, expose cleaner PARTagColorReference init.
  • v1.1.0 - Added properties for placeholderText and tapToEraseTags.
  • v1.0.4 - Enabled for use in swift pods.
  • v1.0.2 - Including .xibs 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.

Author

Paul Rolfe, paul.a.rolfe@gmail.com, @ThePaulRolfe

License

PARTagPicker is available under the MIT license. See the LICENSE file for more info.