Tu-view

# Skeleton 骨架屏

在需要等待加载内容的位置设置一个骨架屏，某些场景下比 Loading 的视觉效果更好。

# 基础用法

基础的骨架效果。

<template>
	<tu-skeleton />
</template>
Expand Copy

# 更多参数

可以配置骨架屏段落数量，以便更接近真实渲染效果。首行会被渲染一个长度 33% 的段首。

<tu-skeleton :rows="6" />
Expand Copy

# 动画效果

显示动画效果。

<tu-skeleton
	:rows="6"
	animated
/>
Expand Copy

# 自定义样式

TuView 提供的排版模式有时候并不满足要求，当您想要用自己定义的模板时，可以通过一个具名 Slot 来自己设定模板。

我们提供了不同的模板单元可供使用，具体可选值请看 API 详细描述。 建议在描述模板的时候，尽量靠近真实的 DOM 结构，这样可以避免 DOM 高度差距引起的抖动。

<template>
	<tu-skeleton style="width: 240px">
		<template slot="template">
			<tu-skeleton-item
				variant="image"
				style="width: 240px; height: 240px;"
			/>
			<div style="padding: 12px;">
				<tu-skeleton-item
					variant="p"
					style="width: 50%"
				/>
				<div style="display: flex; align-items: center; justify-items: space-between;">
					<tu-skeleton-item
						variant="text"
						style="margin-right: 16px;"
					/>
					<tu-skeleton-item
						variant="text"
						style="width: 30%;"
					/>
				</div>
			</div>
		</template>
	</tu-skeleton>
</template>
Expand Copy

# Loading 状态

当 Loading 结束之后，我们往往需要显示真实的 UI，可以通过 loading 的值来控制是否显示真实的 DOM。然后通过 具名 Slot 来设置当 loading 结束之后需要展示的 UI。

欧洲风情街
2022-06-01 操作按钮
<template>
	<div style="width: 240px">
		<p>
			<label style="margin-right: 16px;">切换 Loading</label>
			<tu-switch v-model="loading" />
		</p>
		<tu-skeleton
			style="width: 240px"
			:loading="loading"
			animated
		>
			<template slot="template">
				<tu-skeleton-item
					variant="image"
					style="width: 240px; height: 300px;"
				/>
				<div style="padding: 14px;">
					<tu-skeleton-item
						variant="h3"
						style="width: 50%;"
					/>
					<div
						style="display: flex; align-items: center; justify-items: space-between; margin-top: 16px; height: 16px;"
					>
						<tu-skeleton-item
							variant="text"
							style="margin-right: 16px;"
						/>
						<tu-skeleton-item
							variant="text"
							style="width: 30%;"
						/>
					</div>
				</div>
			</template>
			<template>
				<tu-card :body-style="{ padding: '0px', marginBottom: '1px' }">
					<img
						src="https://os.alipayobjects.com/rmsportal/QBnOOoLaAfKPirc.png"
						class="image"
					/>
					<div style="padding: 14px;">
						<span>欧洲风情街</span>
						<div style="margin-top: 11px">
							<span class="time">2022-06-01</span>
							<tu-button
								style="float: right"
								class="button"
								size="mini"
								>操作按钮</tu-button
							>
						</div>
					</div>
				</tu-card>
			</template>
		</tu-skeleton>
	</div>
</template>

<script>
	export default {
		data() {
			return {
				loading: true,
			};
		},
	};
</script>
Expand Copy

# 渲染多条数据

大多时候, 骨架屏都被用来渲染列表, 当我们需要在从服务器获取数据的时候来渲染一个假的 UI。利用 count 这个属性就能控制渲染多少条假的数据在页面上

TIP

请注意, 请尽可能的将 count 的大小保持在最小状态, 即使是假的 UI, DOM 元素多了之后, 照样会引起性能问题, 并且在骨架屏销毁时所消耗的时间也会更长(相对的)。

点我重新加载

<template>
	<div>
		<p>
			<tu-button @click="setLoading">点我重新加载</tu-button>
		</p>
		<tu-row>
			<tu-col
				:span="8"
				v-for="(item, index) in lists"
				:key="index"
			>
				<tu-skeleton
					style="width:240px"
					:loading="loading"
					animated
				>
					<template slot="template">
						<tu-skeleton-item
							variant="image"
							style="width: 240px; height: 300px;"
						/>
						<div style="padding: 14px;">
							<tu-skeleton-item
								variant="h3"
								style="width: 50%;"
							/>
							<div
								style="display: flex; align-items: center; justify-items: space-between; margin-top: 16px; height: 16px;"
							>
								<tu-skeleton-item
									variant="text"
									style="margin-right: 16px;"
								/>
								<tu-skeleton-item
									variant="text"
									style="width: 30%;"
								/>
							</div>
						</div>
					</template>
					<template>
						<tu-card :body-style="{ padding: '0px', marginBottom: '1px' }">
							<img
								:src="item.imgUrl"
								class="image multi-content"
							/>
							<div style="padding: 14px;">
								<span>{{ item.name }}</span>
								<div style="margin-top: 9px">
									<span class="time">2022-06-01</span>
									<tu-button
										style="float: right"
										class="button"
										size="mini"
										>操作按钮</tu-button
									>
								</div>
							</div>
						</tu-card>
					</template>
				</tu-skeleton>
			</tu-col>
		</tu-row>
	</div>
</template>

<script>
	export default {
		data() {
			return {
				loading: true,
				lists: [],
			};
		},
		mounted() {
			this.loading = false;
			this.lists = [
				{
					imgUrl: "https://os.alipayobjects.com/rmsportal/QBnOOoLaAfKPirc.png",
					name: "欧洲风情街",
				},
				{
					imgUrl: "https://os.alipayobjects.com/rmsportal/QBnOOoLaAfKPirc.png",
					name: "欧洲风情街",
				},
				{
					imgUrl: "https://os.alipayobjects.com/rmsportal/QBnOOoLaAfKPirc.png",
					name: "欧洲风情街",
				},
			];
		},
		methods: {
			setLoading() {
				this.loading = true;
				setTimeout(() => (this.loading = false), 2000);
			},
		},
	};
</script>
<style>
	.multi-content {
		width: 240px;
		height: 300px;
	}
</style>
Expand Copy

# 防止渲染抖动

有时候，API 的请求回来的特别快，往往骨架占位刚刚被渲染，真实的数据就已经回来了，用户界面会出现闪动，此时为了避免这种情况，就需要通过 throttle 属性来避免这个问题。

欧洲风情街
2022-06-01 操作按钮
<template>
	<div style="width: 240px">
		<p>
			<label style="margin-right: 16px;">切换 Loading</label>
			<tu-switch v-model="loading" />
		</p>
		<tu-skeleton
			style="width: 240px"
			:loading="loading"
			animated
			:throttle="500"
		>
			<template slot="template">
				<tu-skeleton-item
					variant="image"
					style="width: 240px; height: 300px;"
				/>
				<div style="padding: 14px;">
					<tu-skeleton-item
						variant="h3"
						style="width: 50%;"
					/>
					<div
						style="display: flex; align-items: center; justify-items: space-between; margin-top: 16px; height: 16px;"
					>
						<tu-skeleton-item
							variant="text"
							style="margin-right: 16px;"
						/>
						<tu-skeleton-item
							variant="text"
							style="width: 30%;"
						/>
					</div>
				</div>
			</template>
			<template>
				<tu-card :body-style="{ padding: '0px', marginBottom: '1px'}">
					<img
						src="https://os.alipayobjects.com/rmsportal/QBnOOoLaAfKPirc.png"
						class="image"
					/>
					<div style="padding: 14px;">
						<span>欧洲风情街</span>
						<div style="margin-top: 11px">
							<span class="time">2022-06-01</span>
							<tu-button
								style="float: right"
								class="button"
								size="mini"
								>操作按钮</tu-button
							>
						</div>
					</div>
				</tu-card>
			</template>
		</tu-skeleton>
	</div>
</template>

<script>
	export default {
		data() {
			return {
				loading: false,
			};
		},
	};
</script>
Expand Copy

# Skeleton Attributes

参数 说明 类型 可选值 默认值
animated 是否使用动画 boolean true / false false
count 渲染多少个 template, 建议使用尽可能小的数字 number integer 1
loading 是否显示 skeleton 骨架屏 boolean true / false true
rows 骨架屏段落数量 number 正整数 4
throttle 延迟占位 DOM 渲染的时间, 单位是毫秒 number 正整数 0

# Skeleton Item Attributes

参数 说明 类型 可选值 默认值
variant 当前显示的占位元素的样式 Enum(string) p / h1 / h3 / text / caption / button / image / circle / rect text

# Skeleton Slots

name description
default 用来展示真实 UI
template 用来展示自定义占位符

← Empty 空状态 →