Struct moxie_dom::elements::forms::ButtonBuilder[][src]

#[must_use = "needs to be built"]pub struct ButtonBuilder { /* fields omitted */ }

The HTML <button> element represents a clickable button, which can be used in forms or anywhere in a document that needs simple, standard button functionality.

A type for initializing the element’s attributes before calling build.

Implementations

impl ButtonBuilder[src]

pub fn autofocus(self, to_set: bool) -> Self[src]

Specifies that the button should have input focus when the page loads. Only one element in a document can have this attribute.

pub fn disabled(self, to_set: bool) -> Self[src]

Prevents the user from interacting with the button: it cannot be pressed or focused.

pub fn form(self, to_set: impl ToString) -> Self[src]

The <form> element to associate the button with (its form owner). The value of this attribute must be the id of a <form> in the same document. (If this attribute is not set, the <button> is associated with its ancestor <form> element, if any.)

This attribute lets you associate <button> elements to <form>s anywhere in the document, not just inside a <form>. It can also override an ancestor <form> element.

pub fn formaction(self, to_set: impl ToString) -> Self[src]

The URL that processes the information submitted by the button. Overrides the action attribute of the button’s form owner. Does nothing if there is no form owner.

pub fn formenctype(self, to_set: impl ToString) -> Self[src]

If the button is a submit button (it’s inside/associated with a <form> and doesn’t have type=“button”), specifies how to encode the form data that is submitted. Possible values:

  • application/x-www-form-urlencoded: The default if the attribute is not used.
  • multipart/form-data: Use to submit <input> elements with their type attributes set to file.
  • text/plain: Specified as a debugging aid; shouldn’t be used for real form submission.

If this attribute is specified, it overrides the enctype attribute of the button’s form owner.

pub fn formmethod(self, to_set: impl ToString) -> Self[src]

If the button is a submit button (it’s inside/associated with a <form> and doesn’t have type=“button”), this attribute specifies the HTTP method used to submit the form. Possible values:

  • post: The data from the form are included in the body of the HTTP request when sent to the server. Use when the form contains information that shouldn’t be public, like login credentials.
  • get: The form data are appended to the form’s action URL, with a ? as a separator, and the resulting URL is sent to the server. Use this method when the form has no side effects, like search forms.

If specified, this attribute overrides the method attribute of the button’s form owner.

pub fn formnovalidate(self, to_set: bool) -> Self[src]

If the button is a submit button, specifies that the form is not to be validated when it is submitted. If this attribute is specified, it overrides the novalidate attribute of the button’s form owner.

This attribute is also available on <input type="image"> and <input type="submit"> elements.

pub fn formtarget(self, to_set: impl ToString) -> Self[src]

If the button is a submit button, this attribute is a author-defined name or standardized, underscore-prefixed keyword indicating where to display the response from submitting the form. This is the name of, or keyword for, a browsing context (a tab, window, or <iframe>). If this attribute is specified, it overrides the target attribute of the button’s form owner. The following keywords have special meanings:

  • _self: Load the response into the same browsing context as the current one. This is the default if the attribute is not specified.
  • _blank: Load the response into a new unnamed browsing context — usually a new tab or window, depending on the user’s browser settings.
  • _parent: Load the response into the parent browsing context of the current one. If there is no parent, this option behaves the same way as _self.
  • _top: Load the response into the top-level browsing context (that is, the browsing context that is an ancestor of the current one, and has no parent). If there is no parent, this option behaves the same way as _self.

pub fn name(self, to_set: impl ToString) -> Self[src]

The name of the button, submitted as a pair with the button’s value as part of the form data.

pub fn type_(self, to_set: impl ToString) -> Self[src]

The default behavior of the button. Possible values are:

  • submit: The button submits the form data to the server. This is the default if the attribute is not specified for buttons associated with a <form>, or if the attribute is an empty or invalid value.
  • reset: The button resets all the controls to their initial values, like <input type="reset">. (This behavior tends to annoy users.)
  • button: The button has no default behavior, and does nothing when pressed by default. It can have client-side scripts listen to the element’s events, which are triggered when the events occur.

pub fn value(self, to_set: impl ToString) -> Self[src]

Defines the value associated with the button’s name when it’s submitted with the form data. This value is passed to the server in params when the form is submitted.

Trait Implementations

impl ElementBuilder for ButtonBuilder[src]

impl<E> EventTarget<E> for ButtonBuilder where
    E: GlobalEvent
[src]

impl GlobalEventHandler for ButtonBuilder[src]

impl HtmlElementBuilder for ButtonBuilder[src]

impl NodeBuilder for ButtonBuilder[src]

type Output = Button

The type of the DOM node

fn build(self) -> Button[src]

Initialize the element with all of the attributes so far.

impl NodeWrapper for ButtonBuilder[src]

impl<Child> Parent<Child> for ButtonBuilder where
    Child: PhrasingContent
[src]

Auto Trait Implementations

impl !RefUnwindSafe for ButtonBuilder

impl !Send for ButtonBuilder

impl !Sync for ButtonBuilder

impl Unpin for ButtonBuilder

impl !UnwindSafe for ButtonBuilder

Blanket Implementations

impl<T> Any for T where
    T: 'static + ?Sized
[src]

impl<T> Borrow<T> for T where
    T: ?Sized
[src]

impl<T> BorrowMut<T> for T where
    T: ?Sized
[src]

impl<N> Child for N where
    N: NodeWrapper
[src]

impl<T> Downcast for T where
    T: Any

impl<T> Erased for T

impl<T> From<T> for T[src]

impl<T> Instrument for T[src]

impl<T, U> Into<U> for T where
    U: From<T>, 
[src]

impl<T, U> TryFrom<U> for T where
    U: Into<T>, 
[src]

type Error = Infallible

The type returned in the event of a conversion error.

impl<T, U> TryInto<U> for T where
    U: TryFrom<T>, 
[src]

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.