Groundworx Carousel

描述

Groundworx Carousel is a flexible Gutenberg block that allows you to display slides with any inner blocks. It’s built on top of the lightweight Splide.js library and supports responsive options, breakpoint-based layouts, and advanced design controls.

Features:

  • Native Gutenberg block support
  • Slide, loop, or fade transition types
  • Responsive controls for each breakpoint
  • Arrow and pagination customization
  • Progress bar and slide counter support
  • Grid fallback layout when carousel is disabled
  • Modern, accessible, and lightweight

Perfect for building galleries, content sliders, testimonials, product showcases, and more.

Developer Notes

Supported Breakpoints for Carousel Fallback

Groundworx Carousel allows you to disable the carousel and fall back to a grid layout at a specific breakpoint by passing destroy: true inside splideOptions.breakpoints.

The supported breakpoint keys are:

  • tablet
  • laptop
  • desktop

These follow a mobile-first, breakpoint-and-up model. For example, using tablet will apply the fallback from tablet size and up.

You can also use these breakpoints to provide default values for splideOptions settings — such as perPage, gap, or arrows — at different screen sizes.
Important: Once the carousel is destroyed via destroy: true, it cannot be reactivated at larger breakpoints. All subsequent settings will be ignored.

You can register custom variations using wp.blocks.registerBlockVariation() and define breakpoint-specific splideOptions.

For full code examples, refer to the GitHub repository:
https://github.com/groundworx-dev/groundworx-carousel#example-variations

Source Code

The unminified source code is publicly available at:
https://github.com/groundworx-dev/groundworx-carousel

About

Groundworx Carousel is part of the Groundworx Block Suite — a modular collection of high-performance, design-focused blocks built for modern WordPress development.

Created and maintained by Johanne Courtright, a WordPress developer and UI/UX specialist with a passion for accessible, customizable interfaces.

Visit https://groundworx.dev for more blocks, documentation, and upcoming releases.

螢幕截圖

  • Sleek and responsive front-end carousel layout
  • Responsive settings per breakpoint in block editor
  • Customize design with native WordPress controls
  • Grid layout with mobile-first carousel fallback

Blocks

This plugin provides 2 blocks.

  • Carousel Display content in a carousel, with blocks added to each slide.
  • Slide A single slide within a carousel block.

安裝

  1. Upload the plugin to the /wp-content/plugins/ directory or install it via the WordPress admin panel.
  2. Activate the plugin through the ‘Plugins’ menu in WordPress.
  3. Add the Carousel block in the Block Editor.
  4. Add any block(s) you want inside each slide.
  5. Customize carousel behavior via the block settings panel.

常見問題

Can I use custom blocks inside each slide?

Yes, the Carousel block supports all inner blocks inside each Slide block.

Does it support touch and swipe?

Yes. Splide.js provides full touch/swipe navigation on mobile and tablet.

評價

There are no reviews for this plugin.

貢獻者及開發者

“Groundworx Carousel” 是一個開源的軟體。以下的人對這個外掛作出了貢獻。

貢獻者

將 Groundworx Carousel 外掛本地化為台灣繁體中文版。

對開發相關資訊感興趣?

任何人均可瀏覽程式碼、查看 SVN 存放庫,或透過 RSS 訂閱開發記錄

修改日誌

1.0.2

  • Fixed: Breakpoint configuration loading from plugin path.

1.0.1

  • Fixed file exclusions for packaging.
  • Updated metadata for WordPress.org compliance.

1.0.0

  • Initial release.