Scroll Indicator

Description

Scroll Indicator adds a focused block for landing pages, hero sections, editorial layouts, and long-form content. It gives visitors a clear visual cue that there is more to explore below the fold.

Choose from multiple icon styles, adjust the size, use native WordPress text color controls, add optional helper text, and let visitors click or keyboard-activate the indicator to move smoothly down the page.

The block is intentionally lightweight. Animations are handled with CSS, respect reduced-motion preferences, and the front-end script is limited to click-to-scroll and automatic hide-on-scroll behavior.

Key Features

• Five icon styles: mouse, arrow, chevron, dots, and hand.
• Preset sizes plus a custom CSS size value.
• Native block editor controls for text color, spacing, typography, and alignment.
• Fixed screen positioning and draggable absolute positioning for hero-style sections.
• CSS-only animation that respects the visitor’s reduced-motion preference.
• Optional text label beneath the icon.
• Automatic hide-on-scroll behavior.
• Keyboard-accessible click-to-scroll interaction.
• No animation libraries or heavy runtime dependencies.

Development

The human-readable source for the compiled JavaScript and CSS is included in this plugin package under src/.

The generated files in compiled/ are built from src/index.js, src/view.js, and the SCSS files in src/ using @wordpress/scripts. To rebuild them, run:

1. npm install
2. npm run build

The public source repository is maintained at https://github.com/dhanson-wp/scroll-indicator.

Good For

• Landing page hero sections.
• Editorial introductions.
• Long-form stories and portfolios.
• Product pages where visitors should continue below the fold.
• Any layout that needs a subtle, branded scroll cue.