dunji/options
Types
크기 단위: 픽셀 또는 퍼센트.
레이어/embed 모드에서는 퍼센트 사용 가능.
pub type Dimension {
Px(Int)
Percent(Int)
}Constructors
-
Px(Int)픽셀 단위 (예:
Px(500)). -
Percent(Int)퍼센트 단위 (예:
Percent(100)→"100%"). 레이어/embed 모드 전용.
카카오 우편번호 서비스 생성자 옵션.
콜백 함수는 포함하지 않으며, dunji.open()이나 dunji.embed()의
인자로 별도 전달한다.
default()로 생성한 뒤 builder 함수로 원하는 값만 설정한다.
예시
let opts =
options.default()
|> options.width(400)
|> options.height(500)
|> options.animation(True)
|> options.theme(my_theme)
pub type Options {
Options(
width: option.Option(Dimension),
height: option.Option(Dimension),
min_width: option.Option(Int),
animation: option.Option(Bool),
focus_input: option.Option(Bool),
auto_mapping_road: option.Option(Bool),
auto_mapping_jibun: option.Option(Bool),
shorthand: option.Option(Bool),
submit_mode: option.Option(Bool),
use_banner_link: option.Option(Bool),
hide_map_btn: option.Option(Bool),
hide_eng_btn: option.Option(Bool),
always_show_eng_addr: option.Option(Bool),
please_read_guide: option.Option(Int),
please_read_guide_timer: option.Option(Float),
max_suggest_items: option.Option(Int),
show_more_h_name: option.Option(Bool),
theme: option.Option(theme.Theme),
query: option.Option(String),
auto_close: option.Option(Bool),
left: option.Option(Int),
top: option.Option(Int),
popup_title: option.Option(String),
popup_key: option.Option(String),
)
}Constructors
-
Options( width: option.Option(Dimension), height: option.Option(Dimension), min_width: option.Option(Int), animation: option.Option(Bool), focus_input: option.Option(Bool), auto_mapping_road: option.Option(Bool), auto_mapping_jibun: option.Option(Bool), shorthand: option.Option(Bool), submit_mode: option.Option(Bool), use_banner_link: option.Option(Bool), hide_map_btn: option.Option(Bool), hide_eng_btn: option.Option(Bool), always_show_eng_addr: option.Option(Bool), please_read_guide: option.Option(Int), please_read_guide_timer: option.Option(Float), max_suggest_items: option.Option(Int), show_more_h_name: option.Option(Bool), theme: option.Option(theme.Theme), query: option.Option(String), auto_close: option.Option(Bool), left: option.Option(Int), top: option.Option(Int), popup_title: option.Option(String), popup_key: option.Option(String), )Arguments
- width
-
팝업/레이어 고정 너비. 기본값: 500px. 레이어 모드에서 퍼센트 가능.
- height
-
팝업/레이어 고정 높이. 기본값: 500px, 최소: 400px. 레이어 모드에서 퍼센트 가능.
- min_width
-
최소 너비 (px). 기본값: 300, 범위: 0-300.
- animation
-
애니메이션 효과 사용 여부. 기본값: False.
- focus_input
-
실행 시 검색 입력창 자동 포커스 (PC만). 기본값: True.
- auto_mapping_road
-
도로명 1:N 매핑 시 “선택 안함” 표시. 기본값: True.
- auto_mapping_jibun
-
지번 1:N 매핑 시 “선택 안함” 표시. 기본값: True.
- shorthand
-
시/도 약칭 사용 (서울특별시 → 서울). 기본값: True.
- submit_mode
-
form submit 사용 여부. 기본값: True.
- use_banner_link
-
하단 배너 링크 사용 여부. 기본값: True.
- hide_map_btn
-
지도 버튼 숨기기. 기본값: False.
- hide_eng_btn
-
영문보기 버튼 숨기기. 기본값: False.
- always_show_eng_addr
-
한글/영문 주소 동시 표시. 기본값: False.
- please_read_guide
-
검색 결과가 지정 페이지 이상일 때 가이드 강조 (3-20). 기본값: 0 (비활성).
- please_read_guide_timer
-
가이드 강조 지속 시간 (초, 0.1-60). 기본값: 1.5.
- max_suggest_items
-
검색 드롭다운 최대 추천 항목 수 (1-10). 기본값: 10.
- show_more_h_name
-
행정동이 법정동과 다를 때 행정동 표시. 기본값: False.
- theme
-
색상 테마 설정.
- query
-
초기 검색어.
- auto_close
-
주소 선택 후 자동 닫기. 기본값: True.
- left
-
팝업 X 좌표 (px). open() 전용.
- top
-
팝업 Y 좌표 (px). open() 전용.
- popup_title
-
팝업 창 제목. open() 전용.
- popup_key
-
중복 팝업 방지 키. 같은 키로 여러 번 open 시 하나만 열림. open() 전용.
Values
pub fn auto_mapping(options: Options, value: Bool) -> Options도로명/지번 1:N 매핑 “선택 안함” 표시를 동시에 설정하는 축약.
pub fn height_percent(options: Options, value: Int) -> Options팝업/레이어 고정 높이를 퍼센트로 설정. 레이어/embed 모드 전용.
pub fn please_read_guide(options: Options, value: Int) -> Options검색 결과 가이드 강조 페이지 수 설정 (3-20, 0은 비활성).
pub fn please_read_guide_timer(
options: Options,
value: Float,
) -> Options가이드 강조 지속 시간 설정 (초, 0.1-60).