- 🔍 An elegant search controller for iOS.
- 🔍 iOS 中一款优雅的搜索控制器。
- 支持多种热门搜索风格
- 支持多种搜索历史风格
- 支持多种搜索结果显示模式
- 支持搜索建议
- 支持搜索历史(记录)缓存
- 支持使用delegate 或者 block 完成搜索时的回调
- 支持CocoaPods
- iOS 7.0 or later
- Xcode 8.0 or later
-
Getting Started
-
Usage
- 使用CocoaPods:
pod "PYSearch"
- 导入主头文件
#import <PYSearch.h>
- 手动导入:
- 将
PYSearch
文件夹中的所有文件拽入项目中 - 导入主头文件
#import "PYSearch.h"
- 将
// 1. 创建热门搜索数组
NSArray *hotSeaches = @[@"Java", @"Python", @"Objective-C", @"Swift", @"C", @"C++", @"PHP", @"C#", @"Perl", @"Go", @"JavaScript", @"R", @"Ruby", @"MATLAB"];
// 2. 创建搜索控制器
PYSearchViewController *searchViewController = [PYSearchViewController searchViewControllerWithHotSearches:hotSeaches searchBarPlaceholder:@"搜索编程语言" didSearchBlock:^(PYSearchViewController *searchViewController, UISearchBar *searchBar, NSString *searchText) {
// 开始(点击)搜索时执行以下代码
// 如:设置搜索结果控制器标题searchViewController.searchResultController.title = @"PYSearchResultController";
}];
// 3. 跳转到搜索控制器
UINavigationController *nav = [[UINavigationController alloc] initWithRootViewController:searchViewController];
[self presentViewController:nav animated:NO completion:nil];
- 设置热门搜索风格(默认为PYHotSearchStyleNormalTag)
// 设置热门搜索为彩色标签风格
searchViewController.hotSearchStyle = PYHotSearchStyleColorfulTag;
- 设置搜索历史风格(默认为PYSearchHistoryStyleCell)
// 设置搜索历史为带边框标签风格
searchViewController.searchHistoryStyle = PYSearchHistoryStyleBorderTag;
- 设置搜索结果显示模式(默认为PYSearchResultShowModePush)
// 设置搜索模式为内嵌
searchViewController.searchResultShowMode = PYSearchResultShowModeEmbed;
- 隐藏搜索建议(默认为:NO)
// 隐藏搜索建议
searchViewController.searchSuggestionHidden = YES;
- 如果您在使用过程中有任何问题,欢迎issue me! 很乐意为您解答任何相关问题!
- 与其给我点star,不如向我狠狠地抛来一个BUG!
- 如果想要参与这个项目的维护或者有好的设计风格,欢迎pull request!
- 如果您想要更多的接口来自定义或者建议/意见,欢迎issue me!我会根据大家的需求提供更多的接口!
All source code is licensed under the MIT License.