diff --git a/example/pages/rate/index.js b/example/pages/rate/index.js
index 6ccce815..c8fbf038 100644
--- a/example/pages/rate/index.js
+++ b/example/pages/rate/index.js
@@ -4,8 +4,9 @@ Page({
   data: {
     value1: 3,
     value2: 3,
-    value3: 4,
-    value4: 2
+    value3: 3,
+    value4: 4,
+    value5: 3
   },
 
   onChange(event) {
diff --git a/example/pages/rate/index.wxml b/example/pages/rate/index.wxml
index 456e58c8..f83267a4 100644
--- a/example/pages/rate/index.wxml
+++ b/example/pages/rate/index.wxml
@@ -22,9 +22,19 @@
     data-key="value3"
     value="{{ value3 }}"
     size="{{ 25 }}"
+    color="#f44"
+    void-color="#eee"
+    void-icon="star"
+    bind:change="onChange"
+  />
+</demo-block>
+
+<demo-block title="自定义数量">
+  <van-rate
+    custom-class="van-rate"
+    data-key="value4"
+    value="{{ value4 }}"
     count="{{ 6 }}"
-    color="#07c160"
-    void-color="#ceefe8"
     bind:change="onChange"
   />
 </demo-block>
@@ -32,8 +42,17 @@
 <demo-block title="禁用状态">
   <van-rate
     custom-class="van-rate"
-    data-key="value4"
-    value="{{ value4 }}"
+    data-key="value5"
+    value="{{ value5 }}"
     disabled
   />
 </demo-block>
+
+<demo-block title="只读状态">
+  <van-rate
+    custom-class="van-rate"
+    data-key="value5"
+    value="{{ value5 }}"
+    readonly
+  />
+</demo-block>
diff --git a/example/pages/rate/index.wxss b/example/pages/rate/index.wxss
index 31253f32..10c8e210 100644
--- a/example/pages/rate/index.wxss
+++ b/example/pages/rate/index.wxss
@@ -1,3 +1,7 @@
+page {
+  background-color: #fff;
+}
+
 .van-rate {
   margin-left: 15px;
 }
diff --git a/packages/rate/README.md b/packages/rate/README.md
index d33e7ba3..43688874 100644
--- a/packages/rate/README.md
+++ b/packages/rate/README.md
@@ -56,9 +56,19 @@ Page({
 <van-rate
   value="{{ value }}"
   size="{{ 25 }}"
+  color="#f44"
+  void-color="#eee"
+  void-icon="star"
+  bind:change="onChange"
+/>
+```
+
+#### 自定义数量
+
+```html
+<van-rate
+  value="{{ value }}"
   count="{{ 6 }}"
-  color="#07c160"
-  void-color="#ceefe8"
   bind:change="onChange"
 />
 ```
@@ -73,6 +83,16 @@ Page({
 />
 ```
 
+#### 只读状态
+
+```html
+<van-rate
+  readonly
+  value="{{ value }}"
+  bind:change="onChange"
+/>
+```
+
 ### API
 
 | 参数 | 说明 | 类型 | 默认值 |