Antd Vue3 使用 Anchor 锚点组件记录

2024-03-30 07:20

本文主要是介绍Antd Vue3 使用 Anchor 锚点组件记录,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

项目场景

客户要求做一个表单页面,表单数据分为三步,每一步骤是一个单独的 Vue 组件,表单上方需要使用锚点组件实现锚点定位到每一步的功能。

代码总览
<template><div class="guided-form-content-wrapper"><!-- Anchor 锚点 --><a-anchor :affix="false" :target-offset="16" :get-container="getContainer" @click="handleClickAnchor"><a-anchor-link v-for="(item, $index) in steps" :key="$index" :href="'#' + item.id" :title="item.title" /></a-anchor><a-form ref="formRef" :model="form"  v-bind="layout" class="form-wrapper"><DemoFormStep1 :id="steps[0].id" /><DemoFormStep2 :id="steps[1].id" /><DemoFormStep3 :id="steps[2].id" /></a-form></div>
</template>
<script lang="ts" setup>
import DemoFormStep1 from './DemoFormStep1.vue';
import DemoFormStep2 from './DemoFormStep2.vue';
import DemoFormStep3 from './DemoFormStep3.vue';const form = ref<FormDataDto>({});
const layout = {labelCol: { flex: '0 0 140px' },wrapperCol: { flex: '1 1 0' }
};
const steps = [{ id: 'step1', title: '步骤一', description: '第一步描述' },{ id: 'step2', title: '步骤二', description: '第二步描述' },{ id: 'step3', title: '步骤三', description: '第三步描述' }
];/** Anchor 锚点指定滚动的容器 */
function getContainer() {// 给组件指定渲染的容器,解决锚点不会随页面滚动而移动的问题return document.querySelector('.form-wrapper');
}
/** Anchor 锚点形式点击锚点 */
function handleClickAnchor(e, link) {// 阻止点击的默认事件修改路由e.preventDefault();if (link.href) {const element = document.querySelector(link.href);element && element.scrollIntoView({ block: 'start', behavior: 'smooth', alignToTop: 'false' });}
}
</script>
<style lang="less" scoped>
.guided-form-content-wrapper {height: 100%;display: flex;flex-direction: column;:deep(.ant-anchor) {display: flex;}.form-wrapper {flex: 1 0 0;overflow: auto;padding: 16px;background-color: #f0f2f5;}
}
</style>
踩坑点

1. 锚点组件水平展示

Anchor 组件默认锚点 title 垂直显示,通过写 CSS 样式的方式使锚点 title 水平展示。

2. 设置锚点

首先使用 Anchor 组件设置锚点。

<a-anchor :affix="false" :target-offset="16" :get-container="getContainer" @click="handleClickAnchor"><a-anchor-link v-for="(item, $index) in steps" :key="$index" :href="'#' + item.id" :title="item.title" />
</a-anchor>

href 为锚点链接,'#' + item.id 表示锚点链接对应的是 id 为 item.id 的元素,例如:#step1 表示 id 为 step1 的 DOM 元素。

其次,跳转的位置要有一个id,注意点是 这个 id 和上一步设置的 # 号后面的内容是一致的。

注意,# 号后面不能为纯数字,否则无法正常定位,浏览器报错。

3. 点击锚点 title 页面路由发生变化。

由于使用 href 设置了锚点链接,点击锚点的时候页面 url 发生了变化。这是由于 Anchor 组件的点击默认事件会修改路由。

为了防止这种现象的发生,需要在点击锚点 title 时阻止路由跳转。因此这里定义 click 事件的 handler,阻止修改路由并通过 JavaScript 实现点击锚点 tilte 定位到相应的锚点。

/** Anchor 锚点形式点击锚点 */
function handleClickAnchor(e, link) {// 阻止点击的默认事件修改路由e.preventDefault();if (link.href) {const element = document.querySelector(link.href);element && element.scrollIntoView({ block: 'start', behavior: 'smooth', alignToTop: 'false' });}
}

4. 锚点 title 没有随着页面滚动高亮变化

Anchor 锚点组件的锚点 title 没办法随着页面滚动而高亮变化,但是点击 title 跳转具体锚定位置的功能却是没有问题的。经分析,Anchor 组件有一个 getContainer 属性,需要使用该属性来指定 Anchor 组件指定滚动的容器,默认情况下是window,但是在本业务场景下是与 Anchor 同级的表单组件进行滚动,所以通过 getContainer 属性来解决页面滚动时上方锚点 title 没有高亮的问题。

/** Anchor 锚点指定滚动的容器 */
function getContainer() {// 给组件指定渲染的容器,解决锚点不会随页面滚动而移动的问题return document.querySelector('.form-wrapper');
}

这篇关于Antd Vue3 使用 Anchor 锚点组件记录的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/860842

相关文章

Java中流式并行操作parallelStream的原理和使用方法

《Java中流式并行操作parallelStream的原理和使用方法》本文详细介绍了Java中的并行流(parallelStream)的原理、正确使用方法以及在实际业务中的应用案例,并指出在使用并行流... 目录Java中流式并行操作parallelStream0. 问题的产生1. 什么是parallelS

Linux join命令的使用及说明

《Linuxjoin命令的使用及说明》`join`命令用于在Linux中按字段将两个文件进行连接,类似于SQL的JOIN,它需要两个文件按用于匹配的字段排序,并且第一个文件的换行符必须是LF,`jo... 目录一. 基本语法二. 数据准备三. 指定文件的连接key四.-a输出指定文件的所有行五.-o指定输出

Linux jq命令的使用解读

《Linuxjq命令的使用解读》jq是一个强大的命令行工具,用于处理JSON数据,它可以用来查看、过滤、修改、格式化JSON数据,通过使用各种选项和过滤器,可以实现复杂的JSON处理任务... 目录一. 简介二. 选项2.1.2.2-c2.3-r2.4-R三. 字段提取3.1 普通字段3.2 数组字段四.

Linux kill正在执行的后台任务 kill进程组使用详解

《Linuxkill正在执行的后台任务kill进程组使用详解》文章介绍了两个脚本的功能和区别,以及执行这些脚本时遇到的进程管理问题,通过查看进程树、使用`kill`命令和`lsof`命令,分析了子... 目录零. 用到的命令一. 待执行的脚本二. 执行含子进程的脚本,并kill2.1 进程查看2.2 遇到的

详解SpringBoot+Ehcache使用示例

《详解SpringBoot+Ehcache使用示例》本文介绍了SpringBoot中配置Ehcache、自定义get/set方式,并实际使用缓存的过程,文中通过示例代码介绍的非常详细,对大家的学习或者... 目录摘要概念内存与磁盘持久化存储:配置灵活性:编码示例引入依赖:配置ehcache.XML文件:配置

Java 虚拟线程的创建与使用深度解析

《Java虚拟线程的创建与使用深度解析》虚拟线程是Java19中以预览特性形式引入,Java21起正式发布的轻量级线程,本文给大家介绍Java虚拟线程的创建与使用,感兴趣的朋友一起看看吧... 目录一、虚拟线程简介1.1 什么是虚拟线程?1.2 为什么需要虚拟线程?二、虚拟线程与平台线程对比代码对比示例:三

k8s按需创建PV和使用PVC详解

《k8s按需创建PV和使用PVC详解》Kubernetes中,PV和PVC用于管理持久存储,StorageClass实现动态PV分配,PVC声明存储需求并绑定PV,通过kubectl验证状态,注意回收... 目录1.按需创建 PV(使用 StorageClass)创建 StorageClass2.创建 PV

vite搭建vue3项目的搭建步骤

《vite搭建vue3项目的搭建步骤》本文主要介绍了vite搭建vue3项目的搭建步骤,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学... 目录1.确保Nodejs环境2.使用vite-cli工具3.进入项目安装依赖1.确保Nodejs环境

Nginx搭建前端本地预览环境的完整步骤教学

《Nginx搭建前端本地预览环境的完整步骤教学》这篇文章主要为大家详细介绍了Nginx搭建前端本地预览环境的完整步骤教学,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 目录项目目录结构核心配置文件:nginx.conf脚本化操作:nginx.shnpm 脚本集成总结:对前端的意义很多

Redis 基本数据类型和使用详解

《Redis基本数据类型和使用详解》String是Redis最基本的数据类型,一个键对应一个值,它的功能十分强大,可以存储字符串、整数、浮点数等多种数据格式,本文给大家介绍Redis基本数据类型和... 目录一、Redis 入门介绍二、Redis 的五大基本数据类型2.1 String 类型2.2 Hash