Struct stdweb::web::html_element::SelectElement

pub struct SelectElement(_);

The HTML <select> element represents a control that provides a menu of options.

(JavaScript docs)

Methods

impl SelectElement

pub fn raw_value(&self) -> String

Returns the value attribute of the first selected <option> element or if it is missing, the text attribute. If there is no selection, return empty string. This method is just a wrapper for getting HTMLSelectElement.value directly

pub fn set_raw_value(&self, value: &str)

Set the given value to HTMLSelectElement.value directly.

pub fn selected_index(&self) -> Option<u32>

Returns the Some(index) of the first selected item, if any, or None if there is no selected item.

pub fn set_selected_index(&self, selected_index: Option<u32>)

Change selected index to the given value.

pub fn value(&self) -> Option<String>

Returns the Some(value) of the first selected item, if any, or None if there is no selected item.

pub fn set_value(&self, value: Option<&str>) -> Result<(), UnknownValueError>

Change the selected value to the given value. If you provide an invalid value, the <select> element will have no item selected, and an UnknownValueError is returned.

pub fn multiple(&self) -> bool

Indicates whether multiple items can be selected

pub fn selected_options(&self) -> HtmlCollection

An HtmlCollection representing the set of <option> elements that are selected.

pub fn selected_values(&self) -> Vec<String>

A convenience method to get values of all selected <option> elements

pub fn selected_indices(&self) -> Vec<i32>

A convenience method to get indices of all selected <option> elements

Trait Implementations

impl JsSerialize for SelectElement

impl TryFrom<EventTarget> for SelectElement

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from(value: EventTarget) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Node> for SelectElement

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from(value: Node) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Element> for SelectElement

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from(value: Element) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<HtmlElement> for SelectElement

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from(value: HtmlElement) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<SelectElement> for Reference

type Error = Void

The type returned in the event of a conversion error.

fn try_from(value: SelectElement) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Reference> for SelectElement

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from(reference: Reference) -> Result<Self, Self::Error>

Performs the conversion.

impl<'_r> TryFrom<&'_r Reference> for SelectElement

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from(reference: &Reference) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Value> for SelectElement

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from(value: Value) -> Result<Self, Self::Error>

Performs the conversion.

impl<'_r> TryFrom<&'_r Value> for SelectElement

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from(value: &Value) -> Result<Self, Self::Error>

Performs the conversion.

impl InstanceOf for SelectElement

fn instance_of(reference: &Reference) -> bool

Checks whenever a given Reference if of type Self.

impl ReferenceType for SelectElement

unsafe fn from_reference_unchecked(reference: Reference) -> Self

Converts a given reference into a concrete reference-like wrapper. Doesn't do any type checking; highly unsafe to use!

impl IEventTarget for SelectElement

fn add_event_listener<T, F>(&self, listener: F) -> EventListenerHandle where
    T: ConcreteEvent,
    F: FnMut(T) + 'static, 

Adds given event handler to the list of event listeners for the specified EventTarget on which it's called.

fn dispatch_event<T: IEvent>(&self, event: &T) -> Result<bool, TODO>

Dispatches an Event at this EventTarget, invoking the affected event listeners in the appropriate order.

impl INode for SelectElement

fn as_node(&self) -> &Node

Casts a reference to this object into a reference to a Node.

fn append_child<T: INode>(&self, child: &T)

Adds a node to the end of the list of children of a specified parent node.

fn remove_child<T: INode>(&self, child: &T) -> Result<Node, NotFoundError>

Removes a child node from the DOM.

fn clone_node(&self, kind: CloneKind) -> Result<Self, TODO>

Returns a duplicate of the node on which this method was called.

fn contains<T: INode>(&self, node: &T) -> bool

Checks whenever a given node is a descendant of this one or not.

fn insert_before<T: INode, U: INode>(
    &self,
    new_node: &T,
    reference_node: &U
) -> Result<Node, InsertNodeError>

Inserts the specified node before the reference node as a child of the current node.

fn replace_child<T: INode, U: INode>(
    &self,
    new_child: &T,
    old_child: &U
) -> Result<Node, InsertNodeError>

Replaces one hild node of the specified node with another.

fn parent_node(&self) -> Option<Node>

Returns the parent of this node in the DOM tree.

fn first_child(&self) -> Option<Node>

Returns the node's first child in the tree, or None if the node is childless.

fn last_child(&self) -> Option<Node>

Returns the node's last child in the tree, or None if the node is childless.

fn next_sibling(&self) -> Option<Node>

Returns the node's next sibling in the tree, or None if there isn't such a node.

fn node_name(&self) -> String

Returns the name of the node.

fn node_type(&self) -> NodeType

Returns the type of the node.

fn node_value(&self) -> Option<String>

Returns the value of the node.

fn set_node_value(&self, value: Option<&str>)

Sets the value of the node.

fn owner_document(&self) -> Option<Document>

Returns the Document that this node belongs to.

fn parent_element(&self) -> Option<Element>

Returns an Element that is the parent of this node. Returns null if the node has no parent or the parent is not an Element.

fn previous_sibling(&self) -> Option<Node>

Returns the node's previous sibling in the tree, or None if there isn't such a node.

fn text_content(&self) -> Option<String>

A property which represents the text content of a node and its descendants.

fn set_text_content(&self, text: &str)

Sets the text content of this node; calling thil removes all of node's children and replaces them with a single text node with the given value.

fn child_nodes(&self) -> NodeList

Returns a live collection of child nodes of this node.

fn base_uri(&self) -> String

Gets the base URL.

fn has_child_nodes(&self) -> bool

Returns whether this node has children nodes.

fn is_default_namespace(&self, namespace: &str) -> bool

Determines whether the given namespace is the default namespace of this node.

fn is_equal_node<T: INode>(&self, node: &T) -> bool

Tests whether this node is equal to another node. Two nodes are equal if they have the same type, defining characteristics, matching attributes, and so on.

fn is_same_node<T: INode>(&self, node: &T) -> bool

Test whether two Node references are the same.

fn lookup_prefix(&self, namespace: &str) -> Option<String>

Returns the prefix for the given namespace URI, if present.

fn lookup_namespace_uri(&self, prefix: &str) -> Option<String>

Returns the namespace URI for the given prefix.

fn normalize(&self)

Merges any adjacent text nodes and removes empty text nodes under this node.

impl IElement for SelectElement

fn namespace_uri(&self) -> Option<String>

The Element.namespaceURI read-only property returns the namespace URI of the element, or null if the element is not in a namespace.

fn class_list(&self) -> TokenList

The Element.classList is a read-only property which returns a live TokenList collection of the class attributes of the element.

fn has_attribute(&self, name: &str) -> bool

The Element.hasAttribute() method returns a Boolean value indicating whether the specified element has the specified attribute or not.

fn get_attribute(&self, name: &str) -> Option<String>

Element.getAttribute() returns the value of a specified attribute on the element. If the given attribute does not exist, the value returned will either be null or "" (the empty string);

fn set_attribute(
    &self,
    name: &str,
    value: &str
) -> Result<(), InvalidCharacterError>

Sets the value of an attribute on the specified element. If the attribute already exists, the value is updated; otherwise a new attribute is added with the specified name and value.

fn scroll_top(&self) -> f64

Gets the the number of pixels that an element's content is scrolled vertically.

fn set_scroll_top(&self, value: f64)

Sets the the number of pixels that an element's content is scrolled vertically.

fn scroll_left(&self) -> f64

Gets the the number of pixels that an element's content is scrolled to the left.

fn set_scroll_left(&self, value: f64)

Sets the the number of pixels that an element's content is scrolled to the left.

fn get_attribute_names(&self) -> Vec<String>

Element.getAttributeNames() returns the attribute names of the element as an Array of strings. If the element has no attributes it returns an empty array.

fn remove_attribute(&self, name: &str)

Element.removeAttribute removes an attribute from the specified element.

fn has_attributes(&self) -> bool

The Element.hasAttributes() method returns Boolean value, indicating if the current element has any attributes or not.

fn closest(&self, selectors: &str) -> Result<Option<Element>, SyntaxError>

Returns the closest ancestor of the element (or the element itself) which matches the selectors given in parameter. If there isn't such an ancestor, it returns None.

fn set_pointer_capture(&self, pointer_id: i32) -> Result<(), InvalidPointerId>

Designates a specific element as the capture target of future pointer events.

fn release_pointer_capture(
    &self,
    pointer_id: i32
) -> Result<(), InvalidPointerId>

Releases pointer capture that was previously set for a specific pointer

fn has_pointer_capture(&self, pointer_id: i32) -> bool

Returns a boolean indicating if the element has captured the specified pointer

fn insert_adjacent_html(
    &self,
    position: InsertPosition,
    html: &str
) -> Result<(), InsertAdjacentError>

Insert nodes from HTML fragment into specified position.

fn insert_html_before(&self, html: &str) -> Result<(), InsertAdjacentError>

Insert nodes from HTML fragment before element.

fn prepend_html(&self, html: &str) -> Result<(), InsertAdjacentError>

Insert nodes from HTML fragment as the first children of the element.

fn append_html(&self, html: &str) -> Result<(), InsertAdjacentError>

Insert nodes from HTML fragment as the last children of the element.

fn insert_html_after(&self, html: &str) -> Result<(), InsertAdjacentError>

Insert nodes from HTML fragment after element.

fn slot(&self) -> String

The slot property of the Element interface returns the name of the shadow DOM slot the element is inserted in.

fn attach_shadow(
    &self,
    mode: ShadowRootMode
) -> Result<ShadowRoot, AttachShadowError>

Attach a shadow DOM tree to the specified element and returns a reference to its ShadowRoot. It returns a shadow root if successfully attached or None if the element cannot be attached.

fn shadow_root(&self) -> Option<ShadowRoot>

Returns the shadow root of the current element or None.

impl IHtmlElement for SelectElement

fn focus(&self)

Sets focus on the specified element, if it can be focused.

fn blur(&self)

Removes keyboard focus from the current element.

fn dataset(&self) -> StringMap

Allows access, both in reading and writing, to all of the custom data attributes (data-*) set on the element, either in HTML or in the DOM.

fn get_bounding_client_rect(&self) -> Rect

Returns the size of an element and its position relative to the viewport. (JavaScript docs)

fn offset_width(&self) -> i32

Returns the layout width of an element. Typically, an element's offsetWidth is a measurement which includes the element borders, the element horizontal padding, the element vertical scrollbar (if present, if rendered) and the element CSS width.

fn offset_height(&self) -> i32

Returns the height of the element including vertical padding and borders, as an integer.

fn inner_text(&self) -> String

A property which represents the "rendered" text content of a node and its descendants. It approximates the text the user would get if they highlighted the contents of the element with the cursor and then copied to the clipboard.

impl AsRef<Reference> for SelectElement

fn as_ref(&self) -> &Reference

Performs the conversion.

impl From<SelectElement> for EventTarget

fn from(value: SelectElement) -> Self

Performs the conversion.

impl From<SelectElement> for Node

fn from(value: SelectElement) -> Self

Performs the conversion.

impl From<SelectElement> for Element

fn from(value: SelectElement) -> Self

Performs the conversion.

impl From<SelectElement> for HtmlElement

fn from(value: SelectElement) -> Self

Performs the conversion.

impl From<SelectElement> for Reference

fn from(value: SelectElement) -> Self

Performs the conversion.

impl Clone for SelectElement

fn clone(&self) -> SelectElement

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Eq for SelectElement

impl PartialEq<SelectElement> for SelectElement

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl Debug for SelectElement

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

Formats the value using the given formatter.