Struct ItemStyle 

pub struct ItemStyle {

    pub w: Option<Length>,
    pub h: Option<Length>,
    pub min_w: Option<Length>,
    pub min_h: Option<Length>,
    pub max_w: Option<Length>,
    pub max_h: Option<Length>,
    pub grow: Option<f32>,
    pub shrink: Option<f32>,
    pub basis: Option<Length>,
    pub align_self: Option<AlignSelf>,
    pub m: Option<Length>,
    pub mx: Option<Length>,
    pub my: Option<Length>,
    pub mt: Option<Length>,
    pub mr: Option<Length>,
    pub mb: Option<Length>,
    pub ml: Option<Length>,
    pub p: Option<Length>,
    pub px: Option<Length>,
    pub py: Option<Length>,
    pub pt: Option<Length>,
    pub pr: Option<Length>,
    pub pb: Option<Length>,
    pub pl: Option<Length>,
    pub col_span: Option<u16>,
    pub row_span: Option<u16>,
    pub paint: PaintStyle,
}

The layout attributes every element accepts, as a flex/grid item.

Every setter takes impl Into<Length>, so .w(120.0), .w("50%") and .w(Length::Auto) all work; rsx! passes literals straight through.

It carries the item’s PaintStyle too, reached through setters of the same names (.bg(..), .border(..)), so one prop is the whole vocabulary.

Fields

w: Option<Length>

width.

h: Option<Length>

height.

min_w: Option<Length>

min-width.

min_h: Option<Length>

min-height.

max_w: Option<Length>

max-width.

max_h: Option<Length>

max-height.

grow: Option<f32>

flex-grow.

shrink: Option<f32>

flex-shrink.

basis: Option<Length>

flex-basis.

align_self: Option<AlignSelf>

align-self.

m: Option<Length>

margin (all sides).

mx: Option<Length>

margin-inline.

my: Option<Length>

margin-block.

mt: Option<Length>

margin-top.

mr: Option<Length>

margin-right.

mb: Option<Length>

margin-bottom.

ml: Option<Length>

margin-left.

p: Option<Length>

padding (all sides).

px: Option<Length>

padding-inline.

py: Option<Length>

padding-block.

pt: Option<Length>

padding-top.

pr: Option<Length>

padding-right.

pb: Option<Length>

padding-bottom.

pl: Option<Length>

padding-left.

col_span: Option<u16>

grid-column: span N.

row_span: Option<u16>

grid-row: span N.

paint: PaintStyle

How the box looks: background, border, radius, shadow, opacity.

Implementations

impl ItemStyle

pub fn w(self, v: impl Into<Length>) -> Self

Set width.

pub fn h(self, v: impl Into<Length>) -> Self

Set height.

pub fn min_w(self, v: impl Into<Length>) -> Self

Set min-width.

pub fn min_h(self, v: impl Into<Length>) -> Self

Set min-height.

pub fn max_w(self, v: impl Into<Length>) -> Self

Set max-width.

pub fn max_h(self, v: impl Into<Length>) -> Self

Set max-height.

pub fn basis(self, v: impl Into<Length>) -> Self

Set flex-basis.

pub fn m(self, v: impl Into<Length>) -> Self

Set the margin on all four sides.

pub fn mx(self, v: impl Into<Length>) -> Self

Set the left and right margin.

pub fn my(self, v: impl Into<Length>) -> Self

Set the top and bottom margin.

pub fn mt(self, v: impl Into<Length>) -> Self

Set the top margin.

pub fn mr(self, v: impl Into<Length>) -> Self

Set the right margin.

pub fn mb(self, v: impl Into<Length>) -> Self

Set the bottom margin.

pub fn ml(self, v: impl Into<Length>) -> Self

Set the left margin.

pub fn p(self, v: impl Into<Length>) -> Self

Set the padding on all four sides.

pub fn px(self, v: impl Into<Length>) -> Self

Set the left and right padding.

pub fn py(self, v: impl Into<Length>) -> Self

Set the top and bottom padding.

pub fn pt(self, v: impl Into<Length>) -> Self

Set the top padding.

pub fn pr(self, v: impl Into<Length>) -> Self

Set the right padding.

pub fn pb(self, v: impl Into<Length>) -> Self

Set the bottom padding.

pub fn pl(self, v: impl Into<Length>) -> Self

Set the left padding.

pub fn grow(self, v: f32) -> Self

Set flex-grow.

pub fn shrink(self, v: f32) -> Self

Set flex-shrink.

pub fn align_self(self, v: impl Into<AlignSelf>) -> Self

Set align-self.

pub fn col_span(self, v: u16) -> Self

Set how many grid columns this item spans.

pub fn row_span(self, v: u16) -> Self

Set how many grid rows this item spans.

pub fn bg(self, v: impl Into<Color32>) -> Self

Set the background colour. See PaintStyle::bg.

pub fn border(self, v: impl Into<Stroke>) -> Self

Set the border stroke. See PaintStyle::border.

pub fn radius(self, v: f32) -> Self

Set the corner radius. See PaintStyle::radius.

pub fn shadow(self, v: bool) -> Self

Cast the theme’s window shadow. See PaintStyle::shadow.

pub fn custom_shadow(self, v: Shadow) -> Self

Cast a shadow of your own. See PaintStyle::custom_shadow.

pub fn opacity(self, v: f32) -> Self

Multiply the opacity of this node. See PaintStyle::opacity.

pub fn padding_px(&self) -> Option<[f32; 4]>

The padding this item asks for, in points, if it asked for any.

[top, right, bottom, left], resolved most-specific-wins exactly as ItemStyle::to_taffy resolves it. None when no padding prop is set — there is nothing to take over — and when any side is a percentage or auto, because those need the containing block, which only the layout has.

This is for an element that hands its padding to the widget rather than to the layout: <Button> does, so that the hover frame and the click area cover the whole box, and <Frame> does outside a tree, where there is no layout to hold it.

pub fn without_padding(self) -> Self

This style with every padding prop cleared.

The other half of ItemStyle::padding_px: an element that took the padding over passes this to cx.leaf, so the layout does not reserve the same points a second time.

pub fn to_taffy(&self) -> Style

The taffy style of this item, with container properties left default.

Trait Implementations

impl Clone for ItemStyle

fn clone(&self) -> ItemStyle

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ItemStyle

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

Formats the value using the given formatter.

impl Default for ItemStyle

fn default() -> ItemStyle

Returns the “default value” for a type.

impl PartialEq for ItemStyle

fn eq(&self, other: &ItemStyle) -> 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 Copy for ItemStyle

impl StructuralPartialEq for ItemStyle