Vue组件封装小技巧,老大看了都说好

目录
文章目录隐藏
  1. 1. 你可能不需要创建一个组件
  2. 2. 使用插槽而不是 prop 来显示内容
  3. 3. 将该组件与触发它的因素分组
  4. 4. 使用 teleport,从任何地方显示固定位置的元素
  5. 5. 在一个对象中分组相关的 props
  6. 6. 赋予每个循环 item,赋予自己的状态
  7. 7. 尽可能地将加载数据移至其用户界面附近
  8. 8. 纯粹的 UI 组件不应访问应用程序的状态
  9. 9. 不要在组件中指定 width 或 margin

组件是前端框架的基本构建块。把它们设计得更好会使我们的应用程序更容易改变和理解。在这节课中,分享一下在过去几年中工作中学到的 9 个技巧。

1. 你可能不需要创建一个组件

在创建一个组件之前,看看它是为了可重用性和为某些 UI 添加一个状态,还是仅仅为了组织和划分代码。

如果是后者,那么你就不需要创建它,因为它只会增加更多不必要的工作,比如传递props和发射事件。

不仅如此,它还要求我们跳转到该文件以查看它所包含的内容,而不是直接在父组件中看到它,这就干净多了。

2. 使用插槽而不是 prop 来显示内容

假设有一个可重复使用的按钮组件,它通过props获取文本。

<BaseButton label="Delete Item"/>

如果想在其中显示一个图标,必须添加更多的道具,如<BaseButton label="Delete Item" icon="delete" />并更新组件以显示该图标。

但有了插槽,我们就可以在每次使用该组件时,以想要的方式显示标签:

<BaseButton>
  Delete Item <Icon name="delete" />
</BaseButton>

或者你只需要把某个单词加粗。对于插槽,可以直接在文本中使用<strong>标记,而不是在组件中解析它。

3. 将该组件与触发它的因素分组

有时有两个独立的组件在某种情况下一起使用。最好把它们放在一个新的组件中,这样重复使用和移动它们更容易。

一个常见的例子是 Modal 组件。我们通常在点击一个特定的按钮时显示Modal。与其在每次我们想重用它(或把它移到其他地方)时添加showModal状态和导入 modal 与它的按钮,不如有一个单一的组件来显示按钮,当用户点击时,它显示相关的 modal。

<!-- CreateItemButton.vue -->
<template>
  <Modal v-if="showModal" @close="showModal = false" />
  <BaseButton @click="showModal = true">
    Create Item
  </BaseButton>
</template>

<script setup>
const showModal = false
</script>

4. 使用 teleport,从任何地方显示固定位置的元素

继续前面的例子,如果我们想正确地显示 modal ,我们需要确保模态使用正确的z-index,并且它在 HTML 代码中显示在正确的位置,所以它总是显示在页面上所有东西的上面。

我们可以通过直接将 modal 显示为<body>元素的一个子元素来轻松地避免这个问题,无论我们在组件结构中使用它。

Teleport 组件使我们能够做到这一点。

我们所要做的就是用 <Teleport to="body"> 来包装 modal 组件。

<!-- BaseModal.vue -->
<template>
  <Teleport to="body">
    <div class="modal"></div>
  </Teleport>
</template>

这个组件是 Vue 3 内置组件的一部分。如果你使用的是 Vue 2,请查看PortalVue

5. 在一个对象中分组相关的 props

组件的 prop 列表是组件界面的一个主要部分。接口越清晰,就越容易使用和推理。

改进 prop 列表的一个方法是将相关的属性分组在一起。以这个组件为例:

<PostCard
  :title="post.title"
  :date="post.date"
  :layout="currentLayout"
  :image="post.imageUrl"
  <!-- more props -->
/>

我们需要花几秒钟时间来了解这里有哪些 props 与帖子(post )相关。但我们可以像这样把与帖子相关的 props 分组,使之更加清晰。

<PostCard :post="post" :layout="currentLayout" />

所以现在我们很快就知道,layout 不是 post 数据的一部分。

不仅如此,我们还通过这种方法使更新 props 变得更加容易。例如,添加或删除与帖子相关的 props ,不需要我们更新组件的 props 列表。

6. 赋予每个循环 item,赋予自己的状态

创建一个新的组件的一个很好的理由是给一块用户界面提供它自己的状态。我们需要这样做的一个常见的地方是在v-for循环中:

<template>
  <div>
    <div v-for="(item, index) in items" :key="item.id">
      <input type="checkbox" v-model="checkedItems[index]">
    </div>
  </div>
</template>
<script setup>
const checkedItems = ref(items.map(item => item.checked))
</script>

为了跟踪检查过的 items,我们不得不创建一个数组,并用 items 的初始值来填充它。但是这段代码还不够强大。为了让它变得更好,我们必须让 items 通过它们的id而不是index 来访问,因为 index 是不可靠的,可以改变。例如,如果你添加一个支持通过拖放来重新排列 items 的功能呢?

为了简化这段代码,我们可以引入一个新的组件,为每个 item 保存一个状态。像这样:

<template>
  <div>
    <Item v-for="item in items" :key="item.id" :item="item" />
  </div>
</template>

Item 组件内容如下:

<template>
  <div>
    <input type="checkbox" v-model="checked">
  </div>
</template>

<script setup>
const props = defineProps({ item: Object })
const checked = ref(props.item.checked)
</script>

这种方法的另一个好处是,我们把所有 item 的相关数据、计算属性和方法都加在一个地方,便于理解和改变。

7. 尽可能地将加载数据移至其用户界面附近

无论你是用 GraphQL 还是其他 API 加载,最好把代码放在尽可能接近使用它的用户界面的地方。这有两个原因:

  1. 移动带有数据的 UI 组件变得更加容易。只需移动该组件,而无需寻找其依赖关系。
  2. 当所有的碎片被放在一个地方时,总是更容易理解代码–可以看到用户界面和它的数据来自哪里。

有时,有多个组件使用同一个获取的数据。在这种情况下,可以将获取的代码上移一级。因此,会有一个父组件,在那里获取数据,还有一个子组件,然后把数据传递给它。

但一定要确保它是一个单一的层次。如果不是,那就寻找一种方法来改进你的组件设计和它们之间的关系。

8. 纯粹的 UI 组件不应访问应用程序的状态

有两种类型的前端组件:纯 UI 组件和特定应用组件。

纯粹的 UI 组件是像按钮、输入框等。它们不应该知道关于应用程序的任何事情。它们的工作仅仅是为了显示 UI–它们通过 props 获取数据。

特定于应用程序的组件是知道应用程序状态的组件,无论是本地状态还是全局状态(通过状态管理库,如 Pinia)。

分离这些组件使得在应用程序的其他地方,甚至在其他应用程序中重用 UI 组件更加容易。

如果你正在构建自己的 UI 组件,这个技巧也适用。如果你使用的是外部库,如 Vuetify 或 Quasar,那么你就不必担心这个问题–这些组件在设计时就考虑到了这一点。

9. 不要在组件中指定 width 或 margin

当创建一个组件时,你应该把它看作是一块 UI,可以像其他本地元素一样使用。

让用户指定组件周围的空间是实现这一目标的好方法。

假设你的组件在其根元素上有一个顶部边距,而用户想把它显示在某个元素下面,但没有顶部边距。要做到这一点,用户必须设置一个与组件的margin相同的负margin,比如margin-top: -50px;更不用说在某些情况下,用户必须与选择器的特异性相匹配(或者可能使用!important)。

而宽度也是如此。如果用户想让该组件具有响应性,他们必须覆盖其宽度和最大宽度。

因此,通过不在组件内部设置宽度和边距,总是给用户这种控制是有意义的。

「点点赞赏,手留余香」

0

给作者打赏,鼓励TA抓紧创作!

微信微信 支付宝支付宝

还没有人赞赏,快来当第一个赞赏的人吧!

声明:本站所有文章,如无特殊说明或标注,均为本站原创发布。任何个人或组织,在未征得本站同意时,禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益,可联系我们进行处理。
码云笔记 » Vue组件封装小技巧,老大看了都说好

发表回复