Struct html_tags::ButtonOwned
source · pub struct ButtonOwned {Show 28 fields
pub accesskey: Option<String>,
pub autocapitalize: Option<String>,
pub autocomplete: Option<String>,
pub autofocus: Option<bool>,
pub class: Option<String>,
pub contenteditable: Option<String>,
pub contextmenu: Option<String>,
pub data: Option<BTreeMap<String, String>>,
pub dir: Option<String>,
pub disabled: Option<bool>,
pub draggable: Option<String>,
pub enterkeyhint: Option<String>,
pub exportparts: Option<String>,
pub extra: Option<BTreeMap<String, String>>,
pub form: Option<String>,
pub formaction: Option<String>,
pub formenctype: Option<String>,
pub formmethod: Option<String>,
pub formnovalidate: Option<bool>,
pub formtarget: Option<String>,
pub hidden: Option<bool>,
pub id: Option<String>,
pub inert: Option<String>,
pub inputmode: Option<String>,
pub is: Option<String>,
pub name: Option<String>,
pub type_: Option<String>,
pub value: Option<String>,
}
Expand description
The <button>
HTML element is an interactive element activated by a user with a mouse, keyboard, finger, voice command, or other assistive technology. Once activated, it then performs an action, such as submitting a form or opening a dialog.
By default, HTML buttons are presented in a style resembling the platform the user agent runs on, but you can change buttons’ appearance with CSS.
More information: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/button
Fields§
§accesskey: Option<String>
Provides a hint for generating a keyboard shortcut for the current element. This attribute consists of a space-separated list of characters. The browser should use the first one that exists on the computer keyboard layout.
autocapitalize: Option<String>
Controls whether and how text input is automatically capitalized as it is entered/edited by the user. It can have the following values:
off
ornone
, no autocapitalization is applied (all letters default to lowercase)on
orsentences
, the first letter of each sentence defaults to a capital letter; all other letters default to lowercasewords
, the first letter of each word defaults to a capital letter; all other letters default to lowercasecharacters
, all letters should default to uppercase
autocomplete: Option<String>
This attribute on a <button>
is nonstandard and Firefox-specific. Unlike other browsers, Firefox persists the dynamic disabled state of a <button>
across page loads. Setting autocomplete="off"
on the button disables this feature; see Firefox bug 654072.
autofocus: Option<bool>
This Boolean attribute specifies that the button should have input focus when the page loads. Only one element in a document can have this attribute.
class: Option<String>
A space-separated list of the classes of the element. Classes allow CSS and JavaScript to select and access specific elements via the class selectors or functions like the method Document.getElementsByClassName()
.
contenteditable: Option<String>
An enumerated attribute indicating if the element should be editable by the user. If so, the browser modifies its widget to allow editing. The attribute must take one of the following values:
true
or the empty string, which indicates that the element must be editable;false
, which indicates that the element must not be editable.
data: Option<BTreeMap<String, String>>
Forms a class of attributes, called custom data attributes, that allow proprietary information to be exchanged between the HTML and its DOM representation that may be used by scripts. All such custom data are available via the HTMLElement
interface of the element the attribute is set on. The HTMLElement.dataset
property gives access to them.
dir: Option<String>
An enumerated attribute indicating the directionality of the element's text. It can have the following values:
ltr
, which means left to right and is to be used for languages that are written from the left to the right (like English);rtl
, which means right to left and is to be used for languages that are written from the right to the left (like Arabic);auto
, which lets the user agent decide. It uses a basic algorithm as it parses the characters inside the element until it finds a character with a strong directionality, then it applies that directionality to the whole element.
disabled: Option<bool>
This Boolean attribute prevents the user from interacting with the button: it cannot be pressed or focused.
Firefox, unlike other browsers, persists the dynamic disabled state of a <button>
across page loads. To control this feature, use the [autocomplete
]] (#autocomplete) attribute.
draggable: Option<String>
An enumerated attribute indicating whether the element can be dragged, using the Drag and Drop API. It can have the following values:
true
, which indicates that the element may be draggedfalse
, which indicates that the element may not be dragged.
enterkeyhint: Option<String>
Hints what action label (or icon) to present for the enter key on virtual keyboards.
exportparts: Option<String>
Used to transitively export shadow parts from a nested shadow tree into a containing light tree.
extra: Option<BTreeMap<String, String>>
/// Extra attributes of the element. This is a map of attribute names to their values, and the attribute names are in lowercase.
form: Option<String>
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.
formaction: Option<String>
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.
formenctype: Option<String>
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
: Used to submit<input>
elements with theirtype
attributes set tofile
.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.
formmethod: Option<String>
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'saction
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.
formnovalidate: Option<bool>
If the button is a submit button, this Boolean attribute 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.
formtarget: Option<String>
If the button is a submit button, this attribute is an 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
.
An enumerated attribute indicating that the element is not yet, or is no longer, relevant. For example, it can be used to hide elements of the page that can't be used until the login process has been completed. The browser won't render such elements. This attribute must not be used to hide content that could legitimately be shown.
id: Option<String>
Defines a unique identifier (ID) which must be unique in the whole document. Its purpose is to identify the element when linking (using a fragment identifier), scripting, or styling (with CSS).
inert: Option<String>
A boolean value that makes the browser disregard user input events for the element. Useful when click events are present.
inputmode: Option<String>
Provides a hint to browsers about the type of virtual keyboard configuration to use when editing this element or its contents. Used primarily on <input>
elements, but is usable on any element while in contenteditable
mode.
is: Option<String>
Allows you to specify that a standard HTML element should behave like a registered custom built-in element (see Using custom elements for more details).
name: Option<String>
The name of the button, submitted as a pair with the button's value
as part of the form data, when that button is used to submit the form.
type_: Option<String>
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.
value: Option<String>
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 using this button.
Implementations§
Trait Implementations§
source§impl Clone for ButtonOwned
impl Clone for ButtonOwned
source§fn clone(&self) -> ButtonOwned
fn clone(&self) -> ButtonOwned
1.0.0 · source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moresource§impl Debug for ButtonOwned
impl Debug for ButtonOwned
source§impl Default for ButtonOwned
impl Default for ButtonOwned
source§fn default() -> ButtonOwned
fn default() -> ButtonOwned
source§impl Ord for ButtonOwned
impl Ord for ButtonOwned
source§fn cmp(&self, other: &ButtonOwned) -> Ordering
fn cmp(&self, other: &ButtonOwned) -> Ordering
1.21.0 · source§fn max(self, other: Self) -> Selfwhere
Self: Sized,
fn max(self, other: Self) -> Selfwhere Self: Sized,
source§impl PartialEq<ButtonOwned> for ButtonOwned
impl PartialEq<ButtonOwned> for ButtonOwned
source§fn eq(&self, other: &ButtonOwned) -> bool
fn eq(&self, other: &ButtonOwned) -> bool
self
and other
values to be equal, and is used
by ==
.source§impl PartialOrd<ButtonOwned> for ButtonOwned
impl PartialOrd<ButtonOwned> for ButtonOwned
source§fn partial_cmp(&self, other: &ButtonOwned) -> Option<Ordering>
fn partial_cmp(&self, other: &ButtonOwned) -> Option<Ordering>
1.0.0 · source§fn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
self
and other
) and is used by the <=
operator. Read more