Icon Button

IconButton composes the Button component except that it renders only an icon.

Since IconButton only renders an icon, you must pass the aria-label prop, so screen readers can give meaning to the button.

Import#

import { IconButton } from "@chakra-ui/core"

import { IconButton } from "@chakra-ui/core"

<IconButton aria-label="Search database" icon={<SearchIcon />} />

<IconButton aria-label="Search database" icon={<SearchIcon />} />

Editable Example

The IconButton component accepts most of the props from the Button component, so we can use colorScheme prop to change the color of the button.

<IconButton
  colorScheme="blue"
  aria-label="Search database"
  icon={<SearchIcon />}
/>

<IconButton
  colorScheme="blue"
  aria-label="Search database"
  icon={<SearchIcon />}
/>

Editable Example

Like the Button component, pass the size prop to change the size of the button.

<IconButton
  colorScheme="teal"
  aria-label="Call Segun"
  size="lg"
  icon={<PhoneIcon />}
/>

<IconButton
  colorScheme="teal"
  aria-label="Call Segun"
  size="lg"
  icon={<PhoneIcon />}
/>

Editable Example

Like the Button component, pass the variant prop to change the style of the button.

<IconButton
  variant="outline"
  colorScheme="teal"
  aria-label="Send email"
  icon={<EmailIcon />}
/>

<IconButton
  variant="outline"
  colorScheme="teal"
  aria-label="Send email"
  icon={<EmailIcon />}
/>

Editable Example

You can also use icons from popular libraries like react-icons and just pass it into the button.

<IconButton
  variant="outline"
  colorScheme="teal"
  aria-label="Call Sage"
  fontSize="20px"
  icon={<MdPhone />}
/>

<IconButton
  variant="outline"
  colorScheme="teal"
  aria-label="Call Sage"
  fontSize="20px"
  icon={<MdPhone />}
/>

Editable Example

Name	Type	Default	Description
size	`sm`, `md`, `lg`	`md`	Specifies an explicit icon size instead of the default value.
icon	`string`	`null`	The icon to be used. Refer to the Icons section of the docs for the available icon options.
isRound	`boolean`	`false`	If `true`, the button will be perfectly round. Else, it'll be slightly round.
aria-label (required)	`string`		A11y: A label that describes the button.
variant	`outline`, `ghost`, `unstyled` , `link` , `solid`	`solid`	The variant of the button style to use.
colorScheme	`string`	`gray`	The color scheme of the button.
isDisabled	`boolean`		If `true`, the button will be disabled.
isLoading	`boolean`		If `true`, the button will show a spinner.