Skip to main content
Built-in Elements

<hole />

Overview

A hole can be used for mounting and doesn't have any conductive properties, for a hole with a conductive ring of copper see <platedhole />.

Holes do not have a schematic representation.

Holes can be used inside of a <footprint /> or as a standalone element.

Hole Shapes

Two hole shapes are supported:

  • circle - A circular hole (default)
  • pill - A pill-shaped hole (rounded rectangle)

Circle Hole

A circular hole is the most common type used for mounting:

export default () => (
<board width="30mm" height="20mm">
<hole diameter="3mm" x={10} y={10} />
</board>
)
3D Circuit Preview

Pill-Shaped Hole

Pill-shaped holes are useful for mounting components that need elongated holes or for allowing some positional adjustment:

export default () => (
<board width="30mm" height="20mm">
<hole
shape="pill"
width="5mm"
height="2mm"
pcbX={0}
pcbY={0}
/>
</board>
)
PCB Circuit Preview

Rotated Pill Hole

Pill-shaped holes can be rotated using the pcbRotation property:

export default () => (
<board width="30mm" height="20mm">
<hole
shape="pill"
width="5mm"
height="2mm"
pcbX={0}
pcbY={0}
pcbRotation="45deg"
/>
</board>
)
PCB Circuit Preview

Properties

PropertyShapeTypeDefaultDescription
shapeall"circle" | "pill""circle"Shape of the hole
diametercirclenumber | string-Diameter of the circular hole
widthpillnumber | string-Width of the pill-shaped hole
heightpillnumber | string-Height of the pill-shaped hole
xallnumber0X position of the hole center
yallnumber0Y position of the hole center
pcbRotationpillnumber | string0Rotation angle in degrees (e.g., "45deg" or 45)