# @duskmoon-dev/el-card 中文文档

规范地址：https://npmcn.com/package/%40duskmoon-dev/el-card/

版本：1\.10\.3
npm 元数据更新时间：2026-11-11T10:50:03.870Z
中文译文更新时间：2026-11-13T00:46:05.020Z
软件包许可：未声明

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40duskmoon-dev/el-card
原文对照：https://npmcn.com/package/%40duskmoon-dev/el-card/?lang=original
项目主页：https://github.com/duskmoon-dev/duskmoon-elements#readme
源码仓库：https://github.com/duskmoon-dev/duskmoon-elements

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：77.2 kB，17 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：2 个
- 首次发布：2026-01-04T07:17:34.949Z
- 最新版本发布：2026-11-11T10:50:03.414Z
- 近 30 天下载量：2702（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：54（近 12 个月 54 个）

## 中文简介

装有页眉、身体和页脚的容器部件.

## 安装

```sh
npm install @duskmoon-dev/el-card
```

也可以使用：`pnpm add @duskmoon-dev/el-card`、`yarn add @duskmoon-dev/el-card`、`bun add @duskmoon-dev/el-card`

## README

# @duskmoon-dev/el-card (日语)

装有页眉、身体和页脚的容器部件.

## 安装

```bash
bun add @duskmoon-dev/el-card
```

## 使用量

### 自动注册( 建议)

使用组件的最简单方式 - 只需导入即可:

```html
<!-- Via CDN -->
<script type="module" src="https://esm.sh/@duskmoon-dev/el-card/register"></script>

<!-- Now use the element -->
<el-dm-card>
  <h3 slot="header">Card Title</h3>
  <p>Card body content goes here.</p>
  <div slot="footer">
    <button>Action</button>
  </div>
</el-dm-card>
```

或与一捆子:

```ts
import '@duskmoon-dev/el-card/register';
```

### 手工登记

```html
<script type="module">
  import { register } from '@duskmoon-dev/el-card';
  register();
</script>

<el-dm-card>
  <h3 slot="header">Card Title</h3>
  <p>Card body content goes here.</p>
</el-dm-card>
```

## 备选案文

| 备选案文 | 说明 |
| --- | --- |
| `elevated` | 有阴影的出牌( 默认) |
| `outlined` | 带有边框的卡 |
| `filled` | 有微妙背景的牌 |

## 铺垫

| 大小 | 说明 |
| --- | --- |
| `none` | 无粘贴 |
| `sm` | 小垫子 |
| `md` | 中度粘贴( 默认) |
| `lg` | 大型垫地 |

## 属性

| 属性 | 类型 | 默认 | 说明 |
| --- | --- | --- | --- |
| `variant` | 字符串 | `elevated` | 卡片变型 |
| `interactive` | 布尔 | `false` | 让牌可以点击 |
| `padding` | 字符串 | `md` | 铺设大小 |

## 槽数

| 槽 | 说明 |
| --- | --- |
| (默认) | 纸牌正文内容 |
| `header` | 标题部分 |
| `footer` | 页脚部分 |
| `media` | 媒体内容(图像/视频) |

## CSS 组件

| 编 | 说明 |
| --- | --- |
| `card` | 主卡容器 |
| `header` | 标题部分 |
| `body` | 机构部分 |
| `footer` | 页脚部分 |
| `media` | 媒体科 |

## CSS 自定义属性

| 财产 | 说明 |
| --- | --- |
| `--dm-card-padding` | 贴纸 |
| `--dm-card-border-radius` | 边界半径 |
| `--dm-card-background` | 背景颜色 |
| `--dm-card-border-color` | 边框颜色 |
| `--dm-card-shadow` | 框阴影 |

## 实例

### 与媒体

```html
<el-dm-card>
  <img slot="media" src="image.jpg" alt="Card image" />
  <h3 slot="header">Image Card</h3>
  <p>Description of the image.</p>
</el-dm-card>
```

### 互动卡

```html
<el-dm-card interactive onclick="handleClick()">
  <h3 slot="header">Clickable Card</h3>
  <p>Click me!</p>
</el-dm-card>
```

### 概要备选案文

```html
<el-dm-card variant="outlined">
  <p>Outlined card content.</p>
</el-dm-card>
```

## 许可证

麻省理工学院

## 常见问题

### @duskmoon-dev/el-card 是什么？

装有页眉、身体和页脚的容器部件\.

### 如何安装 @duskmoon-dev/el-card？

在项目目录运行 npm install @duskmoon-dev/el-card，或使用 pnpm add / yarn add / bun add。

### @duskmoon-dev/el-card 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @duskmoon-dev/el-card 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @duskmoon-dev/el-card 可以商用吗？

@duskmoon-dev/el-card 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @duskmoon-dev/el-card 的下载量有多少？

根据 npm 官方下载统计，@duskmoon-dev/el-card 在 2026/10/13 – 2026/11/11 这 30 天内被下载 2,702 次，日均约 90 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @duskmoon-dev/el-card 还在维护吗？

最新版本 1\.10\.3 发布于 2026/11/11（2 天前）；至今共发布 54 个版本，其中过去 12 个月发布了 54 个；首次发布于 2026/01/04。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。