Sha256: 49d7ef9a25a83bb93d7f03cea78a6fc115d95a90ec4743a3cc3b061585a60e49

Contents?: true

Size: 1.87 KB

Versions: 23

Compression:

Stored size: 1.87 KB

Contents

/**
 * Defines a set of helper functions used to construct a component following
 * Playbook's patterns.
 */
import classnames from 'classnames'

/**
 *
 * @param {String} prefix the prefix to be used on the dash separated prop (data, aria, etc...)
 * @param {Object} data the object containing the data to derive the props from.
 * @returns {Object} an object whose keys have the prefix added to them.
 */
const buildPrefixedProps = (prefix: string, data: {[key: string]: any}) => 
  Object.keys(data).reduce((props: {[key: string]: any}, key: string) => {
    props[`${prefix}-${key}`] = data[key]
    return props
  }, {})

/**
 * Represent a "No-Operation" function that can be used as a sensible
 * default to event handlers in the absence of a value.
 *
 * @returns {() => {}} the noop function.
 */
export const noop = (): void => { void 0 }

/**
 * Maps a given aria object into HTML valid aria attribtues and their values.
 *
 * @param {Object} aria the object containing the aria prop values.
 * @returns {Object} an object holding the HTML valid aria props and their values.
 */
export const buildAriaProps = (aria: {[key: string]: string}): {[key: string]: string} => 
  buildPrefixedProps('aria', aria)

/**
 * Maps a given data object into HTML valid data attribtues and their values.
 *
 * @param {Object} data the object containing the data prop values.
 * @returns {Object} an object holding the HTML valid data props and their values.
 */
export const buildDataProps = (data: {[key: string]: any}) => buildPrefixedProps('data', data)

/**
 * Builds a Playbook valid root className off of the incoming css rules.
 *
 * @param {Object} rules a 'classnames' compliant rules object, used to derive the root className.
 * @returns {String} the derived root className value.
 */
export const buildCss = (...rules: (string | { [x: string]: string; })[]): string => classnames(rules).replace(/\s/g, '_')

Version data entries

23 entries across 23 versions & 1 rubygems

Version Path
playbook_ui-11.4.0.pre.alpha.rubytheme2 app/pb_kits/playbook/utilities/props.ts
playbook_ui-11.4.0.pre.alpha.rubytheme1 app/pb_kits/playbook/utilities/props.ts
playbook_ui-11.4.0 app/pb_kits/playbook/utilities/props.ts
playbook_ui-11.3.0.pre.alpha2 app/pb_kits/playbook/utilities/props.ts
playbook_ui-11.3.0.pre.alpha1 app/pb_kits/playbook/utilities/props.ts
playbook_ui-11.3.0 app/pb_kits/playbook/utilities/props.ts
playbook_ui-11.2.7 app/pb_kits/playbook/utilities/props.ts
playbook_ui-11.2.6 app/pb_kits/playbook/utilities/props.ts
playbook_ui-11.2.5 app/pb_kits/playbook/utilities/props.ts
playbook_ui-11.2.4 app/pb_kits/playbook/utilities/props.ts
playbook_ui-11.2.4.pre.alpha1 app/pb_kits/playbook/utilities/props.ts
playbook_ui-11.2.3 app/pb_kits/playbook/utilities/props.ts
playbook_ui-11.2.2 app/pb_kits/playbook/utilities/props.ts
playbook_ui-11.2.1 app/pb_kits/playbook/utilities/props.ts
playbook_ui-11.2.0 app/pb_kits/playbook/utilities/props.ts
playbook_ui-11.1.2 app/pb_kits/playbook/utilities/props.ts
playbook_ui-11.1.2.pre.alpha1 app/pb_kits/playbook/utilities/props.ts
playbook_ui-11.1.1 app/pb_kits/playbook/utilities/props.ts
playbook_ui-11.1.1.pre.alpha1 app/pb_kits/playbook/utilities/props.ts
playbook_ui-11.1.0 app/pb_kits/playbook/utilities/props.ts