<div class='sourceset sourceset-android'>Android</div>

```kotlin
@ExperimentalWearMaterialApi
public object PlaceholderDefaults
```

Contains the default values used for providing placeholders.

There are three distinct but coordinated aspects to placeholders in Compose for Wear OS. Firstly
placeholder [Modifier.placeholder](/jetpack-compose/androidx.wear.compose/compose-material/composable-functions/placeholder) which is drawn over content that is not yet loaded. Secondly a
placeholder background which provides a background brush to cover the usual background of
containers such as [Chip](/jetpack-compose/androidx.wear.compose/compose-material/components/Chip) or [Card](/jetpack-compose/androidx.wear.compose/compose-material/components/Card) until all of the content has loaded. Thirdly a placeholder
shimmer effect [Modifier.placeholderShimmer](/jetpack-compose/androidx.wear.compose/compose-material/composable-functions/placeholderShimmer) effect which runs in an animation loop while waiting
for the data to load.

## Functions

<h2 id="placeholderchipcolors-originalchipcolors-placeholderstate-color">placeholderChipColors</h2>

```kotlin
@Composable
public fun placeholderChipColors(
    originalChipColors: ChipColors,
    placeholderState: PlaceholderState,
    color: Color = MaterialTheme.colors.surface,
): ChipColors
```

Create a [ChipColors](/jetpack-compose/androidx.wear.compose/compose-material/interfaces/ChipColors) that can be used in placeholder mode. This will provide the placeholder
background effect that covers the normal chip background with a solid background of [color](/jetpack-compose/androidx.compose.ui/ui-graphics/classes/Color)
when the [placeholderState](/jetpack-compose/androidx.wear.compose/compose-material/classes/PlaceholderState) is set to show the placeholder and a wipe off gradient brush when
the state is in wipe-off mode. If the state is [PlaceholderState.isShowContent](/jetpack-compose/androidx.wear.compose/compose-material/classes/PlaceholderState) then the
normal background will be used. All other colors will be delegated to `originalChipColors`.

Example of a [Chip](/jetpack-compose/androidx.wear.compose/compose-material/components/Chip) with icon and a label that put placeholders over individual content slots
and then draws a placeholder shimmer over the result and draws over the [Chip](/jetpack-compose/androidx.wear.compose/compose-material/components/Chip)s normal
background color with [color](/jetpack-compose/androidx.compose.ui/ui-graphics/classes/Color) as the placeholder background color which will be wiped away
once all of the placeholder data is loaded:

#### Parameters

| | |
| --- | --- |
| originalChipColors | the chip colors to use when not in placeholder mode. |
| placeholderState | the placeholder state of the component |
| color | the color to use for the placeholder background brush |

<hr class="docs-overload-divider">

<h2 id="placeholderchipcolors-placeholderstate-color">placeholderChipColors</h2>

```kotlin
@Composable
public fun placeholderChipColors(
    placeholderState: PlaceholderState,
    color: Color = MaterialTheme.colors.surface,
): ChipColors
```

Create a [ChipColors](/jetpack-compose/androidx.wear.compose/compose-material/interfaces/ChipColors) that can be used for a [Chip](/jetpack-compose/androidx.wear.compose/compose-material/components/Chip) that is used as a placeholder drawn on
top of another [Chip](/jetpack-compose/androidx.wear.compose/compose-material/components/Chip). When not drawing a placeholder background brush the chip will be
transparent allowing the contents of the chip below to be displayed.

Example of a [Chip](/jetpack-compose/androidx.wear.compose/compose-material/components/Chip) with icon and a primary and secondary labels that draws another [Chip](/jetpack-compose/androidx.wear.compose/compose-material/components/Chip)
over the top of it when waiting for placeholder data to load and draws over the [Chip](/jetpack-compose/androidx.wear.compose/compose-material/components/Chip)s
normal background color with [color](/jetpack-compose/androidx.compose.ui/ui-graphics/classes/Color) as the placeholder background color which will be wiped
away once all of the placeholder data is loaded:

#### Parameters

| | |
| --- | --- |
| color | the color to use for the placeholder background brush. |
| placeholderState | the current placeholder state. |

<hr class="docs-overload-divider">

<h2 id="painterwithplaceholderoverlaybackgroundbrush-placeholderstate-painter-color">painterWithPlaceholderOverlayBackgroundBrush</h2>

```kotlin
@Composable
public fun painterWithPlaceholderOverlayBackgroundBrush(
    placeholderState: PlaceholderState,
    painter: Painter,
    color: Color = MaterialTheme.colors.surface,
): Painter
```

Create a [Painter](/jetpack-compose/androidx.compose.ui/ui-graphics/classes/Painter) that wraps another painter and overlays a placeholder background brush on
top. If the [placeholderState](/jetpack-compose/androidx.wear.compose/compose-material/classes/PlaceholderState) is [PlaceholderState.isShowContent](/jetpack-compose/androidx.wear.compose/compose-material/classes/PlaceholderState) the original painter will
be used. Otherwise the [painter](/jetpack-compose/androidx.compose.ui/ui-graphics/classes/Painter) will be drawn and then a placeholder background will be
drawn over it or a wipe-off brush will be used to reveal the background when the state is
[PlaceholderState.isWipeOff](/jetpack-compose/androidx.wear.compose/compose-material/classes/PlaceholderState).

#### Parameters

| | |
| --- | --- |
| placeholderState | the state of the placeholder |
| painter | the original painter that will be drawn over when in placeholder mode. |
| color | the color to use for the placeholder background brush |

<hr class="docs-overload-divider">

<h2 id="placeholderbackgroundbrush-placeholderstate-color">placeholderBackgroundBrush</h2>

```kotlin
@Composable
public fun placeholderBackgroundBrush(
    placeholderState: PlaceholderState,
    color: Color = MaterialTheme.colors.surface,
): Painter
```

Create a [Painter](/jetpack-compose/androidx.compose.ui/ui-graphics/classes/Painter) that paints with a placeholder background brush. If the [placeholderState](/jetpack-compose/androidx.wear.compose/compose-material/classes/PlaceholderState)
is [PlaceholderState.isShowContent](/jetpack-compose/androidx.wear.compose/compose-material/classes/PlaceholderState) then a transparent background will be shown. Otherwise a
placeholder background will be drawn or a wipe-off brush will be used to reveal the content
underneath when [PlaceholderState.isWipeOff](/jetpack-compose/androidx.wear.compose/compose-material/classes/PlaceholderState) is true.

#### Parameters

| | |
| --- | --- |
| placeholderState | the state of the placeholder |
| color | the color to use for the placeholder background brush |