TURecipientBar

Introduction

TURecipientBar is a versatile recipient bar that allows for easy and intuitive recipient selection in iOS apps. With its flexible and customizable design, it provides a seamless user experience when creating messaging interfaces.

Purpose

The TURecipientBar library aims to simplify the implementation of recipient selection in iOS apps. It provides a user-friendly interface for selecting and managing recipients, enabling developers to focus on building engaging messaging features.

Key Features

  • Simple and intuitive recipient selection
  • Flexible and customizable design
  • Support for email, phone numbers, usernames, etc.
  • Auto-complete functionality
  • Recipient management (add/remove recipients)
  • Delegate methods for customization

Installation

Cocoapods

To install TURecipientBar using Cocoapods, add the following line to your Podfile:

“`ruby
pod ‘TURecipientBar’
“`

Manual Installation

  1. Download the latest zip package from the official GitHub repository.
  2. Unzip the package.
  3. Drag and drop the TURecipientBar folder into your Xcode project.

Usage

Quick Start

To quickly integrate TURecipientBar into your project, follow these steps:

  1. Create an instance of TURecipientBar in your view controller.
  2. Set the desired frame for the recipient bar.
  3. Add the recipient bar as a subview to your view hierarchy.
  4. Implement the necessary delegate methods for recipient management (e.g., adding/removing recipients).

Customization

TURecipientBar provides multiple customization options for adapting its appearance and behavior to suit your app’s design. Some of the available customization features include:

  • Bar background color
  • Recipient text color
  • Placeholder text
  • Auto-complete suggestions
  • Number of visible recipients
  • And many more…

Refer to the TURecipientBar documentation for a complete list of customization options.

Delegate Methods

The TURecipientBar delegate methods allow you to customize the recipient bar according to your app’s requirements. Some of the available delegate methods include:

  • recipientBar(_:didAddRecipient:)
  • recipientBar(_:willRemoveRecipient:)
  • recipientBar(_:shouldAddRecipient:)
  • recipientBar(_:shouldRemoveRecipient:)
  • And more…

Use these delegate methods to control the recipient bar’s behavior, perform custom validation, or implement any additional features you may need.

Examples

Basic Usage Example

To demonstrate a basic usage of TURecipientBar, consider the following example:


let recipientBar = TURecipientBar(frame: CGRect(x: 0, y: 0, width: view.frame.width, height: 50))
recipientBar.delegate = self

view.addSubview(recipientBar)

Advanced Customization Example

Here is an example of how you can customize TURecipientBar to match your app’s design:


recipientBar.backgroundColor = .white
recipientBar.placeholderTextColor = .lightGray
recipientBar.autocompleteSuggestionsTintColor = .purple
recipientBar.maxVisibleRecipients = 3

Compatibility

TURecipientBar is compatible with iOS 10 and above.

Support and Contact

For any inquiries or issues, please contact our support team at support@example.com.