Package Exports
- @wordpress/components
- @wordpress/components/build-module/index.js
- @wordpress/components/build-style/style.css
- @wordpress/components/build/index.js
- @wordpress/components/src/index.js
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@wordpress/components) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
Component Reference
This package includes a library of generic WordPress components to be used for creating common UI elements shared between screens and features of the WordPress dashboard.
Installation
Install the module
npm install @wordpress/components --save
This package assumes that your code will run in an ES2015+ environment. If you're using an environment that has limited or no support for such language features and APIs, you should include the polyfill shipped in @wordpress/babel-preset-default
in your code.
Usage
Within Gutenberg, these components can be accessed by importing from the components
root directory:
/**
* WordPress dependencies
*/
import { Button } from '@wordpress/components';
export default function MyButton() {
return <Button>Click Me!</Button>;
}
Many components include CSS to add style, you will need to add in order to appear correctly. Within WordPress, add the wp-components
stylesheet as a dependency of your plugin's stylesheet. See wp_enqueue_style documentation for how to specify dependencies.
In non-WordPress projects, link to the build-style/style.css
file directly, it is located at node_modules/@wordpress/components/build-style/style.css
.
Docs & examples
You can browse the components docs and examples at https://wordpress.github.io/gutenberg/
Contributing
See CONTRIBUTING.md for the contributing guidelines for the @wordpress/components
package.