【dismissSearch】検索フィールドを閉じる動作をプログラムで制御するには？

dismissSearchモディファイアは、検索フィールドを非アクティブにするための機能です。
検索フィールドがアクティブな状態で、キーボードが表示されている場合にこのモディファイアを呼び出すと、キーボードが閉じられ、検索フィールドが非アクティブになります。

iOS：15.0以上
XCode（当サイトの環境）：15.0.1

dismissSearchを実行した時の効果
サンプルコード
まとめ
1. 実際の使いどころ

dismissSearchを実行した時の効果

isSearchingをfalseに設定する
検索フィールドからテキストをクリアする
検索フィールドからフォーカスを外す

サンプルコード

以下に、dismissSearchの使用例を示します。使い方を説明するためシンプルなプログラムにしています。

import SwiftUI

struct dismissSearchSmp: View {
    @State private var searchText = ""

    var body: some View {
        dismissSearchChild()
            .searchable(text: $searchText, placement:.navigationBarDrawer(displayMode: .always), prompt: "検索文字列")
    }
}

struct dismissSearchChild: View {
    @Environment(\.dismissSearch) private var dismissSearch

    var body: some View {
        NavigationStack {
            List {
                ForEach(0..<100) { index in
                    Text("Item \(index)")
                }
            }
            .navigationTitle("Searchable List")
            
            Button("検索を閉じる") {
                dismissSearch()
            }
        }
    }
}

この例では、dismissSearch関数を使用して、検索フィールドを非アクティブにするためのボタンを追加しています。
ボタンをタップすると、dismissSearchが呼び出され、検索フィールドが非アクティブになります。
これにより、キーボードが閉じられ、検索フィールドがフォーカスを失います。