Documentation
Bleed

Bleed

The Bleed component is specifically designed to create a container with negative margins so that its content appears to extend beyond the container's boundaries. This is particularly useful when you want to visually break out of a parent container without having to refactor the entire component tree.

Example

<Stack space={4}>
  <Bleed space={3}>
    <Placeholder label="space = 3" />
  </Bleed>
  <Placeholder />
  <Bleed horizontal={4}>
    <Placeholder label="horizontal = 4" />
  </Bleed>
  <Placeholder />
  <Bleed vertical={3}>
    <Placeholder label="vertical = 3" />
  </Bleed>
  <Placeholder />
  <Bleed bottom={3}>
    <Placeholder label="bottom = 3" />
  </Bleed>
  <Placeholder />
  <Placeholder />
  <Bleed top={3}>
    <Placeholder label="top = 3" />
  </Bleed>
  <Bleed left={4}>
    <Placeholder label="left = 4" />
  </Bleed>
  <Bleed right={4}>
    <Placeholder label="right = 4" />
  </Bleed>
</Stack>

This component works in contrast to the Inset component, which creates a padded container. While Inset creates a container that keeps its content within its boundaries, this component creates a container that allows its content to "bleed" into the surrounding layout.

Props

The Bleed component is created using the Box component. It extends all the props* supported by Box, as well as React Native View (opens in a new tab), and the props mentioned below.

*

Unavailable Box props: margin, marginX, marginY, marginTop, marginRight, marginBottom, marginLeft, marginStart, marginEnd

space

Type
ResponsiveProp<number>

Applies a negative margin to each side.

horizontal

Type
ResponsiveProp<number>

Applies a negative margin horizontally.

vertical

Type
ResponsiveProp<number>

Applies a negative margin vertically.

top

Type
ResponsiveProp<number>

Applies a negative margin to the top.

right

Type
ResponsiveProp<number>

Applies a negative margin to the right.

bottom

Type
ResponsiveProp<number>

Applies a negative margin to the bottom.

left

Type
ResponsiveProp<number>

Applies a negative margin to the left.

start

Type
ResponsiveProp<number>

Applies a negative margin to the left for the ltr direction, otherwise to the right.

end

Type
ResponsiveProp<number>

Applies a negative margin to the right for the ltr direction, otherwise to the left.