# Slots
注意
① 使用slot插入的view必须是z-paging
的子view(此view的上一级必须是z-paging
),如:
② slot节点不支持通过v-if或v-show动态显示/隐藏,若需要动态控制,可将v-if添加在其子节点上,如:
# 主体布局Slot
名称 | 说明 |
---|---|
top 1.5.5 | 可以将自定义导航栏、tab-view等需要固定的(不需要跟着滚动的) 元素放入slot="top" 的view中。注意,当有多个需要固定的view时,请用一个view包住它们,并且在这个view上设置 slot="top" 。需要固定在顶部的view请勿设置position: fixed; 。在使用页面滚动时,若top中的内容动态变化(即高度动态变化),请在高度更新后调用this.$refs.paging.updatePageScrollTopHeight() |
bottom 1.6.2 | 可以将需要固定在底部的(不需要跟着滚动的) 元素放入slot="bottom" 的view中。注意,当有多个需要固定的view时,请用一个view包住它们,并且在这个view上设置 slot="bottom" 。需要固定在底部的view请勿设置position: fixed; 。在使用页面滚动时,若bottom中的内容动态变化(即高度动态变化),请在高度更新后调用this.$refs.paging.updatePageScrollBottomHeight() |
left 2.2.3 | 可以将需要固定在左侧的(不需要跟着滚动的) 元素放入slot="left" 的view中。注意,当有多个需要固定的view时,请用一个view包住它们,并且在这个view上设置 slot="left" 。需要固定在左侧的view请勿设置position: fixed; 。
|
right 2.2.3 | 可以将需要固定在右侧的(不需要跟着滚动的) 元素放入slot="right" 的view中。注意,当有多个需要固定的view时,请用一个view包住它们,并且在这个view上设置 slot="right" 。需要固定在右侧的view请勿设置position: fixed; 。
|
# 下拉刷新Slot
名称 | 说明 |
---|---|
refresher | 自定义下拉刷新view,设置后则不使用uni自带的下拉刷新view和z-paging自定义的下拉刷新view。此view的style必须设置为height:100% (在非nvue中,自定义下拉刷新view的高度受 slot-scope="{ refresherStatus(default:默认状态;release-to-refresh:松手立即刷新;loading:刷新中;complete:刷新结束;go-f2:松手进入二楼)(v2.8.0及之前的版本是number类型,对应为:0,1,2,3,4) }" |
refresherComplete 2.1.1 | 自定义结束状态下 的下拉刷新view,若设置,当下拉刷新结束时,会替换当前状态下的下拉刷新view。(注意:默认情况下您无法看到结束状态的下拉刷新view,除非您设置了 |
refresherF2 2.7.7 | 自定义松手显示二楼状态下的view |
f2 2.7.7 | 自定义需要插入二楼的view |
# 底部加载更多Slot
名称 | 说明 |
---|---|
loadingMoreDefault | 自定义滑动到底部"默认"状态的view(即"点击加载更多view") (自定义插入时默认点击无法加载更多,若需要实现点击加载更多,请为插入的view添加点击事件,并在点击事件中调用 |
loadingMoreLoading | 自定义滑动到底部"加载中"状态的view |
loadingMoreNoMore | 自定义滑动到底部"没有更多数据"状态的view |
loadingMoreFail | 自定义滑动到底部"加载失败"状态的view |
# 空数据图Slot
名称 | 说明 |
---|---|
empty | 自定义空数据占位view 2.5.0 slot-scope="{ isLoadFailed(true: 加载失败,false: 加载成功) }" |
# 全屏Loading Slot
名称 | 说明 |
---|---|
loading | 自定义页面reload时的加载view,注意:这个slot默认仅会在第一次加载时显示,若需要每次reload时都显示,需要将auto-hide-loading-after-first-loaded 设置为false |
# 返回顶部按钮Slot
名称 | 说明 |
---|---|
backToTop 1.9.4 | 自定义点击返回顶部view (此view受“【返回顶部按钮】配置”控制,且其父view默认宽高为76rpx) |
# 虚拟列表&内置列表Slot
名称 | 说明 |
---|---|
cell 2.2.5 | use-virtual-list 或use-inner-list 为true时有效内置列表中的cell slot-scope="{ item, index }" |
header 2.2.5 | use-virtual-list 或use-inner-list 为true时有效内置列表中的header(在cell顶部且跟随列表滚动) |
footer 2.2.5 | use-virtual-list 或use-inner-list 为true时有效内置列表中的footer(在cell底部且跟随列表滚动) |
# 聊天记录模式Slot
名称 | 说明 |
---|---|
chatLoading | 使用聊天记录模式时自定义顶部加载更多view(除没有更多数据外),use-chat-record-mode 为true时有效slot-scope="{ loadingMoreStatus(default:默认状态;loading:加载中;no-more:没有更多数据;fail:加载失败) (v2.8.0及之前的版本是number类型,对应为:0,1,2,3) }" 2.7.5 |
chatNoMore 2.7.5 | 使用聊天记录模式时自定义没有更多数据view,use-chat-record-mode 为true时有效 |