Реализация поиска с автодополнением в Swift для iOS
Автодополнение в Swift для iOS кажется простой функцией, но качественная реализация требует согласованной работы источника данных, сетевого слоя и интерфейса. Пользователь вводит запрос, ожидает быстрый ответ и не должен видеть устаревшие подсказки после изменения текста.
Рассмотрим практический путь от моделирования поискового запроса до готового элемента управления. Основное внимание уделяется асинхронным вызовам, отмене лишней работы и состояниям, которые часто упускают при быстрой разработке.
Подход охватывает локальные индексы, базы данных и удалённые API. Отдельные решения показаны для UIKit и SwiftUI, поскольку оба фреймворка позволяют создавать одинаково отзывчивый поиск, но по-разному организуют жизненный цикл запросов.
Я Равиль Зарипов, разработчик из Алматы. Моя практика охватывает приложения для Android, iOS, Windows, macOS и Linux, а также серверные компоненты и базы данных. Этот опыт помогает выбирать архитектуру, которая остаётся удобной за пределами одного экрана.
Архитектура источника подсказок
Поиск стоит разделить на независимые части: источник данных, сервис подсказок и представление. Единый контракт suggestions(for:) отделяет пользовательский интерфейс от способа получения результатов. Вместе с ним удобно задавать ограничение количества элементов и понятные ошибки.
Для небольшого локального каталога подходит массив, отсортированный по имени или релевантности. Более крупные наборы данных требуют индексации: SQLite с FTS5 или серверная полнотекстовая индексация. При удалённом поиске API должен принимать нормализованную строку и возвращать только необходимые поля.
Нормализация включает удаление лишних пробелов, приведение регистра и учёт особенностей локализации. В запросе не следует передавать необработанный пользовательский ввод: для базы данных безопаснее использовать параметризованные запросы, а для сетевого слоя — корректное URL-кодирование.
Задержка ввода и отмена запросов
Каждое изменение текста порождает потенциальный запрос, но выполнять все обращения к источнику нельзя. Задержка в 250–350 миллисекунд объединяет короткие последовательности нажатий и снижает нагрузку на сеть. Точное значение подбирается по типу данных и целевой скорости ответа.
В Swift отмена реализуется через Task. Перед запуском новой задачи предыдущую отменяют, а результат проверяют на актуальность после await. Это особенно важно, если удалённый сервер отвечает медленно: первый запрос может завершиться позже второго и вернуть неправильные подсказки.
Кэширование сокращает повторные обращения к одним и тем же префиксам. Размер кэша следует ограничивать, а срок жизни записей выбирать с учётом частоты обновления данных. Для сетевых вызовов отмена должна распространяться на URLSession, иначе сервер продолжит бесполезную работу.
Интеграция UISearchController в UIKit
UISearchController предоставляет готовую строку поиска, системную клавиатуру и стандартное поведение present-представлений. Для получения подсказок контроллер назначается в качестве searchResultsUpdater. Этот回调 вызывается при каждом изменении текста.
Ключевая часть контроллера выглядит следующим образом:
protocol SearchProviding: Sendable {
func suggestions(for query: String) async throws -> [String]
}
@MainActor
final class SearchViewController: UIViewController, UISearchResultsUpdating {
private let provider: SearchProviding
private var searchTask: Task<Void, Never>?
func updateSearchResults(for searchController: UISearchController) {
let query = searchController.searchBar.text ?? ""
searchTask?.cancel()
searchTask = Task { [weak self] in
guard let self else { return }
do {
try await Task.sleep(nanoseconds: 300_000_000)
let items = try await provider.suggestions(for: query)
guard !Task.isCancelled else { return }
showSuggestions(items)
} catch is CancellationError {
} catch {
showError(error)
}
}
}
}
Перед запуском задачи запрос очищается от пробелов, а короткие строки отбрасываются. Полученные значения передаются в источник данных таблицы или другого выбранного представления. Выбор подсказки устанавливает текст поля и запускает переход к результату.
Обновление элементов интерфейса выполняется в главном акторе. Тяжёлый парсинг и операции с базой лучше оставлять вне главного потока, чтобы прокрутка и ввод оставались плавными.
Поиск на SwiftUI
SwiftUI предоставляет модификаторы searchable и searchSuggestions. Первый создаёт поле поиска, второй связывает его с массивом подсказок. Для загрузки результатов удобно использовать task(id:): при изменении запроса предыдущая задача автоматически отменяется.
.task(id: query) {
guard query.count >= 2 else {
suggestions = []
return
}
do {
try await Task.sleep(nanoseconds: 300_000_000)
let items = try await service.suggestions(for: query)
guard !Task.isCancelled else { return }
suggestions = items
} catch {
suggestions = []
}
}
Сервис подсказок остаётся общим для UIKit и SwiftUI. Благодаря этому правила нормализации, задержки и обработки ошибок не дублируются. Если проект использует Combine, существующие потоки можно преобразовать в асинхронные вызовы, но новая логика всё равно должна учитывать отмену.
Состояния интерфейса и обработка ошибок
Поисковый экран должен явно показывать начальное состояние, загрузку, отсутствие результатов и ошибку. Спиннер появляется после задержки, чтобы короткий запрос не вызывал заметное мерцание. Если подходящих подсказок нет, полезно предложить изменить формулировку.
Ошибки сети и данные из локального кэша требуют разных реакций. При потере соединения можно показать недавние результаты с пометкой об устаревании. Ошибка разбора ответа не должна превращаться в длинное техническое сообщение для пользователя, но её полезно зафиксировать в диагностике.
Логи автодополнения не должны содержать чувствительные запросы без необходимости. Особенно это касается аналитики и журналов сервера. Интерфейс также необходимо проверить с VoiceOver, увеличенным размером текста и локализованной клавиатурой.
Тестирование и производительность
Модульные тесты используют подставной сервис, который имитирует разные задержки и ошибки. Проверяются пустой запрос, минимальная длина ввода, отмена задачи и защита от устаревшего ответа. Отдельно тестируются нормализация и порядок подсказок.
Интерфейсные тесты вводят текст, выбирают результат и проверяют переход к найденному объекту. Сценарий unavailable-сети подтверждает появление кэшированных данных. Инструменты Instruments помогают измерить задержки, allocations и влияние обновлений на главный поток.
Для сравнения вариантов можно ориентироваться на следующие характеристики:
| Критерий | UISearchController | SwiftUI | Собственная реализация |
|---|---|---|---|
| Тип проекта | Существующий UIKit-проект | SwiftUI-проект | Особые требования |
| Задержка ввода | Debounce и отмена задачи | Задача с идентификатором | Полный контроль |
| Состояния | Делегирование UIKit | Делегирование SwiftUI | Ручная реализация |
| Гибкость | Высокая | Высокая | Максимальная |
| Сложность | Низкая | Низкая | Высокая |
Собственная реализация оправдана при нестандартной визуализации, сложной фильтрации или необходимости объединить поиск с другими элементами управления. Для большинства приложений системный компонент сокращает объём кода и сохраняет привычное поведение.
Опыт, проекты и ресурсы
Мобильная разработка для меня остаётся частью более широкой практики. В портфолио представлены проекты на Delphi, FireMonkey, Kotlin, Swift и PHP, а также решения с использованием баз данных. Общие для них принципы — разделение ответственности, тестируемые контракты и контролируемая работа с ресурсами.
Материалы блога и GitHub дополняют портфолино примерами реализации и практическими заметками. Они позволяют увидеть не только отдельный экран, но и архитектурные решения, которые можно перенести в другой проект или стек.
Дополнительным ориентиром для читателей служит страница MihneaDB. Рядом с мобильным поиском она показывает, что качество пользовательского сценария зависит не только от интерфейса, но и от выбранной модели данных.
Надёжное автодополнение получается при сочетании задержки ввода, отменяемых задач, актуальных ответов и понятных состояний. Такой сценарий одинаково хорошо работает в UIKit и SwiftUI, сохраняя бизнес-логику в независимом сервисе.