实践：实现 Vue 应用程序的时尚布局

2023-11-0806:39:29WEB前端开发Comments1,219 views字数 4855阅读模式

页面布局是减少代码重复和创建可维护且具有专业外观的应用程序的基本模式。如果使用的是 Nuxt，则可以提供开箱即用的优雅解决方案。然而，令人遗憾的是，在 Vue 中，这些问题并未得到官方文档的解决。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/56774.html

经过多次尝试，小编得出了一个运行良好且可扩展而不会令人头疼的架构的模式。下面用一个简单的例子为大家介绍一下。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/56774.html

设置需求文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/56774.html

布局架构需要满足的需求：文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/56774.html

页面应声明每个部分的布局和组件。
对页面的更改不应影响其他页面。
如果布局的某些部分在页面中是通用的，则只应声明一次。

设置 Vue 路由文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/56774.html

小编需要在页面之间导航，这就是小编要设置 vue-router 的原因。 Vue-cli 脚手架 vite 提供了在创建新项目时包含它的选项，但如果您没有用脚手架创建项目，可以通过下面的方式设置路由。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/56774.html

1. 安装 vue-router 依赖项文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/56774.html

npm i -D vue-router@4

2. 声明路由文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/56774.html

const routes = [
  { path: "/", component: () => import("./pages/HomePage.vue") },
  { path: "/explore", component: () => import("./pages/ExplorePage.vue") },
];

3. 将其安装为插件文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/56774.html

import { createApp } from "vue";
import { createRouter, createWebHashHistory } from "vue-router";
import App from "./App.vue";
import routes from "./routes.ts"

const router = createRouter({
  history: createWebHashHistory(),
  routes,
});

const app = createApp(App);

app.use(router);

app.mount("#app");

4. 最后，更新 App.vue 使其仅包含 router-view文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/56774.html

<template>
  <router-view />
</template>

运行后的显示效果如下图所示：文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/56774.html

页面文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/56774.html

下面将创建以下页面：主页、探索、文章和 404，以及三种布局：三列、两列和空白。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/56774.html

三列布局文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/56774.html

主页是每个流行的社交网络使用的典型 3 列布局。第一列包含应用程序的徽标和导航，在使用此布局的每个页面中保持不变。这同样适用于右下角的页脚。每个页面的主要内容和侧边栏小部件都会更改。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/56774.html

首先从 HomePage.vue 组件开始实现这一点。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/56774.html

<script setup lang="ts">
import ThreeColumnLayout from "../layouts/ThreeColumnLayout.vue";
import ArticleCard from "../components/ArticleCard.vue";
import WidgetFriendSuggestions from "../components/WidgetFriendSuggestions.vue";
import useArticles from "../composables/useArticles";
const articles = useArticles().getArticles();
</script>

<template>
  <ThreeColumnLayout>
    <h2 class="text-3xl font-bold mb-4">Homepage content</h2>
    <ArticleCard v-for="article in articles" :article="article" />

    <template #aside>
      <WidgetFriendSuggestions />
    </template>
  </ThreeColumnLayout>
</template>

小编使用一个 ThreeColumnLayout 组件（稍后会实现它）。默认插槽具有标题和文章列表，它们是页面的主要内容。此外，小编创建一个名称为 aside 的命名槽，用于声明小部件。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/56774.html

按照通用约定， ThreeColumnLayout 组件放置在文件夹中 /layouts 它将使用网格容器并用于文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/56774.html

grid-template-areas 创建三列布局。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/56774.html

布局的实现细节将取决于此组件，而不是页面。使用 flexbox，网格系统或任何其他技术都是可能的。如果使用全宽、盒装或流体布局，则同样适用。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/56774.html

此布局有 3 列文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/56774.html

第一列将包含硬编码的徽标和导航组件。
第二列将仅创建默认插槽，并让页面决定要插入的内容。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/56774.html

第三列将包含每个页面通用的旁槽和页脚组件。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/56774.html

ThreeColumnLayout.vue文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/56774.html

<script setup>
import AppNavigation from "../components/AppNavigation.vue";
import AppFooter from "../components/AppFooter.vue";
import AppLogo from "../components/AppLogo.vue";
</script>

<template>
  <div class="three-column-layout">
    <header>
      <AppLogo />
      <AppNavigation />
    </header>

    <main>
      <slot />
    </main>

    <aside>
      <slot name="aside" />
      <AppFooter />
    </aside>
  </div>
</template>

<style scoped lang="scss">
.three-column-layout {
  display: grid;
  grid-template-areas:
    "header"
    "main"
    "aside";

  header {
    grid-area: header;
    margin-top: 30px;
  }
  main {
    grid-area: main;
    margin-top: 10px;
    padding: 20px;
  }
  aside {
    grid-area: aside;
    margin-top: 10px;
    padding: 20px;
  }

  @media (min-width: 768px) {
    grid-template-columns: 1fr 3fr 1fr;
    grid-template-areas: "header main aside";
  }
}
</style>

实现效果如下图所示：文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/56774.html

创建具有相同布局的新页面将证明这种方法是多么简洁。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/56774.html

使用下面的代码创建文章页面，并在侧边栏上有一个额外的小部件：文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/56774.html

<script setup>
import ThreeColumnLayout from "../layouts/ThreeColumnLayout.vue";
import WidgetRelatedContent from "../components/WidgetRelatedContent.vue";
import WidgetFriendSuggestions from "../components/WidgetFriendSuggestions.vue";
import { useRoute } from "vue-router";
import useArticles from "../composables/useArticles";
const article = useArticles().getArticle(useRoute().params.id);
</script>

<template>
  <ThreeColumnLayout>
    <h2 class="text-3xl font-bold mb-4">{{ article.title }}</h2>
    <div class="max-w-md" v-html="article.description"></div>

    <template #aside>
      <WidgetFriendSuggestions />
      <WidgetRelatedContent />
    </template>
  </ThreeColumnLayout>
</template>

实现的效果：文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/56774.html

两列布局文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/56774.html

对于 “详情” 页面，小编将创建一个两列布局。第一列将与三列布局相同，但主要部分将占据屏幕的其余部分，并将页脚放在底部。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/56774.html

该实现看起来与上一个没有太大区别。但是这次小编使用 flex-basis。（只是为了演示创建 CSS 布局的不同方法。在实际场景中，所有实现都应使用相同的技术。）文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/56774.html

TwoColumnLayout.vue文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/56774.html

<script setup>
import AppNavigation from "../components/AppNavigation.vue";
import AppLogo from "../components/AppLogo.vue";
import AppFooter from "../components/AppFooter.vue";
</script>
<template>
  <div class="two-column-layout">
    <header>
      <AppLogo />
      <AppNavigation />
    </header>

    <main>
      <slot />
      <AppFooter />
    </main>
  </div>
</template>

<style scoped>
.two-column-layout {
  display: flex;
  @media (max-width: 768px) {
    flex-direction: column;
  }
}
header {
  flex-basis: 20%;
  margin-top: 30px;
}

main {
  flex-basis: 80%;
  margin-top: 10px;
  padding: 20px;
}
</style>

使用此布局的浏览页面非常简单。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/56774.html

Explore.vue文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/56774.html

<script setup>
import TwoColumnLayout from "../layouts/TwoColumnLayout.vue";
import ExploreItem from "../components/ExploreItem.vue";

import useArticles from "../composables/useArticles";
const articles = useArticles().getExploreArticles();
</script>

<template>
  <TwoColumnLayout>
    <h2 class="text-3xl font-bold mb-12">
      Latest content on <a target="_blank" href="https://dev.to/">Dev.to</a>
    </h2>
    <div class="grid lg:grid-cols-3 gap-6">
      <ExploreItem v-for="article in articles" :article="article" />
    </div>
  </TwoColumnLayout>
</template>

实现效果：文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/56774.html

文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/56774.html

空白布局文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/56774.html

最后，小编创建一个可在 404 页面上使用的空白整页布局。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/56774.html

<template>
  <main class="container my-24 px-6 mx-auto">
    <slot />
  </main>
</template>

即使实现很简单，使用布局也很重要，这次只有一个居中的容器（tailwind.css）。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/56774.html

这样，小编可以保持页面组件的精简，并确保使用此布局的多个页面的外观和行为相同。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/56774.html

<script setup>
import BlankLayout from "../layouts/BlankLayout.vue";
import PageNotFound from "../components/PageNotFound.vue";
</script>

<template>
  <BlankLayout>
    <PageNotFound />
  </BlankLayout>
</template>

文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/56774.html

结论文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/56774.html

布局是减少样板和维护具有专业外观的应用程序的绝佳工具。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/56774.html

葡萄城技术团队文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/56774.html

实践：实现 Vue 应用程序的时尚布局

搞懂 Vue3 defineModel 双向绑定：告别繁琐代码！

Tailwind CSS响应式Web设计全面掌握指南

全栈开发使用Node js（Express）、MYSQL进行CRUD

TypeScript项目搭配Axios封装后端接口调用

jQuery 4.0 测试版，体积小性能好不再支持 IE 10

JavaScript实现轮播图方法，代码简单

Next.Js 与 Tailwind 项目开发笔记

使用Vite创建Vue3项目并开发第一个组件

asyncio 中并发运行的多个任务要如何精确控制

Django RESTful项目中使用Swagger文档生成器

Comment