Struct Element

pub struct Element;

A basic element with no interactivity.

An element has no children and no special rendering logic. It can be used to render a rectangle, a line or a circle using view styling rules.

Examples

Element without visible styling

An element can be used without visible styling which displays nothing at all. This is useful to create an invisible spacer between other views.

Element::new(cx)
    .width(Pixels(100.0))
    .height(Pixels(100.0));

Element as a rectangle

An element can be used to display a rectangle like this black one with a size of 100 by 100 pixels.

Element::new(cx)
    .width(Pixels(100.0))
    .height(Pixels(100.0))
    .background_color(Color::black());

Element as a line

An element can be used to display a line like this black one with a size of 100 by 1 pixels.

Element::new(cx)
     .width(Pixels(100.0))
     .height(Pixels(1.0))
     .background_color(Color::black());

Element as a circle

An element can be used to display a circle like this black one with a diameter of 100 pixels. To create a perfect circle the width and height of the element have to be equal and the border radius has to be set to fifty percent.

Element::new(cx)
    .width(Pixels(100.0))
    .height(Pixels(100.0))
    .border_radius(Percentage(50.0))
    .background_color(Color::black());

Element as an image

An element can be used to display an image like this 100 by 100 pixels one. The image can be set by using a stylesheet or by using a lens. The image has to be loaded manually by using the Context::load_image method.

Element::new(cx)
    .width(Pixels(100.0))
    .height(Pixels(100.0));

Implementations

impl Element

pub fn new(cx: &mut Context) -> Handle<'_, Element>

Creates a new element.

Examples

Element::new(cx);

Trait Implementations

impl View for Element

fn element(&self) -> Option<&'static str>

Specifies a name for the view type which can be used as an element selector in css.

fn build<F>(self, cx: &mut Context, content: F) -> Handle<'_, Self>

where F: FnOnce(&mut Context),

Builds the view into the tree and returns a handle which can be used to apply style and layout modifiers to the view.

fn event(&mut self, cx: &mut EventContext<'_>, event: &mut Event)

Handles any events received by the view.

fn draw(&self, cx: &mut DrawContext<'_>, canvas: &Canvas)

Provides custom drawing for the view.

fn accessibility(&self, cx: &mut AccessContext<'_>, node: &mut AccessNode)