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
2017-10-06 12:33:28 +08:00
parent 265fcbf2ef
commit 64ec6ce5ac
68 changed files with 439 additions and 135 deletions
@@ -0,0 +1,132 @@
+<style>
+.demo-dialog {
+  .van-button {
+    margin: 15px;
+  }
+}
+</style>
+
+<script>
+import { Dialog } from 'packages';
+
+const message = '弹窗内容';
+
+export default {
+  methods: {
+    onClickAlert() {
+      Dialog.alert({
+        title: '标题',
+        message
+      });
+    },
+
+    onClickAlert2() {
+      Dialog.alert({
+        message
+      });
+    },
+
+    onClickConfirm() {
+      Dialog.confirm({
+        title: '标题',
+        message
+      }).catch(action => {
+        console.log(action);
+      });
+    }
+  }
+};
+</script>
+
+## Dialog 弹出框
+
+### 使用指南
+
+```js
+import { Dialog } from 'vant';
+```
+
+### 代码演示
+
+#### 消息提示
+
+用于提示一些消息，只包含一个确认按钮
+
+:::demo 消息提示
+```html
+<van-button @click="onClickAlert">Alert</van-button>
+<van-button @click="onClickAlert2">无标题 Alert</van-button>
+```
+
+```javascript
+export default {
+  methods: {
+    onClickAlert() {
+      Dialog.alert({
+        title: '标题',
+        message: '弹窗内容'
+      }).then(() => {
+        // on close
+      });
+    },
+
+    onClickAlert2() {
+      Dialog.alert({
+        message: '弹窗内容'
+      }).then(() => {
+        // on close
+      });
+    }
+  }
+};
+```
+:::
+
+#### 消息确认
+
+用于确认消息，包含取消和确认按钮
+
+:::demo 消息确认
+```html
+<van-button @click="onClickConfirm">Confirm</van-button>
+```
+
+```javascript
+export default {
+  methods: {
+    onClickConfirm() {
+      Dialog.confirm({
+        title: '标题',
+        message: '弹窗内容'
+      }).then(() => {
+        // on confirm
+      }).catch(() => {
+        // on cancel
+      });
+    }
+  }
+};
+```
+:::
+
+### 方法
+
+| 方法名 | 参数 | 返回值 | 介绍 |
+|-----------|-----------|-----------|-------------|
+| Dialog.alert | options | `Promise`  | 展示消息提示弹窗 |
+| Dialog.confirm | options | `Promise`  | 展示消息确认弹窗 |
+| Dialog.close | - | `void`  | 关闭弹窗 |
+
+### Options
+
+| 参数       | 说明      | 类型       | 默认值       | 可选值       |
+|-----------|-----------|-----------|-------------|-------------|
+| title | 标题 | `String`  |  |   |
+| message | 内容 | `String`  |  |   |
+| showConfirmButton | 是否展示确认按钮 | `Boolean`  |  `true` |   |
+| showCancelButton | 是否展示取消按钮 | `Boolean`  |  `false` |   |
+| confirmButtonText | 确认按钮的文案 | `String`  |  `确认` |   |
+| cancelButtonText | 取消按钮的文案 | `String`  | `取消` |   |
+| overlay | 是否展示蒙层 | `Boolean`  | `true` |   |
+| closeOnClickOverlay | 点击蒙层时是否关闭弹窗 | `Boolean`  | `false` |   |
+| lockOnScroll | 是否禁用背景滚动 | `Boolean`  | `true` |   |