---
title: "BorderScope"
description: "An interface that introduces border properties to a Style receiver scope interface."
type: "interface"
lastmod: "2026-05-20T01:13:53.360097Z"
---
## API Reference

> Source set: Common

```kotlin
@ExperimentalFoundationStyleApi
interface BorderScope
```

An interface that introduces border properties to a [Style](/jetpack-compose/androidx.compose.foundation/foundation/interfaces/Style) receiver scope interface.

## Functions

### borderWidth

```kotlin
fun borderWidth(value: Dp)
```

Sets the width of the border around the component. The border is drawn on top of the
background and the padded content. The border's width does not contribute to the component's
layout size (width/height); it is rendered within the component's bounds This method only
sets the width; color or brush must be set separately.

Specifying a `Dp.Unspecified` value will remove the border.

Specifying a `Dp.Hairline` or 0.dp value will create 1 pixel border regardless of density.

This property is *not* inherited

#### Parameters

| | |
| --- | --- |
| value | The width of the border. |

### borderColor

```kotlin
fun borderColor(value: Color)
```

Sets the color of the border around the component. The border is drawn on top of the
background and the padded content. This method only sets the color; width must be set
separately. The border's presence and appearance do not affect the component's layout size.

This property is *not* inherited

#### Parameters

| | |
| --- | --- |
| value | The color of the border. |

### borderBrush

```kotlin
fun borderBrush(value: Brush)
```

Sets the brush used to paint the border around the component. The border is drawn on top of
the background and the padded content. This method only sets the brush; width must be set
separately. The border's presence and appearance do not affect the component's layout size.

This property is *not* inherited

#### Parameters

| | |
| --- | --- |
| value | The brush to paint the border (e.g., for gradients). |