# t-back-top

BackTop 回到顶部

t-back-top 组件介绍

t-back-top 用于在页面滚动一定距离后显示返回顶部按钮，点击后页面平滑滚动回顶部。适用于长列表页面，方便用户快速返回页面顶部。

t-back-top 平台兼容

Harmony	H5	Android	iOS	小程序	UTS
✅	✅	✅	✅	✅	✅

t-back-top 基础用法

基础用法参考 demo/back-top/back-top.uvue，通过 scrollTop 属性控制显示/隐藏，滚动超过 400rpx 时自动显示。

<template>
	<scroll-view :class="[`h-100% p-15 tpg`]" :show-scrollbar="false" @scroll="onscroll" :scroll-top="scrollTops">
		<tui-theme-switch></tui-theme-switch>
		<t-card class="r-10 mb-15" title='BackTop' subTitle="一键引入，自动监听滚动，轻松实现平滑返回页面顶部功能"></t-card>
		<t-section class="r-10 mb-15" title="向上滑动200px显示按钮"></t-section>
		<t-col class="mb-15 r-10 p-15">
			<t-text class="sfwb" size="large">未来科技城市景观</t-text>
			<t-text
				class="slh-40">在未来的某个时代，科技已经彻底改变了人们的生活。夜晚的城市景观被霓虹灯光和全息广告照亮，飞行汽车在摩天大楼间穿梭。在这个充满活力的氛围中，一位市民正在使用一款高科技装置，可能是一款智能手机或平板电脑，其界面呈现出全息效果。这个场景融合了传统的中国建筑元素与超现代设计，展现了未来科技的魅力。在这个未来时代，我们的城市已经发展成为一座充满奇迹的科技堡垒。夜晚，城市的每个角落都散发着耀眼的光芒。那些建筑物不再是冰冷的钢筋水泥，而是融合了智能材料，能够根据环境变化自动调节温度和光线。</t-text>
			<image class="h-240 w-100%" src="/static/image/D1.jpg" />
			<t-text class="slh-40">
				在这座城市中心，有一座名为"智慧之塔"的建筑，它不仅是城市的地标，更是科技发展的象征。智慧之塔高耸入云，塔身由无数块全息屏幕组成，实时展示着全球各地的新闻、天气预报和公共信息。

				在这繁华的街角，市民们正沉浸在这科技带来的便利之中。那位正在使用高科技装置的市民，名叫小李，他正通过全息界面与远在地球另一端的家人视频通话。这款装置不仅可以实现全息通话，还能根据用户的需求，提供实时翻译、生活助手等功能。

				在街道的另一边，一家全息餐厅吸引了众多食客。餐厅内的餐桌都是智能化的，顾客只需在桌面上点选菜品，全息投影便会呈现出食物的立体图像，供顾客欣赏。而在后厨，机器人厨师正根据订单精确地烹饪美食。

				此外，这座城市的交通系统也发生了翻天覆地的变化。飞行汽车穿梭在摩天大楼之间，它们采用清洁能源，实现了零排放。道路上的无人驾驶公交车，时刻保持着最佳运行状态，为市民提供便捷的出行服务。

				在这个充满活力的城市中，传统文化与现代科技完美融合。古老的寺庙和园林被赋予了新的生命，通过全息投影技术，让游客们仿佛穿越时空，感受历史的沧桑。而那些传统的节日庆典，也在科技的加持下，变得更加丰富多彩。
			</t-text>
		</t-col>
		<t-back-top type="primary" :scrollTop="scrollTop" @click="onBacktop"></t-back-top>
		<t-back-top type="success" :scrollTop="scrollTop" class="dr-90! db-100!" icon="arrowtext"
			@click="onBacktop"></t-back-top>

	</scroll-view>
</template>

<script setup>
	import { ref } from 'vue'
	const scrollTop = ref(0)
	const scrollTops = ref(0)
	function onscroll(e : ScrollEvent) {
		scrollTop.value = e.detail.scrollTop
	}
	function onBacktop() {
		scrollTops.value = scrollTop.value
		nextTick(()=>{
			scrollTops.value = 0
		})
	}
</script>

t-back-top Props

属性名	说明	类型	默认值
path	点击组件后跳转的页面路径；为空时仅响应事件	string	''
hover	是否启用点击效果	boolean	true
type	组件主题类型，可选 info、primary、error、warning、success	string	'primary'
disabled	是否禁用	boolean	false
effect	组件显示主题，可选 normal、dark、light、plain	string	'normal'
size	组件尺寸，可选 large、medium、small、mini	string	'large'
scrollTop	滚动组件的 scrollTop 值	number	0
icon	返回按钮的图标名称	string	'rocketline'
iconClass	图标样式类	string	''

t-back-top Events

事件名	说明	回调参数
click	点击时触发	-
transitionend	动画结束时触发	-
initFinished	组件初始化完成时触发	-
touchstart	触摸开始时触发	-
touchend	触摸结束时触发	-
touchmove	触摸移动时触发	-
touchcancel	触摸取消时触发	-

t-back-top Slots

插槽名	说明
default	自定义返回顶部按钮内容，默认显示图标

外部类

类名	说明
icon-class	图标样式类