Skip to content

Box ​

A simple rectangle with optionally rounded corners. This can be useful to visually group parts of a layout, or as a placeholder.

Attributes ​

alignmode ​

Defaults to Inside()

The align mode of the rectangle in its parent GridLayout.

color ​

Defaults to RGBf(0.9, 0.9, 0.9)

The color of the rectangle.

julia
using CairoMakie
fig = Figure()
Box(fig[1, 1], color = :red)
Box(fig[1, 2], color = (:red, 0.5))
Box(fig[2, 1], color = RGBf(0.2, 0.5, 0.7))
Box(fig[2, 2], color = RGBAf(0.2, 0.5, 0.7, 0.5))
fig

cornerradius ​

Defaults to 0.0

The radius of the rounded corner. One number is for all four corners, four numbers for going clockwise from top-right.

julia
using CairoMakie
fig = Figure()
Box(fig[1, 1], cornerradius = 0)
Box(fig[1, 2], cornerradius = 20)
Box(fig[1, 3], cornerradius = (0, 10, 20, 30))
fig

halign ​

Defaults to :center

The horizontal alignment of the rectangle in its suggested boundingbox

height ​

Defaults to nothing

The height setting of the rectangle.

linestyle ​

Defaults to nothing

The linestyle of the rectangle border

julia
using CairoMakie
fig = Figure()
Box(fig[1, 1], linestyle = :solid)
Box(fig[1, 2], linestyle = :dot)
Box(fig[1, 3], linestyle = :dash)
fig

strokecolor ​

Defaults to RGBf(0, 0, 0)

The color of the border.

julia
using CairoMakie
fig = Figure()
Box(fig[1, 1], strokecolor = :red)
Box(fig[1, 2], strokecolor = (:red, 0.5))
Box(fig[2, 1], strokecolor = RGBf(0.2, 0.5, 0.7))
Box(fig[2, 2], strokecolor = RGBAf(0.2, 0.5, 0.7, 0.5))
fig

strokevisible ​

Defaults to true

Controls if the border of the rectangle is visible.

strokewidth ​

Defaults to 1.0

The line width of the rectangle's border.

julia
using CairoMakie
fig = Figure()
Box(fig[1, 1], strokewidth = 1)
Box(fig[1, 2], strokewidth = 10)
Box(fig[1, 3], strokewidth = 0)
fig

tellheight ​

Defaults to true

Controls if the parent layout can adjust to this element's height

tellwidth ​

Defaults to true

Controls if the parent layout can adjust to this element's width

valign ​

Defaults to :center

The vertical alignment of the rectangle in its suggested boundingbox

visible ​

Defaults to true

Controls if the rectangle is visible.

width ​

Defaults to nothing

The width setting of the rectangle.

z ​

Defaults to 0.0

Sets the z value of the Box