Bootstrap按钮加载中状态 LoadingButton实现

酷涛姑娘_3375

酷涛姑娘_3375

2026-05-23

425人浏览

原创

Bootstrap 5 中按钮 loading 状态需手动实现:必须同时设置 disabled="true"、aria-disabled="true",替换文本并插入 spinner-border 元素;恢复时移除禁用属性并还原原始文案,且所有操作须在 finally 块中统一处理。

bootstrap按钮加载中状态 loadingbutton实现

Bootstrap 5 中如何让按钮进入 loading 状态

原生 Bootstrap 不提供 loading 属性或内置的加载中按钮组件,必须手动控制按钮的禁用状态、文字和视觉反馈。最稳妥的做法是用 JavaScript 动态切换 disabled 属性、替换 innerText,并添加 spinner 子元素。

常见错误是只加 spinner 不禁用按钮,导致用户重复点击;或用了 opacity: 0.6 却没设 pointer-events: none,依然可触发事件。

  • 务必同时设置 disabled="true" 和 aria-disabled="true",确保语义与交互一致
  • 推荐使用 Bootstrap 5 内置的 ,避免自定义 SVG 尺寸错位
  • 文字替换建议用 data-loading-text 自定义属性预存文案,方便复用

用纯 JS 实现一个可复用的 LoadingButton 函数

不需要引入额外库,一段轻量函数就能封装通用逻辑。核心是保存原始文本、插入 spinner、阻止重复提交。

示例场景:表单提交按钮点击后显示加载中,请求完成再恢复。

function setLoading(btn, isLoading) {
  const originalText = btn.dataset.originalText || btn.innerText;
  if (isLoading) {
    btn.disabled = true;
    btn.setAttribute('aria-disabled', 'true');
    btn.dataset.originalText = originalText;
    const spinner = document.createElement('span');
    spinner.className = 'spinner-border spinner-border-sm me-2';
    spinner.setAttribute('role', 'status');
    spinner.setAttribute('aria-hidden', 'true');
    btn.innerHTML = '';
    btn.appendChild(spinner);
    btn.appendChild(document.createTextNode(btn.dataset.loadingText || '加载中...'));
  } else {
    btn.disabled = false;
    btn.removeAttribute('aria-disabled');
    btn.innerText = originalText;
  }
}
  • btn.dataset.loadingText 可在 HTML 中提前写好:
  • 注意用 innerHTML = '' 清空再重插,避免多次点击造成多个 spinner 堆叠
  • 若按钮含图标(如 ),需改用 textContent + 克隆节点方式保留结构

Vue / React 项目里怎么避免重复实现

在框架中不应每次都在 click 回调里手动调用 setLoading,应抽象为指令或 Hook。

Vue 3 的自定义指令示例(v-loading):

VPS Bootstrap
VPS Bootstrap

从零启动全新 VPS,完成 OpenClaw 完整部署,包括备份/恢复及恢复后验证。用于 OpenClaw 部署。

下载
app.directive('loading', {
  beforeMount(el, binding) {
    el.dataset.loadingText = binding.value.text || '加载中...';
  },
  updated(el, binding) {
    setLoading(el, binding.value.active);
  }
});

React 中建议封装为 useLoadingButton Hook:

function useLoadingButton() {
  const [loading, setLoading] = useState(false);
  const toggleLoading = useCallback((state) => setLoading(state), []);
  return { loading, toggleLoading };
}
  • Vue 指令要监听 updated 钩子,因为 active 是响应式变量,值变化时需同步 UI
  • React 中别直接在事件里 setLoading(true) 后发请求——异步链断裂时容易忘记关 loading
  • 所有框架方案都绕不开「请求开始 → 启动 loading → 请求结束 → 关闭 loading」这个三段式流程,漏掉任一环节就会卡死按钮

为什么不能只靠 CSS 类名切换来实现 loading 效果

仅靠添加 .disabled 类或自定义 .btn-loading 类,无法真正阻止点击事件传播,也不满足无障碍要求。

典型问题:

  • 用户仍可用回车键或空格键触发按钮(button 元素默认可聚焦且可激活)
  • 屏幕阅读器不会感知“正在加载”,因为它没收到 aria-disabled="true" 或 aria-busy="true"
  • 移动端 touchstart 事件可能穿透,尤其在 fastclick 未关闭时
  • CSS 动画 spinner 若用 visibility: hidden 替代 display: none,仍占布局空间,影响按钮高度一致性

loading 状态的本质是状态同步:DOM 属性、A11Y 属性、视觉呈现、事件响应,四者必须严格一致。少一个,就不是真正的 loading 状态。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

bootstrap

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2763

5

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

2023.10.09

6003

6

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

6950

13

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

2024.03.22

6718

10

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

2024.05.22

963

5

bootstrap框架介绍
bootstrap框架介绍

本专题整合了bootstrap框架相关介绍,阅读专题下面的文章了解更多详细内容。

2026.03.18

745

21

bootstrap安装教程
bootstrap安装教程

本专题整合了bootstrap安装相关教程,阅读专题下面的文章了解更多详细操作教程。

2026.03.18

199

9

Vite 项目如何打包和部署
Vite 项目如何打包和部署

Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章,帮助读者完成上线流程。

2026.10.28

80

16

Vite 如何搭配 Vue.js
Vite 如何搭配 Vue.js

Vite搭配Vue.js专题汇集创建Vue 3项目、配置开发环境、路径别名、Vue插件、代理、多环境构建与调试的已审核文章,帮助读者完成从初始化到日常开发的配置。

2026.10.28

60

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Bootstrap5 入门教程
Bootstrap5 入门教程

共0课时 | 0人学习

Bootstrap Components 组件文档
Bootstrap Components 组件文档

共0课时 | 0人学习

Bootstrap Grid 栅格系统
Bootstrap Grid 栅格系统

共0课时 | 0人学习