XUL:timepicker

出典: MDC

« XUL リファレンス HOME    [ 例 | 属性 | プロパティ | メソッド | 関連項目 ]

timepicker は時間の入力に使われます。時間、分、秒の 3 つのフィールドを持っています。フィールドの隣の矢印ボタンはマウスによる値の調整を可能にしています。4 つ目のテキストボックスは 12 時間表記で午前か午後かを選べるように出現します。

初期値を指定するには、value 属性に HH:MM:SS あるいは HH:MM のどちらかの値を設定します。value プロパティか dateValue プロパティを使用して値を取得したり変更できます。前者は時間を HH:MM:SS 形式の文字列として指定し、一方後者は時間を Date オブジェクトとして指定します。さらに、hour, minute, second プロパティで時間のそれぞれの要素を別々に取得したり、変更することができます。

属性

disabled, hideseconds, increment, readonly, tabindex, value

プロパティ

amIndicator, dateValue, disabled, hideSeconds, hour, hourLeadingZero, increment, is24HourClock, isPM, minute, minuteLeadingZero, pmIndicator, readOnly, second, secondLeadingZero, tabIndex, value

[編集] 例

<timepicker value="12:05"/>

[編集] 属性

XUL 要素からの継承 align, allowevents, allownegativeassertions, class, coalesceduplicatearcs, collapsed, container, containment, context, contextmenu, datasources, dir, empty, equalsize, flags, flex, height, hidden, id, insertafter, insertbefore, left, maxheight, maxwidth, menu, minheight, minwidth, mousethrough, observes, ordinal, orient, pack, persist, popup, position, preference-editable, querytype, ref, removeelement, sortDirection, sortResource, sortResource2, statustext, style, template, tooltip, tooltiptext, top, uri, wait-cursor, width

disabled

型: 真偽値

要素が無効化されているかどうかを示します。ある要素が true に設定されていたら、その要素は無効化されています。無効化された要素は通常グレイ表示のテキストで描画されます。要素が無効化されていると、ユーザのアクションには応答せず、フォーカスもあてられず、command イベントも発生しません。

hideseconds

型: 真偽値

秒フィールドを表示するかどうかを設定します。

readonly

型: boolean

true に設定した場合、ユーザは要素の値を変更できません。しかし、スクリプトからは依然として値を変更できます。

increment

型: 整数値

矢印が押されたときに変更される分数。これを使用するときは hideseconds が true に設定されている必要があります。

tabindex

型: 整数

要素のタブの順番。タブの順番は tab キーが押下されたときにフォーカスが移動する順番です。より大きな tabindex の値をもつ要素は、タブの遷移が後になります。

value

型: 文字列

timepicker の初期値を HH:MM:SS 形式と HH:MM 形式のどちらかに設定します。

[編集] プロパティ

XUL 要素からの継承 align, allowEvents, boxObject, builder, className, collapsed, contextMenu, controllers, currentItem, database, datasources, dir, flex, height, hidden, id, left, listBoxObject, maxHeight, maxWidth, menu, minHeight, minWidth, observes, ordinal, orient, pack, persist, ref, resource, statusText, style, tooltip, tooltipText, top, value, width DOM 要素からの継承 attributes, childNodes, cloneNode, firstChild, lastChild, localName, namespaceURI, nextSibling, nodeName, nodeType, nodeValue, ownerDocument, parentNode, prefix, previousSibling, tagName

amIndicator

型: 文字列

設定された文字列は、午前と午後の区別表示に使用されます。初期値は AM です。この値はユーザが使用するロケールに合わせる事もできます。

dateValue

型: Date

Date オブジェクトとして datepicker に現在入力または選択されている日付。

disabled

型: 真偽値

disabled 属性の値の取得と設定。

hideSeconds

型: 真偽値

秒フィールドが表示されているかどうかを示します。

hour

型: integer

現在選択されている 0 から 23 までの時刻。選択された時刻を変更するには、このプロパティを設定します。

hourLeadingZero

型: 真偽値

hour が 10 未満の場合、先頭にゼロを表示するかどうか指示します。このプロパティは読み取り専用です。

increment

型: 整数

increment 属性の値の取得と設定。

is24HourClock

型: 真偽値

時刻の表示に 24 時間形式と 12 時間形式のどちらを使用しているかを示します。12 時間形式の時計では、ユーザが AM と PM を拡張フィールドで取得することができます。このプロパティは読み込み専用です。この値はユーザのロケールから判定されます。

isPM

型: boolean

false の場合、hour は 0 から 11 の間になります。true の場合、hour は 12 以上になります。

minute

型: integer

現在選択されている、0 から 59 までの分。選択された分を変更するには、このプロパティを設定します。

minuteLeadingZero

型: 真偽値

分数が 10 未満の場合、先頭にゼロを表示するかどうかを指示します。このプロパティは読み取り専用です。

pmIndicator

型: 文字列

設定された文字列は午前と午後の区別表示に使用されます。初期値は PM です。この値はユーザが使用するロケールに合わせる事もできます。

readOnly

型: 真偽値

true に設定すると、ユーザは要素の値を変更できなくなります。

second

型: integer

現在選択されている 0 から 59 までの秒。選択された秒を変更するには、このプロパティを設定します。

secondLeadingZero

型: 真偽値

秒数が 10 未満の場合、先頭にゼロを表示するかどうかを指示します。このプロパティは読み取り専用です。

tabIndex

型: 整数

tabindex 属性の値の取得と設定。

value

型: 文字列

現在入力されている HH:MM:SS 形式の時間。時間を変更するには、このプロパティを設定します。

[編集] メソッド

XUL 要素からの継承 blur, click, doCommand, focus, getElementsByAttribute DOM 要素からの継承 addEventListener, appendChild, dispatchEvent, getAttribute, getAttributeNode, getAttributeNodeNS, getAttributeNS, getElementsByTagName, getElementsByTagNameNS, hasAttribute, hasAttributeNS, hasAttributes, hasChildNodes, insertBefore, isSupported, normalize, removeAttribute, removeAttributeNode, removeAttributeNS, removeChild, removeEventListener, replaceChild, setAttribute, setAttributeNode, setAttributeNodeNS, setAttributeNS

[編集] 関連項目

インタフェース

nsIDOMXULControlElement