Card 卡片

卡片用于展示单个主题的内容和相关操作。

使用方法

按需导入组件：

import 'mdui/components/card.js';

按需导入组件的 TypeScript 类型：

import type { Card } from 'mdui/components/card.js';

使用示例：

Card

<mdui-card style="width: 200px;height: 124px">Card</mdui-card>

示例

形状

使用 variant 属性设置卡片的形状。

<mdui-card variant="elevated" style="width: 200px;height: 124px"></mdui-card>
<mdui-card variant="filled" style="width: 200px;height: 124px"></mdui-card>
<mdui-card variant="outlined" style="width: 200px;height: 124px"></mdui-card>

源码

可点击

添加 clickable 属性可以使卡片可点击，此时会添加鼠标悬浮效果和点击涟漪效果。

<mdui-card clickable style="width: 200px;height: 124px"></mdui-card>

源码

链接

添加 href 属性，可以使卡片变为链接，此时还可以使用这些和链接相关的属性：download、target、rel。

<mdui-card href="https://www.mdui.org" target="_blank" style="width: 200px;height: 124px"></mdui-card>

源码

禁用状态

添加 disabled 属性可以禁用卡片。

<mdui-card disabled style="width: 200px;height: 124px"></mdui-card>

源码

API

属性

HTML 属性	JavaScript 属性	类型	默认值
`variant`	`variant`	`'elevated' \| 'filled' \| 'outlined'`	`'elevated'`
卡片的形状。可选值包括： `elevated`：带阴影的卡片，与背景的视觉分离度较高 `filled`：带填充色的卡片，与背景的视觉分离度较低 `outlined`：带边框的卡片，与背景的视觉分离度最高
`clickable`	`clickable`	`boolean`	`false`
是否可点击。为 `true` 时，卡片将具有鼠标悬浮效果和点击涟漪效果
`disabled`	`disabled`	`boolean`	`false`
是否禁用
`href`	`href`	`string`	-
链接的目标 URL。如果设置了此属性，组件内部将渲染为 `<a>` 元素，并可以使用链接相关的属性。
`download`	`download`	`string`	-
下载链接的目标。 Note：仅在设置了 `href` 属性时，此属性才有效。
`target`	`target`	`'_blank' \| '_parent' \| '_self' \| '_top'`	-
链接的打开方式。可选值包括： `_blank`：在新窗口中打开链接 `_parent`：在父框架中打开链接 `_self`：默认。在当前框架中打开链接 `_top`：在整个窗口中打开链接 Note：仅在设置了 `href` 属性时，此属性才有效。
`rel`	`rel`	`'alternate' \| 'author' \| 'bookmark' \| 'external' \| 'help' \| 'license' \| 'me' \| 'next' \| 'nofollow' \| 'noreferrer' \| 'opener' \| 'prev' \| 'search' \| 'tag'`	-
当前文档与被链接文档之间的关系。可选值包括： `alternate`：当前文档的替代版本 `author`：当前文档或文章的作者 `bookmark`：永久链接到最近的祖先章节 `external`：引用的文档与当前文档不在同一站点 `help`：链接到相关的帮助文档 `license`：当前文档的主要内容由被引用文件的版权许可覆盖 `me`：当前文档代表链接内容的所有者 `next`：当前文档是系列中的一部分，被引用的文档是系列的下一个文档 `nofollow`：当前文档的作者或发布者不认可被引用的文件 `noreferrer`：不包含 `Referer` 头。类似于 `noopener` 的效果 `opener`：如果超链接会创建一个顶级浏览上下文（即 `target` 属性值为 `_blank`），则创建一个辅助浏览上下文 `prev`：当前文档是系列的一部分，被引用的文档是系列的上一个文档 `search`：提供一个资源链接，可用于搜索当前文件及其相关页面 `tag`：提供一个适用于当前文档的标签（由给定地址识别） Note：仅在指定了 `href` 属性时可用。
`autofocus`	`autofocus`	`boolean`	`false`
是否在页面加载完成后自动获取焦点
`tabindex`	`tabIndex`	`number`	-
元素在使用 Tab 键切换焦点时的顺序

方法

名称	参数	返回值
`click`		`void`
模拟鼠标点击元素
`focus`	`options: FocusOptions` (可选)	`void`
将焦点设置到当前元素。可以传入一个对象作为参数，该对象的属性包括： `preventScroll`：默认情况下，元素获取焦点后，页面会滚动以将该元素滚动到视图中。如果不希望页面滚动，可以将此属性设置为 `true`。
`blur`		`void`
移除当前元素的焦点

事件

名称
`focus`
获得焦点时触发
`blur`
失去焦点时触发

Slots

名称
默认
卡片的内容

CSS 自定义属性

名称
`--shape-corner`
组件的圆角大小。可以指定一个具体的像素值；但更推荐引用设计令牌

Chip 纸片

Checkbox 复选框