smail - v2.0.0

smail/style

This module provides all the CSS style properties that have been officially tested for email client compatibility. Using these functions is strongly recommended over raw attribute.style calls, as they handle unit conversions (such as rem to px) and ensure the properties work correctly across email clients.

For any property not covered here, attribute.style remains available as an escape hatch.

Values

background_color

</> 
pub fn background_color(value: String) -> attribute.Attribute

Sets the background colour of the element.

border

</> 
pub fn border(value: String) -> attribute.Attribute

Sets the border on all four sides of the element. Any rem values are automatically converted to px for maximum email client compatibility.

border_bottom

</> 
pub fn border_bottom(value: String) -> attribute.Attribute

Sets the border on the bottom side of the element. Any rem values are automatically converted to px for maximum email client compatibility.

border_collapse

</> 
pub fn border_collapse(value: String) -> attribute.Attribute

Sets how table borders are rendered. Common values are "collapse" and "separate".

border_left

</> 
pub fn border_left(value: String) -> attribute.Attribute

Sets the border on the left side of the element. Any rem values are automatically converted to px for maximum email client compatibility.

border_radius

</> 
pub fn border_radius(value: String) -> attribute.Attribute

Sets the rounding of the element’s corners. Any rem values are automatically converted to px for maximum email client compatibility.

Note: border-radius is not supported in Outlook.

border_right

</> 
pub fn border_right(value: String) -> attribute.Attribute

Sets the border on the right side of the element. Any rem values are automatically converted to px for maximum email client compatibility.

border_top

</> 
pub fn border_top(value: String) -> attribute.Attribute

Sets the border on the top side of the element. Any rem values are automatically converted to px for maximum email client compatibility.

color

</> 
pub fn color(value: String) -> attribute.Attribute

Sets the foreground color of the element’s text content.

Note: unlike standard email clients where color inheritance is unreliable, this library ensures the color cascades correctly to child elements.

direction

</> 
pub fn direction(value: String) -> attribute.Attribute

Sets the text direction for the element’s content. Common values are "ltr" (left-to-right) and "rtl" (right-to-left).

display

</> 
pub fn display(value: String) -> attribute.Attribute

Sets how the element is displayed. Common values are "block", "inline", "inline-block", and "none".

font_family

</> 
pub fn font_family(value: String) -> attribute.Attribute

Sets the font family for the element’s text. Multiple font names can be provided as a comma-separated fallback list, e.g. "Arial, sans-serif".

font_size

</> 
pub fn font_size(value: String) -> attribute.Attribute

Sets the size of the font. Any rem values are automatically converted to px for maximum email client compatibility.

font_style

</> 
pub fn font_style(value: String) -> attribute.Attribute

Sets the style of the font. Common values are "normal" and "italic".

font_weight

</> 
pub fn font_weight(value: String) -> attribute.Attribute

Sets the weight (boldness) of the font. Common values are "normal", "bold", or a numeric value such as "700".

height

</> 
pub fn height(value: String) -> attribute.Attribute

Sets the height of the element. Any rem values are automatically converted to px for maximum email client compatibility.

letter_spacing

</> 
pub fn letter_spacing(value: String) -> attribute.Attribute

Sets additional spacing between individual characters. Any rem values are automatically converted to px for maximum email client compatibility.

line_height

</> 
pub fn line_height(value: String) -> attribute.Attribute

Sets the height of a line of text. Any rem values are automatically converted to px for maximum email client compatibility.

margin

</> 
pub fn margin(value: String) -> attribute.Attribute

Sets the margin on all four sides of the element. Any rem values are automatically converted to px for maximum email client compatibility.

margin_bottom

</> 
pub fn margin_bottom(value: String) -> attribute.Attribute

Sets the margin on the bottom side of the element. Any rem values are automatically converted to px for maximum email client compatibility.

margin_left

</> 
pub fn margin_left(value: String) -> attribute.Attribute

Sets the margin on the left side of the element. Any rem values are automatically converted to px for maximum email client compatibility.

margin_right

</> 
pub fn margin_right(value: String) -> attribute.Attribute

Sets the margin on the right side of the element. Any rem values are automatically converted to px for maximum email client compatibility.

margin_top

</> 
pub fn margin_top(value: String) -> attribute.Attribute

Sets the margin on the top side of the element. Any rem values are automatically converted to px for maximum email client compatibility.

max_width

</> 
pub fn max_width(value: String) -> attribute.Attribute

Sets the maximum width of the element. Any rem values are automatically converted to px for maximum email client compatibility.

min_width

</> 
pub fn min_width(value: String) -> attribute.Attribute

Sets the minimum width of the element. Any rem values are automatically converted to px for maximum email client compatibility.

overflow

</> 
pub fn overflow(value: String) -> attribute.Attribute

Sets how content that overflows the element’s box is handled. Common values are "visible", "hidden", "scroll", and "auto".

padding

</> 
pub fn padding(value: String) -> attribute.Attribute

Sets the padding on all four sides of the element. Any rem values are automatically converted to px for maximum email client compatibility.

padding_bottom

</> 
pub fn padding_bottom(value: String) -> attribute.Attribute

Sets the padding on the bottom side of the element. Any rem values are automatically converted to px for maximum email client compatibility.

padding_left

</> 
pub fn padding_left(value: String) -> attribute.Attribute

Sets the padding on the left side of the element. Any rem values are automatically converted to px for maximum email client compatibility.

padding_right

</> 
pub fn padding_right(value: String) -> attribute.Attribute

Sets the padding on the right side of the element. Any rem values are automatically converted to px for maximum email client compatibility.

padding_top

</> 
pub fn padding_top(value: String) -> attribute.Attribute

Sets the padding on the top side of the element. Any rem values are automatically converted to px for maximum email client compatibility.

rem_to_px

</> 
pub fn rem_to_px(value: String) -> String

Converts rem values to px in a space-separated string of CSS values. Any token ending in rem is multiplied by 16 to produce its pixel equivalent. Tokens that are not rem values are left unchanged.

text_align

</> 
pub fn text_align(value: String) -> attribute.Attribute

Sets the horizontal alignment of inline content. Accepted values are "left", "right", "center", and "justify".

text_decoration

</> 
pub fn text_decoration(value: String) -> attribute.Attribute

Sets decorative lines on text. Common values are "none", "underline", "overline", and "line-through".

text_transform

</> 
pub fn text_transform(value: String) -> attribute.Attribute

Controls the capitalisation of text. Common values are "none", "uppercase", "lowercase", and "capitalize".

vertical_align

</> 
pub fn vertical_align(value: String) -> attribute.Attribute

Sets the vertical alignment of the element relative to its line box or table cell. Common values are "top", "middle", and "bottom".

white_space

</> 
pub fn white_space(value: String) -> attribute.Attribute

Sets how white space inside an element is handled. Common values are "normal", "nowrap", and "pre".

width

</> 
pub fn width(value: String) -> attribute.Attribute

Sets the width of the element. Any rem values are automatically converted to px for maximum email client compatibility.

word_break

</> 
pub fn word_break(value: String) -> attribute.Attribute

Controls how line breaks occur within words when they overflow their container. Common values are "normal", "break-all", and "keep-all".

word_wrap

</> 
pub fn word_wrap(value: String) -> attribute.Attribute

Controls whether the browser may break lines within words to prevent overflow. Common values are "normal" and "break-word".

✨ Search Document