Responsive Containers provides a framework for applying styles to blocks & widgets based on how large they appear on screen.

K. Adam White

<p><a href="https://developer.mozilla.org/en-US/docs/Web/CSS/Media_Queries/Using_media_queries" rel="nofollow ugc">CSS media queries</a> let us style elements based on the size of the screen. What if we wanted to style them based on the size of their <strong>container</strong>? A widget or block should often look different if it’s full-width or constrained within a column or sidebar, but we didn’t have any way to write <strong>container queries</strong> to style those elements based on their on-screen width… until now!</p>
<p>This plugin loads a small JavaScript file that conditionally applies classes to elements based on how wide those elements are in the browser. This can be used by other themes and plugins to write container-specific styles for editor blocks or widgets, so that they will display correctly wherever they are placed in the page.</p>
<p>The script works on the frontend and in the block editor — see your responsive styles live while you’re composing your post, and trust that your widgets and blocks will look their best whether they’re full-width or in the narrowest sidebar.</p>
<h3>Usage</h3>
<p>If you have a block or widget in your site that you wish to use as a responsive container, add the <code>data-responsive-container</code> attribute to that block’s container element. For example, the parent <code><div></code> for a calendar block might look like this:</p>
<pre><code><div class="calendar-block" data-responsive-container>
</code></pre>
<p>By adding that data-attribute and nothing more, your container will now be tagged with additional classes based on how big they appear:<br />
– No special class if the container is below 420px (style for this narrow context as your default).<br />
– <code>container-sm</code> if the container is 420px wide or more,<br />
– <code>container-md</code> if it is wider than 600px,<br />
– <code>container-lg</code> if it is wider than 720px, and<br />
– <code>container-xl</code> for any element 960px or wider.</p>
<p>These are default values and therefore somewhat arbitrary, so you may also provide your own custom theme- or plugin-specific breakpoint values using the <code>data-responsive-container</code> attribute. When rendering your element or block in PHP, pass an array of <strong>class names</strong> and the <strong>minimum width</strong> at which each class should be applied. These class names can be generic like the default <code>.container-*</code> classes, or they may be specific to the element being styled:</p>
<pre><code>echo sprintf(
  '<div class="myblock" data-responsive-container="%s">',
  esc_attr( wp_json_encode( [
    'myblock--2-column' => 600,
    'myblock--3-column' => 900,
  ] )
);
</code></pre>
<p>In this example your container would receive the <code>.myblock--2-column</code> class from 600px up, and <code>.myblock--3-column</code> at or above 900px.</p>
<p>Note that in this case the <code>.myblock</code> element receives no custom class below 600px. We don’t apply any class names below your specified minimum because we assume styles are written narrow-context-first, but you may ensure your smallest class is always applied by providing a minimum width of <code>0</code>:</p>
<pre><code>echo sprintf(
  '<div class="myblock" data-responsive-container="%s">',
  esc_attr( wp_json_encode( [
    'myblock--1-column' => 0, // Will apply in all circumstances.
    'myblock--2-column' => 600,
    'myblock--3-column' => 900,
  ] )
);
</code></pre>
<h3>From within WordPress</h3>
<ol>
<li>Visit ‘Plugins > Add New’</li>
<li>Search for ‘Responsive Containers’</li>
<li>Activate the Responsive Containers plugin from your Plugins page.</li>
<li>Start using <code>data-responsive-container</code> attributes within your theme or plugin.</li>
</ol>
<h3>Manually</h3>
<ol>
<li>Upload the <code>responsive-containers</code> folder to the <code>/wp-content/plugins/</code> directory</li>
<li>Activate the Responsive Containers plugin from your Plugins page.</li>
<li>Start using <code>data-responsive-container</code> attributes within your theme or plugin.</li>
</ol>
<h3>License & Attribution</h3>
<p>This plugin is licensed under the terms of the <a href="./license.txt" rel="nofollow ugc">GNU General Public License</a> (or “GPL”). It is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.</p>
<p>It was created by K. Adam White at <a href="https://humanmade.com" rel="nofollow ugc">Human Made</a>, based on a concept popularized by <a href="https://philipwalton.com/" rel="nofollow ugc">Philip Walton</a>.</p>
<p>This plugin utilizes the <a href="https://www.npmjs.com/package/resize-observer-polyfill" rel="nofollow ugc"><code>resize-observer-polyfill</code> library</a> by Denis Rul, released under the MIT license and © 2016 Denis Rul.</p>


Alternatives to Responsive Containers

Top alternatives