Files
2025-10-01 10:01:52 +08:00

3.4 KiB
Raw Permalink Blame History

title, description, spline, isComponent
title description spline isComponent
Toast 轻提示 用于轻量级反馈或提示,不会打断用户操作。 message true

引入

全局引入,在 miniprogram 根目录下的app.json中配置,局部引入,在需要引入的页面或组件的index.json中配置。

"usingComponents": {
  "t-toast": "tdesign-miniprogram/toast/toast"
}

代码演示

在开发者工具中预览效果

Tips: 请确保开发者工具为打开状态。导入开发者工具后依次执行npm i > 构建npm包 > 勾选 "将JS编译成ES5"

基础提示

{{ base }}

组件状态

{{ theme }}

显示遮罩

{{ cover }}

手动关闭

{{ close }}

API

Toast Props

名称 类型 默认值 描述 必传
style Object - 样式 N
custom-style Object - 样式,一般用于开启虚拟化组件节点场景 N
direction String row 图标排列方式。可选项row/column N
duration Number 2000 弹窗显示毫秒数 N
icon String / Object / Slot - 自定义图标。传入对象则透传至 Icon 组件。通用类型定义 N
message String / Slot - 弹窗显示文字。通用类型定义 N
overlay-props Object - 遮罩层属性,透传至 Overlay。TS 类型:OverlayProps Overlay API Documents详细类型定义 N
placement String middle 弹窗展示位置。可选项: top/middle/bottom N
prevent-scroll-through Boolean false 防止滚动穿透,即不允许点击和滚动 N
show-overlay Boolean false 是否显示遮罩层 N
theme String - 提示类型。可选项loading/success/error N
using-custom-navbar Boolean false 是否使用了自定义导航栏 N

Toast Events

名称 参数 描述
close - 轻提示隐藏的时候触发
destroy - 轻提示销毁的时候触发

Toast External Classes

类名 描述
t-class 根节点样式类

CSS Variables

组件提供了下列 CSS 变量,可用于自定义样式。

名称 默认值 描述
--td-toast-bg-color @font-gray-2 -
--td-toast-color @font-white-1 -
--td-toast-column-icon-size 64rpx -
--td-toast-max-width 374rpx -
--td-toast-radius 8rpx -
--td-toast-row-icon-size 48rpx -