图文联动
布局 · 区块 · 已复制 0 次
React
左文右图(或反向):点左侧哪一项,右侧媒体就交叉淡入到对应素材,同时该项展开正文。 每一项下面那条分割线**本身就是切换进度条**——当前项的下横线从左往右填满,填满即切下一项;切走的那一项立刻归零,新项从 0 开始。时长与自动轮换读同一个值,所以「线走完」和「换项」是同一件事。手点过之后不再自动切换,线也随之撤掉:一条走不完的倒计时线等于骗人。 线的厚度仍是 1px,不额外多一条横杠、不改变排版——这是刻意的,加粗成 2px 就会把列表的行距顶开。演示素材(图片 / 视频 / logo / 字体)已全部上传到本站,代码里用的是绝对地址,粘进项目就能显示;换成自己的素材改 `ASSET` 一行即可。
调参预览改动实时生效,代码一起变
演示页加载中…
演示在 iframe 里独立运行(1280×560 虚拟视口,缩放 50%)。右侧时间轴之类的交互要在框内滚动才看得到。
快速上手,一路向前。
3 行 · 一行一项
关
dark
开
开
5200
150015000
500
1001500
12
040
复制走的就是这段 —— 只列你改过的参数,其余用组件默认值
当前为默认值// 你在 uibits.cn 调出来的这一版。只列改过的参数,其余用组件默认值。
// 素材已经是本站绝对地址,贴进项目就能显示;换成自己的素材时改 src 即可。
// 完整实现见详情页「源码」。
<SplitFeatures
title="快速上手,一路向前。"
items={[
{
title: "10 分钟在线申请",
body: "免费开立支票与储蓄账户,无需到网点,也不用纸质材料。",
media: { type: 'img', src: "https://uibits.cn/demo/component/assets/img/apply-online.webp" },
},
{
title: "当天即可获得信用卡^4",
body: "符合条件的客户开户当天就能使用信用卡——没有最低消费、信用记录或个人担保要求。",
link: "https://uibits.cn/demo/component/cards/index.html",
media: { type: 'img', src: "https://uibits.cn/demo/component/assets/img/virtual-cards.webp" },
},
{
title: "几秒钟搞定银行业务",
body: "一个搜索框就能找到任何交易、供应商或银行卡,还能直接付款、转账——所有操作一站完成。",
media: { type: 'img', src: "https://uibits.cn/demo/component/assets/img/cards.webp" },
},
]}
/>源码
/* SplitFeatures —— 来自 uibits.cn 组件库,复制即用。
*
* 依赖:react、next(只有图文联动的「了解更多 →」用到 next/link)
* 素材:全部在 uibits.cn 上,代码里用的是绝对地址,贴进项目就能显示。
* 换成自己的素材时,改顶部 ASSET 常量即可(或者逐处替换 src)。
*/
'use client';
import Link from 'next/link';
import { useEffect, useRef, useState, type CSSProperties } from 'react';
import type { ReactNode } from 'react';
/**
* 文案表里的两种轻标记:
* `^2` → <sup>2</sup>(模板原文里的上标编号)
* `|` → 换行(标题要按语义断两行,不能交给 balance 去猜)
*
* 参数面板给的是纯文本,组件默认值也是同一份纯文本,所以这里统一解释,
* 免得"改过参数"和"没改过参数"渲染出两套东西。
*/
function rich(text: string, opts: { br?: boolean } = {}): ReactNode {
const parts = String(text ?? '').split(/(\^\d+|\|)/g);
return parts.map((p, i) => {
if (/^\^\d+$/.test(p)) return <sup key={i}>{p.slice(1)}</sup>;
if (p === '|') return opts.br ? <br key={i} /> : ' ';
return p;
});
}
/**
* `标题 | 正文 | 链接` 这种行表 → 二维数组,空行丢掉。
*
* 也可以直接喂字符串数组(`['标题 | 正文', '标题 | 正文']`)——写 JSX 时
* 数组比一串 `\n` 好读,两种都收,免得调用方为了一个分隔符去拼字符串。
*/
function rows(text: string | string[]): string[][] {
const src = Array.isArray(text) ? text.join('\n') : String(text ?? '');
return src
.split('\n')
.map((line) => line.trim())
.filter(Boolean)
.map((line) => line.split('|').map((c) => c.trim()));
}
export type SplitMedia = { type: 'img' | 'video'; src: string; poster?: string };
export type SplitItem = {
/** 纯文本,支持 `^2` 上标 */
title: string;
body: string;
link?: string;
media: SplitMedia;
};
function SwapMedia({ item, active }: { item: SplitItem; active: boolean }) {
const vRef = useRef<HTMLVideoElement>(null);
useEffect(() => {
const v = vRef.current;
if (!v) return;
if (active) {
if (!v.dataset.armed) {
v.dataset.armed = '1';
v.load();
}
const p = v.play();
if (p && p.catch) p.catch(() => {});
} else {
v.pause();
}
}, [active]);
if (item.media.type === 'video') {
return (
<video
ref={vRef}
muted
loop
playsInline
preload="none"
poster={item.media.poster}
src={item.media.src}
aria-label={item.title}
/>
);
}
/* eslint-disable-next-line @next/next/no-img-element */
return <img src={item.media.src} alt={item.title} loading="lazy" />;
}
/**
* 左文右图(或反向):点左侧列表项,右侧媒体交叉淡入到对应素材。
*
* 可调项(都能从参数面板实时改):
* reverse 媒体放左侧
* theme 写进 data-theme(注意:本包不含 ThemeFlow,单独用时它不会换色板)
* autoPlay 是否自动轮换
* intervalMs 轮换间隔
* transitionMs 交叉过渡时长(走 --split-dur)
* radius 媒体圆角(走 --split-radius)
*/
export default function SplitFeatures({
title,
items,
reverse = false,
theme = 'dark',
autoPlay = true,
showProgress = true,
intervalMs = 5200,
transitionMs = 500,
radius,
}: {
title: string;
items: SplitItem[];
reverse?: boolean;
theme?: 'dark' | 'paper';
autoPlay?: boolean;
/** 当前项下分割线上的切换进度条 */
showProgress?: boolean;
intervalMs?: number;
transitionMs?: number;
radius?: number;
}) {
const [active, setActive] = useState(0);
/* 用户手点过就停:自动轮换停了,进度条也得停——一条走不完的线等于说谎 */
const [picked, setPicked] = useState(false);
/* 进度条只在"真的会自动切下一项"时出现:不自动轮换、只剩一项、用户已手点,
三种情况都没有"下一次",画一条倒计时线就是在骗人。 */
const running = autoPlay && !picked && items.length > 1;
// 自动轮换(用户手动点过就停)
useEffect(() => {
if (!running) return;
const t = setInterval(() => {
setActive((i) => (i + 1) % items.length);
}, intervalMs);
return () => clearInterval(t);
}, [running, intervalMs, items.length]);
// 条目变少时把选中项夹回范围内,否则右侧一张图都不显示
useEffect(() => {
setActive((i) => (items.length ? Math.min(i, items.length - 1) : 0));
}, [items.length]);
// 条目被换掉(长度不变但内容换了)时,别把"用户已手点"的锁带过去
useEffect(() => {
setPicked(false);
}, [items.length]);
const pick = (i: number) => {
setPicked(true);
setActive(i);
};
const style = {
'--split-dur': `${transitionMs}ms`,
...(radius == null ? {} : { '--split-radius': `${radius}px` }),
} as CSSProperties;
const copy = (
<div className="split__copy">
<h2 className="h5">{rich(title)}</h2>
<ul className="feature-list">
{items.map((f, i) => (
<li key={i} className={`feature${i === active ? ' is-open' : ''}`}>
<button className="feature__head" type="button" onClick={() => pick(i)} aria-expanded={i === active}>
<span className="feature__dot" aria-hidden="true" />
<span>{rich(f.title)}</span>
</button>
<div className="feature__body">
<p>{rich(f.body)}</p>
{f.link ? (
<Link className="text-link" href={f.link}>
了解更多 →
</Link>
) : null}
</div>
{/* 当前项的下分割线走一条进度;切走即卸载,新项重新从 0 开始 */}
{showProgress && running && i === active ? (
<span
className="feature__bar"
style={{ animationDuration: `${intervalMs}ms` }}
aria-hidden="true"
/>
) : null}
</li>
))}
</ul>
</div>
);
const media = (
<figure className="split__media">
{items.map((f, i) => (
<div key={i} className={`swap${i === active ? ' is-on' : ''}`} aria-hidden={i !== active}>
<SwapMedia item={f} active={i === active} />
</div>
))}
</figure>
);
return (
<section className={`section split${reverse ? ' split--reverse' : ''}`} data-theme={theme} style={style}>
<div className="container">
<div className="w12 split__grid">
{reverse ? (
<>
{media}
{copy}
</>
) : (
<>
{copy}
{media}
</>
)}
</div>
</div>
</section>
);
}
可调参数
| 参数 | 类型 | 默认值 |
|---|---|---|
标题title | text | 快速上手,一路向前。 |
条目items | textarea | 10 分钟在线申请 | 免费开立支票与储蓄账户,无需到网点,也不用纸质材料。 | 当天即可获得信用卡^4 | 符合条件的客户开户当天就能使用信用卡——没有最低消费、信用记录或个人担保要求。 | /cards 几秒钟搞定银行业务 | 一个搜索框就能找到任何交易、供应商或银行卡,还能直接付款、转账——所有操作一站完成。 | |
媒体放左侧(反向布局)reverse | 开关 | 关 |
区块 theme 属性theme | 枚举:dark / paper | dark |
自动轮换autoPlay | 开关 | 开 |
下分割线进度条showProgress | 开关 | 开 |
轮换间隔intervalMs | 数值 1500–15000 / 步长 500 | 5200 |
交叉过渡时长transitionMs | 数值 100–1500 / 步长 50 | 500 |
媒体圆角radius | 数值 0–40 / 步长 1 | 12 |
上方的调参预览可以直接拖动,改完点「复制当前代码」拿走带你自己参数的版本。
相似组件
按标签重合度推荐,不是运营手配的榜单。



