PAYATHON 2026

如何让水平滚动缩略图列表的自定义按钮固定在容器两侧?

数据小陈

将列表放进单独的滚动层,按钮留在这一层外,并相对于外层容器绝对定位。这样列表可以水平滚动,按钮始终位于外层容器的左下角和右下角。

为什么 absolute 按钮仍会随列表滚动?

原代码中,.folio_ss_cont 同时承担两个职责:

  • 通过 position: relative 为按钮提供定位参照。
  • 通过 overflow-x: auto 提供水平滚动区域。

虽然按钮与 .folio_ss_slider 是兄弟元素,它们仍然是 .folio_ss_cont 的子元素。position: absolute 让按钮脱离普通文档流,但按钮仍属于祖先元素的滚动内容,因此会随着 .folio_ss_cont 滚动。

可以改成下面的结构:

.folio_ss_cont                 外层定位容器
├── .folio_ss_viewport         水平滚动区域
│   └── .folio_ss_slider       缩略图列表
├── 左侧按钮
└── 右侧按钮

调整 HTML 结构

新增 .folio_ss_viewport,把原来的列表放进去。按钮保留在 .folio_ss_cont 内,与 .folio_ss_viewport 同级。

示例列出两个项目,其余项目按相同结构添加即可。href 是占位地址,需要换成实际链接。

<div class="folio_ss_cont">
  <div
    class="folio_ss_viewport"
    id="fss_viewport_cine"
    tabindex="0"
    role="region"
    aria-label="缩略图列表"
  >
    <div class="folio_ss_slider" id="fss_slider_cine">
      <a href="#item-1">
        <div class="folio_ss_item_cont">
          <img
            class="folio_ss_item_thm"
            alt="Thumbnail image"
            src="/img/folio_thumbs/1.jpg"
          />
          <p>Item 1</p>
        </div>
      </a>

      <a href="#item-2">
        <div class="folio_ss_item_cont">
          <img
            class="folio_ss_item_thm"
            alt="Thumbnail image"
            src="/img/folio_thumbs/2.jpg"
          />
          <p>Item 2</p>
        </div>
      </a>
    </div>
  </div>

  <button
    type="button"
    class="folio_ss_btn_scroll_L"
    aria-label="向左滚动"
    aria-controls="fss_viewport_cine"
  >❰</button>

  <button
    type="button"
    class="folio_ss_btn_scroll_R"
    aria-label="向右滚动"
    aria-controls="fss_viewport_cine"
  >❱</button>
</div>

原生 button 支持键盘操作。原代码中的 <a> 没有 href,需要跳转的链接应补上实际地址。

将 overflow 移到内部滚动区域

用以下样式替换原有样式。按钮尺寸可以根据页面设计调整,重点是让按钮的定位父元素不再负责列表的水平滚动。

.folio_ss_cont {
  position: relative;
  width: 50%;
  background: #faa;
  color: #fff;
}

.folio_ss_viewport {
  width: 100%;
  overflow-x: auto;
  overflow-y: hidden;
  scrollbar-width: none;
}

.folio_ss_viewport::-webkit-scrollbar {
  display: none;
}

.folio_ss_slider {
  width: fit-content;
  min-width: 100%;
  display: flex;
  flex-flow: row nowrap;
  background: #afa;
}

.folio_ss_slider a {
  flex: 0 0 auto;
  margin: min(3vw, 3vh);
}

.folio_ss_item_cont {
  width: 30vw;
  background: #aaf;
}

.folio_ss_item_thm {
  display: block;
  width: 100%;
  aspect-ratio: 1;
  object-fit: cover;
  margin-bottom: min(1vw, 1vh);
}

.folio_ss_item_cont p {
  margin-bottom: 0;
}

.folio_ss_btn_scroll_L,
.folio_ss_btn_scroll_R {
  position: absolute;
  bottom: 0;
  z-index: 1;
  width: 3rem;
  height: 3rem;
  padding: 0;
  border: 0;
  box-sizing: border-box;
  display: flex;
  justify-content: center;
  align-items: center;
  background: rgb(0 0 0 / 36%);
  color: #fff;
  font-size: 2rem;
  cursor: pointer;
}

.folio_ss_btn_scroll_L {
  left: 0;
}

.folio_ss_btn_scroll_R {
  right: 0;
}

scrollbar-width: none 和 ::-webkit-scrollbar 用于隐藏滚动条,具体效果取决于浏览器支持情况。滚动区域仍保留 overflow-x: auto,可以继续通过按钮、触摸或触控板水平滚动。

按钮应滚动 viewport

结构调整后,应在 .folio_ss_viewport 上调用 scrollBy()。.folio_ss_slider 负责撑开内容宽度,外层 .folio_ss_cont 负责按钮定位。

将这段脚本放在上述 HTML 后面:

const viewport = document.getElementById('fss_viewport_cine');
const container = viewport.parentElement;

function folioSliderScroll(direction) {
  const distance = viewport.clientWidth * 0.8;
  const reduceMotion = window.matchMedia(
    '(prefers-reduced-motion: reduce)'
  ).matches;

  viewport.scrollBy({
    left: direction === 'L' ? -distance : distance,
    behavior: reduceMotion ? 'instant' : 'smooth'
  });
}

container
  .querySelector('.folio_ss_btn_scroll_L')
  .addEventListener('click', () => folioSliderScroll('L'));

container
  .querySelector('.folio_ss_btn_scroll_R')
  .addEventListener('click', () => folioSliderScroll('R'));

示例中每次滚动可视宽度的 80%,步长可以按需求修改。到达边界时,浏览器会将滚动位置限制在有效范围内。

如何保持列表链接可点击?

这个结构中只有两个按钮覆盖在列表上方,没有铺满整个容器的透明遮罩,因此按钮以外的链接区域可以正常点击。

按钮覆盖的区域,包括半透明背景部分,会接收按钮点击。如果需要让链接更容易操作,可以缩小按钮,或为滚动区域增加底部空间,将按钮放在独立的底部区域。

不要给按钮设置 pointer-events: none,否则它们无法响应鼠标点击。如果以后增加覆盖整个容器的控制层,可以给控制层设置 pointer-events: none,再给其中的按钮设置 pointer-events: auto。

position: sticky 会保留元素在普通文档流中的空间,这也解释了原方案中容器高度发生变化的现象。对于覆盖在滚动列表两侧的按钮,分开定位容器和滚动区域更直接,也不需要改用相对于视口定位的 position: fixed。

备注:内容仅供参考。