[swift] QuickLayout을 사용하여 키보드와 텍스트 필드를 관리하기

17 Nov 2023

swift

텍스트 필드와 키보드를 관리하는 것은 iOS 앱 개발에서 자주 생기는 과제입니다. 사용자가 텍스트 필드를 탭하거나 화면을 스크롤할 때, 키보드가 화면을 가리지 않고 원활하게 작동해야 합니다. 이를 위해 QuickLayout 라이브러리를 사용하여 간편하게 구현해보겠습니다.

QuickLayout이란?

QuickLayout은 iOS 앱의 레이아웃을 구성하고 관리하기 위한 오픈 소스 라이브러리입니다. 이 라이브러리는 Swift 언어로 작성되었으며, 인터페이스 빌더 대신 코드로 레이아웃을 구성할 수 있도록 해줍니다. 또한, 간단한 API를 통해 키보드와 텍스트 필드의 상호작용을 쉽게 처리할 수 있습니다.

QuickLayout 설치

QuickLayout은 Swift 패키지 매니저를 사용하여 쉽게 설치할 수 있습니다. 프로젝트의 Package.swift 파일에 다음과 같이 의존성을 추가하세요:

dependencies: [
    .package(url: "https://github.com/huri000/QuickLayout.git", from: "2.0.0")
],
targets: [
    .target(name: "YourTarget", dependencies: ["QuickLayout"])
]

위의 커맨드를 실행한 후 프로젝트를 빌드하면 QuickLayout 라이브러리가 자동으로 다운로드 및 연결됩니다.

QuickLayout을 사용하여 키보드와 텍스트 필드 관리하기

텍스트 필드가 키보드에 가려질 경우, QuickLayout을 사용하여 텍스트 필드를 키보드 위로 이동시킬 수 있습니다. 다음은 간단한 예시 코드입니다:

import UIKit
import QuickLayout

class ViewController: UIViewController {

    var textField = UITextField()

    override func viewDidLoad() {
        super.viewDidLoad()
        
        setupTextField()
        setupKeyboardNotifications()
    }
    
    func setupTextField() {
        textField.borderStyle = .roundedRect
        view.addSubview(textField)
        
        textField.layout.centerY().leading(16).trailing(16).height(40)
    }
    
    func setupKeyboardNotifications() {
        NotificationCenter.default.addObserver(self, selector: #selector(keyboardWillShow(notification:)), name: UIResponder.keyboardWillShowNotification, object: nil)
        NotificationCenter.default.addObserver(self, selector: #selector(keyboardWillHide(notification:)), name: UIResponder.keyboardWillHideNotification, object: nil)
    }
    
    @objc func keyboardWillShow(notification: NSNotification) {
        guard let keyboardFrame = notification.userInfo?[UIResponder.keyboardFrameEndUserInfoKey] as? NSValue else { return }
        
        let keyboardHeight = keyboardFrame.cgRectValue.height
        let bottomSpace = view.frame.height - textField.frame.maxY
        
        if bottomSpace < keyboardHeight {
            view.layoutMargin.bottom += (keyboardHeight - bottomSpace)
        }
    }
    
    @objc func keyboardWillHide(notification: NSNotification) {
        view.layoutMargin.bottom = 0
    }

}

위의 코드는 ViewController 클래스에 textField를 생성하고, setupTextField 메서드를 사용하여 레이아웃을 구성합니다. setupKeyboardNotifications 메서드는 키보드 알림을 등록하고, keyboardWillShow과 keyboardWillHide 메서드를 사용하여 키보드가 나타날 때와 사라질 때의 동작을 정의합니다.

결론

QuickLayout을 사용하여 텍스트 필드와 키보드를 관리하는 것은 매우 편리하고 간단한 방법입니다. 이러한 기능을 활용하여 iOS 앱의 사용자 경험을 향상시킬 수 있습니다. 더 자세한 내용은 QuickLayout 레포지토리를 참고하시기 바랍니다.

참고 자료:

QuickLayout 레포지토리