https://github.com/thewoowon/react-native-daum-postcode
react native 다음 주소 검색
https://github.com/thewoowon/react-native-daum-postcode
daum daum-postcode javascript react react-native reactjs typescript webview
Last synced: about 1 month ago
JSON representation
react native 다음 주소 검색
- Host: GitHub
- URL: https://github.com/thewoowon/react-native-daum-postcode
- Owner: thewoowon
- License: mit
- Created: 2025-01-01T15:13:09.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-01-05T13:35:08.000Z (about 1 year ago)
- Last Synced: 2025-06-26T07:18:16.443Z (9 months ago)
- Topics: daum, daum-postcode, javascript, react, react-native, reactjs, typescript, webview
- Language: TypeScript
- Homepage: https://www.npmjs.com/package/@thewoowon/react-native-daum-postcode
- Size: 120 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 📦 @thewoowon/react-native-daum-postcode
> React Native wrapper for Daum Postcode service
Easily integrate Daum Postcode (Kakao Address API) in your React Native app for seamless address searching and selection.
---
## 🚀 Features
- 📍 **Real-time address search:** Effortlessly find addresses using the Daum Postcode API.
- 📦 **Simple integration:** Minimal setup required for React Native projects.
- 📱 **Mobile-friendly:** Optimized for both iOS and Android platforms.
- 📡 **TypeScript support:** Built with TypeScript for better developer experience.
---
## 📦 Installation
```bash
npm install @thewoowon/react-native-daum-postcode
```
or using yarn:
```bash
yarn add @thewoowon/react-native-daum-postcode
```
and iOS requires pod install because of react-native-webview.
```bash
cd ios && pod install
```
---
## 🛠️ Usage
```tsx
import React from 'react';
import { View, Alert } from 'react-native';
import Postcode from '@thewoowon/react-native-daum-postcode';
const App = () => {
const handleAddressSelect = (data: any) => {
console.log('Selected Address:', data);
};
return (
Alert.alert(JSON.stringify(data))}
onError={(error: any) => Alert.alert(JSON.stringify(error))}
/>
);
};
export default App;
```
---
## 📚 Props
| Prop Name | Type | Required | Description |
|----------------|-----------------------|----------|------------------------------------|
| `onSelected` | `function` | ✅ | Callback when an address is selected |
| `onError` | `function` | ✅ | Callback when an error is occured |
| `style` | `StyleProp`| ❌ | Custom styles for the component |
---
## 📦 Example Output
The component renders the official Daum Postcode search interface inside a WebView, allowing users to search and select addresses easily.
---
## 📖 Changelog
### v1.0.0 (Initial Release)
- 🎉 First release with basic Daum Postcode integration
---
## 💡 Contributing
Contributions are welcome! Please follow these steps:
1. Fork the repository.
2. Create a new branch (`feat/new-feature`).
3. Commit your changes.
4. Open a pull request.
---
## 🛡️ License
This project is licensed under the MIT License. See the [LICENSE](./LICENSE) file for details.
---
## 📞 Support
If you have any questions or need support, feel free to open an issue on [GitHub](https://github.com/thewoowon/react-native-daum-postcode).
---
## ⭐ Show Your Support
If you find this package useful, please consider giving it a star on [GitHub](https://github.com/thewoowon/react-native-daum-postcode)!
---
This project is inspired by [@actbase/react-daum-postcode](https://github.com/actbase/react-daum-postcode).
Happy coding! 🚀