Skip to content

v3.0.0

Choose a tag to compare

@nutteloost nutteloost released this 04 Jun 13:45

Simple Swipe Card v3.0.0

New Features ✨

  • Native CSS Scroll-Snap Strategy: A new scroll_strategy option lets you choose how swiping is handled. The default (js) keeps the current JavaScript gestures; set scroll_strategy: css to hand scrolling to the browser's built-in scroll-snap. Swiping should work smoother on low-powered devices such as wall-panels. Note: swipe effects, loop modes, free swipe, and auto-height are not available in this mode. (closes #102)

  • Centered Carousel Alignment: Carousel mode now has an alignment option. Choose Centered (peek) to keep the active card centered with the previous and next cards peeking in on both sides, instead of the default left-aligned layout. Set carousel_alignment: center and pair it with a loop mode to show peeking neighbors at the first and last slides too. (closes #103)

  • UIX Support: Simple Swipe Card now applies UIX styling directly, so it works on both the swipe card itself and on individual child cards. (closes #109)

  • Per-Slide Pagination Dot Colors: You can now color each pagination dot individually — for example, to match the color of the card on that slide. Set --simple-swipe-card-pagination-dot-slideN-color (and optionally --simple-swipe-card-pagination-dot-slideN-active-color) for the slides you want to customize. (closes #110)

Improvements 🛠️

  • Highly Optimized Loading: The card has been heavily reworked under the hood and should be noticable faster— it appears almost instantly instead of fading in after a short delay. (closes #111)

  • Smoother First Load: Cards size themselves to their layout right away, so there's less flicker or shifting while the dashboard loads.

  • Home Assistant 2026.5 / 2026.6 Compatibility: Updated for Home Assistant's ongoing migration of UI controls to Web Awesome.

Bug Fixes 🩹

  • Mini Media Player Shortcuts Dropdown: The shortcuts dropdown of mini-media-player is once again fully visible instead of being clipped to the card's edges. (closes #106)

  • Nested Swipe Directions: A vertical swipe card containing horizontal swipe cards (or vice-versa) now swipes correctly on both axes. (closes #101)

  • Toggles Unresponsive to Touch: Switches, checkboxes, and other toggle controls inside child cards once again respond to taps on touch devices when the swipe card contains more than one card. (closes #112)

  • Editor Dropdowns Unselectable: Every dropdown in the card editor (loop behavior, swipe direction, swipe behavior, swipe effect, and the state-synchronization entity) showed its options but couldn't be selected on recent Home Assistant. Home Assistant rebuilt ha-select on Web Awesome; the editor now uses the new control with a fallback for older versions, and the state-synchronization field uses a proper entity picker. (closes #107)

  • Swipe Effects Not Rendering: The stacked transition effects (fade, flip, coverflow, creative, cards, reveal, zoom, and swing) showed an empty or half-height card on recent Home Assistant. The effects are working again.

  • Empty Text Fields in the Editor: The Card Spacing, Auto-swipe interval, Reset timeout, Start card, and Carousel minimum card width fields rendered blank with no way to enter a value on recent Home Assistant. Home Assistant 2026.5 removed ha-textfield (replaced by ha-input); the editor now uses the new control with fallbacks to ha-textfield and a native input so the fields work on older, current, and future versions.