跳到主要内容

Card 卡片

通用卡片容器。

基础用法​

基础用法
水墨山水

远山如黛,近水含烟。

这是卡片的正文内容区域。

可交互卡片

clickable 时整卡承担 button 语义,支持 Enter / Space 键盘激活。

import { LhCard } from '@lh-ui/react'

export default function Demo() {
return (
<LhCard title="水墨山水" style={{ width: 300 }}>
<p>远山如黛,近水含烟。</p>
</LhCard>
)
}

Card Props​

属性说明类型可选值默认值
title标题(无 header 时渲染默认头部)string——
shadow阴影显示时机'always' | 'hover' | 'never'—'always'
clickable整卡可点击(承担 button 键盘语义)boolean—false
loading加载中(正文区骨架占位,整卡禁止交互)boolean—false
cover封面区ReactNode——
header头部内容(覆盖默认头部)ReactNode——
extra头部右侧附加区ReactNode——
footer底部区域ReactNode——
themeVars组件级主题变量,覆盖 ConfigProvider 配置Record<string, string>——
bgPattern组件级背景花纹string——
sx快速布局属性SxProps——

Card 事件​

事件说明回调签名Vue 对照
onClick点击时触发(仅 clickable 且非 loading)(event: MouseEvent) => void@click
键盘交互

clickable 且非 loading 时,卡片渲染为 role="button" 并响应 Enter / Space(Space 会 preventDefault 防滚动),详见 无障碍。

Vue 插槽对照

plus 的 cover / header / extra / footer 插槽在 React 侧映射为同名 ReactNode props,默认插槽为 children。

样式​

import '@lh-ui/react/style/card'