amirho/react.dev
1
0
Fork 0
mirror of https://github.com/reactjs/react.dev.git synced 2026-02-24 20:53:08 +00:00
Code Issues Packages Projects Releases Wiki Activity

Updated docs and check for truthiness

Browse Source 
Change api docs to reflect presence of the new argument.  In addition,
callback was change to require only a "truthy" value.
This commit is contained in:
ngavalas
2013-06-14 16:37:20 -07:00
parent 495ba6fd6d
commit ecf97b1a98
1 changed files with 4 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
docs/api.md
View File

@@ -108,15 +108,17 @@ Transfer properties from this component to a target component that have not alre
#### setState
```javascript
setState(object nextState)
setState(object nextState_[, function callback]_)
```
Merges nextState with the current state. This is the primary method you use to trigger UI updates from event handlers and server request callbacks.
Merges nextState with the current state. This is the primary method you use to trigger UI updates from event handlers and server request callbacks. In addition, you can supply an optional callback function that is executed once `setState` is completed.
**Note:** *NEVER* mutate `this.state` directly. As calling `setState()` afterwards may replace the mutation you made. Treat `this.state` as if it were immutable.
**Note:** `setState()` does not immediately mutate `this.state` but creates a pending state transition. Accessing `this.state` after calling this method can potentially return the existing value.
**Note**: There is no guarantee of synchronous operation of calls to `setState` and calls may eventually be batched for performance gains.
#### replaceState
```javascript