# Inline Image Text

> A large sentence with small pictures set in its lines, at letter height. Lines rise from their mask and each picture opens as its line lands. Sized in em; a muted loop works too.

Text effects · text, image, video, reveal, mask · HTML, CSS, vanilla JS · no dependencies · updated 2026-11-03
Demo: https://kodza.dev/components/inline-image-text/
Source on GitHub: https://github.com/kodza-dev/kodza/tree/main/components/inline-image-text

## Files

The code below, served as files: byte for byte what the Kodza site copies (the CSS includes its theme guard).

- [`kodza-inline-image-text.css`](https://kodza.dev/registry/inline-image-text/kodza-inline-image-text.css) · 7.0 KB
- [`kodza-inline-image-text.js`](https://kodza.dev/registry/inline-image-text/kodza-inline-image-text.js) · 14.5 KB
- [`kodza-inline-image-text.html`](https://kodza.dev/registry/inline-image-text/kodza-inline-image-text.html) · 0.9 KB · the markup, to adapt and paste into your page

**Can you run shell commands? Download the CSS and the JS, don't retype them.** Retyping costs thousands of tokens and can drop or change lines of the CSS. Put the files where your stack expects them (Use it says where: change the `-o` paths):

```bash
curl -fsSL --create-dirs -o kodza/kodza-inline-image-text.css https://kodza.dev/registry/inline-image-text/kodza-inline-image-text.css
curl -fsSL --create-dirs -o kodza/kodza-inline-image-text.js https://kodza.dev/registry/inline-image-text/kodza-inline-image-text.js
```

Then load the files from your page as Use it shows, instead of pasting the content. The HTML is the part you adapt (text, links, modifiers): paste it from the Code section. Copy the CSS and the JS from the Code section only if you can't run commands, exactly as they are. (Windows PowerShell: `curl.exe`.)

## API

- Root: `.kodza-inline-image-text`
- Element: put the root class on the page's own paragraph or heading. It keeps the page's font, size and layout; the component only adds its effect.
- Variables (set them on the root element itself: it declares its own defaults):
  - `--kz-inline-image-text-width: 2em`
  - `--kz-inline-image-text-height: 0.9em`
  - `--kz-inline-image-text-radius: calc(0.26em * var(--kz-radius-scale, 1))`
  - `--kz-inline-image-text-gap: 0.06em` — on each side, on top of the spaces
  - `--kz-inline-image-text-offset: -0.08em` — below the baseline, to sit centred on the letters
  - `--kz-inline-image-text-duration: 0.9s`
  - `--kz-inline-image-text-stagger: 90ms`
  - `--kz-inline-image-text-zoom: 1.14`
  - `--kz-inline-image-text-ease: cubic-bezier(0.22, 1, 0.36, 1)`
- Lifecycle: `kodza:init` / `kodza:destroy` on `document`, with `{ detail: { root } }` to target a container.

## Images

The shape of each image slot, measured in the demo at 1440 × 900 (desktop) and 390 × 844 (mobile). Where the shape is fixed, the frame crops the image to it: export in that shape, keep the subject near the centre, at twice the widest size shown (sharp on retina screens).

| Slot | Desktop | Mobile | Widest shown |
| --- | --- | --- | --- |
| `.kodza-inline-image-text__media img` | 2.24:1 | 2.22:1 | 112 px |
| `.kodza-inline-image-text__media video` | 2.24:1 | 2.22:1 | 112 px |

## Dark mode

Nothing to set: it takes its colours from the text around it, or looks the same on a light and a dark page.

Its images have dark versions next to them (`kz-stack-dark-1400.webp` → `kz-stack-dark-dark-1400.webp`). To swap them on a dark page: `<picture><source media="(prefers-color-scheme: dark)" srcset="…-dark-….webp"><img …></picture>`.

## Use it

### Plain HTML page

- CSS: `kodza/kodza-inline-image-text.css` next to the page (the Files commands as they are), linked in `<head>`: `<link rel="stylesheet" href="kodza/kodza-inline-image-text.css">`. Without a shell, paste it in a `<style>` in `<head>` instead. It only touches `kodza-` classes.
- HTML: where the component goes. Paste it as many times as you need: instances never interfere.
- JS: `kodza/kodza-inline-image-text.js`, loaded with `<script src="kodza/kodza-inline-image-text.js" defer></script>` in `<head>`. Without a shell, paste it in a `<script>` before `</body>` (or in `<head>`: it waits for the page). One copy per page, whatever the number of instances.
- Restyle with the `--kz-…` variables, set on the component's root element itself (the root declares its own defaults, so a value on an ancestor is ignored), and with the modifiers / attributes listed under API.
- Font: it takes the page's own. The Kodza look is Geist: `<link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600;700&family=Geist+Mono:wght@400;500&display=swap">`.
- Corners: a site with its own shapes sets them once for every Kodza component, on `:root`, never by editing the CSS (unset, nothing changes): `--kz-radius-scale` multiplies every corner (`0` square, `0.5` softer, `1` Kodza).
- Motion: a site sets its pace once for every Kodza component, on `:root`, never by editing the CSS or the JS: `--kz-motion-scale` multiplies every duration (`0.5` twice as fast, `2` twice as slow, `0` no motion at all, loops stopped, like reduced motion). Unset, nothing changes.
- Content added later (AJAX navigation, a SPA route, a builder preview): start it with `document.dispatchEvent(new CustomEvent('kodza:init', { detail: { root: container } }))`; before removing it, the same call with `'kodza:destroy'` stops it and puts the original markup back.

### Claude artifact (claude.ai)

- Paste the CSS in a `<style>` and the JS in a `<script>` at the end, in the artifact itself: it loads stylesheets only from Google Fonts and scripts only from a few CDNs, so no `<link>` or `<script src>` to Kodza.
- Writing the artifact file with a shell? Insert the downloaded files (Files) with a command instead of retyping them: a line `KODZA-CSS` alone inside the `<style>`, `KODZA-JS` inside the `<script>`, then `sed -e '/^KODZA-CSS$/{r kodza/kodza-inline-image-text.css' -e 'd' -e '}' -e '/^KODZA-JS$/{r kodza/kodza-inline-image-text.js' -e 'd' -e '}' page.html > artifact.html`.
- Font: load Geist from Google Fonts (allowed): `<link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600;700&family=Geist+Mono:wght@400;500&display=swap">`.
- Corners: a site with its own shapes sets them once for every Kodza component, on `:root`, never by editing the CSS (unset, nothing changes): `--kz-radius-scale` multiplies every corner (`0` square, `0.5` softer, `1` Kodza).
- Motion: a site sets its pace once for every Kodza component, on `:root`, never by editing the CSS or the JS: `--kz-motion-scale` multiplies every duration (`0.5` twice as fast, `2` twice as slow, `0` no motion at all, loops stopped, like reduced motion). Unset, nothing changes.
- Images: the artifact blocks every other host, `kodza.dev` included, without an error. Embed each one as a `data:` URI, with a command if you can run one (`curl -s <url> | base64`; the 1400 px files weigh 10 to 30 KB), never by typing base64 out. If you can't run commands, keep the `<img>` with its `width` and `height`, and tell the user the picture stays blank inside the artifact.
- Dark mode: the viewer sets `data-theme="dark"` or `"light"` on `<html>`, or nothing when it follows the system. Write the Dark mode rules twice: inside `@media (prefers-color-scheme: dark)` with `:root:not([data-theme="light"])` in front of each selector, and with `:root[data-theme="dark"]` in front of each selector.

### WordPress

- HTML: a **Custom HTML** block (or a pattern / template part). WordPress keeps this markup as it is only for users allowed to post unfiltered HTML (Administrators; Super Admins on multisite): for anyone else it strips tags such as `<svg>`, `<input>` or `<dialog>`, so add it from the theme (a pattern or template part) instead.
- CSS and JS: the downloaded files go in the theme, under `wp-content/themes/<your-theme>/kodza/` (the child theme if there is one), enqueued from its functions.php (or a code-snippets plugin):
  ```php
  add_action('wp_enqueue_scripts', function () {
    $dir = get_stylesheet_directory() . '/kodza/';
    $uri = get_stylesheet_directory_uri() . '/kodza/';
    wp_enqueue_style('kodza-inline-image-text', $uri . 'kodza-inline-image-text.css', [], filemtime($dir . 'kodza-inline-image-text.css'));
    wp_enqueue_script('kodza-inline-image-text', $uri . 'kodza-inline-image-text.js', [], filemtime($dir . 'kodza-inline-image-text.js'), true);
  });
  ```
  Scoped to `kodza-` classes, the CSS never touches the theme. One copy of the JS, whatever the number of blocks.
- No access to the theme files? The CSS can also go, as it is, in **Appearance → Customize → Additional CSS** (classic theme) or **Styles → Additional CSS** in the Site Editor (block theme).
- Theme with AJAX page transitions: fire `kodza:init` on the new content after each swap (and `kodza:destroy` on the old one).
- Performance plugin (WP Rocket, LiteSpeed Cache, Perfmatters…) with **Delay JavaScript execution** turned on: add `kodza` to the scripts it must not delay. Otherwise the component waits for the visitor's first scroll, tap or mouse move, and that first click can be lost.
- Colours: it takes the colour of the text around it (or keeps its own monochrome): nothing to point at the theme.
- WordPress turns straight quotes and `--` into typographic ones in the text of a Custom HTML block (not inside `<code>` or `<pre>`).

#### With Elementor

- HTML: an **HTML** widget (Elementor shows it to administrators only). It keeps the code exactly as pasted, straight quotes included.
- CSS and JS: as above. Elementor's Site Settings → Theme Style styles every button, field, link and image of the page, components included; the theme guard at the end of the CSS keeps the component's buttons, fields and link colours as they are.
- The Elementor editor redraws each widget after the page has loaded: without the script below, the component stays still in the editor preview (the published page works). Add it once per site, in the footer like the component's script (`kodza/elementor-editor.js`, or a code-snippets plugin):

```js
// Kodza in the Elementor editor: the editor redraws each HTML widget after the page has loaded.
// Start Kodza in what it draws, stop it in what it replaces or removes. Once per site.
window.addEventListener('elementor/frontend/init', () => {
  if (!elementorFrontend.isEditMode()) return;
  class KodzaWidget extends elementorModules.frontend.handlers.Base {
    onInit() {
      super.onInit();
      this.kodza = [...this.$element[0].children];
      document.dispatchEvent(new CustomEvent('kodza:init', { detail: { root: this.$element[0] } }));
    }
    onDestroy() {
      super.onDestroy();
      this.kodza.forEach((root) => document.dispatchEvent(new CustomEvent('kodza:destroy', { detail: { root } })));
    }
  }
  elementorFrontend.elementsHandler.attachHandler('html', KodzaWidget);
});
```

- No child theme: everything can go in the HTML widget instead, `<style>` with the CSS, the HTML, then `<script>` with the JS. It works on the page and in the editor without the script above.

### Shopify

- Files: `assets/kodza-inline-image-text.css` and `assets/kodza-inline-image-text.js` (the Files commands with `-o assets/…`).
- In the section: `{{ 'kodza-inline-image-text.css' | asset_url | stylesheet_tag }}` and `<script src="{{ 'kodza-inline-image-text.js' | asset_url }}" defer></script>`, then the HTML.
- The theme editor re-renders sections: restart them with
  `document.addEventListener('shopify:section:load', (e) => document.dispatchEvent(new CustomEvent('kodza:init', { detail: { root: e.target } })));`
  and the same with `shopify:section:unload` → `kodza:destroy`.

### React / Next.js

- Files, side by side (e.g. in `components/kodza/`): `InlineImageText.tsx` (below), the CSS block under Code saved as `inline-image-text.css` and the JS block as `inline-image-text.js`, both as they are. The HTML block is already inside the component: skip it.
- Use it: `import { InlineImageText } from '@/components/kodza/InlineImageText';` then `<InlineImageText />`. Props: `vars` (the `--kz-…` variables listed under API, e.g. `vars={{ '--kz-inline-image-text-width': … }}`), `className`, `style` and the other props of its `<p>` (`onClick`, `aria-…`).
- Next.js App Router: it is a Client Component already (`'use client'`). Pages Router: Next.js takes global CSS only in `pages/_app`, so move the `import './inline-image-text.css'` line there.
- Safe under StrictMode, client-side navigation and prop changes: when a prop changes, the `key` gives React a fresh element, `kodza:destroy` stops the script on the old one and `kodza:init` starts it on the new one.
- Built from your data (tabs, rows, options)? Add what the markup is made of to the `key`, as plain values (ids, text, numbers). What the visitor changes (the open tab, the sort, what they type) is the script's: follow it with `onClick` or `onInput` on the root, and change it from your code as a visitor would (click the tab; set the field's value, then dispatch a bubbling `input` event). Fields stay uncontrolled (`defaultValue`, `name`).

```tsx
'use client';
// Kodza — Inline Image Text, for React. From https://kodza.dev/components/inline-image-text/
// Kodza License: free to use, client work included. Not to resell or redistribute, ported or not: https://kodza.dev/docs/#print-license
// Next to this file: inline-image-text.css and inline-image-text.js, the component's CSS and JS from Kodza, as they are.
// Yours to edit: the markup is plain JSX below.
// The script changes this markup once React has rendered it (it adds layers, splits text, moves
// nodes), so React must not patch it afterwards. When a prop changes, the key gives React a fresh
// element: kodza:destroy stops the script on the old one, kodza:init starts it on the new one.
// data-kodza-manual keeps the script from starting it on its own: the effect below does, once
// React has hydrated the markup (on a page that streams in, the script can load first).
// Built from your data (tabs, rows, options)? Put what the markup is made of in the key, as plain
// values (ids, text, numbers): a change starts the script again on fresh markup. What the visitor
// changes (the open tab, the sort, what they type) is the script's: keep it out of the key, follow
// it with onClick or onInput on the root, and change it from your code as a visitor would (click
// the tab; set the field's value, then dispatch a bubbling input event).
import { useRef, useEffect, type ComponentPropsWithoutRef, type ComponentRef, type CSSProperties } from 'react';
import './inline-image-text.css';

export type InlineImageTextProps = Omit<ComponentPropsWithoutRef<'p'>, "children" | "vars"> & {
  /** Settings, as CSS variables on the root */
  vars?: {
    /** default: 2em */
    "--kz-inline-image-text-width"?: string | number;
    /** default: 0.9em */
    "--kz-inline-image-text-height"?: string | number;
    /** default: calc(0.26em * var(--kz-radius-scale, 1)) */
    "--kz-inline-image-text-radius"?: string | number;
    /** on each side, on top of the spaces — default: 0.06em */
    "--kz-inline-image-text-gap"?: string | number;
    /** below the baseline, to sit centred on the letters — default: -0.08em */
    "--kz-inline-image-text-offset"?: string | number;
    /** default: 0.9s */
    "--kz-inline-image-text-duration"?: string | number;
    /** default: 90ms */
    "--kz-inline-image-text-stagger"?: string | number;
    /** default: 1.14 */
    "--kz-inline-image-text-zoom"?: string | number;
    /** default: cubic-bezier(0.22, 1, 0.36, 1) */
    "--kz-inline-image-text-ease"?: string | number;
  };
  className?: string;
};

export function InlineImageText({ vars, className, style, ...rest }: InlineImageTextProps) {
  const ref = useRef<ComponentRef<'p'>>(null);
  const classes = ["kodza-inline-image-text", className].filter(Boolean).join(' ');
  // Everything the markup is made of: when it changes, React gets a fresh element (see the top)
  const key = JSON.stringify([classes, vars, style, rest]);

  // Starts the script on this element once React has rendered it, stops it when it goes
  useEffect(() => {
    const root = ref.current;
    let live = true;
    // @ts-ignore: a plain script, no types to find
    import('./inline-image-text.js').then(() => {
      if (live) document.dispatchEvent(new CustomEvent('kodza:init', { detail: { root } }));
    });
    return () => {
      live = false;
      document.dispatchEvent(new CustomEvent('kodza:destroy', { detail: { root } }));
    };
  }, [key]);

  return (
    <p key={key} {...rest} className={classes} data-kodza-manual style={{ ...vars, ...style } as CSSProperties} ref={ref}>No stack <span className="kodza-inline-image-text__media"> <img src="https://kodza.dev/media/kz-stack-dark-1400.webp" alt="" width="1400" height="1050" loading="lazy" /> </span> of dependencies. No build steps <span className="kodza-inline-image-text__media"> <img src="https://kodza.dev/media/kz-steps-dark-1400.webp" alt="" width="1400" height="933" loading="lazy" /> </span>. No framework <span className="kodza-inline-image-text__media"> <img src="https://kodza.dev/media/kz-columns-dark-1400.webp" alt="" width="1120" height="1400" loading="lazy" /> </span> holding it up. Just code <span className="kodza-inline-image-text__media"> <video src="https://kodza.dev/media/kz-reel-dark-loop.mp4" poster="https://kodza.dev/media/kz-reel-dark-poster.webp" width="1280" height="720" muted loop playsInline preload="metadata" aria-hidden="true" /> </span> that runs where you paste it.</p>
  );
}
```

## Code

```html
<p class="kodza-inline-image-text">No stack <span class="kodza-inline-image-text__media"><img src="https://kodza.dev/media/kz-stack-dark-1400.webp" alt="" width="1400" height="1050" loading="lazy"></span> of dependencies. No build steps <span class="kodza-inline-image-text__media"><img src="https://kodza.dev/media/kz-steps-dark-1400.webp" alt="" width="1400" height="933" loading="lazy"></span>. No framework <span class="kodza-inline-image-text__media"><img src="https://kodza.dev/media/kz-columns-dark-1400.webp" alt="" width="1120" height="1400" loading="lazy"></span> holding it up. Just code <span class="kodza-inline-image-text__media"><video src="https://kodza.dev/media/kz-reel-dark-loop.mp4" poster="https://kodza.dev/media/kz-reel-dark-poster.webp" width="1280" height="720" muted loop playsinline preload="metadata" aria-hidden="true"></video></span> that runs where you paste it.</p>
```

```css
/* Kodza License: free to use, client work included. Not to resell or redistribute, ported or not: https://kodza.dev/docs/#print-license */
/* Kodza — Inline Image Text
   A sentence set large with small pictures sitting in its lines, at letter height. When it
   reaches the screen, its lines rise from behind their mask and each picture opens in turn as
   its line lands: from the top, settling with a slight zoom. A muted video loop works in
   place of an image. It plays once; send a "kodza:replay" event to the element to play it again.
   The sentence keeps the page's font and size: the pictures are sized in em, so they follow
   the text down to a phone. Everything is tuned with the --kz-inline-image-text-* variables. */
.kodza-inline-image-text {
  /* The pictures: size, shape, and where they sit on the line */
  --kz-inline-image-text-width: 2em;
  --kz-inline-image-text-height: 0.9em;
  --kz-inline-image-text-radius: calc(0.26em * var(--kz-radius-scale, 1));
  --kz-inline-image-text-gap: 0.06em; /* on each side, on top of the spaces */
  --kz-inline-image-text-offset: -0.08em; /* below the baseline, to sit centred on the letters */
  /* The entrance: a line's rise, the step between two lines, and the zoom a picture settles from.
     A picture opens in 1.1 times the rise, its zoom settles in 1.9 times. */
  --kz-inline-image-text-duration: 0.9s;
  --kz-inline-image-text-stagger: 90ms;
  --kz-inline-image-text-zoom: 1.14;
  --kz-inline-image-text-ease: cubic-bezier(0.22, 1, 0.36, 1);
}

.kodza-inline-image-text__media {
  display: inline-block;
  width: var(--kz-inline-image-text-width);
  height: var(--kz-inline-image-text-height);
  margin: 0 var(--kz-inline-image-text-gap);
  vertical-align: var(--kz-inline-image-text-offset);
  overflow: hidden;
  border-radius: var(--kz-inline-image-text-radius);
}

/* A picture element from a WordPress image plugin lets its image fill the box */
.kodza-inline-image-text__media picture {
  display: contents;
}

.kodza-inline-image-text__media img,
.kodza-inline-image-text__media video {
  display: block;
  width: 100%;
  max-width: none;
  height: 100%;
  object-fit: cover;
}

/* Hidden until it plays, only once the script is there to play it */
.kodza-inline-image-text.is-armed {
  opacity: 0;
}

/* While it plays, each line is a mask, with room for descenders without opening the gap
   between lines */
.kodza-inline-image-text__line {
  display: block;
  overflow: hidden;
  padding-bottom: 0.1em;
  margin-bottom: -0.1em;
}

.kodza-inline-image-text__row {
  display: block;
  transform: translateY(110%);
}

.kodza-inline-image-text.is-playing .kodza-inline-image-text__row {
  transform: none;
  transition: transform calc(var(--kz-inline-image-text-duration) * 1.1 * var(--kz-motion-scale, 1)) var(--kz-inline-image-text-ease) calc(var(--kz-line, 0) * var(--kz-inline-image-text-stagger) * var(--kz-motion-scale, 1));
}

/* A replay: the lines at rest leave upwards first, in 0.55 times the rise, half the stagger
   apart (the script waits as long, LEAVE and LEAVE_STEP) */
.kodza-inline-image-text.is-shown .kodza-inline-image-text__row {
  transform: none;
}

.kodza-inline-image-text.is-leaving .kodza-inline-image-text__row {
  transform: translateY(-110%);
  transition: transform calc(var(--kz-inline-image-text-duration) * 0.55 * var(--kz-motion-scale, 1)) cubic-bezier(0.65, 0, 0.35, 1) calc(var(--kz-line, 0) * var(--kz-inline-image-text-stagger) * 0.5 * var(--kz-motion-scale, 1));
}

/* A picture waits closed, zoomed in, until its turn (the script opens it once it is loaded) */
.kodza-inline-image-text.is-playing .kodza-inline-image-text__media:not(.is-open) {
  clip-path: inset(0 0 100% 0 round var(--kz-inline-image-text-radius));
}

.kodza-inline-image-text.is-playing .kodza-inline-image-text__media:not(.is-open) :is(img, video) {
  transform: scale(var(--kz-inline-image-text-zoom));
}

.kodza-inline-image-text .kodza-inline-image-text__media.is-open {
  clip-path: inset(0 0 0 0 round var(--kz-inline-image-text-radius));
  transition: clip-path calc(var(--kz-inline-image-text-duration) * 1.1 * var(--kz-motion-scale, 1)) var(--kz-inline-image-text-ease);
}

.kodza-inline-image-text .kodza-inline-image-text__media.is-open :is(img, video) {
  transform: none;
  transition: transform calc(var(--kz-inline-image-text-duration) * 1.9 * var(--kz-motion-scale, 1)) var(--kz-inline-image-text-ease);
}

@media (prefers-reduced-motion: reduce) {
  .kodza-inline-image-text.is-armed {
    opacity: 1;
  }

  .kodza-inline-image-text .kodza-inline-image-text__row,
  .kodza-inline-image-text .kodza-inline-image-text__media,
  .kodza-inline-image-text .kodza-inline-image-text__media :is(img, video) {
    transition: none !important;
  }
}

/* kodza-guard 65f3441a02b5 — generated by Kodza, do not edit.
   Theme guard: keeps a site's own CSS (WordPress themes, Bootstrap, CSS resets…) off this
   component. :not(#_) is always true and weighs as much as an id, so these lines win over
   theme rules made of classes and tags. Customise the component through its --kz-* variables. */

/* What the browser gives, where the component sets it only in some states: at the lowest weight, so its own rules below put it back */

:where(.kodza-inline-image-text__media img:where(:not([class*="kodza-"]))):not(#_),
:where(.kodza-inline-image-text__media video:where(:not([class*="kodza-"]))):not(#_) {
  transition: revert;
}

/* What the browser gives, on everything the component leaves to it */

.kodza-inline-image-text__line:not(#_),
.kodza-inline-image-text__row:not(#_),
.kodza-inline-image-text__media:not(#_) {
  box-sizing: revert;
}

.kodza-inline-image-text__media img:where(:not([class*="kodza-"])):not(#_),
.kodza-inline-image-text__media video:where(:not([class*="kodza-"])):not(#_) {
  border: revert;
  margin: revert;
  padding: revert;
  border-radius: revert;
  outline: revert;
  text-decoration: revert;
  list-style: revert;
  box-sizing: revert;
  float: revert;
  position: revert;
  background-color: revert;
  background-image: revert;
  box-shadow: revert;
  outline-offset: revert;
  appearance: revert;
  max-height: revert;
  color: revert;
  font-family: revert;
  font-size: revert;
  font-weight: revert;
  font-style: revert;
  line-height: revert;
  letter-spacing: revert;
  text-transform: revert;
  text-underline-offset: revert;
  text-align: revert;
  text-indent: revert;
  text-shadow: revert;
  vertical-align: revert;
}

/* The component's own rules, one step stronger: real buttons and fields, what it sets on tags themes style (links, lists, headings, images…), and the root width (a theme may narrow it, never widen it) */

.kodza-inline-image-text__media img:not(#_),
.kodza-inline-image-text__media video:not(#_) {
  display: block;
  max-width: none;
}

.kodza-inline-image-text .kodza-inline-image-text__media.is-open :is(img, video):not(#_) {
  transition: transform calc(var(--kz-inline-image-text-duration) * 1.9 * var(--kz-motion-scale, 1)) var(--kz-inline-image-text-ease);
}

@media (prefers-reduced-motion: reduce) {
  .kodza-inline-image-text .kodza-inline-image-text__media :is(img, video):not(#_) {
    transition: none !important;
  }
}
```

```js
// Kodza License: free to use, client work included. Not to resell or redistribute, ported or not: https://kodza.dev/docs/#print-license
// Kodza — Inline Image Text
// When the sentence reaches the screen, lays it out in the lines the browser actually wraps,
// pictures included, and plays the entrance: each line rises from behind its mask, and each
// picture opens as its line lands, once it is loaded. Then the markup goes back to the way it
// was written: the pictures are moved, never reloaded, and a loop keeps playing.
// Settings: the --kz-inline-image-text-* variables in component.css (size and shape of the
// pictures, durations), and the constants below.
(() => {
  const SELECTOR = '.kodza-inline-image-text';
  const MEDIA = '.kodza-inline-image-text__media';
  // When a picture starts opening, as a share of its line's rise: it opens as its line comes up
  const OPEN_AT = 0.1;
  // Pictures open in reading order, at least this many line steps apart
  // (--kz-inline-image-text-stagger), even when their lines land together
  const MEDIA_STEP = 1;
  // On a replay, the lines leave upwards first: in this share of the rise
  // (--kz-inline-image-text-duration), this share of the stagger apart
  const LEAVE = 0.55;
  const LEAVE_STEP = 0.5;
  // The longest wait for a loop's first frame, in ms: past it, the picture opens on the poster
  const VIDEO_WAIT = 2500;
  // Where it starts: once its top is this far into the screen
  const START = '0px 0px -12% 0px';

  const reduceMotion = window.matchMedia('(prefers-reduced-motion: reduce)').matches;
  // The site's pace, --kz-motion-scale (set on :root, read on the instance): every duration of the
  // script times it, and 0 moves nothing, like reduced motion
  const paceOf = (el) => {
    const pace = parseFloat(getComputedStyle(el).getPropertyValue('--kz-motion-scale'));
    return pace >= 0 ? pace : 1;
  };
  // A duration variable, written in s or ms, in ms
  const time = (el, name, fallback) => {
    const value = getComputedStyle(el).getPropertyValue(name).trim();
    const n = parseFloat(value);
    if (!Number.isFinite(n)) return fallback;
    return value.endsWith('ms') ? n : n * 1000;
  };

  // Lays the sentence out in lines, each in its own mask, and returns the pictures of each line.
  // Words and pictures are the pieces, grouped by the line their middle sits on: a picture at
  // the start or the end of a line stays with it. Each line is cloned from the text as written
  // (links, emphasis), then the live pictures are moved into the clone.
  function split(root) {
    const texts = [];
    const walker = document.createTreeWalker(root, NodeFilter.SHOW_TEXT);
    while (walker.nextNode()) if (!walker.currentNode.parentElement.closest(MEDIA)) texts.push(walker.currentNode);
    texts.forEach((node) => {
      node.textContent.split(/(\s+)/).forEach((part) => {
        if (!part.trim()) return part && node.before(part);
        const word = document.createElement('span');
        word.className = 'kodza-inline-image-text__word';
        word.textContent = part;
        node.before(word);
      });
      node.remove();
    });

    // Screen pixels to CSS pixels, should a parent be scaled by a transform
    const scale = root.getBoundingClientRect().width / root.offsetWidth || 1;
    const style = getComputedStyle(root);
    const reach = (parseFloat(style.lineHeight) || parseFloat(style.fontSize) * 1.2) * scale / 2;
    const lines = [];
    root.querySelectorAll(`.kodza-inline-image-text__word, ${MEDIA}`).forEach((piece) => {
      const box = piece.getBoundingClientRect();
      const middle = box.top + box.height / 2;
      const line = lines[lines.length - 1];
      if (line && Math.abs(middle - line.middle) < reach) line.pieces.push(piece);
      else lines.push({ middle, pieces: [piece] });
    });

    const range = document.createRange();
    const copies = lines.map(({ pieces }) => {
      range.setStartBefore(pieces[0]);
      range.setEndAfter(pieces[pieces.length - 1]);
      const copy = range.cloneContents();
      copy.querySelectorAll('.kodza-inline-image-text__word').forEach((word) => word.replaceWith(word.textContent));
      copy.querySelectorAll('[id]').forEach((el) => el.removeAttribute('id'));
      return { copy, media: pieces.filter((piece) => piece.matches(MEDIA)) };
    });
    // Moved within the same task, a playing <video> does not pause
    root.textContent = '';
    copies.forEach(({ copy, media }, i) => {
      copy.querySelectorAll(MEDIA).forEach((clone, k) => clone.replaceWith(media[k]));
      const line = document.createElement('span');
      const row = document.createElement('span');
      line.className = 'kodza-inline-image-text__line';
      row.className = 'kodza-inline-image-text__row';
      row.style.setProperty('--kz-line', i);
      row.append(copy);
      line.append(row);
      root.append(line, ' ');
    });
    return copies.map(({ media }) => media);
  }

  // One instance. Everything it starts is tied to `signal`, so kodza:destroy stops it all
  function mount(root, signal) {
    const pace = paceOf(root);
    const still = reduceMotion || !pace; // the still path: no motion asked, by the visitor or the site
    const html = root.innerHTML;
    const media = [...root.querySelectorAll(MEDIA)];
    const videos = [...root.querySelectorAll(`${MEDIA} video`)];
    const timers = new Set();
    let run = 0;

    const wait = (ms) => new Promise((resolve) => {
      const timer = setTimeout(() => {
        timers.delete(timer);
        resolve();
      }, ms);
      timers.add(timer);
    });
    // The first of these events, then none of them is listened to any more
    const event = (el, types) => new Promise((resolve) => {
      const done = () => {
        types.forEach((type) => el.removeEventListener(type, done));
        resolve();
      };
      types.forEach((type) => el.addEventListener(type, done, { signal }));
    });
    const stop = () => {
      timers.forEach(clearTimeout);
      timers.clear();
    };
    // Resolves once a picture has something to show: its image loaded (or failed), or the first
    // frame of its loop (the poster, past VIDEO_WAIT)
    const ready = (box) => {
      const video = box.querySelector('video');
      const img = box.querySelector('img');
      if (video) {
        if (video.readyState >= 2) return Promise.resolve();
        return Promise.race([event(video, ['loadeddata', 'error']), wait(VIDEO_WAIT)]);
      }
      if (!img) return Promise.resolve();
      return (img.complete ? Promise.resolve() : event(img, ['load', 'error'])).then(() => img.decode?.().catch(() => {}));
    };

    // The markup as written, with the live pictures back in their places
    const restore = () => {
      const page = document.createElement('template');
      page.innerHTML = html;
      page.content.querySelectorAll(MEDIA).forEach((clone, k) => clone.replaceWith(media[k]));
      root.classList.remove('is-playing', 'is-shown', 'is-leaving');
      media.forEach((box) => box.classList.remove('is-open'));
      root.replaceChildren(page.content);
    };

    // A replay over the sentence at rest: its lines first leave upwards, behind their masks, so
    // the entrance never starts from a sentence wiped in one frame
    const leave = (token) => {
      if (!root.querySelector('.kodza-inline-image-text__line')) split(root);
      root.classList.add('is-shown');
      void root.offsetWidth; // the lines leave from where they rest
      root.classList.add('is-leaving');
      const count = root.querySelectorAll('.kodza-inline-image-text__line').length;
      const duration = time(root, '--kz-inline-image-text-duration', 900);
      const stagger = time(root, '--kz-inline-image-text-stagger', 90);
      // The last line is out of sight by 0.8 of its run: the entrance follows it at once
      wait((duration * LEAVE * 0.8 + stagger * LEAVE_STEP * (count - 1)) * pace).then(() => token === run && enter(token));
    };

    const play = () => {
      if (still) return;
      const token = ++run;
      stop();
      // The first entrance, or a replay over one still playing, starts from below at once
      if (root.classList.contains('is-armed') || root.classList.contains('is-playing')) enter(token);
      else leave(token);
    };

    const enter = (token) => {
      if (root.classList.contains('is-playing') || root.classList.contains('is-shown')) restore();
      // Behind a closed mask, a lazy image would wait for a scroll that never comes
      root.querySelectorAll('img[loading="lazy"]').forEach((img) => { img.loading = 'eager'; });
      const lines = split(root);
      root.classList.remove('is-armed');
      void root.offsetWidth; // the lines start below their mask, even on a replay
      root.classList.add('is-playing');

      const duration = time(root, '--kz-inline-image-text-duration', 900);
      const stagger = time(root, '--kz-inline-image-text-stagger', 90);
      const steps = [wait((duration * 1.1 + stagger * (lines.length - 1)) * pace)];
      let turn = -Infinity;
      lines.forEach((boxes, i) => boxes.forEach((box) => {
        turn = Math.max(stagger * i, turn + stagger * MEDIA_STEP);
        const at = (turn + duration * OPEN_AT) * pace;
        steps.push(Promise.all([wait(at), ready(box)]).then(() => {
          if (token !== run) return;
          box.classList.add('is-open');
          return wait(duration * 1.9 * pace); // the zoom, the longest of the two
        }));
      }));
      Promise.all(steps).then(() => token === run && !signal.aborted && restore());
    };

    // A loop plays while it is on screen, never on the still path
    const seen = new IntersectionObserver((entries) => {
      const on = entries[entries.length - 1].isIntersecting && !still;
      videos.forEach((video) => {
        video.muted = true;
        if (on) video.play().catch(() => {});
        else video.pause();
      });
    });
    if (videos.length) seen.observe(root);
    signal.addEventListener('abort', () => {
      seen.disconnect();
      videos.forEach((video) => video.pause());
    });
    if (still) return;

    root.classList.add('is-armed');
    const start = new IntersectionObserver((entries) => {
      if (!entries[0].isIntersecting) return;
      start.disconnect();
      // Lines are measured with the page's own font
      document.fonts.ready.then(() => !signal.aborted && !run && play());
    }, { rootMargin: START });
    start.observe(root);
    root.addEventListener('kodza:replay', play, { signal });
    // An entrance still playing would put its lines back into the restored markup
    signal.addEventListener('abort', () => {
      start.disconnect();
      run += 1;
      stop();
    });
  }

  // Kodza lifecycle, the same in every component: `kodza:init` starts the instances inside
  // event.detail.root (the whole page by default), `kodza:destroy` stops them and puts their
  // markup back. For themes and apps that swap content without a page load. Each running root
  // keeps its markup as written under KODZA, shared by every Kodza script on the page: a Kodza
  // component inside another one is saved as written, not half-started, and stopped with it. Two
  // components on one root (a reveal on a stat card) both start, and stop together.
  const KODZA = Symbol.for('kodza');
  const RUNNING = Symbol.for(`kodza ${SELECTOR}`); // a root this component runs on, for every copy of this script
  const instances = new WeakMap();
  const find = (scope = document) => [scope, ...scope.querySelectorAll(SELECTOR)].filter((el) => el.matches?.(SELECTOR));
  const attrsOf = (el) => [...el.attributes].map((a) => [a.name, a.value]);
  const put = (el, saved) => {
    [...el.attributes].forEach((a) => el.removeAttribute(a.name));
    saved.attrs.forEach(([name, value]) => el.setAttribute(name, value));
    el.innerHTML = saved.html;
  };
  // The markup inside a root as written: Kodza components already running in it give back their own
  const written = (root) => {
    const all = [...root.querySelectorAll('*')];
    if (!all.some((el) => el[KODZA])) return root.innerHTML;
    const copy = root.cloneNode(true);
    const twins = copy.querySelectorAll('*');
    let last = null;
    all.forEach((el, i) => {
      if (!el[KODZA] || last?.contains(el)) return;
      last = el;
      put(twins[i], el[KODZA]);
    });
    return copy.innerHTML;
  };
  const init = (scope) => find(scope).forEach((root) => {
    // Already running, maybe from another copy of this script. Marked is-ready with no Kodza component
    // running on it, a root is a copy of a started one (a cloned slide): it is left as it is
    if (root[RUNNING] || (root.classList.contains('is-ready') && !root[KODZA])) return;
    // Rendered by React (data-kodza-manual): React starts it, with an init aimed at that markup once
    // it has hydrated it. Any earlier start would change markup React has not taken over yet
    const owner = root.closest('[data-kodza-manual]');
    if (owner && !(scope && owner.contains(scope))) return;
    const controller = new AbortController();
    // Another Kodza component already running on this root: its markup as written is kept, and the
    // two stop together
    const before = root[KODZA];
    const saved = { html: before ? before.html : written(root), attrs: before ? before.attrs : attrsOf(root), stop: () => destroy(root) };
    if (before) before.above = saved;
    instances.set(root, { controller, saved, before });
    root[KODZA] = saved;
    root[RUNNING] = true;
    mount(root, controller.signal);
    root.classList.add('is-ready');
  });
  const destroy = (scope) => find(scope).forEach((root) => {
    const instance = instances.get(root);
    if (!instance) return;
    instances.delete(root);
    instance.saved.above?.stop(); // a Kodza component started after it on the same root stops first
    // The Kodza components running inside it stop first: once its markup is put back, their own
    // script could not find them any more
    root.querySelectorAll('*').forEach((el) => el[KODZA]?.stop());
    instance.controller.abort();
    delete root[RUNNING];
    // Started on top of another one: that one stops next, and puts the markup back
    if (instance.before) {
      delete instance.before.above;
      root[KODZA] = instance.before;
      return instance.before.stop();
    }
    delete root[KODZA];
    put(root, instance.saved);
  });
  document.addEventListener('kodza:init', (event) => init(event.detail?.root));
  document.addEventListener('kodza:destroy', (event) => destroy(event.detail?.root));
  init();
  // Loaded in <head>, the script runs before the markup exists: once more when it is parsed
  if (document.readyState === 'loading') document.addEventListener('DOMContentLoaded', () => init(), { once: true });
})();
```

Free to use, from Kodza (https://kodza.dev).
