vant components

docs/examples-docs/quantity.md

@@ -0,0 +1,99 @@
+<style>
+@component-namespace demo {
+  @b quantity {
+    .van-quantity {
+      margin-left: 15px;
+    }
+
+    .curr-quantity {
+      margin: 15px;
+    }
+  }
+}
+</style>
+
+<script>
+export default {
+  data() {
+    return {
+      quantity1: 1,
+      quantity2: null,
+    };
+  }
+};
+</script>
+
+## Quantity 数量选择
+
+### 使用指南
+
+如果你已经按照快速上手中引入了整个`vant`，以下**组件注册**就可以忽略了，因为你已经全局注册了`vant`中的全部组件。
+
+#### 全局注册
+
+你可以在全局注册`Quantity`组件，比如页面的主文件（`index.js`，`main.js`），这样页面任何地方都可以直接使用`Quantity`组件了：
+
+```js
+import Vue from 'vue';
+import { Quantity } from 'vant';
+import 'vant/lib/vant-css/quantity.css';
+
+Vue.component(Quantity.name, Quantity);
+```
+
+#### 局部注册
+
+如果你只是想在某个组件中使用，你可以在对应组件中注册`Quantity`组件，这样只能在你注册的组件中使用`Quantity`：
+
+```js
+import { Quantity } from 'vant';
+
+export default {
+  components: {
+    'van-quantity': Quantity
+  }
+};
+```
+
+### 代码演示
+
+#### 基础用法
+
+:::demo 基础用法
+```html
+<van-quantity v-model="quantity1"></van-quantity>
+<p class="curr-quantity">当前值：{{ quantity1 }}</p>
+```
+:::
+
+#### 禁用Quantity
+
+设置`disabled`属性，此时`quantity`不可改变。
+
+:::demo 禁用Quantity
+```html
+<van-quantity v-model="quantity1" disabled></van-quantity>
+```
+:::
+
+#### 高级用法
+
+默认是每次加减为1，可以对组件设置`step`、`min`、`max`、`defaultValue`属性。
+
+:::demo 高级用法
+```html
+<van-quantity v-model="quantity2" min="5" max="40" step="2" default-value="9"></van-quantity>
+<p class="curr-quantity">当前值：{{ quantity2 }}</p>
+```
+:::
+
+### API
+
+| 参数       | 说明      | 类型       | 默认值       | 可选值       |
+|-----------|-----------|-----------|-------------|-------------|
+| min | 最小值 | `string`, `number` | `1`         |           |
+| max | 最大值 | `string`, `number`  |           |           |
+| step | 步数 | `string`, `number`  | `1`         |           |
+| disabled | 是否被禁用了 | `boolean`  | `false`      |           |
+| defaultValue | 默认值 | `string`, `number`  | `1`      |           |
+