IconButton

Basic Usage with Paragon Icon

With tooltips

Active State

isActive=true with inverted colors

Inverted Colors

Sizes

IconButton Props API
  • className string Required

    A custom class name.

  • iconAs elementType Required

    Component that renders the icon, currently defaults to FontAwesomeIcon, but is going to be deprecated soon, please use Paragon's icons instead.

  • src element Required | func Required Required

    An icon component to render. Example import of a Paragon icon component: import { Check } from '@edx/paragon/dist/icon';

    Defaultnull
  • alt string Required Required

    Alt text for your icon. For best practice, avoid using alt text to describe the image in the IconButton. Instead, we recommend describing the function of the button.

  • invertColors bool Required

    Changes icon styles for dark background

    Defaultfalse
  • icon shape Required {
    prefix: string,
    iconName: string,
    icon: array,
    }
  • iconClassNames string Required

    Extra class names that will be added to the icon

  • onClick func Required

    Click handler for the button

    Default() => {}
  • variant enum Required'primary' | 'secondary' | 'success' | 'warning' | 'danger' | 'light' | 'dark' | 'black' | 'brand'

    Type of button (uses Bootstrap options)

    Default'primary'
  • size enum Required'sm' | 'md' | 'inline'

    size of button to render

    Default'md'
  • isActive bool Required

    whether to show the IconButton in an active state, whose styling is distinct from default state

    Defaultfalse
IconButtonWithTooltip Props API
  • tooltipPlacement string Required

    tooltip placement can be top, left, right etc, per https://popper.js.org/docs/v2/constructors/#options

    Default'top'
  • tooltipContent node Required Required

    any valid JSX or text to be rendered as tooltip contents

  • variant enum Required'primary' | 'secondary' | 'success' | 'warning' | 'danger' | 'light' | 'dark' | 'black' | 'brand'

    Type of button (uses Bootstrap options)

    Default'primary'
  • invertColors bool Required

    Changes icon styles for dark background

    Defaultfalse