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

2.4 KiB
Raw Blame History

category subtitle type title cols
Components 标签页 数据展示 Tabs 1

选项卡切换组件。

何时使用

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

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

  • 卡片式的页签,提供可关闭的样式,常用于容器顶部。
  • 标准线条式页签,用于容器内部的主功能切换,这是最常用的 Tabs。
  • RadioButton 可作为更次级的页签来使用。

API

Tabs

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

Tabs.TabPane

参数 说明 类型 默认值
forceRender 被隐藏时是否渲染 DOM 结构 boolean false
key 对应 activeKey string
tab 选项卡头显示文字 string|ReactNode