@carbon/ibm-products
Version:
Carbon for IBM Products
154 lines (152 loc) • 5.57 kB
JavaScript
/**
* Copyright IBM Corp. 2020, 2026
*
* This source code is licensed under the Apache-2.0 license found in the
* LICENSE file in the root directory of this source tree.
*/
const require_runtime = require("../../_virtual/_rolldown/runtime.js");
const require_index = require("../../node_modules/classnames/index.js");
const require_settings = require("../../settings.js");
const require_devtools = require("../../global/js/utils/devtools.js");
const require_uuidv4 = require("../../global/js/utils/uuidv4.js");
const require_SidePanel = require("../SidePanel/SidePanel.js");
let react = require("react");
react = require_runtime.__toESM(react);
let prop_types = require("prop-types");
prop_types = require_runtime.__toESM(prop_types);
let _carbon_react = require("@carbon/react");
//#region src/components/CreateSidePanel/CreateSidePanel.tsx
/**
* Copyright IBM Corp. 2021, 2024
*
* This source code is licensed under the Apache-2.0 license found in the
* LICENSE file in the root directory of this source tree.
*/
var import_classnames = /* @__PURE__ */ require_runtime.__toESM(require_index.default);
const blockClass = `${require_settings.pkg.prefix}--create-side-panel`;
const componentName = "CreateSidePanel";
/**
* Use with medium complexity creations if the user needs page context. On-page content can be seen and interacted with.
*/
const CreateSidePanel = react.default.forwardRef(({ className, children, disableSubmit, formTitle, formDescription, id, onRequestClose, onRequestSubmit, open, primaryButtonText, secondaryButtonText, selectorPageContent, selectorPrimaryFocus, subtitle, title, ...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 = require_uuidv4.default();
return selectorPageContent && /* @__PURE__ */ react.default.createElement(require_SidePanel.SidePanel, {
...rest,
id,
open,
ref,
selectorPageContent,
onRequestClose,
title,
subtitle,
selectorPrimaryFocus,
...require_devtools.getDevtoolsProps(componentName),
placement: "right",
slideIn: true,
animateTitle: false,
className: (0, import_classnames.default)(blockClass, className),
size: "md",
actions
}, /* @__PURE__ */ react.default.createElement("h3", {
className: `${blockClass}__form-title-text ${blockClass}__content-text`,
id: formTitleId
}, formTitle), /* @__PURE__ */ react.default.createElement("p", { className: `${blockClass}__form-description-text ${blockClass}__content-text` }, formDescription), /* @__PURE__ */ react.default.createElement(_carbon_react.Form, {
className: `${blockClass}__form`,
"aria-labelledby": formTitleId,
onSubmit: (e) => e.preventDefault()
}, children));
});
CreateSidePanel.displayName = componentName;
CreateSidePanel.propTypes = {
/**
* Sets the body content of the create side panel
*/
/**@ts-ignore*/
children: prop_types.default.oneOfType([prop_types.default.arrayOf(prop_types.default.node), prop_types.default.node]).isRequired,
/**
* Provide an optional class to be applied to the containing node.
*/
className: prop_types.default.string,
/**
* The description of the CreateSidePanel serves to provide more information about the form within the panel.
*/
description: prop_types.default.node,
/**
* 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: prop_types.default.bool,
/**
* Specifies an optional field that provides a additional context for a form
*/
formDescription: prop_types.default.node,
/**
* Specifies a required field that provides a title for a form
*/
formTitle: prop_types.default.node.isRequired,
/**
* Unique identifier
*/
id: prop_types.default.string,
/**
* Specifies an optional handler which is called when the CreateSidePanel
* is closed.
*/
onRequestClose: prop_types.default.func,
/**
* Specifies an optional handler which is called when the CreateSidePanel
* primary button is pressed.
*/
onRequestSubmit: prop_types.default.func,
/**
* Specifies whether the CreateSidePanel is open or not.
*/
/**@ts-ignore*/
open: prop_types.default.bool,
/**
* Specifies the primary button's text in the modal.
*/
primaryButtonText: prop_types.default.string.isRequired,
/**
* Specifies the secondary button's text in the modal.
*/
secondaryButtonText: prop_types.default.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.
*/
selectorPageContent: prop_types.default.string.isRequired,
/**
* Specifies which DOM element in the form should be focused.
*/
/**@ts-ignore*/
selectorPrimaryFocus: prop_types.default.node.isRequired,
/**
* **Experimental:** Provide a `Slug` component to be rendered inside the `SidePanel` component
*/
slug: prop_types.default.node,
/**
* The subtitle of the CreateSidePanel is optional and serves to provide more information about the modal.
*/
subtitle: prop_types.default.node,
/**
* The title of the CreateSidePanel is usually the product or service name.
*/
title: prop_types.default.string.isRequired
};
//#endregion
exports.CreateSidePanel = CreateSidePanel;