Practice recipe based on public documentation; the Breakdance extension is not installed here.
What it does and when to use it
Shows how far the visitor has scrolled through a page. 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 secondary reading-progress indicator
Scenario: A secondary reading-progress indicator. The goal is a useful result on a real project, not a claim that this scenario was a completed client project.
- Use it on a long article where scroll position has meaning.
- Keep the indicator visually small and separate from navigation.
- Compare its start and end states on the actual article, including the footer.
Expected result
You should have a secondary reading-progress indicator. 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 bar finishes too early, check its measured content scope and late-loading media. The indicator is approximate orientation, not a measure of comprehension.
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 Scroll Progress 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.