diff --git a/_posts/2013-07-11-react-v0-4-prop-validation-and-default-values.md b/_posts/2013-07-11-react-v0-4-prop-validation-and-default-values.md new file mode 100644 index 00000000..b2898fd3 --- /dev/null +++ b/_posts/2013-07-11-react-v0-4-prop-validation-and-default-values.md @@ -0,0 +1,63 @@ +--- +title: "New in React v0.4: Prop Validation and Default Values" +layout: post +author: Paul O'Shannessy +--- + +Many of the questions we got following the public launch of React revolved around `props`, specifically that people wanted to do validation and to make sure their components had sensible defaults. + + +## Validation + +Oftentimes you want to validate your `props` before you use them. Perhaps you want to ensure they are a specific type. Or maybe you want to restrict your prop to specific values. Or maybe you want to make a specific prop required. This was always possible — you could have written validations in your `render` or `componentWillReceiveProps` functions, but that gets clunky fast. + +React v0.4 will provide a nice easy way for you to use built-in validators, or to even write your own. + +```js +React.createClass({ + propTypes: { + // An optional string prop named "description". + description: React.PropTypes.string, + + // A required enum prop named "category". + category: React.PropTypes.oneOf(['News','Photos']).isRequired, + + // A prop named "dialog" that requires an instance of Dialog. + dialog: React.PropTypes.instanceOf(Dialog).isRequired + }, + ... +}); +``` + + +## Default Values + +One common pattern we've seen with our React code is to do something like this: + +```js +React.createClass({ + render: function() { + var value = this.props.value || 'default value'; + return
{value}
; + } +}); +``` + +Do this for a few `props` across a few components and now you have a lot of redundant code. Starting with React v0.4, you can provide default values in a declarative way: + +```js +React.createClass({ + getDefaultProps: function() { + return { + value: 'default value' + }; + } + ... +}); +``` + +We will use the cached result of this function before each `render`. We also perform all validations before each `render` to ensure that you have all of the data you need in the right form before you try to use it. + +- - - + +Both of these features are entirely optional. We've found them to be increasingly valuable at Facebook as our applications grow and evolve, and we hope others find them useful as well.