Repolode
hackiftekhar

hackiftekhar/IQKeyboardManager

코드 작성 없이 키보드가 UITextField와 UITextView를 가리지 않도록 해주는 iOS용 드롭인 라이브러리입니다.

스타
16,619
포크
2,441
열린 이슈
10
마지막 커밋
지난달

어떤 프로젝트인가요?

iOS 앱에서 키보드가 올라오면 사용자가 입력 중인 UITextField나 UITextView를 가리는 경우가 많습니다. IQKeyboardManager를 활성화하면 이를 자동으로 처리합니다. 화면마다 별도의 코드를 작성하지 않아도 뷰를 조정해 현재 입력 중인 필드가 키보드 위에 계속 표시되도록 합니다.

이 라이브러리는 UIScrollView, UITableView, UICollectionView와 함께 사용할 수 있고 모든 인터페이스 방향을 지원하며, 키보드와 필드 사이에 유지할 간격도 설정할 수 있습니다. 클래스 단위로 활성화 여부를 제어해 특정 화면에서 비활성화할 수도 있습니다.

Swift 버전인 IQKeyboardManagerSwift는 서브스펙으로 나뉘어 있어 Previous/Next/Done 툴바, return 키 처리, 탭으로 키보드 닫기, 키보드 모양 설정, placeholder를 지원하는 UITextView 등 필요한 선택 기능만 포함할 수 있습니다. CocoaPods, Carthage, Swift Package Manager로 설치할 수 있으며 iOS 13.0 이상이 필요합니다.

핵심 기능

  • 01현재 입력 중인 UITextField나 UITextView가 키보드 위에 표시되도록 자동으로 조정합니다.
  • 02서브클래싱 없이 UIScrollView, UITableView, UICollectionView와 함께 사용할 수 있습니다.
  • 03모든 인터페이스 방향을 지원하며 키보드와의 간격을 설정할 수 있습니다.
  • 04선택적 서브스펙을 통해 Previous/Next/Done 툴바, return 키 처리, 탭으로 키보드 닫기 기능을 추가할 수 있습니다.
  • 05키보드 모양 설정과 placeholder를 지원하는 UITextView를 제공합니다.

활용 사례

  • 로그인 화면이나 폼 화면이 있는 기존 iOS 앱에 키보드 처리를 추가할 때.
  • 텍스트 입력 필드가 있는 테이블 뷰나 컬렉션 뷰에서 키보드가 입력 필드를 가리지 않도록 할 때.
  • 사용자 지정 accessory view를 작성하지 않고 폼에 Done/Next 툴바를 빠르게 추가할 때.

빠른 시작

  1. 1

    Podfile에 pod를 추가합니다

    pod 'IQKeyboardManagerSwift'
  2. 2

    AppDelegate에서 IQKeyboardManager.shared.isEnabled = true를 설정해 IQKeyboardManager를 활성화합니다

사용 전 알아둘 점

  • iOS 전용이며 다른 플랫폼은 지원하지 않습니다.
  • 작성자는 타사 SDK나 라이브러리의 종속성으로 포함해 배포하는 것을 권장하지 않습니다.
  • 버전 7.2.0부터 소스 코드 설치는 지원되지 않습니다.

토픽

자주 묻는 질문

IQKeyboardManager은(는) 무엇인가요?
코드 작성 없이 키보드가 UITextField와 UITextView를 가리지 않도록 해주는 iOS용 드롭인 라이브러리입니다. iOS 앱에서 키보드가 올라오면 사용자가 입력 중인 UITextField나 UITextView를 가리는 경우가 많습니다. IQKeyboardManager를 활성화하면 이를 자동으로 처리합니다. 화면마다 별도의 코드를 작성하지 않아도 뷰를 조정해 현재 입력 중인 필드가 키보드 위에 계속 표시되도록 합니다.
IQKeyboardManager은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
IQKeyboardManager은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
IQKeyboardManager은(는) 아직 유지보수되고 있나요?
6개월 이내 업데이트. IQKeyboardManager의 마지막 커밋은 2026년 9월 28일입니다.
IQKeyboardManager은(는) 어디에 사용할 수 있나요?
로그인 화면이나 폼 화면이 있는 기존 iOS 앱에 키보드 처리를 추가할 때. 텍스트 입력 필드가 있는 테이블 뷰나 컬렉션 뷰에서 키보드가 입력 필드를 가리지 않도록 할 때. 사용자 지정 accessory view를 작성하지 않고 폼에 Done/Next 툴바를 빠르게 추가할 때.
IQKeyboardManager는 어떻게 설치하나요?
Podfile에 pod를 추가합니다: pod 'IQKeyboardManagerSwift' AppDelegate에서 IQKeyboardManager.shared.isEnabled = true를 설정해 IQKeyboardManager를 활성화합니다
IQKeyboardManager은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/hackiftekhar/IQKeyboardManager

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트