WordPress中Slick Slider自定义导航箭头同步显示对应滑块文章标题
Slick双联动滑块动态导航标题实现方案
实现前置逻辑
JS运行阶段无法直接调用WordPress的PHP函数,因此需要在页面渲染阶段将每个滑块对应的文章标题,通过自定义属性预存在DOM节点上,保证JS读取的标题与the_title()输出的内容完全一致。
步骤1:PHP层预存滑块标题
在WordPress循环输出每个滑块项时,将当前文章标题写入滑块元素的data-slide-title自定义属性,同时做转义处理避免特殊字符破坏DOM结构:
// 滑块循环输出示例 while ( $slider_query->have_posts() ) { $slider_query->the_post(); // 输出内容图区滑块项 printf( '<div class="content-image__item" data-slide-title="%s">', esc_attr( get_the_title() ) ); // 图片内容渲染逻辑 echo '</div>'; // 输出文本区滑块项 printf( '<div class="content-image-content__item" data-slide-title="%s">', esc_attr( get_the_title() ) ); // 文本内容渲染逻辑 echo '</div>'; }
注:这里使用
get_the_title()取值后转义,最终渲染到页面的标题值与直接调用the_title()输出的内容100%匹配,无格式差异。
步骤2:改造自定义导航箭头结构
在原有自定义箭头的HTML中新增标题占位节点,用于动态写入相邻滑块的文章标题:
// 文本区滑块的箭头配置调整 prevArrow: '<div class="content-image-arrow prev slick-arrow"><img src="/wp-content/themes/axia/img/icons/next-white.svg"/><span class="arrow-title"></span></div>', nextArrow: '<div class="content-image-arrow next slick-arrow"><img src="/wp-content/themes/axia/img/icons/next-white.svg"/><span class="arrow-title"></span></div>',
步骤3:绑定滑块事件实现标题动态更新
基于Slick原生的初始化、切换完成事件,编写通用的标题更新逻辑,适配无限循环的索引边界问题,完整初始化代码如下:
const $imageSlider = $('.content-image'); const $textSlider = $('.content-image-content'); // 通用标题更新方法 function updateArrowTitles(slickInstance) { const totalSlides = slickInstance.slideCount; const currentIndex = slickInstance.currentSlide; // 计算相邻滑块索引,适配无限循环的边界逻辑 const prevIndex = (currentIndex - 1 + totalSlides) % totalSlides; const nextIndex = (currentIndex + 1) % totalSlides; // 读取滑块预存的标题并写入箭头占位 const prevTitle = $(slickInstance.$slides[prevIndex]).data('slide-title'); const nextTitle = $(slickInstance.$slides[nextIndex]).data('slide-title'); $textSlider.find('.slick-arrow.prev .arrow-title').text(prevTitle); $textSlider.find('.slick-arrow.next .arrow-title').text(nextTitle); } // 初始化图区联动滑块 $imageSlider.slick({ infinite: true, dots: false, speed: 300, slidesToShow: 1, slidesToScroll: 1, centerMode: true, mobileFirst: true, asNavFor: ".content-image-content", responsive: [ { breakpoint: 1124, settings: { slidesToShow: 3, slidesToScroll: 1 } }, { breakpoint: 1024, settings: { slidesToShow: 3, slidesToScroll: 1 } }, { breakpoint: 768, settings: { slidesToShow: 3, slidesToScroll: 1 } }, { breakpoint: 567, settings: { slidesToShow: 3, slidesToScroll: 1 } } ], }); // 初始化文本区联动滑块 $textSlider.slick({ dots: false, arrows: true, infinite: true, fade: true, speed: 300, slidesToShow: 1, slidesToScroll: 1, prevArrow: '<div class="content-image-arrow prev slick-arrow"><img src="/wp-content/themes/axia/img/icons/next-white.svg"/><span class="arrow-title"></span></div>', nextArrow: '<div class="content-image-arrow next slick-arrow"><img src="/wp-content/themes/axia/img/icons/next-white.svg"/><span class="arrow-title"></span></div>', asNavFor: ".content-image", // 页面加载完成时初始化箭头标题 init: function(event, slick) { updateArrowTitles(slick); }, // 滑块切换完成时同步更新箭头标题 afterChange: function(event, slick) { updateArrowTitles(slick); } });
适配说明
- 因为两个滑块通过
asNavFor配置双向联动,不管是点击图区的滑块项,还是点击文本区的导航箭头,都会触发文本区滑块的状态更新,标题逻辑不需要重复绑定 - 索引计算采用取模运算,完全适配
infinite: true的无限循环模式,不会在首尾滑块位置出现索引越界、标题取值错误的问题 - 所有标题来源均为WordPress循环输出的原生文章数据,和后台编辑的文章标题实时同步,不需要在JS中硬编码任何静态标题值
内容的提问来源于stack exchange,提问作者Dionoh
相关产品推荐
相关产品推荐

