ReactionButton - SwiftGit

Button

ReactionButton

November 9, 2023

Since Facebook introduced reactions in 2016, it became a standard in several applications as a way for users to interact with content. ReactionButton is a control that allows developers to add this functionality to their apps in an easy way.

Features

Support of Dark Mode
Customizable layout using ReactionButtonDelegateLayout
Extensible DataSource for the control
Layout support for scrolling interfaces (UICollectionView/UITableView)
Codable initializer for usage on storyboards
Events

Requirements

iOS 13.0+
Swift 5.0+

Installation

Installation guide

Usage

1. Basic Instance

There are multiple ways to instantiate a ReactionButton, using a frame, storyboards, or an empty convenience initializer.

Example Code


                                              
                                                let buttonSample = ReactionButton(frame: CGRect(x: 0, y: 0, width: 100, height: 100))

buttonSample.dataSource = self

view.addSubview(buttonSample)

Images from Trump reactionpacks style.

2. Delegate

The ReactionButton has a delegate to communicate events of option selection, option focus, and cancel of actions. To use it, set the ReactionButtonDelegate conform as a delegate.


                                              
                                                let buttonSample = ReactionButton(frame: CGRect(x: 0, y: 0, width: 100, height: 100))

buttonSample.delegate = self

view.addSubview(buttonSample)

Images from Trump reactionpacks style.

3. Custom layout instance

ReactionButton allows customization of the layout with the help of ReactionButtonDelegateLayout. To use it, please conform to that protocol and set it as delegate (Same pattern as UICollectionView).


                                              
                                                func ReactionSelectorConfiguration(_ selector: ReactionButton) -> ReactionButton.Config {

ReactionButton.Config(spacing: 2,

size: 30,

minSize: 34,

maxSize: 45,

spaceBetweenComponents: 30)

}

You can custom your selector with the following variables, used in the