sp-react-native-iconbutton

A React Native button that can also have an icon within it through the iconProps property.

It works both WITH an icon AND without so it can cover all your button needs.

Renders a TouchableOpacity under iOS and a TouchableNativeFeedback under Android.

Install

sp-react-native-iconbutton needs React Native 0.16 or higher.

Install the package:

$ npm i sp-react-native-iconbutton --save

Import the Button component:

import Button from 'sp-react-native-iconbutton'

###Caution: This library is now compatible for react-native 29 and onwards. Thats because it uses the ActivityIndicator which does not exist in previous versions of react-native. If you wish to run it in previous react-native versions you will have to use the branch called pre29.

Usage

Provide TouchableWithoutFeedback' props to the component (including style), textStyle's StyleSheet to customize the inner text and a children node to render. You can also provide the isLoading prop that will dim the button and disable it to prevent accidental taps.

<Button
    style={{backgroundColor: '#3D5B96', height:60, borderRadius: 4, borderWidth: 1, borderColor: 'rgba(0,0,0,0.2)'}}
    textStyle={{color: 'white', textAlign: 'center'}}
    iconProps={{name: "facebook",size:25, color: "white"}}
    iconStyle={{paddingHorizontal:20}}
>
    Login with Facebook
</Button>

API

| Prop | Type | Description | |------|------|-------------| | onPress | func | Function to execute when the onPress event is triggered. | | onPressIn | func | Function to execute when the onPressIn event is triggered. | | onPressOut | func | Function to execute when the onPressOut event is triggered. | | onLongPress | func | Function to execute when the onLongPress event is triggered. | | customIcon | func | A function that returns a custom React element that will serve as the icon. (If you use that, you should NOT use iconProps or iconStyle) | | iconContainerStyle | ViewStylePropTypes | The StyleSheet to apply to the view that contains our icon be it a custom icon or a default (FontAwesome) icon. | | iconStyle | ViewStylePropTypes | The StyleSheet to apply to the inner button text. (If you use that, you should NOT use customIcon) | | iconProps | Object | If you pass iconProps you're actually telling the Button to create a FontAwesome icon, and you then pass those props to that icon. The properties to pass to your (FontAwesome) icon. You can pass any prop that you could pass on react-native-vector-icons (If you use that, you should NOT use customIcon) | | textStyle | TextStylePropTypes | The StyleSheet to apply to the inner button text. | | disabledStyle | TextStylePropTypes | The StyleSheet to apply when disabled. | | children | string | The string to render as the text button. | | isLoading | bool | Renders an inactive state dimmed button with a spinner if true. | | isDisabled | bool | Renders an inactive state dimmed button if true. | | activityIndicatorColor | string | Sets the button of the ActivityIndicatorIOS or ProgressBarAndroid in the loading state. | | background | TouchableNativeFeedback.propTypes.background | Android only. The background prop of TouchableNativeFeedback. |

License

MIT.