Keyboard Avoidance — mohiyati, amalga oshirish usullari va interfeysning siljishi

Keyboard Avoidance nima

Keyboard Avoidance — iOS da tizim klaviaturasi paydo bo'lganda faol kiritish maydonining ko'rinishini ta'minlaydigan texnikalar to'plamidir. Asosiy muammo: klaviatura ekranning 50% gacha qismini egallaydi va interfeysning pastki yarmini, jumladan matn maydonlari, jo'natish tugmalari va boshqa elementlarni yopadi.

Amalga oshirishning uchta asosiy yondashuvi mavjud: Keyboard Notifications orqali qo'lda boshqarish (klassik usul, iOS 3.0 dan ishlaydi), avtomatik aylantirish bilan UIScrollView dan foydalanish (Apple tomonidan tavsiya etiladi) va Keyboard Layout Guide (iOS 15+ dan zamonaviy usul). Tanlov eng kam qo'llab-quvvatlanadigan iOS versiyasiga va interfeys murakkabligiga bog'liq.

Apple ma'lumotlariga ko'ra, Keyboard Avoidance ning yo'qligi, matn maydonlari klaviatura tomonidan to'liq yopilganda ilovalarning rad etilishining eng keng tarqalgan sabablaridan biridir. App Store ko'rsatmalari barcha interaktiv elementlarning faol kiritish vaqtida mavjud bo'lishini aniq talab qiladi.

Nega iOS buni avtomatik bajarmaydi

iOS qaysi element ko'rinadigan bo'lishi kerakligini avtomatik aniqlay olmaydi, chunki u interfeys semantikasini bilmaydi. Bitta matn maydoni bo'lgan oddiy formada butun ekranni siljitish kifoya. Maxsus panellar, suzuvchi tugmalar va bir nechta bo'limlarga ega murakkab interfeysda har xil xatti-harakatlar mantig'i talab qilinadi.

Bundan tashqari, ba'zi ilovalar ataylab kontentni siljitmaydi — masalan, klaviatura kalkulyatorlari yoki muharrirlar, bu erda klaviatura ish maydonining bir qismidir. iOS har qanday stsenariy uchun moslashuvchan API-larni taqdim etib, qarorni ishlab chiqaruvchiga qoldiradi.

Keyboard Frame Notifications

UIKeyboardWillShowNotification — iOS klaviatura paydo bo'lishidan oldin yuboradigan asosiy bildirishnomadir. U UIResponder.keyboardFrameEndUserInfoKey lug'atida klaviaturaning yakuniy pozitsiyasi bilan CGRect, shuningdek UIResponder.keyboardAnimationDurationUserInfoKey da animatsiya davomiyligini o'z ichiga oladi.

Bildirishnoma ishlovchisi faol matn maydoni va klaviatura o'rtasidagi qoplanishni hisoblashi, so'ngra konteynerning pastki bo'shlig'ini (contentInset yoki frame) o'zgartirishi kerak. Maydon klaviaturaning yuqori chetidan pastda bo'lsa, kontent qoplanish miqdoriga qadar yuqoriga siljiydi. Klaviatura yashiringanda bo'shliq asl qiymatiga qaytadi.

@objc func keyboardWillShow(_ notification: Notification) {
    guard let keyboardFrame = notification
        .userInfo?[UIResponder.keyboardFrameEndUserInfoKey]
        as? CGRect else { return }
    
    let keyboardHeight = keyboardFrame.height
    scrollView.contentInset.bottom = keyboardHeight
    scrollView.verticalScrollIndicatorInsets.bottom = keyboardHeight
}

Bildirishnomalardan foydalanganda animatsiyani tizim klaviaturasi bilan sinxronlashtirish muhimdir. iOS animatsiya egri chizig'ini (UIResponder.keyboardAnimationCurveUserInfoKey) va davomiylikni uzatadi. UIView.animate ni ushbu parametrlar bilan ishlating, shunda kontent klaviatura bilan bir vaqtda silliq siljiydi.

iOS 15+ da Keyboard Layout Guide

UIScrollView.keyboardLayoutGuide — iOS 15 da taqdim etilgan Keyboard Avoidance uchun zamonaviy API. U klaviaturaning o'rnini avtomatik kuzatadi va interfeysning pastki qismini klaviaturaning yuqori cheti bilan bog'laydigan Auto Layout cheklovlarini yangilaydi.

Foydalanish uchun UIScrollView yoki UIStackView da layout guide-ni faollashtirish va kontentning pastki cheklovini unga ulash kifoya. Bildirishnomalar, balandlikni hisoblash va animatsiya bilan hech qanday qo'l ishi talab qilinmaydi — tizim hamma narsani avtomatik bajaradi, animatsiyani klaviaturaning paydo bo'lishi va yashirinishi bilan sinxronlashtiradi.

// Keyboard Layout Guide-ni yoqing (iOS 15+)
scrollView.keyboardLayoutGuide.followsUndockedKeyboard = true

// Pastki cheklovni klaviatura tepasiga mahkamlang
contentView.bottomAnchor.constraint(
    equalTo: scrollView.keyboardLayoutGuide.topAnchor
).isActive = true

followsUndockedKeyboard — guide pastki chetidan ajratilishi mumkin bo'lgan klaviaturaga (iPad da) reaksiya berishini aniqlaydigan xususiyat. Faqat interfeys to'g'ri ishlasa suzuvchi klaviatura bilan true qo'ying. iPhone uchun bu xususiyat e'tiborga olinmaydi — klaviatura doimo pastki chetiga bog'langan.

UIScrollView va klaviatura

UIScrollView — Apple Keyboard Avoidance uchun asos sifatida foydalanishni tavsiya qiladigan konteynerdir. Klaviatura paydo bo'lganda, scroll view o'zining contentInset.bottom qiymatini oshiradi, kontentni yuqoriga aylantirishga va faol maydonni ko'rinadigan qilishga imkon beradi.

Asosiy metod — scrollRectToVisible, scroll view-ni dasturiy ravishda shunday aylantiradiki, belgilangan to'rtburchak (faol matn maydoni) ko'rinadigan sohada bo'ladi. contentInset o'zgarishini scrollRectToVisible chaqiruvi bilan birlashtirib, maydon nafaqat yopilmaganligini, balki ko'rinadigan sohaning yuqori qismida joylashganligini kafolatlaysiz.

func adjustScrollForKeyboard(
    keyboardHeight: CGFloat,
    activeField: UIView
) {
    scrollView.contentInset.bottom = keyboardHeight
    scrollView.verticalScrollIndicatorInsets.bottom = keyboardHeight
    
    var visibleRect = view.frame
    visibleRect.size.height -= keyboardHeight
    
    if activeField.frame.origin.y > visibleRect.maxY {
        scrollView.scrollRectToVisible(
            activeField.frame, animated: true
        )
    }
}

UITableView bilan UIViewController uchun Apple klaviatura paydo bo'lganda contentInset-ni avtomatik tuzatadigan UITableViewController dan foydalanishni tavsiya qiladi. Agar qo'shilgan jadval bilan UIViewController dan foydalanayotgan bo'lsangiz, Keyboard Avoidance-ni qo'lda amalga oshirishingiz kerak bo'ladi — UITableViewController maxsus kontrollerlar uchun bu xatti-harakatni ta'minlamaydi.

Auto Layout va Keyboard Avoidance

Auto Layout animatsiyalarni dasturlashtirmasdan Keyboard Avoidance-ni amalga oshirish imkonini beradi — klaviatura bildirishnomasiga javoban ma'lum bir cheklovning faolligini (isActive) o'zgartirish yoki uning konstantasini yangilash kifoya.

Odatiy sxema: scroll view yoki kontentning pastki bo'shlig'i uchun IBOutlet NSLayoutConstraint yarating va keyboardWillShow ishlovchisida constraint.constant = keyboardHeight qo'ying, keyboardWillHide da esa 0 ga qaytaring. Silliq o'tish uchun animate bloki ichida layoutIfNeeded orqali layout-ni yangilang.

UIStackView dan foydalanganda, pastki bo'shliq cheklovlarini o'zgartirish ham ishlaydi: stack view barcha bolalar elementlarini avtomatik qayta taqsimlaydi. Biroq, agar stack view UIScrollView ichida bo'lsa, uning ichidagi cheklovlarni emas, balki scroll view ning o'zining contentInset-ni boshqarish afzalroqdir.

Keyboard Avoidance uchun uchinchi tomon yechimlari

IQKeyboardManager — kontrollerda bir satr kod bo'lmasdan avtomatik Keyboard Avoidance-ni amalga oshiradigan eng mashhur kutubxona (GitHub da 16 000 dan ortiq yulduz). U matn maydonlarini kuzatish uchun method swizzling dan foydalanadi va klaviatura paydo bo'lganda kontentni avtomatik ko'taradi.

Kutubxona moslashuvchan sozlamalarni taqdim etadi: maydon va klaviatura orasidagi masofani belgilash, alohida kontrollerlar uchun yoqish/o'chirish, UITextView va maxsus kiritish ko'rinishlari uchun xatti-harakatni sozlash mumkin. Biroq, method swizzling boshqa kutubxonalar bilan ziddiyatga kelishi mumkin va Apple kutilmagan yon ta'sirlar tufayli bu yondashuvni ishlab chiqarish kodi uchun tavsiya etmaydi.

Muqobillarga TPKeyboardAvoiding (engil kutubxona, ~2000 yulduz) va jamoatchilik tomonidan KeyboardManager kiradi. Zamonaviy loyihalar uchun Apple iOS 15+ ning o'rnatilgan vositalaridan, pastroq minimal versiyaga ega loyihalar uchun esa contentInset bilan UIScrollView dan foydalanishni tavsiya qiladi, bu eng ishonchli o'rnatilgan yechimdir.