wxc-toast

MinUI 小程序组件 - 提示框

Install

  1. $ min install @minui/wxc-toast

Demos

title传值

属性传参设置文案

提示框 toast - 图1

  1. <template>
  2. <wxc-toast
  3. is-show="{{$toast.show}}"
  4. text="Hello World"></wxc-toast>
  5. <button bindtap="showToast">属性传值</button>
  6. </template>
  7. <script>
  8. export default {
  9. config: {
  10. usingComponents: {
  11. 'wxc-toast': '@minui/wxc-toast'
  12. }
  13. },
  14. data: {
  15. $toast: {
  16. show: false
  17. }
  18. },
  19. /** note: 在 wxp 文件或者页面文件中请去掉 methods 包装 */
  20. methods: {
  21. showToast() {
  22. this.setData({
  23. $toast: {
  24. show: true
  25. }
  26. })
  27. setTimeout(() => {
  28. this.setData({
  29. $toast: {
  30. show: false
  31. }
  32. })
  33. }, 1500)
  34. }
  35. }
  36. }
  37. </script>
  38. <style>
  39. </style>

自定义 icon 色

设置 icon 颜色 #ff5777

提示框 toast - 图2

  1. <template>
  2. <wxc-toast
  3. is-show="{{$toast.show}}"
  4. text="分享成功"
  5. icon="yes"
  6. icon-color="#ff5777"
  7. ></wxc-toast>
  8. <button bindtap="showToast">自定义 icon 颜色的 toast</button>
  9. </template>
  10. <script>
  11. export default {
  12. config: {
  13. usingComponents: {
  14. 'wxc-toast': '@minui/wxc-toast'
  15. }
  16. },
  17. data: {
  18. $toast: {
  19. show: false
  20. }
  21. },
  22. /** note: 在 wxp 文件或者页面文件中请去掉 methods 包装 */
  23. methods: {
  24. showToast() {
  25. this.setData({
  26. $toast: {
  27. show: true
  28. }
  29. })
  30. setTimeout(() => {
  31. this.setData({
  32. $toast: {
  33. show: false
  34. }
  35. })
  36. }, 1500)
  37. }
  38. }
  39. }
  40. </script>
  41. <style>
  42. </style>

自定义 icon 图

自定义 icon 图片

提示框 toast - 图3

  1. <template>
  2. <wxc-toast
  3. is-show="{{$toast.show}}"
  4. src="https://s10.mogucdn.com//mlcdn/c45406/171017_885a650c746k7hajhf04aja566h1i_68x68.png"
  5. text="{{$toast.title}}"></wxc-toast>
  6. <button bindtap="showToast">自定义 icon 图片的 toast</button>
  7. </template>
  8. <script>
  9. export default {
  10. config: {
  11. usingComponents: {
  12. 'wxc-toast': '@minui/wxc-toast'
  13. }
  14. },
  15. data: {
  16. $toast: {
  17. show: false,
  18. title: ""
  19. }
  20. },
  21. /** note: 在 wxp 文件或者页面文件中请去掉 methods 包装 */
  22. methods: {
  23. showToast() {
  24. this.setData({
  25. $toast: {
  26. show: true,
  27. title: "自定义 icon 图片"
  28. }
  29. });
  30. setTimeout(() => {
  31. this.setData({
  32. $toast: {
  33. show: false,
  34. title: ''
  35. }
  36. })
  37. }, 1500)
  38. }
  39. }
  40. }
  41. </script>
  42. <style>
  43. </style>

设置 icon

设置 icon 为 yes

提示框 toast - 图4

  1. <template>
  2. <wxc-toast
  3. is-show="{{$toast.show}}"
  4. icon="yes"
  5. >分享成功</wxc-toast>
  6. <button bindtap="showToast">一个带 icon 的 toast</button>
  7. </template>
  8. <script>
  9. export default {
  10. config: {
  11. usingComponents: {
  12. 'wxc-toast': '@minui/wxc-toast'
  13. }
  14. },
  15. data: {
  16. $toast: {
  17. show: false
  18. }
  19. },
  20. /** note: 在 wxp 文件或者页面文件中请去掉 methods 包装 */
  21. methods: {
  22. showToast() {
  23. this.setData({
  24. $toast: {
  25. show: true
  26. }
  27. })
  28. setTimeout(() => {
  29. this.setData({
  30. $toast: {
  31. show: false
  32. }
  33. })
  34. }, 1500)
  35. }
  36. }
  37. }
  38. </script>
  39. <style>
  40. </style>

子元素传值

子元素设置文案

提示框 toast - 图5

  1. <template>
  2. <wxc-toast is-show="{{$toast.show}}">Hello World</wxc-toast>
  3. <button bindtap="showToast">子元素传值</button>
  4. </template>
  5. <script>
  6. export default {
  7. config: {
  8. usingComponents: {
  9. 'wxc-toast': '@minui/wxc-toast'
  10. }
  11. },
  12. data: {
  13. $toast: {
  14. show: false
  15. }
  16. },
  17. /** note: 在 wxp 文件或者页面文件中请去掉 methods 包装 */
  18. methods: {
  19. showToast() {
  20. this.setData({
  21. $toast: {
  22. show: true
  23. }
  24. })
  25. setTimeout(() => {
  26. this.setData({
  27. $toast: {
  28. show: false
  29. }
  30. })
  31. }, 1500)
  32. }
  33. }
  34. }
  35. </script>
  36. <style>
  37. </style>

长文案支持

长文案提示,文案换行显示

提示框 toast - 图6

  1. <template>
  2. <wxc-toast
  3. is-show="{{$toast.show}}"
  4. text="当文案比较多需要换行的时候那就需要换行"></wxc-toast>
  5. <button bindtap="showToast">一个长文案 toast</button>
  6. </template>
  7. <script>
  8. export default {
  9. config: {
  10. usingComponents: {
  11. 'wxc-toast': '@minui/wxc-toast'
  12. }
  13. },
  14. data: {
  15. $toast: {
  16. show: false
  17. }
  18. },
  19. /** note: 在 wxp 文件或者页面文件中请去掉 methods 包装 */
  20. methods: {
  21. showToast() {
  22. this.setData({
  23. $toast: {
  24. show: true
  25. }
  26. })
  27. setTimeout(() => {
  28. this.setData({
  29. $toast: {
  30. show: false
  31. }
  32. })
  33. }, 1500)
  34. }
  35. }
  36. }
  37. </script>
  38. <style>
  39. </style>

调用show方法显示

调用 show(message) 方法显示 toast

  1. <template>
  2. <wxc-toast
  3. class="J_toast"
  4. text="Hello World"></wxc-toast>
  5. <button bindtap="showToast">调用 show() 方法显示</button>
  6. </template>
  7. <script>
  8. export default {
  9. config: {
  10. usingComponents: {
  11. 'wxc-toast': '@minui/wxc-toast'
  12. }
  13. },
  14. data: {},
  15. /** note: 在 wxp 文件或者页面文件中请去掉 methods 包装 */
  16. methods: {
  17. showToast() {
  18. let $toast = this.selectComponent(".J_toast")
  19. $toast && $toast.show('这是show方法传值')
  20. }
  21. }
  22. }
  23. </script>
  24. <style>
  25. </style>

API

Toast【props】

名称描述
is-show[说明]: toast 显示控制字段。类型:Boolean默认值:false
text[说明]:提示的文案,必填。类型:String默认值:""
icon[说明]:图标。类型:String默认值:"" 可选值详见 wxc-icon 组件中的 type 属性
icon-image[说明]:【已废弃,请使用 src 】自定义图标图片的路径,优先级高于 icon。类型:String默认值:""
src[说明]:自定义图标图片的路径,优先级高于 icon。类型:String默认值:""
icon-color[说明]:图标颜色。类型:String默认值:"#fff"
duration[说明]:提示的延迟时间,单位毫秒。类型:Number默认值:2000
bind:success[说明]:调用成功的回调函数。

Toast【methods】

名称描述
show(msg)[说明]:显示toast。[类型]:Function[参数]:String[返回]:void
地址
toast 组件文档 https://meili.github.io/min/docs/minui/index.html#toast
toast 组件源码 https://github.com/meili/minui/tree/master/packages/wxc-toast
MinUI 组件库 https://github.com/meili/minui

Preview

toast

ChangeLog

v1.0.8(2018.03.29)

  • show() 方法增加 message 参数

v1.0.7(2018.01.16)

  • icon-image 属性更改为 src,1.0.7 及以上版本的 min 支持本地图片路径

v1.0.6(2018.01.09)

  • z-index 层级规范方案修改

v1.0.3(2018.01.04)

  • 修复自定义 icon 时,icon 的颜色样式问题,规范 z-index 规范

v1.0.2(2017.11.02)

  • update .npmignore

v1.0.1(2017.10.24)

  • 初始版本