tag

TagsList

'TagList allows to add a list of highly customizable tags. You can set common tags parameters, add items with unique parameters. There are 2 ways to put data into TagsList: using dataSource methods or create DefaultTagsListDataSource and simply put array of strings into'

Showing:

Popularity

Downloads/wk

0

GitHub Stars

44

Maintenance

Last Commit

1yr ago

Contributors

3

Package

Dependencies

0

License

MIT

Categories

Readme

TagsList

CI Status Version License Swift 5.0

TagList allows to add a list of highly customizable tags. You can set common tags parameters, add items with unique parameters

Example

To run the example project, clone the repo, and run pod install from the Example directory first. Example project includes 3 parts:

  • VC is TagsListDataSource + customisation of items
  • Simple way to display string array (DefaultTagsListDataSource)
  • Sample of using TagsList inside of UITableViewCell and calculating TagsList height

Preview

Content orientationItems deletingCustomisation features

Requirements

  • iOS 11.0+
  • Xcode 9.0

Installation

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

pod 'TagsList'

Import TagsList into your swift source file

import TagsList

Congratulations!

Usage

Common tags settings

First step to customise appearance of tags is configure TagViewItemConfigurator. It include common tags view settings and applies by default.

TagViewItemConfigurator properties
borderMarginHorizontal
spacing
contentHeight
cellHeight
itemCornerRadius
sideImageCornerRadius
xButtonCornerRadius

sideImageEverytimeDisplaying
xButtonEverytimeDisplaying
maxWidth
titleFont

backgroundColor
sideImageBackgroundColor
xButtonBackgroundColor
textColor

xButtonImage

Ways of data representation

Next step is representation of your data. There are 2 ways:

  • Create DefaultTagsListDataSource and put your string array into
  • Set TagsList property tagsListDataSource and implement methods of TagsListDataSource protocol

Choose first way if you need to represent array of strings quickly. If you want to create tags with different representation I recomend you to use second way or create own TagsListDataSource

Tags with different representation

If you need to show custom tags like on Preview use TagViewItems array with second way of data representation.

TagViewItem properties
title
titleColor
titleFont

sideImage
sideImageBackgroundColor

xButtonDisplaying
xButtonBackgroundColor
xButtonImage

backgroundColor

If you stil want to customise items after previous steps use tagsListCellFinalConfiguration method of TagsListDataSource

Author

Mobile team of Inostudio.

License

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

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100