1.0.2 • Published 6 years ago
react-use-web-share v1.0.2
useWebShare
A custom react hook for triggering the native web share dialog in supported browsers
Usage
npm install react-use-web-shareconst { loading, isSupported, share } = useWebShare();
function onClick() {
share();
}See example directory for full example.
Parameters
| Parameter | description | default | required |
|---|---|---|---|
| onSuccess | called on successfully sharing the content | () => {} | false |
| onError | called when caught error from navigator share content | () => {} | false |
Returns
| Name | Type | Description |
|---|---|---|
| loading | boolean | Loading state |
| isSupported | boolean | Detects whether the feature is supported in user's browser. Can be used to show the fallback |
| share | function | can be called to trigger the native share popup |
share
This is the function that triggers the native share dialog in browser.
This takes an object as argument.
| Name | description | default |
|---|---|---|
| title | title of shared item | document.title |
| text | text of shared item | |
| url | url to be shared | canonical url if present, otherwise current url |
Contributing
- Install dependencies
npm install- Run dev for lib
npm run dev- Run demo
npm start