bpk-component-text

bpk-component-text

Backpack text component.

Installation

npm install bpk-component-text --save-dev

Usage

import React from 'react';
import BpkText, { TEXT_STYLES, WEIGHT_STYLES } from 'bpk-component-text';

export default () => (
  <BpkText tagName="h1" textStyle={TEXT_STYLES.xl}>My heading</BpkText>
  <BpkText tagName="p">My paragraph</BpkText>
  <BpkText tagName="p" textStyle={TEXT_STYLES.lg}>My callout paragraph</BpkText>
  <BpkText tagName="p">
    Text can be <BpkText tagName="span" weight={WEIGHT_STYLES.bold}>bold</BpkText>.
  </BpkText>
);

When using the same style in many places repeating the textStyle and tagName props can become tedious in this case you can use withDefaultProps from bpk-react-utils.

import React from 'react';
import BpkText from 'bpk-component-text';
import { withDefaultProps } from 'bpk-react-utils';

const LargeParagraph = withDefaultProps(BpkText, { textStyle: 'lg', tagName: 'p' });
const TinySpan = withDefaultProps(BpkText, { textStyle: 'xs', tagName: 'span' });

export default () => (
  <div>
    <LargeParagraph>
      Lorem ipsum dolor sit amet, consectetur adipiscing elit.
      Pellentesque imperdiet lobortis tellus, non rhoncus erat tincidunt id.
      Pellentesque consectetur, dolor nec vulputate vehicula, ex metus mattis ante,
      non dictum mi ante eu arcu.
    </LargeParagraph>
    <LargeParagraph>
        Lorem ipsum dolor sit amet, consectetur adipiscing elit.
        Pellentesque imperdiet lobortis tellus, non rhoncus erat tincidunt id.
        Pellentesque consectetur, dolor nec vulputate vehicula, ex metus mattis ante,
        non dictum mi ante eu arcu.
    </LargeParagraph>
    <TinySpan>
      Side effects of Backpack include euphoria, happiness, and increased develpoment velocity.
    </TinySpan>
  </div>
);

Props

Property	PropType	Required	Default Value
children	-	true	-
textStyle	oneOf(TEXT_STYLES.xs, TEXT_STYLES.sm, TEXT_STYLES.base, TEXT_STYLES.lg, TEXT_STYLES.xl, TEXT_STYLES.xxl, TEXT_STYLES.xxxl, TEXT_STYLES.xxxxl, TEXT_STYLES.xxxxxl)	false	TEXT_STYLES.base
tagName	'span', 'p', 'text', 'h1', 'h2', 'h3', 'h4', 'h5', 'h6'	false	'span'
className	string	false	null
bold (deprecated, use weight)	bool	false	false
weight	oneOf(WEIGHT_STYLES.regular, WEIGHT_STYLES.bold, WEIGHT_STYLES.black)	false	WEIGHT_STYLES.regular