IDC资讯中心
项目介绍：
https://github.com/zekunyan/TTGTagCollectionView
TTGTagCollectionView
What
TTGTagCollectionView用于垂直或水平滚动视图显示出不同大小的标签视图。如果你只想显示文字标签，你可以使用TTGTagCollectionView代替，具有更简单的API。
它是高度可定制的，许多功能的文本标签可以配置，如标签的字体大小和背景颜色。
Features
*支持的文本标签和自定义视图标签。
*高度可定制
*垂直和水平滚动
*基于UICollectionView
*支持Autolayout intrinsiccontentsize
自动确定基于内容的高度尺寸
Requirements
iOS 7 and later.
Installation
CocoaPods
TTGTagCollectionView is available through CocoaPods. To install
it, simply add the following line to your Podfile:
pod "TTGTagCollectionView"Carthage
You can use Carthage to install TTGTagCollectionView by adding it to your Cartfile:
github "zekunyan/TTGTagCollectionView"Usage
TTGTextTagCollectionView
Use TTGTextTagCollectionView to show text tags.
Basic usage
TTGTextTagCollectionView *tagCollectionView = [[TTGTextTagCollectionView alloc] initWithFrame:CGRectMake(20, 20, 200, 200)];
[self.view addSubview:tagCollectionView];
[tagCollectionView addTags:@[@"TTG", @"Tag", @"collection", @"view"]];
Delegate
Conform the TTGTextTagCollectionViewDelegate protocol to get callback when you select the tag or content height changes.
@protocol TTGTextTagCollectionViewDelegate <NSObject>
@optional
- (void)textTagCollectionView:(TTGTextTagCollectionView *)textTagCollectionView didTapTag:(NSString *)tagText atIndex:(NSUInteger)index selected:(BOOL)selected;
- (void)textTagCollectionView:(TTGTextTagCollectionView *)textTagCollectionView updateContentSize:(CGSize)contentSize;
@endCustomization
// Define if the tag can be selected.
@property (assign, nonatomic) BOOL enableTagSelection;
// Text font
@property (strong, nonatomic) UIFont *tagTextFont;
// Text color
@property (strong, nonatomic) UIColor *tagTextColor;
@property (strong, nonatomic) UIColor *tagSelectedTextColor;
// Background color
@property (strong, nonatomic) UIColor *tagBackgroundColor;
@property (strong, nonatomic) UIColor *tagSelectedBackgroundColor;
// Corner radius
@property (assign, nonatomic) CGFloat tagCornerRadius;
@property (assign, nonatomic) CGFloat tagSelectedCornerRadius; // Default is tagCornerRadius
// Border
@property (assign, nonatomic) CGFloat tagBorderWidth;
@property (assign, nonatomic) CGFloat tagSelectedBorderWidth; // Default is tagBorderWidth
@property (strong, nonatomic) UIColor *tagBorderColor;
@property (strong, nonatomic) UIColor *tagSelectedBorderColor; // Default is tagBorderColor
// Extra space for width and height
@property (assign, nonatomic) CGSize extraSpace;
// Horizontal and veritical space between tags
@property (assign, nonatomic) CGFloat horizontalSpacing;
@property (assign, nonatomic) CGFloat verticalSpacing;
// Content size
@property (nonatomic, assign, readonly) CGSize contentSize;
// Scroll direction. Default is vertical
@property (nonatomic, assign) TTGTagCollectionScrollDirection scrollDirection;
// Number of lines for horizontal direction
@property (nonatomic, assign) NSUInteger numberOfLinesForHorizontalScrollDirection;
// Tag shadow
@property (nonatomic, copy) UIColor *shadowColor; // Default is [UIColor black]
@property (nonatomic, assign) CGSize shadowOffset; // Default is CGSizeZero
@property (nonatomic, assign) CGFloat shadowRadius; // Default is 0f
@property (nonatomic, assign) CGFloat shadowOpacity; // Default is 0.5f
// Content inset, default is UIEdgeInsetsMake(2, 2, 2, 2)
@property (nonatomic, assign) UIEdgeInsets contentInset;Config tags
// Add tags
- (void)addTag:(NSString *)tag;
- (void)addTags:(NSArray <NSString *> *)tags;
/// Remove tags
- (void)removeTag:(NSString *)tag;
- (void)removeTagAtIndex:(NSUInteger)index;
- (void)removeAllTags;Config tag selection
- (void)setTagAtIndex:(NSUInteger)index selected:(BOOL)selected;Get tag information
- (NSArray <NSString *> *)allTags;
- (NSArray <NSString *> *)allSelectedTags;
- (NSArray <NSString *> *)allNotSelectedTags;Reload
You can reload tags programmatically.
- (void)reload;TTGTagCollectionView
Use TTGTagCollectionView to show custom tag views.
DataSource and Delegate
Just like the UITableView, you must conform and implement the required methods of TTGTagCollectionViewDelegate and TTGTagCollectionViewDataSource to get TTGTagCollectionView work.
DataSource
@protocol TTGTagCollectionViewDataSource <NSObject>
@required
- (NSUInteger)numberOfTagsInTagCollectionView:(TTGTagCollectionView *)tagCollectionView;
- (UIView *)tagCollectionView:(TTGTagCollectionView *)tagCollectionView tagViewForIndex:(NSUInteger)index;
@endDelegate
@protocol TTGTagCollectionViewDelegate <NSObject>
@required
- (CGSize)tagCollectionView:(TTGTagCollectionView *)tagCollectionView sizeForTagAtIndex:(NSUInteger)index;
@optional
- (void)tagCollectionView:(TTGTagCollectionView *)tagCollectionView didSelectTag:(UIView *)tagView atIndex:(NSUInteger)index;
- (void)tagCollectionView:(TTGTagCollectionView *)tagCollectionView updateContentSize:(CGSize)contentSize;
@endCustomization
You can config the horizontal and vertical space between tags.
/**
* Tags scroll direction, default is veritical
*/
@property (nonatomic, assign) TTGTagCollectionScrollDirection scrollDirection;
/**
* Number of lines for horizontal scroll direction
*/
@property (nonatomic, assign) NSUInteger numberOfLinesForHorizontalScrollDirection;
/**
* Horizontal space between tags
*/
@property (nonatomic, assign) CGFloat horizontalSpacing;
/**
* Vertical space between tags
*/
@property (nonatomic, assign) CGFloat verticalSpacing;
/**
* The true tags content size
*/
@property (nonatomic, assign, readonly) CGSize contentSize;
/**
* Tag shadow
*/
@property (nonatomic, strong) UIColor *shadowColor; // Default is [UIColor black]
@property (nonatomic, assign) CGSize shadowOffset; // Default is CGSizeZero
@property (nonatomic, assign) CGFloat shadowRadius; // Default is 0f
@property (nonatomic, assign) CGFloat shadowOpacity; // Default is 0.5f
/**
* Content inset, default is UIEdgeInsetsMake(2, 2, 2, 2)
*/
@property (nonatomic, assign) UIEdgeInsets contentInset;Reload
You can reload tags programmatically.
- (void)reload;
