用途:渲染两条垂直滚动的轨道,左侧为文字列表(标题),右侧为媒体列表(缩略图),两者严格同步移动。当行经过焦点中心时,文字行与对应媒体行同时被高亮。这是 SP-D 编辑杂志(editorial-magazine)风格包的核心机制。
主要能力:支持通过参数自定义视口高度与圆角、文字轨道的横向位置/宽度/对齐/字体/字号/行高/字体样式、媒体轨道的横向位置/宽度/缩略图尺寸/圆角/间距/可见堆叠数量、滚动速度与方向、缓动、上下淡出遮罩比例,以及焦点行的纵向位置。每行由标题与媒体源组成。
使用方式:按配置对象传入参数即可,包括 viewport_height_pct、viewport_radius_px、text_rail、media_rail、rows、scroll_velocity_px_per_sec、scroll_direction、easing、fade_mask_top_pct、fade_mask_bottom_pct、active_row_focal_y_px。行为上先渲染带圆角的视口并在其中放置两条轨道,再对每条轨道同步执行 transform: translateY 动画,并用 CSS mask-image 做上下柔和淡出。媒体轨道中每个缩略图应为真实的 <video autoplay loop muted> 元素,每行不透明度根据与 active_row_focal_y_px 的距离变化。
适用场景:编辑杂志类动态排版、标题与媒体配对滚动的展示页等。
限制与检查:两条轨道必须真正同步(同一帧使用同一 translateY),应共用单一共享的 translateY 变量;内侧视频须为真实视频而非静帧;淡出遮罩需用 CSS mask-image 而非仅能渐变为单色的 linear-gradient 叠加层;滚动须为线性、无缓动。默认样式为 SP-D:米白背景、墨色文字。参数中的 media_src 与 assets 路径等具体资源需自行提供。