[swift] searchBarに何も入力されていない時tableViewを消したい

Question

前提・実現したいこと

検索された場所を基準として特定の施設を検索できるiPhone用アプリを作っています。
下記のiOSのマップように、searchbarをタップし地名などを入れると検索候補がtableViewで表示され、
searchBarがキャンセルボタン押下で空欄になったりキーボードで文字を削除して空欄になったりしたときにはtableViewを削除したいのですが、うまく行きません。
キャンセルボタンをおしたとき、一度searchBarに入力した単語を削除したときにtableViewを消すにはどうしたら良いのでしょうか。

![]

発生している問題・エラーメッセージ

現状はこのように、searchBarが空欄でもtableViewが残ってしまいます。

該当のソースコード

import UIKit
import MapKit

var tableView: UITableView!

class ViewController: UIViewController, UISearchBarDelegate, MKMapViewDelegate, MKLocalSearchCompleterDelegate {
    
    @IBOutlet weak var mapView: MKMapView!
    @IBOutlet weak var searchBar: UISearchBar!
     
    var locationManager: CLLocationManager?
    var annotationArray: [CustomAnnotation] = []
    var completer =  MKLocalSearchCompleter()
    
    override func viewDidLoad() {
        super.viewDidLoad()
      
        self.mapView.delegate = self
        searchBar.delegate = self
        
        completer.delegate = self
        completer.filterType = .locationsOnly
    }
    
    
    //キーボードの検索ボタンクタップ時に呼ばれるメソッド
    func searchBarSearchButtonClicked(_ searchBar: UISearchBar) {
        //キーボードを閉じる
        searchBar.resignFirstResponder()
        //キャンセルボタンの表示
        searchBar.setShowsCancelButton(false, animated: true)
        
        //入力された文字を取り出す
        if let searchKey = searchBar.text {
            //入力された文字をデバッグに表示
            print(searchKey)
            
            //CLGeocoderインスタンスを取得
            let geocoder = CLGeocoder()
            
            //入力された文字から位置情報を取得しマップにアノテーションを表示する処理。省略。
                            
                            //データベースを検索するメソッドを行う
                            self.searchDB(keyword: searchKey)
    }
    
      
    //jsonの中身を受け取るデータ構造
    struct Databaser: Codable {
     // 省略
    }

    //データベースを検索するメソッド
    func searchDB (keyword: String) {
        //省略
    }
    
    //アノテーションビューを返すメソッド
    func mapView(_ mapView: MKMapView, viewFor annotation: MKAnnotation) -> MKAnnotationView? {
        //省略
    }
}

extension ViewController: UITableViewDelegate, UITableViewDataSource {

    func searchBar(_ searchBar: UISearchBar, textDidChange searchText: String) {
        
        let tableView = UITableView(frame: CGRect(x: 32, y: 120, width: view.frame.width - 100, height: view.frame.height / 3))
        tableView.register(UITableViewCell.self, forCellReuseIdentifier: "data")
        tableView.separatorStyle = .none
        tableView.delegate = self
        tableView.dataSource = self
        tableView.tableFooterView = UIView()
        
        if searchBar.text != "" {
            self.view.addSubview(tableView)
        } else {
            tableView.removeFromSuperview()
        }
        
        searchBar.setShowsCancelButton(true, animated: true)
    }
    
    //入力に変更があった際に呼び出されるメソッド.
    func searchBar(_ searchBar: UISearchBar, shouldChangeTextIn range: NSRange, replacementText text: String) -> Bool {
        guard let text = searchBar.text else { return false }
        completer.queryFragment = text
        return true
    }
    
    func tableView(_ tableView: UITableView, heightForRowAt indexPath: IndexPath) -> CGFloat {

        tableView.estimatedRowHeight = 20 
        return UITableView.automaticDimension
    }
    
    //tableViewが何行か決めるメソッド
    func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
        return completer.results.count
    }
    
    //tableViewのセルの内容を決めるメソッド
    func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
        let identifier = "Cell"
        var cell = tableView.dequeueReusableCell(withIdentifier: identifier)
        
        if (cell == nil) {
            cell = UITableViewCell(style: .default, reuseIdentifier: identifier)
        }
        
        cell?.textLabel?.text = completer.results[indexPath.row].title
        return cell!
    }
    
    // セルを選択したときのメソッド
    private func tableView(tableView: UITableView, didSelectRowAtIndexPath indexPath: NSIndexPath) {
        
    }
    
    // キャンセルボタンタップ時に呼び出されるメソッド.
    func searchBarCancelButtonClicked(_ searchBar: UISearchBar) {
        searchBar.resignFirstResponder()
        searchBar.setShowsCancelButton(false, animated: true)
        searchBar.removeFromSuperview()
    }
}

修正後
import UIKit
import MapKit

class ViewController: UIViewController, UISearchBarDelegate, MKMapViewDelegate, UITableViewDelegate, UITableViewDataSource,MKLocalSearchCompleterDelegate {

    @IBOutlet weak var mapView: MKMapView!
    @IBOutlet weak var searchBar: UISearchBar!
    @IBOutlet weak var tableView: UITableView!
    var locationManager: CLLocationManager?
    var annotationArray: [CustomAnnotation] = []
    var completer =  MKLocalSearchCompleter()
    
    override func viewDidLoad() {
        super.viewDidLoad()
        //省略
        
        searchBar.delegate = self
        tableView.delegate = self
        tableView.dataSource = self
        tableView.isHidden = true
        completer.delegate = self
        completer.filterType = .locationsOnly
    }
    
    
    
    func searchBar(_ searchBar: UISearchBar, textDidChange searchText: String) {
        
        if searchBar.text != "" {
            tableView.isHidden = false
        } else {
            tableView.isHidden = true
        }
        
        searchBar.setShowsCancelButton(true, animated: true)
    }
    
    func searchBarSearchButtonClicked(_ searchBar: UISearchBar) {
        //キーボードを閉じる
        searchBar.resignFirstResponder()
        //キャンセルボタンの表示
        searchBar.setShowsCancelButton(false, animated: true)
        
        //入力された文字を取り出す
        if let searchKey = searchBar.text {
            //入力された文字をデバッグに表示
            print(searchKey)
            
            //CLGeocoderインスタンスを取得
            let geocoder = CLGeocoder()
            //入力された文字列から位置情報を取得してアノテーションで表示する処理。省略。
        }
    }
    
    //入力に変更があった際に呼び出されるメソッド.
    func searchBar(_ searchBar: UISearchBar, shouldChangeTextIn range: NSRange, replacementText text: String) -> Bool {
        guard let text = searchBar.text else { return false }
        completer.queryFragment = text
        return true
    }
    
    // キャンセルボタンタップ時に呼び出されるメソッド.
    func searchBarCancelButtonClicked(_ searchBar: UISearchBar) {
        searchBar.setShowsCancelButton(false, animated: true)
        tableView.isHidden = true
    }
    
    //tableViewが何行か決めるメソッド
    func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
        return completer.results.count
    }
    
    //セルの内容を設定するメソッド
    func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
        let identifier = "Cell"
        var cell = tableView.dequeueReusableCell(withIdentifier: identifier)
        
        if (cell == nil) {
            cell = UITableViewCell(style: .default, reuseIdentifier: identifier)
        }
        
        cell?.textLabel?.text = completer.results[indexPath.row].title
        return cell!
    }
    
    func tableView(_ tableView: UITableView, heightForRowAt indexPath: IndexPath) -> CGFloat {
        tableView.estimatedRowHeight = 20
        return UITableView.automaticDimension
    }
    
    // セルを選択したときのメソッド
    private func tableView(tableView: UITableView, didSelectRowAtIndexPath indexPath: NSIndexPath) {
        
    }

}

試したこと

searchBarに文字が何かしら文字が入力されている時はaddSubviewでtableViewを表示し、
何も入力されていない時はremoveFromSuperview()すればいいのかと思いifで分岐してみましたがうまくいきませんでした。

補足情報（FW/ツールのバージョンなど）

こちらを参考にここまで作りました。
https://github.com/hanawat/local-search-completer

Answer 1

テーブルそのものを非表示にしたいならtableView.isHhidden = true、
セルを非表示（というかクリア）したいなら、resultsを空っぽにしてテーブルをリロードして下さい。

Comments

[Tajiko]

さっそくご回答いただきありがとうございます。

お教えいただいた通りキャンセルボタンを押した時にテーブルを消したいので searchBarCancelButtonClickedメソッドの中で
tableView.isHidden = true　としたのですがエラーが出てしまいました。

エラー：
Ambiguous reference to member 'tableView(_:heightForRowAt:)'

エラーの解釈は、
searchBarに何かしら単語が入力されてからtableVeiwを作ればいいと考えていたため
tableViewをインスタンス化するのを
func searchBar(_ searchBar: UISearchBar, textDidChange searchText: String)
の中に書いてしまっています。なのでtableViewという変数がsearchBarCancelButtonClickedでは認識できない、という解釈で合っていますいますでしょうか。

また、上記の解釈で合っている場合は、tableViewを生成する記述を他の場所に書く（例えば、他のクラスに書くなど？）した方がよいということでしょうか。

[fuzzball]

認識していないのではなく、グローバル変数のtableViewを参照しようとしてエラーになっているようですね。（理由は分かりません）

ひとまず現状でおかしな点を修正しましょう。

・グローバル変数のtableViewをインスタンス変数に変更する。
・テーブルビューの生成時/参照時はそのインスタンス変数を使うようにする。
・テーブルビューの生成はサーチバーの生成時に。
・searchBar(_:textDidChange:)の中では、表示/非表示の切り替えだけおこなう。
・searchBarCancelButtonClicked(_:) は、そのExtensionに入れるべきではない。（これはオマケです）

ちゃんとソース全体を見ていないので、細かいところはご自分で適宜修正をお願いします。

[Tajiko]

ありがとうございます。

グローバル変数をやめ、storyboard上にTableViewを配置し、isHiddenで表示非表示をそれぞれのメソッドで設定しました。また、ectensionをやめ普通にViewControllerの中に全てのメソッドを入れました。そうしましたらtableViewについてはサーチバーに文字が入力されている時だけ表示され、文字が何もない時はひい表示にすることができました。ありがとうございます。

しかし、今度はtableViewに検索候補地が表示されなくなってしまいました。

重ね重ね大変申し訳ないのですが、修正後のコードを本文に追加いたしましたのでもう一度ご指導いただけないでしょうか。よろしくお願いいたします。

[Tajiko]

申し訳ございません。22:28のコメントは私の凡ミスにより発生しているものでした。
無事解決いたしました。
fuzzball様、いつもありがとうございます。