astro-vtbot
Advanced tools
No, its NOT a roBOT 🤖, its a 👜 Bag of Tricks!✨
The bag of tricks provides extensions & support around Astro's view transitions.
A current deployment of tech demos and the documentation can be found at https://events-3bg.pages.dev/
The selection of optional Starlight components keeps growing:
Ever wished clicking on Starlight's previous page and next page links would slide content from the left respectively from the right? Now you can enable
<PageOrder />on Starlight sites. This automatically alters the direction of the view transition. Visit a page further down the sidebar and get a forward navigation, visit a page further up, and you get a back navigation.
Eliminate the Pseudo-Scrolling of the Main Section: With
<PageOffset />, The Bag offers a simple to use component that eliminates pseudo scrolling effects induced by morph transitions on elements that are larger than the viewport. Especially useful to get a smooth and neat transition animation for your main content.
Improved Sidebar Handling: When you navigate to a page that has its entry within a collapsed category, the category is now automatically turned open. If the current page marker is outside the visible part of the sidebar, it is automatically scrolled into view. New: Support for your own customizations!
If you want to use
transition:persistinside the main content area, you can do that now! As of v1.7.8 the<ReplacementSwap />component handlesdata-astro-transition-persistattributes within the replaced DOM trees in the same way as Astro's built-inswap()function does.
The Jotter now leverages Starlight! The beginning of a more structured and searchable version of the pile of notes that it was.
Starlight Support: Ever wanted to see what your Starlight site looks like with view transitions enabled? Follow these steps to get rid of full page loads and make your Starlight site look like a SPA!
The astro-vtbotpackage isn't a monolithic library. Use the components you need and only pay bandwidth for those.
| Component | Brotli bytes added |
|---|---|
| Animation Style ✨ | ~0.1k |
| BrakePad 🦥 | ~0.2k |
| Linter 🧹 | ~1.9k |
| LoadingIndicator ⏳ | ~0.4k |
| Move 🚟 | ~0.2k |
| NoScroll 📜 | ~0.1k |
| PageOffset 📄⇞ | ~0.1k |
| Portal 🚪 | ~0.2k |
| ReplacementSwap ↹ | ~0.5k |
| Starlight … 🌟 | ~3.0k |
| Swing 🎷 | ~0.1k |
| VtBotDebug 🐛 | ~2.8k |
| Zoom 🔎 | ~0.1k |
Visit the documentation of the reusable components for detailed information.
<Linter/>: A linter component that helps you identify problems when setting up transitions.
<VtBotDebug/>: A Debugging component that logs the events and their data as they occur.
<ReplacementSwap/>: An alterantive DOM swap(), which preserves elements in the original DOM to avoid reinitialization of iframes or CSS animations.
<LoadIndicator>: Have you ever missed the visual feedback on sites with view transitions as to whether the app has noticed the click? You need a loading indicator! Here you go!
Zoom, <Move> and Swing animations and the <AnimationsStyle/> component allows for extended styling options.
<Portal/> component that forces all view transitions through a portal/loading page.
<NoScroll/> keep the current vertical and horizontal scroll position when transitioning to the next page.
The bag of tricks currently contains several technical demos that show examples of the implementation of various effects using the view transition events.
The sources are in this repository.
Last but not least, the deployment also includes the ▶ Jotter ◀ with a wealth of information on transition events as well as background information and valuable tips & tricks on view transitions in Astro.
Some of the contents are technical demos, some are useful tools, and some are reusable components that you can use in your own project to handle edge cases that go beyond Astro's standard features.
For help, check out the Discussions tab on the GitHub repo.
This package is maintained by martrapp independently from Astro. You're welcome to contribute by submitting an issue or opening a PR!
See CHANGELOG.md for a history of changes to this package.
1.7.15 - 2024-05-05
FAQs
The 👜 Bag of Tricks ✨ for Astro's View Transitions
The npm package astro-vtbot receives a total of 5,807 weekly downloads. As such, astro-vtbot popularity was classified as popular.
We found that astro-vtbot demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
Security News
Socket’s threat research team has detected six malicious npm packages typosquatting popular libraries to insert SSH backdoors.
Security News
MITRE's 2024 CWE Top 25 highlights critical software vulnerabilities like XSS, SQL Injection, and CSRF, reflecting shifts due to a refined ranking methodology.
Security News
In this segment of the Risky Business podcast, Feross Aboukhadijeh and Patrick Gray discuss the challenges of tracking malware discovered in open source softare.
