Skip to main content

Module placeholder

Module placeholder 

Source
Expand description

What a region shows when it is not showing its content.

The fifth phase-B emitter, where makeover_layout::Readiness becomes markup. Left to the apps, each grows its own class family and the families drift: empty-state--error against error-state for the same fact.

§Why one function for three states

Pending, Empty and Failed are the same anatomy — a region-sized box with a line of text in it — differing in what the text means and what colour it takes. Three emitters would be three copies of a <div> and a <p>, and the interesting thing about them is precisely the state, which the description carries. Ready renders nothing here by construction: it is the state that shows content, so there is no stand-in to draw.

§The action, and why it arrives as markup

Two of goingson’s 27 empty states offer a way out — “No projects yet” with an “Add your first project” button under it. A button is an address, and no crate in this family names one. So it arrives through Markup, the existing named hole in the escaping, the same way a field’s trailing block does. The caller states that what it is passing is trusted; nothing here can check that for them.

Constants§

PLACEHOLDER_CLASSES
Every class this module can put in markup.

Functions§

placeholder_html
A region’s stand-in, or nothing at all when the region has its content.
placeholder_html_into
A region’s stand-in, written into a buffer the caller already has.
placeholder_html_placed
A placeholder, saying where the way out landed.