NBEmojiSearchView
Integrate a searchable emoji dropdown into your iOS app in just a few lines.
To start searching, the user just types a :. Then, the emojiSearchView will automatically parse text to find the user's search query and display results appropriately. When the user selects an emoji, the emojiSearchView will automatically insert it into the correct location in the textField or textView.
##Installation ###CocoaPods CocoaPods is a dependency manager for Objective-C, which automates and simplifies the process of using 3rd-party libraries like NBEmojiSearchView in your projects.
pod "NBEmojiSearchView"
###Alternative Alternatively, you can just drag the Source folder into your project.
##Usage Instantiate an NBEmojiSearchView, then install it on a UITextField or UITextView as shown below.
NBEmojiSearchView *emojiSearchView = [[NBEmojiSearchView alloc] init];
then
[emojiSearchView installOnTextField:textField];
or
[emojiSearchView installOnTextView:textView];
You control sizing and placement of the emojiSearchView. The emojiSearchView will appear and disappear at the appropriate times automatically.
###Customization
The UITableView that displays results is exposed.
@property (nonatomic, strong) UITableView *tableView;
Animation
The appearance and disappearance animations. Set these blocks with custom animations you'd like the emojiSearchView to execute.
If you choose to customize these the appear or disappear animation, you MUST call appearAnimationDidFinish or disappearAnimationDidFinish when the animation completes, respectively.
@property (nonatomic, copy) void (^appearAnimationBlock)(); "Default: A non-animated alpha change from 0.0 to 1.0."
@property (nonatomic, copy) void (^disappearAnimationBlock)(); "Default: A non-animated alpha change from 1.0 to 0.0."
Example
self.emojiSearchView.appearAnimationBlock = ^{
[UIView animateWithDuration:0.2 animations:^{
weakSelf.emojiSearchView.alpha = 1.0;
} completion:^(BOOL finished) {
[weakSelf.emojiSearchView appearAnimationDidFinish];
}];
};
Other Visuals
The font of the emoji result cells.
@property (nonatomic, strong) UIFont *font;
The text color of the emoji result cells.
@property (nonatomic, strong) UIColor *textColor;
The header title of the tableView that displays emoji search results.
@property (nonatomic, strong) NSString *headerTitle;
###Delegate Methods
These delegate methods revolve around the appearance and disappearance of the search view. Please let me know or PR if you'd like additional delegate methods.
- (void)emojiSearchViewWillAppear:(NBEmojiSearchView *)emojiSearchView;
- (void)emojiSearchViewDidAppear:(NBEmojiSearchView *)emojiSearchView;
- (void)emojiSearchViewWillDisappear:(NBEmojiSearchView *)emojiSearchView;
- (void)emojiSearchViewDidDisappear:(NBEmojiSearchView *)emojiSearchView;
71 Jul 17, 2022
289 Jun 13, 2022
0 Jan 2, 2022
691 Nov 20, 2022
1.3k Dec 26, 2022
3.4k Dec 21, 2022
2.7k Dec 28, 2022
194 Nov 14, 2022
531 Dec 26, 2022
65 Jun 27, 2021
307 Oct 17, 2022
1k Nov 20, 2022
301 Jun 29, 2022
24 Dec 8, 2022
87 Mar 30, 2022
63 Sep 22, 2022
127 Nov 20, 2022
2 May 9, 2022
38 Aug 30, 2022
643 Sep 8, 2022
93 Nov 12, 2022
478 Dec 30, 2022
101 Nov 7, 2022
15k Jan 8, 2023
125 Sep 27, 2021
337 Dec 24, 2022
3.7k Dec 31, 2022
98 Dec 27, 2022
39 Dec 22, 2022