2.0.3 • Published 3 years ago
react-native-action-tips v2.0.3
react-native-action-tips
Cross platform tooltip for React Native.
Install
To get started install via npm:
npm install react-native-action-tips --save
Usage
Import:
import ActionTip from 'react-native-action-tips';
You can use the imperative API to control the action tip:
const actionTipRef = useRef(null);
<ActionTip
ref={actionTipRef}
position={{ top: 50 }}
/>
someMethod() {
actionTipRef.current.show("Link has been copied");
}
The declarative API for controlling the action tip:
const [isVisible, setIsVisible] = useState(false);
<ActionTip
visible={isVisible}
text="Link has been copied"
position={{ top: 50 }}
/>
Notes
The action tip exposes imperative show()
and hide()
functions.
The position of the component can be customised through the position
prop by passing an object as such { top: 0, bottom: 0, left: 0, right: 0 }
. By default the component uses "absolute"
positioning. This can be changed by passing style through the containerStyle
prop.
Props
Prop | Type | Optional | Default | Description | |
---|---|---|---|---|---|
ref | string | Yes | ref allows you to call the show() and hide() methods. | ||
text | string | Yes | Text which is displayed inside the action tip. | ||
visible | boolean | Yes | Controls the tooltip visibility. | ||
duration | number | Yes | 2000 ms | Duration until the action tip dismisses. | |
animationInDuration | number | Yes | 150 ms | Duration of fade-in animation. | |
animationOutDuration | number | Yes | 700 ms | Duration of fade-out animation. | |
opacity | number | Yes | 0.85 | Maximum opacity the tip should animate to. | |
position | object | Yes | 0 | Absolute positioning of the component. | |
containerStyle | style | Yes | Style applied to the action tip container. | ||
textStyle | style | Yes | Style applied to the action tip text. | ||
onHide | function | Yes | Callback when tooltip is hidden |
Contributing
If you want to issue a PR, go ahead ;)
Authors
- Luke Brandon Farrell - Author
- Aspect One - Organization
License
This project is licensed under the MIT License
Contributors ✨
Thanks goes to these wonderful people (emoji key):
This project follows the all-contributors specification. Contributions of any kind welcome!