検索結果

listbox

この記事内

例
関連情報
1. 関連項目

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

この要素は、一つ以上の項目を選択できる項目のリストを作成するために使用します。listbox は複数のコラムを含みます。ここには listbox 内の項目を取得、変更することができる数多くのメソッドがあります。

リスト内に表示する行数の指定は rows 属性を使用します。追加の行はスクロールバーを使用して見ることができます。listbox には listitem 要素が含まれます。listbox 内の各 rows はすべて同じ高さになり、リスト内で最も高い項目と同じ高さに揃います。高さが変わる行を持つリストやテキストではないコンテンツを持つリストを作成したいときは、代わりに richlistbox 要素を使用してください。

詳しい情報は List Controls をご覧ください。

属性: disabled, disableKeyNavigation, preference, rows, seltype, suppressonselect, tabindex, value

プロパティ: accessibleType, currentIndex, currentItem, disabled, disableKeyNavigation, itemCount, listBoxObject, selectedCount, selectedIndex, selectedItem, selectedItems, selType, suppressOnSelect, tabIndex, value

メソッド: addItemToSelection, appendItem, clearSelection, ensureElementIsVisible, ensureIndexIsVisible, getIndexOfFirstVisibleRow, getIndexOfItem, getItemAtIndex, getNumberofVisibleRows, getRowCount, getSelectedItem, insertItemAt, invertSelection, moveByOffset, removeItemAt, removeItemFromSelection, scrollToIndex, selectAll, selectItem, selectItemRange, timedSelect, toggleItemSelection

例

 <listbox id="theList">
   <listitem label="Ruby"/>
   <listitem label="Emerald"/>
   <listitem label="Sapphire" selected="true"/>
   <listitem label="Diamond"/>
 </listbox>

属性

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

disableKeyNavigation: 型: 論理型; この属性が使用されていない場合、ユーザは、項目のラベル内の文字にマッチするキーを押すことによって、要素内の特定の項目に移動することができます。これはインクリメンタルに行われるため、さらに文字を入力して、項目をさらに特定することができます。この機能は、この属性を true に設定することによって無効化されます。

preference: 型: 要素の id; 要素を対応する preference につなぎます。この属性は prefwindow 内で使用された場合のみ効果があります。preference の値は、要素の value プロパティと一致するように更新されます。

rows: 型: 整数型; 要素内に表示する行数。要素がこの数値よりも多くの行を含むときはスクロールバーが現れます。要素内の実際の rows の値を取得するには getRowCount メソッドを使用してください。

{{ XULAttr("seltype") }}: 型: 下記の値のいずれか一つ; 複数の選択を許可するかどうかを指示します。

single: 一度に一行だけが選択できます。(listbox のデフォルト値)
multiple: 一度に複数行が選択できます。(tree のデフォルト値)

tree 要素ではさらに、

cell : 個々のセルが選択できます。
text : 行が選択されたとき、最初の列のテキストのみが強調表示されます。

suppressonselect: 型: 論理型; この属性が指定されていないときは、ユーザや select メソッドの呼び出しによって項目が選択されるたびに select イベントが発生します。true に設定すると select イベントは発生しません。

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

value: 型: 文字列型; 文字列の属性はデータ値を要素に関連付けます。特定の目的のために使われるわけではありませんが、スクリプトからあなた自身の用途のためにアクセスできます。

プロパティ

accessibleType: 型: 整数型; 要素の accessibility オブジェクトの種類を示す値。

currentIndex: 型: 整数型; 現在フォーカスされた list 内の項目の index を設定します。フォーカスされた項目がない場合、値は -1 になります。一つの項目のみを選択する list では、現在の index は常に選択された index と同じになります。複数の項目を選択する list では、Ctrl キーを押下しながらカーソルキーで移動することによって、選択を変更せずに、現在フォーカスされた行がユーザによって変更されます。

currentItem: 型: listitem 要素; リストボックス内の最後に選択された項目を返します。これは複数の項目を選択するリストボックスで役立ちます。

disabled: 型: 論理型; disabled 属性の値の取得と設定。

disableKeyNavigation: 型: 論理型; disableKeyNavigation 属性の値の取得と設定。

itemCount: 型: 整数型; 子項目の数を保持する読み取り専用のプロパティ。

listBoxObject: 型: nsIListBoxObject; リストボックスの背後の nsIListBoxObject。このプロパティは読み取り専用です。リストボックスの機能のほとんどが listbox 内で直接利用可能なため、このボックスオブジェクトを直接使用する必要はありません。

selectedCount: 型: 整数型; 現在選択されている項目の数を返します。

selectedIndex: 型: 整数型; 選択された項目の index を返します。また、このプロパティに index を設定して項目を選択する事もできます。このプロパティに -1 を設定すると、項目の選択をすべて解除します。

selectedItem: 型: 要素; 選択できる要素がある要素の、現在選択されている項目を保持します。項目が選択されていないときは、この値は null になります。この値の設定によって項目を選択することができます。値が、このプロパティまたは selectedIndex プロパティを通じて変更されるか、ユーザによって変更された場合、select イベントが要素に送られます。

selectedItems: 型: listitems の配列; リスト内の選択された項目の配列を返します。

{{ XULProp("selType") }}: 型: 文字列型; {{ XULAttr("seltype") }} 属性の値の取得と設定。

suppressOnSelect: 型: 論理型; suppressonselect 属性の値の取得と設定。

tabIndex: 型: 整数型; tabindex 属性の値の取得と設定。

value: 型: 文字列型; value 属性の値の取得と設定。

メソッド

XUL 要素からの継承
blur, click, doCommand, focus, getElementsByAttribute getElementsByAttributeNS

DOM 要素からの継承
addEventListener(), appendChild(), compareDocumentPosition, dispatchEvent(), getAttribute(), getAttributeNode(), getAttributeNodeNS(), getAttributeNS(), getElementsByTagName(), getElementsByTagNameNS(), getFeature, getUserData, hasAttribute(), hasAttributeNS(), hasAttributes(), hasChildNodes(), insertBefore(), isEqualNode, isSameNode, isSupported(), lookupNamespaceURI, lookupPrefix, normalize(), removeAttribute(), removeAttributeNode(), removeAttributeNS(), removeChild(), removeEventListener(), replaceChild(), setAttribute(), setAttributeNode(), setAttributeNodeNS(), setAttributeNS(), setUserData

addItemToSelection( item ): 戻り値の型: 戻り値無し; 与えられた item を追加選択します。すでに選択されている項目の選択は解除されません。

« XUL リファレンス HOME

appendItem(label,value ): 戻り値の型: 要素; 新しい項目を生成し、既存の項目リストの末尾に追加します。値の設定は任意です。この関数は新しく生成された要素を返します。

例

<script>
function addItemsToList() {
  var list = document.getElementById('myMenuList');

  // add item with just the label
  list.appendItem('One');

  // add item with label and value
  list.appendItem('Two', 999);

  // Select the first item
  list.selectedIndex = 0;
}
</script>

<button label="Add items" oncommand="addItemsToList()" />

<menulist id="myMenuList">
  <menupopup />
</menulist>

listbox

例

属性

プロパティ

メソッド

例

関連情報

関連項目

ドキュメントのタグと貢献者