[Improvement] Reorganize document (#1066)

2018-05-15 10:39:01 +08:00
parent b1142fd862
commit e8aad7246c
124 changed files with 181 additions and 186 deletions
@@ -0,0 +1,75 @@
+## Radio
+
+### Install
+``` javascript
+import { RadioGroup, Radio } from 'vant';
+
+Vue.use(RadioGroup);
+Vue.use(Radio);
+```
+
+### Usage
+
+#### Basic Usage
+Use `v-model` to bind the name of checked radio
+
+```html
+<van-radio-group v-model="radio">
+  <van-radio name="1">Radio 1</van-radio>
+  <van-radio name="2">Radio 2</van-radio>
+</van-radio-group>
+```
+
+```javascript
+export default {
+  data() {
+    return {
+      radio: '1'
+    }
+  }
+};
+```
+
+#### Disabled
+
+```html
+<van-radio-group v-model="radio" disabled>
+  <van-radio name="1">Radio 1</van-radio>
+  <van-radio name="2">Radio 2</van-radio>
+</van-radio-group>
+```
+
+#### Inside a Cell
+
+```html
+<van-radio-group v-model="radio">
+  <van-cell-group>
+    <van-cell :title="Radio 1" clickable @click="radio = '1'">
+      <van-radio name="1" />
+    </van-cell>
+    <van-cell :title="Radio 2" clickable @click="radio = '2'">
+      <van-radio name="2" />
+    </van-cell>
+  </van-cell-group>
+</van-radio-group>
+```
+
+### Radio API
+
+| Attribute | Description | Type | Default |
+|-----------|-----------|-----------|-------------|
+| name | Radio name | `any` | - |
+| disabled | Whether to disable radio | `Boolean` | `false` |
+
+### RadioGroup API
+
+| Attribute | Description | Type | Default |
+|-----------|-----------|-----------|-------------|
+| v-model | Name of checked radio | `any` | - |
+| disabled | Diable all radios | `Boolean` | `false` |
+
+### RadioGroup Event
+
+| Event | Description | Parameters |
+|-----------|-----------|-----------|
+| change | Triggered when value changed | current value |