daum_postcode_view

Description:

daum postcode view

다음 우편번호 서비스 For Flutter #
다음 우편번호 서비스를 Flutter에서 편리하게 사용하기 위한 패키지입니다.
사용법 #
daum_postcode_view를 프로젝트의 pubspec.yaml에 추가합니다.
그런 다음 사용하고자 하는 위젯 내부에 다음과 같이 작성합니다.
DaumPostcodeView(
onComplete: (model) {
// onComplete 정의
},
options: const DaumPostcodeOptions(
// options 정의 (선택)
),
);
copied to clipboard
속성 #
onComplete #
주소를 선택한 후에 동작하는 콜백 함수를 정의합니다. 주소를 선택할 시 반환하는 JSON 문자열을 Dart 객체로 변환하여 model 파라미터로 제공합니다.
해당 모델의 속성은 다음 우편번호 서비스의 속성 항목의 oncomplete 콜백에서 제공하는 정보와 일치합니다.

구 우편번호 (postcode, postcode1, postcode2, postcodeSeq) 속성은 제외하였습니다.

options #
다음 우편번호 서비스를 개인화(Customize)하여 사용하기 위한 옵션입니다.
옵션에 대한 설명은 다음 우편번호 서비스의 속성 항목의 width부터 theme 까지의 설명을 참조해주세요.

theme

문자열 대신 Dart 기본 UI 패키지의 Color 속성을 사용합니다.
Color 속성의 Alpha 값은 무시되며, RGB 값만 반영됩니다.


themeType

위의 링크에서 설명하지 않는 항목입니다.
기본 테마(DaumPostcodeThemeType.defaultTheme)와 어두운 테마(DaumPostcodeThemeType.darknessTheme) 두 가지를 사용할 수 있습니다.
themeType 속성을 사용할 시 theme 속성은 무시됩니다.




구 우편번호 관련 속성(zonecodeOnly)은 제외하였습니다.

사용 예시 #
import 'package:flutter/material.dart';
import 'package:daum_postcode_view/daum_postcode_view.dart';

class SearchPostcodePage extends StatelessWidget {
static const String routeName = '/postcode';

const SearchPostcodePage({Key? key}) : super(key: key);

@override
Widget build(BuildContext context) {
return Scaffold(
body: DaumPostcodeView(
onComplete: (model) {
Navigator.of(context).pop(model);
},
options: const DaumPostcodeOptions(
animation: true,
hideEngBtn: true,
themeType: DaumPostcodeThemeType.darknessTheme,
),
),
);
}
}
copied to clipboard
주의사항 #
이 패키지는 내부적으로 webview_flutter 를 사용하고 있습니다. 따라서 안드로이드에서 사용하는 경우 android/app/build.gradle의 minSdkVersion을 19 이상으로 설정해야 합니다.
android {
defaultConfig {
minSdkVersion 19
}
}
copied to clipboard
안드로이드 Release 모드로 빌드 시에는 android/app/src/main/AndroidManifest.xml 에 다음과 같이 권한을 추가하여야 합니다.
<uses-permission android:name="android.permission.INTERNET"/>
copied to clipboard