stdweb/webapi/html_elements/input.rs
1use webcore::value::Reference;
2use webcore::try_from::TryInto;
3use webapi::dom_exception::InvalidStateError;
4use webapi::event_target::{IEventTarget, EventTarget};
5use webapi::node::{INode, Node};
6use webapi::element::{IElement, Element};
7use webapi::html_element::{IHtmlElement, HtmlElement};
8
9/// The HTML input element is used to create interactive controls
10/// for web-based forms in order to accept data from the user.
11///
12/// [(JavaScript docs)](https://developer.mozilla.org/en/docs/Web/HTML/Element/input)
13// https://html.spec.whatwg.org/#htmlinputelement
14#[derive(Clone, Debug, PartialEq, Eq, ReferenceType)]
15#[reference(instance_of = "HTMLInputElement")]
16#[reference(subclass_of(EventTarget, Node, Element, HtmlElement))]
17pub struct InputElement( Reference );
18
19impl IEventTarget for InputElement {}
20impl INode for InputElement {}
21impl IElement for InputElement {}
22impl IHtmlElement for InputElement {}
23
24impl InputElement {
25 /// The value of the control. This attribute is optional except when the input is a radio button or a checkbox.
26 ///
27 // https://html.spec.whatwg.org/#the-input-element:dom-input-value
28 #[inline]
29 pub fn raw_value( &self ) -> String {
30 js! (
31 return @{self}.value;
32 ).try_into().unwrap()
33 }
34
35 /// Sets the value of the control.
36 ///
37 // https://html.spec.whatwg.org/#dom-input-value
38 #[inline]
39 pub fn set_raw_value( &self, value: &str ) {
40 js! { @(no_return)
41 @{self}.value = @{value};
42 }
43 }
44
45 /// The offset to the start of the selection.
46 /// This attribute only applies when the input is a text, search, url, telephone or password.
47 ///
48 // https://html.spec.whatwg.org/#the-input-element:dom-textarea/input-selectionstart
49 #[inline]
50 pub fn selection_start( &self ) -> Option<u32> {
51 js! (
52 return @{self}.selectionStart;
53 ).try_into().ok()
54 }
55
56 /// Sets the offset to the start of the selection.
57 /// This attribute only applies when the input is a text, search, url, telephone or password.
58 ///
59 // https://html.spec.whatwg.org/#the-input-element:dom-textarea/input-selectionstart
60 #[inline]
61 pub fn set_selection_start( &self, value: u32 ) -> Result<(), InvalidStateError> {
62 js_try! ( @(no_return)
63 @{self}.selectionStart = @{value};
64 ).unwrap()
65 }
66
67 /// The offset to the end of the selection.
68 /// This attribute only applies when the input is a text, search, url, telephone or password.
69 ///
70 // https://html.spec.whatwg.org/#the-input-element:dom-textarea/input-selectionstart
71 #[inline]
72 pub fn selection_end( &self ) -> Option<u32> {
73 js! (
74 return @{self}.selectionEnd;
75 ).try_into().ok()
76 }
77
78 /// Sets the offset to the end of the selection.
79 /// This attribute only applies when the input is a text, search, url, telephone or password.
80 ///
81 // https://html.spec.whatwg.org/#the-input-element:dom-textarea/input-selectionstart
82 #[inline]
83 pub fn set_selection_end( &self, value: u32 ) -> Result<(), InvalidStateError> {
84 js_try! ( @(no_return)
85 @{self}.selectionEnd = @{value};
86 ).unwrap()
87 }
88}