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,172 @@
+<style>
+.demo-popup {
+  .van-button {
+    margin: 10px 15px;
+  }
+
+  .van-popup-1 {
+    width: 60%;
+    box-sizing: border-box;
+    padding: 20px;
+    border-radius: 5px;
+    text-align: center;
+  }
+
+  .van-popup-2 {
+    width: 100%;
+    height: 200px;
+    box-sizing: border-box;
+    padding: 20px;
+  }
+
+  .van-popup-3 {
+    line-height: 50px;
+    text-align: center;
+    background-color: rgba(0, 0, 0, 0.701961);
+    color: #fff;
+  }
+
+  .van-popup-4,
+  .van-popup-5 {
+    width: 100%;
+    height: 100%;
+  }
+}
+</style>
+
+<script>
+import Dialog from 'packages/dialog';
+
+export default {
+  data() {
+    return {
+      popupShow1: false,
+      popupShow2: false,
+      popupShow3: false,
+      popupShow4: false,
+      popupShow5: false
+    }
+  },
+
+  watch: {
+    popupShow3(val) {
+      if (val) {
+        setTimeout(() => {
+          this.popupShow3 = false;
+        }, 2000);
+      }
+    }
+  },
+
+  methods: {
+    showDialog() {
+      Dialog.confirm({
+        title: 'confirm标题',
+        message: '弹窗提示文字，左右始终距离边20PX，上下距离20PX，文字左对齐。弹窗提示文字，左右始终距离边20PX，上下距离20PX，文字左对齐。'
+      }).then((action) => {
+        console.log(action);
+      }, (error) => {
+        console.log(error);
+      });
+    }
+  }
+};
+</script>
+
+## Popup 弹出层
+
+### 使用指南
+``` javascript
+import { Popup } from 'vant';
+
+Vue.component(Popup.name, Popup);
+```
+
+### 代码演示
+
+#### 基础用法
+
+`popup`默认情况下是从中间弹出。
+
+:::demo 基础用法
+```html
+<van-button @click="popupShow1 = true">从中间弹出popup</van-button>
+<van-popup v-model="popupShow1" class="van-popup-1" :lock-on-scroll="true">
+  从中间弹出popup
+</van-popup>
+```
+
+```javascript
+export default {
+  data() {
+    return {
+      popupShow1: false
+    }
+  }
+};
+```
+:::
+
+#### 从不同位置弹出层
+
+可以设置`position`属性，`popup`即能从不同位置弹出，`position`的可选值有`top`，`bottom`，`right`，`left`。
+
+:::demo 从不同位置弹出层
+```html
+<van-button @click="popupShow2 = true;">从下方弹出popup</van-button>
+<van-popup v-model="popupShow2" position="bottom" class="van-popup-2">
+  <van-button @click="showDialog">弹出dialog</van-button>
+</van-popup>
+
+<van-button @click="popupShow3 = true">从上方弹出popup</van-button>
+<van-popup v-model="popupShow3" position="top" class="van-popup-3" :overlay="false">
+  更新成功
+</van-popup>
+
+<van-button @click="popupShow4 = true">从右方弹出popup</van-button>
+<van-popup v-model="popupShow4" position="right" class="van-popup-4" :overlay="false">
+  <van-button @click.native="popupShow4 = false">关闭 popup</van-button>
+</van-popup>
+
+
+<van-button @click="popupShow5 = true">从左方弹出popup</van-button>
+<van-popup v-model="popupShow5" position="left" class="van-popup-5" :overlay="false">
+  <van-button @click.native="popupShow5 = false">关闭 popup</van-button>
+</van-popup>
+```
+
+```javascript
+export default {
+  data() {
+    return {
+      popupShow1: false,
+      popupShow2: false,
+      popupShow3: false,
+      popupShow4: false
+    }
+  },
+
+  watch: {
+    popupShow2(val) {
+      if (val) {
+        setTimeout(() => {
+          this.popupShow2 = false;
+        }, 2000);
+      }
+    }
+  }
+};
+```
+:::
+
+### API
+
+| 参数       | 说明      | 类型       | 默认值       | 可选值       |
+|-----------|-----------|-----------|-------------|-------------|
+| v-model | 当前组件是否显示 | `Boolean`  | `false` | - |
+| overlay | 是否显示背景遮罩层 | `Boolean`  | `true` | -  |
+| lockOnScroll | 背景是否跟随滚动 | `Boolean`  | `false` | - |
+| position | 弹出层位置 | `String`  | - | `top`, `bottom`, `right`, `left`  |
+| closeOnClickOverlay | 点击遮罩层是否关闭弹出层 | `Boolean`  | `true` | - |
+| transition | 弹出层的`transition` | `String`  | `popup-slide` |   |
+| preventScroll | 是否防止滚动穿透 | `Boolean`  | `false` | -  |