Docs: add English language support (#170)

* feat: support lang entry build * feat: vant support lang switch * move lang iframe-router to utils & fix router link bug * add en-US config && add some translation * chang async. to async_ (support superman cdn) * add layout translation * change nav style * upgrade zan-doc * fix: doc config * upgrade zan-doc && remove useless code * fix changelog generate path
2026-04-06 02:00:43 +08:00 · 2017-10-06 12:33:28 +08:00
parent 265fcbf2ef
commit 64ec6ce5ac
68 changed files with 439 additions and 135 deletions
--- a/docs/examples-docs/zh-CN/toast.md
+++ b/docs/examples-docs/zh-CN/toast.md
@@ -0,0 +1,166 @@
+<style>
+.demo-toast {
+  .van-button {
+    margin-left: 15px;
+  }
+}
+</style>
+
+<script>
+import { Toast } from 'packages';
+
+export default {
+  methods: {
+    showToast() {
+      Toast('我是提示文案，建议不超过十五字~');
+    },
+    showLoadingToast() {
+      Toast.loading();
+    },
+    showSuccessToast() {
+      Toast.success('成功文案');
+    },
+    showFailToast() {
+      Toast.fail('失败文案');
+    },
+    showCustomizedToast(duration) {
+      const toast = Toast.loading({
+        duration: 0,  
+        forbidClick: true,
+        message: '倒计时 3 秒'
+      });
+
+      let second = 3;
+      const timer = setInterval(() => {
+        second--;
+        if (second) {
+          toast.message = `倒计时 ${second} 秒`;
+        } else {
+          clearInterval(timer);
+          Toast.clear();
+        }
+      }, 1000);
+    }
+  }
+};
+</script>
+
+## Toast 轻提示
+
+### 使用指南
+
+```javascript
+import { Toast } from 'vant';
+```
+
+### 代码演示
+
+#### 文字提示
+
+:::demo 文字提示
+```html
+<van-button @click="showToast">文字提示</van-button>
+```
+
+```javascript
+export default {
+  methods: {
+    showToast() {
+      Toast('我是提示文案，建议不超过十五字~');
+    }
+  }
+}
+```
+:::
+
+#### 加载提示
+
+:::demo 加载提示
+```html
+<van-button @click="showLoadingToast">加载提示</van-button>
+```
+
+```javascript
+export default {
+  methods: {
+    showLoadingToast() {
+      Toast.loading();
+    }
+  }
+}
+```
+:::
+
+#### 成功/失败提示
+
+:::demo 成功/失败提示
+```html
+<van-button @click="showSuccessToast">成功提示</van-button>
+<van-button @click="showFailToast">失败提示</van-button>
+```
+
+```javascript
+export default {
+  methods: {
+    showSuccessToast() {
+      Toast.success('成功文案');
+    },
+    showFailToast() {
+      Toast.fail('失败文案');
+    }
+  }
+}
+```
+:::
+
+#### 高级用法
+
+:::demo 高级用法
+```html
+<van-button @click="showCustomizedToast">高级用法</van-button>
+```
+
+```javascript
+export default {
+  methods: {
+    showCustomizedToast() {
+      const toast = Toast.loading({
+        duration: 0,       // 持续展示 toast
+        forbidClick: true, // 禁用背景点击
+        message: '倒计时 3 秒'
+      });
+
+      let second = 3;
+      const timer = setInterval(() => {
+        second--;
+        if (second) {
+          toast.message = `倒计时 ${second} 秒`;
+        } else {
+          clearInterval(timer);
+          Toast.clear();
+        }
+      }, 1000);
+    }
+  }
+};
+```
+:::
+
+### 方法
+
+| 方法名 | 参数 | 返回值 | 介绍 |
+|-----------|-----------|-----------|-------------|
+| Toast | `options | message` | toast 实例 | 展示提示 |
+| Toast.loading | `options | message` | toast 实例 | 展示加载提示 |
+| Toast.success | `options | message` | toast 实例 | 展示成功提示 |
+| Toast.fail | `options | message` | toast 实例 | 展示失败提示 |
+| Toast.clear | - | `void` | 关闭提示 |
+
+### Options
+
+| 参数       | 说明      | 类型       | 默认值       | 可选值       |
+|-----------|-----------|-----------|-------------|-------------|
+| type | 提示类型 | `String` | `text` | `loading` `success` `fail` `html` |
+| message | 内容 | `String` | `''` | - |
+| forbidClick | 禁止背景点击 | `Boolean` | `false` | - |
+| duration | 时长(ms) | `Number` | `3000` | 值为 0 时，toast 不会消失 |