AniLibrary

外掛說明

AniLibrary gives you one wrapper block that can hold almost any other block. Add the wrapper, drop your content inside, choose an animation, and you’re done.

Features:

  • Works with core blocks, groups, columns, and most custom blocks.
  • Choose when animations start: page load, scroll into view, hover, click, or loop.
  • Animate in, out, or both — with reverse or continue exit directions derived from the same preset.
  • Use the Scrub media preset to move through a video or GIF as someone scrolls.
  • GIFs can move in steps; videos give the smoothest result.
  • Start top-of-page scrub media at the beginning when the page first loads.
  • Repeat scrubbed media playback across a scroll range for multiple visible cycles.
  • Nest wrappers with match-parent timing and join-parent animation controls.
  • Suggests animation styles based on the content inside.
  • Respects users who prefer reduced motion.
  • Lightweight front-end output.
  • No tracking and no outside asset requests.

螢幕擷圖

適用於區塊編輯器

這個外掛提供 1 個可供區塊編輯器使用的區塊。

  • AniLibrary Wrap any block and add easy animations.

安裝方式

  1. Upload the plugin files to /wp-content/plugins/anilibrary, or install through the WordPress plugins screen.
  2. Activate the plugin through the “Plugins” screen in WordPress.
  3. Open the block editor and add “AniLibrary”.
  4. Place one or more blocks inside the wrapper and configure animation settings in the sidebar.

常見問題集

Will this work with my blocks?

Usually yes. The wrapper can contain core blocks and most custom blocks.

Can I nest AniLibrary blocks?

Yes. Nesting gives you more control over different parts of your content.

Does it load scripts on every page?

No. Front-end assets only load on pages where AniLibrary is used.

What if a visitor prefers reduced motion?

AniLibrary automatically reduces motion for those users.

How do I remove an animation without losing the content?

Select the AniLibrary wrapper and use “Remove animation & keep content” in Animation Settings, or Ungroup.

使用者評論

這個外掛目前沒有任何使用者評論。

參與者及開發者

以下人員參與了開源軟體〈AniLibrary〉的開發相關工作。

參與者

將〈AniLibrary〉外掛本地化為台灣繁體中文版

對開發相關資訊感興趣?

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

變更記錄

1.3.3

  • Per-character kerning now uses each letter’s real size and weight. Pairs such as “Yo” stay as tight during the animation as they are after it settles.

1.3.2

  • Per-character animations keep each word’s kerning. Letters no longer jump when the animation settles.

1.3.1

  • Entrance effects such as Rise, Blur, Fade, and Slide stay invisible until each item starts, including staggered text and delays.
  • Reduced motion shows content immediately, including before JavaScript loads and when Hide until hover is on.
  • An invalid viewport margin no longer hides that block or stops other animations on the page.
  • The front-end script loads once, so a second copy cannot leave the page on an older runtime.
  • Canceled text entrances no longer pop back to visible, and Bounce waits until every bounce finishes.

1.3.0

  • Confirmed compatibility with WordPress 7.1.
  • Safari fix: settle completed entrances so blur does not stick mid-flight; exits still work after settle.
  • Join parent animation children no longer run their own triggers.
  • Scroll triggers use multi-threshold observers and optional viewport margin (rootMargin).
  • No-flash pending class until the runtime primes hidden entrances.
  • Layout/item stagger for non-text wrappers; selective stagger via abw-stagger-item on child blocks.

1.2.0

  • Added Animate In / Out / In & Out, with Reverse or Continue exit directions derived from entrance presets.
  • Improved exit timing so delayed entrances skip exit, and mid-entrance exits wait for completion.
  • Fixed nested wrappers so outer effects animate nested shells, and independent Scrub stays visible under hide-until-hover.
  • Clarified Match parent timing vs Join parent animation nesting controls.
  • Animation Settings opens by default; added Remove animation & keep content (Ungroup).
  • Added automated nesting and animation scenario tests.

1.1.0

  • Added the Scrub media preset for videos and animated GIFs.
  • Added controls for forward/backward scroll playback, one-way scroll, and once-only locking.
  • Added screen, page, and parent block scroll sources for fixed and nested media layouts.
  • Added beginning-at-page-top behavior for hero, fixed, and sticky media.
  • Added a playback cycles control for repeating scrubbed media as users scroll.
  • Added animated GIF support with graceful fallback when a browser cannot step through the GIF.

1.0.0

  • Initial release.
  • Added wrapper block with load/scroll/hover/click/loop triggers.
  • Added smart preset suggestions based on your content.
  • Added reduced-motion-safe runtime defaults.