SweetAlert2：自定义确认按钮文本的完整教程-php教程-PHP中文网

SweetAlert2：自定义确认按钮文本的完整教程

心靈之曲

发布： 2025-09-22 10:38:24

原创

576人浏览过

SweetAlert2：自定义确认按钮文本的完整教程

本教程详细介绍了如何在SweetAlert2中自定义弹窗的确认按钮文本。通过配置Swal.fire函数中的confirmButtonText选项，用户可以轻松地将默认的“Ok”文本修改为任何自定义文本，甚至包含HTML内容，从而提升用户体验和界面一致性。

sweetalert2是一个功能强大且高度可定制的javascript弹窗库，广泛应用于web开发中，用于替代浏览器原生的alert()、confirm()和prompt()。它提供了丰富的配置选项，允许开发者精细控制弹窗的各个方面，包括按钮的文本。

理解Swal.fire与confirmButtonText

在SweetAlert2中，创建弹窗的主要方法是调用Swal.fire()函数。此函数接受一个配置对象作为参数，通过设置该对象中的属性来定制弹窗的行为和外观。要修改确认按钮的默认文本（通常是“Ok”），我们需要使用confirmButtonText属性。

confirmButtonText属性的值可以是纯文本字符串，也可以是包含HTML标签的字符串，这为按钮文本的样式和内容提供了极大的灵活性。

示例：修改确认按钮文本

假设您正在使用以下代码来显示一个基于后端数据的弹窗：

$(document).ready(function(){
    let popup_shown = false;
    let cookies = document.cookie.split('; ');
    for( let i=0; i<cookies.length; i++ ){
        let cookie = cookies[i].split('=');
        if( cookie[0] === 'zxczxc' )
            popup_shown = true;
    }
    if( !popup_shown ){
        var popup_data = '{!! $output !!}'; // 假设 $output 包含HTML内容
        Swal.fire({ html:popup_data }); // 默认确认按钮文本为“Ok”
        document.cookie = "zxczxc=1; path=/";
    }
});

登录后复制

要将确认按钮的文本从默认的“Ok”更改为“知道了”或“继续”，只需在Swal.fire的配置对象中添加confirmButtonText属性即可：

$(document).ready(function(){
    let popup_shown = false;
    let cookies = document.cookie.split('; ');
    for( let i=0; i<cookies.length; i++ ){
        let cookie = cookies[i].split('=');
        if( cookie[0] === 'zxczxc' )
            popup_shown = true;
    }
    if( !popup_shown ){
        var popup_data = '{!! $output !!}';
        Swal.fire({
            html: popup_data,
            confirmButtonText: '知道了' // 自定义确认按钮文本
        });
        document.cookie = "zxczxc=1; path=/";
    }
});

登录后复制

高级定制：HTML内容与辅助功能

confirmButtonText不仅支持纯文本，还可以包含HTML内容，这意味着您可以为按钮添加图标、粗体文本或其他自定义样式。此外，为了提高可访问性，建议为包含非纯文本的按钮设置confirmButtonAriaLabel属性，为屏幕阅读器提供清晰的描述。

通义听悟

阿里云通义听悟是聚焦音视频内容的工作学习AI助手，依托大模型，帮助用户记录、整理和分析音视频内容，体验用大模型做音视频笔记、整理会议记录。

查看详情

以下是一个更全面的示例，展示了如何使用HTML、图标以及如何添加取消按钮并自定义其文本：

Swal.fire({
  title: '<strong>HTML <u>示例</u></strong>', // 弹窗标题支持HTML
  icon: 'info', // 弹窗图标
  html:
    '您可以使用 <b>粗体文本</b>, ' +
    '<a href="//sweetalert2.github.io">链接</a> ' +
    '以及其他HTML标签', // 弹窗内容支持HTML
  showCloseButton: true, // 显示关闭按钮
  showCancelButton: true, // 显示取消按钮
  focusConfirm: false, // 不自动聚焦确认按钮
  confirmButtonText:
    '<i class="fa fa-thumbs-up"></i> 太棒了!', // 确认按钮文本，包含Font Awesome图标
  confirmButtonAriaLabel: '点赞，太棒了!', // 确认按钮的ARIA标签，用于辅助功能
  cancelButtonText:
    '<i class="fa fa-thumbs-down"></i>', // 取消按钮文本，包含Font Awesome图标
  cancelButtonAriaLabel: '点踩' // 取消按钮的ARIA标签
});

登录后复制

在这个例子中：

confirmButtonText被设置为一个包含<i>标签（用于Font Awesome图标）和文本的HTML字符串。
confirmButtonAriaLabel为确认按钮提供了可访问性描述。
showCancelButton: true启用了取消按钮，并且cancelButtonText和cancelButtonAriaLabel也进行了相应的定制。

注意事项

版本差异： 请确保您使用的是SweetAlert2 (Swal.fire)，而不是旧版SweetAlert (swal)。两者的API有所不同，旧版的swal()函数可能使用不同的参数结构。本教程中所有示例均基于SweetAlert2。
HTML内容： 当confirmButtonText包含HTML时，SweetAlert2会自动对其进行渲染。请确保您提供的HTML是安全且格式正确的。
可访问性： 为了提供更好的用户体验，特别是对于使用屏幕阅读器的用户，强烈建议在使用自定义或HTML格式的按钮文本时，同时设置confirmButtonAriaLabel和cancelButtonAriaLabel。
官方文档： SweetAlert2的官方GitHub页面（https://www.php.cn/link/342312606e8c4777d1db65ec26526022）是获取最新信息和更详细配置选项的最佳资源。