ant-design/components/tabs/index.zh-CN.md

category	subtitle	type	title	cols	cover
Components	标签页	数据展示	Tabs	1	https://gw.alipayobjects.com/zos/antfincdn/lkI2hNEDr2V/Tabs.svg

选项卡切换组件。

何时使用

提供平级的区域将大块内容进行收纳和展现，保持界面整洁。

Ant Design 依次提供了三级选项卡，分别用于不同的场景。

• 卡片式的页签，提供可关闭的样式，常用于容器顶部。
• 既可用于容器顶部，也可用于容器内部，是最通用的 Tabs。
• Radio.Button 可作为更次级的页签来使用。

API

Tabs

参数	说明	类型	默认值	版本
addIcon	自定义添加按钮	ReactNode	-	4.4.0
activeKey	当前激活 tab 面板的 key	string	-
animated	是否使用动画切换 Tabs，在 `tabPosition=top	bottom` 时有效	boolean | {inkBar:boolean, tabPane:boolean}	false
renderTabBar	替换 TabBar，用于二次封装标签头	(props: DefaultTabBarProps, DefaultTabBar: React.ComponentClass) => React.ReactElement	-
defaultActiveKey	初始化选中面板的 key，如果没有设置 activeKey	string	第一个面板
hideAdd	是否隐藏加号图标，在 type="editable-card" 时有效	boolean	false
size	大小，提供 large default 和 small 三种大小	string	default
centered	标签居中展示	boolean	false	4.4.0
tabBarExtraContent	tab bar 上额外的元素	React.ReactNode	-
tabBarGutter	tabs 之间的间隙	number	-
tabBarStyle	tab bar 的样式对象	object	-
tabPosition	页签位置，可选值有 top right bottom left	string	top
type	页签的基本样式，可选 line、card editable-card 类型	string	line
onChange	切换面板的回调	Function(activeKey) {}	-
onEdit	新增和删除页签的回调，在 type="editable-card" 时有效	(targetKey, action): void	-
onTabClick	tab 被点击的回调	Function(key: string, event: MouseEvent)	-
onTabScroll	tab 滚动时触发	Function({ direction: 'left' | 'right' | 'top' | 'bottom' })	-	4.3.0
keyboard	开启键盘切换功能	boolean	true

Tabs.TabPane

参数	说明	类型	默认值
forceRender	被隐藏时是否渲染 DOM 结构	boolean	false
key	对应 activeKey	string	-
tab	选项卡头显示文字	string|ReactNode	-
closeIcon	自定义关闭图标，在 type="editable-card"时有效	ReactNode	-