@carbon/ibm-products/lib/components/EmptyStates/EmptyStateV2.js

Carbon for IBM Products

/**
 * Copyright IBM Corp. 2020, 2025
 *
 * This source code is licensed under the Apache-2.0 license found in the
 * LICENSE file in the root directory of this source tree.
 */

'use strict';

var _rollupPluginBabelHelpers = require('../../_virtual/_rollupPluginBabelHelpers.js');
var React = require('react');
var index = require('../../_virtual/index.js');
var cx = require('classnames');
var react = require('@carbon/react');
var devtools = require('../../global/js/utils/devtools.js');
require('../../global/js/utils/props-helper.js');
var settings = require('../../settings.js');
var EmptyStateIllustration = require('./EmptyStateIllustration.js');

const blockClass = `${settings.pkg.prefix}--empty-state`;
const componentName = 'EmptyStateV2';
/**
 * This is the V2 version of the `EmptyState` component. To use you must pass the `v2` prop to the V1 version of the component `EmptyState` and use the props below.
 * In order to avoid breaking changes in the future `EmptyStateV2` is not actually directly importable.
 * @deprecated
 */

exports.EmptyStateV2 = /*#__PURE__*/React.forwardRef((props, ref) => {
  const {
    action,
    className,
    illustration: customIllustration,
    illustrationDescription,
    illustrationPosition = 'top',
    illustrationTheme,
    kind,
    link,
    size = 'lg',
    subtitle,
    title,
    ...rest
  } = props;
  const illustrationProps = {
    size,
    theme: illustrationTheme,
    title: illustrationDescription,
    kind
  };
  return /*#__PURE__*/React.createElement("div", _rollupPluginBabelHelpers.extends({}, rest, {
    className: cx([blockClass, className, `${blockClass}-position--${illustrationPosition}`, {
      [`${blockClass}-type--${kind}`]: kind
    }]),
    ref: ref
  }, devtools.getDevtoolsProps(componentName)), customIllustration && /*#__PURE__*/React.createElement("img", {
    src: customIllustration,
    alt: illustrationDescription,
    className: cx([`${blockClass}__illustration`, `${blockClass}__illustration--${size}`])
  }), !customIllustration && kind && /*#__PURE__*/React.createElement(EmptyStateIllustration.default, illustrationProps), /*#__PURE__*/React.createElement("div", {
    className: `${blockClass}__content`
  }, /*#__PURE__*/React.createElement("h3", {
    className: cx(`${blockClass}__header`, {
      [`${blockClass}__header--small`]: size === 'sm'
    })
  }, title), subtitle && /*#__PURE__*/React.createElement("p", {
    className: cx(`${blockClass}__subtitle`, {
      [`${blockClass}__subtitle--small`]: size === 'sm'
    })
  }, subtitle), action && /*#__PURE__*/React.createElement(react.Button, _rollupPluginBabelHelpers.extends({}, action, {
    className: `${blockClass}__action-button`,
    size: "sm"
  }), action.text), link && /*#__PURE__*/React.createElement(react.Link, _rollupPluginBabelHelpers.extends({}, link, {
    className: `${blockClass}__link`
  }), link.text)));
});

/**@ts-ignore*/
exports.EmptyStateV2.deprecated = {
  level: 'warn',
  details: 'For more information, please refer to the Carbon docs https://carbondesignsystem.com/patterns/empty-states-pattern/'
};

// Return a placeholder if not released and not enabled by feature flag
exports.EmptyStateV2 = settings.pkg.checkComponentEnabled(exports.EmptyStateV2, componentName);
exports.EmptyStateV2.propTypes = {
  /**
   * Props for the action button. Refer to the Carbon Components button documentation for full list of props.
   */
  /**@ts-ignore*/
  action: index.default.PropTypes.shape({
    text: index.default.string
  }),
  /**
   * Provide an optional class to be applied to the containing node.
   */
  className: index.default.string,
  /**
   * Source for the illustration image if you choose to use your own custom image. Passing an illustration prop will supersede the kind option.
   */
  illustration: index.default.string,
  /**
   * The alt text for the illustration
   */
  illustrationDescription: index.default.string,
  /**
   * Designates the position of the illustration relative to the content
   */
  illustrationPosition: index.default.oneOf(['top', 'right', 'bottom', 'left']),
  /**
   * Empty state illustration theme variations.
   * To ensure you use the correct themed illustrations, you can conditionally specify light or dark
   * based on your app's current theme value. Example:
   * `illustrationTheme={appTheme === ('carbon--g100' || 'carbon--g90') ? 'dark' : 'light'}`
   */
  illustrationTheme: index.default.oneOf(['light', 'dark']),
  /**
   * Determines which predefined illustration will be displayed
   */
  kind: index.default.oneOf(['error', 'noData', 'noTags', 'notFound', 'notifications', 'unauthorized']),
  /**
   * Props for the link. Refer to the Carbon Components link documentation for full list of props.
   */
  /**@ts-ignore*/
  link: index.default.shape({
    text: index.default.oneOfType([index.default.string, index.default.node])
  }),
  /**
   * Empty state size
   */
  size: index.default.oneOf(['sm', 'lg']),
  /**
   * Empty state subtext
   */
  subtitle: index.default.oneOfType([index.default.string, index.default.node]),
  /**
   * Empty state heading
   */
  title: index.default.oneOfType([index.default.string, index.default.node]).isRequired
};
exports.EmptyStateV2.displayName = componentName;