Merge branch '2.x' into dev

docs/markdown/advanced-usage.zh-CN.md

@@ -104,7 +104,7 @@ import '@vant/touch-emulator';
 
 ### 底部安全区适配
 
-iPhone X 等机型底部存在底部指示条，指示条的操作区域与页面底部存在重合，容易导致用户误操作，因此我们需要针对这些机型进行底部安全区适配。Vant 中部分组件提供了`safe-area-inset-bottom`属性，设置该属性后，即可在对应的机型上开启适配，如下示例：
+iPhone X 等机型底部存在底部指示条，指示条的操作区域与页面底部存在重合，容易导致用户误操作，因此我们需要针对这些机型进行安全区适配。Vant 中部分组件提供了 `safe-area-inset-top` 或 `safe-area-inset-bottom` 属性，设置该属性后，即可在对应的机型上开启适配，如下示例：
 
 ```html
 <!-- 在 head 标签中添加 meta 标签，并设置 viewport-fit=cover 值 -->
@@ -113,7 +113,10 @@ iPhone X 等机型底部存在底部指示条，指示条的操作区域与页
   content="width=device-width, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0, viewport-fit=cover"
 />
 
-<!-- 开启 safe-area-inset-bottom 属性 -->
+<!-- 开启顶部安全区适配 -->
+<van-nav-bar safe-area-inset-top />
+
+<!-- 开启底部安全区适配 -->
 <van-number-keyboard safe-area-inset-bottom />
 ```
 

src/image-preview/ImagePreview.js

@@ -113,7 +113,7 @@ export default createComponent({
         return (
           <div class={bem('index')}>
             {slots.index
-              ? slots.index()
+              ? slots.index({ index: state.active })
               : `${state.active + 1} / ${props.images.length}`}
           </div>
         );

src/image-preview/README.md

@@ -164,10 +164,10 @@ export default {
 
 ### Slots
 
-| Name  | Description                                  |
+| Name | Description | SlotProps |
-| ----- | -------------------------------------------- |
+| --- | --- | --- |
-| index | Custom index                                 |
+| index | Custom index | { index: index of current image } |
-| cover | Custom content that covers the image preview |
+| cover | Custom content that covers the image preview | - |
 
 ### onClose Parematers
 

src/image-preview/README.zh-CN.md

@@ -207,10 +207,10 @@ export default {
 
 通过组件调用 `ImagePreview` 时，支持以下插槽：
 
-| 名称  | 说明                           |
+| 名称  | 说明                           | 参数                      |
-| ----- | ------------------------------ |
+| ----- | ------------------------------ | ------------------------- |
-| index | 自定义页码内容                 |
+| index | 自定义页码内容                 | { index: 当前图片的索引 } |
-| cover | 自定义覆盖在图片预览上方的内容 |
+| cover | 自定义覆盖在图片预览上方的内容 | -                         |
 
 ### onClose 回调参数
 

src/nav-bar/README.zh-CN.md

@@ -66,7 +66,7 @@ export default {
 | fixed | 是否固定在顶部 | _boolean_ | `false` |
 | placeholder `v2.5.9` | 固定在顶部时，是否在标签位置生成一个等高的占位元素 | _boolean_ | `false` |
 | z-index | 导航栏 z-index | _number \| string_ | `1` |
-| safe-area-inset-top `v2.10.13` | 是否开启顶部安全区适配 | _boolean_ | `false` |
+| safe-area-inset-top `v2.10.13` | 是否开启[顶部安全区适配](#/zh-CN/advanced-usage#di-bu-an-quan-qu-gua-pei) | _boolean_ | `false` |
 
 ### Slots
 

src/popup/README.md

@@ -127,6 +127,7 @@ export default {
 | close-icon | Close icon name | _string_ | `cross` |
 | close-icon-position | Close Icon Position，can be set to `top-left` `bottom-left` `bottom-right` | _string_ | `top-right` |
 | transition | Transition, equivalent to `name` prop of [transtion](https://v3.vuejs.org/api/built-in-components.html#transition) | _string_ | - |
+| transition-appear `v2.10.14` | Whether to apply transition on initial render | _boolean_ | `false` |
 | teleport | Return the mount node for Popup | _string \| Element_ | - |
 | safe-area-inset-bottom `v2.2.1` | Whether to enable bottom safe area adaptation | _boolean_ | `false` |
 

src/popup/README.zh-CN.md

@@ -137,6 +137,7 @@ export default {
 | close-icon | 关闭图标名称或图片链接 | _string_ | `cross` |
 | close-icon-position | 关闭图标位置，可选值为`top-left`<br>`bottom-left` `bottom-right` | _string_ | `top-right` |
 | transition | 动画类名，等价于 [transtion](https://v3.cn.vuejs.org/api/built-in-components.html#transition) 的`name`属性 | _string_ | - |
+| transition-appear `v2.10.14` | 是否在初始渲染时启用过渡动画 | _boolean_ | `false` |
 | teleport | 指定挂载的节点 | _string \| Element_ | - |
 | safe-area-inset-bottom | 是否开启[底部安全区适配](#/zh-CN/advanced-usage#di-bu-an-quan-qu-gua-pei) | _boolean_ | `false` |
 

src/popup/index.js

@@ -45,6 +45,8 @@ export const popupSharedProps = {
   overlayStyle: Object,
   // overlay custom class name
   overlayClass: String,
+  // Initial rendering animation
+  transitionAppear: Boolean,
   // whether to show overlay
   overlay: {
     type: Boolean,
@@ -208,13 +210,14 @@ export default createComponent({
     });
 
     const renderTransition = () => {
-      const { position, transition } = props;
+      const { position, transition, transitionAppear } = props;
       const name =
         position === 'center' ? 'van-fade' : `van-popup-slide-${position}`;
 
       return (
         <Transition
           name={transition || name}
+          transitionAppear={transitionAppear}
           onAfterEnter={onOpened}
           onAfterLeave={onClosed}
         >