Back to migration overview

Component Alias Migration ​

BootstrapVue component aliases are not auto-registered in BootstrapVueNext and must be migrated to canonical names or resolver aliases.

Edit this page on GitHub

Component Alias Migration ​

Summary ​

BootstrapVue component aliases are not auto-registered in BootstrapVueNext and must be migrated to canonical names or resolver aliases.

Affected APIs ​

  • BootstrapVueNextResolver

Breaking Change ​

BootstrapVue had a number of component aliases — for instance, <b-btn> was an alias for <b-button>. BootstrapVueNext does not support these aliases by default, so you must either migrate to the canonical component names or opt into aliases yourself.

To define aliases, you can use the BootstrapVueNextResolver's aliases option. Whether you preserve aliases or rewrite call sites is up to the consuming application.

The table below lists each BootstrapVue alias and its BootstrapVueNext replacement:

BootstrapVueBootstrapVueNext
b-btnBButton
b-btn-groupBButtonGroup
b-btn-toolbarBButtonToolbar
b-ddBDropdown
b-dd-itemBDropdownItem
b-dropdown-item-btn, b-dd-item-button, b-dd-item-btnBDropdownItemButton
b-dd-dividerBDropdownDivider
b-dd-textBDropdownText
b-dd-formBDropdownForm
b-dd-groupBDropdownGroup
b-dd-headerBDropdownHeader
b-datalistBFormDatalist
b-checkbox, b-checkBFormCheckbox
b-datepickerBFormDatepicker
b-fileBFormFile
b-inputBFormInput
b-radio-groupBFormRadioGroup
b-ratingBFormRating
b-selectBFormSelect
b-select-optionBFormSelectOption
b-option-groupBFormOptionGroup
b-tagsBFormTags
b-tagBFormTag
b-textareaBFormTextarea
b-timepickerBFormTimepicker
b-nav-item-dd, b-nav-dropdown, b-nav-ddBNavItemDropdown
b-nav-toggleBNavbarToggle

Note: While BootstrapVueNext recommends using Vue 3 naming convention BButton it is still possible to use b-button.

Migration Notes ​

  • Extracted from the canonical BootstrapVue → BootstrapVueNext migration guide.

Safe Automatic Rewrite ​

Yes. This entry is mostly mechanical and can usually be rewritten automatically when the surrounding code matches the documented patterns.

  • None