跳转到主要内容
在本页

构建一个 Vue.js 应用

Vue.js 是一个渐进式前端 JavaScript 框架。它提供了用于创建动态和交互式用户界面的工具和功能。

在本教程中,我们将使用 Vite 和 Deno 构建一个简单的 Vue.js 应用。该应用将显示恐龙列表。当您单击其中一个时,它将带您进入包含更多详细信息的恐龙页面。您可以在 GitHub 上查看完成的应用

The Vue.js app in action

使用 Vite 和 Deno 创建 Vue.js 应用 跳转到标题

我们将使用 Vite 来搭建一个基本的 Vue.js 应用。在您的终端中,运行以下命令以使用 Vite 创建一个新的 .js 应用

deno run -A npm:create-vite

出现提示时,为您的应用命名,并从提供的框架中选择 Vue,并选择 TypeScript 作为变体。

创建完成后,cd 进入您的新项目并运行以下命令以安装依赖项

deno install

然后,运行以下命令以启动您的新 Vue.js 应用

deno task dev

Deno 将运行 package.json 文件中的 dev 任务,该任务将启动 Vite 服务器。点击输出的本地主机链接,即可在浏览器中查看您的应用。

添加后端 跳转到标题

下一步是添加后端 API。我们将创建一个非常简单的 API,用于返回有关恐龙的信息。

在新的 Vite 项目的根目录下,创建一个 api 文件夹。在该文件夹中,创建一个 main.ts 文件(用于运行服务器)和一个 data.json 文件(用于存放硬编码数据)。

此 JSON 文件复制并粘贴到 api/data.json 中。

我们将使用 oak 中间件框架cors 中间件 构建一个简单的 API 服务器,其路由返回恐龙信息,并启用 CORS

使用 deno add 命令将所需的依赖项添加到您的项目中。

deno add jsr:@oak/oak jsr:@tajpouria/cors

接下来,更新 api/main.ts 以导入所需的模块,并创建一个新的 Router 实例来定义一些路由。

main.ts
import { Application, Router } from "@oak/oak";
import { oakCors } from "@tajpouria/cors";
import data from "./data.json" with { type: "json" };

const router = new Router();

在此之后,在同一个文件中,我们将定义三个路由。第一个路由 / 将返回字符串 Welcome to the dinosaur API,然后我们将设置 /dinosaurs 以返回所有恐龙,最后设置 /dinosaurs/:dinosaur 以根据 URL 中的名称返回特定的恐龙。

main.ts
router
  .get("/", (context) => {
    context.response.body = "Welcome to dinosaur API!";
  })
  .get("/dinosaurs", (context) => {
    context.response.body = data;
  })
  .get("/dinosaurs/:dinosaur", (context) => {
    if (!context?.params?.dinosaur) {
      context.response.body = "No dinosaur name provided.";
    }

    const dinosaur = data.find((item) =>
      item.name.toLowerCase() === context.params.dinosaur.toLowerCase()
    );

    context.response.body = dinosaur ? dinosaur : "No dinosaur found.";
  });

最后,在同一个文件的底部,创建一个新的 Application 实例,并使用 app.use(router.routes()) 将我们刚刚定义的路由附加到应用程序,并启动服务器以监听端口 8000。

main.ts
const app = new Application();
app.use(oakCors());
app.use(router.routes());
app.use(router.allowedMethods());

await app.listen({ port: 8000 });

您可以使用 deno run --allow-env --allow-net api/main.ts 运行 API 服务器。我们将创建一个任务来运行此命令,并更新 dev 任务以同时运行 Vue.js 应用和 API 服务器。

在您的 package.json 文件中,更新 scripts 字段以包含以下内容。

{
  "scripts": {
    "dev": "deno task dev:api & deno task dev:vite",
    "dev:api": "deno run --allow-env --allow-net api/main.ts",
    "dev:vite": "deno run -A npm:vite",
    // ...
}

现在,如果您运行 deno task dev 并访问浏览器中的 localhost:8000,您应该会看到文本 Welcome to dinosaur API!,如果您访问 localhost:8000/dinosaurs,您应该会看到所有恐龙的 JSON 响应。

构建前端 跳转到标题

入口点和路由 跳转到标题

src 目录中,您会找到一个 main.ts 文件。这是 Vue.js 应用的入口点。我们的应用将有多个路由,因此我们需要一个路由器来进行客户端路由。我们将使用官方的 Vue Router 来实现这一点。

更新 src/main.ts 以导入和使用路由器。

import { createApp } from "vue";
import router from "./router/index.ts";

import "./style.css";
import App from "./App.vue";

createApp(App)
  .use(router)
  .mount("#app");

使用 deno add 将 Vue Router 模块添加到项目中。

deno add npm:vue-router

接下来,在 src 目录中创建一个 router 目录。在其中创建一个包含以下内容的 index.ts 文件。

router/index.ts
import { createRouter, createWebHistory } from "vue-router";
import HomePage from "../components/HomePage.vue";
import Dinosaur from "../components/Dinosaur.vue";

export default createRouter({
  history: createWebHistory("/"),
  routes: [
    {
      path: "/",
      name: "Home",
      component: HomePage,
    },
    {
      path: "/:dinosaur",
      name: "Dinosaur",
      component: Dinosaur,
      props: true,
    },
  ],
});

这将设置一个包含两个路由的路由器://:dinosaurHomePage 组件将在 / 处渲染,Dinosaur 组件将在 /:dinosaur 处渲染。

最后,您可以删除 src/App.vue 文件中的所有代码,并将其更新为仅包含 <RouterView> 组件。

App.vue
<template>
  <RouterView />
</template>;

组件 跳转到标题

Vue.js 将前端 UI 拆分为组件。每个组件都是可重用的代码段。我们将创建三个组件:一个用于主页,一个用于恐龙列表,一个用于单个恐龙。

每个组件文件都被分成三个部分:<script><template><style><script> 标签包含组件的 JavaScript 逻辑,<template> 标签包含 HTML,而 <style> 标签包含 CSS。

/src/components 目录中,创建三个新文件:HomePage.vueDinosaurs.vueDinosaur.vue

恐龙组件 跳转到标题

Dinosaurs 组件将从我们之前设置的 API 中获取恐龙列表,并使用Vue Router 的 RouterLink 组件 将它们渲染为链接。(因为我们正在创建一个 TypeScript 项目,不要忘记在 script 标签上指定 lang="ts" 属性。)将以下代码添加到 Dinosaurs.vue 文件中

Dinosaurs.vue
<script lang="ts">
import { defineComponent } from 'vue';

export default defineComponent({
    async setup() {
        const res = await fetch("https://127.0.0.1:8000/dinosaurs")
        const dinosaurs = await res.json() as Dinosaur[];
        return { dinosaurs };
    }
});
</script>

<template>
    <div v-for="dinosaur in dinosaurs" :key="dinosaur.name">
        <RouterLink :to="{ name: 'Dinosaur', params: { dinosaur: `${dinosaur.name.toLowerCase()}` } }" >
            {{ dinosaur.name }}
        </RouterLink>
    </div>
</template>

这段代码使用 Vue.js 的 v-for 指令遍历 dinosaurs 数组,并将每个恐龙渲染为一个 RouterLink 组件。RouterLink 组件的 :to 属性指定了点击链接时要导航到的路由,:key 属性用于唯一标识每个恐龙。

主页组件 跳转到标题

主页将包含一个标题,然后它将渲染 Dinosaurs 组件。将以下代码添加到 HomePage.vue 文件中

HomePage.vue
<script setup lang="ts">
import Dinosaurs from './Dinosaurs.vue';
</script>
<template>
  <h1>Welcome to the Dinosaur App! 🦕</h1>
  <p>Click on a dinosaur to learn more about them</p>
  <Suspense>
    <template #default>
      <Dinosaurs />
    </template>
    <template #fallback>
      <div>Loading...</div>
    </template>
  </Suspense>
</template>

由于 Dinosaurs 组件异步获取数据,因此使用 Suspense 组件 来处理加载状态。

恐龙组件 跳转到标题

Dinosaur 组件将显示特定恐龙的名称和描述,以及返回完整列表的链接。

首先,我们将为要获取的数据设置一些类型。在 src 目录中创建一个 types.ts 文件,并添加以下代码

types.ts
type Dinosaur = {
  name: string;
  description: string;
};

type ComponentData = {
  dinosaurDetails: null | Dinosaur;
};

然后更新 Dinosaur.vue 文件

Dinosaur.vue
<script lang="ts">
import { defineComponent } from 'vue';

export default defineComponent({
    props: { dinosaur: String },
    data(): ComponentData {
        return { 
            dinosaurDetails: null 
        };
    },
    async mounted() {
        const res = await fetch(`https://127.0.0.1:8000/dinosaurs/${this.dinosaur}`);
        this.dinosaurDetails = await res.json();
    }
});
</script>

<template>
    <h1>{{ dinosaurDetails?.name }}</h1>
    <p>{{ dinosaurDetails?.description }}</p>
    <RouterLink to="/">🠠 Back to all dinosaurs</RouterLink>
</template>

这段代码使用 props 选项定义了一个名为 dinosaur 的 prop,它将被传递给组件。mounted 生命周期钩子用于根据 dinosaur prop 获取恐龙的详细信息,并将它们存储在 dinosaurDetails 数据属性中。然后,这些数据将在模板中渲染。

运行应用程序 跳转到标题

现在我们已经设置好了前端和后端,可以运行应用程序了。在终端中,运行以下命令

deno task dev

在浏览器中访问输出的 localhost 链接以查看应用程序。点击一只恐龙查看更多详细信息!

The vue app in action

🦕 现在您可以在 Deno 中使用 Vite 运行 Vue 应用程序了,您可以构建真实的应用程序!如果您想扩展此演示,您可以考虑构建一个后端服务器,以便在构建后提供静态应用程序,然后您就可以将您的恐龙应用程序部署到云端