Package Exports
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 (@plone/components) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
@plone/components
This package contains ReactJS components for use Plone as a headless CMS.
The purpose of this package is to provide a third party design system free and agnostic set of baseline components to build upon.
Components list
- Container
- Input
Demo / Storybook
https://plone-components.netlify.app/
Development
This package follows a style guide (Storybook) driven development. The components are developed in isolation, given their own Storybook stories.
The components are expected to be data-driven-less. So they won't rely internally in any data retrieval facility or utilities. They receive the necessary data as props. In that regard, they should be "dumb" components that only take care of rendering. This should be specially true for the most basic components.
Headless UI component library
This package has the form of a headless UI component library. A headless UI component library provide "white label" components that you later can style with your own styles. It is not tied to any heavy specific styling nor any CSS framework. The vanilla CSS provided allow you to "drop-in" your own CSS framework, build and existing styling into the components.
This post explains extensively its benefits:
react-aria-components
@plone/components is based on Adobe's react-aria-components library. React Aria Components is a library of unstyled components built on top of the React Aria hooks. It provides a simpler way to build accessible components with custom styles, while offering the flexibility to drop down to hooks for even more customizability where needed.
Releases
The release policy for this package follows a quick 1.0.0 release, as opposed to have a excessive long alpha/beta road to 1.0.0. This is because the development of this package is expected to happen during the next years.
PLIP #4352
This package is the result of the execution of the Plone Improvement Proposal #4352.