-
🔍 An elegant search controller for iOS.
QQ chat room
Features
- Support a variety of hot search style
- Support a variety of search history style
- Support a variety of search results display mode
- Support a variety of search view controller display mode
- Support search suggestions
- Support search history (record) cache
- Support callback using delegate or block completion search
- Support CocoaPods
- Support localization
- Support vertical and horizontal screen on iPhone and iPad
Requirements
- iOS 7.0 or later
- Xcode 7.0 or later
Architecture
Main
PYSearchPYSearchConstPYSearchViewControllerPYSearchSuggestionViewController
Category
UIColor+PYSearchExtensionUIView+PYSearchExtensionNSBundle+PYSearchExtension
Contents
-
Getting Started
-
Usage
Renderings
Styles
Hot search style
Search history style
How to use
- Use CocoaPods:
pod "PYSearch"- Import the main file：
#import <PYSearch.h>
- Manual import：
- Drag All files in the
PYSearchfolder to project - Import the main file：
#import "PYSearch.h"
- Drag All files in the
Details (See the example program PYSearchExample for details)
// 1. Create hotSearches array
NSArray *hotSeaches = @[@"Java", @"Python", @"Objective-C", @"Swift", @"C", @"C++", @"PHP", @"C#", @"Perl", @"Go", @"JavaScript", @"R", @"Ruby", @"MATLAB"];
// 2. Create searchViewController
PYSearchViewController *searchViewController = [PYSearchViewController searchViewControllerWithHotSearches:hotSeaches searchBarPlaceholder:@"Search programming language" didSearchBlock:^(PYSearchViewController *searchViewController, UISearchBar *searchBar, NSString *searchText) {
// Call this Block when completion search automatically
// Such as: Push to a view controller
[searchViewController.navigationController pushViewController:[[UIViewController alloc] init] animated:YES];
}];
// 3. present the searchViewController
UINavigationController *nav = [[UINavigationController alloc] initWithRootViewController:searchViewController];
[self presentViewController:nav animated:NO completion:nil];
Custom
- Custom search suggestions display
// 1. Set dataSource
searchViewController.dataSource = self;
// 2. Implement dataSource method
- Custom search result dispaly
// 1. Set searchResultShowMode
searchViewController.searchResultShowMode = PYSearchResultShowModeEmbed;
// 2. Set searchResultController
searchViewController.searchResultController = [[UIViewController alloc] init];
- Set hotSearchStyle（default is PYHotSearchStyleNormalTag）
// Set hotSearchStyle
searchViewController.hotSearchStyle = PYHotSearchStyleColorfulTag;
- Set searchHistoryStyle（default is PYSearchHistoryStyleCell）
// Set searchHistoryStyle
searchViewController.searchHistoryStyle = PYSearchHistoryStyleBorderTag;
- Set searchHistoriesCachePath（default is PYSEARCH_SEARCH_HISTORY_CACHE_PATH）
// Set searchHistoriesCachePath
searchViewController.searchHistoriesCachePath = @"The cache path";
- Set searchHistoriesCount（default is 20）
// Set searchHistoriesCount
searchViewController. searchHistoriesCount = 6;
- Set searchResultShowMode（default is PYSearchResultShowModeCustom）
// Set searchResultShowMode
searchViewController.searchResultShowMode = PYSearchResultShowModeEmbed;
- Set searchSuggestionHidden（deafult is NO）
// Set searchSuggestionHidden
searchViewController.searchSuggestionHidden = YES;
Hope
- If you have any questions during the process or want more interfaces to customize，you can issues me!
- Instead of giving me star, it is better to throw a bug to me!
- If you want to participate in the maintenance of this project or have a good design style, welcome to pull request!
- If you feel slightly discomfort in use, please contact me QQ:499491531 or Email:[email protected].
- Hope to improve this project together, let it become more powerful, able to meet the needs of most users!
Licenses
All source code is licensed under the MIT License.
设置了Localization native development region为china，取消按钮还是cancel,代码将其修改为
182 Dec 23, 2022
568 Jan 4, 2023
95 Nov 24, 2022
358 Dec 30, 2022
2.5k Dec 21, 2022
384 Jul 20, 2022
304 Dec 29, 2022
125 Jan 13, 2022
1.2k Jan 4, 2023
3 Aug 1, 2022
183 Dec 5, 2022
79 Jan 3, 2023
43 Nov 3, 2022
118 Dec 25, 2022
51 Jan 3, 2023
19 Oct 9, 2022
166 Nov 17, 2022