Struct WElement 

pub struct WElement(/* private fields */);

Available on crate feature wasm only.

An HTML element, usable from JavaScript.

The builder methods consume and return the handle so they chain in JS exactly as they do in Rust:

const card = element("div").addClass("card").child(element("h1").text("Hi"));
card.render();  // '<div class="card"><h1>Hi</h1></div>'

Implementations

impl WElement

pub fn new(tag: &str) -> Self

Creates an element with the given tag name.

pub fn set_id(self, id: &str) -> Self

Sets id, replacing any existing one.

pub fn add_class(self, class_name: &str) -> Self

Appends a class name.

pub fn set_style(self, style: &str) -> Self

Sets style, replacing any existing one.

pub fn attr(self, key: &str, value: &str) -> Self

Appends an attribute, escaping the value.

URL attributes go through the same policy as Element::attr: a script URL renders as #.

pub fn trusted_url(self, key: &str, value: &str) -> Self

Replaces key with a URL written as given, even if it is a script URL.

The value is still attribute-escaped. Use this only for a URL the page author wrote.

pub fn bool_attr(self, key: &str) -> Self

Appends a boolean attribute, which renders as a bare key.

pub fn data_attr(self, key: &str, value: &str) -> Self

Appends data-{key}="{value}".

pub fn aria_attr(self, key: &str, value: &str) -> Self

Appends aria-{key}="{value}".

pub fn text(self, content: &str) -> Self

Sets the text content, escaping it.

pub fn raw_text(self, content: &str) -> Self

Sets the content without escaping it.

pub fn child(self, child: WElement) -> Self

Appends a child element. The child handle is consumed.

pub fn add_classes(self, classes: Vec<String>) -> Self

Appends several class names.

pub fn raw_child(self, markup: &str) -> Self

Appends markup without escaping it, as a child.

The element-level counterpart of rawText; like it, never pass user data.

pub fn self_closing(self, yes: bool) -> Self

Renders this element as <tag … /> (or <tag … > in HTML mode) with no content, even when the tag is not a void element.

pub fn comment(self, content: &str) -> Self

Appends an HTML comment as a child.

pub fn render(&self) -> String

Renders on a single line.

pub fn render_pretty(&self) -> String

Renders with indentation.

pub fn render_with_options( &self, pretty: bool, indent: &str, xhtml: bool, ) -> String

Renders with explicit options: pretty turns indentation on, indent is the string written per level, and xhtml closes void elements as <br />.

pub fn render_bytes(&self) -> Vec<u8>

Renders on a single line, as UTF-8 bytes, which spares Node a UTF-16 round trip.

Trait Implementations

impl Clone for WElement

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WElement

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

Formats the value using the given formatter.

impl From<WElement> for JsValue

fn from(value: WElement) -> Self

Converts to this type from the input type.

impl FromWasmAbi for WElement

type Abi = WasmPtr<WasmRefCell<WElement>>

The Wasm ABI type that this converts from when coming back out from the ABI boundary.

unsafe fn from_abi(js: Self::Abi) -> Self

Recover a Self from Self::Abi.

impl IntoWasmAbi for WElement

type Abi = WasmPtr<WasmRefCell<WElement>>

The Wasm ABI type that this converts into when crossing the ABI boundary.

fn into_abi(self) -> Self::Abi

Convert self into Self::Abi so that it can be sent across the wasm ABI boundary.

impl LongRefFromWasmAbi for WElement

type Abi = WasmPtr<WasmRefCell<WElement>>

Same as RefFromWasmAbi::Abi

type Anchor = RcRef<WElement>

Same as RefFromWasmAbi::Anchor

unsafe fn long_ref_from_abi(js: Self::Abi) -> Self::Anchor

Same as RefFromWasmAbi::ref_from_abi

impl OptionFromWasmAbi for WElement

fn is_none(abi: &Self::Abi) -> bool

Tests whether the argument is a “none” instance. If so it will be deserialized as None, and otherwise it will be passed to FromWasmAbi.

impl OptionIntoWasmAbi for WElement

fn none() -> Self::Abi

Returns an ABI instance indicating “none”, which JS will interpret as the None branch of this option.

impl RefFromWasmAbi for WElement

type Abi = WasmPtr<WasmRefCell<WElement>>

The Wasm ABI type references to Self are recovered from.

type Anchor = RcRef<WElement>

The type that holds the reference to Self for the duration of the invocation of the function that has an &Self parameter. This is required to ensure that the lifetimes don’t persist beyond one function call, and so that they remain anonymous.

unsafe fn ref_from_abi(js: Self::Abi) -> Self::Anchor

Recover a Self::Anchor from Self::Abi.

impl RefMutFromWasmAbi for WElement

type Abi = WasmPtr<WasmRefCell<WElement>>

Same as RefFromWasmAbi::Abi

type Anchor = RcRefMut<WElement>

Same as RefFromWasmAbi::Anchor

unsafe fn ref_mut_from_abi(js: Self::Abi) -> Self::Anchor

Same as RefFromWasmAbi::ref_from_abi

impl SupportsConstructor for WElement

impl SupportsInstanceProperty for WElement

impl SupportsStaticProperty for WElement

impl TryFromJsValue for WElement

fn try_from_js_value(value: JsValue) -> Result<Self, JsValue>

Performs the conversion.

fn try_from_js_value_ref(value: &JsValue) -> Option<Self>

Performs the conversion.

impl VectorFromWasmAbi for WElement

type Abi = <Box<[JsValue]> as FromWasmAbi>::Abi

unsafe fn vector_from_abi(js: Self::Abi) -> Box<[WElement]>

impl VectorIntoWasmAbi for WElement

type Abi = <Box<[JsValue]> as IntoWasmAbi>::Abi

fn vector_into_abi(vector: Box<[WElement]>) -> Self::Abi

impl WasmDescribe for WElement

fn describe()

impl WasmDescribeVector for WElement

fn describe_vector()