BootstrapVue 入门[每日前端夜话0x62]

Vue.js 是一个流行的 JavaScript 库，用于在短时间内开发原型。这包括用户界面、前端应用、静态网页和本机移动应用。它以易用的语法和简单的数据绑定功能而闻名。

最近，Vue.js 生态系统发布了一个新的软件包。它是流行的 Bootstrap 框架与 Vue.js 的集成。这个包称为 BootstrapVue。它允许我们使用与 Bootstrap（v4）集成的自定义组件。
它还支持自定义 Bootstrap 组件、网格系统，还支持 Vue.js 指令。

在本文中，我们将介绍 BootstrapVue 的基础知识，解释一般概念，演示设置过程，并通过它构建一个迷你 Vue.js 项目，以便为你提供更多的实践经验。

为什么选择 BootstrapVue？

鉴于 Bootstrap是最受欢迎的独立 CSS 框架（在我看来），很多已经或有意向从Vanilla JavaScript 的框架转移到 Vue.js 的开发人员总是发现迁移有点困难，因为 Bootstrap 对 jQuery 的依赖性很大。

使用 BootstrapVue，任何人都可以从 Vanilla.js 或 jQuery 切换到 Vue.js，而无需担心 Bootstrap 对 jQuery 的严重依赖，甚至无法找到解决方法。这就是 BootstrapVue 的救援方式。它有助于弥补这一差距，并允许 Vue 开发人员能够轻松地在他们的项目中使用 Bootstrap。

入门

使用 webpack、babel 等模块捆绑包时，最好直接把这些包包含到项目中。为了给你演示并提供了解和使用 BootstrapVue 的实践方法，我们将用 BootstrapVue 设置一个 Vue.js 项目，并把它构建到一个功能性的 Vue.js 应用中。

先决条件

具备 Vue.js 的基本知识可以帮你理解这个演示
在你的电脑上全局安装 Vue CLI 。如果你目前尚未安装，请按照此安装指南进行操作

Create a Vue project

创建一个Vue项目

首先必须创建一个 Vue.js 项目，我们将会用它来演示 BootstrapVue 组件的实现。在首选目录上打开一个终端窗口，然后运行以下命令：

1vue create bootstrapvue-demo

如果你没有全局安装 Vue CLI，请按照此安装指南进行操作后再继续本教程。

上面的命令会显示一个预设的选择对话框，如下所示：

选择 default，然后单击Enter继续：

现在，你创建了一个 Vue 程序，下面转到新的 Vue 项目目录，并使用以下命令启动开发服务器：

1cd bootstrapvue-demo2npm run serve

你的 Vue 应用程序将会在 localhost:8080 上提供服务。在浏览器中打开它，你将看到自己的Vue应用程序：

将 Bootstrap 和 BootstrapVue 添加到项目中

有两种方法可以做到这一点，可以用npm和yarn这样的包管理器或者用CDN链接。

使用npm或yarn

我们将使用npm或yarn安装之前提到的包。切换到项目的根目录并运行下面的任一命令，具体取决于你首选的包管理器：

1# With npm2npm install bootstrap-vue bootstrap axios34# With yarn5yarn add bootstrap-vue bootstrap axios

上面的命令将会安装BootstrapVue和Bootstrap包。 BoostrapVue包中包含所有BootstrapVue组件，常规Bootstrap包含CSS文件。另外还安装了Axios来帮助我们从themealdb API获取程序所需的数据。

Using CDN

使用CDN
要通过CDN将Bootstrap和BootstrapVue添加到Vue项目，请打开项目公共文件夹中的index.html文件，并将此代码添加到适当的位置：

1<!-- public/index.html-->23<!-- Add Bootstrap and Bootstrap-Vue CSS to the <head> section -->4<link type="text/css" rel="stylesheet" href="https://unpkg.com/bootstrap/dist/css/bootstrap.min.css"/>5<link type="text/css" rel="stylesheet" href="https://unpkg.com/bootstrap-vue@latest/dist/bootstrap-vue.min.css"/>67<!-- Add Vue and BootstrapVue scripts just before the closing </body> tag -->8<script src="https://unpkg.com/vue/dist/vue.min.js"></script>9<script src="https://unpkg.com/bootstrap-vue@latest/dist/bootstrap-vue.min.js"></script>

这将把每个库的缩小版和最新版本引入我们的项目中，非常简单！但是出于本文的目的，我们将使用第一个方法中的包管理器。下面继续设置BootstrapVue包。

设置BootstrapVue

接下来，让我们设置刚刚安装的BootstrapVue包。转到你的main.js文件并将这行代码添加到顶部：

1//src/main.js2import BootstrapVue from 'bootstrap-vue'3Vue.use(BootstrapVue)

在这里做的事情非常简单，我们导入了BoostrapVue包，然后用Vue.use()函数在程序中注册它，以便Vue程序可以识别。

我们还需要将Bootstrap CSS文件导入到项目中。将这段代码段添加到main.js文件中：

1//src/main.js2import 'bootstrap/dist/css/bootstrap.css'3import 'bootstrap-vue/dist/bootstrap-vue.css'

在将必要的模块导入Vue程序后，你的main.js文件应该和下面的代码段类似：

 1//src/main.js 2import Vue from 'vue' 3import App from './App.vue' 4import BootstrapVue from 'bootstrap-vue' 5import 'bootstrap/dist/css/bootstrap.css' 6import 'bootstrap-vue/dist/bootstrap-vue.css' 7 8Vue.use(BootstrapVue) 9Vue.config.productionTip = false1011new Vue({12  render: h => h(App),13}).$mount('#app')

创建Bootstrap组件

下面开始创建我们的第一个组件，第一个组件是Navbar组件。转到组件目录，创建一个名为Navbar.vue的文件，并使用以下代码更新它：

 1//src/components/Navbar.vue 2<template> 3    <div> 4      <b-navbar toggleable="lg" type="dark" variant="success"> 5        <b-container> 6            <b-navbar-brand href="#">Mealzers</b-navbar-brand> 7            <b-navbar-toggle target="nav-collapse"></b-navbar-toggle> 8            <b-collapse id="nav-collapse" is-nav> 9              <!-- Right aligned nav items -->10              <b-navbar-nav class="ml-auto">11                <b-nav-form>12                  <b-form-input 13                    size="sm" 14                    class="mr-sm-2" 15                    placeholder="Search for a meal"16                    v-model="meal"17                    ></b-form-input>18                  <b-button 19                    size="sm" 20                    class="my-2 my-sm-0" 21                    type="submit" 22                    @click.prevent="getMeal"23                    >Search</b-button>24                </b-nav-form>25                <b-nav-item-dropdown right>26                  <!-- Using 'button-content' slot -->27                  <template slot="button-content"><em>User</em></template>28                  <b-dropdown-item href="#">Profile</b-dropdown-item>29                  <b-dropdown-item href="#">Sign Out</b-dropdown-item>30                </b-nav-item-dropdown>31              </b-navbar-nav>32            </b-collapse>33          </b-container>34      </b-navbar>35    </div>  36</template>37<script>38export default {39    data() {40        return {41            meal: ''42        }43    },44  methods: {45    getMeal() {46      ...47    }48  }49}    50</script>

Navbar组件中包含几个BootstrapVue组件，其中一个是b-navbar组件。它是Navbar中其他组件的父组件。如果没有这个组件，Navbar中的所有其他组件将无法正确呈现。

可以用type 属性更改Navbar上的文本颜色。 Navbar的background-color也可以用variant 属性来改变。这些颜色可以是任何正常的Bootstrap默认颜色 —— info、primary、success 等。

另一个是b-navbar-brand组件。这是可以呈现网站徽标的地方。它还包含variant和type属性，它们可以分别用于改变background-color和text-color。

其他BootstrapVue组件是：

b-nav-form
b-nav-item-dropdown
b-dropdown-item
b-navbar-toggle
b-collapse
b-nav-item（可以用“disabled”属性禁用）
b-navbar-nav
b-nav-item.
更多

BootstrapVue组件的一个美妙之处在于它们默认是响应式的。所以你无需编写额外的代码或用外部库来使其实现响应式。

还有一个组件是Card组件。card 组件允许我们在卡中显示图像、文本等。它写做b-card 。为了演示它，让我们在组件目录中创建一个Cards.vue文件。然后用下面的代码更新其内容：

1//src/components/Cards.vue 2<template> 3  <b-container> 4    <div v-if="meals.length"> 5      <b-row> 6        <div v-bind:key="data.index" v-for="data in meals"> 7          <b-col l="4"> 8            <b-card 9                    v-bind:title="data.strCategory"10                    v-bind:img-src="data.strCategoryThumb"11                    img-alt="Image"12                    img-top13                    tag="article"14                    style="max-width: 20rem;"15                    class="mb-2">16              <b-card-text>{{ `${data.strCategoryDescription.slice(0,100)}...` }}</b-card-text>17              <b-button href="#" variant="primary">View food</b-button>18            </b-card>19          </b-col>20        </div>21      </b-row>22    </div>23    <div v-else>24      <h5>No meals available yet </h5>25    </div>26  </b-container>27</template>2829<script>30  import axios from "axios";31  export default {32    data() {33      return {34        meals: []35      };36    },37    mounted() {38      axios39        .get("https://www.themealdb.com/api/json/v1/1/categories.php")40        .then(response => {41        this.meals = response.data.categories;42      })43        .catch(err => {44        console.log(err);45      });46    }47  };48</script>

为了渲染刚刚创建的Cards组件，需要修改HelloWorld.vue文件。打开它并使用以下代码更新：

 1//src/components/HelloWorld.vue 2<template> 3  <div> 4    <Cards /> 5  </div> 6</template> 7 8<script> 9import Cards from './Cards.vue'10export default {11  name:'cards',12  components: {13    Cards14  },15  data() {16    return {1718    };19  },20};21</script>22<style scoped>23</style>24view raw

在这里做的是创建一个Cards组件并将其嵌入到HelloWorld.vue文件中。请注意，在Cards组件中，有一个生命周期hook来修改数据。数据在被渲染到浏览器之前被填充到b-card组件中。

接下来，更新App.vue文件，用来捕获最近的更改并将正确的组件呈现给浏览器。打开它并使用下面的代码更新：

 1//App.vue 2<template> 3  <div id="app"> 4    <Navbar /> 5    <HelloWorld/> 6  </div> 7</template> 8<script> 9 import HelloWorld from './components/HelloWorld.vue'10  import Navbar from './components/Navbar.vue';  11  export default {12    name: 'navbar',13    components: {14      Navbar,15      HelloWorld16    }17  }18</script>

这是在浏览器上可以看到我们的餐饮程序运行如下：

正如你所看到的，card 没有被正确的布局，所以必须纠正这一点。幸运的是，BootstrapVue有一些可以将我们的card放在网格中的内置组件。

它们是：

b-row
b-col

修改Cards.vue文件中的代码，使用上面提到的BootstrapVue组件在网格中呈现内容。打开Cards.vue文件并使用下面的代码片段更新：

1//src/components/HelloWorld.vue 2<template> 3  <b-container> 4    <div v-if="meals.length"> 5      <b-row> 6        <div v-bind:key="data.index" v-for="data in meals"> 7          <b-col l="4"> 8            <b-card 9              v-bind:title="data.strCategory"10              v-bind:img-src="data.strCategoryThumb"11              img-alt="Image"12              img-top13              tag="article"14              style="max-width: 20rem;"15              class="mb-2">16              <b-card-text>{{ `${data.strCategoryDescription.slice(0,100)}...` }}</b-card-text>17              <b-button href="#" variant="primary">View food</b-button>18            </b-card>19          </b-col>20        </div>21      </b-row>22    </div>23    <div v-else>24      <h5>No meals available yet </h5>25    </div>26  </b-container>27</template>28<script>29import axios from "axios";30export default {31  data() {32    return {33      meals: []34    };35  },36  mounted() {37    axios38      .get("https://www.themealdb.com/api/json/v1/1/categories.php")39      .then(response => {40        this.meals = response.data.categories;41      })42      .catch(err => {43        console.log(err);44      });45  }46};47</script>

现在刷新浏览器，应该看到一个正确布局的卡片，其中包含渲染内容。

现在有了一个排列工整的餐饮程序。我们用了一些BootstrapVue的组件构建了所有这些。要了解有关BootstrapVue的更多信息，请查看官方文档（https://bootstrap-vue.js.org/docs/）。

迁移

如果你想把现有项目从常规Bootstrap4迁移到BootstrapVue该怎么办？这将是一件轻而易举的事。这就是你需要做的：

1.从构建脚本中删除bootstrap.js文件

2.从你的程序中删除jQuery，BootstrapVue能独立工作

3.将本机Bootstrap标记转换为BootstrapVue自定义组件标记

就是这些！通过这三个步骤，你可以将现有项目从依赖jQuery的常规Bootstrap迁移到更简单的独立BootstrapVue包，而不会破坏任何现有代码。

结论

本文通过示例演示了怎样使用BootstrapVue。我们从安装开始，在Vue项目中进行设置，最后使用其自定义组件构建Mealzers程序的一部分。可以看到，BootstrapVue模块简单易用。如果你有常规Bootstrap包的知识，那么使用BootstrapVue将是轻而易举的一件事。

原文：https://blog.logrocket.com/getting-started-with-bootstrapvue-2d8bf907ef11