内置组件
内置组件
组件注册和使用
内置组件无需注册便可以直接在模板中使用。它们也支持 tree-shake:仅在使用时才会包含在构建中。
在渲染函数中使用它们时,需要显式导入。例如:
import { h, Transition } from 'vue'h(Transition, { /* props */})
` {#transition}"">
为单个元素或组件提供动画过渡效果。
Props
tsinterface TransitionProps { /** * 用于自动生成过渡 CSS class 名。 * 例如 `name: 'fade'` 将自动扩展为 `.fade-enter`、 * `.fade-enter-active` 等。 */ name?: string /** * 是否应用 CSS 过渡 class。 * 默认:true */ css?: boolean /** * 指定要等待的过渡事件类型 * 来确定过渡结束的时间。 * 默认情况下会自动检测 * 持续时间较长的类型。 */ type?: 'transition' | 'animation' /** * 显式指定过渡的持续时间。 * 默认情况下是等待过渡效果的根元素的第一个 `transitionend` * 或`animationend`事件。 */ duration?: number | { enter: number; leave: number } /** * 控制离开/进入过渡的时序。 * 默认情况下是同时的。 */ mode?: 'in-out' | 'out-in' | 'default' /** * 是否对初始渲染使用过渡。 * 默认:false */ appear?: boolean /** * 用于自定义过渡 class 的 prop。 * 在模板中使用短横线命名,例如:enter-from-class="xxx" */ enterFromClass?: string enterActiveClass?: string enterToClass?: string appearFromClass?: string appearActiveClass?: string appearToClass?: string leaveFromClass?: string leaveActiveClass?: string leaveToClass?: string}
事件
@before-enter
@before-leave
@enter
@leave
@appear
@after-enter
@after-leave
@after-appear
@enter-cancelled
@leave-cancelled
(v-show
only)@appear-cancelled
示例
简单元素:
templatetoggled content
通过改变
key
属性来强制过度执行:template{{ text }}
动态组件,初始渲染时带有过渡模式 + 动画出现:
template监听过渡事件:
templatetoggled content
参考
指南
` {#transitiongroup}"">
为列表中的多个元素或组件提供过渡效果。
Props
拥有与
除了
mode
以外所有的 props,并增加了两个额外的 props:tsinterface TransitionGroupProps extends Omit { /** * 如果未定义,则渲染为片段 (fragment)。 */ tag?: string /** * 用于自定义过渡期间被应用的 CSS class。 * 在模板中使用 kebab-case,例如 move-class="xxx" */ moveClass?: string}
事件
抛出与
相同的事件。
详细信息
默认情况下,
不会渲染一个容器 DOM 元素,但是可以通过
tag
prop 启用。注意,每个
的子节点必须有独立的 key,动画才能正常工作。
支持通过 CSS transform 控制移动效果。当一个子节点在屏幕上的位置在更新之后发生变化时,它会被添加一个使其位移的 CSS class (基于
name
attribute 推导,或使用move-class
prop 显式配置)。如果使其位移的 class 被添加时 CSS 的transform
属性是“可过渡的”,那么该元素会基于 FLIP 技巧平滑地到达动画终点。示例
template{{ item.text }}
参考指南 - TransitionGroup
` {#keepalive}"">
缓存包裹在其中的动态切换组件。
Props
tsinterface KeepAliveProps { /** * 如果指定,则只有与 `include` 名称 * 匹配的组件才会被缓存。 */ include?: MatchPattern /** * 任何名称与 `exclude` * 匹配的组件都不会被缓存。 */ exclude?: MatchPattern /** * 最多可以缓存多少组件实例。 */ max?: number | string}type MatchPattern = string | RegExp | (string | RegExp)[]
详细信息
包裹动态组件时,会缓存不活跃的组件实例,而不是销毁它们。
任何时候都只能有一个活跃组件实例作为
的直接子节点。
当一个组件在
中被切换时,它的
activated
和deactivated
生命周期钩子将被调用,用来替代mounted
和unmounted
。这适用于的直接子节点及其所有子孙节点。
示例
基本用法:
template与
v-if
/v-else
分支一起使用时,同一时间只能有一个组件被渲染:template与
一起使用:
template使用
include
/exclude
:template使用
max
:template参考指南 - KeepAlive
` {#teleport}"">
将其插槽内容渲染到 DOM 中的另一个位置。
Props
tsinterface TeleportProps { /** * 必填项。指定目标容器。 * 可以是选择器或实际元素。 */ to: string | HTMLElement /** * 当值为 `true` 时,内容将保留在其原始位置 * 而不是移动到目标容器中。 * 可以动态更改。 */ disabled?: boolean}
示例
指定目标容器:
template有条件地禁用:
template参考指南 - Teleport
` {#suspense}"">
用于协调对组件树中嵌套的异步依赖的处理。
Props
tsinterface SuspenseProps { timeout?: string | number}
事件
@resolve
@pending
@fallback
详细信息
接受两个插槽:
#default
和#fallback
。它将在内存中渲染默认插槽的同时展示后备插槽内容。如果在渲染时遇到异步依赖项 (异步组件和具有
async setup()
的组件),它将等到所有异步依赖项解析完成时再显示默认插槽。参考指南 - Suspense
鹏仔微信 15129739599 鹏仔QQ344225443 鹏仔前端 pjxi.com 共享博客 sharedbk.com
图片声明:本站部分配图来自网络。本站只作为美观性配图使用,无任何非法侵犯第三方意图,一切解释权归图片著作权方,本站不承担任何责任。如有恶意碰瓷者,必当奉陪到底严惩不贷!