Toast 轻提示

一种轻量级反馈/提示,可以用来显示不会打断用户操作的内容,适合用于页面转场、数据交互的等场景中。

规则

  • 一次只显示一个 toast。

  • 有 Icon 的 Toast,字数为 4-6 个;没有 Icon 的 Toast,字数不宜超过 14 个。

代码演示

基本

text、icon、success、failure、offline、loading

  1. import { Toast, WhiteSpace, WingBlank, Button, Icon } from 'antd-mobile';
  2. function showToast() {
  3. Toast.info('This is a toast tips !!!', 1);
  4. }
  5. function showToastNoMask() {
  6. Toast.info('Toast without mask !!!', 2, null, false);
  7. }
  8. function successToast() {
  9. Toast.success('Load success !!!', 1);
  10. }
  11. function failToast() {
  12. Toast.fail('Load failed !!!', 1);
  13. }
  14. function offline() {
  15. Toast.offline('Network connection failed !!!', 1);
  16. }
  17. function loadingToast() {
  18. Toast.loading('Loading...', 1, () => {
  19. console.log('Load complete !!!');
  20. });
  21. }
  22. /* eslint global-require: 0 */
  23. const ToastExample = () => (
  24. <WingBlank>
  25. <WhiteSpace />
  26. <Button onClick={showToast}>Text toast</Button>
  27. <WhiteSpace />
  28. <Button onClick={showToastNoMask}>Without mask</Button>
  29. <WhiteSpace />
  30. <Button onClick={() => Toast.info(<Icon type={require('./reload.svg')} />, 1)}>
  31. Cumstom Icon
  32. </Button>
  33. <WhiteSpace />
  34. <Button onClick={successToast}>Success toast</Button>
  35. <WhiteSpace />
  36. <Button onClick={failToast}>Failed toast</Button>
  37. <WhiteSpace />
  38. <Button onClick={offline}>Network failure toast</Button>
  39. <WhiteSpace />
  40. <Button onClick={loadingToast}>Loading toast</Button>
  41. <WhiteSpace />
  42. </WingBlank>
  43. );
  44. ReactDOM.render(<ToastExample />, mountNode);

Toast轻提示 - 图1

API

适用平台:WEB、React-Native
  • Toast.success(content, duration, onClose, mask)

  • Toast.fail(content, duration, onClose, mask)

  • Toast.info(content, duration, onClose, mask)

  • Toast.loading(content, duration, onClose, mask)

  • Toast.offline(content, duration, onClose, mask)

组件提供了五个静态方法,参数如下:
属性说明类型默认值
content提示内容React.Element or String
duration自动关闭的延时,单位秒number3
onClose关闭后回调Function
mask是否显示透明蒙层,防止触摸穿透Booleantrue

注: duration = 0 时,onClose 无效,toast 不会消失;隐藏 toast 需要手动调用 hide

还提供了全局配置和全局销毁方法:
  • Toast.hide()