方法
本節(jié)介紹用于操作Accordion UI組件的成員。
beginUpdate()
推遲可能對(duì)性能產(chǎn)生負(fù)面影響的呈現(xiàn),直到調(diào)用endUpdate() 方法。
在額外的渲染會(huì)對(duì)性能產(chǎn)生負(fù)面影響的情況下,beginUpdate()和endUpdate()方法可以減少渲染的次數(shù)。
collapseItem(index)
折疊具有特定索引的項(xiàng)。
- Parameters:
- index:
- 項(xiàng)目的索引。
- Return Value:Promise<void> (或)
- 一個(gè)Promise,在元素折疊時(shí)解決,否則拒絕。當(dāng)使用jQuery時(shí),它是一個(gè) 或。
提示:當(dāng)可折疊屬性設(shè)置為true時(shí),此方法將應(yīng)用。
defaultOptions(rule)
指定此組件的與設(shè)備相關(guān)的默認(rèn)配置屬性。
- Parameters:
- rule:Object
- 組件的默認(rèn)設(shè)備屬性。
- 目標(biāo)結(jié)構(gòu):
名稱 | 類型 | 描述 |
---|---|---|
device |
| |
設(shè)備參數(shù)。 當(dāng)指定一個(gè)函數(shù)時(shí),從參數(shù)中獲取有關(guān)當(dāng)前設(shè)備的信息。如果屬性應(yīng)應(yīng)用于設(shè)備,則返回true。 |
options | 選擇應(yīng)用。 |
defaultOptions是UI組件類支持的靜態(tài)方法。下面的代碼演示了如何為桌面上執(zhí)行的應(yīng)用程序中的Accordion UI組件的所有實(shí)例指定默認(rèn)屬性。
DevExpress.ui.dxAccordion.defaultOptions({ device: { deviceType: "desktop" }, options: { // Here go the Accordion properties } });
dispose()
處置分配給Accordion實(shí)例的所有資源。
調(diào)用此方法后,移除與UI組件關(guān)聯(lián)的DOM元素:
$("#myAccordion").dxAccordion("dispose"); $("#myAccordion").remove();
只有當(dāng)UI組件是用jQuery或純JavaScript創(chuàng)建時(shí)才使用此方法,在Angular、Vue和React中使用條件渲染:
element()
獲取根UI組件元素。
- Return Value:HTMLElement | jQuery
- HTML元素或jQuery元素(當(dāng)您使用jQuery時(shí))。
endUpdate()
在調(diào)用beginUpdate()方法后刷新UI組件。
在額外的渲染會(huì)對(duì)性能產(chǎn)生負(fù)面影響的情況下,beginUpdate()和endUpdate()方法可以減少渲染的次數(shù)。
expandItem(index)
用特定索引展開項(xiàng)。
- Parameters:
- index: Number
- 項(xiàng)目的索引。
- Return Value:Promise (jQuery或native)
- 如果item被擴(kuò)展則解決,否則拒絕Promise,當(dāng)使用jQuery時(shí),它是一個(gè) native Promise或jQuery.Promise。
focus()
將焦點(diǎn)設(shè)置在UI組件上。
getDataSource()
獲取數(shù)據(jù)源實(shí)例。
- Return Value: DataSource
- 數(shù)據(jù)源實(shí)例。
即使UI組件的DataSource屬性是一個(gè)簡(jiǎn)單的數(shù)組,這個(gè)方法也會(huì)返回DataSource實(shí)例。
getInstance(element)
獲取使用其DOM節(jié)點(diǎn)找到的UI組件的實(shí)例。
- Parameters:
- element: |
- UI組件的容器。
- Return Value:
- UI組件的實(shí)例。
getInstance是UI組件類支持的靜態(tài)方法,下面的代碼演示了如何獲取ID為myAccordion的元素中的Accordion實(shí)例:
// Modular approach import Accordion from "devextreme/ui/accordion"; ... let element = document.getElementById("myAccordion"); let instance = Accordion.getInstance(element) as Accordion; // Non-modular approach let element = document.getElementById("myAccordion"); let instance = DevExpress.ui.dxAccordion.getInstance(element);
實(shí)例()
獲取UI組件的實(shí)例,使用它來訪問UI組件的其他方法。
- Return Value:
- 這個(gè)UI組件的實(shí)例。
off(eventName)
從單個(gè)事件分離所有事件處理程序。
- Parameters:
- eventName:
- 事件的名稱。
- Return Value:
- 為其調(diào)用此方法的對(duì)象。
off(eventName, eventHandler)
從單個(gè)事件分離特定事件處理程序。
- Parameters:
- eventName:
- 事件的名稱。
- eventHandler:
- 事件的處理程序。
- Return Value:
- 為其調(diào)用此方法的對(duì)象。
on(eventName, eventHandler)
訂閱一個(gè)事件。
- Parameters:
- eventName:
- 事件的名稱。
- eventHandler:
- 事件的處理程序。
- Return Value:
- 為其調(diào)用此方法的對(duì)象。
使用此方法訂閱events部分中列出的事件之一。
on(events)
訂閱事件。
- Parameters:
- eventName:
- 事件及其處理程序:{"eventName1": handler1, "eventName2": handler2,…}
- Return Value:
- 為其調(diào)用此方法的對(duì)象。
使用此方法可以通過一個(gè)方法調(diào)用訂閱多個(gè)事件。事件部分列出了可用的事件。
選項(xiàng)()
獲取所有UI組件屬性。
- Return Value:
- UI組件的屬性。
選項(xiàng)(optionName)
獲取單個(gè)屬性的值。
- Parameters:
- optionName:
- 屬性的名稱或完整路徑。
- Return Value:any
- 這個(gè)屬性的值。
選項(xiàng)(optionName,optionValue)
更新單個(gè)屬性的值。
- Parameters:
- optionName:
- 屬性的名稱或完整路徑。
- optionValue:any
- 屬性的新值。
選項(xiàng)(選項(xiàng))
更新幾個(gè)屬性的值。
- Parameters:
- options: Object
- 選項(xiàng)及其新值。
egisterKeyHandler(關(guān)鍵,處理程序)
注冊(cè)當(dāng)用戶按下特定鍵時(shí)要執(zhí)行的處理程序。
- Parameters:
- key:String
- 一個(gè)密鑰。
- handler: Function
- 接受keydown事件作為參數(shù),當(dāng)使用jQuery時(shí),它是一個(gè)EventObject或。
key參數(shù)接受以下值之一:
-
"backspace"
-
"tab"
-
"enter"
-
"escape"
-
"pageUp"
-
"pageDown"
-
"end"
-
"home"
-
"leftArrow"
-
"upArrow"
-
"rightArrow"
-
"downArrow"
-
"del"
-
"space"
-
"F"
-
"A"
-
"asterisk"
- "minus"
鍵的自定義處理程序?qū)⑷∠随I的默認(rèn)處理程序。
repaint()
在不重新加載數(shù)據(jù)的情況下重新繪制UI組件,調(diào)用它來更新UI組件的標(biāo)記。
該方法重新繪制工具欄并重新初始化其所有項(xiàng)。
resetOption (optionName)
將屬性重置為默認(rèn)值。
- Parameters:
- optionName:
- 屬性的名稱。
updateDimensions ()
更新UI組件內(nèi)容的維度。
- Return Value: Promise (or)
- 更新完成后解析的承諾,當(dāng)使用jQuery時(shí),它是一個(gè)native Promise或jQueryPromise。
在UI組件的大小(size)被更改后,使用這個(gè)方法使UI組件的內(nèi)容與UI組件的大小相匹配。