Practice recipe based on public documentation; the Breakdance extension is not installed here.
What it does and when to use it
Provides an HTML image element for an image source. Use it for the specific job described below. If a simpler native element can deliver the same outcome, prefer the simpler structure and fewer competing styles.
Before you start
This is a Breakdance catalogue recipe for use with a compatible Breakdance Elements for Oxygen extension. It is not a guarantee of availability in your version. Check the installed element list and official reference before following the steps. Exact control labels can differ; this recipe has not been executed on this site.
Worked example: A semantic image with an intentional display size
Scenario: A semantic image with an intentional display size. The goal is a useful result on a real project, not a claim that this scenario was a completed client project.
- Choose the image source and provide relevant alternative text.
- Preserve width/height information where the implementation supports it and constrain responsive width.
- Check the final img markup and avoid unnecessary wrappers if that is the reason for choosing this element.
Expected result
You should have a semantic image with an intentional display size. Verify the result on the frontend using the same content or object described in the steps. A correct builder preview alone does not establish that links, data or interactions work for visitors.
Troubleshooting
If the image causes layout shift or overflow, review dimensions and its containing layout. Prefer the native Image element unless a specific markup requirement justifies this choice.
Checks before publishing
Use real text and assets rather than a perfect placeholder. Check a long label, narrow screen and empty-data state before publishing.
- Compare desktop and narrow-screen layouts using actual content.
- Follow every destination and operate interactive controls with a keyboard where applicable.
- Check an empty or unavailable-data state when the element depends on a provider.
Official reference and version notes
Official HTML IMG reference provides the current provider information. This is independent, AI-assisted documentation on Benjamin Olsen’s website; examples are clearly identified as practice recipes.
Check extension element visibility in Oxygen. An element may be hidden where a native equivalent exists.