百科狗-知识改变命运!
--

内置组件 ​

百变鹏仔1年前 (2023-11-21)阅读数 24#技术干货
文章标签组件

内置组件 ​

组件注册和使用

内置组件无需注册便可以直接在模板中使用。它们也支持 tree-shake:仅在使用时才会包含在构建中。

在渲染函数中使用它们时,需要显式导入。例如:

js
import { h, Transition } from 'vue'h(Transition, { /* props */})

` {#transition}"">​

单个元素或组件提供动画过渡效果。

  • Props

    ts
    interface 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
  • 示例

    简单元素:

    template
     toggled content

    通过改变 key 属性来强制过度执行:

    template
     {{ text }}

    动态组件,初始渲染时带有过渡模式 + 动画出现:

    template
     

    监听过渡事件:

    template
     toggled content
  • 参考 指南

` {#transitiongroup}"">​

为列表中的多个元素或组件提供过渡效果。

  • Props

    拥有与 除了 mode 以外所有的 props,并增加了两个额外的 props:

    ts
    interface 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

    ts
    interface KeepAliveProps { /** * 如果指定,则只有与 `include` 名称 * 匹配的组件才会被缓存。 */ include?: MatchPattern /** * 任何名称与 `exclude` * 匹配的组件都不会被缓存。 */ exclude?: MatchPattern /** * 最多可以缓存多少组件实例。 */ max?: number | string}type MatchPattern = string | RegExp | (string | RegExp)[]
  • 详细信息

    包裹动态组件时,会缓存不活跃的组件实例,而不是销毁它们。

    任何时候都只能有一个活跃组件实例作为 的直接子节点。

    当一个组件在 中被切换时,它的 activateddeactivated 生命周期钩子将被调用,用来替代 mountedunmounted。这适用于 的直接子节点及其所有子孙节点。

  • 示例

    基本用法:

    template
     

    v-if / v-else 分支一起使用时,同一时间只能有一个组件被渲染:

    template
      

    一起使用:

    template
       

    使用 include / exclude

    template
       

    使用 max

    template
     
  • 参考指南 - KeepAlive

` {#teleport}"">​

将其插槽内容渲染到 DOM 中的另一个位置。

  • Props

    ts
    interface TeleportProps { /** * 必填项。指定目标容器。 * 可以是选择器或实际元素。 */ to: string | HTMLElement /** * 当值为 `true` 时,内容将保留在其原始位置 * 而不是移动到目标容器中。 * 可以动态更改。 */ disabled?: boolean}
  • 示例

    指定目标容器:

    template

    内置组件 ​

    有条件地禁用:

    template
     
  • 参考指南 - Teleport

` {#suspense}"">​

用于协调对组件树中嵌套的异步依赖的处理。

  • Props

    ts
    interface SuspenseProps { timeout?: string | number}
  • 事件

    • @resolve
    • @pending
    • @fallback
  • 详细信息

    接受两个插槽:#default#fallback。它将在内存中渲染默认插槽的同时展示后备插槽内容。

    如果在渲染时遇到异步依赖项 (异步组件和具有 async setup() 的组件),它将等到所有异步依赖项解析完成时再显示默认插槽。

  • 参考指南 - Suspense

鹏仔微信 15129739599 鹏仔QQ344225443 鹏仔前端 pjxi.com 共享博客 sharedbk.com

免责声明:我们致力于保护作者版权,注重分享,当前被刊用文章因无法核实真实出处,未能及时与作者取得联系,或有版权异议的,请联系管理员,我们会立即处理! 部分文章是来自自研大数据AI进行生成,内容摘自(百度百科,百度知道,头条百科,中国民法典,刑法,牛津词典,新华词典,汉语词典,国家院校,科普平台)等数据,内容仅供学习参考,不准确地方联系删除处理!邮箱:344225443@qq.com)

图片声明:本站部分配图来自网络。本站只作为美观性配图使用,无任何非法侵犯第三方意图,一切解释权归图片著作权方,本站不承担任何责任。如有恶意碰瓷者,必当奉陪到底严惩不贷!

内容声明:本文中引用的各种信息及资料(包括但不限于文字、数据、图表及超链接等)均来源于该信息及资料的相关主体(包括但不限于公司、媒体、协会等机构)的官方网站或公开发表的信息。部分内容参考包括:(百度百科,百度知道,头条百科,中国民法典,刑法,牛津词典,新华词典,汉语词典,国家院校,科普平台)等数据,内容仅供参考使用,不准确地方联系删除处理!本站为非盈利性质站点,本着为中国教育事业出一份力,发布内容不收取任何费用也不接任何广告!)