[swift] PhoneNumberKit을 사용하여 특정 국가의 전화번호 대화상자에 자동완성 기능 추가하기

17 Nov 2023

swift

이번에는 PhoneNumberKit 라이브러리를 사용하여 iOS 앱의 전화번호 대화상자에 자동완성 기능을 추가하는 방법에 대해 알아보겠습니다.

PhoneNumberKit 소개

PhoneNumberKit은 Swift로 작성된 오픈소스 라이브러리로, 전화번호를 구문 분석하고 유효성을 검사하는 기능을 제공합니다. 이 라이브러리를 사용하면 전화번호를 쉽게 다룰 수 있으며, 국가별 번호 형식에 맞게 포맷팅을 할 수도 있습니다.

전화번호 대화상자 생성하기

먼저 PhoneNumberKit을 프로젝트에 추가해야 합니다. 이를 위해 Podfile에 다음과 같이 추가합니다.

pod 'PhoneNumberKit'

그런 다음 터미널에서 아래 명령어를 실행하여 라이브러리를 설치합니다.

pod install

이제 PhoneNumberKit을 임포트하고 전화번호 대화상자를 생성하는 코드를 작성해보겠습니다.

import UIKit
import PhoneNumberKit

class ViewController: UIViewController {
    let phoneNumberKit = PhoneNumberKit()
    
    override func viewDidLoad() {
        super.viewDidLoad()
        
        let phoneNumberTextField = PhoneNumberTextField()
        phoneNumberTextField.placeholder = "전화번호를 입력하세요"
        
        // 특정 국가 코드를 설정합니다(예: 한국은 +82).
        phoneNumberTextField.defaultRegion = "KR"
        
        // 전화번호 유효성 검사를 활성화합니다.
        phoneNumberTextField.withExamplePlaceholder = true
        
        // 전화번호 TextField를 화면에 추가합니다.
        view.addSubview(phoneNumberTextField)
    }
}

위의 코드에서 PhoneNumberTextField는 PhoneNumberKit에서 제공하는 UITextField 하위 클래스입니다. 이를 사용하면 전화번호를 유효성 검사하고, 포맷팅하여 보기 좋게 표시할 수 있습니다.

자동완성 기능 추가하기

PhoneNumberKit은 국가별로 전화번호 형식을 인식하기 때문에 자동완성 기능도 쉽게 구현할 수 있습니다. 다음 코드를 사용하여 자동완성을 추가해보겠습니다.

let phoneNumberTextField = PhoneNumberTextField()
phoneNumberTextField.placeholder = "전화번호를 입력하세요"

// 특정 국가 코드를 설정합니다(예: 한국은 +82).
phoneNumberTextField.defaultRegion = "KR"

// 전화번호 유효성 검사를 활성화합니다.
phoneNumberTextField.withExamplePlaceholder = true

// 전화번호 TextField를 화면에 추가합니다.
view.addSubview(phoneNumberTextField)

let autocompleteTextField = PhoneNumberTextField()
autocompleteTextField.placeholder = "국가를 입력하세요"

// 자동완성 기능을 활성화합니다.
autocompleteTextField.withFlag = true

// 국가 TextField를 화면에 추가합니다.
view.addSubview(autocompleteTextField)

위의 코드에서 autocompleteTextField는 국가 코드를 자동완성할 수 있는 PhoneNumberTextField입니다. withFlag 속성을 true로 설정하면 국가별 국기 아이콘도 함께 표시됩니다.

결론

PhoneNumberKit를 사용하여 특정 국가의 전화번호 대화상자에 자동완성 기능을 추가하는 방법에 대해 알아보았습니다. PhoneNumberKit은 유효성 검사 및 번호 형식 포맷팅에 큰 도움을 줄 수 있는 강력한 라이브러리입니다. 이제 앱의 사용성을 높이기 위해 전화번호 입력 시 자동완성을 적용해보세요!

참고 자료

```