From a27a7461d96b21b3d64ac3252fda7ad8dcdc3e98 Mon Sep 17 00:00:00 2001 From: Website Deployment Script Date: Tue, 15 Oct 2019 10:04:06 +0000 Subject: [PATCH] Deploy website Deploy website version based on 490de0318c2b15a9621e2bb18d242ff3d8cf3501 --- docs/0.40/layout-props.html | 4 ++-- docs/0.40/layout-props/index.html | 4 ++-- docs/0.40/panresponder.html | 6 +++--- docs/0.40/panresponder/index.html | 6 +++--- docs/0.40/scrollview.html | 15 +++++++++------ docs/0.40/scrollview/index.html | 15 +++++++++------ docs/0.40/textinput.html | 6 +++--- docs/0.40/textinput/index.html | 6 +++--- docs/0.41/layout-props.html | 4 ++-- docs/0.41/layout-props/index.html | 4 ++-- docs/0.41/panresponder.html | 6 +++--- docs/0.41/panresponder/index.html | 6 +++--- docs/0.42/panresponder.html | 6 +++--- docs/0.42/panresponder/index.html | 6 +++--- docs/0.43/panresponder.html | 6 +++--- docs/0.43/panresponder/index.html | 6 +++--- docs/0.44/panresponder.html | 6 +++--- docs/0.44/panresponder/index.html | 6 +++--- docs/0.60/animated.html | 18 +++++++++--------- docs/0.60/animated/index.html | 18 +++++++++--------- docs/0.60/appstate.html | 2 +- docs/0.60/appstate/index.html | 2 +- docs/0.60/asyncstorage.html | 4 ++-- docs/0.60/asyncstorage/index.html | 4 ++-- docs/0.60/communication-android.html | 4 ++-- docs/0.60/communication-android/index.html | 4 ++-- docs/0.60/datepickerios.html | 2 +- docs/0.60/datepickerios/index.html | 2 +- docs/0.60/dimensions.html | 2 +- docs/0.60/dimensions/index.html | 2 +- docs/0.60/drawerlayoutandroid.html | 2 +- docs/0.60/drawerlayoutandroid/index.html | 2 +- docs/0.60/easing.html | 14 +++++++------- docs/0.60/easing/index.html | 14 +++++++------- docs/0.60/flatlist.html | 8 ++++---- docs/0.60/flatlist/index.html | 8 ++++---- docs/0.60/hermes.html | 4 ++-- docs/0.60/hermes/index.html | 4 ++-- docs/0.60/imagebackground.html | 2 +- docs/0.60/imagebackground/index.html | 2 +- docs/0.60/inputaccessoryview.html | 2 +- docs/0.60/inputaccessoryview/index.html | 2 +- docs/0.60/layout-props.html | 4 ++-- docs/0.60/layout-props/index.html | 4 ++-- docs/0.60/modal.html | 4 ++-- docs/0.60/modal/index.html | 4 ++-- docs/0.60/out-of-tree-platforms.html | 4 ++-- docs/0.60/out-of-tree-platforms/index.html | 4 ++-- docs/0.60/panresponder.html | 6 +++--- docs/0.60/panresponder/index.html | 6 +++--- docs/0.60/safeareaview.html | 4 ++-- docs/0.60/safeareaview/index.html | 4 ++-- docs/0.60/scrollview.html | 14 +++++++------- docs/0.60/scrollview/index.html | 14 +++++++------- docs/0.60/sectionlist.html | 1 - docs/0.60/sectionlist/index.html | 1 - docs/0.60/statusbar.html | 2 +- docs/0.60/statusbar/index.html | 2 +- docs/0.60/text.html | 6 +++--- docs/0.60/text/index.html | 6 +++--- docs/0.60/textinput.html | 6 +++--- docs/0.60/textinput/index.html | 6 +++--- docs/0.60/touchablewithoutfeedback.html | 2 +- docs/0.60/touchablewithoutfeedback/index.html | 2 +- docs/0.60/vibration.html | 2 +- docs/0.60/vibration/index.html | 2 +- docs/0.60/view.html | 6 +++--- docs/0.60/view/index.html | 6 +++--- docs/animated.html | 18 +++++++++--------- docs/animated/index.html | 18 +++++++++--------- docs/appstate.html | 2 +- docs/appstate/index.html | 2 +- docs/asyncstorage.html | 4 ++-- docs/asyncstorage/index.html | 4 ++-- docs/communication-android.html | 4 ++-- docs/communication-android/index.html | 4 ++-- docs/datepickerios.html | 2 +- docs/datepickerios/index.html | 2 +- docs/dimensions.html | 2 +- docs/dimensions/index.html | 2 +- docs/drawerlayoutandroid.html | 2 +- docs/drawerlayoutandroid/index.html | 2 +- docs/easing.html | 14 +++++++------- docs/easing/index.html | 14 +++++++------- docs/flatlist.html | 8 ++++---- docs/flatlist/index.html | 8 ++++---- docs/hermes.html | 4 ++-- docs/hermes/index.html | 4 ++-- docs/imagebackground.html | 2 +- docs/imagebackground/index.html | 2 +- docs/inputaccessoryview.html | 2 +- docs/inputaccessoryview/index.html | 2 +- docs/layout-props.html | 4 ++-- docs/layout-props/index.html | 4 ++-- docs/modal.html | 4 ++-- docs/modal/index.html | 4 ++-- docs/out-of-tree-platforms.html | 4 ++-- docs/out-of-tree-platforms/index.html | 4 ++-- docs/panresponder.html | 6 +++--- docs/panresponder/index.html | 6 +++--- docs/safeareaview.html | 4 ++-- docs/safeareaview/index.html | 4 ++-- docs/scrollview.html | 14 +++++++------- docs/scrollview/index.html | 14 +++++++------- docs/sectionlist.html | 1 - docs/sectionlist/index.html | 1 - docs/statusbar.html | 2 +- docs/statusbar/index.html | 2 +- docs/text.html | 6 +++--- docs/text/index.html | 6 +++--- docs/textinput.html | 6 +++--- docs/textinput/index.html | 6 +++--- docs/touchablewithoutfeedback.html | 2 +- docs/touchablewithoutfeedback/index.html | 2 +- docs/vibration.html | 2 +- docs/vibration/index.html | 2 +- docs/view.html | 6 +++--- docs/view/index.html | 6 +++--- 118 files changed, 310 insertions(+), 308 deletions(-) diff --git a/docs/0.40/layout-props.html b/docs/0.40/layout-props.html index 890cd6514a3..862e7dae899 100644 --- a/docs/0.40/layout-props.html +++ b/docs/0.40/layout-props.html @@ -545,9 +545,9 @@

position

-

position in React Native is similar to regular CSS, but everything is set to relative by default, so absolute positioning is always just relative to the parent.

+

position in React Native is similar to regular CSS, but everything is set to relative by default, so absolute positioning is always relative to the parent.

If you want to position a child using specific numbers of logical pixels relative to its parent, set the child to have absolute position.

-

If you want to position a child relative to something that is not its parent, just don't use styles for that. Use the component tree.

+

If you want to position a child relative to something that is not its parent, don't use styles for that. Use the component tree.

See https://github.com/facebook/css-layout for more details on how position differs between React Native and CSS.

diff --git a/docs/0.40/layout-props/index.html b/docs/0.40/layout-props/index.html index 890cd6514a3..862e7dae899 100644 --- a/docs/0.40/layout-props/index.html +++ b/docs/0.40/layout-props/index.html @@ -545,9 +545,9 @@

position

-

position in React Native is similar to regular CSS, but everything is set to relative by default, so absolute positioning is always just relative to the parent.

+

position in React Native is similar to regular CSS, but everything is set to relative by default, so absolute positioning is always relative to the parent.

If you want to position a child using specific numbers of logical pixels relative to its parent, set the child to have absolute position.

-

If you want to position a child relative to something that is not its parent, just don't use styles for that. Use the component tree.

+

If you want to position a child relative to something that is not its parent, don't use styles for that. Use the component tree.

See https://github.com/facebook/css-layout for more details on how position differs between React Native and CSS.

diff --git a/docs/0.40/panresponder.html b/docs/0.40/panresponder.html index c1550920e16..a2d1deaddf2 100644 --- a/docs/0.40/panresponder.html +++ b/docs/0.40/panresponder.html @@ -1,4 +1,4 @@ -PanResponder · React Native
Edit

PanResponder

PanResponder reconciles several touches into a single gesture. It makes single-touch gestures resilient to extra touches, and can be used to recognize simple multi-touch gestures.

+
Edit

PanResponder

PanResponder reconciles several touches into a single gesture. It makes single-touch gestures resilient to extra touches, and can be used to recognize multi-touch gestures.

By default, PanResponder holds an InteractionManager handle to block long-running JS events from interrupting active gestures.

It provides a predictable wrapper of the responder handlers provided by the gesture responder system. For each handler, it provides a new gestureState object alongside the native event object:

onPanResponderMove: (event, gestureState) => {}
@@ -157,7 +157,7 @@
 
create()

 
static create(config)
 

-
@param {object} config Enhanced versions of all of the responder callbacks that provide not only the typical ResponderSyntheticEvent, but also the PanResponder gesture state. Simply replace the word Responder with PanResponder in each of the typical onResponder* callbacks. For example, the config object would look like:

+
@param {object} config Enhanced versions of all of the responder callbacks that provide not only the typical ResponderSyntheticEvent, but also the PanResponder gesture state. Replace the word Responder with PanResponder in each of the typical onResponder* callbacks. For example, the config object would look like:

 
    
 
  • onMoveShouldSetPanResponder: (e, gestureState) => {...}
    • 
 
  • onMoveShouldSetPanResponderCapture: (e, gestureState) => {...}
    • 
diff --git a/docs/0.40/panresponder/index.html b/docs/0.40/panresponder/index.html
index c1550920e16..a2d1deaddf2 100644
--- a/docs/0.40/panresponder/index.html
+++ b/docs/0.40/panresponder/index.html
@@ -1,4 +1,4 @@
-PanResponder · React Native
Edit

PanResponder

PanResponder reconciles several touches into a single gesture. It makes single-touch gestures resilient to extra touches, and can be used to recognize simple multi-touch gestures.

+
Edit

PanResponder

PanResponder reconciles several touches into a single gesture. It makes single-touch gestures resilient to extra touches, and can be used to recognize multi-touch gestures.

By default, PanResponder holds an InteractionManager handle to block long-running JS events from interrupting active gestures.

It provides a predictable wrapper of the responder handlers provided by the gesture responder system. For each handler, it provides a new gestureState object alongside the native event object:

onPanResponderMove: (event, gestureState) => {}
@@ -157,7 +157,7 @@
 
create()

 
static create(config)
 

-
@param {object} config Enhanced versions of all of the responder callbacks that provide not only the typical ResponderSyntheticEvent, but also the PanResponder gesture state. Simply replace the word Responder with PanResponder in each of the typical onResponder* callbacks. For example, the config object would look like:

+
@param {object} config Enhanced versions of all of the responder callbacks that provide not only the typical ResponderSyntheticEvent, but also the PanResponder gesture state. Replace the word Responder with PanResponder in each of the typical onResponder* callbacks. For example, the config object would look like:

 
    
 
  • onMoveShouldSetPanResponder: (e, gestureState) => {...}
    • 
 
  • onMoveShouldSetPanResponderCapture: (e, gestureState) => {...}
    • 
diff --git a/docs/0.40/scrollview.html b/docs/0.40/scrollview.html
index 9f6aadc54a6..1990bfe76fb 100644
--- a/docs/0.40/scrollview.html
+++ b/docs/0.40/scrollview.html
@@ -69,10 +69,10 @@
               }
             });
Edit

ScrollView

Component that wraps platform ScrollView while providing integration with touch locking "responder" system.

-

Keep in mind that ScrollViews must have a bounded height in order to work, since they contain unbounded-height children into a bounded container (via a scroll interaction). In order to bound the height of a ScrollView, either set the height of the view directly (discouraged) or make sure all parent views have bounded height. Forgetting to transfer {flex: 1} down the view stack can lead to errors here, which the element inspector makes easy to debug.

+

Keep in mind that ScrollViews must have a bounded height in order to work, since they contain unbounded-height children into a bounded container (via a scroll interaction). In order to bound the height of a ScrollView, either set the height of the view directly (discouraged) or make sure all parent views have bounded height. Forgetting to transfer {flex: 1} down the view stack can lead to errors here, which the element inspector can be used to debug.

Doesn't yet support other contained responders from blocking this scroll view from becoming the responder.

-

<ScrollView> vs <ListView> - which one to use? ScrollView simply renders all its react child components at once. That makes it very easy to understand and use. On the other hand, this has a performance downside. Imagine you have a very long list of items you want to display, worth of couple of your ScrollView’s heights. Creating JS components and native views upfront for all its items, which may not even be shown, will contribute to slow rendering of your screen and increased memory usage.

-

This is where ListView comes into play. ListView renders items lazily, just when they are about to appear. This laziness comes at cost of a more complicated API, which is worth it unless you are rendering a small fixed set of items.

+

<ScrollView> vs <ListView> - which one to use? ScrollView renders all its react child components at once. That makes it very understandable and useful. On the other hand, this has a performance downside. Imagine you have a very long list of items you want to display, worth of couple of your ScrollView’s heights. Creating JS components and native views upfront for all its items, which may not even be shown, will contribute to slow rendering of your screen and increased memory usage.

+

This is where ListView comes into play. ListView renders items lazily, right when they are about to appear. This laziness comes at cost of a more complicated API, which is worth it unless you are rendering a small fixed set of items.

Props

  • View props...
    • @@ -458,9 +458,12 @@

    indicatorStyle

    The style of the scroll indicators.

      -
    • default (the default), same as black.
      • -
    • black, scroll indicator is black. This style is good against a white content background.
      • -
    • white, scroll indicator is white. This style is good against a black content background.
      • +
    • default (the default), same as black. + +- `black`, scroll indicator is black. This style is good against a light content background. + +- `white`, scroll indicator is white. This style is good against a dark content background. +
diff --git a/docs/0.40/scrollview/index.html b/docs/0.40/scrollview/index.html index 9f6aadc54a6..1990bfe76fb 100644 --- a/docs/0.40/scrollview/index.html +++ b/docs/0.40/scrollview/index.html @@ -69,10 +69,10 @@ } });
Edit

ScrollView

Component that wraps platform ScrollView while providing integration with touch locking "responder" system.

-

Keep in mind that ScrollViews must have a bounded height in order to work, since they contain unbounded-height children into a bounded container (via a scroll interaction). In order to bound the height of a ScrollView, either set the height of the view directly (discouraged) or make sure all parent views have bounded height. Forgetting to transfer {flex: 1} down the view stack can lead to errors here, which the element inspector makes easy to debug.

+

Keep in mind that ScrollViews must have a bounded height in order to work, since they contain unbounded-height children into a bounded container (via a scroll interaction). In order to bound the height of a ScrollView, either set the height of the view directly (discouraged) or make sure all parent views have bounded height. Forgetting to transfer {flex: 1} down the view stack can lead to errors here, which the element inspector can be used to debug.

Doesn't yet support other contained responders from blocking this scroll view from becoming the responder.

-

<ScrollView> vs <ListView> - which one to use? ScrollView simply renders all its react child components at once. That makes it very easy to understand and use. On the other hand, this has a performance downside. Imagine you have a very long list of items you want to display, worth of couple of your ScrollView’s heights. Creating JS components and native views upfront for all its items, which may not even be shown, will contribute to slow rendering of your screen and increased memory usage.

-

This is where ListView comes into play. ListView renders items lazily, just when they are about to appear. This laziness comes at cost of a more complicated API, which is worth it unless you are rendering a small fixed set of items.

+

<ScrollView> vs <ListView> - which one to use? ScrollView renders all its react child components at once. That makes it very understandable and useful. On the other hand, this has a performance downside. Imagine you have a very long list of items you want to display, worth of couple of your ScrollView’s heights. Creating JS components and native views upfront for all its items, which may not even be shown, will contribute to slow rendering of your screen and increased memory usage.

+

This is where ListView comes into play. ListView renders items lazily, right when they are about to appear. This laziness comes at cost of a more complicated API, which is worth it unless you are rendering a small fixed set of items.

Props

  • View props...
    • @@ -458,9 +458,12 @@

    indicatorStyle

    The style of the scroll indicators.

      -
    • default (the default), same as black.
      • -
    • black, scroll indicator is black. This style is good against a white content background.
      • -
    • white, scroll indicator is white. This style is good against a black content background.
      • +
    • default (the default), same as black. + +- `black`, scroll indicator is black. This style is good against a light content background. + +- `white`, scroll indicator is white. This style is good against a dark content background. +
diff --git a/docs/0.40/textinput.html b/docs/0.40/textinput.html index f3e973fd6c5..81082944a5f 100644 --- a/docs/0.40/textinput.html +++ b/docs/0.40/textinput.html @@ -69,7 +69,7 @@ } });
Edit

TextInput

A foundational component for inputting text into the app via a keyboard. Props provide configurability for several features, such as auto-correction, auto-capitalization, placeholder text, and different keyboard types, such as a numeric keypad.

-

The simplest use case is to plop down a TextInput and subscribe to the onChangeText events to read the user input. There are also other events, such as onSubmitEditing and onFocus that can be subscribed to. A simple example:

+

The simplest use case is to plop down a TextInput and subscribe to the onChangeText events to read the user input. There are also other events, such as onSubmitEditing and onFocus that can be subscribed to. An example:

defaultValue

-

Provides an initial value that will change when the user starts typing. Useful for simple use-cases where you do not want to deal with listening to events and updating the value prop to keep the controlled state in sync.

+

Provides an initial value that will change when the user starts typing. Useful for use-cases where you do not want to deal with listening to events and updating the value prop to keep the controlled state in sync.

@@ -564,7 +564,7 @@ AppRegistry.registerComponent(
TypeRequired

value

-

The value to show for the text input. TextInput is a controlled component, which means the native value will be forced to match this value prop if provided. For most uses, this works great, but in some cases this may cause flickering - one common cause is preventing edits by keeping value the same. In addition to simply setting the same value, either set editable={false}, or set/update maxLength to prevent unwanted edits without flicker.

+

The value to show for the text input. TextInput is a controlled component, which means the native value will be forced to match this value prop if provided. For most uses, this works great, but in some cases this may cause flickering - one common cause is preventing edits by keeping value the same. In addition to setting the same value, either set editable={false}, or set/update maxLength to prevent unwanted edits without flicker.

diff --git a/docs/0.40/textinput/index.html b/docs/0.40/textinput/index.html index f3e973fd6c5..81082944a5f 100644 --- a/docs/0.40/textinput/index.html +++ b/docs/0.40/textinput/index.html @@ -69,7 +69,7 @@ } });
Edit

TextInput

A foundational component for inputting text into the app via a keyboard. Props provide configurability for several features, such as auto-correction, auto-capitalization, placeholder text, and different keyboard types, such as a numeric keypad.

-

The simplest use case is to plop down a TextInput and subscribe to the onChangeText events to read the user input. There are also other events, such as onSubmitEditing and onFocus that can be subscribed to. A simple example:

+

The simplest use case is to plop down a TextInput and subscribe to the onChangeText events to read the user input. There are also other events, such as onSubmitEditing and onFocus that can be subscribed to. An example:

TypeRequired

defaultValue

-

Provides an initial value that will change when the user starts typing. Useful for simple use-cases where you do not want to deal with listening to events and updating the value prop to keep the controlled state in sync.

+

Provides an initial value that will change when the user starts typing. Useful for use-cases where you do not want to deal with listening to events and updating the value prop to keep the controlled state in sync.

@@ -564,7 +564,7 @@ AppRegistry.registerComponent(
TypeRequired

value

-

The value to show for the text input. TextInput is a controlled component, which means the native value will be forced to match this value prop if provided. For most uses, this works great, but in some cases this may cause flickering - one common cause is preventing edits by keeping value the same. In addition to simply setting the same value, either set editable={false}, or set/update maxLength to prevent unwanted edits without flicker.

+

The value to show for the text input. TextInput is a controlled component, which means the native value will be forced to match this value prop if provided. For most uses, this works great, but in some cases this may cause flickering - one common cause is preventing edits by keeping value the same. In addition to setting the same value, either set editable={false}, or set/update maxLength to prevent unwanted edits without flicker.

diff --git a/docs/0.41/layout-props.html b/docs/0.41/layout-props.html index f400863b395..69534e2b867 100644 --- a/docs/0.41/layout-props.html +++ b/docs/0.41/layout-props.html @@ -545,9 +545,9 @@
TypeRequired

position

-

position in React Native is similar to regular CSS, but everything is set to relative by default, so absolute positioning is always just relative to the parent.

+

position in React Native is similar to regular CSS, but everything is set to relative by default, so absolute positioning is always relative to the parent.

If you want to position a child using specific numbers of logical pixels relative to its parent, set the child to have absolute position.

-

If you want to position a child relative to something that is not its parent, just don't use styles for that. Use the component tree.

+

If you want to position a child relative to something that is not its parent, don't use styles for that. Use the component tree.

See https://github.com/facebook/css-layout for more details on how position differs between React Native and CSS.

diff --git a/docs/0.41/layout-props/index.html b/docs/0.41/layout-props/index.html index f400863b395..69534e2b867 100644 --- a/docs/0.41/layout-props/index.html +++ b/docs/0.41/layout-props/index.html @@ -545,9 +545,9 @@

position

-

position in React Native is similar to regular CSS, but everything is set to relative by default, so absolute positioning is always just relative to the parent.

+

position in React Native is similar to regular CSS, but everything is set to relative by default, so absolute positioning is always relative to the parent.

If you want to position a child using specific numbers of logical pixels relative to its parent, set the child to have absolute position.

-

If you want to position a child relative to something that is not its parent, just don't use styles for that. Use the component tree.

+

If you want to position a child relative to something that is not its parent, don't use styles for that. Use the component tree.

See https://github.com/facebook/css-layout for more details on how position differs between React Native and CSS.

diff --git a/docs/0.41/panresponder.html b/docs/0.41/panresponder.html index e8a8f391986..e90dc5a9ad5 100644 --- a/docs/0.41/panresponder.html +++ b/docs/0.41/panresponder.html @@ -1,4 +1,4 @@ -PanResponder · React Native
Edit

PanResponder

PanResponder reconciles several touches into a single gesture. It makes single-touch gestures resilient to extra touches, and can be used to recognize simple multi-touch gestures.

+
Edit

PanResponder

PanResponder reconciles several touches into a single gesture. It makes single-touch gestures resilient to extra touches, and can be used to recognize multi-touch gestures.

By default, PanResponder holds an InteractionManager handle to block long-running JS events from interrupting active gestures.

It provides a predictable wrapper of the responder handlers provided by the gesture responder system. For each handler, it provides a new gestureState object alongside the native event object:

onPanResponderMove: (event, gestureState) => {}
@@ -157,7 +157,7 @@
 
create()

 
static create(config)
 

-
@param {object} config Enhanced versions of all of the responder callbacks that provide not only the typical ResponderSyntheticEvent, but also the PanResponder gesture state. Simply replace the word Responder with PanResponder in each of the typical onResponder* callbacks. For example, the config object would look like:

+
@param {object} config Enhanced versions of all of the responder callbacks that provide not only the typical ResponderSyntheticEvent, but also the PanResponder gesture state. Replace the word Responder with PanResponder in each of the typical onResponder* callbacks. For example, the config object would look like:

 
    
 
  • onMoveShouldSetPanResponder: (e, gestureState) => {...}
    • 
 
  • onMoveShouldSetPanResponderCapture: (e, gestureState) => {...}
    • 
diff --git a/docs/0.41/panresponder/index.html b/docs/0.41/panresponder/index.html
index e8a8f391986..e90dc5a9ad5 100644
--- a/docs/0.41/panresponder/index.html
+++ b/docs/0.41/panresponder/index.html
@@ -1,4 +1,4 @@
-PanResponder · React Native
Edit

PanResponder

PanResponder reconciles several touches into a single gesture. It makes single-touch gestures resilient to extra touches, and can be used to recognize simple multi-touch gestures.

+
Edit

PanResponder

PanResponder reconciles several touches into a single gesture. It makes single-touch gestures resilient to extra touches, and can be used to recognize multi-touch gestures.

By default, PanResponder holds an InteractionManager handle to block long-running JS events from interrupting active gestures.

It provides a predictable wrapper of the responder handlers provided by the gesture responder system. For each handler, it provides a new gestureState object alongside the native event object:

onPanResponderMove: (event, gestureState) => {}
@@ -157,7 +157,7 @@
 
create()

 
static create(config)
 

-
@param {object} config Enhanced versions of all of the responder callbacks that provide not only the typical ResponderSyntheticEvent, but also the PanResponder gesture state. Simply replace the word Responder with PanResponder in each of the typical onResponder* callbacks. For example, the config object would look like:

+
@param {object} config Enhanced versions of all of the responder callbacks that provide not only the typical ResponderSyntheticEvent, but also the PanResponder gesture state. Replace the word Responder with PanResponder in each of the typical onResponder* callbacks. For example, the config object would look like:

 
    
 
  • onMoveShouldSetPanResponder: (e, gestureState) => {...}
    • 
 
  • onMoveShouldSetPanResponderCapture: (e, gestureState) => {...}
    • 
diff --git a/docs/0.42/panresponder.html b/docs/0.42/panresponder.html
index 8a20ca880a8..32f3f367fdb 100644
--- a/docs/0.42/panresponder.html
+++ b/docs/0.42/panresponder.html
@@ -1,4 +1,4 @@
-PanResponder · React Native
Edit

PanResponder

PanResponder reconciles several touches into a single gesture. It makes single-touch gestures resilient to extra touches, and can be used to recognize simple multi-touch gestures.

+
Edit

PanResponder

PanResponder reconciles several touches into a single gesture. It makes single-touch gestures resilient to extra touches, and can be used to recognize multi-touch gestures.

By default, PanResponder holds an InteractionManager handle to block long-running JS events from interrupting active gestures.

It provides a predictable wrapper of the responder handlers provided by the gesture responder system. For each handler, it provides a new gestureState object alongside the native event object:

onPanResponderMove: (event, gestureState) => {}
@@ -157,7 +157,7 @@
 
create()

 
static create(config)
 

-
@param {object} config Enhanced versions of all of the responder callbacks that provide not only the typical ResponderSyntheticEvent, but also the PanResponder gesture state. Simply replace the word Responder with PanResponder in each of the typical onResponder* callbacks. For example, the config object would look like:

+
@param {object} config Enhanced versions of all of the responder callbacks that provide not only the typical ResponderSyntheticEvent, but also the PanResponder gesture state. Replace the word Responder with PanResponder in each of the typical onResponder* callbacks. For example, the config object would look like:

 
    
 
  • onMoveShouldSetPanResponder: (e, gestureState) => {...}
    • 
 
  • onMoveShouldSetPanResponderCapture: (e, gestureState) => {...}
    • 
diff --git a/docs/0.42/panresponder/index.html b/docs/0.42/panresponder/index.html
index 8a20ca880a8..32f3f367fdb 100644
--- a/docs/0.42/panresponder/index.html
+++ b/docs/0.42/panresponder/index.html
@@ -1,4 +1,4 @@
-PanResponder · React Native
Edit

PanResponder

PanResponder reconciles several touches into a single gesture. It makes single-touch gestures resilient to extra touches, and can be used to recognize simple multi-touch gestures.

+
Edit

PanResponder

PanResponder reconciles several touches into a single gesture. It makes single-touch gestures resilient to extra touches, and can be used to recognize multi-touch gestures.

By default, PanResponder holds an InteractionManager handle to block long-running JS events from interrupting active gestures.

It provides a predictable wrapper of the responder handlers provided by the gesture responder system. For each handler, it provides a new gestureState object alongside the native event object:

onPanResponderMove: (event, gestureState) => {}
@@ -157,7 +157,7 @@
 
create()

 
static create(config)
 

-
@param {object} config Enhanced versions of all of the responder callbacks that provide not only the typical ResponderSyntheticEvent, but also the PanResponder gesture state. Simply replace the word Responder with PanResponder in each of the typical onResponder* callbacks. For example, the config object would look like:

+
@param {object} config Enhanced versions of all of the responder callbacks that provide not only the typical ResponderSyntheticEvent, but also the PanResponder gesture state. Replace the word Responder with PanResponder in each of the typical onResponder* callbacks. For example, the config object would look like:

 
    
 
  • onMoveShouldSetPanResponder: (e, gestureState) => {...}
    • 
 
  • onMoveShouldSetPanResponderCapture: (e, gestureState) => {...}
    • 
diff --git a/docs/0.43/panresponder.html b/docs/0.43/panresponder.html
index c7c75ed4445..847957c9a1a 100644
--- a/docs/0.43/panresponder.html
+++ b/docs/0.43/panresponder.html
@@ -1,4 +1,4 @@
-PanResponder · React Native
Edit

PanResponder

PanResponder reconciles several touches into a single gesture. It makes single-touch gestures resilient to extra touches, and can be used to recognize simple multi-touch gestures.

+
Edit

PanResponder

PanResponder reconciles several touches into a single gesture. It makes single-touch gestures resilient to extra touches, and can be used to recognize multi-touch gestures.

By default, PanResponder holds an InteractionManager handle to block long-running JS events from interrupting active gestures.

It provides a predictable wrapper of the responder handlers provided by the gesture responder system. For each handler, it provides a new gestureState object alongside the native event object:

onPanResponderMove: (event, gestureState) => {}
@@ -157,7 +157,7 @@
 
create()

 
static create(config)
 

-
@param {object} config Enhanced versions of all of the responder callbacks that provide not only the typical ResponderSyntheticEvent, but also the PanResponder gesture state. Simply replace the word Responder with PanResponder in each of the typical onResponder* callbacks. For example, the config object would look like:

+
@param {object} config Enhanced versions of all of the responder callbacks that provide not only the typical ResponderSyntheticEvent, but also the PanResponder gesture state. Replace the word Responder with PanResponder in each of the typical onResponder* callbacks. For example, the config object would look like:

 
    
 
  • onMoveShouldSetPanResponder: (e, gestureState) => {...}
    • 
 
  • onMoveShouldSetPanResponderCapture: (e, gestureState) => {...}
    • 
diff --git a/docs/0.43/panresponder/index.html b/docs/0.43/panresponder/index.html
index c7c75ed4445..847957c9a1a 100644
--- a/docs/0.43/panresponder/index.html
+++ b/docs/0.43/panresponder/index.html
@@ -1,4 +1,4 @@
-PanResponder · React Native
Edit

PanResponder

PanResponder reconciles several touches into a single gesture. It makes single-touch gestures resilient to extra touches, and can be used to recognize simple multi-touch gestures.

+
Edit

PanResponder

PanResponder reconciles several touches into a single gesture. It makes single-touch gestures resilient to extra touches, and can be used to recognize multi-touch gestures.

By default, PanResponder holds an InteractionManager handle to block long-running JS events from interrupting active gestures.

It provides a predictable wrapper of the responder handlers provided by the gesture responder system. For each handler, it provides a new gestureState object alongside the native event object:

onPanResponderMove: (event, gestureState) => {}
@@ -157,7 +157,7 @@
 
create()

 
static create(config)
 

-
@param {object} config Enhanced versions of all of the responder callbacks that provide not only the typical ResponderSyntheticEvent, but also the PanResponder gesture state. Simply replace the word Responder with PanResponder in each of the typical onResponder* callbacks. For example, the config object would look like:

+
@param {object} config Enhanced versions of all of the responder callbacks that provide not only the typical ResponderSyntheticEvent, but also the PanResponder gesture state. Replace the word Responder with PanResponder in each of the typical onResponder* callbacks. For example, the config object would look like:

 
    
 
  • onMoveShouldSetPanResponder: (e, gestureState) => {...}
    • 
 
  • onMoveShouldSetPanResponderCapture: (e, gestureState) => {...}
    • 
diff --git a/docs/0.44/panresponder.html b/docs/0.44/panresponder.html
index 2bcebc136b5..ab72bd82019 100644
--- a/docs/0.44/panresponder.html
+++ b/docs/0.44/panresponder.html
@@ -1,4 +1,4 @@
-PanResponder · React Native
Edit

PanResponder

PanResponder reconciles several touches into a single gesture. It makes single-touch gestures resilient to extra touches, and can be used to recognize simple multi-touch gestures.

+
Edit

PanResponder

PanResponder reconciles several touches into a single gesture. It makes single-touch gestures resilient to extra touches, and can be used to recognize multi-touch gestures.

By default, PanResponder holds an InteractionManager handle to block long-running JS events from interrupting active gestures.

It provides a predictable wrapper of the responder handlers provided by the gesture responder system. For each handler, it provides a new gestureState object alongside the native event object:

onPanResponderMove: (event, gestureState) => {}
@@ -157,7 +157,7 @@
 
create()

 
static create(config)
 

-
@param {object} config Enhanced versions of all of the responder callbacks that provide not only the typical ResponderSyntheticEvent, but also the PanResponder gesture state. Simply replace the word Responder with PanResponder in each of the typical onResponder* callbacks. For example, the config object would look like:

+
@param {object} config Enhanced versions of all of the responder callbacks that provide not only the typical ResponderSyntheticEvent, but also the PanResponder gesture state. Replace the word Responder with PanResponder in each of the typical onResponder* callbacks. For example, the config object would look like:

 
    
 
  • onMoveShouldSetPanResponder: (e, gestureState) => {...}
    • 
 
  • onMoveShouldSetPanResponderCapture: (e, gestureState) => {...}
    • 
diff --git a/docs/0.44/panresponder/index.html b/docs/0.44/panresponder/index.html
index 2bcebc136b5..ab72bd82019 100644
--- a/docs/0.44/panresponder/index.html
+++ b/docs/0.44/panresponder/index.html
@@ -1,4 +1,4 @@
-PanResponder · React Native
Edit

PanResponder

PanResponder reconciles several touches into a single gesture. It makes single-touch gestures resilient to extra touches, and can be used to recognize simple multi-touch gestures.

+
Edit

PanResponder

PanResponder reconciles several touches into a single gesture. It makes single-touch gestures resilient to extra touches, and can be used to recognize multi-touch gestures.

By default, PanResponder holds an InteractionManager handle to block long-running JS events from interrupting active gestures.

It provides a predictable wrapper of the responder handlers provided by the gesture responder system. For each handler, it provides a new gestureState object alongside the native event object:

onPanResponderMove: (event, gestureState) => {}
@@ -157,7 +157,7 @@
 
create()

 
static create(config)
 

-
@param {object} config Enhanced versions of all of the responder callbacks that provide not only the typical ResponderSyntheticEvent, but also the PanResponder gesture state. Simply replace the word Responder with PanResponder in each of the typical onResponder* callbacks. For example, the config object would look like:

+
@param {object} config Enhanced versions of all of the responder callbacks that provide not only the typical ResponderSyntheticEvent, but also the PanResponder gesture state. Replace the word Responder with PanResponder in each of the typical onResponder* callbacks. For example, the config object would look like:

 
    
 
  • onMoveShouldSetPanResponder: (e, gestureState) => {...}
    • 
 
  • onMoveShouldSetPanResponderCapture: (e, gestureState) => {...}
    • 
diff --git a/docs/0.60/animated.html b/docs/0.60/animated.html
index 4a43b14675d..4f2b95aae47 100644
--- a/docs/0.60/animated.html
+++ b/docs/0.60/animated.html
@@ -1,4 +1,4 @@
-Animated · React Native
Edit

Animated

The Animated library is designed to make animations fluid, powerful, and easy to build and maintain. Animated focuses on declarative relationships between inputs and outputs, with configurable transforms in between, and simple start/stop methods to control time-based animation execution.

-

The simplest workflow for creating an animation is to create an Animated.Value, hook it up to one or more style attributes of an animated component, and then drive updates via animations using Animated.timing():

+
Edit

Animated

The Animated library is designed to make animations fluid, powerful, and painless to build and maintain. Animated focuses on declarative relationships between inputs and outputs, with configurable transforms in between, and start/stop methods to control time-based animation execution.

+

The most basic workflow for creating an animation is to create an Animated.Value, hook it up to one or more style attributes of an animated component, and then drive updates via animations using Animated.timing():

Animated.timing(
   // Animate value over time
   this.state.fadeAnim, // The value to drive
@@ -90,7 +90,7 @@
 
Animated provides three types of animation types. Each animation type provides a particular animation curve that controls how your values animate from their initial value to the final value:

 
 
In most cases, you will be using timing(). By default, it uses a symmetric easeInOut curve that conveys the gradual acceleration of an object to full speed and concludes by gradually decelerating to a stop.

@@ -100,7 +100,7 @@
 
By using the native driver, we send everything about the animation to native before starting the animation, allowing native code to perform the animation on the UI thread without having to go through the bridge on every frame. Once the animation has started, the JS thread can be blocked without affecting the animation.

 
You can use the native driver by specifying useNativeDriver: true in your animation configuration. See the Animations guide to learn more.

 
Animatable components

-
Only animatable components can be animated. These special components do the magic of binding the animated values to the properties, and do targeted native updates to avoid the cost of the react render and reconciliation process on every frame. They also handle cleanup on unmount so they are safe by default.

+
Only animatable components can be animated. These unique components do the magic of binding the animated values to the properties, and do targeted native updates to avoid the cost of the react render and reconciliation process on every frame. They also handle cleanup on unmount so they are safe by default.

 
@@ -121,7 +121,7 @@
 
  • Animated.sequence() starts the animations in order, waiting for each to complete before starting the next.
    • 
 
  • Animated.stagger() starts animations in order and in parallel, but with successive delays.
    • 
 
-
    Animations can also be chained together simply by setting the toValue of one animation to be another Animated.Value. See Tracking dynamic values in the Animations guide.
    
+
    Animations can also be chained together by setting the toValue of one animation to be another Animated.Value. See Tracking dynamic values in the Animations guide.
    
 
    By default, if one animation is stopped or interrupted, then all other animations in the group are also stopped.
    
 
    Combining animated values
    
 
    You can combine two animated values via addition, subtraction, multiplication, division, or modulo to make a new animated value:
    
@@ -189,14 +189,14 @@
 
    Animates a value according to an analytical spring model based on damped harmonic oscillation. Tracks velocity state to create fluid motions as the toValue updates, and can be chained together.
    
 
    Config is an object that may have the following options.
    
 
    Note that you can only define one of bounciness/speed, tension/friction, or stiffness/damping/mass, but not more than one:
    
-
    The friction/tension or bounciness/speed options match the spring model in Facebook Pop, Rebound, and Origami.
    
+
    The friction/tension or bounciness/speed options match the spring model in Facebook Pop, Rebound, and Origami.
    
 
      
 
    • friction: Controls "bounciness"/overshoot. Default 7.
      • 
 
    • tension: Controls speed. Default 40.
      • 
 
    • speed: Controls speed of the animation. Default 12.
      • 
 
    • bounciness: Controls bounciness. Default 8.
      • 
 
    
-
    Specifying stiffness/damping/mass as parameters makes Animated.spring use an analytical spring model based on the motion equations of a damped harmonic oscillator. This behavior is slightly more precise and faithful to the physics behind spring dynamics, and closely mimics the implementation in iOS's CASpringAnimation primitive.
    
+
    Specifying stiffness/damping/mass as parameters makes Animated.spring use an analytical spring model based on the motion equations of a damped harmonic oscillator. This behavior is slightly more precise and faithful to the physics behind spring dynamics, and closely mimics the implementation in iOS's CASpringAnimation.
    
 
      
 
    • stiffness: The spring stiffness coefficient. Default 100.
      • 
 
    • damping: Defines how the spring’s motion should be damped due to the forces of friction. Default 10.
      • 
@@ -297,7 +297,7 @@
 
      forkEvent()
      
 
      static forkEvent(event, listener)
 
      
-
      Advanced imperative API for snooping on animated events that are passed in through props. It permits to add a new javascript listener to an existing AnimatedEvent. If animatedEvent is a simple javascript listener, it will merge the 2 listeners into a single one, and if animatedEvent is null/undefined, it will assign the javascript listener directly. Use values directly where possible.
      
+
      Advanced imperative API for snooping on animated events that are passed in through props. It permits to add a new javascript listener to an existing AnimatedEvent. If animatedEvent is a javascript listener, it will merge the 2 listeners into a single one, and if animatedEvent is null/undefined, it will assign the javascript listener directly. Use values directly where possible.
      
 
      
 
      unforkEvent()
      
 
      static unforkEvent(event, listener)
diff --git a/docs/0.60/animated/index.html b/docs/0.60/animated/index.html
index 4a43b14675d..4f2b95aae47 100644
--- a/docs/0.60/animated/index.html
+++ b/docs/0.60/animated/index.html
@@ -1,4 +1,4 @@
-Animated · React Native
    Edit

    Animated

    The Animated library is designed to make animations fluid, powerful, and easy to build and maintain. Animated focuses on declarative relationships between inputs and outputs, with configurable transforms in between, and simple start/stop methods to control time-based animation execution.

    -

    The simplest workflow for creating an animation is to create an Animated.Value, hook it up to one or more style attributes of an animated component, and then drive updates via animations using Animated.timing():

    +
    Edit

    Animated

    The Animated library is designed to make animations fluid, powerful, and painless to build and maintain. Animated focuses on declarative relationships between inputs and outputs, with configurable transforms in between, and start/stop methods to control time-based animation execution.

    +

    The most basic workflow for creating an animation is to create an Animated.Value, hook it up to one or more style attributes of an animated component, and then drive updates via animations using Animated.timing():

    Animated.timing(
   // Animate value over time
   this.state.fadeAnim, // The value to drive
@@ -90,7 +90,7 @@
 
    Animated provides three types of animation types. Each animation type provides a particular animation curve that controls how your values animate from their initial value to the final value:
    
 
 
    In most cases, you will be using timing(). By default, it uses a symmetric easeInOut curve that conveys the gradual acceleration of an object to full speed and concludes by gradually decelerating to a stop.
    
@@ -100,7 +100,7 @@
 
    By using the native driver, we send everything about the animation to native before starting the animation, allowing native code to perform the animation on the UI thread without having to go through the bridge on every frame. Once the animation has started, the JS thread can be blocked without affecting the animation.
    
 
    You can use the native driver by specifying useNativeDriver: true in your animation configuration. See the Animations guide to learn more.
    
 
    Animatable components
    
-
    Only animatable components can be animated. These special components do the magic of binding the animated values to the properties, and do targeted native updates to avoid the cost of the react render and reconciliation process on every frame. They also handle cleanup on unmount so they are safe by default.
    
+
    Only animatable components can be animated. These unique components do the magic of binding the animated values to the properties, and do targeted native updates to avoid the cost of the react render and reconciliation process on every frame. They also handle cleanup on unmount so they are safe by default.
    
 
@@ -121,7 +121,7 @@
 
  • Animated.sequence() starts the animations in order, waiting for each to complete before starting the next.
    • 
 
  • Animated.stagger() starts animations in order and in parallel, but with successive delays.
    • 
 
-
    Animations can also be chained together simply by setting the toValue of one animation to be another Animated.Value. See Tracking dynamic values in the Animations guide.
    
+
    Animations can also be chained together by setting the toValue of one animation to be another Animated.Value. See Tracking dynamic values in the Animations guide.
    
 
    By default, if one animation is stopped or interrupted, then all other animations in the group are also stopped.
    
 
    Combining animated values
    
 
    You can combine two animated values via addition, subtraction, multiplication, division, or modulo to make a new animated value:
    
@@ -189,14 +189,14 @@
 
    Animates a value according to an analytical spring model based on damped harmonic oscillation. Tracks velocity state to create fluid motions as the toValue updates, and can be chained together.
    
 
    Config is an object that may have the following options.
    
 
    Note that you can only define one of bounciness/speed, tension/friction, or stiffness/damping/mass, but not more than one:
    
-
    The friction/tension or bounciness/speed options match the spring model in Facebook Pop, Rebound, and Origami.
    
+
    The friction/tension or bounciness/speed options match the spring model in Facebook Pop, Rebound, and Origami.
    
 
      
 
    • friction: Controls "bounciness"/overshoot. Default 7.
      • 
 
    • tension: Controls speed. Default 40.
      • 
 
    • speed: Controls speed of the animation. Default 12.
      • 
 
    • bounciness: Controls bounciness. Default 8.
      • 
 
    
-
    Specifying stiffness/damping/mass as parameters makes Animated.spring use an analytical spring model based on the motion equations of a damped harmonic oscillator. This behavior is slightly more precise and faithful to the physics behind spring dynamics, and closely mimics the implementation in iOS's CASpringAnimation primitive.
    
+
    Specifying stiffness/damping/mass as parameters makes Animated.spring use an analytical spring model based on the motion equations of a damped harmonic oscillator. This behavior is slightly more precise and faithful to the physics behind spring dynamics, and closely mimics the implementation in iOS's CASpringAnimation.
    
 
      
 
    • stiffness: The spring stiffness coefficient. Default 100.
      • 
 
    • damping: Defines how the spring’s motion should be damped due to the forces of friction. Default 10.
      • 
@@ -297,7 +297,7 @@
 
      forkEvent()
      
 
      static forkEvent(event, listener)
 
      
-
      Advanced imperative API for snooping on animated events that are passed in through props. It permits to add a new javascript listener to an existing AnimatedEvent. If animatedEvent is a simple javascript listener, it will merge the 2 listeners into a single one, and if animatedEvent is null/undefined, it will assign the javascript listener directly. Use values directly where possible.
      
+
      Advanced imperative API for snooping on animated events that are passed in through props. It permits to add a new javascript listener to an existing AnimatedEvent. If animatedEvent is a javascript listener, it will merge the 2 listeners into a single one, and if animatedEvent is null/undefined, it will assign the javascript listener directly. Use values directly where possible.
      
 
      
 
      unforkEvent()
      
 
      static unforkEvent(event, listener)
diff --git a/docs/0.60/appstate.html b/docs/0.60/appstate.html
index 681cda0aceb..6cc28a5c47b 100644
--- a/docs/0.60/appstate.html
+++ b/docs/0.60/appstate.html
@@ -130,7 +130,7 @@
 
      addEventListener(type, handler);
 
      
 
      Add a handler to AppState changes by listening to the change event type and providing the handler
      
-
      TODO: now that AppState is a subclass of NativeEventEmitter, we could deprecate addEventListener and removeEventListener and just use addListener and listener.remove() directly. That will be a breaking change though, as both the method and event names are different (addListener events are currently required to be globally unique).
      
+
      TODO: now that AppState is a subclass of NativeEventEmitter, we could deprecate addEventListener and removeEventListener and use addListener and listener.remove() directly. That will be a breaking change though, as both the method and event names are different (addListener events are currently required to be globally unique).
      
 
      
 
      removeEventListener()
      
 
      removeEventListener(type, handler);
diff --git a/docs/0.60/appstate/index.html b/docs/0.60/appstate/index.html
index 681cda0aceb..6cc28a5c47b 100644
--- a/docs/0.60/appstate/index.html
+++ b/docs/0.60/appstate/index.html
@@ -130,7 +130,7 @@
 
      addEventListener(type, handler);
 
      
 
      Add a handler to AppState changes by listening to the change event type and providing the handler
      
-
      TODO: now that AppState is a subclass of NativeEventEmitter, we could deprecate addEventListener and removeEventListener and just use addListener and listener.remove() directly. That will be a breaking change though, as both the method and event names are different (addListener events are currently required to be globally unique).
      
+
      TODO: now that AppState is a subclass of NativeEventEmitter, we could deprecate addEventListener and removeEventListener and use addListener and listener.remove() directly. That will be a breaking change though, as both the method and event names are different (addListener events are currently required to be globally unique).
      
 
      
 
      removeEventListener()
      
 
      removeEventListener(type, handler);
diff --git a/docs/0.60/asyncstorage.html b/docs/0.60/asyncstorage.html
index 1a66744ed66..650ca7b3957 100644
--- a/docs/0.60/asyncstorage.html
+++ b/docs/0.60/asyncstorage.html
@@ -71,10 +71,10 @@
    Edit

    AsyncStorage

    Deprecated. Use react-native-community/react-native-async-storage instead.

    -

    AsyncStorage is a simple, unencrypted, asynchronous, persistent, key-value storage system that is global to the app. It should be used instead of LocalStorage.

    +

    AsyncStorage is an unencrypted, asynchronous, persistent, key-value storage system that is global to the app. It should be used instead of LocalStorage.

    It is recommended that you use an abstraction on top of AsyncStorage instead of AsyncStorage directly for anything more than light usage since it operates globally.

    On iOS, AsyncStorage is backed by native code that stores small values in a serialized dictionary and larger values in separate files. On Android, AsyncStorage will use either RocksDB or SQLite based on what is available.

    -

    The AsyncStorage JavaScript code is a simple facade that provides a clear JavaScript API, real Error objects, and simple non-multi functions. Each method in the API returns a Promise object.

    +

    The AsyncStorage JavaScript code is a facade that provides a clear JavaScript API, real Error objects, and non-multi functions. Each method in the API returns a Promise object.

    Importing the AsyncStorage library:

    import {AsyncStorage} from 'react-native';
    diff --git a/docs/0.60/asyncstorage/index.html b/docs/0.60/asyncstorage/index.html index 1a66744ed66..650ca7b3957 100644 --- a/docs/0.60/asyncstorage/index.html +++ b/docs/0.60/asyncstorage/index.html @@ -71,10 +71,10 @@
    Edit

    AsyncStorage

    Deprecated. Use react-native-community/react-native-async-storage instead.

    -

    AsyncStorage is a simple, unencrypted, asynchronous, persistent, key-value storage system that is global to the app. It should be used instead of LocalStorage.

    +

    AsyncStorage is an unencrypted, asynchronous, persistent, key-value storage system that is global to the app. It should be used instead of LocalStorage.

    It is recommended that you use an abstraction on top of AsyncStorage instead of AsyncStorage directly for anything more than light usage since it operates globally.

    On iOS, AsyncStorage is backed by native code that stores small values in a serialized dictionary and larger values in separate files. On Android, AsyncStorage will use either RocksDB or SQLite based on what is available.

    -

    The AsyncStorage JavaScript code is a simple facade that provides a clear JavaScript API, real Error objects, and simple non-multi functions. Each method in the API returns a Promise object.

    +

    The AsyncStorage JavaScript code is a facade that provides a clear JavaScript API, real Error objects, and non-multi functions. Each method in the API returns a Promise object.

    Importing the AsyncStorage library:

    import {AsyncStorage} from 'react-native';
    diff --git a/docs/0.60/communication-android.html b/docs/0.60/communication-android.html index 1331ec9011a..97445fdb57e 100644 --- a/docs/0.60/communication-android.html +++ b/docs/0.60/communication-android.html @@ -15,7 +15,7 @@

    0.60

    Edit

    Communication between native and React Native

    In Integrating with Existing Apps guide and Native UI Components guide we learn how to embed React Native in a native component and vice versa. When we mix native and React Native components, we'll eventually find a need to communicate between these two worlds. Some ways to achieve that have been already mentioned in other guides. This article summarizes available techniques.

    Introduction

    React Native is inspired by React, so the basic idea of the information flow is similar. The flow in React is one-directional. We maintain a hierarchy of components, in which each component depends only on its parent and its own internal state. We do this with properties: data is passed from a parent to its children in a top-down manner. If an ancestor component relies on the state of its descendant, one should pass down a callback to be used by the descendant to update the ancestor.

    -

    The same concept applies to React Native. As long as we are building our application purely within the framework, we can drive our app with properties and callbacks. But, when we mix React Native and native components, we need some special, cross-language mechanisms that would allow us to pass information between them.

    +

    The same concept applies to React Native. As long as we are building our application purely within the framework, we can drive our app with properties and callbacks. But, when we mix React Native and native components, we need some specific, cross-language mechanisms that would allow us to pass information between them.

    Properties

    Properties are the simplest way of cross-component communication. So we need a way to pass properties both from native to React Native, and from React Native to native.

    Passing properties from native to React Native

    @@ -66,7 +66,7 @@ mReactRootView.

    initialDate

    -

    Provides an initial value that will change when the user starts selecting a date. It is useful for simple use-cases where you do not want to deal with listening to events and updating the date prop to keep the controlled state in sync. The controlled state has known bugs which causes it to go out of sync with native. The initialDate prop is intended to allow you to have native be source of truth.

    +

    Provides an initial value that will change when the user starts selecting a date. It is useful for use-cases where you do not want to deal with listening to events and updating the date prop to keep the controlled state in sync. The controlled state has known bugs which causes it to go out of sync with native. The initialDate prop is intended to allow you to have native be source of truth.

    diff --git a/docs/0.60/datepickerios/index.html b/docs/0.60/datepickerios/index.html index f0f7476e551..9571f11988c 100644 --- a/docs/0.60/datepickerios/index.html +++ b/docs/0.60/datepickerios/index.html @@ -223,7 +223,7 @@
    TypeRequired

    initialDate

    -

    Provides an initial value that will change when the user starts selecting a date. It is useful for simple use-cases where you do not want to deal with listening to events and updating the date prop to keep the controlled state in sync. The controlled state has known bugs which causes it to go out of sync with native. The initialDate prop is intended to allow you to have native be source of truth.

    +

    Provides an initial value that will change when the user starts selecting a date. It is useful for use-cases where you do not want to deal with listening to events and updating the date prop to keep the controlled state in sync. The controlled state has known bugs which causes it to go out of sync with native. The initialDate prop is intended to allow you to have native be source of truth.

    diff --git a/docs/0.60/dimensions.html b/docs/0.60/dimensions.html index 234631930a4..0c1d03b593d 100644 --- a/docs/0.60/dimensions.html +++ b/docs/0.60/dimensions.html @@ -100,7 +100,7 @@ 
    static set(dims)

    This should only be called from native code by sending the didUpdateDimensions event.

    -

    @param {object} dims Simple string-keyed object of dimensions to set

    +

    @param {object} dims string-keyed object of dimensions to set

    ← DatePickerAndroidEasing →
    Edit

    FlatList

    A performant interface for rendering simple, flat lists, supporting the most handy features:

    +
    Edit

    FlatList

    A performant interface for rendering basic, flat lists, supporting the most handy features:

    • Fully cross-platform.
    • Optional horizontal mode.
      • @@ -315,7 +315,7 @@ const styles = StyleSheet.create({

      data

      -

      For simplicity, data is just a plain array. If you want to use something else, like an immutable list, use the underlying VirtualizedList directly.

      +

      For simplicity, data is a plain array. If you want to use something else, like an immutable list, use the underlying VirtualizedList directly.

    TypeRequired
    @@ -416,7 +416,7 @@ const styles = StyleSheet.create({

    getItemLayout

    (data, index) => {length: number, offset: number, index: number}
    -

    getItemLayout is an optional optimization that allows skipping the measurement of dynamic content if you know the size (height or width) of items ahead of time. getItemLayout is both efficient and easy to use if you have fixed size items, for example:

    +

    getItemLayout is an optional optimization that allows skipping the measurement of dynamic content if you know the size (height or width) of items ahead of time. getItemLayout is efficient if you have fixed size items, for example:

      getItemLayout={(data, index) => (
     {length: ITEM_HEIGHT, offset: ITEM_HEIGHT * index, index}
   )}
diff --git a/docs/0.60/flatlist/index.html b/docs/0.60/flatlist/index.html
index 9f08a3f87cd..a42ab650961 100644
--- a/docs/0.60/flatlist/index.html
+++ b/docs/0.60/flatlist/index.html
@@ -1,4 +1,4 @@
-FlatList · React Native
    Edit
    FlatList
    A performant interface for rendering simple, flat lists, supporting the most handy features:
    
+        
    Edit
    FlatList
    A performant interface for rendering basic, flat lists, supporting the most handy features:
    
 
      
 
    • Fully cross-platform.
      • 
 
    • Optional horizontal mode.
      • 
@@ -315,7 +315,7 @@ const styles = StyleSheet.create({

    data

    -

    For simplicity, data is just a plain array. If you want to use something else, like an immutable list, use the underlying VirtualizedList directly.

    +

    For simplicity, data is a plain array. If you want to use something else, like an immutable list, use the underlying VirtualizedList directly.

    TypeRequired
    @@ -416,7 +416,7 @@ const styles = StyleSheet.create({

    getItemLayout

    (data, index) => {length: number, offset: number, index: number}
    -

    getItemLayout is an optional optimization that allows skipping the measurement of dynamic content if you know the size (height or width) of items ahead of time. getItemLayout is both efficient and easy to use if you have fixed size items, for example:

    +

    getItemLayout is an optional optimization that allows skipping the measurement of dynamic content if you know the size (height or width) of items ahead of time. getItemLayout is efficient if you have fixed size items, for example:

      getItemLayout={(data, index) => (
     {length: ITEM_HEIGHT, offset: ITEM_HEIGHT * index, index}
   )}
diff --git a/docs/0.60/hermes.html b/docs/0.60/hermes.html
index 70dde82a7e3..9cbc51a6b23 100644
--- a/docs/0.60/hermes.html
+++ b/docs/0.60/hermes.html
@@ -71,7 +71,7 @@
         
    Edit
    Using Hermes
    
 
 
    
-
    Hermes is an open-source JavaScript engine optimized for running React Native apps on Android. For many apps, simply enabling Hermes will result in improved start-up time, decreased memory usage, and smaller app size. At this time Hermes is an opt-in React Native feature, and this guide explains how to enable it.
    
+
    Hermes is an open-source JavaScript engine optimized for running React Native apps on Android. For many apps, enabling Hermes will result in improved start-up time, decreased memory usage, and smaller app size. At this time Hermes is an opt-in React Native feature, and this guide explains how to enable it.
    
 
    First, ensure you're using at least version 0.60.4 of React Native.
    
 
    If you have an existing app based on an earlier version of React Native, you will have to upgrade it first. See Upgrading to new React Native Versions for how to do this. Make especially sure that all changes to android/app/build.gradle have been applied, as detailed by the React Native upgrade helper. After upgrading the app, make sure everything works before trying to switch to Hermes.
    
 
    
@@ -95,7 +95,7 @@
 
    $ react-native run-android
 
    
 
    Confirming Hermes is in use
    
-
    If you've just created a new app from scratch you should see if Hermes is enabled in the welcome view:
    
+
    If you've recently created a new app from scratch you should see if Hermes is enabled in the welcome view:
    
 
    Where to find JS engine status in AwesomeProject
    
 
    A HermesInternal global variable will be available in JavaScript that can be used to verify that Hermes is in use:
    
 
    const isHermes = () => global.HermesInternal != null;
diff --git a/docs/0.60/hermes/index.html b/docs/0.60/hermes/index.html
index 70dde82a7e3..9cbc51a6b23 100644
--- a/docs/0.60/hermes/index.html
+++ b/docs/0.60/hermes/index.html
@@ -71,7 +71,7 @@
         
    Edit
    Using Hermes
    
 
 
    
-
    Hermes is an open-source JavaScript engine optimized for running React Native apps on Android. For many apps, simply enabling Hermes will result in improved start-up time, decreased memory usage, and smaller app size. At this time Hermes is an opt-in React Native feature, and this guide explains how to enable it.
    
+
    Hermes is an open-source JavaScript engine optimized for running React Native apps on Android. For many apps, enabling Hermes will result in improved start-up time, decreased memory usage, and smaller app size. At this time Hermes is an opt-in React Native feature, and this guide explains how to enable it.
    
 
    First, ensure you're using at least version 0.60.4 of React Native.
    
 
    If you have an existing app based on an earlier version of React Native, you will have to upgrade it first. See Upgrading to new React Native Versions for how to do this. Make especially sure that all changes to android/app/build.gradle have been applied, as detailed by the React Native upgrade helper. After upgrading the app, make sure everything works before trying to switch to Hermes.
    
 
    
@@ -95,7 +95,7 @@
 
    $ react-native run-android
 
    
 
    Confirming Hermes is in use
    
-
    If you've just created a new app from scratch you should see if Hermes is enabled in the welcome view:
    
+
    If you've recently created a new app from scratch you should see if Hermes is enabled in the welcome view:
    
 
    Where to find JS engine status in AwesomeProject
    
 
    A HermesInternal global variable will be available in JavaScript that can be used to verify that Hermes is in use:
    
 
    const isHermes = () => global.HermesInternal != null;
diff --git a/docs/0.60/imagebackground.html b/docs/0.60/imagebackground.html
index 8c4f13a1a7c..b67b379984f 100644
--- a/docs/0.60/imagebackground.html
+++ b/docs/0.60/imagebackground.html
@@ -69,7 +69,7 @@
               }
             });
         
    Edit
    ImageBackground
    A common feature request from developers familiar with the web is background-image. To handle this use case, you can use the <ImageBackground> component, which has the same props as <Image>, and add whatever children to it you would like to layer on top of it.
    
-
    You might not want to use <ImageBackground> in some cases, since the implementation is very simple. Refer to <ImageBackground>'s source code for more insight, and create your own custom component when needed.
    
+
    You might not want to use <ImageBackground> in some cases, since the implementation is basic. Refer to <ImageBackground>'s source code for more insight, and create your own custom component when needed.
    
 
    Note that you must specify some width and height style attributes.
    
 
    Example
    
 
    return (
diff --git a/docs/0.60/imagebackground/index.html b/docs/0.60/imagebackground/index.html
index 8c4f13a1a7c..b67b379984f 100644
--- a/docs/0.60/imagebackground/index.html
+++ b/docs/0.60/imagebackground/index.html
@@ -69,7 +69,7 @@
               }
             });
         
    Edit
    ImageBackground
    A common feature request from developers familiar with the web is background-image. To handle this use case, you can use the <ImageBackground> component, which has the same props as <Image>, and add whatever children to it you would like to layer on top of it.
    
-
    You might not want to use <ImageBackground> in some cases, since the implementation is very simple. Refer to <ImageBackground>'s source code for more insight, and create your own custom component when needed.
    
+
    You might not want to use <ImageBackground> in some cases, since the implementation is basic. Refer to <ImageBackground>'s source code for more insight, and create your own custom component when needed.
    
 
    Note that you must specify some width and height style attributes.
    
 
    Example
    
 
    return (
diff --git a/docs/0.60/inputaccessoryview.html b/docs/0.60/inputaccessoryview.html
index 4bc25ac877a..9ebcc7c42e8 100644
--- a/docs/0.60/inputaccessoryview.html
+++ b/docs/0.60/inputaccessoryview.html
@@ -69,7 +69,7 @@
               }
             });
         
    Edit
    InputAccessoryView
    A component which enables customization of the keyboard input accessory view on iOS. The input accessory view is displayed above the keyboard whenever a TextInput has focus. This component can be used to create custom toolbars.
    
-
    To use this component wrap your custom toolbar with the InputAccessoryView component, and set a nativeID. Then, pass that nativeID as the inputAccessoryViewID of whatever TextInput you desire. A simple example:
    
+
    To use this component wrap your custom toolbar with the InputAccessoryView component, and set a nativeID. Then, pass that nativeID as the inputAccessoryViewID of whatever TextInput you desire. A basic example:
    
 
    Edit
    InputAccessoryView
    A component which enables customization of the keyboard input accessory view on iOS. The input accessory view is displayed above the keyboard whenever a TextInput has focus. This component can be used to create custom toolbars.
    
-
    To use this component wrap your custom toolbar with the InputAccessoryView component, and set a nativeID. Then, pass that nativeID as the inputAccessoryViewID of whatever TextInput you desire. A simple example:
    
+
    To use this component wrap your custom toolbar with the InputAccessoryView component, and set a nativeID. Then, pass that nativeID as the inputAccessoryViewID of whatever TextInput you desire. A basic example:
    TypeRequired

    position

    -

    position in React Native is similar to regular CSS, but everything is set to relative by default, so absolute positioning is always just relative to the parent.

    +

    position in React Native is similar to regular CSS, but everything is set to relative by default, so absolute positioning is always relative to the parent.

    If you want to position a child using specific numbers of logical pixels relative to its parent, set the child to have absolute position.

    -

    If you want to position a child relative to something that is not its parent, just don't use styles for that. Use the component tree.

    +

    If you want to position a child relative to something that is not its parent, don't use styles for that. Use the component tree.

    See https://github.com/facebook/yoga for more details on how position differs between React Native and CSS.

    diff --git a/docs/0.60/layout-props/index.html b/docs/0.60/layout-props/index.html index 0b68feb9d3d..48ad478b3ba 100644 --- a/docs/0.60/layout-props/index.html +++ b/docs/0.60/layout-props/index.html @@ -611,9 +611,9 @@

    position

    -

    position in React Native is similar to regular CSS, but everything is set to relative by default, so absolute positioning is always just relative to the parent.

    +

    position in React Native is similar to regular CSS, but everything is set to relative by default, so absolute positioning is always relative to the parent.

    If you want to position a child using specific numbers of logical pixels relative to its parent, set the child to have absolute position.

    -

    If you want to position a child relative to something that is not its parent, just don't use styles for that. Use the component tree.

    +

    If you want to position a child relative to something that is not its parent, don't use styles for that. Use the component tree.

    See https://github.com/facebook/yoga for more details on how position differs between React Native and CSS.

    diff --git a/docs/0.60/modal.html b/docs/0.60/modal.html index f3788024118..bc51d50fa49 100644 --- a/docs/0.60/modal.html +++ b/docs/0.60/modal.html @@ -1,4 +1,4 @@ -Modal · React Native
    Edit

    Modal

    The Modal component is a simple way to present content above an enclosing view.

    +
    Edit

    Modal

    The Modal component is a basic way to present content above an enclosing view.

    Note: If you need more control over how to present modals over the rest of your app, then consider using a top-level Navigator.

    diff --git a/docs/0.60/modal/index.html b/docs/0.60/modal/index.html index f3788024118..bc51d50fa49 100644 --- a/docs/0.60/modal/index.html +++ b/docs/0.60/modal/index.html @@ -1,4 +1,4 @@ -Modal · React Native
    Edit

    Modal

    The Modal component is a simple way to present content above an enclosing view.

    +
    Edit

    Modal

    The Modal component is a basic way to present content above an enclosing view.

    Note: If you need more control over how to present modals over the rest of your app, then consider using a top-level Navigator.

    diff --git a/docs/0.60/out-of-tree-platforms.html b/docs/0.60/out-of-tree-platforms.html index 65cac09d1eb..e6b27a6ca0e 100644 --- a/docs/0.60/out-of-tree-platforms.html +++ b/docs/0.60/out-of-tree-platforms.html @@ -1,4 +1,4 @@ -Out-of-Tree Platforms · React Native
    Edit

    Out-of-Tree Platforms

    React Native is not just for Android and iOS - there are community-supported projects that bring it to other platforms, such as:

    +
    Edit

    Out-of-Tree Platforms

    React Native is not only for Android and iOS - there are community-supported projects that bring it to other platforms, such as:

    • React Native Windows - React Native support for Microsoft's Universal Windows Platform (UWP) and the Windows Presentation Foundation (WPF)
    • React Native DOM - An experimental, comprehensive port of React Native to the web. (Not to be confused with React Native Web, which has different goals)
      • diff --git a/docs/0.60/out-of-tree-platforms/index.html b/docs/0.60/out-of-tree-platforms/index.html index 65cac09d1eb..e6b27a6ca0e 100644 --- a/docs/0.60/out-of-tree-platforms/index.html +++ b/docs/0.60/out-of-tree-platforms/index.html @@ -1,4 +1,4 @@ -Out-of-Tree Platforms · React Native
    Edit

    Out-of-Tree Platforms

    React Native is not just for Android and iOS - there are community-supported projects that bring it to other platforms, such as:

    +
    Edit

    Out-of-Tree Platforms

    React Native is not only for Android and iOS - there are community-supported projects that bring it to other platforms, such as:

    • React Native Windows - React Native support for Microsoft's Universal Windows Platform (UWP) and the Windows Presentation Foundation (WPF)
    • React Native DOM - An experimental, comprehensive port of React Native to the web. (Not to be confused with React Native Web, which has different goals)
      • diff --git a/docs/0.60/panresponder.html b/docs/0.60/panresponder.html index 8ceed85e52c..6a0d14dcf25 100644 --- a/docs/0.60/panresponder.html +++ b/docs/0.60/panresponder.html @@ -1,4 +1,4 @@ -PanResponder · React Native
    Edit

    PanResponder

    PanResponder reconciles several touches into a single gesture. It makes single-touch gestures resilient to extra touches, and can be used to recognize simple multi-touch gestures.

    +
    Edit

    PanResponder

    PanResponder reconciles several touches into a single gesture. It makes single-touch gestures resilient to extra touches, and can be used to recognize basic multi-touch gestures.

    By default, PanResponder holds an InteractionManager handle to block long-running JS events from interrupting active gestures.

    It provides a predictable wrapper of the responder handlers provided by the gesture responder system. For each handler, it provides a new gestureState object alongside the native event object:

    onPanResponderMove: (event, gestureState) => {}
@@ -152,7 +152,7 @@
 
    create()
    
 
    static create(config)
 
    
-
    @param {object} config Enhanced versions of all of the responder callbacks that provide not only the typical ResponderSyntheticEvent, but also the PanResponder gesture state. Simply replace the word Responder with PanResponder in each of the typical onResponder* callbacks. For example, the config object would look like:
    
+
    @param {object} config Enhanced versions of all of the responder callbacks that provide not only the typical ResponderSyntheticEvent, but also the PanResponder gesture state, by replacing the word Responder with PanResponder in each of the typical onResponder* callbacks. For example, the config object would look like:
    
 
      
 
    • onMoveShouldSetPanResponder: (e, gestureState) => {...}
      • 
 
    • onMoveShouldSetPanResponderCapture: (e, gestureState) => {...}
      • 
diff --git a/docs/0.60/panresponder/index.html b/docs/0.60/panresponder/index.html
index 8ceed85e52c..6a0d14dcf25 100644
--- a/docs/0.60/panresponder/index.html
+++ b/docs/0.60/panresponder/index.html
@@ -1,4 +1,4 @@
-PanResponder · React Native
    Edit

    PanResponder

    PanResponder reconciles several touches into a single gesture. It makes single-touch gestures resilient to extra touches, and can be used to recognize simple multi-touch gestures.

    +
    Edit

    PanResponder

    PanResponder reconciles several touches into a single gesture. It makes single-touch gestures resilient to extra touches, and can be used to recognize basic multi-touch gestures.

    By default, PanResponder holds an InteractionManager handle to block long-running JS events from interrupting active gestures.

    It provides a predictable wrapper of the responder handlers provided by the gesture responder system. For each handler, it provides a new gestureState object alongside the native event object:

    onPanResponderMove: (event, gestureState) => {}
@@ -152,7 +152,7 @@
 
    create()
    
 
    static create(config)
 
    
-
    @param {object} config Enhanced versions of all of the responder callbacks that provide not only the typical ResponderSyntheticEvent, but also the PanResponder gesture state. Simply replace the word Responder with PanResponder in each of the typical onResponder* callbacks. For example, the config object would look like:
    
+
    @param {object} config Enhanced versions of all of the responder callbacks that provide not only the typical ResponderSyntheticEvent, but also the PanResponder gesture state, by replacing the word Responder with PanResponder in each of the typical onResponder* callbacks. For example, the config object would look like:
    
 
      
 
    • onMoveShouldSetPanResponder: (e, gestureState) => {...}
      • 
 
    • onMoveShouldSetPanResponderCapture: (e, gestureState) => {...}
      • 
diff --git a/docs/0.60/safeareaview.html b/docs/0.60/safeareaview.html
index e9c7adab7f1..ac776517e00 100644
--- a/docs/0.60/safeareaview.html
+++ b/docs/0.60/safeareaview.html
@@ -69,9 +69,9 @@
               }
             });
    Edit

    SafeAreaView

    The purpose of SafeAreaView is to render content within the safe area boundaries of a device. It is currently only applicable to iOS devices with iOS version 11 or later.

    -

    SafeAreaView renders nested content and automatically applies paddings to reflect the portion of the view that is not covered by navigation bars, tab bars, toolbars, and other ancestor views. Moreover, and most importantly, Safe Area's paddings reflect the physical limitation of the screen, such as rounded corners or camera notches (i.e. the sensor housing area on iPhone X).

    +

    SafeAreaView renders nested content and automatically applies padding to reflect the portion of the view that is not covered by navigation bars, tab bars, toolbars, and other ancestor views. Moreover, and most importantly, Safe Area's paddings reflect the physical limitation of the screen, such as rounded corners or camera notches (i.e. the sensor housing area on iPhone X).

    Usage Example

    -

    Simply wrap your top level view with a SafeAreaView with a flex: 1 style applied to it. You may also want to use a background color that matches your application's design.

    +

    To use, wrap your top level view with a SafeAreaView with a flex: 1 style applied to it. You may also want to use a background color that matches your application's design.

    Edit

    SafeAreaView

    The purpose of SafeAreaView is to render content within the safe area boundaries of a device. It is currently only applicable to iOS devices with iOS version 11 or later.

    -

    SafeAreaView renders nested content and automatically applies paddings to reflect the portion of the view that is not covered by navigation bars, tab bars, toolbars, and other ancestor views. Moreover, and most importantly, Safe Area's paddings reflect the physical limitation of the screen, such as rounded corners or camera notches (i.e. the sensor housing area on iPhone X).

    +

    SafeAreaView renders nested content and automatically applies padding to reflect the portion of the view that is not covered by navigation bars, tab bars, toolbars, and other ancestor views. Moreover, and most importantly, Safe Area's paddings reflect the physical limitation of the screen, such as rounded corners or camera notches (i.e. the sensor housing area on iPhone X).

    Usage Example

    -

    Simply wrap your top level view with a SafeAreaView with a flex: 1 style applied to it. You may also want to use a background color that matches your application's design.

    +

    To use, wrap your top level view with a SafeAreaView with a flex: 1 style applied to it. You may also want to use a background color that matches your application's design.

    Edit

    ScrollView

    Component that wraps platform ScrollView while providing integration with touch locking "responder" system.

    -

    Keep in mind that ScrollViews must have a bounded height in order to work, since they contain unbounded-height children into a bounded container (via a scroll interaction). In order to bound the height of a ScrollView, either set the height of the view directly (discouraged) or make sure all parent views have bounded height. Forgetting to transfer {flex: 1} down the view stack can lead to errors here, which the element inspector makes easy to debug.

    +

    Keep in mind that ScrollViews must have a bounded height in order to work, since they contain unbounded-height children into a bounded container (via a scroll interaction). In order to bound the height of a ScrollView, either set the height of the view directly (discouraged) or make sure all parent views have bounded height. Forgetting to transfer {flex: 1} down the view stack can lead to errors here, which the element inspector makes quick to debug.

    Doesn't yet support other contained responders from blocking this scroll view from becoming the responder.

    <ScrollView> vs <FlatList> - which one to use?

    -

    ScrollView simply renders all its react child components at once. That makes it very easy to understand and use.

    -

    On the other hand, this has a performance downside. Imagine you have a very long list of items you want to display, maybe several screens worth of content. Creating JS components and native views for everything all at once, much of which may not even be shown, will contribute to slow rendering and increased memory usage.

    -

    This is where FlatList comes into play. FlatList renders items lazily, just when they are about to appear, and removes items that scroll way off screen to save memory and processing time.

    +

    ScrollView renders all its react child components at once, but this has a performance downside.

    +

    Imagine you have a very long list of items you want to display, maybe several screens worth of content. Creating JS components and native views for everything all at once, much of which may not even be shown, will contribute to slow rendering and increased memory usage.

    +

    This is where FlatList comes into play. FlatList renders items lazily, when they are about to appear, and removes items that scroll way off screen to save memory and processing time.

    FlatList is also handy if you want to render separators between your items, multiple columns, infinite scroll loading, or any number of other features it supports out of the box.

    Example

    @@ -401,7 +401,7 @@ const styles = StyleSheet.create({

    When set, the scroll view will adjust the scroll position so that the first child that is currently visible and at or beyond minIndexForVisible will not change position. This is useful for lists that are loading content in both directions, e.g. a chat thread, where new messages coming in might otherwise cause the scroll position to jump. A value of 0 is common, but other values such as 1 can be used to skip loading spinners or other content that should not maintain position.

    The optional autoscrollToTopThreshold can be used to make the content automatically scroll to the top after making the adjustment if the user was within the threshold of the top before the adjustment was made. This is also useful for chat-like applications where you want to see new messages scroll into place, but not if the user has scrolled up a ways and it would be disruptive to scroll a bunch.

    Caveat 1: Reordering elements in the scrollview with this enabled will probably cause jumpiness and jank. It can be fixed, but there are currently no plans to do so. For now, don't re-order the content of any ScrollViews or Lists that use this feature.

    -

    Caveat 2: This simply uses contentOffset and frame.origin in native code to compute visibility. Occlusion, transforms, and other complexity won't be taken into account as to whether content is "visible" or not.

    +

    Caveat 2: This uses contentOffset and frame.origin in native code to compute visibility. Occlusion, transforms, and other complexity won't be taken into account as to whether content is "visible" or not.

    diff --git a/docs/0.60/scrollview/index.html b/docs/0.60/scrollview/index.html index 5cf3a154b06..77d7cfdd5e6 100644 --- a/docs/0.60/scrollview/index.html +++ b/docs/0.60/scrollview/index.html @@ -69,12 +69,12 @@ } });
    Edit

    ScrollView

    Component that wraps platform ScrollView while providing integration with touch locking "responder" system.

    -

    Keep in mind that ScrollViews must have a bounded height in order to work, since they contain unbounded-height children into a bounded container (via a scroll interaction). In order to bound the height of a ScrollView, either set the height of the view directly (discouraged) or make sure all parent views have bounded height. Forgetting to transfer {flex: 1} down the view stack can lead to errors here, which the element inspector makes easy to debug.

    +

    Keep in mind that ScrollViews must have a bounded height in order to work, since they contain unbounded-height children into a bounded container (via a scroll interaction). In order to bound the height of a ScrollView, either set the height of the view directly (discouraged) or make sure all parent views have bounded height. Forgetting to transfer {flex: 1} down the view stack can lead to errors here, which the element inspector makes quick to debug.

    Doesn't yet support other contained responders from blocking this scroll view from becoming the responder.

    <ScrollView> vs <FlatList> - which one to use?

    -

    ScrollView simply renders all its react child components at once. That makes it very easy to understand and use.

    -

    On the other hand, this has a performance downside. Imagine you have a very long list of items you want to display, maybe several screens worth of content. Creating JS components and native views for everything all at once, much of which may not even be shown, will contribute to slow rendering and increased memory usage.

    -

    This is where FlatList comes into play. FlatList renders items lazily, just when they are about to appear, and removes items that scroll way off screen to save memory and processing time.

    +

    ScrollView renders all its react child components at once, but this has a performance downside.

    +

    Imagine you have a very long list of items you want to display, maybe several screens worth of content. Creating JS components and native views for everything all at once, much of which may not even be shown, will contribute to slow rendering and increased memory usage.

    +

    This is where FlatList comes into play. FlatList renders items lazily, when they are about to appear, and removes items that scroll way off screen to save memory and processing time.

    FlatList is also handy if you want to render separators between your items, multiple columns, infinite scroll loading, or any number of other features it supports out of the box.

    Example

    TypeRequiredPlatform
    @@ -401,7 +401,7 @@ const styles = StyleSheet.create({

    When set, the scroll view will adjust the scroll position so that the first child that is currently visible and at or beyond minIndexForVisible will not change position. This is useful for lists that are loading content in both directions, e.g. a chat thread, where new messages coming in might otherwise cause the scroll position to jump. A value of 0 is common, but other values such as 1 can be used to skip loading spinners or other content that should not maintain position.

    The optional autoscrollToTopThreshold can be used to make the content automatically scroll to the top after making the adjustment if the user was within the threshold of the top before the adjustment was made. This is also useful for chat-like applications where you want to see new messages scroll into place, but not if the user has scrolled up a ways and it would be disruptive to scroll a bunch.

    Caveat 1: Reordering elements in the scrollview with this enabled will probably cause jumpiness and jank. It can be fixed, but there are currently no plans to do so. For now, don't re-order the content of any ScrollViews or Lists that use this feature.

    -

    Caveat 2: This simply uses contentOffset and frame.origin in native code to compute visibility. Occlusion, transforms, and other complexity won't be taken into account as to whether content is "visible" or not.

    +

    Caveat 2: This uses contentOffset and frame.origin in native code to compute visibility. Occlusion, transforms, and other complexity won't be taken into account as to whether content is "visible" or not.

    diff --git a/docs/0.60/sectionlist.html b/docs/0.60/sectionlist.html index 391db139988..d970f49f388 100644 --- a/docs/0.60/sectionlist.html +++ b/docs/0.60/sectionlist.html @@ -82,7 +82,6 @@
  • Scroll loading.

    • If you don't need section support and want a simpler interface, use <FlatList>.

    -

    Simple Examples:

    Example

    TypeRequiredPlatform
    diff --git a/docs/0.60/statusbar/index.html b/docs/0.60/statusbar/index.html index 52fec60b7e1..cf5228d036c 100644 --- a/docs/0.60/statusbar/index.html +++ b/docs/0.60/statusbar/index.html @@ -166,7 +166,7 @@

    popStackEntry()

    static popStackEntry(entry: any)
    -

    Pop a StatusBar entry from the stack.

    +

    Get and remove the last a StatusBar entry from the stack.

    Parameters:

    diff --git a/docs/0.60/text.html b/docs/0.60/text.html index cbcd336e7e1..c2ec19841cd 100644 --- a/docs/0.60/text.html +++ b/docs/0.60/text.html @@ -157,7 +157,7 @@ 9-17: bold, red

    Containers

    -

    The <Text> element is special relative to layout: everything inside is no longer using the flexbox layout but using text layout. This means that elements inside of a <Text> are no longer rectangles, but wrap when they see the end of the line.

    +

    The <Text> element is unique relative to layout: everything inside is no longer using the flexbox layout but using text layout. This means that elements inside of a <Text> are no longer rectangles, but wrap when they see the end of the line.

    <Text>
   <Text>First part and </Text>
   <Text>second part</Text>
@@ -213,7 +213,7 @@
   <MyAppHeaderText>Text styled as a header</MyAppHeaderText>
 </View>
    -

    Assuming that MyAppText is a component that simply renders out its children into a Text component with styling, then MyAppHeaderText can be defined as follows:

    +

    Assuming that MyAppText is a component that only renders out its children into a Text component with styling, then MyAppHeaderText can be defined as follows:

    class MyAppHeaderText extends Component {
   render() {
     return (
@@ -240,7 +240,7 @@
 
    Reference
    
 
    Props
    
 
    accessibilityHint
    
-
    An accessibility hint helps users understand what will happen when they perform an action on the accessibility element when that result is not obvious from the accessibility label.
    
+
    An accessibility hint helps users understand what will happen when they perform an action on the accessibility element when that result is not clear from the accessibility label.
    diff --git a/docs/0.60/text/index.html b/docs/0.60/text/index.html index cbcd336e7e1..c2ec19841cd 100644 --- a/docs/0.60/text/index.html +++ b/docs/0.60/text/index.html @@ -157,7 +157,7 @@ 9-17: bold, red

    Containers

    -

    The <Text> element is special relative to layout: everything inside is no longer using the flexbox layout but using text layout. This means that elements inside of a <Text> are no longer rectangles, but wrap when they see the end of the line.

    +

    The <Text> element is unique relative to layout: everything inside is no longer using the flexbox layout but using text layout. This means that elements inside of a <Text> are no longer rectangles, but wrap when they see the end of the line.

    <Text>
   <Text>First part and </Text>
   <Text>second part</Text>
@@ -213,7 +213,7 @@
   <MyAppHeaderText>Text styled as a header</MyAppHeaderText>
 </View>
    -

    Assuming that MyAppText is a component that simply renders out its children into a Text component with styling, then MyAppHeaderText can be defined as follows:

    +

    Assuming that MyAppText is a component that only renders out its children into a Text component with styling, then MyAppHeaderText can be defined as follows:

    class MyAppHeaderText extends Component {
   render() {
     return (
@@ -240,7 +240,7 @@
 
    Reference
    
 
    Props
    
 
    accessibilityHint
    
-
    An accessibility hint helps users understand what will happen when they perform an action on the accessibility element when that result is not obvious from the accessibility label.
    
+
    An accessibility hint helps users understand what will happen when they perform an action on the accessibility element when that result is not clear from the accessibility label.
    TypeRequired
    diff --git a/docs/0.60/textinput.html b/docs/0.60/textinput.html index 1b2bfff7718..3440eb78c20 100644 --- a/docs/0.60/textinput.html +++ b/docs/0.60/textinput.html @@ -69,7 +69,7 @@ } });
    Edit

    TextInput

    A foundational component for inputting text into the app via a keyboard. Props provide configurability for several features, such as auto-correction, auto-capitalization, placeholder text, and different keyboard types, such as a numeric keypad.

    -

    The simplest use case is to plop down a TextInput and subscribe to the onChangeText events to read the user input. There are also other events, such as onSubmitEditing and onFocus that can be subscribed to. A simple example:

    +

    The most basic use case is to plop down a TextInput and subscribe to the onChangeText events to read the user input. There are also other events, such as onSubmitEditing and onFocus that can be subscribed to. A minimal example:

    TypeRequired

    defaultValue

    -

    Provides an initial value that will change when the user starts typing. Useful for simple use-cases where you do not want to deal with listening to events and updating the value prop to keep the controlled state in sync.

    +

    Provides an initial value that will change when the user starts typing. Useful for use-cases where you do not want to deal with listening to events and updating the value prop to keep the controlled state in sync.

    @@ -892,7 +892,7 @@ export default function UselessTextInputMultiline() {
    TypeRequired

    value

    -

    The value to show for the text input. TextInput is a controlled component, which means the native value will be forced to match this value prop if provided. For most uses, this works great, but in some cases this may cause flickering - one common cause is preventing edits by keeping value the same. In addition to simply setting the same value, either set editable={false}, or set/update maxLength to prevent unwanted edits without flicker.

    +

    The value to show for the text input. TextInput is a controlled component, which means the native value will be forced to match this value prop if provided. For most uses, this works great, but in some cases this may cause flickering - one common cause is preventing edits by keeping value the same. In addition to setting the same value, either set editable={false}, or set/update maxLength to prevent unwanted edits without flicker.

    diff --git a/docs/0.60/textinput/index.html b/docs/0.60/textinput/index.html index 1b2bfff7718..3440eb78c20 100644 --- a/docs/0.60/textinput/index.html +++ b/docs/0.60/textinput/index.html @@ -69,7 +69,7 @@ } });
    Edit

    TextInput

    A foundational component for inputting text into the app via a keyboard. Props provide configurability for several features, such as auto-correction, auto-capitalization, placeholder text, and different keyboard types, such as a numeric keypad.

    -

    The simplest use case is to plop down a TextInput and subscribe to the onChangeText events to read the user input. There are also other events, such as onSubmitEditing and onFocus that can be subscribed to. A simple example:

    +

    The most basic use case is to plop down a TextInput and subscribe to the onChangeText events to read the user input. There are also other events, such as onSubmitEditing and onFocus that can be subscribed to. A minimal example:

    TypeRequired

    defaultValue

    -

    Provides an initial value that will change when the user starts typing. Useful for simple use-cases where you do not want to deal with listening to events and updating the value prop to keep the controlled state in sync.

    +

    Provides an initial value that will change when the user starts typing. Useful for use-cases where you do not want to deal with listening to events and updating the value prop to keep the controlled state in sync.

    @@ -892,7 +892,7 @@ export default function UselessTextInputMultiline() {
    TypeRequired

    value

    -

    The value to show for the text input. TextInput is a controlled component, which means the native value will be forced to match this value prop if provided. For most uses, this works great, but in some cases this may cause flickering - one common cause is preventing edits by keeping value the same. In addition to simply setting the same value, either set editable={false}, or set/update maxLength to prevent unwanted edits without flicker.

    +

    The value to show for the text input. TextInput is a controlled component, which means the native value will be forced to match this value prop if provided. For most uses, this works great, but in some cases this may cause flickering - one common cause is preventing edits by keeping value the same. In addition to setting the same value, either set editable={false}, or set/update maxLength to prevent unwanted edits without flicker.

    diff --git a/docs/0.60/touchablewithoutfeedback.html b/docs/0.60/touchablewithoutfeedback.html index 6203f209d72..0081c3220fc 100644 --- a/docs/0.60/touchablewithoutfeedback.html +++ b/docs/0.60/touchablewithoutfeedback.html @@ -97,7 +97,7 @@
    TypeRequired

    accessibilityHint

    -

    An accessibility hint helps users understand what will happen when they perform an action on the accessibility element when that result is not obvious from the accessibility label.

    +

    An accessibility hint helps users understand what will happen when they perform an action on the accessibility element when that result is not clear from the accessibility label.

    diff --git a/docs/0.60/touchablewithoutfeedback/index.html b/docs/0.60/touchablewithoutfeedback/index.html index 6203f209d72..0081c3220fc 100644 --- a/docs/0.60/touchablewithoutfeedback/index.html +++ b/docs/0.60/touchablewithoutfeedback/index.html @@ -97,7 +97,7 @@
    TypeRequired

    accessibilityHint

    -

    An accessibility hint helps users understand what will happen when they perform an action on the accessibility element when that result is not obvious from the accessibility label.

    +

    An accessibility hint helps users understand what will happen when they perform an action on the accessibility element when that result is not clear from the accessibility label.

    diff --git a/docs/0.60/vibration.html b/docs/0.60/vibration.html index 1df52a68499..3f1bb766de8 100644 --- a/docs/0.60/vibration.html +++ b/docs/0.60/vibration.html @@ -72,7 +72,7 @@

    There will be no effect on devices that do not support Vibration, eg. the simulator.

    Note for Android: add <uses-permission android:name="android.permission.VIBRATE"/> to AndroidManifest.xml

    The vibration duration in iOS is not configurable, so there are some differences with Android. In Android, if pattern is a number, it specifies the vibration duration in ms. If pattern is an array, those odd indices are the vibration duration, while the even ones are the separation time.

    -

    In iOS, invoking vibrate(duration) will just ignore the duration and vibrate for a fixed time. While the pattern array is used to define the duration between each vibration. See below example for more.

    +

    In iOS, invoking vibrate(duration) will ignore the duration and vibrate for a fixed time. While the pattern array is used to define the duration between each vibration. See below example for more.

    Repeatable vibration is also supported, the vibration will repeat with defined pattern until cancel() is called.

    Example:

    const DURATION = 10000;
diff --git a/docs/0.60/vibration/index.html b/docs/0.60/vibration/index.html
index 1df52a68499..3f1bb766de8 100644
--- a/docs/0.60/vibration/index.html
+++ b/docs/0.60/vibration/index.html
@@ -72,7 +72,7 @@
 
    There will be no effect on devices that do not support Vibration, eg. the simulator.
    
 
    Note for Android: add <uses-permission android:name="android.permission.VIBRATE"/> to AndroidManifest.xml
    
 
    The vibration duration in iOS is not configurable, so there are some differences with Android. In Android, if pattern is a number, it specifies the vibration duration in ms. If pattern is an array, those odd indices are the vibration duration, while the even ones are the separation time.
    
-
    In iOS, invoking vibrate(duration) will just ignore the duration and vibrate for a fixed time. While the pattern array is used to define the duration between each vibration. See below example for more.
    
+
    In iOS, invoking vibrate(duration) will ignore the duration and vibrate for a fixed time. While the pattern array is used to define the duration between each vibration. See below example for more.
    
 
    Repeatable vibration is also supported, the vibration will repeat with defined pattern until cancel() is called.
    
 
    Example:
    
 
    const DURATION = 10000;
diff --git a/docs/0.60/view.html b/docs/0.60/view.html
index 2486fec3b52..287ef9fa263 100644
--- a/docs/0.60/view.html
+++ b/docs/0.60/view.html
@@ -123,7 +123,7 @@
    TypeRequired

    accessibilityHint

    -

    An accessibility hint helps users understand what will happen when they perform an action on the accessibility element when that result is not obvious from the accessibility label.

    +

    An accessibility hint helps users understand what will happen when they perform an action on the accessibility element when that result is not clear from the accessibility label.

    @@ -375,7 +375,7 @@
    TypeRequired

    removeClippedSubviews

    -

    This is a special performance property exposed by RCTView and is useful for scrolling content when there are many subviews, most of which are offscreen. For this property to be effective, it must be applied to a view that contains many subviews that extend outside its bound. The subviews must also have overflow: hidden, as should the containing view (or one of its superviews).

    +

    This is a reserved performance property exposed by RCTView and is useful for scrolling content when there are many subviews, most of which are offscreen. For this property to be effective, it must be applied to a view that contains many subviews that extend outside its bound. The subviews must also have overflow: hidden, as should the containing view (or one of its superviews).

    @@ -470,7 +470,7 @@

    renderToHardwareTextureAndroid

    Whether this View should render itself (and all of its children) into a single hardware texture on the GPU.

    -

    On Android, this is useful for animations and interactions that only modify opacity, rotation, translation, and/or scale: in those cases, the view doesn't have to be redrawn and display lists don't need to be re-executed. The texture can just be re-used and re-composited with different parameters. The downside is that this can use up limited video memory, so this prop should be set back to false at the end of the interaction/animation.

    +

    On Android, this is useful for animations and interactions that only modify opacity, rotation, translation, and/or scale: in those cases, the view doesn't have to be redrawn and display lists don't need to be re-executed. The texture can be re-used and re-composited with different parameters. The downside is that this can use up limited video memory, so this prop should be set back to false at the end of the interaction/animation.

    TypeRequired
    diff --git a/docs/0.60/view/index.html b/docs/0.60/view/index.html index 2486fec3b52..287ef9fa263 100644 --- a/docs/0.60/view/index.html +++ b/docs/0.60/view/index.html @@ -123,7 +123,7 @@
    TypeRequiredPlatform

    accessibilityHint

    -

    An accessibility hint helps users understand what will happen when they perform an action on the accessibility element when that result is not obvious from the accessibility label.

    +

    An accessibility hint helps users understand what will happen when they perform an action on the accessibility element when that result is not clear from the accessibility label.

    @@ -375,7 +375,7 @@
    TypeRequired

    removeClippedSubviews

    -

    This is a special performance property exposed by RCTView and is useful for scrolling content when there are many subviews, most of which are offscreen. For this property to be effective, it must be applied to a view that contains many subviews that extend outside its bound. The subviews must also have overflow: hidden, as should the containing view (or one of its superviews).

    +

    This is a reserved performance property exposed by RCTView and is useful for scrolling content when there are many subviews, most of which are offscreen. For this property to be effective, it must be applied to a view that contains many subviews that extend outside its bound. The subviews must also have overflow: hidden, as should the containing view (or one of its superviews).

    @@ -470,7 +470,7 @@

    renderToHardwareTextureAndroid

    Whether this View should render itself (and all of its children) into a single hardware texture on the GPU.

    -

    On Android, this is useful for animations and interactions that only modify opacity, rotation, translation, and/or scale: in those cases, the view doesn't have to be redrawn and display lists don't need to be re-executed. The texture can just be re-used and re-composited with different parameters. The downside is that this can use up limited video memory, so this prop should be set back to false at the end of the interaction/animation.

    +

    On Android, this is useful for animations and interactions that only modify opacity, rotation, translation, and/or scale: in those cases, the view doesn't have to be redrawn and display lists don't need to be re-executed. The texture can be re-used and re-composited with different parameters. The downside is that this can use up limited video memory, so this prop should be set back to false at the end of the interaction/animation.

    TypeRequired
    diff --git a/docs/animated.html b/docs/animated.html index 62ba9a379cc..bb7537f3683 100644 --- a/docs/animated.html +++ b/docs/animated.html @@ -1,4 +1,4 @@ -Animated · React Native
    Edit

    Animated

    The Animated library is designed to make animations fluid, powerful, and easy to build and maintain. Animated focuses on declarative relationships between inputs and outputs, with configurable transforms in between, and simple start/stop methods to control time-based animation execution.

    -

    The simplest workflow for creating an animation is to create an Animated.Value, hook it up to one or more style attributes of an animated component, and then drive updates via animations using Animated.timing():

    +
    Edit

    Animated

    The Animated library is designed to make animations fluid, powerful, and painless to build and maintain. Animated focuses on declarative relationships between inputs and outputs, with configurable transforms in between, and start/stop methods to control time-based animation execution.

    +

    The most basic workflow for creating an animation is to create an Animated.Value, hook it up to one or more style attributes of an animated component, and then drive updates via animations using Animated.timing():

    Animated.timing(
   // Animate value over time
   this.state.fadeAnim, // The value to drive
@@ -90,7 +90,7 @@
 
    Animated provides three types of animation types. Each animation type provides a particular animation curve that controls how your values animate from their initial value to the final value:
    
 
 
    In most cases, you will be using timing(). By default, it uses a symmetric easeInOut curve that conveys the gradual acceleration of an object to full speed and concludes by gradually decelerating to a stop.
    
@@ -100,7 +100,7 @@
 
    By using the native driver, we send everything about the animation to native before starting the animation, allowing native code to perform the animation on the UI thread without having to go through the bridge on every frame. Once the animation has started, the JS thread can be blocked without affecting the animation.
    
 
    You can use the native driver by specifying useNativeDriver: true in your animation configuration. See the Animations guide to learn more.
    
 
    Animatable components
    
-
    Only animatable components can be animated. These special components do the magic of binding the animated values to the properties, and do targeted native updates to avoid the cost of the react render and reconciliation process on every frame. They also handle cleanup on unmount so they are safe by default.
    
+
    Only animatable components can be animated. These unique components do the magic of binding the animated values to the properties, and do targeted native updates to avoid the cost of the react render and reconciliation process on every frame. They also handle cleanup on unmount so they are safe by default.
    
 
@@ -121,7 +121,7 @@
 
  • Animated.sequence() starts the animations in order, waiting for each to complete before starting the next.
    • 
 
  • Animated.stagger() starts animations in order and in parallel, but with successive delays.
    • 
 
-
    Animations can also be chained together simply by setting the toValue of one animation to be another Animated.Value. See Tracking dynamic values in the Animations guide.
    
+
    Animations can also be chained together by setting the toValue of one animation to be another Animated.Value. See Tracking dynamic values in the Animations guide.
    
 
    By default, if one animation is stopped or interrupted, then all other animations in the group are also stopped.
    
 
    Combining animated values
    
 
    You can combine two animated values via addition, subtraction, multiplication, division, or modulo to make a new animated value:
    
@@ -189,14 +189,14 @@
 
    Animates a value according to an analytical spring model based on damped harmonic oscillation. Tracks velocity state to create fluid motions as the toValue updates, and can be chained together.
    
 
    Config is an object that may have the following options.
    
 
    Note that you can only define one of bounciness/speed, tension/friction, or stiffness/damping/mass, but not more than one:
    
-
    The friction/tension or bounciness/speed options match the spring model in Facebook Pop, Rebound, and Origami.
    
+
    The friction/tension or bounciness/speed options match the spring model in Facebook Pop, Rebound, and Origami.
    
 
      
 
    • friction: Controls "bounciness"/overshoot. Default 7.
      • 
 
    • tension: Controls speed. Default 40.
      • 
 
    • speed: Controls speed of the animation. Default 12.
      • 
 
    • bounciness: Controls bounciness. Default 8.
      • 
 
    
-
    Specifying stiffness/damping/mass as parameters makes Animated.spring use an analytical spring model based on the motion equations of a damped harmonic oscillator. This behavior is slightly more precise and faithful to the physics behind spring dynamics, and closely mimics the implementation in iOS's CASpringAnimation primitive.
    
+
    Specifying stiffness/damping/mass as parameters makes Animated.spring use an analytical spring model based on the motion equations of a damped harmonic oscillator. This behavior is slightly more precise and faithful to the physics behind spring dynamics, and closely mimics the implementation in iOS's CASpringAnimation.
    
 
      
 
    • stiffness: The spring stiffness coefficient. Default 100.
      • 
 
    • damping: Defines how the spring’s motion should be damped due to the forces of friction. Default 10.
      • 
@@ -297,7 +297,7 @@
 
      forkEvent()
      
 
      static forkEvent(event, listener)
 
      
-
      Advanced imperative API for snooping on animated events that are passed in through props. It permits to add a new javascript listener to an existing AnimatedEvent. If animatedEvent is a simple javascript listener, it will merge the 2 listeners into a single one, and if animatedEvent is null/undefined, it will assign the javascript listener directly. Use values directly where possible.
      
+
      Advanced imperative API for snooping on animated events that are passed in through props. It permits to add a new javascript listener to an existing AnimatedEvent. If animatedEvent is a javascript listener, it will merge the 2 listeners into a single one, and if animatedEvent is null/undefined, it will assign the javascript listener directly. Use values directly where possible.
      
 
      
 
      unforkEvent()
      
 
      static unforkEvent(event, listener)
diff --git a/docs/animated/index.html b/docs/animated/index.html
index 62ba9a379cc..bb7537f3683 100644
--- a/docs/animated/index.html
+++ b/docs/animated/index.html
@@ -1,4 +1,4 @@
-Animated · React Native
    Edit

    Animated

    The Animated library is designed to make animations fluid, powerful, and easy to build and maintain. Animated focuses on declarative relationships between inputs and outputs, with configurable transforms in between, and simple start/stop methods to control time-based animation execution.

    -

    The simplest workflow for creating an animation is to create an Animated.Value, hook it up to one or more style attributes of an animated component, and then drive updates via animations using Animated.timing():

    +
    Edit

    Animated

    The Animated library is designed to make animations fluid, powerful, and painless to build and maintain. Animated focuses on declarative relationships between inputs and outputs, with configurable transforms in between, and start/stop methods to control time-based animation execution.

    +

    The most basic workflow for creating an animation is to create an Animated.Value, hook it up to one or more style attributes of an animated component, and then drive updates via animations using Animated.timing():

    Animated.timing(
   // Animate value over time
   this.state.fadeAnim, // The value to drive
@@ -90,7 +90,7 @@
 
    Animated provides three types of animation types. Each animation type provides a particular animation curve that controls how your values animate from their initial value to the final value:
    
 
 
    In most cases, you will be using timing(). By default, it uses a symmetric easeInOut curve that conveys the gradual acceleration of an object to full speed and concludes by gradually decelerating to a stop.
    
@@ -100,7 +100,7 @@
 
    By using the native driver, we send everything about the animation to native before starting the animation, allowing native code to perform the animation on the UI thread without having to go through the bridge on every frame. Once the animation has started, the JS thread can be blocked without affecting the animation.
    
 
    You can use the native driver by specifying useNativeDriver: true in your animation configuration. See the Animations guide to learn more.
    
 
    Animatable components
    
-
    Only animatable components can be animated. These special components do the magic of binding the animated values to the properties, and do targeted native updates to avoid the cost of the react render and reconciliation process on every frame. They also handle cleanup on unmount so they are safe by default.
    
+
    Only animatable components can be animated. These unique components do the magic of binding the animated values to the properties, and do targeted native updates to avoid the cost of the react render and reconciliation process on every frame. They also handle cleanup on unmount so they are safe by default.
    
 
@@ -121,7 +121,7 @@
 
  • Animated.sequence() starts the animations in order, waiting for each to complete before starting the next.
    • 
 
  • Animated.stagger() starts animations in order and in parallel, but with successive delays.
    • 
 
-
    Animations can also be chained together simply by setting the toValue of one animation to be another Animated.Value. See Tracking dynamic values in the Animations guide.
    
+
    Animations can also be chained together by setting the toValue of one animation to be another Animated.Value. See Tracking dynamic values in the Animations guide.
    
 
    By default, if one animation is stopped or interrupted, then all other animations in the group are also stopped.
    
 
    Combining animated values
    
 
    You can combine two animated values via addition, subtraction, multiplication, division, or modulo to make a new animated value:
    
@@ -189,14 +189,14 @@
 
    Animates a value according to an analytical spring model based on damped harmonic oscillation. Tracks velocity state to create fluid motions as the toValue updates, and can be chained together.
    
 
    Config is an object that may have the following options.
    
 
    Note that you can only define one of bounciness/speed, tension/friction, or stiffness/damping/mass, but not more than one:
    
-
    The friction/tension or bounciness/speed options match the spring model in Facebook Pop, Rebound, and Origami.
    
+
    The friction/tension or bounciness/speed options match the spring model in Facebook Pop, Rebound, and Origami.
    
 
      
 
    • friction: Controls "bounciness"/overshoot. Default 7.
      • 
 
    • tension: Controls speed. Default 40.
      • 
 
    • speed: Controls speed of the animation. Default 12.
      • 
 
    • bounciness: Controls bounciness. Default 8.
      • 
 
    
-
    Specifying stiffness/damping/mass as parameters makes Animated.spring use an analytical spring model based on the motion equations of a damped harmonic oscillator. This behavior is slightly more precise and faithful to the physics behind spring dynamics, and closely mimics the implementation in iOS's CASpringAnimation primitive.
    
+
    Specifying stiffness/damping/mass as parameters makes Animated.spring use an analytical spring model based on the motion equations of a damped harmonic oscillator. This behavior is slightly more precise and faithful to the physics behind spring dynamics, and closely mimics the implementation in iOS's CASpringAnimation.
    
 
      
 
    • stiffness: The spring stiffness coefficient. Default 100.
      • 
 
    • damping: Defines how the spring’s motion should be damped due to the forces of friction. Default 10.
      • 
@@ -297,7 +297,7 @@
 
      forkEvent()
      
 
      static forkEvent(event, listener)
 
      
-
      Advanced imperative API for snooping on animated events that are passed in through props. It permits to add a new javascript listener to an existing AnimatedEvent. If animatedEvent is a simple javascript listener, it will merge the 2 listeners into a single one, and if animatedEvent is null/undefined, it will assign the javascript listener directly. Use values directly where possible.
      
+
      Advanced imperative API for snooping on animated events that are passed in through props. It permits to add a new javascript listener to an existing AnimatedEvent. If animatedEvent is a javascript listener, it will merge the 2 listeners into a single one, and if animatedEvent is null/undefined, it will assign the javascript listener directly. Use values directly where possible.
      
 
      
 
      unforkEvent()
      
 
      static unforkEvent(event, listener)
diff --git a/docs/appstate.html b/docs/appstate.html
index f7c637c1cca..c8a4d77083d 100644
--- a/docs/appstate.html
+++ b/docs/appstate.html
@@ -130,7 +130,7 @@
 
      addEventListener(type, handler);
 
      
 
      Add a handler to AppState changes by listening to the change event type and providing the handler
      
-
      TODO: now that AppState is a subclass of NativeEventEmitter, we could deprecate addEventListener and removeEventListener and just use addListener and listener.remove() directly. That will be a breaking change though, as both the method and event names are different (addListener events are currently required to be globally unique).
      
+
      TODO: now that AppState is a subclass of NativeEventEmitter, we could deprecate addEventListener and removeEventListener and use addListener and listener.remove() directly. That will be a breaking change though, as both the method and event names are different (addListener events are currently required to be globally unique).
      
 
      
 
      removeEventListener()
      
 
      removeEventListener(type, handler);
diff --git a/docs/appstate/index.html b/docs/appstate/index.html
index f7c637c1cca..c8a4d77083d 100644
--- a/docs/appstate/index.html
+++ b/docs/appstate/index.html
@@ -130,7 +130,7 @@
 
      addEventListener(type, handler);
 
      
 
      Add a handler to AppState changes by listening to the change event type and providing the handler
      
-
      TODO: now that AppState is a subclass of NativeEventEmitter, we could deprecate addEventListener and removeEventListener and just use addListener and listener.remove() directly. That will be a breaking change though, as both the method and event names are different (addListener events are currently required to be globally unique).
      
+
      TODO: now that AppState is a subclass of NativeEventEmitter, we could deprecate addEventListener and removeEventListener and use addListener and listener.remove() directly. That will be a breaking change though, as both the method and event names are different (addListener events are currently required to be globally unique).
      
 
      
 
      removeEventListener()
      
 
      removeEventListener(type, handler);
diff --git a/docs/asyncstorage.html b/docs/asyncstorage.html
index 911e0e82d24..8a479812758 100644
--- a/docs/asyncstorage.html
+++ b/docs/asyncstorage.html
@@ -71,10 +71,10 @@
    Edit

    AsyncStorage

    Deprecated. Use react-native-community/react-native-async-storage instead.

    -

    AsyncStorage is a simple, unencrypted, asynchronous, persistent, key-value storage system that is global to the app. It should be used instead of LocalStorage.

    +

    AsyncStorage is an unencrypted, asynchronous, persistent, key-value storage system that is global to the app. It should be used instead of LocalStorage.

    It is recommended that you use an abstraction on top of AsyncStorage instead of AsyncStorage directly for anything more than light usage since it operates globally.

    On iOS, AsyncStorage is backed by native code that stores small values in a serialized dictionary and larger values in separate files. On Android, AsyncStorage will use either RocksDB or SQLite based on what is available.

    -

    The AsyncStorage JavaScript code is a simple facade that provides a clear JavaScript API, real Error objects, and simple non-multi functions. Each method in the API returns a Promise object.

    +

    The AsyncStorage JavaScript code is a facade that provides a clear JavaScript API, real Error objects, and non-multi functions. Each method in the API returns a Promise object.

    Importing the AsyncStorage library:

    import {AsyncStorage} from 'react-native';
    diff --git a/docs/asyncstorage/index.html b/docs/asyncstorage/index.html index 911e0e82d24..8a479812758 100644 --- a/docs/asyncstorage/index.html +++ b/docs/asyncstorage/index.html @@ -71,10 +71,10 @@
    Edit

    AsyncStorage

    Deprecated. Use react-native-community/react-native-async-storage instead.

    -

    AsyncStorage is a simple, unencrypted, asynchronous, persistent, key-value storage system that is global to the app. It should be used instead of LocalStorage.

    +

    AsyncStorage is an unencrypted, asynchronous, persistent, key-value storage system that is global to the app. It should be used instead of LocalStorage.

    It is recommended that you use an abstraction on top of AsyncStorage instead of AsyncStorage directly for anything more than light usage since it operates globally.

    On iOS, AsyncStorage is backed by native code that stores small values in a serialized dictionary and larger values in separate files. On Android, AsyncStorage will use either RocksDB or SQLite based on what is available.

    -

    The AsyncStorage JavaScript code is a simple facade that provides a clear JavaScript API, real Error objects, and simple non-multi functions. Each method in the API returns a Promise object.

    +

    The AsyncStorage JavaScript code is a facade that provides a clear JavaScript API, real Error objects, and non-multi functions. Each method in the API returns a Promise object.

    Importing the AsyncStorage library:

    import {AsyncStorage} from 'react-native';
    diff --git a/docs/communication-android.html b/docs/communication-android.html index cef1035e180..f88b76ae2ad 100644 --- a/docs/communication-android.html +++ b/docs/communication-android.html @@ -15,7 +15,7 @@

    0.61

    Edit

    Communication between native and React Native

    In Integrating with Existing Apps guide and Native UI Components guide we learn how to embed React Native in a native component and vice versa. When we mix native and React Native components, we'll eventually find a need to communicate between these two worlds. Some ways to achieve that have been already mentioned in other guides. This article summarizes available techniques.

    Introduction

    React Native is inspired by React, so the basic idea of the information flow is similar. The flow in React is one-directional. We maintain a hierarchy of components, in which each component depends only on its parent and its own internal state. We do this with properties: data is passed from a parent to its children in a top-down manner. If an ancestor component relies on the state of its descendant, one should pass down a callback to be used by the descendant to update the ancestor.

    -

    The same concept applies to React Native. As long as we are building our application purely within the framework, we can drive our app with properties and callbacks. But, when we mix React Native and native components, we need some special, cross-language mechanisms that would allow us to pass information between them.

    +

    The same concept applies to React Native. As long as we are building our application purely within the framework, we can drive our app with properties and callbacks. But, when we mix React Native and native components, we need some specific, cross-language mechanisms that would allow us to pass information between them.

    Properties

    Properties are the simplest way of cross-component communication. So we need a way to pass properties both from native to React Native, and from React Native to native.

    Passing properties from native to React Native

    @@ -66,7 +66,7 @@ mReactRootView.
    TypeRequiredPlatform

    initialDate

    -

    Provides an initial value that will change when the user starts selecting a date. It is useful for simple use-cases where you do not want to deal with listening to events and updating the date prop to keep the controlled state in sync. The controlled state has known bugs which causes it to go out of sync with native. The initialDate prop is intended to allow you to have native be source of truth.

    +

    Provides an initial value that will change when the user starts selecting a date. It is useful for use-cases where you do not want to deal with listening to events and updating the date prop to keep the controlled state in sync. The controlled state has known bugs which causes it to go out of sync with native. The initialDate prop is intended to allow you to have native be source of truth.

    diff --git a/docs/datepickerios/index.html b/docs/datepickerios/index.html index 4b449d40403..b4a4f1415dd 100644 --- a/docs/datepickerios/index.html +++ b/docs/datepickerios/index.html @@ -223,7 +223,7 @@
    TypeRequired

    initialDate

    -

    Provides an initial value that will change when the user starts selecting a date. It is useful for simple use-cases where you do not want to deal with listening to events and updating the date prop to keep the controlled state in sync. The controlled state has known bugs which causes it to go out of sync with native. The initialDate prop is intended to allow you to have native be source of truth.

    +

    Provides an initial value that will change when the user starts selecting a date. It is useful for use-cases where you do not want to deal with listening to events and updating the date prop to keep the controlled state in sync. The controlled state has known bugs which causes it to go out of sync with native. The initialDate prop is intended to allow you to have native be source of truth.

    diff --git a/docs/dimensions.html b/docs/dimensions.html index 4a92093185d..e859a2d3577 100644 --- a/docs/dimensions.html +++ b/docs/dimensions.html @@ -100,7 +100,7 @@ 
    static set(dims)

    This should only be called from native code by sending the didUpdateDimensions event.

    -

    @param {object} dims Simple string-keyed object of dimensions to set

    +

    @param {object} dims string-keyed object of dimensions to set

    ← DatePickerAndroidEasing →
    Edit

    FlatList

    A performant interface for rendering simple, flat lists, supporting the most handy features:

    +
    Edit

    FlatList

    A performant interface for rendering basic, flat lists, supporting the most handy features:

    • Fully cross-platform.
    • Optional horizontal mode.
      • @@ -315,7 +315,7 @@ const styles = StyleSheet.create({

      data

      -

      For simplicity, data is just a plain array. If you want to use something else, like an immutable list, use the underlying VirtualizedList directly.

      +

      For simplicity, data is a plain array. If you want to use something else, like an immutable list, use the underlying VirtualizedList directly.

    TypeRequired
    @@ -416,7 +416,7 @@ const styles = StyleSheet.create({

    getItemLayout

    (data, index) => {length: number, offset: number, index: number}
    -

    getItemLayout is an optional optimization that allows skipping the measurement of dynamic content if you know the size (height or width) of items ahead of time. getItemLayout is both efficient and easy to use if you have fixed size items, for example:

    +

    getItemLayout is an optional optimization that allows skipping the measurement of dynamic content if you know the size (height or width) of items ahead of time. getItemLayout is efficient if you have fixed size items, for example:

      getItemLayout={(data, index) => (
     {length: ITEM_HEIGHT, offset: ITEM_HEIGHT * index, index}
   )}
diff --git a/docs/flatlist/index.html b/docs/flatlist/index.html
index 6cbb3d7e80c..7928a6dc127 100644
--- a/docs/flatlist/index.html
+++ b/docs/flatlist/index.html
@@ -1,4 +1,4 @@
-FlatList · React Native
    Edit
    FlatList
    A performant interface for rendering simple, flat lists, supporting the most handy features:
    
+        
    Edit
    FlatList
    A performant interface for rendering basic, flat lists, supporting the most handy features:
    
 
      
 
    • Fully cross-platform.
      • 
 
    • Optional horizontal mode.
      • 
@@ -315,7 +315,7 @@ const styles = StyleSheet.create({

    data

    -

    For simplicity, data is just a plain array. If you want to use something else, like an immutable list, use the underlying VirtualizedList directly.

    +

    For simplicity, data is a plain array. If you want to use something else, like an immutable list, use the underlying VirtualizedList directly.

    TypeRequired
    @@ -416,7 +416,7 @@ const styles = StyleSheet.create({

    getItemLayout

    (data, index) => {length: number, offset: number, index: number}
    -

    getItemLayout is an optional optimization that allows skipping the measurement of dynamic content if you know the size (height or width) of items ahead of time. getItemLayout is both efficient and easy to use if you have fixed size items, for example:

    +

    getItemLayout is an optional optimization that allows skipping the measurement of dynamic content if you know the size (height or width) of items ahead of time. getItemLayout is efficient if you have fixed size items, for example:

      getItemLayout={(data, index) => (
     {length: ITEM_HEIGHT, offset: ITEM_HEIGHT * index, index}
   )}
diff --git a/docs/hermes.html b/docs/hermes.html
index 0e6ea1c9c1e..8fffb8ace7a 100644
--- a/docs/hermes.html
+++ b/docs/hermes.html
@@ -71,7 +71,7 @@
         
    Edit
    Using Hermes
    
 
 
    
-
    Hermes is an open-source JavaScript engine optimized for running React Native apps on Android. For many apps, simply enabling Hermes will result in improved start-up time, decreased memory usage, and smaller app size. At this time Hermes is an opt-in React Native feature, and this guide explains how to enable it.
    
+
    Hermes is an open-source JavaScript engine optimized for running React Native apps on Android. For many apps, enabling Hermes will result in improved start-up time, decreased memory usage, and smaller app size. At this time Hermes is an opt-in React Native feature, and this guide explains how to enable it.
    
 
    First, ensure you're using at least version 0.60.4 of React Native.
    
 
    If you have an existing app based on an earlier version of React Native, you will have to upgrade it first. See Upgrading to new React Native Versions for how to do this. Make especially sure that all changes to android/app/build.gradle have been applied, as detailed by the React Native upgrade helper. After upgrading the app, make sure everything works before trying to switch to Hermes.
    
 
    
@@ -95,7 +95,7 @@
 
    $ react-native run-android
 
    
 
    Confirming Hermes is in use
    
-
    If you've just created a new app from scratch you should see if Hermes is enabled in the welcome view:
    
+
    If you've recently created a new app from scratch you should see if Hermes is enabled in the welcome view:
    
 
    Where to find JS engine status in AwesomeProject
    
 
    A HermesInternal global variable will be available in JavaScript that can be used to verify that Hermes is in use:
    
 
    const isHermes = () => global.HermesInternal != null;
diff --git a/docs/hermes/index.html b/docs/hermes/index.html
index 0e6ea1c9c1e..8fffb8ace7a 100644
--- a/docs/hermes/index.html
+++ b/docs/hermes/index.html
@@ -71,7 +71,7 @@
         
    Edit
    Using Hermes
    
 
 
    
-
    Hermes is an open-source JavaScript engine optimized for running React Native apps on Android. For many apps, simply enabling Hermes will result in improved start-up time, decreased memory usage, and smaller app size. At this time Hermes is an opt-in React Native feature, and this guide explains how to enable it.
    
+
    Hermes is an open-source JavaScript engine optimized for running React Native apps on Android. For many apps, enabling Hermes will result in improved start-up time, decreased memory usage, and smaller app size. At this time Hermes is an opt-in React Native feature, and this guide explains how to enable it.
    
 
    First, ensure you're using at least version 0.60.4 of React Native.
    
 
    If you have an existing app based on an earlier version of React Native, you will have to upgrade it first. See Upgrading to new React Native Versions for how to do this. Make especially sure that all changes to android/app/build.gradle have been applied, as detailed by the React Native upgrade helper. After upgrading the app, make sure everything works before trying to switch to Hermes.
    
 
    
@@ -95,7 +95,7 @@
 
    $ react-native run-android
 
    
 
    Confirming Hermes is in use
    
-
    If you've just created a new app from scratch you should see if Hermes is enabled in the welcome view:
    
+
    If you've recently created a new app from scratch you should see if Hermes is enabled in the welcome view:
    
 
    Where to find JS engine status in AwesomeProject
    
 
    A HermesInternal global variable will be available in JavaScript that can be used to verify that Hermes is in use:
    
 
    const isHermes = () => global.HermesInternal != null;
diff --git a/docs/imagebackground.html b/docs/imagebackground.html
index 13440215367..d481e78b1dc 100644
--- a/docs/imagebackground.html
+++ b/docs/imagebackground.html
@@ -69,7 +69,7 @@
               }
             });
         
    Edit
    ImageBackground
    A common feature request from developers familiar with the web is background-image. To handle this use case, you can use the <ImageBackground> component, which has the same props as <Image>, and add whatever children to it you would like to layer on top of it.
    
-
    You might not want to use <ImageBackground> in some cases, since the implementation is very simple. Refer to <ImageBackground>'s source code for more insight, and create your own custom component when needed.
    
+
    You might not want to use <ImageBackground> in some cases, since the implementation is basic. Refer to <ImageBackground>'s source code for more insight, and create your own custom component when needed.
    
 
    Note that you must specify some width and height style attributes.
    
 
    Example
    
 
    return (
diff --git a/docs/imagebackground/index.html b/docs/imagebackground/index.html
index 13440215367..d481e78b1dc 100644
--- a/docs/imagebackground/index.html
+++ b/docs/imagebackground/index.html
@@ -69,7 +69,7 @@
               }
             });
         
    Edit
    ImageBackground
    A common feature request from developers familiar with the web is background-image. To handle this use case, you can use the <ImageBackground> component, which has the same props as <Image>, and add whatever children to it you would like to layer on top of it.
    
-
    You might not want to use <ImageBackground> in some cases, since the implementation is very simple. Refer to <ImageBackground>'s source code for more insight, and create your own custom component when needed.
    
+
    You might not want to use <ImageBackground> in some cases, since the implementation is basic. Refer to <ImageBackground>'s source code for more insight, and create your own custom component when needed.
    
 
    Note that you must specify some width and height style attributes.
    
 
    Example
    
 
    return (
diff --git a/docs/inputaccessoryview.html b/docs/inputaccessoryview.html
index 5efa8d628ce..7675d6701c2 100644
--- a/docs/inputaccessoryview.html
+++ b/docs/inputaccessoryview.html
@@ -69,7 +69,7 @@
               }
             });
         
    Edit
    InputAccessoryView
    A component which enables customization of the keyboard input accessory view on iOS. The input accessory view is displayed above the keyboard whenever a TextInput has focus. This component can be used to create custom toolbars.
    
-
    To use this component wrap your custom toolbar with the InputAccessoryView component, and set a nativeID. Then, pass that nativeID as the inputAccessoryViewID of whatever TextInput you desire. A simple example:
    
+
    To use this component wrap your custom toolbar with the InputAccessoryView component, and set a nativeID. Then, pass that nativeID as the inputAccessoryViewID of whatever TextInput you desire. A basic example:
    
 
    Edit
    InputAccessoryView
    A component which enables customization of the keyboard input accessory view on iOS. The input accessory view is displayed above the keyboard whenever a TextInput has focus. This component can be used to create custom toolbars.
    
-
    To use this component wrap your custom toolbar with the InputAccessoryView component, and set a nativeID. Then, pass that nativeID as the inputAccessoryViewID of whatever TextInput you desire. A simple example:
    
+
    To use this component wrap your custom toolbar with the InputAccessoryView component, and set a nativeID. Then, pass that nativeID as the inputAccessoryViewID of whatever TextInput you desire. A basic example:
    TypeRequired

    position

    -

    position in React Native is similar to regular CSS, but everything is set to relative by default, so absolute positioning is always just relative to the parent.

    +

    position in React Native is similar to regular CSS, but everything is set to relative by default, so absolute positioning is always relative to the parent.

    If you want to position a child using specific numbers of logical pixels relative to its parent, set the child to have absolute position.

    -

    If you want to position a child relative to something that is not its parent, just don't use styles for that. Use the component tree.

    +

    If you want to position a child relative to something that is not its parent, don't use styles for that. Use the component tree.

    See https://github.com/facebook/yoga for more details on how position differs between React Native and CSS.

    diff --git a/docs/layout-props/index.html b/docs/layout-props/index.html index 4e6e787c25d..10f979c747c 100644 --- a/docs/layout-props/index.html +++ b/docs/layout-props/index.html @@ -611,9 +611,9 @@

    position

    -

    position in React Native is similar to regular CSS, but everything is set to relative by default, so absolute positioning is always just relative to the parent.

    +

    position in React Native is similar to regular CSS, but everything is set to relative by default, so absolute positioning is always relative to the parent.

    If you want to position a child using specific numbers of logical pixels relative to its parent, set the child to have absolute position.

    -

    If you want to position a child relative to something that is not its parent, just don't use styles for that. Use the component tree.

    +

    If you want to position a child relative to something that is not its parent, don't use styles for that. Use the component tree.

    See https://github.com/facebook/yoga for more details on how position differs between React Native and CSS.

    diff --git a/docs/modal.html b/docs/modal.html index 97c6e5a39d2..0bda6d36e15 100644 --- a/docs/modal.html +++ b/docs/modal.html @@ -1,4 +1,4 @@ -Modal · React Native
    Edit

    Modal

    The Modal component is a simple way to present content above an enclosing view.

    +
    Edit

    Modal

    The Modal component is a basic way to present content above an enclosing view.

    Note: If you need more control over how to present modals over the rest of your app, then consider using a top-level Navigator.

    diff --git a/docs/modal/index.html b/docs/modal/index.html index 97c6e5a39d2..0bda6d36e15 100644 --- a/docs/modal/index.html +++ b/docs/modal/index.html @@ -1,4 +1,4 @@ -Modal · React Native
    Edit

    Modal

    The Modal component is a simple way to present content above an enclosing view.

    +
    Edit

    Modal

    The Modal component is a basic way to present content above an enclosing view.

    Note: If you need more control over how to present modals over the rest of your app, then consider using a top-level Navigator.

    diff --git a/docs/out-of-tree-platforms.html b/docs/out-of-tree-platforms.html index 834679dd7a4..c9c10321f9e 100644 --- a/docs/out-of-tree-platforms.html +++ b/docs/out-of-tree-platforms.html @@ -1,4 +1,4 @@ -Out-of-Tree Platforms · React Native
    Edit

    Out-of-Tree Platforms

    React Native is not just for Android and iOS - there are community-supported projects that bring it to other platforms, such as:

    +
    Edit

    Out-of-Tree Platforms

    React Native is not only for Android and iOS - there are community-supported projects that bring it to other platforms, such as:

    • React Native Windows - React Native support for Microsoft's Universal Windows Platform (UWP) and the Windows Presentation Foundation (WPF)
    • React Native DOM - An experimental, comprehensive port of React Native to the web. (Not to be confused with React Native Web, which has different goals)
      • diff --git a/docs/out-of-tree-platforms/index.html b/docs/out-of-tree-platforms/index.html index 834679dd7a4..c9c10321f9e 100644 --- a/docs/out-of-tree-platforms/index.html +++ b/docs/out-of-tree-platforms/index.html @@ -1,4 +1,4 @@ -Out-of-Tree Platforms · React Native
    Edit

    Out-of-Tree Platforms

    React Native is not just for Android and iOS - there are community-supported projects that bring it to other platforms, such as:

    +
    Edit

    Out-of-Tree Platforms

    React Native is not only for Android and iOS - there are community-supported projects that bring it to other platforms, such as:

    • React Native Windows - React Native support for Microsoft's Universal Windows Platform (UWP) and the Windows Presentation Foundation (WPF)
    • React Native DOM - An experimental, comprehensive port of React Native to the web. (Not to be confused with React Native Web, which has different goals)
      • diff --git a/docs/panresponder.html b/docs/panresponder.html index d53eba1c54c..8289aeb0d63 100644 --- a/docs/panresponder.html +++ b/docs/panresponder.html @@ -1,4 +1,4 @@ -PanResponder · React Native
    Edit

    PanResponder

    PanResponder reconciles several touches into a single gesture. It makes single-touch gestures resilient to extra touches, and can be used to recognize simple multi-touch gestures.

    +
    Edit

    PanResponder

    PanResponder reconciles several touches into a single gesture. It makes single-touch gestures resilient to extra touches, and can be used to recognize basic multi-touch gestures.

    By default, PanResponder holds an InteractionManager handle to block long-running JS events from interrupting active gestures.

    It provides a predictable wrapper of the responder handlers provided by the gesture responder system. For each handler, it provides a new gestureState object alongside the native event object:

    onPanResponderMove: (event, gestureState) => {}
@@ -152,7 +152,7 @@
 
    create()
    
 
    static create(config)
 
    
-
    @param {object} config Enhanced versions of all of the responder callbacks that provide not only the typical ResponderSyntheticEvent, but also the PanResponder gesture state. Simply replace the word Responder with PanResponder in each of the typical onResponder* callbacks. For example, the config object would look like:
    
+
    @param {object} config Enhanced versions of all of the responder callbacks that provide not only the typical ResponderSyntheticEvent, but also the PanResponder gesture state, by replacing the word Responder with PanResponder in each of the typical onResponder* callbacks. For example, the config object would look like:
    
 
      
 
    • onMoveShouldSetPanResponder: (e, gestureState) => {...}
      • 
 
    • onMoveShouldSetPanResponderCapture: (e, gestureState) => {...}
      • 
diff --git a/docs/panresponder/index.html b/docs/panresponder/index.html
index d53eba1c54c..8289aeb0d63 100644
--- a/docs/panresponder/index.html
+++ b/docs/panresponder/index.html
@@ -1,4 +1,4 @@
-PanResponder · React Native
    Edit

    PanResponder

    PanResponder reconciles several touches into a single gesture. It makes single-touch gestures resilient to extra touches, and can be used to recognize simple multi-touch gestures.

    +
    Edit

    PanResponder

    PanResponder reconciles several touches into a single gesture. It makes single-touch gestures resilient to extra touches, and can be used to recognize basic multi-touch gestures.

    By default, PanResponder holds an InteractionManager handle to block long-running JS events from interrupting active gestures.

    It provides a predictable wrapper of the responder handlers provided by the gesture responder system. For each handler, it provides a new gestureState object alongside the native event object:

    onPanResponderMove: (event, gestureState) => {}
@@ -152,7 +152,7 @@
 
    create()
    
 
    static create(config)
 
    
-
    @param {object} config Enhanced versions of all of the responder callbacks that provide not only the typical ResponderSyntheticEvent, but also the PanResponder gesture state. Simply replace the word Responder with PanResponder in each of the typical onResponder* callbacks. For example, the config object would look like:
    
+
    @param {object} config Enhanced versions of all of the responder callbacks that provide not only the typical ResponderSyntheticEvent, but also the PanResponder gesture state, by replacing the word Responder with PanResponder in each of the typical onResponder* callbacks. For example, the config object would look like:
    
 
      
 
    • onMoveShouldSetPanResponder: (e, gestureState) => {...}
      • 
 
    • onMoveShouldSetPanResponderCapture: (e, gestureState) => {...}
      • 
diff --git a/docs/safeareaview.html b/docs/safeareaview.html
index c8fabbbaa9c..ab1f856c150 100644
--- a/docs/safeareaview.html
+++ b/docs/safeareaview.html
@@ -69,9 +69,9 @@
               }
             });
    Edit

    SafeAreaView

    The purpose of SafeAreaView is to render content within the safe area boundaries of a device. It is currently only applicable to iOS devices with iOS version 11 or later.

    -

    SafeAreaView renders nested content and automatically applies paddings to reflect the portion of the view that is not covered by navigation bars, tab bars, toolbars, and other ancestor views. Moreover, and most importantly, Safe Area's paddings reflect the physical limitation of the screen, such as rounded corners or camera notches (i.e. the sensor housing area on iPhone X).

    +

    SafeAreaView renders nested content and automatically applies padding to reflect the portion of the view that is not covered by navigation bars, tab bars, toolbars, and other ancestor views. Moreover, and most importantly, Safe Area's paddings reflect the physical limitation of the screen, such as rounded corners or camera notches (i.e. the sensor housing area on iPhone X).

    Usage Example

    -

    Simply wrap your top level view with a SafeAreaView with a flex: 1 style applied to it. You may also want to use a background color that matches your application's design.

    +

    To use, wrap your top level view with a SafeAreaView with a flex: 1 style applied to it. You may also want to use a background color that matches your application's design.

    Edit

    SafeAreaView

    The purpose of SafeAreaView is to render content within the safe area boundaries of a device. It is currently only applicable to iOS devices with iOS version 11 or later.

    -

    SafeAreaView renders nested content and automatically applies paddings to reflect the portion of the view that is not covered by navigation bars, tab bars, toolbars, and other ancestor views. Moreover, and most importantly, Safe Area's paddings reflect the physical limitation of the screen, such as rounded corners or camera notches (i.e. the sensor housing area on iPhone X).

    +

    SafeAreaView renders nested content and automatically applies padding to reflect the portion of the view that is not covered by navigation bars, tab bars, toolbars, and other ancestor views. Moreover, and most importantly, Safe Area's paddings reflect the physical limitation of the screen, such as rounded corners or camera notches (i.e. the sensor housing area on iPhone X).

    Usage Example

    -

    Simply wrap your top level view with a SafeAreaView with a flex: 1 style applied to it. You may also want to use a background color that matches your application's design.

    +

    To use, wrap your top level view with a SafeAreaView with a flex: 1 style applied to it. You may also want to use a background color that matches your application's design.

    Edit

    ScrollView

    Component that wraps platform ScrollView while providing integration with touch locking "responder" system.

    -

    Keep in mind that ScrollViews must have a bounded height in order to work, since they contain unbounded-height children into a bounded container (via a scroll interaction). In order to bound the height of a ScrollView, either set the height of the view directly (discouraged) or make sure all parent views have bounded height. Forgetting to transfer {flex: 1} down the view stack can lead to errors here, which the element inspector makes easy to debug.

    +

    Keep in mind that ScrollViews must have a bounded height in order to work, since they contain unbounded-height children into a bounded container (via a scroll interaction). In order to bound the height of a ScrollView, either set the height of the view directly (discouraged) or make sure all parent views have bounded height. Forgetting to transfer {flex: 1} down the view stack can lead to errors here, which the element inspector makes quick to debug.

    Doesn't yet support other contained responders from blocking this scroll view from becoming the responder.

    <ScrollView> vs <FlatList> - which one to use?

    -

    ScrollView simply renders all its react child components at once. That makes it very easy to understand and use.

    -

    On the other hand, this has a performance downside. Imagine you have a very long list of items you want to display, maybe several screens worth of content. Creating JS components and native views for everything all at once, much of which may not even be shown, will contribute to slow rendering and increased memory usage.

    -

    This is where FlatList comes into play. FlatList renders items lazily, just when they are about to appear, and removes items that scroll way off screen to save memory and processing time.

    +

    ScrollView renders all its react child components at once, but this has a performance downside.

    +

    Imagine you have a very long list of items you want to display, maybe several screens worth of content. Creating JS components and native views for everything all at once, much of which may not even be shown, will contribute to slow rendering and increased memory usage.

    +

    This is where FlatList comes into play. FlatList renders items lazily, when they are about to appear, and removes items that scroll way off screen to save memory and processing time.

    FlatList is also handy if you want to render separators between your items, multiple columns, infinite scroll loading, or any number of other features it supports out of the box.

    Example

    @@ -401,7 +401,7 @@ const styles = StyleSheet.create({

    When set, the scroll view will adjust the scroll position so that the first child that is currently visible and at or beyond minIndexForVisible will not change position. This is useful for lists that are loading content in both directions, e.g. a chat thread, where new messages coming in might otherwise cause the scroll position to jump. A value of 0 is common, but other values such as 1 can be used to skip loading spinners or other content that should not maintain position.

    The optional autoscrollToTopThreshold can be used to make the content automatically scroll to the top after making the adjustment if the user was within the threshold of the top before the adjustment was made. This is also useful for chat-like applications where you want to see new messages scroll into place, but not if the user has scrolled up a ways and it would be disruptive to scroll a bunch.

    Caveat 1: Reordering elements in the scrollview with this enabled will probably cause jumpiness and jank. It can be fixed, but there are currently no plans to do so. For now, don't re-order the content of any ScrollViews or Lists that use this feature.

    -

    Caveat 2: This simply uses contentOffset and frame.origin in native code to compute visibility. Occlusion, transforms, and other complexity won't be taken into account as to whether content is "visible" or not.

    +

    Caveat 2: This uses contentOffset and frame.origin in native code to compute visibility. Occlusion, transforms, and other complexity won't be taken into account as to whether content is "visible" or not.

    diff --git a/docs/scrollview/index.html b/docs/scrollview/index.html index b10eea7d43a..5e7341e0a0e 100644 --- a/docs/scrollview/index.html +++ b/docs/scrollview/index.html @@ -69,12 +69,12 @@ } });
    Edit

    ScrollView

    Component that wraps platform ScrollView while providing integration with touch locking "responder" system.

    -

    Keep in mind that ScrollViews must have a bounded height in order to work, since they contain unbounded-height children into a bounded container (via a scroll interaction). In order to bound the height of a ScrollView, either set the height of the view directly (discouraged) or make sure all parent views have bounded height. Forgetting to transfer {flex: 1} down the view stack can lead to errors here, which the element inspector makes easy to debug.

    +

    Keep in mind that ScrollViews must have a bounded height in order to work, since they contain unbounded-height children into a bounded container (via a scroll interaction). In order to bound the height of a ScrollView, either set the height of the view directly (discouraged) or make sure all parent views have bounded height. Forgetting to transfer {flex: 1} down the view stack can lead to errors here, which the element inspector makes quick to debug.

    Doesn't yet support other contained responders from blocking this scroll view from becoming the responder.

    <ScrollView> vs <FlatList> - which one to use?

    -

    ScrollView simply renders all its react child components at once. That makes it very easy to understand and use.

    -

    On the other hand, this has a performance downside. Imagine you have a very long list of items you want to display, maybe several screens worth of content. Creating JS components and native views for everything all at once, much of which may not even be shown, will contribute to slow rendering and increased memory usage.

    -

    This is where FlatList comes into play. FlatList renders items lazily, just when they are about to appear, and removes items that scroll way off screen to save memory and processing time.

    +

    ScrollView renders all its react child components at once, but this has a performance downside.

    +

    Imagine you have a very long list of items you want to display, maybe several screens worth of content. Creating JS components and native views for everything all at once, much of which may not even be shown, will contribute to slow rendering and increased memory usage.

    +

    This is where FlatList comes into play. FlatList renders items lazily, when they are about to appear, and removes items that scroll way off screen to save memory and processing time.

    FlatList is also handy if you want to render separators between your items, multiple columns, infinite scroll loading, or any number of other features it supports out of the box.

    Example

    TypeRequiredPlatform
    @@ -401,7 +401,7 @@ const styles = StyleSheet.create({

    When set, the scroll view will adjust the scroll position so that the first child that is currently visible and at or beyond minIndexForVisible will not change position. This is useful for lists that are loading content in both directions, e.g. a chat thread, where new messages coming in might otherwise cause the scroll position to jump. A value of 0 is common, but other values such as 1 can be used to skip loading spinners or other content that should not maintain position.

    The optional autoscrollToTopThreshold can be used to make the content automatically scroll to the top after making the adjustment if the user was within the threshold of the top before the adjustment was made. This is also useful for chat-like applications where you want to see new messages scroll into place, but not if the user has scrolled up a ways and it would be disruptive to scroll a bunch.

    Caveat 1: Reordering elements in the scrollview with this enabled will probably cause jumpiness and jank. It can be fixed, but there are currently no plans to do so. For now, don't re-order the content of any ScrollViews or Lists that use this feature.

    -

    Caveat 2: This simply uses contentOffset and frame.origin in native code to compute visibility. Occlusion, transforms, and other complexity won't be taken into account as to whether content is "visible" or not.

    +

    Caveat 2: This uses contentOffset and frame.origin in native code to compute visibility. Occlusion, transforms, and other complexity won't be taken into account as to whether content is "visible" or not.

    diff --git a/docs/sectionlist.html b/docs/sectionlist.html index aef8f302383..25c0b74c1df 100644 --- a/docs/sectionlist.html +++ b/docs/sectionlist.html @@ -82,7 +82,6 @@
  • Scroll loading.

    • If you don't need section support and want a simpler interface, use <FlatList>.

    -

    Simple Examples:

    Example

    TypeRequiredPlatform
    diff --git a/docs/statusbar/index.html b/docs/statusbar/index.html index 30692119502..0b669311cbd 100644 --- a/docs/statusbar/index.html +++ b/docs/statusbar/index.html @@ -166,7 +166,7 @@

    popStackEntry()

    static popStackEntry(entry: any)
    -

    Pop a StatusBar entry from the stack.

    +

    Get and remove the last a StatusBar entry from the stack.

    Parameters:

    diff --git a/docs/text.html b/docs/text.html index 7e5208c14c6..35fa4a11982 100644 --- a/docs/text.html +++ b/docs/text.html @@ -157,7 +157,7 @@ 9-17: bold, red

    Containers

    -

    The <Text> element is special relative to layout: everything inside is no longer using the flexbox layout but using text layout. This means that elements inside of a <Text> are no longer rectangles, but wrap when they see the end of the line.

    +

    The <Text> element is unique relative to layout: everything inside is no longer using the flexbox layout but using text layout. This means that elements inside of a <Text> are no longer rectangles, but wrap when they see the end of the line.

    <Text>
   <Text>First part and </Text>
   <Text>second part</Text>
@@ -213,7 +213,7 @@
   <MyAppHeaderText>Text styled as a header</MyAppHeaderText>
 </View>
    -

    Assuming that MyAppText is a component that simply renders out its children into a Text component with styling, then MyAppHeaderText can be defined as follows:

    +

    Assuming that MyAppText is a component that only renders out its children into a Text component with styling, then MyAppHeaderText can be defined as follows:

    class MyAppHeaderText extends Component {
   render() {
     return (
@@ -240,7 +240,7 @@
 
    Reference
    
 
    Props
    
 
    accessibilityHint
    
-
    An accessibility hint helps users understand what will happen when they perform an action on the accessibility element when that result is not obvious from the accessibility label.
    
+
    An accessibility hint helps users understand what will happen when they perform an action on the accessibility element when that result is not clear from the accessibility label.
    diff --git a/docs/text/index.html b/docs/text/index.html index 7e5208c14c6..35fa4a11982 100644 --- a/docs/text/index.html +++ b/docs/text/index.html @@ -157,7 +157,7 @@ 9-17: bold, red

    Containers

    -

    The <Text> element is special relative to layout: everything inside is no longer using the flexbox layout but using text layout. This means that elements inside of a <Text> are no longer rectangles, but wrap when they see the end of the line.

    +

    The <Text> element is unique relative to layout: everything inside is no longer using the flexbox layout but using text layout. This means that elements inside of a <Text> are no longer rectangles, but wrap when they see the end of the line.

    <Text>
   <Text>First part and </Text>
   <Text>second part</Text>
@@ -213,7 +213,7 @@
   <MyAppHeaderText>Text styled as a header</MyAppHeaderText>
 </View>
    -

    Assuming that MyAppText is a component that simply renders out its children into a Text component with styling, then MyAppHeaderText can be defined as follows:

    +

    Assuming that MyAppText is a component that only renders out its children into a Text component with styling, then MyAppHeaderText can be defined as follows:

    class MyAppHeaderText extends Component {
   render() {
     return (
@@ -240,7 +240,7 @@
 
    Reference
    
 
    Props
    
 
    accessibilityHint
    
-
    An accessibility hint helps users understand what will happen when they perform an action on the accessibility element when that result is not obvious from the accessibility label.
    
+
    An accessibility hint helps users understand what will happen when they perform an action on the accessibility element when that result is not clear from the accessibility label.
    TypeRequired
    diff --git a/docs/textinput.html b/docs/textinput.html index 915b9e97acc..d8513fabb44 100644 --- a/docs/textinput.html +++ b/docs/textinput.html @@ -69,7 +69,7 @@ } });
    Edit

    TextInput

    A foundational component for inputting text into the app via a keyboard. Props provide configurability for several features, such as auto-correction, auto-capitalization, placeholder text, and different keyboard types, such as a numeric keypad.

    -

    The simplest use case is to plop down a TextInput and subscribe to the onChangeText events to read the user input. There are also other events, such as onSubmitEditing and onFocus that can be subscribed to. A simple example:

    +

    The most basic use case is to plop down a TextInput and subscribe to the onChangeText events to read the user input. There are also other events, such as onSubmitEditing and onFocus that can be subscribed to. A minimal example:

    TypeRequired

    defaultValue

    -

    Provides an initial value that will change when the user starts typing. Useful for simple use-cases where you do not want to deal with listening to events and updating the value prop to keep the controlled state in sync.

    +

    Provides an initial value that will change when the user starts typing. Useful for use-cases where you do not want to deal with listening to events and updating the value prop to keep the controlled state in sync.

    @@ -892,7 +892,7 @@ export default function UselessTextInputMultiline() {
    TypeRequired

    value

    -

    The value to show for the text input. TextInput is a controlled component, which means the native value will be forced to match this value prop if provided. For most uses, this works great, but in some cases this may cause flickering - one common cause is preventing edits by keeping value the same. In addition to simply setting the same value, either set editable={false}, or set/update maxLength to prevent unwanted edits without flicker.

    +

    The value to show for the text input. TextInput is a controlled component, which means the native value will be forced to match this value prop if provided. For most uses, this works great, but in some cases this may cause flickering - one common cause is preventing edits by keeping value the same. In addition to setting the same value, either set editable={false}, or set/update maxLength to prevent unwanted edits without flicker.

    diff --git a/docs/textinput/index.html b/docs/textinput/index.html index 915b9e97acc..d8513fabb44 100644 --- a/docs/textinput/index.html +++ b/docs/textinput/index.html @@ -69,7 +69,7 @@ } });
    Edit

    TextInput

    A foundational component for inputting text into the app via a keyboard. Props provide configurability for several features, such as auto-correction, auto-capitalization, placeholder text, and different keyboard types, such as a numeric keypad.

    -

    The simplest use case is to plop down a TextInput and subscribe to the onChangeText events to read the user input. There are also other events, such as onSubmitEditing and onFocus that can be subscribed to. A simple example:

    +

    The most basic use case is to plop down a TextInput and subscribe to the onChangeText events to read the user input. There are also other events, such as onSubmitEditing and onFocus that can be subscribed to. A minimal example:

    TypeRequired

    defaultValue

    -

    Provides an initial value that will change when the user starts typing. Useful for simple use-cases where you do not want to deal with listening to events and updating the value prop to keep the controlled state in sync.

    +

    Provides an initial value that will change when the user starts typing. Useful for use-cases where you do not want to deal with listening to events and updating the value prop to keep the controlled state in sync.

    @@ -892,7 +892,7 @@ export default function UselessTextInputMultiline() {
    TypeRequired

    value

    -

    The value to show for the text input. TextInput is a controlled component, which means the native value will be forced to match this value prop if provided. For most uses, this works great, but in some cases this may cause flickering - one common cause is preventing edits by keeping value the same. In addition to simply setting the same value, either set editable={false}, or set/update maxLength to prevent unwanted edits without flicker.

    +

    The value to show for the text input. TextInput is a controlled component, which means the native value will be forced to match this value prop if provided. For most uses, this works great, but in some cases this may cause flickering - one common cause is preventing edits by keeping value the same. In addition to setting the same value, either set editable={false}, or set/update maxLength to prevent unwanted edits without flicker.

    diff --git a/docs/touchablewithoutfeedback.html b/docs/touchablewithoutfeedback.html index 33ba3b8a13d..5038e22082b 100644 --- a/docs/touchablewithoutfeedback.html +++ b/docs/touchablewithoutfeedback.html @@ -97,7 +97,7 @@
    TypeRequired

    accessibilityHint

    -

    An accessibility hint helps users understand what will happen when they perform an action on the accessibility element when that result is not obvious from the accessibility label.

    +

    An accessibility hint helps users understand what will happen when they perform an action on the accessibility element when that result is not clear from the accessibility label.

    diff --git a/docs/touchablewithoutfeedback/index.html b/docs/touchablewithoutfeedback/index.html index 33ba3b8a13d..5038e22082b 100644 --- a/docs/touchablewithoutfeedback/index.html +++ b/docs/touchablewithoutfeedback/index.html @@ -97,7 +97,7 @@
    TypeRequired

    accessibilityHint

    -

    An accessibility hint helps users understand what will happen when they perform an action on the accessibility element when that result is not obvious from the accessibility label.

    +

    An accessibility hint helps users understand what will happen when they perform an action on the accessibility element when that result is not clear from the accessibility label.

    diff --git a/docs/vibration.html b/docs/vibration.html index 413a4a070c7..48d945f28f3 100644 --- a/docs/vibration.html +++ b/docs/vibration.html @@ -72,7 +72,7 @@

    There will be no effect on devices that do not support Vibration, eg. the simulator.

    Note for Android: add <uses-permission android:name="android.permission.VIBRATE"/> to AndroidManifest.xml

    The vibration duration in iOS is not configurable, so there are some differences with Android. In Android, if pattern is a number, it specifies the vibration duration in ms. If pattern is an array, those odd indices are the vibration duration, while the even ones are the separation time.

    -

    In iOS, invoking vibrate(duration) will just ignore the duration and vibrate for a fixed time. While the pattern array is used to define the duration between each vibration. See below example for more.

    +

    In iOS, invoking vibrate(duration) will ignore the duration and vibrate for a fixed time. While the pattern array is used to define the duration between each vibration. See below example for more.

    Repeatable vibration is also supported, the vibration will repeat with defined pattern until cancel() is called.

    Example:

    const DURATION = 10000;
diff --git a/docs/vibration/index.html b/docs/vibration/index.html
index 413a4a070c7..48d945f28f3 100644
--- a/docs/vibration/index.html
+++ b/docs/vibration/index.html
@@ -72,7 +72,7 @@
 
    There will be no effect on devices that do not support Vibration, eg. the simulator.
    
 
    Note for Android: add <uses-permission android:name="android.permission.VIBRATE"/> to AndroidManifest.xml
    
 
    The vibration duration in iOS is not configurable, so there are some differences with Android. In Android, if pattern is a number, it specifies the vibration duration in ms. If pattern is an array, those odd indices are the vibration duration, while the even ones are the separation time.
    
-
    In iOS, invoking vibrate(duration) will just ignore the duration and vibrate for a fixed time. While the pattern array is used to define the duration between each vibration. See below example for more.
    
+
    In iOS, invoking vibrate(duration) will ignore the duration and vibrate for a fixed time. While the pattern array is used to define the duration between each vibration. See below example for more.
    
 
    Repeatable vibration is also supported, the vibration will repeat with defined pattern until cancel() is called.
    
 
    Example:
    
 
    const DURATION = 10000;
diff --git a/docs/view.html b/docs/view.html
index 3a2e8bd7f7b..bec19f590ec 100644
--- a/docs/view.html
+++ b/docs/view.html
@@ -123,7 +123,7 @@
    TypeRequired

    accessibilityHint

    -

    An accessibility hint helps users understand what will happen when they perform an action on the accessibility element when that result is not obvious from the accessibility label.

    +

    An accessibility hint helps users understand what will happen when they perform an action on the accessibility element when that result is not clear from the accessibility label.

    @@ -375,7 +375,7 @@
    TypeRequired

    removeClippedSubviews

    -

    This is a special performance property exposed by RCTView and is useful for scrolling content when there are many subviews, most of which are offscreen. For this property to be effective, it must be applied to a view that contains many subviews that extend outside its bound. The subviews must also have overflow: hidden, as should the containing view (or one of its superviews).

    +

    This is a reserved performance property exposed by RCTView and is useful for scrolling content when there are many subviews, most of which are offscreen. For this property to be effective, it must be applied to a view that contains many subviews that extend outside its bound. The subviews must also have overflow: hidden, as should the containing view (or one of its superviews).

    @@ -470,7 +470,7 @@

    renderToHardwareTextureAndroid

    Whether this View should render itself (and all of its children) into a single hardware texture on the GPU.

    -

    On Android, this is useful for animations and interactions that only modify opacity, rotation, translation, and/or scale: in those cases, the view doesn't have to be redrawn and display lists don't need to be re-executed. The texture can just be re-used and re-composited with different parameters. The downside is that this can use up limited video memory, so this prop should be set back to false at the end of the interaction/animation.

    +

    On Android, this is useful for animations and interactions that only modify opacity, rotation, translation, and/or scale: in those cases, the view doesn't have to be redrawn and display lists don't need to be re-executed. The texture can be re-used and re-composited with different parameters. The downside is that this can use up limited video memory, so this prop should be set back to false at the end of the interaction/animation.

    TypeRequired
    diff --git a/docs/view/index.html b/docs/view/index.html index 3a2e8bd7f7b..bec19f590ec 100644 --- a/docs/view/index.html +++ b/docs/view/index.html @@ -123,7 +123,7 @@
    TypeRequiredPlatform

    accessibilityHint

    -

    An accessibility hint helps users understand what will happen when they perform an action on the accessibility element when that result is not obvious from the accessibility label.

    +

    An accessibility hint helps users understand what will happen when they perform an action on the accessibility element when that result is not clear from the accessibility label.

    @@ -375,7 +375,7 @@
    TypeRequired

    removeClippedSubviews

    -

    This is a special performance property exposed by RCTView and is useful for scrolling content when there are many subviews, most of which are offscreen. For this property to be effective, it must be applied to a view that contains many subviews that extend outside its bound. The subviews must also have overflow: hidden, as should the containing view (or one of its superviews).

    +

    This is a reserved performance property exposed by RCTView and is useful for scrolling content when there are many subviews, most of which are offscreen. For this property to be effective, it must be applied to a view that contains many subviews that extend outside its bound. The subviews must also have overflow: hidden, as should the containing view (or one of its superviews).

    @@ -470,7 +470,7 @@

    renderToHardwareTextureAndroid

    Whether this View should render itself (and all of its children) into a single hardware texture on the GPU.

    -

    On Android, this is useful for animations and interactions that only modify opacity, rotation, translation, and/or scale: in those cases, the view doesn't have to be redrawn and display lists don't need to be re-executed. The texture can just be re-used and re-composited with different parameters. The downside is that this can use up limited video memory, so this prop should be set back to false at the end of the interaction/animation.

    +

    On Android, this is useful for animations and interactions that only modify opacity, rotation, translation, and/or scale: in those cases, the view doesn't have to be redrawn and display lists don't need to be re-executed. The texture can be re-used and re-composited with different parameters. The downside is that this can use up limited video memory, so this prop should be set back to false at the end of the interaction/animation.

    TypeRequired
    TypeRequiredPlatform