How do I customize the look of tags in AMTagListView?

Use UIAppearance selectors on AMTagView, such as setting radius, tagLength, and colors. For example, in Swift, `AMTagView.appearance().radius = 10` adjusts corner radius, with all properties listed in the 'Appearance properties' section of the README.

AMTagListView vs UICollectionView for displaying tags?

AMTagListView is simpler for basic tag lists with automatic layout and built-in styling, but UICollectionView offers more flexibility for complex layouts, animations, and better performance with large datasets. Choose based on your need for customization versus control.

How to handle when a tag is tapped in AMTagListView?

The library doesn't have built-in tap handling; you need to add gesture recognizers to individual tags or use the delegate methods like `didRemoveTag` for removal events. Implement custom interactions by accessing the tag's payload or text programmatically.

Does AMTagListView work with SwiftUI?

No, it's a UIKit-based component. To use it in SwiftUI, you'd need to wrap it in a UIViewRepresentable, which adds complexity and might not integrate seamlessly with SwiftUI's state management and declarative syntax.

Is AMTagListView still maintained in 2024?

Based on the GitHub repository, the last commit was in 2017, and there are no recent updates. It's likely unmaintained, so consider forks or alternatives like TagListView for active support and modern iOS compatibility.

How to improve performance when adding many tags?

Use the `andRearrange:` versions of add methods to batch additions, then call `rearrangeTags` manually. This avoids frequent layout recalculations during bulk operations, as explained in the 'Arranging tags' section for optimizing large datasets.

Open-Awesome

AMTagListView

MITObjective-C1.3.0

A UIScrollView subclass for iOS that displays a scrollable list of highly customizable tags with automatic layout.

GitHub

757 stars112 forks0 contributors

What is AMTagListView?

AMTagListView is an open-source iOS library that provides a customizable tag list component built as a UIScrollView subclass. It solves the problem of displaying and managing interactive tags in iOS applications, with features like automatic layout, bulk tag insertion, and extensive styling options. Developers can easily integrate it to create tag-based interfaces for filtering, categorization, or input systems.

Target Audience

iOS developers building apps that require tag-based UI components, such as those for social tagging, search filters, content categorization, or dynamic input fields. It's suitable for both Objective-C and Swift projects.

Value Proposition

Developers choose AMTagListView for its simplicity, high customizability, and seamless integration with UIKit. Unlike building tag lists from scratch, it offers automatic layout management, UIAppearance-based styling, and delegate-driven interactivity, saving development time while maintaining design flexibility.

Overview

UIScrollView subclass that allows to add a list of highly customizable tags.

Use Cases

Best For

Adding tag-based search or filter interfaces in iOS apps
Displaying user-generated tags in social or content apps
Creating customizable input fields with tag suggestions
Building dynamic category or label selection UIs
Implementing scrollable tag lists with custom styling
Enhancing iOS apps with interactive, visually adaptable tag components

Not Ideal For

SwiftUI projects seeking native component integration without UIKit dependencies
Applications requiring drag-and-drop reordering or advanced gesture controls for tags
Teams prioritizing out-of-the-box accessibility features like VoiceOver support and dynamic type scaling
Large-scale apps where performance with hundreds of dynamic tags is critical, as UIScrollView may lag behind UICollectionView

Pros & Cons

Pros

Extensive Visual Customization

Supports UIAppearance-based styling for radius, tail length, colors, and fonts, allowing consistent theming across the app without manual code per tag, as detailed in the 'Appearance properties' section.

Dynamic Tag Management

Offers methods to add tags individually or in bulk with automatic rearrangement, and manual control via `rearrangeTags` for performance optimization, enabling flexible updates as shown in the 'Adding tags' and 'Arranging tags' sections.

Payload and Interactivity Support

Allows attaching custom data (userInfo) to tags and provides delegate methods for validation on addition and notifications on removal, enhancing interactivity for scenarios like filtering or categorization.

Flexible Layout Options

Supports both vertical and horizontal scrolling with configurable tag alignment (left or right), adapting to different UI requirements, as mentioned in the 'Scroll direction' and 'Arranging tags' parts of the README.

Cons

Outdated Codebase

Last significant update appears to be in 2017 (based on copyright), lacking support for modern Swift features, SwiftUI, or recent iOS SDK improvements, which may lead to compatibility issues.

UIAppearance Dependency

Relies on UIAppearance for styling, which can be limiting for dynamic, per-instance customization and is less flexible than programmatic or SwiftUI-based approaches, as evidenced by the setup requiring appearance selectors.

Limited Ecosystem and Maintenance

With no recent commits or updates, the library might have unresolved bugs, reduced community support, and dependencies on older build tools like CocoaPods, complicating integration into modern projects.

Frequently Asked Questions

Related Projects

TagListView

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

Stars2,672

Forks490

Last commit2 years ago

TTGTagCollectionView

Useful for showing text or custom view tags in a vertical or horizontal scrollable view and support Autolayout at the same time. It is highly customizable that most features of the text tag can be configured. 标签流显示控件，同时支持文字或自定义View

Stars1,900

Forks264

Last commit1 month ago

SFFocusViewLayout

UICollectionViewLayout with focused content

Stars1,752

Forks174

Last commit7 years ago

WSTagsField

An iOS text field that represents tags, hashtags, tokens in general.

Stars1,286

Forks226

Last commit3 years ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub