---
title: "Ext.view.BoundList"
description: "xtype 为 boundlist 的 Ext JS 原生组件参考。"
---

> Documentation Index
> Fetch the complete documentation index at: https://ag.879818327.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Ext.view.BoundList

源码定义：`ext-all-debug.js:104417`。分类：数据视图、表格与树。

## 创建示例

```javascript
var component = Ext.create("Ext.view.BoundList", {
  xtype: "boundlist",
  baseCls: Ext.baseCSSPrefix + 'boundlist',
  childEls: [,
  componentLayout: 'boundlist',
  deferInitialRefresh: false,
  renderTo: Ext.getBody()
});
```

## 属性

| 属性 | 类型 | 默认值 | 说明 | 配置示例 |
| --- | --- | --- | --- | --- |
| `baseCls` | `Mixed` | `Ext.baseCSSPrefix + 'boundlist'` | 配置 `baseCls` 对应的 CSS 类名。 | `baseCls: Ext.baseCSSPrefix + 'boundlist'` |
| `childEls` | `Array` | `[` | 组件创建后需要引用的子 DOM 元素集合。 | `childEls: [` |
| `componentLayout` | `String` | `'boundlist'` | 组件采用的内部布局策略。 | `componentLayout: 'boundlist'` |
| `deferInitialRefresh` | `Boolean` | `false` | 控制是否启用 `deferInitialRefresh` 行为。 | `deferInitialRefresh: false` |
| `itemCls` | `Mixed` | `Ext.baseCSSPrefix + 'boundlist-item'` | 配置 `itemCls` 对应的 CSS 类名。 | `itemCls: Ext.baseCSSPrefix + 'boundlist-item'` |
| `listItemCls` | `String` | `''` | 配置 `listItemCls` 对应的 CSS 类名。 | `listItemCls: ''` |
| `pageSize` | `Number` | `0` | 配置组件的 `pageSize` 选项。 | `pageSize: 0` |
| `preserveScrollOnRefresh` | `Boolean` | `true` | 控制是否启用 `preserveScrollOnRefresh` 行为。 | `preserveScrollOnRefresh: true` |
| `refreshed` | `Number` | `0` | 配置组件的 `refreshed` 选项。 | `refreshed: 0` |
| `renderTpl` | `Array` | `[` | 配置生成组件内容的 `renderTpl` 模板。 | `renderTpl: [` |
| `shadow` | `Boolean` | `false` | 控制是否启用 `shadow` 行为。 | `shadow: false` |
| `trackOver` | `Boolean` | `true` | 控制是否启用 `trackOver` 行为。 | `trackOver: true` |

## 方法

| 方法 | 参数 | 说明 | 调用示例 |
| --- | --- | --- | --- |
| `initComponent` | `` | 初始化组件及其子项。 执行时会保留父类默认行为、更新 `selectedItemCls`、`overItemCls` 状态。源码涉及 `addCls()`、`getInnerTpl()`、`createPagingToolbar()`、`callParent()`。 | `component.initComponent()` |
| `getRefOwner` | `` | 读取并返回 `refOwner`。 执行时会保留父类默认行为。源码涉及 `callParent()`。 | `component.getRefOwner()` |
| `getRefItems` | `` | 读取并返回 `refItems`。 | `component.getRefItems()` |
| `createPagingToolbar` | `` | 创建 `pagingToolbar`。源码涉及 `getComponentLayout()`。 | `component.createPagingToolbar()` |
| `finishRenderChildren` | `` | 完成 `renderChildren`。 执行时会保留父类默认行为。源码涉及 `callParent()`。 | `component.finishRenderChildren()` |
| `refresh` | `` | 刷新组件。 执行时会保留父类默认行为。源码涉及 `callParent()`。 | `component.refresh()` |
| `bindStore` | `store, initial` | 绑定 `store`。 执行时会保留父类默认行为。源码涉及 `callParent()`。 | `component.bindStore(...)` |
| `getTargetEl` | `` | 读取并返回 `targetEl`。 | `component.getTargetEl()` |
| `getNodeContainer` | `` | 读取并返回 `nodeContainer`。 | `component.getNodeContainer()` |
| `getInnerTpl` | `displayField` | 读取并返回 `innerTpl`。 | `component.getInnerTpl(...)` |
| `onDestroy` | `` | 处理 `destroy` 回调。 执行时会保留父类默认行为。源码涉及 `callParent()`。 | `component.onDestroy()` |

## 事件

源码中未找到该组件自身注册的事件；可监听继承事件。

Source: https://ag.879818327.xyz/ext/data/view-boundlist/index.mdx