@carbon/ibm-products/es/components/EditSidePanel/EditSidePanel.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.
 */

import { extends as _extends } from '../../_virtual/_rollupPluginBabelHelpers.js';
import '../../global/js/utils/props-helper.js';
import React__default from 'react';
import { Form } from '@carbon/react';
import PropTypes from '../../_virtual/index.js';
import { SidePanel } from '../SidePanel/SidePanel.js';
import cx from 'classnames';
import { getDevtoolsProps } from '../../global/js/utils/devtools.js';
import { pkg } from '../../settings.js';
import uuidv4 from '../../global/js/utils/uuidv4.js';

// The block part of our conventional BEM class names (blockClass__E--M).
const blockClass = `${pkg.prefix}--edit-side-panel`;
const componentName = 'EditSidePanel';

// NOTE: the component SCSS is not imported here: it is rolled up separately.

/**
 * **This component is deprecated.** <br>
 * Use with medium complexity edits if the user needs page context.
 * @deprecated
 */
let EditSidePanel = /*#__PURE__*/React__default.forwardRef((_ref, ref) => {
  let {
    // The component props, in alphabetical order (for consistency).

    children,
    className,
    disableSubmit,
    id,
    formTitle,
    formDescription,
    onRequestClose,
    onRequestSubmit,
    open,
    placement = 'right',
    primaryButtonText,
    secondaryButtonText,
    selectorPrimaryFocus,
    selectorPageContent,
    size = 'md',
    slideIn,
    subtitle,
    title,
    // Collect any other property values passed in.
    ...rest
  } = _ref;
  const actions = [{
    label: primaryButtonText,
    onClick: event => {
      event.preventDefault();
      onRequestSubmit?.();
    },
    kind: 'primary',
    disabled: disableSubmit,
    type: 'submit'
  }, {
    label: secondaryButtonText,
    onClick: onRequestClose,
    kind: 'secondary'
  }];
  const formTitleId = uuidv4();
  return /*#__PURE__*/React__default.createElement(SidePanel, _extends({}, rest, {
    open,
    ref,
    selectorPageContent,
    onRequestClose,
    title,
    subtitle,
    selectorPrimaryFocus,
    id
  }, getDevtoolsProps(componentName), {
    placement: placement,
    slideIn: slideIn,
    animateTitle: false,
    className: cx(blockClass, className),
    size: size,
    preventCloseOnClickOutside: true,
    actions: actions
  }), formTitle && /*#__PURE__*/React__default.createElement("h3", {
    id: formTitleId,
    className: `${blockClass}__form-title-text ${blockClass}__content-text`
  }, formTitle), formDescription && /*#__PURE__*/React__default.createElement("p", {
    className: `${blockClass}__form-description-text ${blockClass}__content-text`
  }, formDescription), /*#__PURE__*/React__default.createElement(Form, {
    className: `${blockClass}__form`,
    "aria-labelledby": formTitleId
  }, children));
});

/**@ts-ignore*/
EditSidePanel.deprecated = {
  level: 'warn',
  details: `This component is deprecated and will be removed in the next major version.`
};

// Return a placeholder if not released and not enabled by feature flag
EditSidePanel = pkg.checkComponentEnabled(EditSidePanel, componentName);

// The display name of the component, used by React. Note that displayName
// is used in preference to relying on function.name.
EditSidePanel.displayName = componentName;

// The types and DocGen commentary for the component props,
// in alphabetical order (for consistency).
// See https://www.npmjs.com/package/prop-types#usage.
EditSidePanel.propTypes = {
  /**
   * Sets the body content of the create side panel
   */
  /**@ts-ignore*/
  children: PropTypes.oneOfType([PropTypes.arrayOf(PropTypes.node), PropTypes.node]).isRequired,
  /**
   * Provide an optional class to be applied to the containing node.
   */
  className: PropTypes.string,
  /**
   * Specifies a boolean for disabling or enabling the primary button. This is important for form validation
   * Returning `true` prevents the primary button from being clicked until required fields are completed.
   */
  disableSubmit: PropTypes.bool,
  /**
   * Specifies an optional field that provides a additional context for a form
   */
  formDescription: PropTypes.node,
  /**
   * Specifies a required field that provides a title for a form
   */
  formTitle: PropTypes.node.isRequired,
  /**
   * Unique identifier
   */
  id: PropTypes.string,
  /**
   * Specifies an optional handler which is called when the CreateSidePanel
   * is closed.
   */
  onRequestClose: PropTypes.func,
  /**
   * Specifies an optional handler which is called when the CreateSidePanel
   * primary button is pressed.
   */
  onRequestSubmit: PropTypes.func,
  /**
   * Specifies whether the CreateSidePanel is open or not.
   */
  open: PropTypes.bool.isRequired,
  /**
   * Determines if the side panel is on the right or left
   */
  placement: PropTypes.oneOf(['left', 'right']),
  /**
   * Specifies the primary button's text in the modal.
   */
  primaryButtonText: PropTypes.string.isRequired,
  /**
   * Specifies the secondary button's text in the modal.
   */
  secondaryButtonText: PropTypes.string.isRequired,
  /**
   * This is the selector to the element that contains all of the page content that will shrink if the panel is a slide in.
   * This prop is required when using the `slideIn` variant of the side panel.
   */
  /**@ts-ignore*/
  selectorPageContent: PropTypes.string.isRequired.if(_ref2 => {
    let {
      slideIn
    } = _ref2;
    return slideIn;
  }),
  /**
   * Specifies which DOM element in the form should be focused.
   */
  /**@ts-ignore*/
  selectorPrimaryFocus: PropTypes.node.isRequired,
  /**
   * Sets the size of the side panel
   */
  size: PropTypes.oneOf(['xs', 'sm', 'md', 'lg', '2xl']),
  /**
   * Specifies which DOM element in the form should be focused.
   */
  slideIn: PropTypes.bool,
  /**
   *  **Experimental:** Provide a `Slug` component to be rendered inside the `SidePanel` component
   */
  slug: PropTypes.node,
  /**
   * The subtitle of the CreateSidePanel is optional and serves to provide more information about the modal.
   */
  subtitle: PropTypes.node,
  /**
   * The title of the CreateSidePanel is usually the product or service name.
   */
  /**@ts-ignore*/
  title: PropTypes.node.isRequired
};

export { EditSidePanel };