一、UISearchBar 的介绍和用途
搜索框 UISearchBar
搜索框广泛应用于App中，在很多商品中能够使你快速找到你想要的商品，就是搜索框的功能。
二、UISearchBar 的属性和方法介绍
1、初始化&设置大小&渲染
/**
搜索框的初始化
*/
let NetWorkSearchBar = UISearchBar.init()
/**
设置大小
注意：无论我们设置多少，都不会影响显示的样式。但可以改变背景高度。
*/
NetWorkSearchBar.frame = CGRect.init(x: 20, y: 30, width: 200, height: 40)
/**
渲染
*/
self.view.addSubview(NetWorkSearchBar)
2、搜索框的样式
/**
设置样式
black: 搜索框整体都是黑色
blackTranslucent :搜索框整体都是黑色 ,等同于 black
default : 默认，背景为灰色，搜索框为白色
blackOpaque : 搜索框整体都是黑色 ,等同于 black
*/
NetWorkSearchBar.barStyle = .blackOpaque
3、搜索框的代理
/**
搜索框的代理事件
*/
NetWorkSearchBar.delegate = self
代理方法
// TODO: 搜索编辑结束时候调用
func searchBarTextDidEndEditing(_ searchBar: UISearchBar) {
print("搜索编辑结束")
}
// TODO: 搜索清楚按钮被点击的时候调用
func searchBarCancelButtonClicked(_ searchBar: UISearchBar) {
print("搜索清楚按钮被点击了")
}
// TODO : 搜索开始编辑的时候调用该函数
func searchBarTextDidBeginEditing(_ searchBar: UISearchBar) {
print("用户开始编辑")
}
// TODO : 收索框标志按钮被点击调用该函数
func searchBarBookmarkButtonClicked(_ searchBar: UISearchBar) {
print("标志按钮被点击")
}
// TODO: 搜索按钮被点击的时候调用
func searchBarSearchButtonClicked(_ searchBar: UISearchBar) {
print("搜索按钮被点击了")
}
//TODO :搜索记录列表被点击
func searchBarResultsListButtonClicked(_ searchBar: UISearchBar) {
print("搜搜记录列表被点击")
}
// TODO : 控制是否允许用户搜索编辑结束
func searchBarShouldEndEditing(_ searchBar: UISearchBar) -> Bool {
return true
}
// TODO : 控制是否允许用户搜索编辑开始
func searchBarShouldBeginEditing(_ searchBar: UISearchBar) -> Bool {
return true
}
// TODO: 这能够获取搜索框输入的文字变化
func searchBar(_ searchBar: UISearchBar, textDidChange searchText: String) {
print(searchText)
}
//TODO : 这搜索按钮分类栏的选择时，调用该函数
func searchBar(_ searchBar: UISearchBar, selectedScopeButtonIndexDidChange selectedScope: Int) {
}
// TODO:控制搜索框文字的输入
func searchBar(_ searchBar: UISearchBar, shouldChangeTextIn range: NSRange, replacementText text: String) -> Bool {
return true
}
4、设置搜索文字& 悬浮提示& 默认提示
/**
设置文字
*/
NetWorkSearchBar.text = "搜一搜"
/**
搜索框上的悬浮标志
*/
NetWorkSearchBar.prompt = "我是谁"
/**
搜索框提示文字
*/
NetWorkSearchBar.placeholder = "来一来"
6、是否要显示标志按钮& 搜索历史按钮& 取消搜索按钮 & 分类按钮
/**
是否显示标志按钮
*/
NetWorkSearchBar.showsBookmarkButton = true;
/**
搜索历史下拉列表按钮
*/
NetWorkSearchBar.showsSearchResultsButton = true
/**
是否显示取消按钮
*/
NetWorkSearchBar.showsCancelButton = true
/**
是否显示分类标签
*/
NetWorkSearchBar.showsScopeBar = true
7、设置背景色& 透明度
/**
光标是红色和取消按钮是红色
*/
NetWorkSearchBar.tintColor = UIColor.red
/**
背景是蓝色
*/
NetWorkSearchBar.barTintColor = UIColor.blue
/**
控制收索框的透明度
*/
NetWorkSearchBar.isTranslucent = true
8、设置搜索分类的文字& 图片&获取某一状态的图片
/**
设置搜索分类下的文字
*/
NetWorkSearchBar.scopeButtonTitles = ["水果","旅游"]
/* 设置分类按钮选中第几个*/
NetWorkSearchBar.selectedScopeButtonIndex = 1
/* 是否显示分类标签*/
NetWorkSearchBar.showsScopeBar = true
/* 设置分类标签的背景图片*/
NetWorkSearchBar.scopeBarBackgroundImage = UIImage.init(named: "test.png")
/**
设置搜索分类某一状态的背景图片
*/
NetWorkSearchBar.setScopeBarButtonBackgroundImage(UIImage.init(named: "test.png"), for: .selected)
/* 获取分类标签某一状态的背景图片*/
let bIamge = NetWorkSearchBar.scopeBarButtonBackgroundImage(for:.selected)
print(bIamge!)
/**
修改分类按钮的文字和样式
*/
NetWorkSearchBar.setScopeBarButtonTitleTextAttributes([NSFontAttributeName:UIFont.systemFont(ofSize: 10),NSForegroundColorAttributeName:UIColor.red], for: .selected)
9、设置搜索标签按某个状态的图片& 获取图片
/**
设置搜索控件上各个标签按钮的图片
search 收索按钮
clear 清楚按钮
bookmark 书页按钮
resultsList 搜索历史按钮
*/
NetWorkSearchBar.setImage(UIImage.init(named: "test.png"), for: UISearchBarIcon.search, state: UIControlState.selected)
/* 获取某个按钮某一状态下的图片*/
let xImage = NetWorkSearchBar.image(for: .search, state: .selected)
print(xImage!)
10、设置搜索框的背景图片& 获取背景图片
/**
设置搜索分类某一状态的背景图片
*/
NetWorkSearchBar.setScopeBarButtonBackgroundImage(UIImage.init(named: "test.png"), for: .selected)
/* 获取分类标签某一状态的背景图片*/
let bIamge = NetWorkSearchBar.scopeBarButtonBackgroundImage(for:.selected)
print(bIamge!)
