@embedpdf/plugin-metadata

中文文档
3.2.0发布于 2026/11/12Apache-2.0TypeScriptESM + CJS近 30 天下载 6.5万

Metadata for EmbedPDF: reads and changes a document's title, author and your own fields.

原始使用文档

@embedpdf/plugin-metadata

Metadata for EmbedPDF: reads and changes a document's title, author and your own fields.

This plugin comes with each EmbedPDF framework package. Import it from the one you use:

FrameworkImport fromDocs
React@embedpdf/react/metadataMetadata
Vue@embedpdf/vue/metadataMetadata
Svelte@embedpdf/svelte/metadataMetadata
Angular@embedpdf/angular/metadataMetadata

In React

A PDF carries information about itself: a title, an author, when it was made. Register metadataPlugin() to show it in your UI and let people change it:

title-field.tsx

import { useMetadata, useMetadataState } from '@embedpdf/react/metadata';

export function TitleField() {
  const { update, canUpdate } = useMetadata();
  const { metadata } = useMetadataState();

  return (
    <label>
      Title
      <input
        defaultValue={metadata?.title ?? ''}
        disabled={!canUpdate()}
        onBlur={(event) => update({ title: event.target.value })}
      />
    </label>
  );
}

What useMetadataState() gives you updates by itself: after your own changes, and on a shared document, after someone else's. Nothing is read when a document opens: the metadata loads the first time something asks for it, so a document nobody shows the properties of costs nothing.

License

Apache-2.0

版本与发布记录

@embedpdf/plugin-metadata 共发布 27 个版本,首次发布于 2026/08/06;过去 12 个月发布了 27 个版本。

版本发布日期距今
3.2.0latest2026/11/121 天前
3.1.02026/11/094 天前
3.0.02026/11/076 天前
3.0.0-next.23next2026/11/076 天前
3.0.0-next.222026/11/049 天前
3.0.0-next.212026/11/0310 天前

关于 @embedpdf/plugin-metadata 的常见问题

@embedpdf/plugin-metadata 是什么?

Metadata for EmbedPDF: reads and changes a document's title, author and your own fields.

如何安装 @embedpdf/plugin-metadata?

在项目目录运行 npm install @embedpdf/plugin-metadata,或使用 pnpm add / yarn add / bun add。

@embedpdf/plugin-metadata 支持 TypeScript 吗?

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

@embedpdf/plugin-metadata 支持 ESM 还是 CommonJS?

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

@embedpdf/plugin-metadata 可以商用吗?

@embedpdf/plugin-metadata 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@embedpdf/plugin-metadata 的下载量有多少?

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

@embedpdf/plugin-metadata 还在维护吗?

最新版本 3.2.0 发布于 2026/11/12(1 天前);至今共发布 27 个版本,其中过去 12 个月发布了 27 个;首次发布于 2026/08/06。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。