iOS UISearchController样式全面设置

image

Q: 如果想要做到上图所示的搜索框需要怎么设置？

搜索框的样式设置都是基于UISearchController的searchBar也就是UISearchBar设置的。
但是UISearchBar并没有提供多少自定义设置。图标相关的设置也主要是系统提供的几种简单样式。

而iOS11和iOS11以下的搜索框由于样式不一样，很多属性的设置不尽相同。

所以这篇文章就是对怎么修改UISearchController样式的梳理

首先UISearchController主要是对UISearchBar的封装，而UISearchBar又包含了UITextField和UINavigationButton(取消按钮)

一 UITextField设置

获取TextField

有两种方法可以获取，KVC或者遍历子视图。
我们这里采用KVC，效率比较高。

let searchField = searchBar.value(forKey: "searchField")

func findTextView(in view: UIView)->UITextField {
    for view in searchBar.subviews[0].subviews {
        if view is UITextField {
            return view as! UITextField
        }
    }
    return nil
}

这里的遍历都是对seachBar.subviews[0]行遍历，如果以后在某个版本比如iOS12中如果UISearchBar的结构又发生了改变，那可能就找不到了。所以如果要使用遍历的话，还是递归seachBar的所有子视图去找比较保险。
改变属性名称的概率比较小，所以用KVO相对安全一点。

1. 图标

这里我们讨论三种图标的设置

UISearchBarIcon.search：这个是搜索框左侧的那个放大镜图标
UISearchBarIcon.bookmark：这个是搜索框右侧显示的图标，默认是不现实的。效果就是微信语音输入的那个话筒一样。
UISearchBarIcon.clear: 这个是在输入过程中显示的清除按钮。

如果设置了bookmark，在没有输入的时候显示bookmark，输入的时候显示清除按钮

代码

这三种图标都可以通过以下方法来设置。

searchBar.setImage(icon, for: .searchBar, state: .normal)

除此之外也可以获取具体的UI组件来设置
如果是想用默认的图片但只是想改变其颜色的话，

1）可以通过下面这个方法来重绘颜色。把返回的图片再通过`setImage`来设置即可。

extension UIImage {
    func reRender(with color: UIColor) -> UIImage? {
        UIGraphicsBeginImageContextWithOptions(size, false, scale)
        if let context = UIGraphicsGetCurrentContext(), let cg = cgImage {
            context.translateBy(x: 0, y: size.height)
            context.scaleBy(x: 1.0, y: -1.0)
            context.setBlendMode(.normal)
            color.setFill()
            let rect = CGRect(x: 0, y: 0, width: size.width, height: size.height)
            context.clip(to: rect, mask: cg) // 乘以alpha
            context.fill(rect)
            let newImage: UIImage? = UIGraphicsGetImageFromCurrentImageContext()
            UIGraphicsEndImageContext()
            return newImage }
        else {
            print("Failed to get current context or cgImage not exist")
            return nil
        }
    }
}
let icon = image.reRender(with: .white)
searchBar.setImage(icon, for: .searchBar, state: .normal)

2）获取UI组件，更改其渲染模式

以修改放大镜颜色为例。
这里我们定义一个属性，然后通过属性监测器来应用到图片上。这里我们取的是在文章开头定义的searchField。然后取它的左视图UIImageView来修改。

public var leftIconColor: UIColor? {
        didSet {
            if let color = leftIconColor,
               let iconView = searchField?.leftView as? UIImageView,
               let icon = iconView.image {
                    iconView.image = icon.withRenderingMode(.alwaysTemplate)
                    iconView.tintColor = color
            }

        }
    }

可以通过获取原图片然后修改图片的。
其它图标的修改请参考文末附的源码。

2. 文字相关

这部分的设置都是跟UISearchField的一样

searchField?.textColor // 文字颜色
searchField?.font // 字体
searchField?.placeholder // 占位符
searchField?.attributedPlaceholder // 富文本占位符

3. 光标颜色

通过设置searchField的tintColor即可修改光标颜色
修改searchBar的tintColor也可以达到效果，因为子视图的tintColor会自动继承父级视图。
但是设置searchBar的tintColor还会修改取消按钮的颜色。如果你想要他们同一个颜色话，直接设置seachBar更好。

4. 背景颜色

iOS11以下的直接设置searchField?.backgroundColor即可。
而iOS11的要设置

let searchFieldBackgroudView = searchField?.subviews.first
searchFieldBackgroudView.backgroundColor

二取消按钮

取消按钮就是在输入的时候显示的cancel按钮。只要设置showsCancelButton即可。

searchBar.showsCancelButton = true

因为模拟器默认语言都是英语的，所以你的取消按钮默认也是显示cancel。如果切换成中文的话显示就是取消了

而如果要自定义这个按钮的话，我们采用的也是遍历子视图获取到这个按钮的方法。

func setupCancelButton() {
    for view in searchBar.subviews[0].subviews {
        if view is UIButton { // 如果是UIButton
            let button = view as! UIButton
            //接下来就像普通button一样设置就好了
            button.setAttributedTitle(attributedTitle, for: .normal) // 通过设置副文本标题可以更改标题
            break
        }
    }
}

然后在searchBar的代理事件的searchBarShouldBeginEditing或者searchBarDidBeginEditing中调用即可。

其它还有一些细节的设置可以参考下面的源码
源码已经提交到Github上了。
并且简化了所有的属性和代理方法。
欢迎大家来提交问题和分支。
如果觉得有帮助的话记得给颗星:P