Basics
Guides
API Reference
Basics
Guides
API Reference
[91:7] extends: Pane
The BorderPane class wraps the JavaFX BorderPane layout container, which divides its area into five regions: top, bottom, left, right, and center. Each region accepts a single child node, and the center region expands to fill all remaining space after the edge regions have been sized. This layout pattern is commonly used for application shells with a toolbar at the top, a status bar at the bottom, navigation panels on the sides, and main content in the center. BorderPane has no additional CSS properties beyond those inherited from Pane and Region.
| Property | Values | Default | Description |
|---|---|---|---|
-fx-background-color |
<paint> [, <paint>]* |
transparent |
One or more paint values for background fill layers, rendered back to front. |
-fx-background-insets |
<size> or <t> <r> <b> <l> [, ...]* |
0 0 0 0 |
Insets from the region edges for each background fill layer. |
-fx-background-radius |
<size> [/ <size>]* [, ...]* |
0 0 0 0 |
Corner radii for each background fill layer. |
| Property | Values | Default | Description |
|---|---|---|---|
-fx-background-image |
<uri> [, <uri>]* |
null |
One or more image URIs for background image layers. |
-fx-background-position |
<bg-position> [, ...]* |
0% 0% |
Position of each background image within the region. Accepts keywords or size values. |
-fx-background-repeat |
<repeat-style> [, ...]* |
repeat repeat |
Tiling behavior for each background image. Values: repeat, no-repeat, round, space applied per axis. |
-fx-background-size |
<bg-size> [, ...]* |
auto auto |
Dimensions for each background image. Supports cover, contain, stretch, or explicit sizes. |
| Property | Values | Default | Description |
|---|---|---|---|
-fx-border-color |
<paint> or <t> <r> <b> <l> [, ...]* |
null |
Paint colors for the border stroke layers. |
-fx-border-insets |
<size> or <t> <r> <b> <l> [, ...]* |
null |
Insets from region edges for each border layer. |
-fx-border-radius |
<size> [, ...]* |
null |
Corner radii for border stroke layers. |
-fx-border-style |
<border-style> [, ...]* |
null |
Border line style (solid, dotted, dashed) plus phase and line cap/join options per layer. |
-fx-border-width |
<size> or <t> <r> <b> <l> [, ...]* |
null |
Thickness of each border stroke layer, per side. |
| Property | Values | Default | Description |
|---|---|---|---|
-fx-border-image-source |
<uri> [, <uri>]* |
null |
Image URIs used to paint the border. |
-fx-border-image-insets |
<size> or <t> <r> <b> <l> [, ...]* |
0 0 0 0 |
Insets for each border image layer. |
-fx-border-image-repeat |
<repeat-style> [, ...]* |
repeat repeat |
Tiling behavior for each border image. |
-fx-border-image-slice |
<size> or <t> <r> <b> <l> [fill] [, ...]* |
100% |
Divides each border image into nine regions. Adding fill preserves the center region. |
-fx-border-image-width |
<size> or <t> <r> <b> <l> [, ...]* |
1 1 1 1 |
Width of each border image slice per side. |
| Property | Values | Default | Description |
|---|---|---|---|
-fx-padding |
<size> or <t> <r> <b> <l> |
0 0 0 0 |
Interior padding between the region border and its content. |
-fx-shape |
<string> |
null |
SVG path string that defines a custom clip shape for the region. |
-fx-scale-shape |
true | false |
true |
When true, the shape is scaled to fit the region. |
-fx-position-shape |
true | false |
true |
When true, the shape is centered within the region. |
-fx-snap-to-pixel |
true | false |
true |
When true, positions and sizes are rounded to whole pixel boundaries. |
-fx-min-width |
<size> |
-1 |
Minimum width. -1 uses the computed minimum. |
-fx-pref-width |
<size> |
-1 |
Preferred width. -1 uses the computed preferred. |
-fx-max-width |
<size> |
-1 |
Maximum width. -1 uses the computed maximum. |
-fx-min-height |
<size> |
-1 |
Minimum height. -1 uses the computed minimum. |
-fx-pref-height |
<size> |
-1 |
Preferred height. -1 uses the computed preferred. |
-fx-max-height |
<size> |
-1 |
Maximum height. -1 uses the computed maximum. |
| Property | Values | Default | Description |
|---|---|---|---|
-fx-blend-mode |
add | blue | color-burn | color-dodge | darken | difference | exclusion | green | hard-light | lighten | multiply | overlay | red | screen | soft-light | src-atop | src-in | src-out | src-over |
null |
Blend mode used when compositing this node with nodes beneath it. |
-fx-cursor |
null | crosshair | default | hand | move | e-resize | h-resize | ne-resize | nw-resize | n-resize | se-resize | sw-resize | s-resize | w-resize | v-resize | text | wait | <url> |
null (inherits) |
Mouse cursor shape shown when the pointer is over this node. Inherits from parent by default. |
-fx-effect |
<effect> |
null |
A visual effect (e.g. DropShadow, InnerShadow) applied to the rendered node. |
-fx-focus-traversable |
true | false |
false |
Whether this node participates in focus traversal via the keyboard Tab key. |
-fx-view-order |
<number> |
0 |
Adjusts rendering and hit-test order within the parent without changing the scene graph order. |
-fx-opacity |
<number> [0.0 - 1.0] |
1 |
Opacity of the node. 0 is fully transparent, 1 is fully opaque. |
-fx-rotate |
<number> |
0 |
Rotation angle in degrees applied around the node's center point. Positive values are clockwise. |
-fx-scale-x |
<number> |
1 |
Scale factor along the X axis about the node's center. |
-fx-scale-y |
<number> |
1 |
Scale factor along the Y axis about the node's center. |
-fx-scale-z |
<number> |
1 |
Scale factor along the Z axis about the node's center. |
-fx-translate-x |
<number> |
0 |
Translation offset along the X axis in pixels. |
-fx-translate-y |
<number> |
0 |
Translation offset along the Y axis in pixels. |
-fx-translate-z |
<number> |
0 |
Translation offset along the Z axis in pixels. |
visibility |
visible | hidden | collapse | inherit |
visible |
Controls whether the node is rendered and participates in layout. collapse removes it from layout; hidden keeps the space. |
-fx-managed |
true | false |
true |
When false, the parent layout does not manage this node's position or size. |
BorderPane ()
Creates a new BorderPane layout container.
this objectsetTop (object Node)
Sets the node placed in the top region of the border pane.
Node is the Node wrapper to install in the top slot, or null to clear it.this objectgetTop ()
Returns the node currently installed in the top region.
An AJO wrapping javafx.scene.Node, or null if none is set.topProperty ()
Returns the ObjectProperty backing the top region reference.
An AJO wrapping javafx.beans.property.ObjectPropertysetBottom (object Node)
Sets the node placed in the bottom region of the border pane.
Node is the Node wrapper to install in the bottom slot, or null to clear it.this objectgetBottom ()
Returns the node currently installed in the bottom region.
An AJO wrapping javafx.scene.Node, or null if none is set.bottomProperty ()
Returns the ObjectProperty backing the bottom region reference.
An AJO wrapping javafx.beans.property.ObjectPropertysetLeft (object Node)
Sets the node placed in the left region of the border pane.
Node is the Node wrapper to install in the left slot, or null to clear it.this objectgetLeft ()
Returns the node currently installed in the left region.
An AJO wrapping javafx.scene.Node, or null if none is set.leftProperty ()
Returns the ObjectProperty backing the left region reference.
An AJO wrapping javafx.beans.property.ObjectPropertysetRight (object Node)
Sets the node placed in the right region of the border pane.
Node is the Node wrapper to install in the right slot, or null to clear it.this objectgetRight ()
Returns the node currently installed in the right region.
An AJO wrapping javafx.scene.Node, or null if none is set.rightProperty ()
Returns the ObjectProperty backing the right region reference.
An AJO wrapping javafx.beans.property.ObjectPropertysetCenter (object Node)
Sets the node placed in the center region of the border pane.
Node is the Node wrapper to install in the center slot, or null to clear it.this objectgetCenter ()
Returns the node currently installed in the center region.
An AJO wrapping javafx.scene.Node, or null if none is set.centerProperty ()
Returns the ObjectProperty backing the center region reference.
An AJO wrapping javafx.beans.property.ObjectProperty
Aussom
Write once. Embed everywhere.
Copyright 2026 Austin Lehman. All rights reserved.