How to install WSTagsField with Swift Package Manager?

In Xcode 11 or later, go to 'File' > 'Swift Packages' > 'Add Package Dependency...' and enter the repository URL: https://github.com/whitesmith/WSTagsField. Follow the prompts to integrate it into your project, as outlined in the README.

WSTagsField vs TagListView for iOS?

WSTagsField focuses on input and management with customizable events and validation, while TagListView is more for displaying static tags. Choose WSTagsField for interactive tag input; TagListView for simple tag displays without input features.

How to change the delimiter in WSTagsField?

Set the delimiter property on the WSTagsField instance, e.g., tagsField.delimiter = "," to use commas. You can also control visibility with isDelimiterVisible, as shown in the usage example.

Does WSTagsField support iOS 13 dark mode?

Yes, you can customize colors like backgroundColor and textColor to adapt to dark mode, but it doesn't automatically adjust—you need to set these properties manually based on the user interface style.

How to prevent duplicate tags in WSTagsField?

Use the onValidateTag closure to add custom logic, such as checking for existing tags. The README example shows validation that prevents duplicates by comparing uppercase text.

WSTagsField performance with many tags?

The dynamic layout adjusts height automatically, but with hundreds of tags, performance may degrade due to UIKit rendering. Optimize by limiting visible tags or implementing pagination if needed.

Open-Awesome

WSTagsField

MITSwift5.4.0

A customizable iOS text field component for displaying and managing tags, hashtags, and tokens.

GitHub

1.3k stars225 forks0 contributors

What is WSTagsField?

WSTagsField is an iOS library that provides a customizable text field component for displaying and managing tags, hashtags, and tokens. It solves the problem of implementing tag input interfaces in iOS apps by offering a ready-to-use, flexible component with extensive customization options and event handling.

Target Audience

iOS developers building applications that require tag input features, such as social media apps, productivity tools, or any app needing hashtag or token-based input.

Value Proposition

Developers choose WSTagsField for its ease of integration, high customizability, and comprehensive event handling, which saves time compared to building a tag input component from scratch while ensuring a polished user experience.

Overview

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

Use Cases

Best For

Adding tag input fields to iOS social media apps
Implementing hashtag functionality in iOS applications
Creating token-based input for search or filtering features
Building customizable tag management interfaces in Swift projects
Enhancing user input with dynamic tag addition and removal
Developing iOS apps that require flexible, styled tag displays

Not Ideal For

Cross-platform applications requiring tag input on Android or web
Projects needing advanced tag interactions like drag-and-drop sorting or batch deletion
Teams looking for a pre-styled, drop-in component with minimal configuration effort
Apps that must support iOS versions earlier than 9.0

Pros & Cons

Pros

Highly Customizable UI

Allows fine-grained control over layout margins, spacing, colors, fonts, and delimiter visibility, as demonstrated by properties like layoutMargins and tintColor in the code example.

Comprehensive Event Handling

Provides callback closures for tag addition, removal, text changes, and height adjustments, enabling responsive user interactions without extra boilerplate code.

Built-in Tag Validation

Supports custom validation logic via the onValidateTag closure to prevent duplicates or invalid tags, offering control over what gets added to the list.

Flexible Input Options

Configures delimiters (e.g., space), return key behavior, and tokenization settings, as shown with acceptTagOption and shouldTokenizeAfterResigningFirstResponder properties.

Cons

No SwiftUI Support

The library is built exclusively with UIKit and lacks native SwiftUI components, making it unsuitable for modern SwiftUI-based projects without wrapper workarounds.

Verbose Configuration

Setting up the component requires configuring numerous properties individually, which can be tedious and error-prone compared to more declarative or convention-based approaches.

Limited Advanced Features

Missing capabilities like drag-and-drop reordering, batch operations, or enhanced accessibility features, which might necessitate additional custom development.

Frequently Asked Questions

Related Projects

SkeletonView

☠️ An elegant way to show users that something is happening and also prepare them to which contents they are awaiting

Stars12,887

Forks1,123

Last commit3 months ago

Material

A UI/UX framework for creating beautiful applications.

Stars12,016

Forks1,260

Last commit4 years ago

NVActivityIndicatorView

A collection of awesome loading animations

Stars10,705

Forks1,155

Last commit6 months ago

Macaw

Powerful and easy-to-use vector graphics Swift library with SVG support

Stars6,048

Forks567

Last commit2 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