Struct SquareElem

pub struct SquareElem { /* private fields */ }

A square with optional content.

Example

// Without content.
#square(size: 40pt)

// With content.
#square[
  Automatically \
  sized to fit.
]

Implementations

impl SquareElem

pub fn new() -> Self

Create a new instance of the element.

pub fn with_width(self, width: Smart<Rel<Length>>) -> Self

Builder-style setter for the width field.

pub fn with_height(self, height: Sizing) -> Self

Builder-style setter for the height field.

pub fn with_fill(self, fill: Option<Paint>) -> Self

Builder-style setter for the fill field.

pub fn with_stroke(self, stroke: Smart<Sides<Option<Option<Stroke>>>>) -> Self

Builder-style setter for the stroke field.

pub fn with_radius(self, radius: Corners<Option<Rel<Length>>>) -> Self

Builder-style setter for the radius field.

pub fn with_inset(self, inset: Sides<Option<Rel<Length>>>) -> Self

Builder-style setter for the inset field.

pub fn with_outset(self, outset: Sides<Option<Rel<Length>>>) -> Self

Builder-style setter for the outset field.

pub fn with_body(self, body: Option<Content>) -> Self

Builder-style setter for the body field.

pub fn push_width(&mut self, width: Smart<Rel<Length>>)

Setter for the width field.

pub fn push_height(&mut self, height: Sizing)

Setter for the height field.

pub fn push_fill(&mut self, fill: Option<Paint>)

Setter for the fill field.

pub fn push_stroke(&mut self, stroke: Smart<Sides<Option<Option<Stroke>>>>)

Setter for the stroke field.

pub fn push_radius(&mut self, radius: Corners<Option<Rel<Length>>>)

Setter for the radius field.

pub fn push_inset(&mut self, inset: Sides<Option<Rel<Length>>>)

Setter for the inset field.

pub fn push_outset(&mut self, outset: Sides<Option<Rel<Length>>>)

Setter for the outset field.

pub fn push_body(&mut self, body: Option<Content>)

Setter for the body field.

pub fn width(&self, styles: StyleChain<'_>) -> Smart<Rel<Length>>

The square’s width. This is mutually exclusive with size and height.

In contrast to size, this can be relative to the parent container’s width.

pub fn height(&self, styles: StyleChain<'_>) -> Sizing

The square’s height. This is mutually exclusive with size and width.

In contrast to size, this can be relative to the parent container’s height.

pub fn fill(&self, styles: StyleChain<'_>) -> Option<Paint>

How to fill the square. See the rectangle’s documentation for more details.

pub fn stroke( &self, styles: StyleChain<'_>, ) -> <Smart<Sides<Option<Option<Stroke>>>> as Resolve>::Output

How to stroke the square. See the rectangle’s documentation for more details.

pub fn radius( &self, styles: StyleChain<'_>, ) -> <Corners<Option<Rel<Length>>> as Resolve>::Output

How much to round the square’s corners. See the rectangle’s documentation for more details.

pub fn inset( &self, styles: StyleChain<'_>, ) -> <Sides<Option<Rel<Length>>> as Resolve>::Output

How much to pad the square’s content. See the box’s documentation for more details.

pub fn outset( &self, styles: StyleChain<'_>, ) -> <Sides<Option<Rel<Length>>> as Resolve>::Output

How much to expand the square’s size without affecting the layout. See the box’s documentation for more details.

pub fn body<'a>(&'a self, styles: StyleChain<'a>) -> &'a Option<Content>

The content to place into the square. The square expands to fit this content, keeping the 1-1 aspect ratio.

When this is omitted, the square takes on a default size of at most {30pt}.

pub fn width_in(styles: StyleChain<'_>) -> Smart<Rel<Length>>

Access the width field in the given style chain.

pub fn height_in(styles: StyleChain<'_>) -> Sizing

Access the height field in the given style chain.

pub fn fill_in(styles: StyleChain<'_>) -> Option<Paint>

Access the fill field in the given style chain.

pub fn stroke_in( styles: StyleChain<'_>, ) -> <Smart<Sides<Option<Option<Stroke>>>> as Resolve>::Output

Access the stroke field in the given style chain.

pub fn radius_in( styles: StyleChain<'_>, ) -> <Corners<Option<Rel<Length>>> as Resolve>::Output

Access the radius field in the given style chain.

pub fn inset_in( styles: StyleChain<'_>, ) -> <Sides<Option<Rel<Length>>> as Resolve>::Output

Access the inset field in the given style chain.

pub fn outset_in( styles: StyleChain<'_>, ) -> <Sides<Option<Rel<Length>>> as Resolve>::Output

Access the outset field in the given style chain.

pub fn body_in(styles: StyleChain<'_>) -> &Option<Content>

Access the body field in the given style chain.

pub fn set_width(width: Smart<Rel<Length>>) -> Property

Create a style property for the width field.

pub fn set_height(height: Sizing) -> Property

Create a style property for the height field.

pub fn set_fill(fill: Option<Paint>) -> Property

Create a style property for the fill field.

pub fn set_stroke(stroke: Smart<Sides<Option<Option<Stroke>>>>) -> Property

Create a style property for the stroke field.

pub fn set_radius(radius: Corners<Option<Rel<Length>>>) -> Property

Create a style property for the radius field.

pub fn set_inset(inset: Sides<Option<Rel<Length>>>) -> Property

Create a style property for the inset field.

pub fn set_outset(outset: Sides<Option<Rel<Length>>>) -> Property

Create a style property for the outset field.

pub fn set_body(body: Option<Content>) -> Property

Create a style property for the body field.

Trait Implementations

impl Capable for SquareElem

fn vtable(capability: TypeId) -> Option<NonNull<()>>

Get the pointer to the vtable for the given capability / trait.

impl Clone for SquareElem

fn clone(&self) -> SquareElem

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Construct for SquareElem

fn construct(engine: &mut Engine<'_>, args: &mut Args) -> SourceResult<Content>

Construct an element from the arguments.

impl Debug for SquareElem

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Fields for SquareElem

type Enum = Fields

An enum with the fields of the element.

fn has(&self, id: u8) -> bool

Whether the element has the given field set.

fn field(&self, id: u8) -> Result<Value, FieldAccessError>

Get the field with the given field ID.

fn field_with_styles( &self, id: u8, styles: StyleChain<'_>, ) -> Result<Value, FieldAccessError>

Get the field with the given ID in the presence of styles.

fn field_from_styles( id: u8, styles: StyleChain<'_>, ) -> Result<Value, FieldAccessError>

Get the field with the given ID from the styles.

fn materialize(&mut self, styles: StyleChain<'_>)

Resolve all fields with the styles and save them in-place.

fn fields(&self) -> Dict

Get the fields of the element.

impl Hash for SquareElem

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl IntoValue for SquareElem

fn into_value(self) -> Value

Cast this type into a value.

impl NativeElement for SquareElem

fn data() -> &'static NativeElementData

Get the element data for the native Rust element.

fn elem() -> Element

where Self: Sized,

Get the element for the native Rust element.

fn pack(self) -> Content

where Self: Sized,

Pack the element into type-erased content.

impl PartialEq for SquareElem

fn eq(&self, other: &Self) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Repr for SquareElem

fn repr(&self) -> EcoString

Return the debug representation of the value.

impl Set for SquareElem

fn set(engine: &mut Engine<'_>, args: &mut Args) -> SourceResult<Styles>

Parse relevant arguments into style properties for this element.