Search iOS Implementation (SwiftUI & UIKit)
Implementasi antarmuka modul Search untuk platform iOS dan iPadOS memadukan fleksibilitas deklaratif SwiftUI (melalui komponen terisolasi di SearchComponents.swift) dengan kestabilan performa UIKit untuk hierarki penyaring cakupan pustaka (Search Scope).
Sumber kode: Source/Features/Search/iOS/
1. Arsitektur Komponen Visual
Arsitektur antarmuka pencarian pada iOS membagi tanggung jawab ke dalam komponen masukan terisolasi dan daftar hasil reaktif:
A. Hierarki Komponen Pencarian
flowchart TD
SMV["SearchModeView (SwiftUI Root)"]
SVM["SearchViewModel"]
SMV <-->|"Data Flow"| SVM
SMV ~~~ COMP
COMP["SearchComponents (InputBar, Progress, Toolbar)"]
RLIST["SearchResultsListView"]
SMV --> COMP
SMV --> RLIST
RLIST ~~~ F_WRAP
F_WRAP["FilterSheet (Scope Bridge)"]
F_VC["iOSSearchFilterViewController (UIKit)"]
SMV -.->|"Present Sheet"| F_WRAP
F_WRAP --> F_VC
F_VC ~~~ NM
NM["iOSNavigationManager"]
RV["iOSReaderView (Reader Engine)"]
ITV["iOSIbarotTextView (UITextView)"]
RLIST -->|"onResultTap"| NM
NM --> RV
RV --> ITV
classDef ui fill:#e040fb26,stroke:#c026d3,stroke-width:2px;
classDef vm fill:#3b82f626,stroke:#2563eb,stroke-width:2px;
classDef store fill:#22c55e26,stroke:#16a34a,stroke-width:2px;
classDef db fill:#f9731626,stroke:#ea580c,stroke-width:2px;
classDef event fill:#be185d26,stroke:#9d174d,stroke-width:2px,color:#9d174d;
class SMV,COMP,RLIST,F_WRAP,F_VC,RV,ITV ui;
class SVM vm;
class NM store;
B. Taksonomi Sub-Komponen SearchComponents.swift
mindmap
root((SearchComponents))
Masukan & Kontrol
SearchInputBar["Kolom input teks & kendali fokus keyboard"]
SearchHistoryOverlay["Overlay 20 pencarian terakhir"]
SearchProgressView["Indikator rasio progres pencarian"]
SearchToolbar["Tombol filter cakupan & menu pengurutan"]
Penyajian Hasil
SearchResultsListView["LazyVStack / List performa tinggi"]
SearchResultItem["Sel baris RTL dengan info juz & halaman"]
AttributedString["Sorotan kuning native pada kata cocok"]
Penyaring Cakupan
FilterSheet["Jembatan UIViewControllerRepresentable"]
ScopeTree["Hierarki pilihan kategori & kitab UIKit"]
2. Alur Interaksi: Dari Aksi Klik Hasil Pencarian ke TextView
Ketika pengguna mengetuk salah satu baris hasil pencarian di SearchResultsListView:
sequenceDiagram
autonumber
actor User as Pengguna
participant Item as SearchResultItemView
participant List as SearchResultsListView
participant Nav as iOSNavigationManager
User->>+Item: Ketuk baris hasil pencarian
Item->>+List: onResultTap(result)
List->>+Nav: openBook(book, initialContentId: result.page, searchResult: result)
deactivate Nav
deactivate List
deactivate Item
sequenceDiagram
autonumber
participant Nav as iOSNavigationManager
participant Rdr as iOSReaderView
participant VM as ReaderViewModel
participant TV as iOSIbarotTextView
Nav->>+Rdr: Tampilkan pembaca dengan parameter pencarian
Rdr->>+VM: loadContent(contentId: result.page, searchResult: result)
VM->>VM: BookConnection.getContent() & render()
VM->>VM: Hitung highlightRanges kata kunci (latar kuning)
VM-->>-Rdr: State siap (contentText berlatar kuning)
Rdr->>+TV: updateUIView(attributedText)
TV->>TV: UITextView.attributedText = renderedText
TV->>TV: scrollRangeToVisible(matchedWordRange)
deactivate TV
deactivate Rdr
3. Bedah Komponen Antarmuka Utama
1. SearchModeView (Struct) - Root View
- Menjadi kontainer utama antarmuka pencarian yang mengelola lapisan
ZStackdanOverlay. - Mengatur toolbar pengurutan dinamis, penyajian lembar modal (sheets) menuju histori pencarian tersimpan (Saved Results), dan pemberitahuan migrasi basis data FTS bila diperlukan.
2. Sub-Komponen Modular (SearchComponents)
SearchInputBar: Kolom input pencarian utama dengan integrasi@FocusStateuntuk manajemen keyboard, tombol pembersih teks instan, dan indikator status aktif.SearchHistoryOverlay: Hamparan mengambang yang menampilkan daftar 20 kueri pencarian terakhir saat kolom teks aktif, memudahkan pencarian berulang tanpa mengetik ulang.SearchProgressView: Bilah kemajuan yang menampilkan rasio pencarian secara riil (jumlah arsip/halaman yang telah dipindai dari total koleksi).SearchToolbar: Bilah tombol aksi untuk menyaring cakupan pustaka, mengubah mode pencarian (Frasa, Dan/Atau, Dekat), serta mengatur urutan hasil pencarian.
3. SearchResultsListView (Struct) & Rendering Teks Tersorot
- Menyajikan baris hasil pencarian dengan tata letak teks Arab Kanan-ke-Kiri (RTL).
- Kompatibilitas AttributedString: Mengonversi
NSAttributedString(Foundation) dari hasil pencarian FTS menjadi tipe nilai SwiftUIAttributedString, memungkinkan rendering sorotan warna kuning pada suku kata yang cocok secara native tanpa hambatan performa tata letak.
4. iOSSearchFilterViewController (Class) - Penyaring Cakupan / Scope
- Menggunakan
UIViewControllerRepresentable(SearchFilterUIKitView) untuk memuat struktur hierarki pustaka UIKit (hierarchical outline). - Menangani seleksi multi-pilihan kategori atau kitab dengan performa tinggi saat menyaring ratusan kategori secara bersamaan.
- Menyalurkan aksi menu konteks "Informasi Kitab" via callback
onShowBookInfoyang diteruskan kenavigationManager.selectedBookForInfountuk disajikan di tingkat rootiOSMainView.