Back to migration overview

BLink Migration ​

Migration notes for BLink from BootstrapVue to BootstrapVueNext.

View Source Edit this page on GitHub
Migration Notes

BLink Migration ​

Summary ​

Migration notes for BLink from BootstrapVue to BootstrapVueNext.

Affected APIs ​

  • BLink

Breaking Change ​

Bootstrap Vue used Vue Router 3, BootstrapVueNext uses Vue Router 4 please read the Vue Router migration guide if using the router features of BLink.

BLink no longer suppresses the scroll to top default behavior when href='#'.

Handling href="#" Links in Documentation

In our documentation site, we addressed the scroll-to-top behavior by cleaning up unnecessary href="#" attributes:

  1. Remove unnecessary hrefs: We removed href="#" from demo components where it wasn't providing any functional value (just styling).

  2. Use contextual anchors: Where navigation is actually needed, we replaced href="#" with meaningful anchor links that point to their demo containers (e.g., href="#navbar-overview"). This provides better user experience by allowing users to navigate directly to specific examples.

This approach maintains component functionality while eliminating the unwanted scroll-to-top behavior.

append ​

Vue router deprecated the append prop in <router-link>, BootstrapVueNext has followed suit and deprecated the append prop on BLink. See the Vue Router migration guide for details.

event ​

Vue router deprecated the event prop in <router-link>, BootstrapVueNext has followed suit and deprecated the event prop on BLink. See the Vue Router migration guide for details.

exact ​

Vue router deprecated the exact prop in <router-link>, BootstrapVueNext has followed suit and deprecated the exact, exact-path and exact-path-active-class props on BLink. See the Vue Router migration guide for details.

$root events ​

BootstrapVueNext no longer emits the bv::link::clicked event on $root.

Migration Notes ​

  • Extracted from the canonical BootstrapVue → BootstrapVueNext migration guide.

Safe Automatic Rewrite ​

Yes. This entry is mostly mechanical, but review the result when surrounding behavior or adjacent props may affect the final markup.

  • None