更新记录

1.0.0（2026-01-23） 下载此版本

初版

平台兼容性

uni-app(4.75)

f-custom-album 自定义相册组件

概述

f-custom-album 是一个用于 读取本地图片/视频资源的自定义相册组件，支持分页加载、多选、图片/视频类型切换、预览与确认操作，适用于 uni-app 项目中需要自定义媒体选择能力的场景。

组件内部基于 这个插件的 queryMedia 函数 能力读取系统相册数据，并可按需解析真实文件路径。

功能说明

• 读取本地图片 / 视频 / 全部媒体资源
• 支持分页加载（无限滚动）
• 支持图片 / 视频类型标签切换
• 支持多选与最大选择数量限制
• 支持已选序号展示
• 支持媒体预览与确认回调
• 支持半屏或自定义高度展示
• 支持主题与布局样式自定义

Props 参数说明

Events 事件说明

使用示例

<f-custom-album
  mediaType="image"
  :maxSelect="5"
  @confirm="onConfirm"
/>

methods: {
  onConfirm({ list, selectedIds }) {
    console.log(list, selectedIds)
  }
}

适用场景

• 自定义图片/视频选择器
• 发布内容前的媒体选择
• 替代系统 chooseImage / chooseVideo 的统一方案