IconButton

Basic Usage with Paragon Icon

Show editable code example

Any Paragon component or export may be added to the code example.

() => {
  const variants = ["brand", "primary", "secondary", "success", "warning", "danger", "light", "dark", "black"];
  return (
    <div className="d-flex flex-wrap">
      {variants.map((variant) => (
        <IconButton key={variant} src={Close} iconAs={Icon} alt="Close" onClick={() => {}} variant={variant} className="mr-2" />
      ))}
    </div>
  );
}

() => {
  const variants = ["brand", "primary", "secondary", "success", "warning", "danger", "light", "dark", "black"];
  return (
    <div className="d-flex flex-wrap">
      {variants.map((variant) => (
        <IconButton key={variant} src={Close} iconAs={Icon} alt="Close" onClick={() => {}} variant={variant} className="mr-2" />
      ))}
    </div>
  );
}

With tooltips

Show editable code example

Any Paragon component or export may be added to the code example.

() => {
  const variants = ["brand", "primary", "secondary", "success", "warning", "danger", "light", "dark", "black"];
  return (
    <div className="d-flex">
      {variants.map((variant) => (
        <IconButtonWithTooltip
          key={variant}
          tooltipPlacement='top'
          tooltipContent={<div>a nice tooltip of {variant}!</div>}
          src={Close}
          iconAs={Icon}
          alt="Close"
          onClick={() => {}}
          variant={variant}
          className="mr-2"
        />
      ))}
    </div>
  );
}

() => {
  const variants = ["brand", "primary", "secondary", "success", "warning", "danger", "light", "dark", "black"];
  return (
    <div className="d-flex">
      {variants.map((variant) => (
        <IconButtonWithTooltip
          key={variant}
          tooltipPlacement='top'
          tooltipContent={<div>a nice tooltip of {variant}!</div>}
          src={Close}
          iconAs={Icon}
          alt="Close"
          onClick={() => {}}
          variant={variant}
          className="mr-2"
        />
      ))}
    </div>
  );
}

Active State

Show editable code example

Any Paragon component or export may be added to the code example.

() => {
  const variants = ["brand", "primary", "secondary", "success", "warning", "danger", "light", "dark", "black"];
  return (
    <div className="d-flex">
      {variants.map((variant) => (
        <IconButton 
          isActive
          key={variant}
          src={Close}
          iconAs={Icon}
          alt="Close"
          onClick={() => {}}
          variant={variant}
          className="mr-2 mb-2"
        />
      ))}
    </div>
  );
}

() => {
  const variants = ["brand", "primary", "secondary", "success", "warning", "danger", "light", "dark", "black"];
  return (
    <div className="d-flex">
      {variants.map((variant) => (
        <IconButton 
          isActive
          key={variant}
          src={Close}
          iconAs={Icon}
          alt="Close"
          onClick={() => {}}
          variant={variant}
          className="mr-2 mb-2"
        />
      ))}
    </div>
  );
}

isActive=true with inverted colors

Show editable code example

Any Paragon component or export may be added to the code example.

() => {
  const variants = ["brand", "primary", "secondary", "success", "warning", "danger", "light", "dark", "black"];
  return (
    <div className="d-flex">
      {variants.map((variant) => (
        <IconButton 
          invertColors
          isActive
          key={variant}
          src={Close}
          iconAs={Icon}
          alt="Close"
          onClick={() => {}}
          variant={variant}
          className="mr-2"
        />
      ))}
    </div>
  );
}

() => {
  const variants = ["brand", "primary", "secondary", "success", "warning", "danger", "light", "dark", "black"];
  return (
    <div className="d-flex">
      {variants.map((variant) => (
        <IconButton 
          invertColors
          isActive
          key={variant}
          src={Close}
          iconAs={Icon}
          alt="Close"
          onClick={() => {}}
          variant={variant}
          className="mr-2"
        />
      ))}
    </div>
  );
}

Inverted Colors

Show editable code example

Any Paragon component or export may be added to the code example.

<div className="d-flex">
  <div className="p-1 bg-brand">
    <IconButton
      src={MenuIcon}
      iconAs={Icon}
      alt="Menu"
      onClick={() => console.log("You clicked the menu button")}
      variant="brand"
      invertColors
    />
  </div>
  <div className="p-1 bg-primary">
    <IconButton
      src={MenuIcon}
      iconAs={Icon}
      alt="Menu"
      onClick={() => console.log("You clicked the menu button")}
      variant="primary"
      invertColors
    />
  </div>
  <div className="p-1 bg-secondary">
    <IconButton
      src={MenuIcon}
      iconAs={Icon}
      alt="Menu"
      onClick={() => console.log("You clicked the menu button")}
      variant="secondary"
      invertColors
    />
  </div>
  <div className="p-1 bg-success">
    <IconButton
      src={MenuIcon}
      iconAs={Icon}
      alt="Menu"
      onClick={() => console.log("You clicked the menu button")}
      variant="success"
      invertColors
    />
  </div>
  <div className="p-1 bg-warning">
    <IconButton
      src={MenuIcon}
      iconAs={Icon}
      alt="Menu"
      onClick={() => console.log("You clicked the menu button")}
      variant="warning"
      invertColors
    />
  </div>
  <div className="p-1 bg-danger">
    <IconButton
      src={MenuIcon}
      iconAs={Icon}
      alt="Menu"
      onClick={() => console.log("You clicked the menu button")}
      variant="danger"
      invertColors
    />
  </div>
  <div className="p-1 bg-light">
    <IconButton
      src={MenuIcon}
      iconAs={Icon}
      alt="Menu"
      onClick={() => console.log("You clicked the menu button")}
      variant="light"
      invertColors
    />
  </div>
  <div className="p-1" style={{ background: "black" }}>
    <IconButton
      src={MenuIcon}
      iconAs={Icon}
      alt="Menu"
      onClick={() => console.log("You clicked the menu button")}
      variant="black"
      invertColors
    />
  </div>
</div>

<div className="d-flex">
  <div className="p-1 bg-brand">
    <IconButton
      src={MenuIcon}
      iconAs={Icon}
      alt="Menu"
      onClick={() => console.log("You clicked the menu button")}
      variant="brand"
      invertColors
    />
  </div>
  <div className="p-1 bg-primary">
    <IconButton
      src={MenuIcon}
      iconAs={Icon}
      alt="Menu"
      onClick={() => console.log("You clicked the menu button")}
      variant="primary"
      invertColors
    />
  </div>
  <div className="p-1 bg-secondary">
    <IconButton
      src={MenuIcon}
      iconAs={Icon}
      alt="Menu"
      onClick={() => console.log("You clicked the menu button")}
      variant="secondary"
      invertColors
    />
  </div>
  <div className="p-1 bg-success">
    <IconButton
      src={MenuIcon}
      iconAs={Icon}
      alt="Menu"
      onClick={() => console.log("You clicked the menu button")}
      variant="success"
      invertColors
    />
  </div>
  <div className="p-1 bg-warning">
    <IconButton
      src={MenuIcon}
      iconAs={Icon}
      alt="Menu"
      onClick={() => console.log("You clicked the menu button")}
      variant="warning"
      invertColors
    />
  </div>
  <div className="p-1 bg-danger">
    <IconButton
      src={MenuIcon}
      iconAs={Icon}
      alt="Menu"
      onClick={() => console.log("You clicked the menu button")}
      variant="danger"
      invertColors
    />
  </div>
  <div className="p-1 bg-light">
    <IconButton
      src={MenuIcon}
      iconAs={Icon}
      alt="Menu"
      onClick={() => console.log("You clicked the menu button")}
      variant="light"
      invertColors
    />
  </div>
  <div className="p-1" style={{ background: "black" }}>
    <IconButton
      src={MenuIcon}
      iconAs={Icon}
      alt="Menu"
      onClick={() => console.log("You clicked the menu button")}
      variant="black"
      invertColors
    />
  </div>
</div>

Sizes

Show editable code example

Any Paragon component or export may be added to the code example.

<>
  <div className="mb-1">
    Small
    <IconButton
      src={MenuIcon}
      iconAs={Icon}
      alt="Menu"
      onClick={() => {}}
      variant="primary"
      size="sm"
    />
  </div>
  <div className="mb-1">
    Inline:
    <IconButton
      src={MenuIcon}
      iconAs={Icon}
      alt="Menu"
      onClick={() => {}}
      variant="primary"
      size="inline"
    />
  </div>
  <div className="x-small mb-1">
    An <strong>inline</strong> Icon Button inherits font size!
    For example, applying className="x-small" will make the Icon Button look like this:
    <IconButton
      src={Favorite}
      iconAs={Icon}
      alt="Favorite"
      onClick={() => {}}
      variant="primary"
      size="inline"
    />
    . The Icon Button will also wrap with the text as long as it is not a direct child of a flex box.
  </div>
</>

<>
  <div className="mb-1">
    Small
    <IconButton
      src={MenuIcon}
      iconAs={Icon}
      alt="Menu"
      onClick={() => {}}
      variant="primary"
      size="sm"
    />
  </div>
  <div className="mb-1">
    Inline:
    <IconButton
      src={MenuIcon}
      iconAs={Icon}
      alt="Menu"
      onClick={() => {}}
      variant="primary"
      size="inline"
    />
  </div>
  <div className="x-small mb-1">
    An <strong>inline</strong> Icon Button inherits font size!
    For example, applying className="x-small" will make the Icon Button look like this:
    <IconButton
      src={Favorite}
      iconAs={Icon}
      alt="Favorite"
      onClick={() => {}}
      variant="primary"
      size="inline"
    />
    . The Icon Button will also wrap with the text as long as it is not a direct child of a flex box.
  </div>
</>

Props API#

IconButton Props API

className string
A custom class name.
iconAs elementType
Component that renders the icon, currently defaults to FontAwesomeIcon, but is going to be deprecated soon, please use Paragon's icons instead.
src element | func
An icon component to render. Example import of a Paragon icon component: import { Check } from '@edx/paragon/dist/icon';
Defaultnull
alt string 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
Changes icon styles for dark background
Defaultfalse
icon shape {
prefix: string,
iconName: string,
icon: array,
}
Accepts a React fontawesome icon. https://fontawesome.com/how-to-use/on-the-web/using-with/react
iconClassNames string
Extra class names that will be added to the icon
onClick func
Click handler for the button
Default() => {}
variant enum'primary' | 'secondary' | 'success' | 'warning' | 'danger' | 'light' | 'dark' | 'black' | 'brand'
Type of button (uses Bootstrap options)
Default'primary'
size enum'sm' | 'md' | 'inline'
size of button to render
Default'md'
isActive bool
whether to show the IconButton in an active state, whose styling is distinct from default state
Defaultfalse

IconButtonWithTooltip Props API

tooltipPlacement string
tooltip placement can be top, left, right etc, per https://popper.js.org/docs/v2/constructors/#options
Default'top'
tooltipContent node Required
any valid JSX or text to be rendered as tooltip contents
variant enum'primary' | 'secondary' | 'success' | 'warning' | 'danger' | 'light' | 'dark' | 'black' | 'brand'
Type of button (uses Bootstrap options)
Default'primary'
invertColors bool
Changes icon styles for dark background
Defaultfalse

Usage Insights#

IconButton

Project Name	Paragon Version	Instance Count
frontend-app-admin-portal	20.39.2	8
frontend-app-authn	20.45.5	4
frontend-app-communications	20.45.0	3
frontend-app-course-authoring	20.35.1	7
frontend-app-discussions	20.44.0	11
frontend-app-gradebook	20.45.0	1
frontend-app-learner-dashboard	20.32.0	2
frontend-app-learner-portal-enterprise	20.45.1	1
frontend-app-learner-record	20.45.0	1
frontend-app-learning	20.28.4	5
frontend-app-library-authoring	20.45.5	3
frontend-app-ora-grading	20.45.1	5
frontend-app-support-tools	20.45.0	2
frontend-component-header-edx	20.45.5	1
frontend-component-header	20.45.5	1
frontend-lib-content-components	20.45.0	16
prospectus	20.45.2	5

IconButtonWithTooltip

Project Name	Paragon Version	Instance Count
frontend-app-course-authoring	20.35.1	3
frontend-app-support-tools	20.45.0	1
frontend-lib-content-components	20.45.0	6

Leave feedback

Paragon Design System

Theme

IconButton

Basic Usage with Paragon Icon

With tooltips

Active State

isActive=true with inverted colors

Inverted Colors

Sizes

Props API#

Usage Insights#

IconButton

IconButtonWithTooltip

All components (A-Z)

Theme

IconButton

Basic Usage with Paragon Icon#

With tooltips#

Active State#

isActive=true with inverted colors#

Inverted Colors#

Sizes#

Props API#

Usage Insights#

IconButton

IconButtonWithTooltip

All components (A-Z)

Basic Usage with Paragon Icon

With tooltips

Active State

isActive=true with inverted colors

Inverted Colors

Sizes