Beskrivelse
CSS media queries let us style elements based on the size of the screen. What if we wanted to style them based on the size of their container? 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 container queries to style those elements based on their on-screen width… until now!
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.
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.
Usage
If you have a block or widget in your site that you wish to use as a responsive container, add the data-responsive-container
attribute to that block’s container element. For example, the parent <div>
for a calendar block might look like this:
<div class="calendar-block" data-responsive-container>
By adding that data-attribute and nothing more, your container will now be tagged with additional classes based on how big they appear:
– No special class if the container is below 420px (style for this narrow context as your default).
– container-sm
if the container is 420px wide or more,
– container-md
if it is wider than 600px,
– container-lg
if it is wider than 720px, and
– container-xl
for any element 960px or wider.
These are default values and therefore somewhat arbitrary, so you may also provide your own custom theme- or plugin-specific breakpoint values using the data-responsive-container
attribute. When rendering your element or block in PHP, pass an array of class names and the minimum width at which each class should be applied. These class names can be generic like the default .container-*
classes, or they may be specific to the element being styled:
echo sprintf(
'<div class="myblock" data-responsive-container="%s">',
esc_attr( wp_json_encode( [
'myblock--2-column' => 600,
'myblock--3-column' => 900,
] )
);
In this example your container would receive the .myblock--2-column
class from 600px up, and .myblock--3-column
at or above 900px.
Note that in this case the .myblock
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 0
:
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,
] )
);
From within WordPress
- Visit ‘Plugins > Add New’
- Search for ‘Responsive Containers’
- Activate the Responsive Containers plugin from your Plugins page.
- Start using
data-responsive-container
attributes within your theme or plugin.
Manually
- Upload the
responsive-containers
folder to the/wp-content/plugins/
directory - Activate the Responsive Containers plugin from your Plugins page.
- Start using
data-responsive-container
attributes within your theme or plugin.
License & Attribution
This plugin is licensed under the terms of the GNU General Public License (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.
It was created by K. Adam White at Human Made, based on a concept popularized by Philip Walton.
This plugin utilizes the resize-observer-polyfill
library by Denis Rul, released under the MIT license and © 2016 Denis Rul.
FAQ
- How does this work?
-
The Responsive Containers plugin implements an approach popularized by Philip Walton’s excellent article Responsive Components: a Solution to the Container Queries Problem. What this plugin does is apply his solution to WordPress sites so that, assuming this plugin is installed, any other plugin or theme can opt-in to responsive container styling.
Under the hood this is all driven by
ResizeObserver
, a new browser feature that efficiently detects element size changes. We use this method to track the size of specific containers on the page and apply a set of classes to those elements based on how big they appear on the screen. - I activated this plugin and nothing changed
-
Installing and activating this plugin will not change anything about your site on its own. You have to update your theme or plugin to add the
data-responsive-containers
HTML attribute to any elements you wish to use as responsive containers.
Vurderinger
Det er ingen omtaler av denne utvidelsen.
Bidragsytere og utviklere
“Responsive Containers” er programvare med åpen kildekode. Følgende personer har bidratt til denne utvidelsen.
BidragsytereOversett “Responsive Containers” til ditt språk.
Interessert i utvikling?
Bla gjennom koden, sjekk ut SVN-repositoriet, eller abonner på utviklingsloggen med RSS.
Endringslogg
1.1
- Alter class application logic to always apply classes once their minimum threshold width has been met or exceeded.
- Adjust default breakpoint cutoffs.
- Adjust README formatting to fix code block rendering issues.
- Begin work to support usage within the block editor.
- Un-document the
responsive_container_breakpoints()
method until it is confirmed to be a useful helper.
1.0
- Loads
responsive-containers.js
to observe and decoratedata-responsive-container
elements. - Introduces
responsive_container_breakpoints()
method to render a stringified & attribute-escaped custom breakpoints array.