# react-proptype-conditional-require
> Conditionally require a React proptype based on other props and/or other conditions.
Latest version **1.0.4** (published 2016-11-16) · MIT license · 0 weekly downloads
## Install
```sh
npm install react-proptype-conditional-require
pnpm add react-proptype-conditional-require
yarn add react-proptype-conditional-require
bun add react-proptype-conditional-require
```
## Health
**Score 15/100 (F)** — status: abandoned.
Positive: no vulnerabilities.
Warnings: low downloads; no types; no esm support.
Negative: abandoned; low maintenance score.
## Facts
| | |
|---|---|
| Version | 1.0.4 |
| Published | 2016-11-16 |
| First published | 2016-02-04 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 28 |
| Author | Ethan Cohen |
| Maintainers | evcohen |
| Keywords | react, proptypes, require, isRequired, isRequiredIf, conditional, props |
## Links
- npm: https://www.npmjs.com/package/react-proptype-conditional-require
- Repository: https://github.com/evcohen/react-proptype-conditional-require
- Homepage: https://github.com/evcohen/react-proptype-conditional-require#readme
- Issues: https://github.com/evcohen/react-proptype-conditional-require/issues
- npm.io page: https://npm.io/package/react-proptype-conditional-require
## Alternatives
- [mobx-react](https://npm.io/package/mobx-react.md) — 2.8M weekly downloads
- [rc-tree](https://npm.io/package/rc-tree.md) — 2.6M weekly downloads
- [@react-oauth/google](https://npm.io/package/@react-oauth/google.md) — 1.3M weekly downloads
- [@wagmi/connectors](https://npm.io/package/@wagmi/connectors.md) — 877.0K weekly downloads
- [vee-validate](https://npm.io/package/vee-validate.md) — 836.4K weekly downloads
## Recent versions
- 1.0.4 (latest) — 2016-11-16
- 1.0.3 — 2016-11-15
- 1.0.2 — 2016-02-11
- 1.0.1 — 2016-02-11
- 1.0.0 — 2016-02-10
- 0.3.2 — 2016-02-10
- 0.3.1 — 2016-02-10
- 0.3.0 — 2016-02-10
- 0.2.2 — 2016-02-10
- 0.2.1 — 2016-02-10
- 0.2.0 — 2016-02-10
- 0.1.6 — 2016-02-10
- 0.1.3 — 2016-02-04
- 0.1.2 — 2016-02-04
- 0.1.1 — 2016-02-04
- … 1 more at https://npm.io/package/react-proptype-conditional-require/versions
## README
# react-proptype-conditional-require
Conditionally require propTypes based on other props and variables.
# getting started
```
$ npm install --save react-proptype-conditional-require
```
# example
``` js
import React, { PropTypes } from 'react';
import isRequiredIf from 'react-proptype-conditional-require';
const Hello = props => Hello {props.value}!
;
Hello.defaultProps = {
value: 'World'
};
const { string } = PropTypes;
Hello.propTypes = {
value: string
className: isRequiredIf(string, (props, propName, componentName) => props.hasOwnProperty('value'))
};
```
# syntax
This is a function that accepts a propType (a typeValidator function) and a condition in which to enforce this propType for React components. The function uses the signature:
```js
import isRequiredIf from 'react-proptype-conditional-require';
...
Component.propTypes = {
foo: isRequiredIf(typeValidator, conditional[, message])
}
```
# usage
## typeValidator
A function that takes the arguments (props, propName, componentName) and returns an Error object if the validation fails. Do not `console.warn` or `throw`.
- props - An object containing all of the props passed to the instance.
- propName - The current key of the prop object under validation.
- componentName - The class of the React component.
**NOTE: All of the React built-in proptypes use this signature and you will usually use them to specify the typeValidator**:
```js
import React, { PropTypes } from 'react';
import isRequiredIf from 'react-proptype-conditional-require';
const { string, bool } = PropTypes;
...
Component.propTypes = {
first: isRequiredIf(string, true),
second: isRequiredIf(bool, false)
}
...
```
## conditional
A boolean *or* function that returns a truthy value that indicates whether the prop is required or not. The function follows the same signature as the typeValidator function: (props, propName, componentName). It should return a boolean, but any truthy value will do.
A common use case:
```js
import React, { PropTypes } from 'react';
import isRequiredIf from 'react-proptype-conditional-require';
const { string } = PropTypes;
...
Component.propTypes = {
label: string,
labelClassName: isRequiredIf(string, props => props.hasOwnProperty('label'));
}
...
```
In that case, the labelClassName will only be required if label is passed.
## message (optional)
A string that specifies the custom error message that you would like to provide if the prop is required but missing. If not provided, the error message used by React will be default.
```js
import React, { PropTypes } from 'react';
import isRequiredIf from 'react-proptype-conditional-require';
const { string } = PropTypes;
...
Component.LABEL_CLASSNAME_ERROR_MESSAGE = 'You must provide a labelClassName when passing down the label prop';
Component.propTypes = {
label: string,
labelClassName: isRequiredIf(string, props => props.hasOwnProperty('label'), Component.LABEL_CLASSNAME_ERROR_MESSAGE);
}
...
```
The above code snippet would throw the custom error message if the label prop were passed but the labelClassName prop was not.
# license
MIT License.
---
_Source: https://npm.io/package/react-proptype-conditional-require · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._