diff --git a/website/src/react-native/css/react-native.css b/website/src/react-native/css/react-native.css index 841780a64cc495..a08679ffde49e1 100644 --- a/website/src/react-native/css/react-native.css +++ b/website/src/react-native/css/react-native.css @@ -377,7 +377,7 @@ h1:hover .hash-link, h2:hover .hash-link, h3:hover .hash-link, h4:hover .hash-li } .hero { - background: #05A5D1; + background: #2D2D2D; padding: 50px 0; color: #FDF3E7; font-weight: 300; diff --git a/website/src/react-native/index.js b/website/src/react-native/index.js index 4276d90971eba6..49a957f0cd9697 100644 --- a/website/src/react-native/index.js +++ b/website/src/react-native/index.js @@ -19,398 +19,106 @@ var index = React.createClass({
React Native
- A framework for building native apps using React + Learn once, write anywhere: Build mobile apps with React
- - -
-
- -

- React Native enables you to build world-class application experiences on native platforms using a consistent developer experience based on JavaScript and - {' '}React{'. '} - The focus of React Native is on developer efficiency across all the platforms you care about — learn once, write anywhere. - Facebook uses React Native in multiple production apps and will continue investing in React Native. -

-
Get started with React Native
+ + +
-

Native Components

+

Build Native Mobile Apps using JavaScript and React

- With React Native, you can use the standard platform components such as UITabBar on iOS and Drawer on Android. This gives your app a consistent look and feel with the rest of the platform ecosystem, and keeps the quality bar high. These components are easily incorporated into your app using their React component counterparts, such as TabBarIOS and DrawerLayoutAndroid. + React Native lets you build mobile apps using only JavaScript. It uses the same design as React, letting you compose a rich mobile UI from declarative components.

- -{`// iOS - -import React, { - Component, -} from 'react'; -import { - TabBarIOS, - NavigatorIOS, -} from 'react-native'; - -class App extends Component { - render() { - return ( - - - - - - ); - } -}`} - - -{`// Android + -import React, { - Component, -} from 'react'; -import { - DrawerLayoutAndroid, - ProgressBarAndroid, - Text, -} from 'react-native'; +{`import React, { Component } from 'react'; +import { Text, View } from 'react-native'; -class App extends Component { +class WhyReactNativeIsSoGreat extends Component { render() { return ( - React Native}> - - + + + If you like React on the web, you'll like React Native. + + + You just use native components like '' and '', + instead of web components like '
' and ''. + + ); } }`} -

Asynchronous Execution

+

A React Native App is a Real Mobile App

- All operations between the JavaScript application code and the native platform are performed asynchronously, and the native modules can also make use of additional threads as well. This means we can decode images off of the main thread, save to disk in the background, measure text and compute layouts without blocking the UI, and more. As a result, React Native apps are naturally fluid and responsive. The communication is also fully serializable, which allows us to leverage Chrome Developer Tools to debug the JavaScript while running the complete app, either in the simulator or on a physical device. + With React Native, you don't build a “mobile web app”, an “HTML5 app”, or a “hybrid app”. You build a real mobile app that's indistinguishable from an app built using Objective-C or Java. React Native uses the same fundamental UI building blocks as regular iOS and Android apps. You just put those building blocks together using JavaScript and React.

-

- See Debugging. -

- -

Touch Handling

-

- React Native implements a powerful system to negotiate touches in complex view hierarchies and provides high level components such as TouchableHighlight that integrate properly with scroll views and other elements without any additional configuration. -

-{`// iOS & Android - -import React, { - Component, -} from 'react'; -import { - ScrollView, - TouchableHighlight, - Text, -} from 'react-native'; +{`import React, { Component } from 'react'; +import { Image, ScrollView, Text } from 'react-native'; -class TouchDemo extends Component { +class AwkwardScrollingImageWithText extends Component { render() { return ( - console.log('pressed')}> - Proper Touch Handling - - - ); - } -}`} - - -

Flexbox and Styling

-

- Laying out views should be easy, which is why we brought the flexbox layout model from the web to React Native. Flexbox makes it simple to build the most common UI layouts, such as stacked and nested boxes with margin and padding. React Native also supports common web styles, such as fontWeight, and the StyleSheet abstraction provides an optimized mechanism to declare all your styles and layout right along with the components that use them and apply them inline. -

- -{`// iOS & Android + + + On iOS, a React Native '' uses a native UIScrollView. + On Android, it uses a native ScrollView. -import React, { - Component, -} from 'react'; -import { - Image, - StyleSheet, - Text, - View, -} from 'react-native'; + On iOS, a React Native '' uses a native UIImageView. + On Android, it uses a native ImageView. -class ReactNative extends Component { - render() { - return ( - - - - - React Native - - - Build high quality mobile apps using React - - - - ); - } -} -var styles = StyleSheet.create({ - row: { flexDirection: 'row', margin: 40 }, - image: { width: 40, height: 40, marginRight: 10 }, - text: { flex: 1, justifyContent: 'center'}, - title: { fontSize: 11, fontWeight: 'bold' }, - subtitle: { fontSize: 10 }, -});`} - - -

Polyfills

-

- React Native is focused on changing the way view code is written. For the rest, we look to the web for universal standards and polyfill those APIs where appropriate. You can use npm to install JavaScript libraries that work on top of the functionality baked into React Native, such as XMLHttpRequest, window.requestAnimationFrame, and navigator.geolocation. We are working on expanding the available APIs, and are excited for the Open Source community to contribute as well. -

- -{`// iOS & Android - -import React, { - Component, -} from 'react'; -import { - Text, -} from 'react-native'; - -class GeoInfo extends Component { - constructor(props) { - super(props); - this.state = { position: 'unknown' }; - }, - componentDidMount() { - navigator.geolocation.getCurrentPosition( - (position) => this.setState({position}), - (error) => console.error(error) - ); - } - render() { - return ( - - Position: {JSON.stringify(this.state.position)} - + React Native wraps the fundamental native components, giving you + the performance of a native app, plus the clean design of React. + + ); } }`} -

Extensibility

-

- It is certainly possible to create a great app using React Native without writing a single line of native code, but React Native is also designed to be easily extended with custom native views and modules - that means you can reuse anything you{"'"}ve already built, and can import and use your favorite native libraries. -

-

Creating iOS modules

+

Don't Waste Time Recompiling

- To create a simple iOS module, create a new class that implements the RCTBridgeModule protocol, and wrap the function that you want to make available to JavaScript in RCT_EXPORT_METHOD. Additionally, the class itself must be explicitly exported with RCT_EXPORT_MODULE();. + React Native lets you build your app faster. Instead of recompiling, you can reload your app instantly. With hot reloading, you can even run new code while retaining your application state. Give it a try - it's a magical experience.

- -{`// Objective-C - -#import "RCTBridgeModule.h" - -@interface MyCustomModule : NSObject -@end - -@implementation MyCustomModule +
+ -RCT_EXPORT_MODULE(); - -// Available as NativeModules.MyCustomModule.processString -RCT_EXPORT_METHOD(processString:(NSString *)input callback:(RCTResponseSenderBlock)callback) -{ - callback(@[[input stringByReplacingOccurrencesOfString:@"Goodbye" withString:@"Hello"]]); -} -@end`} -
- -{`// JavaScript - -import React, { - Component, -} from 'react'; -import { - NativeModules, - Text, -} from 'react-native'; - -class Message extends Component { - constructor(props) { - super(props); - this.state = { text: 'Goodbye World.' }; - } - componentDidMount() { - NativeModules.MyCustomModule.processString(this.state.text, (text) => { - this.setState({text}); - }); - } - render() { - return ( - {this.state.text} - ); - } -}`} - - -

Creating iOS views

+

Use Native Code When You Need To

- Custom iOS views can be exposed by subclassing RCTViewManager, implementing a -(UIView *)view method, and exporting properties with the RCT_EXPORT_VIEW_PROPERTY macro. Then a simple JavaScript file connects the dots. + React Native combines smoothly with components written in Objective-C, Java, or Swift. It's simple to drop down to native code if you need to optimize a few aspects of your application. It's also easy to build part of your app in React Native, and part of your app using native code directly - that's how the Facebook app works.

- -{`// Objective-C - -#import "RCTViewManager.h" - -@interface MyCustomViewManager : RCTViewManager -@end - -@implementation MyCustomViewManager - -RCT_EXPORT_MODULE() - -- (UIView *)view -{ - return [[MyCustomView alloc] init]; -} - -RCT_EXPORT_VIEW_PROPERTY(myCustomProperty, NSString); -@end`} - - -{`// JavaScript - -import React, { - Component, -} from 'react'; -import { - requireNativeComponent, -} from 'react-native'; - -var NativeMyCustomView = requireNativeComponent('MyCustomView', MyCustomView); - -export default class MyCustomView extends Component { - static propTypes = { - myCustomProperty: React.PropTypes.oneOf(['a', 'b']), - }; - render() { - return ; - } -} -`} - -

Creating Android modules

-

- Likewise, Android also supports custom extensions, the methods are just slightly different. -

-

- To create a simple module in Android, create a new class that extends the ReactContextBaseJavaModule class, and annotate the function that you want to make available to JavaScript with @ReactMethod. Additionally, the class itself must be registered in the ReactPackage of your React Native application. -

-{`// Java - -public class MyCustomModule extends ReactContextBaseJavaModule { - -// Available as NativeModules.MyCustomModule.processString - @ReactMethod - public void processString(String input, Callback callback) { - callback.invoke(input.replace("Goodbye", "Hello")); - } -} -`} - - - -{`// JavaScript +{`import React, { Component } from 'react'; +import { Text, View } from 'react-native'; +import { TheGreatestComponentInTheWorld } from './your-native-code'; -import React, { - Component, -} from 'react'; -import { - NativeModules, - Text, -} from 'react-native'; -class Message extends Component { - constructor(props) { - super(props); - this.state = { text: 'Goodbye World.' }; - }, - componentDidMount() { - NativeModules.MyCustomModule.processString(this.state.text, (text) => { - this.setState({text}); - }); - } +class SomethingFast extends Component { render() { return ( - {this.state.text} + + + + TheGreatestComponentInTheWorld could use native Objective-C, + Java, or Swift - the product development process is the same. + + ); } -} -`} - - -

Creating Android views

-

- Custom Android views can be exposed by extending SimpleViewManager, implementing a createViewInstance and getName methods, and exporting properties with the @ReactProp annotation. Then a simple JavaScript file connects the dots. -

- -{`// Java - -public class MyCustomViewManager extends SimpleViewManager { - @Override - public String getName() { - return "MyCustomView"; - } - - @Override - protected MyCustomView createViewInstance(ThemedReactContext reactContext) { - return new MyCustomView(reactContext); - } - - @ReactProp(name = "myCustomProperty") - public void setMyCustomProperty(MyCustomView view, String value) { - view.setMyCustomProperty(value); - } -} -`} - - -{`// JavaScript - -import React, { - Component, -} from 'react'; -import { - requireNativeComponent, -} from 'react-native'; - -var NativeMyCustomView = requireNativeComponent('MyCustomView', MyCustomView); - -export default class MyCustomView extends Component { - static propTypes = { - myCustomProperty: React.PropTypes.oneOf(['a', 'b']), - }; - render() { - return ; - } -} -`} +}`}