Skip to contents

X-axis options

Usage

ax_xaxis(
  ax,
  type = NULL,
  categories = NULL,
  labels = NULL,
  axisBorder = NULL,
  axisTicks = NULL,
  tickAmount = NULL,
  min = NULL,
  max = NULL,
  range = NULL,
  floating = NULL,
  position = NULL,
  title = NULL,
  crosshairs = NULL,
  tooltip = NULL,
  ...
)

Arguments

ax

An apexchart() htmlwidget object.

type

Character. Available Options : "categories" and "datetime".

categories

Categories are labels which are displayed on the x-axis.

labels

A list of parameters.

axisBorder

A list of parameters.

axisTicks

A list of parameters.

tickAmount

Number of Tick Intervals to show.

min

Lowest number to be set for the x-axis. The graph drawing beyond this number will be clipped off.

max

Highest number to be set for the x-axis. The graph drawing beyond this number will be clipped off.

range

Range takes the max value of x-axis, subtracts the provided range value and gets the min value based on that. So, technically it helps to keep the same range when min and max values gets updated dynamically.

floating

Logical. Floating takes x-axis is taken out of normal flow and places x-axis on svg element directly, similar to an absolutely positioned element. Set the offsetX and offsetY then to adjust the position manually

position

Setting this option allows you to change the x-axis position. Available options: "top" and "bottom".

title

A list of parameters.

crosshairs

A list of parameters.

tooltip

A list of parameters.

...

Additional parameters.

Value

An apexchart()

htmlwidget object.

Examples

data("mpg", package = "ggplot2")

# X axis title
apex(
  data = mpg,
  mapping = aes(x = manufacturer)
) %>% 
  ax_xaxis(title = list(text = "Car's manufacturer"))
# force labels to rotate and increase height apex( data = mpg, mapping = aes(x = manufacturer) ) %>% ax_xaxis(labels = list(rotateAlways = TRUE, maxHeight = 180))
# force to not rotate apex( data = mpg, mapping = aes(x = manufacturer) ) %>% ax_xaxis(labels = list(rotate = 0, trim = FALSE))
data("economics", package = "ggplot2") # Custom crosshair apex( data = tail(economics, 50), mapping = aes(x = date, y = psavert), type = "line" ) %>% ax_xaxis( crosshairs = list( opacity = 1, width = 2, fill = list(color = "red"), stroke = list(width = 0) ) )
# Date format (zoom to see changes) apex( data = tail(economics, 150), mapping = aes(x = date, y = psavert), type = "line" ) %>% ax_xaxis( labels = list( datetimeFormatter = list( year = "yyyy-MM", month = "yyyy-MM-dd", day = "yyyy-MM-dd HH:mm" ) ) )