此软件包提供可复用的字段定义,用于在 WordPress DataViews 中显示和编辑媒体附件属性。它主要用于 Gutenberg 内部,并且可能在各个版本之间发生重大变化。

用法

可用字段

此软件包导出常见媒体附件属性的字段定义:

  • altTextField – 图像的替代文本
  • captionField – 媒体说明文本
  • descriptionField – 详细描述
  • filenameField – 文件名(只读)
  • filesizeField – 以人类可读格式显示的文件大小
  • mediaDimensionsField – 图像尺寸(宽 × 高)
  • mediaThumbnailField – 缩略图预览
  • mimeTypeField – MIME 类型显示

在 DataViews 中使用媒体字段

import {
    altTextField,
    captionField,
    filesizeField,
} from '@wordpress/media-fields';
import { DataViews } from '@wordpress/dataviews';

const fields = [
    altTextField,
    captionField,
    filesizeField,
];

export function MyMediaLibrary( { items } ) {
    return (
        <DataViews
            data={ items }
            fields={ fields }
            view={ view }
            onChangeView={ setView }
        />
    );
}

为此软件包做贡献

此软件包是 Gutenberg 项目的一部分。要了解有关为此软件包或整个 Gutenberg 做贡献的更多信息,请阅读项目的主要贡献者指南。