Toast

Toast

demo 原始链接demo 源码编辑文档组件源码

toast - 图1

二维码

toast - 图2

Install

安装

局部注册

全局注册

  1. import { Toast } from 'vux'
  3. export default {
  4.   components: {
  5.     Toast
  6.   }
  7. }

  1. // 在入口文件全局引入
  3. import Vue from 'vue'
  4. import { Toast } from 'vux'
  6. Vue.component('toast', Toast)

该组件支持以plugin形式调用：

以插件形式调用时，和template中使用不同，属性名请使用小驼峰式，比如isShowMask而不是is-show-mask。

  1. import  { ToastPlugin } from 'vux'
  2. Vue.use(ToastPlugin)
  4. // 或者umd方式
  5. // 引入构建的js文件
  6. Vue.use(vuxToastPlugin)
  8. // 默认参数
  9. Vue.use(ToastPlugin, {position: 'top'})
  1. // 显示
  2. this.$vux.toast.show({
  3.  text: 'Loading'
  4. })
  6. // 显示文字
  7. this.$vux.toast.text('hello', 'top')
  9. // 隐藏
  10. this.$vux.toast.hide()
  12. // 获取显示状态
  13. this.$vux.toast.isVisible() // v2.9.1 开始支持

API

属性

名字类型默认值说明版本要求
valuebooleanfalse是否显示, 使用 v-model 绑定—
timenumber2000显示时间—
typestringsuccess类型，可选值 success, warn, cancel, text—
widthstring7.6em宽度—
is-show-maskbooleanfalse是否显示遮罩，如果显示，用户将不能点击页面上其他元素—
textstring提示内容，支持 html，和默认slot同样功能—
positionstringdefault显示位置，可选值 default, top, middle, bottomv2.1.1-rc.4

事件

名字参数说明版本要求
@on-show—提示弹出时触发—
@on-hide—提示隐藏时触发—

插槽

名字说明版本要求
默认插槽默认slot, 提示内容—

Variables

## 样式变量


名字默认值说明继承自变量
@toast-content-font-size 16px 内容文本大小
@toast-top 180px 默认状态下距离顶部的高度
@toast-position-top-offset 10px 顶部显示的高度
@toast-position-bottom-offset 10px 底部显示的高度
@toast-z-index 5001 z-index

Issues

相关 issue

贡献者

贡献者

该组件(包含文档)迭代次数 29，贡献人数 3
airylandLinHaobinwg

Changelog

发布日志

  • v2.9.1 [feature] 添加 isVisible 获取当前显示状态 #2704
  • v2.7.7 [fix] 插件 options 参数作为toast的默认参数
  • v2.6.3 [fix] 修复 type 为 text 时使用 slot 缺失 padding 样式的问题
  • v2.5.8 [fix] zIndex 值应该比 XDialog 大 #1820
  • v2.3.1 [feature] 为插件添加 text 方法方便调用
  • v2.1.1-rc.13 [fix] 修复 调用后没有设置webkitOverflowScrolling为touch
  • v2.1.1-rc.10 [fix] 修复警告图标样式
  • v2.1.1-rc.9 [enhance] 插件调用时每次都重置为默认参数 #870 @jsonviewer
  • v2.1.1-rc.6 [fix] 修复禁止样式被覆盖 #1016 @LaiXuechao
  • v2.1.1-rc.4 [feature] 支持显示位置设置 #973 @LaiXuechao
  • v2.1.1-rc.2 [feature] 支持更多 less 变量
  • v2.0.0 [change] 使用 v-model 而不是:show.sync进行显示属性绑定
  • v2.0.0 [change] 默认不显示遮罩
  • v2.0.0 [feature] 添加 isShowMask 属性