项目场景
客户要求做一个表单页面，表单数据分为三步，每一步骤是一个单独的 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');
}
