vevet/src/components/SplitText/utils/wrapLines.ts

Vevet is a JavaScript library for creative development that simplifies crafting rich interactions like split text animations, carousels, marquees, preloading, and more.

import { cnAdd } from '@/internal/cn';
import { doc } from '@/internal/env';

import { ISplitTextLineMeta, ISplitTextWordMeta } from '../types';

import { getTextAlignment } from './getTextAlignment';

interface IProps {
  container: HTMLElement;
  hasLinesWrapper: boolean;
  wordsMeta: ISplitTextWordMeta[];
  lineClassName: string;
  lineWrapperClassName: string;
  tagName: keyof HTMLElementTagNameMap;
}

interface ILine extends ISplitTextLineMeta {
  nodes: Node[];
}

/**
 * Recursively retrieves the top parent element of a given element within a container.
 */
function getTopParent(ref: Element | null, topParent: Element): Element | null {
  if (!ref?.parentElement) {
    return null;
  }

  if (ref.parentElement === topParent) {
    return ref;
  }

  return getTopParent(ref?.parentElement ?? null, topParent);
}

export function childOf(element: Element, parent: Element) {
  if (element === parent) {
    return true;
  }

  if (element !== null) {
    return childOf(element.parentNode as Element, parent);
  }

  return false;
}

/**
 * Wraps each word in the container into lines, based on their vertical position.
 */
export function wrapLines({
  container,
  hasLinesWrapper,
  wordsMeta,
  lineClassName,
  lineWrapperClassName,
  tagName,
}: IProps) {
  const direction = getTextAlignment(container);

  const linesMeta: ILine[] = [];
  let lineIndex = -1;
  let lastBounding: DOMRect | null = null;

  const baseElement = doc.createElement(tagName);
  baseElement.style.display = 'block';
  baseElement.setAttribute('aria-hidden', 'true');
  cnAdd(baseElement, lineClassName);

  const boundings = wordsMeta.map((wordMeta) =>
    wordMeta.element.getBoundingClientRect(),
  );

  // Create lines by wrapping words
  wordsMeta.forEach((wordMeta, index) => {
    const bounds = boundings[index];
    const topParent = getTopParent(wordMeta.element, container);

    if (!topParent) {
      return;
    }

    // create new line if the top position changes

    const isNextTop = lastBounding && bounds.top > lastBounding.top;
    const isNextLeft = lastBounding && bounds.left >= lastBounding.left;
    const isPrevLeft = lastBounding && bounds.left <= lastBounding.left;

    if (
      !lastBounding ||
      (isNextTop && isPrevLeft && direction === 'left') ||
      (isNextTop && isNextLeft && direction === 'right') ||
      (isNextTop && direction === 'center')
    ) {
      lineIndex += 1;

      const element = baseElement.cloneNode(false) as HTMLElement;

      let wrapper: HTMLElement | undefined;

      if (hasLinesWrapper) {
        wrapper = doc.createElement(tagName);
        wrapper.style.display = 'block';
        cnAdd(wrapper, lineWrapperClassName);
        wrapper.appendChild(element);
      }

      linesMeta[lineIndex] = { element, wrapper, nodes: [], words: [] };
    }

    lastBounding = bounds;

    const currentLine = linesMeta[lineIndex];

    const isInList = !!linesMeta.find(({ nodes }) => nodes.includes(topParent));

    if (!isInList) {
      currentLine.nodes.push(topParent);

      if (topParent.nextSibling?.nodeType === 3) {
        currentLine.nodes.push(topParent.nextSibling);
      }
    }
  });

  // Append line elements to the container
  linesMeta.forEach((line) => {
    container.insertBefore(line.wrapper ?? line.element, line.nodes[0]);

    const fragment = doc.createDocumentFragment();
    fragment.append(...line.nodes);
    line.element.append(fragment);
  });

  // Hide any extra <br> elements after lines
  const hiddenBr: HTMLBRElement[] = [];
  linesMeta.forEach((line) => {
    const nextSibling = (line.wrapper ?? line.element).nextElementSibling;
    if (nextSibling instanceof HTMLBRElement) {
      nextSibling.style.display = 'none';
      hiddenBr.push(nextSibling);
    }
  });

  // Associate words with the corresponding lines
  linesMeta.forEach((line) => {
    line.words.push(
      ...wordsMeta.filter((word) => childOf(word.element, line.element)),
    );
  });

  // Destroy method to undo the line wrapping
  const destroy = () => {
    let isSuccess = true;

    hiddenBr.forEach((br) => {
      br.style.display = '';
    });

    linesMeta.forEach((line) => {
      line.nodes.forEach((node) => {
        const reference = line.wrapper ?? line.element;

        if (reference.parentElement) {
          container.insertBefore(node, reference);
        } else {
          isSuccess = false;
        }
      });

      line.element.remove();
      line.wrapper?.remove();
    });

    return isSuccess;
  };

  return { linesMeta, destroy };
}