返回介绍

开发指南

组件

JS

模板

Toast 消息提示

发布于 2021-04-03 05:35:24 字数 3451 浏览 881 评论 0 收藏 0

Toast 消息提示 基本使用

以下为一个模拟登录成功后,弹出toast提示,并在一定时间(默认2000ms)后,自动跳转页面到个人中心页(也可以配置跳转的参数)的示例

<template>
	<view>
		<u-toast ref="uToast" />
	</view>
</template>

<script>
	export default {
		methods: {
			showToast() {
				this.$refs.uToast.show({
					title: '登录成功',
					type: 'success',
					url: '/pages/user/index'
				})
			}
		}
	}
</script>

配置toast主题

一共有6种主题可选,如下:

  • default-灰黑色,最普通的场景,此为默认主题,可以不用填type参数
  • error-红色,代表错误
  • success-绿色,代表成功
  • warning-黄色,代表警告
  • info-灰色,比default浅一点
  • primary-蓝色,uView的主色调

除了default状态,其他5种主题,都是默认带有一个左边的图标,可以通过配置icon参数为none来取消

this.$refs.uToast.show({
	title: '操作成功',
	// 如果不传此type参数,默认为default,也可以手动写上 type: 'default'
	// type: 'success', 
	// 如果不需要图标,请设置为false
	// icon: false
})

toast结束跳转URL

  • 如果配置了url参数,在toast结束的时候,就会用uni.navigateTo(默认)或者uni.switchTab(需另外设置isTabtrue)
  • 如果配置了params参数,就会在跳转时自动在URL后面拼接上这些参数,具体用法如下:
this.$refs.uToast.show({
	title: '操作成功',
	url: '/pages/user/index',
	params: {
		id: 1,
		menu: 3
	}
})

API

Props

参数说明类型默认值可选值
z-indextoast展示时的z-indexString | Number10090-

Params

这些参数为通过ref调用<toast/>组件内部的show方法时,需要传递参数

参数说明类型默认值可选值
title显示的文本String--
type主题类型,不填默认为defaultStringdefaultprimary / success / error / warning / info
durationtoast的持续时间,单位msNubmer2000-
urltoast结束跳转的url,不填不跳转,优先级高于back参数String--
icon是否显示显示type对应的图标,为false不显示图标Booleantruefalse
positiontoast出现的位置Stringcentertop / bottom
callback 1.3.6toast结束后执行的回调方法Function--
isTabtoast结束后,跳转tab页面时需要配置为trueBooleanfalsetrue
back 1.4.0toast结束后,是否返回上一页,优先级低于url参数Booleanfalsetrue

Methods

方法是通过ref调用的,参见上方说明 注意:所有有关ref的调用,都不能在页面的onLoad生命周期调用,因为此时组件尚未创建完毕,会报错,应该在onReady生命周期调用。

方法名说明参数版本
show显示toast,如需一进入页面就显示toast,请在onReady生命周期调用见上方说明-

如果你对这篇内容有疑问,欢迎到本站社区发帖提问 参与讨论,获取更多帮助,或者扫码二维码加入 Web 技术交流群。

扫码二维码加入Web技术交流群

发布评论

需要 登录 才能够评论, 你可以免费 注册 一个本站的账号。
列表为空,暂无数据
    我们使用 Cookies 和其他技术来定制您的体验包括您的登录状态等。通过阅读我们的 隐私政策 了解更多相关信息。 单击 接受 或继续使用网站,即表示您同意使用 Cookies 和您的相关数据。
    原文