aleene / taglistview Goto Github PK

View Code? Open in Web Editor NEW

This project forked from elaworkshop/taglistview

0.0 3.0 0.0 425 KB

Simple and highly customizable iOS tag list view, in Swift.

License: MIT License

Ruby 2.29% Swift 95.67% Objective-C 2.04%

taglistview's Introduction

TagListView

Simple and highly customizable iOS tag list view, in Swift.

Supports Storyboard, Auto Layout, and @IBDesignable.

Usage

The most convinient way is to use Storyboard. Drag a view to Storyboard and set Class to TagListView (if you use CocoaPods, also set Module to TagListView). Then you can play with the attributes in the right pane, and see the preview in real time thanks to @IBDesignable.

You can add tag to the tag list view, or set custom font and alignment through code:

tagListView.textFont = UIFont.systemFontOfSize(24)
tagListView.alignment = .Center // possible values are .Left, .Center, and .Right

tagListView.addTag("TagListView")
tagListView.insertTag("This should be the second tag", at: 1)

tagListView.removeTag("meow") // all tags with title “meow” will be removed
tagListView.removeAllTags()

You can implement TagListViewDelegate to receive tag pressed event:

// ...
{
    // ...
    tagListView.delegate = self
    // ...
}

func tagPressed(title: String, tagView: TagView, sender: TagListView) {
    print("Tag pressed: \(title), \(sender)")
}

You can also customize a particular tag, or set tap handler for it by manipulating the TagView object returned by addTag(_:):

let tagView = tagListView.addTag("blue")
tagView.tagBackgroundColor = UIColor.blueColor()
tagView.onTap = { tagView in
    print("Don’t tap me!")
}

Be aware that if you update a property (e.g. tagBackgroundColor) for a TagListView, all the inner TagViews will be updated.

Installation

Use CocoaPods:

pod 'TagListView', '~> 1.0'

Or Carthage:

github "ElaWorkshop/TagListView" ~> 1.0

Or drag TagListView folder into your project.

Older Swift Versions?

Currently, the master branch is using Swift 3.0.

For Swift 2, use version 1.0.1 or swift-2.3 branch. For Swift 1.2, use version 0.2.

Contribution

Pull requests are welcome! If you want to do something big, please open an issue to let me know first.

License

MIT

taglistview's People

Contributors

Watchers

taglistview's Issues

Shadow is in front of tag

Why?

Clear button.

It would be nice to have clear button in a TagListField similar to a UITextField. This clear button, when present should remove all tags.
This can work similar to UITextField, i.e. either it is always visible. Or it depends isEditable, i.e. visible when isEditable or visible when !isEditable.
#8

Tag granularity

The layout of the tags is mainly governed by the layout details of the TagListView. However it is possible to set the layout of individual tags by accessing their TagViews.

Accessing TagViews can be done while setting up the TagListView. And if needed can be changed later. Or when selecting or editing a tag.

Do we need something like willDisplayTag(atIndex:), so the user can setup things? Seems a very heavy function if this must be called for each tag.
#8

Drag&drop support

Drag&drop allows the user to rearrange tags

With a long press a tag can be selected, it will then hover above the tag list and can be dropped between two other tags;
Drag&drop is only possible when the TagViewList isEditable;
A delegate asks the user if a tag may be dragged. So you can deny certain tags to be dragged;
A delegate informs the user that a tag has been dragged to a new position. This allows the user to adapt his data;
The demo should show dragging and denying;
Can we keep the original longPress function?

Managed TagListView

A version og TagListView without direct access to TagViews. Everything is handled through delegates.

isSelected vs isHighlighted

What is the purpose of differentiating betwen these two?

To-field?

I could use the to-field to make the interface compacter.

Removal animation

A question was asked whether it was possible to add a removal animation.

I might use the drag&drop approach for this. On removal, dim the tag to fully hidden and the make the width of the tag smaller, which should move all the other tags.

removeAllTags()

Should have another look at the implementation of this function.

What is the relation with the edit-delegates and -datasources;
Is there a relation with a clear-button ( #9 )?
#8

Delete and d&d

I am warming to the use of a delete button. If you make a mistake now with d&d, you might delete an item. So somekind of brake on this is usefull.
This can be a delete button, so you need to hit a specific area.
Or it can be a two-phase delete, as seems that is used by TokenField. First you highlight and then you tap delete on the keyboard. And you can not delete by tapping.

ScrollView

Do I need the scrollView? Or can I do without?

The TagListView consists now of a PrefixLabel + a list if TagView's + an InputTextView.

Suggestions

The tokenfield implementation has a delegate that starts as soon as the user types. This can be used to present suggestions in a TableView for instance. As the user continues typing, the suggestions are finetuned. Tapping a suggstion could for the setting of a tag.

I did not yet find an implementation for this.

TagListViewEditingStyleDelete
TagListViewEditingStyleInsert
TagListViewEditingStyleMove

There should be a corresponding delegate function:

tagListView(_ tagListView: TagListView, editingStyleForTagAt: index) -> TagListViewEditingStyle