---
title: "Ext.button.Cycle"
description: "xtype 为 cycle 的 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.button.Cycle

源码定义：`ext-all-debug.js:60184`。分类：按钮、工具栏、菜单与标签页。

## 创建示例

```javascript
var component = Ext.create("Ext.button.Cycle", {
  xtype: "cycle",
  renderTo: Ext.getBody()
});
```

## 属性

源码中未找到该组件自身声明的可提取配置项；它可能主要继承父类配置。

## 方法

| 方法 | 参数 | 说明 | 调用示例 |
| --- | --- | --- | --- |
| `getButtonText` | `item` | 读取并返回 `buttonText`。 | `component.getButtonText(...)` |
| `setActiveItem` | `item, suppressEvent` | 设置 `activeItem`。 执行时会派发 `change` 事件、更新 `text`、`iconCls` 状态。源码涉及 `getButtonText()`、`setText()`、`setIconCls()`、`setGlyph()`。 | `component.setActiveItem(...)` |
| `getActiveItem` | `` | 读取并返回 `activeItem`。 | `component.getActiveItem()` |
| `initComponent` | `` | 初始化组件及其子项。 执行时会保留父类默认行为、更新 `menu`、`itemCount` 状态。源码涉及 `addEvents()`、`on()`、`callParent()`、`setActiveItem()`。 | `component.initComponent()` |
| `checkHandler` | `item, pressed` | 处理 `checkHandler` 操作。源码涉及 `setActiveItem()`。 | `component.checkHandler(...)` |
| `toggleSelected` | `` | 切换 `selected`。 | `component.toggleSelected()` |

## 事件

| 事件 | 说明 | 监听示例 |
| --- | --- | --- |
| `change` | 组件值发生变化时触发。 源码在 `setActiveItem()` 中通过 `fireEvent()` 触发。 | `listeners: { change: function () {} }` |

Source: https://ag.879818327.xyz/ext/navigation/button-cycle/index.mdx