{"id":16710430,"url":"https://github.com/wan2land/vue-daum-postcode","last_synced_at":"2025-10-28T05:46:35.678Z","repository":{"id":32745942,"uuid":"141532794","full_name":"wan2land/vue-daum-postcode","owner":"wan2land","description":"✉️ 다음 우편번호 서비스 Componet for Vue 2 \u0026 3.","archived":false,"fork":false,"pushed_at":"2024-10-29T08:29:59.000Z","size":3643,"stargazers_count":63,"open_issues_count":11,"forks_count":8,"subscribers_count":4,"default_branch":"main","last_synced_at":"2024-10-29T09:50:07.329Z","etag":null,"topics":["daum-postcode","vue-daum-postcode","vue3"],"latest_commit_sha":null,"homepage":"https://vue-daum-postcode.dist.be","language":"Vue","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wan2land.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-07-19T06:16:05.000Z","updated_at":"2024-10-29T08:29:24.000Z","dependencies_parsed_at":"2023-02-17T14:01:14.320Z","dependency_job_id":"ff6140ee-7c4e-49de-bd38-f3cfef923f9e","html_url":"https://github.com/wan2land/vue-daum-postcode","commit_stats":{"total_commits":452,"total_committers":8,"mean_commits":56.5,"dds":0.2588495575221239,"last_synced_commit":"66c03d9af1eaaf6e9343e4bb6464c027c66e9d41"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wan2land%2Fvue-daum-postcode","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wan2land%2Fvue-daum-postcode/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wan2land%2Fvue-daum-postcode/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wan2land%2Fvue-daum-postcode/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wan2land","download_url":"https://codeload.github.com/wan2land/vue-daum-postcode/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243676778,"owners_count":20329434,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["daum-postcode","vue-daum-postcode","vue3"],"created_at":"2024-10-12T20:08:24.772Z","updated_at":"2025-10-28T05:46:35.616Z","avatar_url":"https://github.com/wan2land.png","language":"Vue","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Vue Daum Postcode\n\n\u003cp\u003e\n  \u003ca href=\"https://github.com/wan2land/vue-daum-postcode/actions\"\u003e\u003cimg alt=\"Build\" src=\"https://img.shields.io/github/actions/workflow/status/wan2land/vue-daum-postcode/ci.yml?branch=main\u0026logo=github\u0026style=flat-square\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://npmcharts.com/compare/vue-daum-postcode?minimal=true\"\u003e\u003cimg alt=\"Downloads\" src=\"https://img.shields.io/npm/dt/vue-daum-postcode.svg?style=flat-square\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.npmjs.com/package/vue-daum-postcode\"\u003e\u003cimg alt=\"Version\" src=\"https://img.shields.io/npm/v/vue-daum-postcode.svg?style=flat-square\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.npmjs.com/package/vue-daum-postcode\"\u003e\u003cimg alt=\"License\" src=\"https://img.shields.io/npm/l/vue-daum-postcode.svg?style=flat-square\" /\u003e\u003c/a\u003e\n  \u003cimg alt=\"VueJS 3.x\" src=\"https://img.shields.io/badge/vue.js-3.x-brightgreen.svg?style=flat-square\" /\u003e\n  \u003cimg alt=\"Language Typescript\" src=\"https://img.shields.io/badge/language-Typescript-007acc.svg?style=flat-square\" /\u003e\n\u003c/p\u003e\n\n[Daum 우편번호 서비스](http://postcode.map.daum.net/guide)를 기반으로 작업된 Vue Component 입니다.\n\nVue 2.x를 사용하다면 [v0.x branch](https://github.com/wan2land/vue-daum-postcode/tree/0.x-vue2)브랜치를 참고해주세요.\n\n- [See Example](http://vue-daum-postcode.dist.be) ([sources](./example))\n\n## Installation\n\n```bash\nnpm i vue-daum-postcode\n```\n\n\n**Global Registration**\n\n[Vue3 Global Registration Guide](https://v3.vuejs.org/guide/component-registration.html#global-registration)\n\n```js\nimport { createApp } from 'vue'\nimport VueDaumPostcode from 'vue-daum-postcode'\n\n\nconst app = createApp(/* */)\n\napp.use(VueDaumPostcode) // export default is plugin\n\n```\n\n**Local Registration**\n\n[Vue3 Local Registration Guide](https://v3.vuejs.org/guide/component-registration.html#local-registration)\n\n```vue\n\u003ctemplate\u003e\n  \u003cVueDaumPostcode :options=\"options\" /\u003e\n\u003c/template\u003e\n\u003cscript\u003e\nimport { VueDaumPostcode } from 'vue-daum-postcode'\n\nexport default {\n  components: {\n    VueDaumPostcode, // export VueDaumPostcode is component\n  },\n}\n\u003c/script\u003e\n```\n\n**기본 태그 변경 (Global Registration)**\n\n```js\napp.use(VueDaumPostcode, {\n  name: 'DaumPostcode',\n})\n```\n\n**Postcode Js 경로 변경 (Global Registration)**\n\n기본 Daum postcode.js url(`https://t1.daumcdn.net/mapjsapi/bundle/postcode/prod/postcode.v2.js`)을 다른 url로 변경하려면 다음과 같이 설정하시면 됩니다.\n\n```js\napp.use(VueDaumPostcode, {\n  scriptUrl: \"https://s3.ap-northeast-2.amazonaws.com/YOUR_BUCKET_NAME/postcode.v2.js\"\n})\n```\n\n## Props\n\n이름                      | 타입      | 설명        | 기본값\n------------------------- | --------- | ----------- | -------\n`q`                       | `String`  | 검색어 | `\"\"`\n`animation`               | `Boolean` | [Daum 우편번호, 생성자속성](http://postcode.map.daum.net/guide)에서 `animation`. | `false`\n`noAutoMapping`           | `Boolean` | [Daum 우편번호, 생성자속성](http://postcode.map.daum.net/guide)에서 `autoMapping`, 기본값을 `true`에서 `false`로 조정. | `false`\n`noShorthand`             | `Boolean` | [Daum 우편번호, 생성자속성](http://postcode.map.daum.net/guide)에서 `shorthand`, 기본값을 `true`에서 `false`로 조정. | `false`\n`pleaseReadGuide`         | `Number`  | [Daum 우편번호, 생성자속성](http://postcode.map.daum.net/guide)에서 `pleaseReadGuide`. | `0`\n`pleaseReadGuideTimer`    | `Number`  | [Daum 우편번호, 생성자속성](http://postcode.map.daum.net/guide)에서 `pleaseReadGuideTimer`. | `1.5`\n`maxSuggestItems`         | `Number`  | [Daum 우편번호, 생성자속성](http://postcode.map.daum.net/guide)에서 `maxSuggestItems`. | `10`\n`showMoreHName`           | `Boolean` | [Daum 우편번호, 생성자속성](http://postcode.map.daum.net/guide)에서 `showMoreHName`. | `false`\n`hideMapBtn`              | `Boolean` | [Daum 우편번호, 생성자속성](http://postcode.map.daum.net/guide)에서 `hideMapBtn`. | `false`\n`hideEngBtn`              | `Boolean` | [Daum 우편번호, 생성자속성](http://postcode.map.daum.net/guide)에서 `hideEngBtn`. | `false`\n`alwaysShowEngAddr`       | `Boolean` | [Daum 우편번호, 생성자속성](http://postcode.map.daum.net/guide)에서 `alwaysShowEngAddr`. | `false`\n`zonecodeOnly`            | `Boolean` | [Daum 우편번호, 생성자속성](http://postcode.map.daum.net/guide)에서 `zonecodeOnly`. | `false`\n`noSubmitMode`            | `Boolean` | Submit Mode 비활성화시 사용. ([관련 이슈 링크](https://github.com/daumPostcode/QnA/issues/286)) | `false`\n`theme`                   | `object`  | [Daum 우편번호, 생성자속성](http://postcode.map.daum.net/guide)에서 `theme`. | `{}`\n\n## Events\n\n이름                      | 설명\n------------------------- | -----------\n`load`                    | 다음 우편번호가 로딩 되었을 때 발생\n`search`                  | [Daum 우편번호, 속성](http://postcode.map.daum.net/guide)에서 `onsearch`.\n`complete`                | [Daum 우편번호, 속성](http://postcode.map.daum.net/guide)에서 `oncomplete`.\n`resize`                  | [Daum 우편번호, 속성](http://postcode.map.daum.net/guide)에서 `onresize`.\n`error`                   | 스크립트 로딩 실패시 발생\n\n## Slots\n\n이름                      | 설명\n------------------------- | ---------\n`loading`                 | 다음 우편번호가 아직 완전히 불러오기 전에 보여줄 내용이 있는 경우 해당 슬롯에 넣습니다. (ex. spinner)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwan2land%2Fvue-daum-postcode","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwan2land%2Fvue-daum-postcode","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwan2land%2Fvue-daum-postcode/lists"}