Files
react.dev/docs/10-addons.md
Daniel Lo Nigro d457201862 Upgrade to Jekyll 3
Full list of changes is at https://jekyllrb.com/docs/upgrading/2-to-3/. The tl;dr of it is:
 - Relative permalinks were removed, so all the files in the `docs` subdirectory need their permalink to be prefixed with `docs/`
 - `post` and `page` types were renamed to `posts` and `pages` respectively
 - `jekyll-paginate`, `pygments` and `redcarpet` are all now optional, so I needed to explicitly add it to the Gemfile. Jekyll now uses `rouge` rather than `pygments` for syntax highlighting, but rouge does not support highlighting individual lines (`hl_lines`) so we need to continue using Pygments.
 - Layout metadata (eg. `sectionid`) is now on a `layout` variable rather than `page`

Tested the following pages and confirmed that they all work:
 - "Docs" link (getting started page): http://127.0.0.1:4000/react/docs/getting-started.html
 - Downloads: http://127.0.0.1:4000/react/downloads.html
 - Tutorial: http://127.0.0.1:4000/react/docs/tutorial.html
 - A few pages under the "docs" subdirectory, to confirm they're working properly:
    - http://127.0.0.1:4000/react/docs/addons.html
 - http://127.0.0.1:4000/react/docs/why-react.html
 - http://127.0.0.1:4000/react/docs/create-fragment.html
 - A few tips:
    - http://127.0.0.1:4000/react/tips/false-in-jsx.html
 - http://127.0.0.1:4000/react/tips/style-props-value-px.html
 - Non-English versions of the page:
    - http://127.0.0.1:4000/react/docs/getting-started-it-IT.html
    - http://127.0.0.1:4000/react/docs/getting-started-ja-JP.html
2016-07-19 12:18:49 -07:00

1.6 KiB

id, title, permalink, prev, next
id title permalink prev next
addons Add-ons docs/addons.html environments.html animation.html

The React add-ons are a collection of useful utility modules for building React apps. These should be considered experimental and tend to change more often than the core.

  • TransitionGroup and CSSTransitionGroup, for dealing with animations and transitions that are usually not simple to implement, such as before a component's removal.
  • LinkedStateMixin, to simplify the coordination between user's form input data and the component's state.
  • cloneWithProps, to make shallow copies of React components and change their props.
  • createFragment, to create a set of externally-keyed children.
  • update, a helper function that makes dealing with immutable data in JavaScript easier.
  • PureRenderMixin, a performance booster under certain situations.
  • shallowCompare, a helper function that performs a shallow comparison for props and state in a component to decide if a component should update.

The add-ons below are in the development (unminified) version of React only:

  • TestUtils, simple helpers for writing test cases.
  • Perf, a performance profiling tool for finding optimization opportunities.

To get the add-ons, install them individually from npm (e.g., npm install react-addons-pure-render-mixin). We don't support using the addons if you're not using npm.