In Onsen UI text input is provided by the <ons-input>
tag. It works exactly like the normal <input>
tag but with some small differences.
Just like the normal input tag you can use the type
attribute to define what kind of input that should be displayed. To get an number input you can use the number
type:
<ons-input
type="number"
placeholder="Age"
min="0"
max="200">
</ons-input>
You can also use types like number
or date
. The only exception are checkboxes and radio buttons, which are implemented in different elements.
Any valid HTML attribute for inputs should work in ons-input
(required
, max
, etc.).
For Android devices the input will displayed as a Material Design input element. One of the features of this input is that it can have a floating label which will animated when the user starts typing. Try changing the style to Android to see how it works.
The label is defined with the placeholder
attribute and to activate the animation the float
attribute is required.
<ons-input placeholder="Username" float></ons-input>
For normal input elements is possible to define a <label>
tab with the for
attribute to link it to an input element.
Unfortunately this does not work with custom elements like <ons-label>
so in order to do it we need to set the id
attribute of the inner input element.
This is done using the input-id
attribute.
<label for="username">Username</label>
<ons-input input-id="username"></ons-input>
This work with any input in Onsen UI such as checkboxes, radios, etc.
名前 | 型 / デフォルト値 | 概要 |
---|---|---|
placeholder | String | Placeholder text. In Material Design, this placeholder will be a floating label. (翻訳中) Optional. |
float | この属性が設定された時、ラベルはアニメーションするようになります。 Optional. | |
type | String |
Specify the input type. This is the same as the “type” attribute for normal inputs. It expects strict text types such as |
input-id | String |
Specify the “id” attribute of the inner <input> element. This is useful when using <label for="..."> elements.
(翻訳中)
Optional.
|
名前 | 概要 |
---|---|
float | この属性が設定された時、ラベルはアニメーションするようになります。 |
value | The current value of the input. (翻訳中) |
disabled |
無効化されている場合にtrue 。
|
Name | 概要 |
---|---|
material | Displays a Material Design input. (翻訳中) |
underbar | Displays a horizontal line underneath a text input. (翻訳中) |
transparent | Displays a transparent input. Works for Material Design. (翻訳中) |
シグネチャ | 概要 |
---|---|
focus() | Focuses the input. (翻訳中) |
blur() | Removes focus from the input. (翻訳中) |
Focuses the input. (翻訳中)
Removes focus from the input. (翻訳中)
Onsen UIに関する質問は、Stack Overflowにてonsen-uiタグを付与してください。Onsen UIチームはあなたの問題解決をお手伝いします。
バグ報告や機能要望については、GitHub Issuesに記載をお願いいたします。
あわせて、下記の情報も参考にしてください。