@workday/canvas-kit-react/dist/commonjs/layout/lib/Grid.js

The parent module that contains all Workday Canvas Kit React components

"use strict";
var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
    if (k2 === undefined) k2 = k;
    var desc = Object.getOwnPropertyDescriptor(m, k);
    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
      desc = { enumerable: true, get: function() { return m[k]; } };
    }
    Object.defineProperty(o, k2, desc);
}) : (function(o, m, k, k2) {
    if (k2 === undefined) k2 = k;
    o[k2] = m[k];
}));
var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
    Object.defineProperty(o, "default", { enumerable: true, value: v });
}) : function(o, v) {
    o["default"] = v;
});
var __importStar = (this && this.__importStar) || function (mod) {
    if (mod && mod.__esModule) return mod;
    var result = {};
    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
    __setModuleDefault(result, mod);
    return result;
};
var __importDefault = (this && this.__importDefault) || function (mod) {
    return (mod && mod.__esModule) ? mod : { "default": mod };
};
Object.defineProperty(exports, "__esModule", { value: true });
exports.Grid = void 0;
const React = __importStar(require("react"));
const styled_1 = __importDefault(require("@emotion/styled"));
const common_1 = require("@workday/canvas-kit-react/common");
const Box_1 = require("./Box");
const grid_1 = require("./utils/grid");
const StyledGrid = (0, styled_1.default)(Box_1.Box)({
    display: 'grid',
}, grid_1.grid);
const GridItem = (0, common_1.createComponent)('div')({
    displayName: 'Grid.Item',
    Component: ({ children, ...elemProps }, ref, Element) => {
        return (React.createElement(Box_1.Box, { as: Element, ref: ref, ...elemProps }, children));
    },
});
/**
 * `Grid` is a two-dimensional layout system for the web. It lets you lay content out in rows and columns.
 * It is highly flexible, and can be used on its own or to build other components.
 * `Grid` is built on top of `Box` and has access to all `BoxProps`.
 *
 * @example
 * ```tsx
 * import { Grid } from '@workday/canvas-kit-react/layout';
 *
 * interface CardProps extends GridProps {
 *   // card-specific props
 * }
 *
 * // `Card`'s default values are set using `GridProps`
 * const Card = (props: CardProps) => (
 *   <Grid gridAutoFlow="row" alignItems="start" depth={1} space="m" {...props}>
 *     <h1>Hello, Card!</h1>
 *     <p>This card uses grid to set its layout.</p>
 *   </Grid>
 * );
 *```
 */
exports.Grid = (0, common_1.createComponent)('div')({
    displayName: 'Grid',
    Component: ({ children, ...elemProps }, ref, Element) => {
        return (React.createElement(StyledGrid, { as: Element, ref: ref, ...elemProps }, children));
    },
    subComponents: {
        /**
         * `<Grid.Item />` is the child specific sub-component to `<Grid/>`. `<Grid.Item />` gets child specific props, whereas `<Grid./>` gets parent container props.
         *
         * @example
         * ```
         * import { Grid } from '@workday/canvas-kit-react/layout';
         * `Grid` is built on top of `Box` so `<Grid.Item />` gets all `BoxProps` as well.
         *
         * interface CardProps extends GridItemStyleProps {
         *   // card-specific props
         * }
         *
         * // `Card`'s default values are set using `GridItemStyleProps`
         * const Card = (props: CardProps) => (
         *   <Grid.Item gridRowStart="1" gridArea="Card" {...props}>
         *     <h1>Hello, Card!</h1>
         *     <p>This card uses grid child specific props to set its layout.</p>
         *   </Grid.Item>
         * );
         *```
         */
        Item: GridItem,
    },
});