如何获取Wix媒体文件夹内所有图片的URL和名称列表
Wix平台获取媒体文件URL/名称列表并关联Content Manager的实现方案
1. 获取媒体库所有图片的元数据
你可以直接调用Wix官方内置的wix-media.v2后端接口拉取全量图片的名称、URL等信息,无需使用第三方工具。
实现步骤:
- 在Wix后台的「开发者」板块中创建后端代码文件(后缀为
.jsw,例如backend/mediaUtils.jsw) - 调用
listFiles方法筛选拉取所有图片类型的媒体文件,支持分页拉取避免数据遗漏,代码示例如下:
import { media } from 'wix-media.v2'; export async function getFullImageList() { const allImages = []; let nextPageToken = undefined; do { // 拉取当前页图片数据 const res = await media.files.listFiles({ paging: { token: nextPageToken }, parentFolderId: 'media-root', // 填写你需要拉取的媒体文件夹ID,media-root为根目录 filter: { mediaType: 'IMAGE' } // 仅筛选图片类型,可根据需求调整筛选规则 }); allImages.push(...res.files); nextPageToken = res.paging?.nextToken; } while (nextPageToken); // 格式化返回你需要的字段 return allImages.map(img => ({ imageName: img.displayName, imageUrl: img.fileUrl })); }
如果你不需要代码实现,也可以直接打开Wix后台媒体管理器,全选目标图片后导出元数据CSV,文件内已经包含完整的文件名、访问URL字段。
2. 批量写入Content Manager关联字段
拿到图片列表后,你可以通过wix-data接口直接批量写入对应数据集,完成数据记录和图片的关联:
- 提前在Content Manager中创建对应数据集,新增两个字段:
图片名称(文本类型)、关联图片(图片类型) - 编写批量写入代码,示例如下:
import { getFullImageList } from 'backend/mediaUtils.jsw'; import wixData from 'wix-data'; async function batchBindImageToDataset() { const imageList = await getFullImageList(); // 映射到数据集字段 const insertData = imageList.map(item => ({ 图片名称: item.imageName, 关联图片: item.imageUrl // 图片类型字段直接传入URL即可自动识别 })); // 替换为你自己的数据集ID,执行批量插入 const result = await wixData.bulkInsert('你的数据集ID', insertData); console.log(`批量写入完成,成功插入${result.inserted}条数据`); }
注意事项
- 单批次调用
bulkInsert最多支持写入1000条数据,若图片数量超过上限可自行拆分批次执行 - 全量写入前建议先插入3-5条测试数据,确认字段映射、图片关联逻辑无误后再执行全量操作
- 若你需要手动导入,可直接使用之前导出的CSV文件,在Content Manager中选择「导入数据集」即可直接完成映射,无需编写代码
内容的提问来源于stack exchange,提问作者Martin B.
相关产品推荐
相关产品推荐

