JGuang

按钮

Button · Arco Design

交互预览
npm install @arco-design/web-react@2.66.18

按钮 Button

按钮是一种命令组件,可发起一个即时操作。

安装

npm install @arco-design/web-react@2.66.18

在入口引入 @arco-design/web-react/dist/css/arco.css,用 ConfigProvider 设置语言。React 19 项目还需在入口最先引入 @arco-design/web-react/es/_util/react-19-adapter,否则 Message、Modal 等命令式 API 无法渲染。

示例

  • 基本用法:按钮分为 主要按钮、次要按钮、虚线按钮、线形按钮和文本按钮五种。
  • 图标按钮:Button 可以嵌入图标,在只设置图标而没有 children 时,按钮的高宽相等。
  • 按钮形状:Button 有多种形状,square - 长方形 (默认), circle - 圆形, round - 全圆角。
  • 按钮尺寸:按钮分为:迷你、小、中、大,四种尺寸。高度分别为:24px/28px/32px/36px。推荐及默认为尺寸「中」。可在不同场景及不同业务需求选择适合尺寸。
  • 按钮状态:按钮状态分为 警告,危险,成功 三种,可以与按钮类型同时生效,优先级高于按钮类型。
  • 禁用按钮:按钮的禁用状态。
  • 加载中按钮:通过设置loading可以让一个按钮处于加载中状态。处于加载中状态的按钮不会触发点击事件。
  • 组合按钮:可用在同级多项操作,以按钮组合方式出现。
  • 长按钮:按钮宽度随着容器宽度进行适配。

示例来自 Arco Design 官方仓库(MIT),固定在 npm 2.66.18 对应的提交;部分示例使用在线图片或上传地址,预览中网络请求被禁用。

API

Button

参数名描述类型默认值
disabled是否禁用boolean-
iconOnly只有图标,按钮宽高相等。如果指定 icon 且没有 children,iconOnly 默认为 trueboolean-
loading按钮是否是加载状态boolean-
loadingFixedWidth当 loading 的时候,不改变按钮的宽度。boolean-
long按钮宽度随容器自适应。boolean-
href添加跳转链接,设置此属性,button表现跟a标签一致string-
targeta 链接的 target 属性,href 存在时生效string-
htmlType按钮原生的 html type 类型'button' | 'submit' | 'reset'button
shape按钮形状,circle - 圆形, round - 全圆角, square - 长方形'circle' | 'round' | 'square'square
size按钮的尺寸'mini' | 'small' | 'default' | 'large'default
status按钮状态'warning' | 'danger' | 'success' | 'default'default
type按钮主要分为六种按钮类型:主要按钮、次级按钮、虚框按钮、文字按钮、线性按钮,default 为次级按钮。'default' | 'primary' | 'secondary' | 'dashed' | 'text' | 'outline'default
icon设置按钮的图标ReactNode-
anchorPropsa 链接的原生属性,href 存在时生效HTMLProps<HTMLAnchorElement>-
className节点类名string | string[]-
style节点样式CSSProperties-
onClick点击按钮的回调(e: Event) => void-