vant components

2017-04-19 17:33:44 +08:00
commit 63c549d651
346 changed files with 25710 additions and 0 deletions
@@ -0,0 +1,99 @@
+<style>
+.tags-container {
+  padding: 5px 15px;
+
+  .van-tag + .van-tag {
+    margin-left: 10px;
+  }
+}
+</style>
+
+## Tag 标记
+
+### 使用指南
+
+如果你已经按照快速上手中引入了整个`vant`，以下**组件注册**就可以忽略了，因为你已经全局注册了`vant`中的全部组件。
+
+#### 全局注册
+
+你可以在全局注册`Tag`组件，比如页面的主文件（`index.js`，`main.js`），这样页面任何地方都可以直接使用`Tag`组件了：
+
+```js
+import Vue from 'vue';
+import { Tag } from 'vant';
+import 'vant/lib/vant-css/tag.css';
+
+Vue.component(Tag.name, Tag);
+```
+
+#### 局部注册
+
+如果你只是想在某个组件中使用，你可以在对应组件中注册`Tag`组件，这样只能在你注册的组件中使用`Tag`：
+
+```js
+import { Tag } from 'vant';
+
+export default {
+  components: {
+    'van-tag': Tag
+  }
+};
+```
+
+### 代码演示
+
+#### 基础用法
+
+`Tag`目前有三种类型，`danger`、`success`、`primary`，它们分别显示为红色，绿色和蓝色，你也可以加上自定义的类，为它们加上其他的颜色。
+
+:::demo 基础用法
+```html
+<div class="tags-container">
+  <van-tag>返现</van-tag>
+  <van-tag plain>返现</van-tag>
+</div>
+<div class="tags-container">
+  <van-tag type="danger">返现</van-tag>
+  <van-tag type="danger">四字标签</van-tag>
+  <van-tag type="danger">一</van-tag>
+</div>
+```
+:::
+
+#### 高级用法
+
+设置`plain`为`true`时表示空心的`tag`，还可以设置`mark`为`true`，表示是否为标记。
+
+:::demo 高级用法
+```html
+<div class="tags-container">
+  <van-tag type="danger">返现</van-tag>
+  <van-tag plain type="danger">返现</van-tag>
+</div>
+<div class="tags-container">
+  <van-tag type="primary">返现</van-tag>
+  <van-tag plain type="primary">返现</van-tag>
+</div>
+<div class="tags-container">
+  <van-tag type="success">返现</van-tag>
+  <van-tag plain type="success">返现</van-tag>
+</div>
+<div class="tags-container">
+  <van-tag type="danger" mark>返现</van-tag>
+</div>
+```
+:::
+
+### API
+
+| 参数       | 说明      | 类型       | 默认值       | 可选值       |
+|-----------|-----------|-----------|-------------|-------------|
+| plain | 是否是空心tag | `boolean`  | `false`          |           |
+| mark | 是否是标记 | `boolean`  | `false`          |           |
+| type | tag类型 | `string`  | `''`          | `primary`, `success`, `danger` |
+
+### Slot
+
+| name       | 描述      |
+|-----------|-----------|
+| - | 自定义tag显示内容 |