UI Bits

图文联动

布局 · 区块 · 已复制 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>
  );
}

可调参数

参数类型默认值
标题titletext快速上手,一路向前。
条目itemstextarea10 分钟在线申请 | 免费开立支票与储蓄账户,无需到网点,也不用纸质材料。 | 当天即可获得信用卡^4 | 符合条件的客户开户当天就能使用信用卡——没有最低消费、信用记录或个人担保要求。 | /cards 几秒钟搞定银行业务 | 一个搜索框就能找到任何交易、供应商或银行卡,还能直接付款、转账——所有操作一站完成。 |
媒体放左侧(反向布局)reverse开关关
区块 theme 属性theme枚举:dark / paperdark
自动轮换autoPlay开关开
下分割线进度条showProgress开关开
轮换间隔intervalMs数值 1500–15000 / 步长 5005200
交叉过渡时长transitionMs数值 100–1500 / 步长 50500
媒体圆角radius数值 0–40 / 步长 112

上方的调参预览可以直接拖动,改完点「复制当前代码」拿走带你自己参数的版本。

相似组件

按标签重合度推荐,不是运营手配的榜单。

首屏镜头推进 截图

首屏镜头推进

布局 · 区块

命令面板 预览

命令面板

导航 · 组件

光标光斑卡片 预览

光标光斑卡片

布局 · 元素

渐隐跑马灯 截图

渐隐跑马灯

媒体 · 组件