What

Features

Demo

Code Structure

Requirements

Installation

CocoaPods for Objective-C

pod"TTGTagCollectionView"

CocoaPods for Swift

use_frameworks!pod"TTGTagCollectionView"

Swift Package Manager

Usage

TTGTextTagCollectionView

Basic usage

Swift

// importimport TTGTags// Create TTGTextTagCollectionView viewlettagView=TTGTextTagCollectionView.init(frame:CGRect(x:20, y:100, width:200, height:200))self.view.addSubview(tagView)// Create TTGTextTag objectlettextTag=TTGTextTag(content:TTGTextTagStringContent(text:"tutuge"), style:TTGTextTagStyle())// Add tagtagView.addTag(textTag)// !!! Never forget this !!!tagView.reload()

Objective-C

// import#import<TTGTags/TTGTextTagCollectionView.h>// Create TTGTextTagCollectionView viewTTGTextTagCollectionView *tagCollectionView = [[TTGTextTagCollectionViewalloc]initWithFrame:CGRectMake(20,20,200,200)];[self.viewaddSubview:tagCollectionView];// Create TTGTextTag objectTTGTextTag *textTag = [TTGTextTagtagWithContent:[TTGTextTagStringContentcontentWithText:@"Some text"]style:[TTGTextTagStylenew]];// Add tag[tagCollectionViewaddTag:textTag];// !!! Never forget this !!![tagCollectionViewreload];

Accessibility

// Auto set accessibilityLabel valuetag.enableAutoDetectAccessibility =YES;// Manualtag.isAccessibilityElement =YES;tag.accessibilityLabel = text;tag.accessibilityIdentifier = [NSStringstringWithFormat:@"identifier:%@", text];tag.accessibilityHint = [NSStringstringWithFormat:@"hint:%@", text];tag.accessibilityValue = [NSStringstringWithFormat:@"value:%@", text];

Delegate

@protocolTTGTextTagCollectionViewDelegate <NSObject>@optional- (BOOL)textTagCollectionView:(TTGTextTagCollectionView *)textTagCollectionViewcanTapTag:(TTGTextTag *)tagatIndex:(NSUInteger)index;- (void)textTagCollectionView:(TTGTextTagCollectionView *)textTagCollectionViewdidTapTag:(TTGTextTag *)tagatIndex:(NSUInteger)index;- (void)textTagCollectionView:(TTGTextTagCollectionView *)textTagCollectionViewupdateContentSize:(CGSize)contentSize;@end

Customization

@interfaceTTGTextTag :NSObject <NSCopying>/// ID@property (nonatomic,assign,readonly)NSUInteger tagId;// Auto increase. The only identifier and main key for a tag/// Attachment object. You can use this to bind any object you want to each tag.@property (nonatomic,strong)id _Nullable attachment;/// Normal state content and style@property (nonatomic,copy) TTGTextTagContent * _Nonnull content;@property (nonatomic,copy) TTGTextTagStyle * _Nonnull style;/// Selected state content and style@property (nonatomic,copy) TTGTextTagContent * _Nullable selectedContent;@property (nonatomic,copy) TTGTextTagStyle * _Nullable selectedStyle;/// Selection state@property (nonatomic,assign)BOOL selected;@property (nonatomic,copy) OnSelectStateChanged _Nullable onSelectStateChanged;// State changed callback/// Accessibility@property (nonatomic,assign)BOOL isAccessibilityElement;// Default = NO@property (nonatomic,copy)NSString * _Nullable accessibilityIdentifier;// Default = nil@property (nonatomic,copy)NSString * _Nullable accessibilityLabel;// Default = nil@property (nonatomic,copy)NSString * _Nullable accessibilityHint;// Default = nil@property (nonatomic,copy)NSString * _Nullable accessibilityValue;// Default = nil@property (nonatomic,assign) UIAccessibilityTraits accessibilityTraits;// Default = UIAccessibilityTraitNone/// Auto detect accessibility/// When enableAutoDetectAccessibility = YES, the property below will be set automatically/// ----------------------------/// isAccessibilityElement = YES/// accessibilityLabel = (selected ? selectedContent : content).getContentAttributedString.string/// accessibilityTraits = selected ? UIAccessibilityTraitSelected : UIAccessibilityTraitButton/// ----------------------------/// But: accessibilityHint and accessibilityValue still keep your custom value;@property (nonatomic,assign)BOOL enableAutoDetectAccessibility;// Default = NO@end

// Normal Text@interfaceTTGTextTagStringContent :TTGTextTagContent/// Text@property (nonatomic,copy)NSString * _Nonnull text;/// Text font@property (nonatomic,copy) UIFont * _Nonnull textFont;/// Text color@property (nonatomic,copy) UIColor * _Nonnull textColor;@end// NSAttributedString Text@interfaceTTGTextTagAttributedStringContent :TTGTextTagContent/// Attributed text@property (nonatomic,copy)NSAttributedString * _Nonnull attributedText;@end

@interfaceTTGTextTagStyle :NSObject <NSCopying>/// Background color@property (nonatomic,copy) UIColor * _Nonnull backgroundColor;// Default is [UIColor lightGrayColor]/// Text alignment@property (nonatomic,assign)NSTextAlignment textAlignment;// Default is NSTextAlignmentCenter/// Gradient background color@property (nonatomic,assign)BOOL enableGradientBackground;// Default is NO@property (nonatomic,copy) UIColor * _Nonnull gradientBackgroundStartColor;@property (nonatomic,copy) UIColor * _Nonnull gradientBackgroundEndColor;@property (nonatomic,assign) CGPoint gradientBackgroundStartPoint;@property (nonatomic,assign) CGPoint gradientBackgroundEndPoint;/// Corner radius@property (nonatomic,assign) CGFloat cornerRadius;// Default is 4@property (nonatomic,assign) Boolean cornerTopRight;@property (nonatomic,assign) Boolean cornerTopLeft;@property (nonatomic,assign) Boolean cornerBottomRight;@property (nonatomic,assign) Boolean cornerBottomLeft;/// Border@property (nonatomic,assign) CGFloat borderWidth;// Default is [UIColor whiteColor]@property (nonatomic,copy) UIColor * _Nonnull borderColor;// Default is 1/// Shadow.@property (nonatomic,copy) UIColor * _Nonnull shadowColor;// Default is [UIColor blackColor]@property (nonatomic,assign) CGSize shadowOffset;// Default is (2, 2)@property (nonatomic,assign) CGFloat shadowRadius;// Default is 2f@property (nonatomic,assign) CGFloat shadowOpacity;// Default is 0.3f/// Extra space in width and height, will expand each tag's size@property (nonatomic,assign) CGSize extraSpace;/// Max width for a text tag. 0 and below means no max width.@property (nonatomic,assign) CGFloat maxWidth;/// Min width for a text tag. 0 and below means no min width.@property (nonatomic,assign) CGFloat minWidth;/// Max height for a text tag. 0 and below means no max height.@property (nonatomic,assign) CGFloat maxHeight;/// Min height for a text tag. 0 and below means no min height.@property (nonatomic,assign) CGFloat minHeight;/// Exact width. 0 and below means no work@property (nonatomic,assign) CGFloat exactWidth;/// Exact height. 0 and below means no work@property (nonatomic,assign) CGFloat exactHeight;@end

// TTGTextTagCollectionView.h// Define if the tag can be selected.@property (assign, nonatomic)BOOL enableTagSelection;// Tags scroll direction, default is vertical.@property (nonatomic, assign) TTGTagCollectionScrollDirection scrollDirection;// Tags layout alignment, default is left.@property (nonatomic, assign) TTGTagCollectionAlignment alignment;// Number of lines. 0 means no limit, default is 0 for vertical and 1 for horizontal.@property (nonatomic, assign)NSUInteger numberOfLines;// Tag selection limit, default is 0, means no limit@property (nonatomic, assign)NSUInteger selectionLimit;// Horizontal and vertical space between tags, default is 4.@property (assign, nonatomic) CGFloat horizontalSpacing;@property (assign, nonatomic) CGFloat verticalSpacing;// Content inset, default is UIEdgeInsetsMake(2, 2, 2, 2).@property (nonatomic, assign) UIEdgeInsets contentInset;// The true tags content size, readonly@property (nonatomic, assign, readonly) CGSize contentSize;// Manual content height// Default = NO, set will update content@property (nonatomic, assign)BOOL manualCalculateHeight;// Default = 0, set will update content@property (nonatomic, assign) CGFloat preferredMaxLayoutWidth;// Scroll indicator@property (nonatomic, assign)BOOL showsHorizontalScrollIndicator;@property (nonatomic, assign)BOOL showsVerticalScrollIndicator;

typedefNS_ENUM(NSInteger, TTGTagCollectionAlignment) {    TTGTagCollectionAlignmentLeft =0,// Default    TTGTagCollectionAlignmentCenter,// Center    TTGTagCollectionAlignmentRight,// Right    TTGTagCollectionAlignmentFillByExpandingSpace,// Expand horizontal spacing and fill    TTGTagCollectionAlignmentFillByExpandingWidth,// Expand width and fill    TTGTagCollectionAlignmentFillByExpandingWidthExceptLastLine,// Expand width and fill, except last line};

Modify tags

// TTGTextTagCollectionView.h/// Add- (void)addTag:(TTGTextTag *)tag;- (void)addTags:(NSArray <TTGTextTag *> *)tags;

// TTGTextTagCollectionView.h/// Insert- (void)insertTag:(TTGTextTag *)tag atIndex:(NSUInteger)index;- (void)insertTags:(NSArray <TTGTextTag *> *)tags atIndex:(NSUInteger)index;

// TTGTextTagCollectionView.h/// Update- (void)updateTagAtIndex:(NSUInteger)index selected:(BOOL)selected;- (void)updateTagAtIndex:(NSUInteger)index withNewTag:(TTGTextTag *)tag;

// TTGTextTagCollectionView.h// Remove tag- (void)removeTag:(TTGTextTag *)tag;- (void)removeTagById:(NSUInteger)tagId;- (void)removeTagAtIndex:(NSUInteger)index;- (void)removeAllTags;

// TTGTextTagCollectionView.h/// Get tag- (TTGTextTag *)getTagAtIndex:(NSUInteger)index;- (NSArray <TTGTextTag *> *)getTagsInRange:(NSRange)range;/// Get all- (NSArray <TTGTextTag *> *)allTags;- (NSArray <TTGTextTag *> *)allSelectedTags;- (NSArray <TTGTextTag *> *)allNotSelectedTags;

Reload

// TTGTextTagCollectionView.h- (void)reload;

Index at point

// TTGTextTagCollectionView.h- (NSInteger)indexOfTagAt:(CGPoint)point;

TTGTagCollectionView

DataSource and Delegate

@protocolTTGTagCollectionViewDataSource <NSObject>@required- (NSUInteger)numberOfTagsInTagCollectionView:(TTGTagCollectionView *)tagCollectionView;- (UIView *)tagCollectionView:(TTGTagCollectionView *)tagCollectionViewtagViewForIndex:(NSUInteger)index;@end

@protocolTTGTagCollectionViewDelegate <NSObject>@required- (CGSize)tagCollectionView:(TTGTagCollectionView *)tagCollectionViewsizeForTagAtIndex:(NSUInteger)index;@optional- (BOOL)tagCollectionView:(TTGTagCollectionView *)tagCollectionViewshouldSelectTag:(UIView *)tagViewatIndex:(NSUInteger)index;- (void)tagCollectionView:(TTGTagCollectionView *)tagCollectionViewdidSelectTag:(UIView *)tagViewatIndex:(NSUInteger)index;- (void)tagCollectionView:(TTGTagCollectionView *)tagCollectionViewupdateContentSize:(CGSize)contentSize;@end

Customization

// TTGTagCollectionView.h// Tags scroll direction, default is vertical.@property (nonatomic, assign) TTGTagCollectionScrollDirection scrollDirection;// Tags layout alignment, default is left.@property (nonatomic, assign) TTGTagCollectionAlignment alignment;// Number of lines. 0 means no limit, default is 0 for vertical and 1 for horizontal.@property (nonatomic, assign)NSUInteger numberOfLines;// Horizontal and vertical space between tags, default is 4.@property (nonatomic, assign) CGFloat horizontalSpacing;@property (nonatomic, assign) CGFloat verticalSpacing;// Content inset, default is UIEdgeInsetsMake(2, 2, 2, 2).@property (nonatomic, assign) UIEdgeInsets contentInset;// The true tags content size, readonly@property (nonatomic, assign, readonly) CGSize contentSize;// Manual content height// Default = NO, set will update content@property (nonatomic, assign)BOOL manualCalculateHeight;// Default = 0, set will update content@property (nonatomic, assign) CGFloat preferredMaxLayoutWidth;// Scroll indicator@property (nonatomic, assign)BOOL showsHorizontalScrollIndicator;@property (nonatomic, assign)BOOL showsVerticalScrollIndicator;

Reload

// TTGTagCollectionView.h- (void)reload;

Index at point

// TTGTagCollectionView.h- (NSInteger)indexOfTagAt:(CGPoint)point;

Fix

Author

License