ui:inputNumber | Lightning コンポーネント開発者ガイド

ui:inputNumber コンポーネントは、text 型の HTML input タグとして表示される、数値の入力項目を表します。次の例に、10 の値を表示する数値項目を示します。

1<aura:attribute name="num" type="integer" default="10"/>
2<ui:inputNumber aura:id="num" label="Age" value="{!v.num}"/>

前の例の結果、次の HTML になります。

1<div class="uiInput uiInputNumber">
2<label class="uiLabel-left uiLabel">
3    <span>Age</span>
4</label>
5<input max="99999999999999" step="1" type="text" 
6        min="-99999999999999" class="uiInput uiInputNumber">
7</div>

ui:inputNumber コンポーネントからの出力を表示するには、ui:inputNumber コンポーネントを使用します。カンマを含む数値を指定する場合は、type="integer" を使用します。次の例は 100,000 を返します。

1<aura:attribute name="number" type="integer" default="100,000"/>
2<ui:inputNumber label="Number" value="{!v.number}"/>

type="string" の場合は、正しい形式で出力するためカンマを含まない数値を指定します。次の例も 100,000 を返します。

1<aura:attribute name="number" type="string" default="100000"/>
2<ui:inputNumber label="Number" value="{!v.number}"/>

format="#,##0,000.00#" を指定すると、10,000.00 のように書式設定された数値が返されます。

1<ui:label label="Cost"/>
2<ui:inputNumber aura:id="costField" format="#,##0,000.00#" value="10000"/>

次の例は、ui:inputNumber コンポーネントの値を取得し、入力を検証し、ui:outputNumber を使用して値を表示します。

1<aura:component> 
2 <ui:inputNumber aura:id="inputCmp" label="Enter a number: "/> <br/>
3    <ui:button label="Submit" press="{!c.validate}"/>
4    <ui:outputNumber aura:id="outNum" value=""/>
5</aura:component>

1swfobject.registerObject("clippy.codeblock-6", "9");
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17({  
18    validate : function(component, evt) {
19        var inputCmp = component.find("inputCmp");
20        var value = inputCmp.get("v.value");
21        
22        var myOutput = component.find("outNum");
23        
24        myOutput.set("v.value", value);
25        
26        // Check if input is numeric
27        if (isNaN(value)) {
28            // Set error message
29            inputCmp.setValid("v.value", false);
30            inputCmp.addErrors("v.value", [{message:"Input not a number: " + value}]);
31        } else {
32            // Clear error
33            inputCmp.setValid("v.value", true);
34        }
35    }
36})

属性

属性名	属性型	説明
`body`	Component[]	コンポーネントのボディ。マークアップでは、これはタグのボディに含まれるすべてを指します。
`class`	String	コンポーネントに添付される CSS スタイル。このスタイルは、コンポーネントで出力される基本スタイルに追加されます。
`disabled`	Boolean	コンポーネントを無効な状態で表示するかどうかを指定します。デフォルト値は「false」です。
`format`	String	数値の形式。たとえば、format=“.00” は、小数点以下 2 桁の数値を表示します。指定されていない場合は、ロケールのデフォルト形式が使用されます。
`label`	String	表示ラベルコンポーネントのテキスト。
`labelClass`	String	表示ラベルコンポーネントの CSS クラス。
`maxlength`	Integer	入力項目に入力できる最大文字数。表示される HTML 入力要素の maxlength 属性に対応します。
`placeholder`	String	項目が空の場合に、ユーザに有効な入力を求めるためのテキスト。
`required`	Boolean	入力が必須かどうかを指定します。デフォルト値は「false」です。
`requiredIndicatorClass`	String	必須のインジケータコンポーネントの CSS クラス。
`size`	Integer	入力項目の長さを示す文字数。表示される HTML 入力要素の size 属性に対応します。
`updateOn`	String	処理されたイベントに updateOn 属性が設定されている場合、コンポーネントの値のバインドを更新します。デフォルト値は「change」です。
`value`	BigDecimal	数値の入力値。

イベント

イベント名	イベントタイプ	説明
`mouseup`	COMPONENT	ユーザがマウスボタンを放したことを示します。
`mousedown`	COMPONENT	ユーザがマウスキーを押したことを示します。
`mousemove`	COMPONENT	ユーザがマウスポインタを移動したことを示します。
`dblclick`	COMPONENT	コンポーネントがダブルクリックされたことを示します。
`mouseout`	COMPONENT	ユーザがマウスポインタをコンポーネントから移動したことを示します。
`click`	COMPONENT	コンポーネントがクリックされたことを示します。
`mouseover`	COMPONENT	ユーザがマウスポインタをコンポーネントに移動したことを示します。
`keyup`	COMPONENT	ユーザがキーボードキーを放したことを示します。
`keypress`	COMPONENT	ユーザがキーボードキーを押したままにしたことを示します。
`select`	COMPONENT	ユーザが選択を行ったことを示します。
`keydown`	COMPONENT	ユーザがキーボードキーを押してから放したことを示します。
`focus`	COMPONENT	コンポーネントにフォーカスが置かれたことを示します。
`blur`	COMPONENT	コンポーネントからフォーカスが離れたことを示します。
`validationError`	COMPONENT	コンポーネントに検証エラーがあることを示します。
`paste`	COMPONENT	ユーザがコンテンツをクリップボードから貼り付けたことを示します。
`change`	COMPONENT	コンポーネントのコンテンツまたは状況が変更されたことを示します。
`clearErrors`	COMPONENT	検証エラーをすべてクリアする必要があることを示します。
`cut`	COMPONENT	ユーザがコンテンツを切り取ってクリップボードに保存したことを示します。
`copy`	COMPONENT	ユーザがコンテンツをクリップボードにコピーしたことを示します。