prop-types-extra

WebJar for prop-types-extra

License

License

MIT
GroupId

GroupId

org.webjars.npm
ArtifactId

ArtifactId

prop-types-extra
Last Version

Last Version

1.1.1
Release Date

Release Date

Type

Type

jar
Description

Description

prop-types-extra
WebJar for prop-types-extra
Project URL

Project URL

https://www.webjars.org
Source Code Management

Source Code Management

https://github.com/react-bootstrap/prop-types-extra

Download prop-types-extra

How to add to project

<!-- https://jarcasting.com/artifacts/org.webjars.npm/prop-types-extra/ -->
<dependency>
    <groupId>org.webjars.npm</groupId>
    <artifactId>prop-types-extra</artifactId>
    <version>1.1.1</version>
</dependency>
// https://jarcasting.com/artifacts/org.webjars.npm/prop-types-extra/
implementation 'org.webjars.npm:prop-types-extra:1.1.1'
// https://jarcasting.com/artifacts/org.webjars.npm/prop-types-extra/
implementation ("org.webjars.npm:prop-types-extra:1.1.1")
'org.webjars.npm:prop-types-extra:jar:1.1.1'
<dependency org="org.webjars.npm" name="prop-types-extra" rev="1.1.1">
  <artifact name="prop-types-extra" type="jar" />
</dependency>
@Grapes(
@Grab(group='org.webjars.npm', module='prop-types-extra', version='1.1.1')
)
libraryDependencies += "org.webjars.npm" % "prop-types-extra" % "1.1.1"
[org.webjars.npm/prop-types-extra "1.1.1"]

Dependencies

compile (2)

Group / Artifact Type Version
org.webjars.npm : react-is jar [16.3.2,17)
org.webjars.npm : warning jar [4.0.0,5)

Project Modules

There are no modules declared in this project.

prop-types-extra GitHub Actions npm

Additional PropTypes for React.

Usage

import elementType from 'prop-types-extra/lib/elementType';
// or
import { elementType } from 'prop-types-extra';

const propTypes = {
  someProp: elementType,
};

If you want to minimize bundle size, import only the validators you use via:

import elementType from 'prop-types-extra/lib/elementType'

Guide

Installation

$ npm i -S react
$ npm i -S prop-types-extra

all(...validators)

This validator checks that all of the provided validators pass.

const propTypes = {
  vertical:  PropTypes.bool.isRequired,

  block: all(
    PropTypes.bool.isRequired,
    ({ block, vertical }) => (
      block && !vertical ?
        new Error('`block` requires `vertical` to be set to have any effect') :
        null
    ),
  ),
};

The provided validators will be validated in order, stopping on the first failure. The combined validator will succeed only if all provided validators succeed.

As in the example, this can be used to make a type assertion along with additional semantic assertions.

componentOrElement

Checks that the value is a ReactComponent or a DOMElement.

const propTypes = {
  container: componentOrElement,
  requiredContainer: componentOrElement.isRequired,
};

This ensures that the value is of the right type to pass to ReactDOM.findDOMNode(), for cases where you need a DOM node.

deprecated(validator, reason)

This validator will log a deprecation warning if the value is present.

const propTypes = {
  collapsable: deprecated(PropTypes.bool, 'Use `collapsible` instead.'),
};

If the collapsable prop above is specified, this validator will log the warning:

The prop `collapsable` of `MyComponent` is deprecated. Use `collapsible` instead.

This validator warns instead of failing on invalid values, and will still call the underlying validator if the deprecated value is present.

This validator will only warn once on each deprecation. To clear the cache of warned messages, such as for clearing state between test cases intended to fail on deprecation warnings, call deprecated._resetWarned().

elementType

Checks that the value is a React element type. This can be either a string (for DOM elements) or a ReactClass (for composite components).

const propTypes = {
  Component: elementType.isRequired,
};

This ensures that the value of is the right type for creating a ReactElement, such as with <Component {...props} />.

isRequiredForA11y(validator)

This validator checks that the value required for accessibility are present.

const propTypes = {
  id: isRequiredForA11y(PropTypes.string),
};

If the id prop above is not specified, the validator will fail with:

The prop `id` is required to make `MyComponent` accessible for users of assistive technologies such as screen readers.

org.webjars.npm

react-bootstrap

The popular front-end framework, rebuilt with React

Versions

Version
1.1.1
1.1.0
1.0.1
1.0.0