← All resources
The toolkit · Resource guide

Observe a container resizing

Respond to size changes in a specific layout container.

Visit website (opens in a new tab)
Understand the tool

Overview

Respond to size changes in a specific layout container.

The example below is an original, minimal illustration of the referenced web-platform feature. Read the official reference and adapt it before using it in a real project.

Best for

  • Understanding observe a container resizing.
  • Trying the pattern in an isolated page.
  • Adapting the example to an existing website.

Key features

  • Container observation
  • Resize callback
  • Cleanup function
A practical walkthrough

Getting started

  1. Read the example and reference. Identify the selectors, files or values that belong to your project.

  2. Try it in isolation. Use a disposable test page and adapt the example values.

  3. Verify before reuse. Check keyboard behavior, responsive layout and relevant browser support.

Things to know

  • These examples are learning material, not a drop-in application.
  • Replace example filenames, selectors and routes as needed.
  • Test changes on staging and escape data for the context where it is used.

Code example

Original illustrative example. Adapt filenames and selectors, and test on staging before reuse.

const panel = document.querySelector('.preview-panel');
const observer = new ResizeObserver(entries => {
  for (const entry of entries) console.log(entry.contentRect.width);
});
if (panel) observer.observe(panel);
// Call observer.disconnect() when this component is removed.

Useful alongside this

Accessibility

Text

Visual

Orientation

Accessibility settings