Android
```kotlin
public object IconButtonDefaults
```
Contains the default values used by [IconButton](/jetpack-compose/androidx.wear.compose/compose-material3/components/IconButton).
## Functions
```kotlin
@Composable public fun shapes(): IconButtonShapes
```
Returns the default [IconButtonShapes](/jetpack-compose/androidx.wear.compose/compose-material3/classes/IconButtonShapes) for a static [IconButton](/jetpack-compose/androidx.wear.compose/compose-material3/components/IconButton).
shapes
```kotlin
@Composable
public fun shapes(shape: Shape): IconButtonShapes
```
Returns a [IconButtonShapes](/jetpack-compose/androidx.wear.compose/compose-material3/classes/IconButtonShapes) for a static [IconButton](/jetpack-compose/androidx.wear.compose/compose-material3/components/IconButton).
#### Parameters
| | |
| --- | --- |
| shape | The normal shape of the IconButton. |
animatedShapes
```kotlin
@Composable
public fun animatedShapes(): IconButtonShapes
```
Returns the default [IconButtonShapes](/jetpack-compose/androidx.wear.compose/compose-material3/classes/IconButtonShapes) with a animation between two CornerBasedShapes when
pressed.
Example of a simple icon button using the default colors, animated when pressed:
Example of a simple icon toggle button using the default colors, animated when pressed:
animatedShapes
```kotlin
@Composable
public fun animatedShapes(
shape: CornerBasedShape? = null,
pressedShape: CornerBasedShape? = null,
): IconButtonShapes
```
Returns a [IconButtonShapes](/jetpack-compose/androidx.wear.compose/compose-material3/classes/IconButtonShapes) with an animation between two CornerBasedShapes when pressed.
Example of a simple icon button using the default colors, animated when pressed:
#### Parameters
| | |
| --- | --- |
| shape | The normal shape of the IconButton - if null, the default [IconButtonDefaults.shape](/jetpack-compose/androidx.wear.compose/compose-material3/objects/IconButtonDefaults) is used. |
| pressedShape | The pressed shape of the IconButton - if null, the default [IconButtonDefaults.pressedShape](/jetpack-compose/androidx.wear.compose/compose-material3/objects/IconButtonDefaults) is used. |
```kotlin
public fun iconSizeFor(buttonSize: Dp): Dp
```
Recommended icon size for a given icon button size.
Ensures that the minimum recommended icon size is applied.
Examples: for size `LargeButtonSize`, returns `LargeIconSize`, for size
`ExtraSmallButtonSize` returns `SmallIconSize`.
#### Parameters
| | |
| --- | --- |
| buttonSize | The size of the icon button |
```kotlin
@Composable
public fun filledIconButtonColors(): IconButtonColors
```
Returns an [IconButtonColors](/jetpack-compose/androidx.wear.compose/compose-material3/classes/IconButtonColors) with the colors for [FilledIconButton](/jetpack-compose/androidx.wear.compose/compose-material3/components/FilledIconButton) - by default, a colored
background with a contrasting icon color. If the icon button is disabled then the colors will
default to the MaterialTheme onSurface color with suitable alpha values applied.
filledIconButtonColors
```kotlin
@Composable
public fun filledIconButtonColors(
containerColor: Color = Color.Unspecified,
contentColor: Color = Color.Unspecified,
disabledContainerColor: Color = Color.Unspecified,
disabledContentColor: Color = Color.Unspecified,
): IconButtonColors
```
Returns an [IconButtonColors](/jetpack-compose/androidx.wear.compose/compose-material3/classes/IconButtonColors) with the colors for [FilledIconButton](/jetpack-compose/androidx.wear.compose/compose-material3/components/FilledIconButton) - by default, a colored
background with a contrasting icon color. If the icon button is disabled then the colors will
default to the MaterialTheme onSurface color with suitable alpha values applied.
#### Parameters
| | |
| --- | --- |
| containerColor | The background color of this icon button when enabled. |
| contentColor | The color of this icon when enabled. |
| disabledContainerColor | The background color of this icon button when not enabled. |
| disabledContentColor | The color of this icon when not enabled. |
```kotlin
@Composable
public fun filledVariantIconButtonColors(): IconButtonColors
```
Returns an [IconButtonColors](/jetpack-compose/androidx.wear.compose/compose-material3/classes/IconButtonColors) as an alternative to the [filledTonalIconButtonColors](#filledtonaliconbuttoncolors), giving
a surface with more chroma to indicate selected or highlighted states that are not primary
calls-to-action. If the icon button is disabled then the colors will default to the
MaterialTheme onSurface color with suitable alpha values applied.
Example of creating a [FilledIconButton](/jetpack-compose/androidx.wear.compose/compose-material3/components/FilledIconButton) with [filledVariantIconButtonColors](#filledvarianticonbuttoncolors):
filledVariantIconButtonColors
```kotlin
@Composable
public fun filledVariantIconButtonColors(
containerColor: Color = Color.Unspecified,
contentColor: Color = Color.Unspecified,
disabledContainerColor: Color = Color.Unspecified,
disabledContentColor: Color = Color.Unspecified,
): IconButtonColors
```
Returns an [IconButtonColors](/jetpack-compose/androidx.wear.compose/compose-material3/classes/IconButtonColors) as an alternative to the [filledTonalIconButtonColors](#filledtonaliconbuttoncolors), giving
a surface with more chroma to indicate selected or highlighted states that are not primary
calls-to-action. If the icon button is disabled then the colors will default to the
MaterialTheme onSurface color with suitable alpha values applied.
Example of creating a [FilledIconButton](/jetpack-compose/androidx.wear.compose/compose-material3/components/FilledIconButton) with [filledVariantIconButtonColors](#filledvarianticonbuttoncolors):
#### Parameters
| | |
| --- | --- |
| containerColor | The background color of this icon button when enabled. |
| contentColor | The color of this icon when enabled. |
| disabledContainerColor | The background color of this icon button when not enabled. |
| disabledContentColor | The color of this icon when not enabled. |
```kotlin
@Composable
public fun filledTonalIconButtonColors(): IconButtonColors
```
Returns an [IconButtonColors](/jetpack-compose/androidx.wear.compose/compose-material3/classes/IconButtonColors) with the colors for [FilledTonalIconButton](/jetpack-compose/androidx.wear.compose/compose-material3/components/FilledTonalIconButton)- by default, a
muted colored background with a contrasting icon color. If the icon button is disabled then
the colors will default to the MaterialTheme onSurface color with suitable alpha values
applied.
filledTonalIconButtonColors
```kotlin
@Composable
public fun filledTonalIconButtonColors(
containerColor: Color = Color.Unspecified,
contentColor: Color = Color.Unspecified,
disabledContainerColor: Color = Color.Unspecified,
disabledContentColor: Color = Color.Unspecified,
): IconButtonColors
```
Returns an [IconButtonColors](/jetpack-compose/androidx.wear.compose/compose-material3/classes/IconButtonColors) with the colors for [FilledTonalIconButton](/jetpack-compose/androidx.wear.compose/compose-material3/components/FilledTonalIconButton)- by default, a
muted colored background with a contrasting icon color. If the icon button is disabled then
the colors will default to the MaterialTheme onSurface color with suitable alpha values
applied.
#### Parameters
| | |
| --- | --- |
| containerColor | The background color of this icon button when enabled. |
| contentColor | The color of this icon when enabled. |
| disabledContainerColor | The background color of this icon button when not enabled. |
| disabledContentColor | The color of this icon when not enabled. |
```kotlin
@Composable
public fun outlinedIconButtonColors(): IconButtonColors
```
Returns an [IconButtonColors](/jetpack-compose/androidx.wear.compose/compose-material3/classes/IconButtonColors) with the colors for [OutlinedIconButton](/jetpack-compose/androidx.wear.compose/compose-material3/components/OutlinedIconButton)- by default, a
transparent background with contrasting icon color. If the icon button is disabled then the
colors will default to the MaterialTheme onSurface color with suitable alpha values applied.
outlinedIconButtonColors
```kotlin
@Composable
public fun outlinedIconButtonColors(
contentColor: Color = Color.Unspecified,
disabledContentColor: Color = Color.Unspecified,
): IconButtonColors
```
Returns an [IconButtonColors](/jetpack-compose/androidx.wear.compose/compose-material3/classes/IconButtonColors) with the colors for [OutlinedIconButton](/jetpack-compose/androidx.wear.compose/compose-material3/components/OutlinedIconButton)- by default, a
transparent background with contrasting icon color. If the icon button is disabled then the
colors will default to the MaterialTheme onSurface color with suitable alpha values applied.
#### Parameters
| | |
| --- | --- |
| contentColor | The color of this icon button when enabled. |
| disabledContentColor | The color of this icon when not enabled. |
```kotlin
@Composable
public fun iconButtonColors(): IconButtonColors
```
Returns an [IconButtonColors](/jetpack-compose/androidx.wear.compose/compose-material3/classes/IconButtonColors) with the colors for [IconButton](/jetpack-compose/androidx.wear.compose/compose-material3/components/IconButton) - by default, a transparent
background with a contrasting icon color. If the icon button is disabled then the colors will
default to the MaterialTheme onSurface color with suitable alpha values applied.
iconButtonColors
```kotlin
@Composable
public fun iconButtonColors(
containerColor: Color = Color.Transparent,
contentColor: Color = Color.Unspecified,
disabledContainerColor: Color = Color.Transparent,
disabledContentColor: Color = Color.Unspecified,
): IconButtonColors
```
Returns an [IconButtonColors](/jetpack-compose/androidx.wear.compose/compose-material3/classes/IconButtonColors) with the colors for [IconButton](/jetpack-compose/androidx.wear.compose/compose-material3/components/IconButton) - by default, a transparent
background with a contrasting icon color. If the icon button is disabled then the colors will
default to the MaterialTheme onSurface color with suitable alpha values applied.
#### Parameters
| | |
| --- | --- |
| containerColor | The background color of this icon button when enabled. |
| contentColor | The color of this icon when enabled. |
| disabledContainerColor | The background color of this icon button when not enabled. |
| disabledContentColor | The color of this icon when not enabled. |