Go to file
Brent Vatne b185a90f81 Add Android example, update example to 0.16.0, fix 0.16.0 Android compat 2015-12-07 10:15:01 -08:00
BVLinearGradient.xcodeproj Initial commit 2015-03-31 10:44:16 -07:00
Examples/AnimatedGradient Add Android example, update example to 0.16.0, fix 0.16.0 Android compat 2015-12-07 10:15:01 -08:00
android Brought android api into parity with iOS 2015-10-01 12:48:02 -04:00
.flowconfig Add a .flowconfig, remove more unnecessary code 2015-04-13 22:10:00 -07:00
.gitignore Add Android example, update example to 0.16.0, fix 0.16.0 Android compat 2015-12-07 10:15:01 -08:00
BVLinearGradient.h Working version with example and instructions 2015-03-31 11:42:53 -07:00
BVLinearGradient.m Passing in CGPoints instead of NSArrays for start/end. 2015-08-18 17:34:49 -04:00
BVLinearGradientManager.h Initial commit 2015-03-31 10:44:16 -07:00
BVLinearGradientManager.m Passing in CGPoints instead of NSArrays for start/end. 2015-08-18 17:34:49 -04:00
README.md typo fixes 2015-10-16 12:48:26 -05:00
example-animated.gif Update Examples section of README 2015-04-06 13:46:12 -07:00
example-other-props.png Add support for start, end, and locations 2015-03-31 17:48:11 -07:00
example.png Update first example image 2015-03-31 17:50:39 -07:00
index.android.js Add Android example, update example to 0.16.0, fix 0.16.0 Android compat 2015-12-07 10:15:01 -08:00
index.ios.js Add Android example, update example to 0.16.0, fix 0.16.0 Android compat 2015-12-07 10:15:01 -08:00
package.json preparing for 1.1.0-alpha release 2015-10-01 12:49:51 -04:00

README.md

react-native-linear-gradient

A <LinearGradient> component for react-native, as seen in react-native-login.

Add it to your project

iOS

  1. Run npm install react-native-linear-gradient --save
  2. Open your project in XCode, right click on Libraries and click Add Files to "Your Project Name" Look under node_modules/react-native-linear-gradient and add BVLinearGradient.xcodeproj. (Screenshot).
  3. Add libBVLinearGradient.a to Build Phases -> Link Binary With Libraries (Screenshot).
  4. Click on BVLinearGradient.xcodeproj in Libraries and go the Build Settings tab. Double click the text to the right of Header Search Paths and verify that it has $(SRCROOT)/../react-native/React - if it isn't, then add it. This is so XCode is able to find the headers that the BVLinearGradient source files are referring to by pointing to the header files installed within the react-native node_modules directory. (Screenshot).
  5. Whenever you want to use it within React code now you can: var LinearGradient = require('react-native-linear-gradient');

If you're having trouble, you can point your package.json at github to see if the issue has been fixed. Simply change the dependency "react-native-linear-gradient": "brentvatne/react-native-linear-gradient", and then npm install

Android

  1. in android/settings.gradle

      include ':app', ':react-native-linear-gradient'
      project(':react-native-linear-gradient').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-linear-gradient/android')
    
  2. in android/app/build.gradle add:

    dependencies {
        ...
        compile project(':react-native-linear-gradient')
    }
    
  3. and finally, in android/src/main/java/com/{YOUR_APP_NAME}/MainActivity.java add:

    ...
    import com.BV.LinearGradient.LinearGradientPackage; // <--- This!
    ...
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        mReactRootView = new ReactRootView(this);
    
        mReactInstanceManager = ReactInstanceManager.builder()
                .setApplication(getApplication())
                .setBundleAssetName("index.android.bundle")
                .setJSMainModuleName("index.android")
                .addPackage(new MainReactPackage())
                .addPackage(new LinearGradientPackage()) // <---- and This!
                .setUseDeveloperSupport(BuildConfig.DEBUG)
                .setInitialLifecycleState(LifecycleState.RESUMED)
                .build();
    
        mReactRootView.startReactApplication(mReactInstanceManager, "SillyGoose", null);
    
        setContentView(mReactRootView);
    }
    

Examples

Simple

The following code will produce something like this:

Example code result

// Within your render function
<LinearGradient colors={['#4c669f', '#3b5998', '#192f6a']} style={styles.linearGradient}>
  <Text style={styles.buttonText}>
    Sign in with Facebook
  </Text>
</LinearGradient>

// Later on in your styles..
var styles = StyleSheet.create({
  linearGradient: {
    flex: 1,
    paddingLeft: 15,
    paddingRight: 15,
    borderRadius: 5
  },
  buttonText: {
    fontSize: 18,
    fontFamily: 'Gill Sans',
    textAlign: 'center',
    margin: 10,
    color: '#ffffff',
  },
});

Additional props

You can also use start and end points, as well as specify the locations for the gradient color changes with the start, end and locations props:

<LinearGradient
  start={[0.0, 0.25]} end={[0.5, 1.0]}
  locations={[0,0.5,0.6]}
  colors={['#4c669f', '#3b5998', '#192f6a']}
  style={styles.linearGradient}>
  <Text style={styles.buttonText}>
    Sign in with Facebook
  </Text>
</LinearGradient>

Example with extra props

Updating the values for fun

Check out [Examples/AnimatedGradient] (git clone this project, cd into it, npm install, open in XCode and run) to see how this is done:

Example with extra props

This gif was created using licecap - a great piece of free OSS

An example app

You can see this component in action in brentvatne/react-native-login.