# 复杂选项卡 JumboTabs

- 页面: https://jiguang132.com/zh/resources/ant-design-mobile/docs/jumbo-tabs
- 资源: Ant Design Mobile (https://jiguang132.com/zh/resources/ant-design-mobile.md)
- 全部指南: https://jiguang132.com/zh/resources/ant-design-mobile/docs.md

内容组之间进行导航切换。

## 安装

```bash
npm install antd-mobile@5.43.0
```

antd-mobile 是移动网页组件库，不是 React Native 或小程序组件。React 19 项目需在入口用 `unstableSetRender` 注册 `createRoot`，否则 Toast、Dialog 等命令式 API 无法渲染；深色模式通过 `<html data-prefers-color-scheme="dark">` 切换。

示例来自 Ant Design Mobile 官方仓库（MIT），固定在 npm 5.43.0 对应的提交；示例中的 `DemoBlock` 等展示辅助组件由 JGuang 重写，不属于 antd-mobile 的 API。

内容组之间进行导航切换。

## 何时使用

选项需要有进一步描述时，用在展示型界面的列表或模块中。

## 示例

## JumboTabs

### 属性

| 属性 | 说明 | 类型 | 默认值 |
| --- | --- | --- | --- |
| activeKey | 当前激活 `tab` 面板的 `key` | `string \| null` | - |
| defaultActiveKey | 初始化选中面板的 `key`，如果没有设置 `activeKey` | `string \| null` | 第一个面板的 `key` |
| onChange | 切换面板的回调 | `(key: string) => void` | - |

## JumboTabs.Tab

| 属性           | 说明                        | 类型        | 默认值  |
| -------------- | --------------------------- | ----------- | ------- |
| description    | 选项卡描述                  | `ReactNode` | -       |
| destroyOnClose | 不可见时是否销毁 `DOM` 结构 | `boolean`   | `false` |
| disabled       | 是否禁用                    | `boolean`   | `false` |
| forceRender    | 被隐藏时是否渲染 `DOM` 结构 | `boolean`   | `false` |
| key            | 对应 `activeKey`            | `string`    | -       |
| title          | 选项卡头显示文字            | `ReactNode` | -       |

JumboTabs 的用法和 Tabs 非常相似，所以关于更多的用法上的指引，请参阅 [Tabs](/zh/components/tabs) 的文档。

---

JGuang 全部资源索引: https://jiguang132.com/llms.txt