2.52.0 • Published 10 months ago

@carbon/ibm-products v2.52.0

Weekly downloads
-
License
Apache-2.0
Repository
github
Last release
10 months ago

@carbon/ibm-products

Carbon for IBM Products is an open source implementation of the closed source pattern asset library (PAL). These PAL designs build on the foundation of IBM’s open source Carbon Design System and React implementation to offer components and patterns beyond the typical component library. Carbon for IBM Products was previously known as Carbon for IBM Cloud and Cognitive (@carbon/ibm-cloud-cognitive), and this name can still be encountered in various places and historical logs.

All Contributors Licensed under the Apache License, Version 2.0 Build status Netlify status GitHub Lerna version PRs welcome

Carbon for IBM Products common UI components

🚀 Getting started

If you’re just getting started and looking to browse our React components, take a look at our Storybook.

📦 Installing Carbon for IBM Products

To use Carbon for IBM Products components, all you need to do is install the @carbon/ibm-products package.

$ yarn add @carbon/ibm-products

# or

$ npm install @carbon/ibm-products

Then you can import the component styles in your index.js.

import '@carbon/ibm-products/css/index.min.css';

Webpack 4

Our package requires support for ES modules (see #2378). In Webpack 5, these are supported by default. In Webpack 4, you will need to add the following rule to your config.

rules: [
  {
    test: /\.mjs$/,
    include: /node_modules/,
    type: 'javascript/auto',
  },
],

Peer dependencies

@carbon/ibm-products is built on top of Carbon components and has a number of dependencies which need to be installed.

Note: @carbon/elements rolls up a number of Carbon packages that could be installed independently. As this list of dependencies could change, we leave you to view package.json in ibm-products if you wish to install individual packages.

Examples

Online examples

Examples for each released component, and some that are still not quite ready, can be found here on

CodeSandbox Stackblitz

Packages

You can find example projects using the components in the examples folder.

Usage

To start using the components

import { AboutModal } from '@carbon/ibm-products';

const App = () => {
  return <AboutModal />;
};

Package prefix

The @carbon/ibm-products package uses a default prefix of c4p for CSS selectors and some IDs.

Changing the prefix

Before any @carbon/ibm-products components are loaded in script or styling ensure you have done the following.

import { pkg } from '@carbon/ibm-products/es/settings';

pkg.prefix = 'tst';

When using multiple components from the library:

@use '@carbon/ibm-products/scss' with (
  $pkg-prefix: 'tst'
);

When using individual components e.g. AboutModal:

@use '@carbon/ibm-products/scss/config' with (
  $pkg-prefix: 'tst'
);

@use '@carbon/ibm-products/scss/components/AboutModal';

See the example gallery for the most up-to-date prefix examples.

Enabling Canary components and flagged features

Components that have not yet completed the release review process are considered to be canary and require the consumer to enable via a feature flag in a config.js file.

For example, create a config.js in your src directory:

import { pkg } from '@carbon/ibm-products';

// Enable 'canary' (not yet reviewed/released) components
// that we want to make use of
pkg.component.AboutModal = true;
pkg.component.SidePanel = true;

// Live dangerously: enable all components!
pkg.setAllComponents(true);

// Enable a feature flagged examples
pkg.feature.nameOfFeature = true;
pkg.feature['Component.feature'] = true;

// Live dangerously: enable all pre-release features!
pkg.setAllFeatures(true);

The default values for component and feature flag settings can be found by running the following command.

node node_modules/@carbon/ibm-products/flags.js

Note: The above settings must happen before a component first renders or a feature is first used.

Note: 2 In the case of features implemented via hooks the feature may function without enabling. In all cases features that disabled by default will log in the console a warning if enabled via a feature flag or an error if not.

Building and running locally

To get started, run the following commands and Storybook will be built and then served on port 3000 on your local machine.

yarn install
yarn storybook

To build all the packages, run the following command.

yarn build

Browser support

This library supports the latest versions of:

  • Apple Safari
  • Google Chrome
  • Microsoft Edge
  • Mozilla Firefox

🙌 Contributing

This project is made possible by several community members who have invested their precious time to give back to the Carbon community. It will continue to be possible by having those that benefit from the package contribute back to it.

So, do not be shy. We both depend on and appreciate contributors, new and old, who help us fix bugs, build new features, improve our documentation, etc.

If you’re interested, definitely check out our Contributing Guide and Carbon’s Developer Handbook! 👀

IBM Telemetry

This package uses IBM Telemetry to collect metrics data. By installing this package as a dependency you are agreeing to telemetry collection. To opt out, see Opting out of IBM Telemetry data collection. For more information on the data being collected, please see the IBM Telemetry documentation.

📝 License

Licensed under the Apache-2.0 License.

This site is powered by Netlify

2.43.2-canary.321

10 months ago

2.43.2-canary.317

10 months ago

2.43.2-canary.319

10 months ago

2.43.2-canary.318

10 months ago

2.53.0-rc.0

10 months ago

2.43.2-canary.308

10 months ago

2.43.2-canary.307

10 months ago

2.52.0

10 months ago

2.43.2-canary.306

10 months ago

2.43.2-canary.305

10 months ago

2.43.2-canary.302

10 months ago

2.43.2-canary.304

10 months ago

2.43.2-canary.303

10 months ago

2.43.2-canary.300

11 months ago

2.43.2-canary.301

10 months ago

1.73.6

11 months ago

2.43.2-canary.298

11 months ago

2.43.2-canary.299

11 months ago

1.73.5

11 months ago

1.73.4

11 months ago

2.43.2-canary.290

11 months ago

2.43.2-canary.292

11 months ago

2.43.2-canary.293

11 months ago

2.43.2-canary.295

11 months ago

2.43.2-canary.297

11 months ago

2.43.2-canary.288

11 months ago

1.73.3

11 months ago

2.52.0-rc.0

11 months ago

2.43.2-canary.282

11 months ago

2.43.2-canary.286

11 months ago

1.73.2

11 months ago

2.43.2-canary.255

11 months ago

2.43.2-canary.257

11 months ago

2.43.2-canary.261

11 months ago

2.43.2-canary.260

11 months ago

2.43.2-canary.262

11 months ago

2.43.2-canary.265

11 months ago

2.43.2-canary.264

11 months ago

2.43.2-canary.267

11 months ago

2.43.2-canary.266

11 months ago

2.43.2-canary.269

11 months ago

2.43.2-canary.268

11 months ago

2.51.0

11 months ago

2.50.0

11 months ago

2.43.2-canary.270

11 months ago

2.43.2-canary.271

11 months ago

2.43.2-canary.278

11 months ago

2.43.2-canary.281

11 months ago

2.51.0-rc.0

11 months ago

2.43.2-canary.252

11 months ago

2.43.2-canary.251

11 months ago

2.43.2-canary.254

11 months ago

2.43.2-canary.253

11 months ago

2.43.2-canary.243

11 months ago

2.43.2-canary.244

11 months ago

2.43.2-canary.247

11 months ago

2.43.2-canary.246

11 months ago

2.43.2-canary.249

11 months ago

2.43.2-canary.248

11 months ago

2.50.0-rc.1

12 months ago

2.50.0-rc.0

12 months ago

2.43.2-canary.230

12 months ago

2.43.2-canary.234

12 months ago

2.43.2-canary.233

12 months ago

2.43.2-canary.235

12 months ago

2.43.2-canary.238

12 months ago

2.43.2-canary.241

11 months ago

2.43.2-canary.240

11 months ago

2.43.2-canary.242

11 months ago

2.43.2-canary.218

12 months ago

2.43.2-canary.217

12 months ago

2.43.2-canary.219

12 months ago

2.43.2-canary.210

12 months ago

2.43.2-canary.212

12 months ago

2.43.2-canary.211

12 months ago

2.43.2-canary.214

12 months ago

2.43.2-canary.213

12 months ago

2.43.2-canary.229

12 months ago

2.43.2-canary.222

12 months ago

2.43.2-canary.226

12 months ago

2.43.2-canary.206

12 months ago

2.43.2-canary.209

12 months ago

2.43.2-canary.208

12 months ago

2.43.2-canary.201

12 months ago

2.43.2-canary.200

12 months ago

2.43.2-canary.203

12 months ago

2.43.2-canary.202

12 months ago

2.43.2-canary.205

12 months ago

2.43.2-canary.191

12 months ago

2.43.2-canary.195

12 months ago

2.43.2-canary.194

12 months ago

2.43.2-canary.197

12 months ago

2.43.2-canary.199

12 months ago

2.43.2-canary.198

12 months ago

2.43.2-canary.189

12 months ago

2.49.0-rc.0

12 months ago

2.49.1

12 months ago

2.49.0

12 months ago

2.48.0

1 year ago

2.49.1-rc.0

12 months ago

2.46.0

1 year ago

2.45.0-rc.1

1 year ago

2.45.0-rc.0

1 year ago

2.41.1-canary.0

1 year ago

2.45.0

1 year ago

2.41.1-canary.9

1 year ago

2.41.1-canary.5

1 year ago

2.41.1-canary.8

1 year ago

2.44.0

1 year ago

2.43.0

1 year ago

2.43.1

1 year ago

2.42.0

1 year ago

1.73.1

1 year ago

2.42.1-canary.8

1 year ago

2.42.1-canary.7

1 year ago

2.42.1-canary.0

1 year ago

2.42.1-canary.4

1 year ago

2.42.1-canary.2

1 year ago

2.42.1-canary.3

1 year ago

2.41.0

1 year ago

2.40.0

1 year ago

2.46.0-rc.0

1 year ago

2.40.1-canary.9

1 year ago

2.40.1-canary.6

1 year ago

2.43.1-canary.0

1 year ago

2.43.1-canary.1

1 year ago

2.43.1-canary.4

1 year ago

2.43.1-canary.3

1 year ago

2.43.1-canary.6

1 year ago

2.43.1-canary.5

1 year ago

2.43.1-canary.8

1 year ago

2.43.1-canary.7

1 year ago

2.48.0-rc.0

1 year ago

2.47.0-rc.0

1 year ago

2.44.0-rc.0

1 year ago

2.44.0-rc.1

1 year ago

2.44.0-rc.2

1 year ago

2.43.2-canary.9

1 year ago

2.43.2-canary.7

1 year ago

2.43.2-canary.4

1 year ago

2.43.2-canary.3

1 year ago

2.43.2-canary.2

1 year ago

2.43.2-canary.1

1 year ago

2.47.0

1 year ago

2.39.0

1 year ago

2.38.0

1 year ago

2.38.0-alpha.5

1 year ago

1.73.0

1 year ago

2.37.0

1 year ago

2.36.0

1 year ago

2.36.0-alpha.27

1 year ago

2.35.0

1 year ago

1.72.3

1 year ago

2.34.0

1 year ago

2.33.0

1 year ago

2.32.0

1 year ago

1.72.2

1 year ago

2.31.1

1 year ago

1.72.1

1 year ago

2.31.0

1 year ago

2.31.0-alpha.5

1 year ago

1.72.0

1 year ago

2.30.0

1 year ago

2.30.0-alpha.11

2 years ago

2.30.0-alpha.9

2 years ago

2.29.0

2 years ago

2.29.0-alpha.10

2 years ago

2.28.1

2 years ago

2.28.0

2 years ago

2.28.0-alpha.4

2 years ago

1.71.0

2 years ago

2.27.0

2 years ago

2.26.0

2 years ago

2.25.0

2 years ago

2.24.0

2 years ago

1.70.0

2 years ago

2.23.0

2 years ago

2.22.0

2 years ago

1.69.0

2 years ago

1.68.0

2 years ago

2.21.0

2 years ago

1.67.0

2 years ago

2.20.0

2 years ago

1.66.0

2 years ago

2.19.2

2 years ago

2.19.1

2 years ago

1.65.0

2 years ago

2.19.0

2 years ago

1.64.0

2 years ago

1.63.0

2 years ago

2.18.1

2 years ago

2.18.0

2 years ago

2.17.2

2 years ago

1.62.1

2 years ago

2.17.0

2 years ago

2.17.1

2 years ago

1.62.0

2 years ago

2.17.0-alpha.8

2 years ago

1.56.0

2 years ago

2.11.0

2 years ago

2.11.1

2 years ago

2.4.1

2 years ago

2.4.0

2 years ago

2.8.1

2 years ago

2.8.0

2 years ago

2.15.2

2 years ago

2.15.0

2 years ago

2.15.1

2 years ago

2.11.2

2 years ago

2.11.3

2 years ago

1.55.0

2 years ago

1.57.0

2 years ago

2.10.1

2 years ago

2.10.2

2 years ago

2.3.2

2 years ago

2.10.0

2 years ago

2.3.1

2 years ago

2.7.0

2 years ago

1.60.0

2 years ago

2.14.0

2 years ago

1.58.0

2 years ago

2.6.1

2 years ago

2.6.0

2 years ago

1.61.1

2 years ago

1.61.0

2 years ago

2.13.0

2 years ago

1.55.2

2 years ago

1.55.1

2 years ago

1.59.0

2 years ago

1.59.1

2 years ago

2.12.0

2 years ago

2.5.0

2 years ago

2.9.0

2 years ago

2.16.0

2 years ago

2.12.1

2 years ago

2.3.0

2 years ago

1.54.2

2 years ago

2.2.0

2 years ago

2.1.2

2 years ago

2.1.1

2 years ago

2.1.3

2 years ago

2.0.1

2 years ago

2.0.0

2 years ago

1.51.0

2 years ago

1.52.0

2 years ago

2.0.0-rc.39

2 years ago

2.0.0-rc.38

2 years ago

2.0.0-rc.35

2 years ago

2.0.0-rc.33

2 years ago

2.0.0-rc.34

2 years ago

2.0.0-rc.31

2 years ago

2.0.0-rc.32

2 years ago

2.0.0-rc.30

2 years ago

2.0.0-rc.28

2 years ago

2.0.0-rc.29

2 years ago

1.53.0

2 years ago

1.53.1

2 years ago

2.1.0

2 years ago

1.54.1

2 years ago

1.48.0

2 years ago

1.49.0

2 years ago

2.0.0-rc.26

2 years ago

2.0.0-rc.27

2 years ago

2.0.0-rc.25

2 years ago

1.50.0

2 years ago

1.46.0

2 years ago

1.46.2

2 years ago

1.46.1

2 years ago

2.0.0-rc.24

2 years ago

2.0.0-rc.22

2 years ago

2.0.0-rc.23

2 years ago

2.0.0-rc.20

2 years ago

2.0.0-rc.21

2 years ago

1.47.0

2 years ago

1.45.0

3 years ago

2.0.0-rc.19

3 years ago

1.44.1

3 years ago

1.44.0

3 years ago

2.0.0-rc.17

3 years ago

2.0.0-rc.18

3 years ago

1.43.0

3 years ago

1.42.0

3 years ago

1.42.1

3 years ago

2.0.0-rc.15

3 years ago

2.0.0-rc.16

3 years ago

2.0.0-rc.13

3 years ago

2.0.0-rc.14

3 years ago

2.0.0-rc.12

3 years ago

1.41.1

3 years ago

1.41.3

3 years ago

1.41.2

3 years ago

1.41.4

3 years ago

1.35.1

3 years ago

1.37.0

3 years ago

1.35.2

3 years ago

1.35.0

3 years ago

1.39.0

3 years ago

1.40.0

3 years ago

1.36.0

3 years ago

2.0.0-rc.4

3 years ago

2.0.0-rc.5

3 years ago

1.34.1

3 years ago

1.38.0

3 years ago

2.0.0-rc.11

3 years ago

2.0.0-rc.10

3 years ago

2.0.0-rc.6

3 years ago

1.41.0

3 years ago

2.0.0-rc.7

3 years ago

2.0.0-rc.8

3 years ago

2.0.0-rc.9

3 years ago

1.32.1

3 years ago

2.0.0-rc.3

3 years ago

1.34.0

3 years ago

1.33.0

3 years ago

1.27.0

3 years ago

1.32.0

3 years ago

2.0.0-rc.2

3 years ago

2.0.0-rc.1

3 years ago

1.31.0

3 years ago

1.18.2

3 years ago

1.21.0

3 years ago

1.25.0

3 years ago

1.25.1

3 years ago

1.23.0

3 years ago

1.23.1

3 years ago

1.19.0

3 years ago

2.0.0-rc.0

3 years ago

1.19.1

3 years ago

1.20.1

3 years ago

1.22.0

3 years ago

1.20.2

3 years ago

1.20.0

3 years ago

1.26.0

3 years ago

1.20.3

3 years ago

1.24.0

3 years ago

1.18.1

3 years ago

1.18.0

3 years ago

1.17.0

3 years ago

1.16.0

3 years ago

1.15.0

3 years ago

1.14.0

3 years ago

1.13.0

3 years ago

1.11.2

3 years ago

1.12.0

3 years ago

1.11.1

3 years ago

1.11.0

3 years ago

1.9.0

4 years ago

1.10.0

3 years ago

1.8.0

4 years ago

1.7.0

4 years ago

1.6.1

4 years ago

1.2.5

4 years ago

1.6.0

4 years ago

1.2.4

4 years ago

1.5.0

4 years ago

1.2.3

4 years ago

1.4.0

4 years ago

1.2.2

4 years ago

1.3.0

4 years ago

1.2.1

4 years ago

1.2.0

4 years ago

1.1.0

4 years ago

1.0.1

4 years ago

1.0.0

4 years ago

1.0.0-rc.2

4 years ago

0.99.1

4 years ago

1.0.0-rc.1

4 years ago

1.0.0-rc.0

4 years ago

0.99.0

4 years ago