coreui/bootstrap-vue

Bootstrap 5 components for Vue 3

Vue.js Components Library built on top of Bootstrap 5 and TypeScript.
Explore Bootstrap Vue docs »

Report bug · Request feature · Blog

Table of contents

• Quick start
• Status
• What's included
• Bugs and feature requests
• Documentation
• Contributing
• Community
• Versioning
• Creators
• Copyright and license

Quick start

Instalation

Several quick start options are available:

• Download the latest release
• Clone the repo: git clone https://github.com/coreui/bootstrap-vue.git
• Install with npm: npm install @coreui/bootstrap-vue
• Install with yarn: yarn add @coreui/bootstrap-vue

Read the Getting started page for information on the framework contents, templates and examples, and more.

Stylesheets

Vue components are styled using bootstrap CSS library.

Installation

yarn add bootstrap

or

npm install bootstrap

Basic usage

import "bootstrap/dist/css/bootstrap.min.css";

Status

Bugs and feature requests

Have a bug or a feature request? Please first read the issue guidelines and search for existing and closed issues. If your problem or idea is not addressed yet, please open a new issue.

Documentation

The documentation for the Bootstrap Vue is hosted at our website Bootstrap Vue

Running documentation locally

1. Run yarn install or npm install to install the Node.js dependencies.
2. Run yarn bootstrap or npm run bootstrap to link local packages together and install remaining package dependencies.
3. From the root directory, run yarn docs:dev or npm run docs:dev (or a specific npm script) to rebuild distributed CSS and JavaScript files, as well as our docs assets.
4. Open http://localhost:8000/ in your browser, and voilà.

Contributing

Please read through our contributing guidelines. Included are directions for opening issues, coding standards, and notes on development.

Editor preferences are available in the editor config for easy use in common text editors. Read more and download plugins at https://editorconfig.org/.

Community

Stay up to date on the development of Bootstrap Vue and reach out to the community with these helpful resources.

• Read and subscribe to The Official CoreUI Blog.

You can also follow @core_ui on Twitter.

Versioning

For transparency into our release cycle and in striving to maintain backward compatibility, Bootstrap Vue is maintained under the Semantic Versioning guidelines.

See the Releases section of our project for changelogs for each release version.

Creators

Łukasz Holeczek

• https://twitter.com/lukaszholeczek
• https://github.com/mrholek

Andrzej Kopański

• https://github.com/xidedix

The CoreUI Team

• https://github.com/orgs/coreui/people

Copyright and license

Copyright 2021 creativeLabs Łukasz Holeczek. Code released under the MIT License. Docs released under Creative Commons.

bootstrap-vue's Issues

Add `v-on` support to CForm

For example, this works:
<form @submit.prevent="onSubmit">

But this does not:
<CForm @submit.prevent="onSubmit">

Add button support to CDropdownItem

https://getbootstrap.com/docs/5.1/components/dropdowns/#menu-items

Bootstrap 5 supports dropdown menu items with button elements.

QUESTION: How do I v-model to a group of radio buttons?

I'm using the CFormCheck component to allow the user to select an option, but I can't figure out how to get the value of the selected button back to my state variable. Should I be setting the model-value attribute? If so, how does that work? Every time I try to set it, the attribute takes on the value true no matter what value I pass in. Is there an example on the documentation site? Thank you.

Example:

<CFormCheck
  id="inlineCheckbox1"
  v-model="cloudSave"
  inline
  type="radio"
  name="inlineRadioOptions"
  label="Local"
  model-value="cloudSave"
/>

Support Vue router props in CDropdownItem / Link

Currently CDDropdownItem only supports href prop. It would be nice if the Vue Router object props were also supported.

New Props:

• to: supports string path or Vue Router Location object
• nuxt: not as critical as "to" but would be nice to add also. A simple boolean prop that embeds a NuxtLink

CDDropdownItem currently extends CLink so it would be nice to implement this logic in CLink so it could be shared by all linkable components.

I can create a PR for this if you are ok with the feature.

Page is not interactable after closing any modal

I'm using Edge Chromium, the webpage is not interactable after closing any modal.
You can try it from your documentation page: https://coreui.io/bootstrap-vue/components/modal.html#live-demo

1. Click"Launch demo modal"
2. Close the modal
3. Click "Launch demo modal" or any supposed to be interactable link/button <- failed here

coreui vs bootstrap-vue?

so this project uses the same name as https://bootstrap-vue.org/?

what's different between coreui/bootstrap-vue vs coreui? the latter also claims to be a bootstrap5 UI kit.

then there is https://github.com/cdmoro/bootstrap-vue-3

Docs - Icon Page 404

It looks like in the official docs the icon component page is missing.

The link in the side nav points to this page: https://coreui.io/bootstrap-vue/components/icon.html and currently throws a 404