Skip to content

t-card

Card 卡片

组件介绍

t-card 用于展示标题、副标题、标签和图片的卡片组件,支持自定义类名以增强样式控制。卡片可以用于展示信息、操作栏、封面图等内容,是页面布局中常用的容器组件。

平台兼容

HarmonyH5AndroidiOS小程序UTS

基础用法

基础用法参考 demo/card/card.uvue,通过 titlesubTitletag 属性设置卡片内容,使用 icon 属性设置图标。

vue
<template>
  <!-- 基础卡片 -->
  <t-card 
    :icon="src" 
    title="主标题" 
    sub-title="次级标题" 
    tag="标签详情">
  </t-card>

  <!-- 不同主题 -->
  <t-card 
    class="mb-30" 
    :icon="src" 
    type="primary" 
    title="主标题" 
    sub-title="次级标题" 
    tag="标签详情">
  </t-card>

  <!-- 不同尺寸 -->
  <t-card 
    class="mb-30" 
    :icon="src" 
    size="large" 
    type="warning" 
    title="主标题" 
    sub-title="次级标题" 
    tag="标签详情">
  </t-card>

  <!-- 展示封面图片 -->
  <t-card class="mb-30 p-0">
    <view class="w-100% h-380 dr">
      <image class="w-100% h-380 r-0" src='/static/image/D1.jpg'></image>
      <text class="da db-0 c-#ffffff sfwb fbsb p-20">
        这是一个展示封面和操作栏的卡片实例
      </text>
    </view>
    <text class="ttl2 p-10 slh-50">
      此示例向您展示了如何使用封面插槽和操作栏插槽,以增强卡片的视觉效果和功能性。
    </text>
  </t-card>
</template>

<script setup>
const src = ref<string>('/static/image/avatar.jpeg')
</script>

Props

属性名说明类型默认值
size组件尺寸,可选 largemediumsmallministring'medium'
type组件主题类型,可选 infoprimaryerrorwarningsuccessstring''
disabled是否禁用booleanfalse
effect组件显示主题,可选 normaldarklightplainstring'normal'
hover是否启用点击效果booleantrue
path点击组件后跳转的页面路径;为空时仅响应事件string''
icon卡片图标,支持图片地址和字体图标string''
iconClass图标样式类,对应外部类 icon-classany''
title标题string''
titleClass标题样式类,对应外部类 title-classany''
subTitle副标题string''
subTitleClass副标题样式类,对应外部类 sub-title-classany''
tag标签string''
tagClass标签样式类,对应外部类 tag-classany''
headerClassheader 盒子的样式类,对应外部类 header-classany''

Events

事件名说明回调参数
click点击时触发UniPointerEvent
transitionend动画结束时触发-
initFinished组件初始化完成时触发,返回组件节点信息NodeInfo
touchstart触摸开始时触发-
touchend触摸结束时触发-
touchmove触摸移动时触发-
touchcancel触摸取消时触发-

Slots

插槽名说明
default默认插槽,用于自定义卡片内容