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.