vue学习笔记九：vue系统性学习笔记之内置组件

2023-11-12 19:45:52

参考文档：内置组件 | Vue.js

内置组件可以直接在模板中使用，而不需注册。

<keep-alive>、<transition>、<transition-group> 和 <teleport> 组件都可以被打包工具 tree-shake。所以它们只会在被使用的时候被引入。如果你需要直接访问它们，也可以将它们显性导入。
// Vue 的 CDN 构建版本
const { KeepAlive, Teleport, Transition, TransitionGroup } = Vue
// Vue 的 ESM 构建版本
import { KeepAlive, Teleport, Transition, TransitionGroup } from 'vue'
<component> 和 <slot> 是模板语法中组件形式的特性。它们不是真正的组件且无法像上述组件那样被导入。

component：

API文档：

Props：

is - string | Component | VNode
用法：

渲染一个“元组件”为动态组件。依 is 的值，来决定哪个组件被渲染。is 的值是一个字符串，它既可以是 HTML 标签名称也可以是组件名称。

<component :is="componentId"></component>


<component :is="$options.components.child"></component>


<component :is="condition ? 'FooComponent' : 'BarComponent'"></component>


<component :is="href ? 'a' : 'span'"></component>
结合内置组件的用法：

内置组件 KeepAlive、Transition、TransitionGroup 和 Teleport 都可以被传递给 is，但是如果你想要通过名字传入它们，就必须注册。例如：
const { Transition, TransitionGroup } = Vue
const Component = {
  components: {
    Transition,
    TransitionGroup
  },
  template: `
    <component :is="isGroup ? 'TransitionGroup' : 'Transition'">
      ...
    </component>
  `
}
如果你传递组件本身到 is 而不是其名字，则不需要注册。
结合 VNode 的用法

在高阶使用场景中，通过模板来渲染现有的 VNode 有时候会是很有用的。通过 <component> 可以实现这种场景，但它应该被视为一种回退策略，用来避免将整个模板改写为 render 函数。
<component :is="vnode" :key="aSuitableKey" />
以这种方式混用 VNode 与模板的注意事项是你需要提供一个合适的 key attribute。VNode 将被认为是静态的，所以除非 key 发生变化，任何更新都将被忽略。key 可以设置在 VNode 或者 <component> 标签上，但无论哪种方式，你都需要在想要 VNode 重新渲染时更改它。如果这些节点具有不同的类型，比如将 span 更改为 div，那么此注意事项将不适用。

transition：

API文档：

Props：

name - string 用于自动生成 CSS 过渡类名。例如：name: 'fade' 将自动拓展为 .fade-enter，.fade-enter-active 等。

appear - boolean，是否在初始渲染时使用过渡。默认为 false。

persisted - boolean。如果是 true，表示这是一个不真实插入/删除元素的转换，而是切换显示/隐藏状态。过渡钩子被注入，但渲染器将跳过。相反，自定义指令可以通过调用注入的钩子 (例如 v-show) 来控制转换。

css - boolean。是否使用 CSS 过渡类。默认为 true。如果设置为 false，将只通过组件事件触发注册的 JavaScript 钩子。

type - string。指定过渡事件类型，侦听过渡何时结束。有效值为 "transition" 和 "animation"。默认 Vue.js 将自动检测出持续时间长的为过渡事件类型。

mode - string 控制离开/进入过渡的时间序列。有效的模式有 "out-in" 和 "in-out"；默认同时进行。

duration - number | { enter: number, leave: number }。指定过渡的持续时间。默认情况下，Vue 会等待过渡所在根元素的第一个 transitionend 或 animationend 事件。

enter-from-class - string

leave-from-class - string

appear-class - string

enter-to-class - string

leave-to-class - string

appear-to-class - string

enter-active-class - string

leave-active-class - string

appear-active-class - string

事件：

before-enter

before-leave

enter

leave

appear

after-enter

after-leave

after-appear

enter-cancelled

leave-cancelled (仅 v-show)

appear-cancelled
用法：

<transition> 元素作为单个元素/组件的过渡效果。<transition> 只会把过渡效果应用到其包裹的内容上，而不会额外渲染 DOM 元素，也不会出现在可被检查的组件层级中。

<transition>
  <div v-if="ok">toggled content</div>
</transition>


<transition name="fade" mode="out-in" appear>
  <component :is="view"></component>
</transition>


<div id="transition-demo">
  <transition @after-enter="transitionComplete">
    <div v-show="ok">toggled content</div>
  </transition>
</div>
const app = createApp({
  ...
  methods: {
    transitionComplete (el) {
      // 因为传递了'el'的DOM元素作为参数
    }
  }
  ...
})

app.mount('#transition-demo')

transition-group：

API文档：

Props：

tag - string - 如果未定义，则不渲染动画元素。

move-class - 覆盖移动过渡期间应用的 CSS 类。

除了 mode - 其他 attribute 和 <transition> 相同。

事件：

事件和 <transition> 相同。

用法：

<transition-group> 提供了多个元素/组件的过渡效果。默认情况下，它不会渲染一个 DOM 元素包裹器，但是可以通过 tag attribute 来定义。

注意，每个 <transition-group> 的子节点必须有独立的 key，动画才能正常工作。

<transition-group> 支持通过 CSS transform 过渡移动。当一个子节点被更新，从屏幕上的位置发生变化，它会被应用一个移动中的 CSS 类 (通过 name attribute 或配置 move-class attribute 自动生成)。如果 CSS transform property 是“可过渡” property，当应用移动类时，将会使用 FLIP 技术使元素流畅地到达动画终点。
<transition-group tag="ul" name="slide">
  <li v-for="item in items" :key="item.id">
    {{ item.text }}
  </li>
</transition-group>

keep-alive：

API文档：

Props：

include - string | RegExp | Array。只有名称匹配的组件会被缓存。

exclude - string | RegExp | Array。任何名称匹配的组件都不会被缓存。

max - number | string。最多可以缓存多少组件实例。
用法：

<keep-alive> 包裹动态组件时，会缓存不活动的组件实例，而不是销毁它们。和 <transition> 相似，<keep-alive> 是一个抽象组件：它自身不会渲染一个 DOM 元素，也不会出现在组件的父组件链中。

当组件在 <keep-alive> 内被切换时，它的 mounted 和 unmounted 生命周期钩子不会被调用，取而代之的是 activated 和 deactivated。(这会运用在 <keep-alive> 的直接子节点及其所有子孙节点。)

主要用于保留组件状态或避免重新渲染。

<keep-alive>
  <component :is="view"></component>
</keep-alive>


<keep-alive>
  <comp-a v-if="a > 1"></comp-a>
  <comp-b v-else></comp-b>
</keep-alive>


<transition>
  <keep-alive>
    <component :is="view"></component>
  </keep-alive>
</transition>
注意，<keep-alive> 是用在其一个直属的子组件被切换的情形。如果你在其中有 v-for 则不会工作。如果有上述的多个条件性的子元素，<keep-alive> 要求同时只有一个子元素被渲染。
include 和 exclude

include 和 exclude prop 允许组件有条件地缓存。二者都可以用逗号分隔字符串、正则表达式或一个数组来表示：

<keep-alive include="a,b">
  <component :is="view"></component>
</keep-alive>


<keep-alive :include="/a|b/">
  <component :is="view"></component>
</keep-alive>


<keep-alive :include="['a', 'b']">
  <component :is="view"></component>
</keep-alive>
匹配首先检查组件自身的 name 选项，如果 name 选项不可用，则匹配它的局部注册名称 (父组件 components 选项的键值)。匿名组件不能被匹配。
max

最多可以缓存多少组件实例。一旦这个数字达到了，在新实例被创建之前，已缓存组件中最久没有被访问的实例会被销毁掉。
<keep-alive :max="10">
  <component :is="view"></component>
</keep-alive>
WARNING

<keep-alive> 不会在函数式组件中正常工作，因为它们没有缓存实例。

slot：

API文档：

Props：

name - string，用于具名插槽

用法：

<slot> 元素作为组件模板之中的内容分发插槽。<slot> 元素自身将被替换。

详细用法，请参考下面教程的链接。

teleport：

API文档：

Props：

to - string。需要 prop，必须是有效的查询选择器或 HTMLElement (如果在浏览器环境中使用)。指定将在其中移动 <teleport> 内容的目标元素

<teleport to="#some-id" />
<teleport to=".some-class" />
<teleport to="[data-teleport]" />


<teleport to="h1" />
<teleport to="some-string" />
disabled - boolean。此可选属性可用于禁用 <teleport> 的功能，这意味着其插槽内容将不会移动到任何位置，而是在你在周围父组件中指定了 <teleport> 的位置渲染。
<teleport to="#popup" :disabled="displayVideoInline">
  <video src="./my-movie.mp4">
</teleport>
请注意，这将移动实际的 DOM 节点，而不是被销毁和重新创建，并且它还将保持任何组件实例的活动状态。所有有状态的 HTML 元素 (即播放的视频) 都将保持其状态。

码农公寓

参考文档：内置组件 | Vue.js

component：

transition：

transition-group：

keep-alive：

slot：

teleport：

相关文章