AMTagListView - SwiftGit

ScrollView

AMTagListView

October 17, 2023

UIScrollView subclass that allows to add a list of highly customizable tags. You can customize colors, border radius, and the tail of the tag. Tags can be added in bulk or dynamically one by one. The newly inserted tag will automatically arrange itself inside the scrollview.

Screenshot

Setup with CocoaPods

Swift


                                              
                                                pod ‘AMTagListView’

When using a bridging header:


                                              
                                                #import <AMTagListView.h>

When using dynamic frameworks:


                                              
                                                @import AMTagListView

Usage

You can create a AMTagListView in your storyboard, or programmatically:

Objective-C


                                              
                                                // Init

AMTagListView *tagListView = [[AMTagListView alloc] initWithFrame:frame];

[self.view addSubview:tagListView];

Swift


                                              
                                                let tagListView = AMTagListView(frame: frame)

view.addSubview(tagListView)

Adding tags

Objective-C


                                              
                                                // Add one tag

[self.tagListView addTag:@”my tag”];
// Add multiple tags

[self.tagListView addTags:@[@”my tag”, @”some tag”]];

Swift


                                              
                                                // Add one tag

tagListView.addTag(“my tag”)
// Add multiple tags

tagListView.addTags([“my tag”, “some tag”])

Arranging tags

The tags are rearranged when you use the method calls listed above. You can also avoid the auto-rearrange by using the andRearrange: versions of such methods. This is useful when adding a big batch of tags. When you do so you must force the rearrange action manually:


                                              
                                                [self.tagListView rearrangeTags];

You can also align the tags to the left or right by setting the tagAlignment property and calling rearrangeTags.

Appearance

Use the AMTagView’s UIAppearance selectors to customize its appearance:

Objective-C


                                              
                                                [[AMTagView appearance] setRadius:10];

Swift


                                              
                                                AMTagView.appearance().radius = 10

Add a payload to a tag

You can add a payload to a single tag by using addTag:withUserInfo::


                                              
                                                [self.tagListView addTag:@”hello” withUserInfo:@{ @”data”: somePayload }];

Scroll direction

You can control the scroll direction with the scrollDirection property:


                                              
                                                [self.tagListView setScrollDirection:AMScrollDirectionHorizontal];

Appearance properties

These are the properties that can be modified:


                                              
                                                // Tag’s corner radius

[[AMTagView appearance] setRadius:float]
// Tail’s length

[[AMTagView appearance] setTagLength:float]
// Inner padding of the tag label

[[AMTagView appearance] setInnerTagPadding:float]
// Radius of the hole punched in the tail

[[AMTagView appearance] setHoleRadius:float]
// Text padding (x for horizontal padding, y for vertical)

[[AMTagView appearance] setTextPadding:CGPoint]
// Text font

[[AMTagView appearance] setTextFont:UIFont]
// The text color

[[AMTagView appearance] setTextColor:UIColor]
// Tag main color

[[AMTagView appearance] setTagColor:UIColor]
// Tag label background color

[[AMTagView appearance] setInnerTagColor:UIColor]

Delegate

This method asks his delegate if a given tag can be added. The method also shows the resulting content size.


                                              
                                                – (BOOL)tagList:(AMTagListView *)tagListView shouldAddTagWithText:(NSString *)text resultingContentSize:(CGSize)size;

This method asks his delegate if a given batch of tags can be added. The method also shows the resulting content size.


                                              
                                                – (BOOL)tagList:(AMTagListView *)tagListView shouldAddTagsWithText:(NSArray *)text resultingContentSize:(CGSize)size;

This is called when a tag is removed:


                                              
                                                – (void)tagList:(AMTagListView *)tagListView didRemoveTag:(UIView<AMTag> *)tag;

Test

To run the test suite install xcpretty gem, launch pod install inside the Tests folder, and run the rake task in the root.

GitHub

View Github

#cocoa #cocoapod #cocoapods #cocoatouch #collection #collectionkit #collectionview #collectionviewcell #collectionviewlayout #delegate #dynamic #expandabletableview #hashtag #hashtags #ibinspectable #instagram #instagramanimation #ios #iosanimation #iosdevelopment #iossdk #iosswift #iosthirdparty #objectivec #storyboard #swift #swiftanimation #swiftcollection #swiftimage #swiftlibrary #swiftpackagemanager #swiftui #swiftuicomponents #table #tableview #tableviewcell #taglistview #tags #tagsview #uicollectionview #uicollectionviewanimation #uicollectionviewcell #uicollectionviewflowlayout #uicollectionviewlayout #uiscrollviewautolayout #uitableview #uitableviewcell #uitableviewcontroller #xcode