From b62a1bbcf6a4d603f7fcda7cd6c2f6ebc2c336b5 Mon Sep 17 00:00:00 2001
From: neverland <jait.chen@foxmail.com>
Date: Sun, 11 Jun 2023 12:11:46 +0800
Subject: [PATCH] docs(FloatingPanel): add some descriptions (#11960)

---
 packages/vant/src/floating-panel/README.md       | 8 ++++++++
 packages/vant/src/floating-panel/README.zh-CN.md | 8 ++++++++
 2 files changed, 16 insertions(+)

diff --git a/packages/vant/src/floating-panel/README.md b/packages/vant/src/floating-panel/README.md
index 016f8e779..d821a3258 100644
--- a/packages/vant/src/floating-panel/README.md
+++ b/packages/vant/src/floating-panel/README.md
@@ -20,6 +20,8 @@ app.use(FloatingPanel);
 
 ### Basic Usage
 
+The default height of FloatingPanel is `100px`, and users can drag it to expand the panel to a height of `60%` of the screen height.
+
 ```html
 <van-floating-panel>
   <van-cell-group>
@@ -35,6 +37,10 @@ app.use(FloatingPanel);
 
 ### Custom Anchors
 
+You can set the anchor position of FloatingPanel through the `anchors` attribute, and control the display height of the current panel through `v-model:height`.
+
+For example, you can make the panel stop at three positions: `100px`, 40% of the screen height, and 70% of the screen height.
+
 ```html
 <van-floating-panel v-model:height="height" :anchors="anchors">
   <div style="text-align: center; padding: 15px">
@@ -62,6 +68,8 @@ export default {
 
 ### Head Drag Only
 
+By default, both the header and content areas of FloatingPanel can be dragged, but you can disable dragging of the content area through the `content-draggable` attribute.
+
 ```html
 <van-floating-panel :content-draggable="false">
   <div style="text-align: center; padding: 15px">
diff --git a/packages/vant/src/floating-panel/README.zh-CN.md b/packages/vant/src/floating-panel/README.zh-CN.md
index f4fb7cd7a..36c837e3b 100644
--- a/packages/vant/src/floating-panel/README.zh-CN.md
+++ b/packages/vant/src/floating-panel/README.zh-CN.md
@@ -20,6 +20,8 @@ app.use(FloatingPanel);
 
 ### 基础用法
 
+FloatingPanel 的默认高度为 `100px`，用户可以拖动来展开面板，使高度达到 `60%` 的屏幕高度。
+
 ```html
 <van-floating-panel>
   <van-cell-group>
@@ -35,6 +37,10 @@ app.use(FloatingPanel);
 
 ### 自定义锚点
 
+你可以通过 `anchors` 属性来设置 FloatingPanel 的锚点位置，并通过 `v-model:height` 来控制当前面板的显示高度。
+
+比如，使面板的高度在 `100px`、40% 屏幕高度和 70% 屏幕高度三个位置停靠：
+
 ```html
 <van-floating-panel v-model:height="height" :anchors="anchors">
   <div style="text-align: center; padding: 15px">
@@ -62,6 +68,8 @@ export default {
 
 ### 仅头部拖拽
 
+默认情况下，FloatingPanel 的头部区域和内容区域都可以被拖拽，你可以通过 `content-draggable` 属性来禁用内容区域的拖拽。
+
 ```html
 <van-floating-panel :content-draggable="false">
   <div style="text-align: center; padding: 15px">