@salesforce/design-system-react/module/components/data-table/cell.js

Salesforce Lightning Design System for React

/* Copyright (c) 2015-present, salesforce.com, inc. All rights reserved */

/* Licensed under BSD 3-Clause - see LICENSE.txt or git.io/sfdc-license */
// ### React
import React, { useContext } from 'react';
import PropTypes from 'prop-types'; // ### classNames

import classNames from 'classnames';
import CellContext from './private/cell-context';
import TableContext from './private/table-context';
import useContextHelper from './private/context-helper'; // ## Constants

import { DATA_TABLE_CELL } from '../../utilities/constants';
/**
 * The default Cell renderer for the DataTable. Pass in any React component with the same `displayName` which takes the same props to provide custom rendering.
 */

var DataTableCell = function DataTableCell(props) {
  var tableContext = useContext(TableContext);
  var cellContext = useContext(CellContext);

  var _useContextHelper = useContextHelper(tableContext, cellContext, props.fixedLayout),
      tabIndex = _useContextHelper.tabIndex,
      hasFocus = _useContextHelper.hasFocus,
      handleFocus = _useContextHelper.handleFocus,
      handleKeyDown = _useContextHelper.handleKeyDown;

  var childText = /*#__PURE__*/React.isValidElement(props.children) ? props.children.props.children : props.children;
  var contents = /*#__PURE__*/React.createElement("div", {
    className: classNames({
      'slds-truncate': props.fixedLayout
    }),
    title: props.title || childText
  }, props.children);
  var className = classNames(props.className, {
    'slds-has-focus': hasFocus
  });

  var ref = function ref(node) {
    if (node && hasFocus) {
      node.focus();
    }
  };

  var cell =
  /*#__PURE__*/
  // eslint-disable-next-line jsx-a11y/no-noninteractive-element-interactions
  React.createElement("td", {
    className: className,
    "data-label": props.label,
    onFocus: handleFocus,
    onKeyDown: handleKeyDown,
    ref: ref,
    role: props.fixedLayout ? 'gridcell' : null,
    style: props.width ? {
      width: props.width
    } : null,
    tabIndex: tabIndex,
    headers: props.headerId
  }, contents);

  if (props.primaryColumn) {
    cell = /*#__PURE__*/React.createElement("th", {
      className: className,
      ref: ref,
      "data-label": props.label,
      role: props.fixedLayout ? 'gridcell' : null,
      tabIndex: tabIndex,
      style: props.width ? {
        width: props.width
      } : null,
      onFocus: handleFocus,
      onKeyDown: handleKeyDown
    }, contents);
  }

  return cell;
}; // ### Display Name
// Always use the canonical component name as the React display name.


DataTableCell.displayName = DATA_TABLE_CELL; // ### Prop Types

DataTableCell.propTypes = {
  /**
   * The contents of the cell. This can be simple text or DOM nodes. Equivalent to `props.item[props.property]`
   */
  children: PropTypes.oneOfType([PropTypes.node, PropTypes.string]),

  /**
   * Class names to be added to the cell.
   */
  className: PropTypes.oneOfType([PropTypes.array, PropTypes.object, PropTypes.string]),

  /**
   * Use this if you are creating an advanced table (selectable, sortable, or resizable rows)
   */
  fixedLayout: PropTypes.bool,

  /**
   * The item from the items which represents this row.
   */
  item: PropTypes.object,

  /**
   * The primary column for a row. This is almost always the first column.
   */
  primaryColumn: PropTypes.bool,

  /**
   * The property of this item to display.
   */
  property: PropTypes.string,

  /**
   * Shows on hover. Useful for truncated cells.
   */
  title: PropTypes.string,

  /**
   * Width of column. This is required for advanced/fixed layout tables. Please provide units. (`rems` are recommended)
   */
  width: PropTypes.string
};
export default DataTableCell;
//# sourceMappingURL=cell.js.map