cascadess (version 0.1.0)

margin: Margins

Description

The margin() function adjusts the outer spacing of a tag element. The margin of a tag element is the space outside and around the tag element, its border, and its content.

Usage

margin(
  x,
  all = NULL,
  top = NULL,
  right = NULL,
  bottom = NULL,
  left = NULL,
  horizontal = NULL,
  vertical = NULL
)

Arguments

x

A tag element or .style pronoun.

all

A responsive argument.

One of -5:5 or "auto" specifying a margin for all sides of the tag element, defaults to NULL, in which case the argument is ignored. 0 removes all outer space, 5 adds the most space, and negative values will consume space and pull the element in that direction.

top, right, bottom, left

A responsive argument.

One of -5:5 or "auto" specifying a margin for the respective side of the tag element.

horizontal

A responsive argument.

One of -5:5 or "auto" specifying a margin for the left and right sides of the tag element.

vertical

A responsive argument.

One of -5:5 or "auto" specifying a margin for the top and bottom sides of the tag element.

Auto margins

In most modern browsers you want to horizontally center a tag element using the flex layout. Alternatively, you can horizontally center an element using margin(.., horizontal = "auto").

div(
  .style %>%
    margin(v = 2, h = "auto") %>%  # <-
    padding(3) %>%
    background("teal"),
  "Nam a sapien. Integer placerat tristique nisl."
)

Nam a sapien. Integer placerat tristique nisl.

Examples

# NOT RUN {
library(htmltools)

div(
  .style %>%
    margin(left = 3, right = 3),
  "Mauris mollis tincidunt felis."
)

div(
  .style %>%
    margin(horizontal = 3),
  "Nulla posuere."
)


div(
  .style %>%
    margin(l = 2, b = 1),
  "Sed bibendum."
)


div(
  .style %>%
    margin(h = "auto"),
  "Sed id ligula quis est convallis tempor."
)

# }