FileUpload

展示文件列表、状态和移除操作。

实时预览

正在加载预览…

参数配置

标题 label禁用 disabled否颜色 color尺寸 size允许移除 remove

全部字段 20

FileUploadOptions

Label

Description

ChooseLabel

Disabled

Dropzone

Interactive

FileDelete

Preview

Variant

Layout

Color

Size

Rules

UploadRules

Accept

列表项 · 0

MaxBytes

MaxFiles

Dialog

mygo.OpenDialogOptions

Parent

Title

DefaultPath

ButtonLabel

Message

Filters

列表项 · 0

Directory

Multiple

ShowHiddenFiles

CreateDirectories

TreatPackagesAsDirectories

Choose

OnChange

OnCancel

OnRemove

UI

Styles · 0

Style

Go 代码

// Inside a view; c is *ui.Context, t is nui.Theme.
// Keep s (example state) outside the view. See the complete example.
nui.FileUpload(c.Key("files"), t, &s.Files, nui.FileUploadOptions{Label: "Project files", Description: "Sample files; no network upload", Disabled: false, Interactive: nui.Set(false), FileDelete: nui.Optional[bool]{}, Color: nui.ColorDefault, Size: nui.SizeDefault})

使用说明

这里展示预置文件及删除操作，重置可以恢复列表。浏览器后端暂不提供原生文件选择框，因此示例显式关闭 Interactive；桌面程序可结合选择、任务进度和自己的上传逻辑使用。

参数与平台说明

浏览器不支持 MyGo 原生文件选择框。本示例提供预置文件与移除操作，不发起上传；文件选择与上传需由应用接入。

API 参考

FileUpload

源码

func FileUpload(c *ui.Context, t Theme, s *FileUploadState, o FileUploadOptions) ui.Element

FileUploadOptions

源码

type FileUploadOptions struct {
	Label, Description, ChooseLabel            string
	Disabled                                   bool
	Dropzone, Interactive, FileDelete, Preview Optional[bool]
	Variant                                    UploadVariant
	Layout                                     UploadLayout
	Color                                      Color
	Size                                       Size
	Rules                                      UploadRules
	Dialog                                     mygo.OpenDialogOptions
	// Choose overrides the native dialog. It executes on a worker and must not mutate UI state.
	Choose             func(context.Context) ([]UploadFile, error)
	OnChange           func([]UploadFile)
	OnCancel, OnRemove func(string)
	Decoration
}

字段	类型	说明
`Label`	`string` Go 零值: `""`	控件标签或可访问名称。
`Description`	`string` Go 零值: `""`	补充说明文字。
`ChooseLabel`	`string` Go 零值: `""`	文件选择操作的文字。
`Disabled`	`bool` Go 零值: `false`	禁用组件及其交互。
`Dropzone`	`Optional[bool]` Go 零值: `unset`	显示文件拖放区域。
`Interactive`	`Optional[bool]` Go 零值: `unset`	允许文件选择交互。
`FileDelete`	`Optional[bool]` Go 零值: `unset`	显示文件移除操作。
`Preview`	`Optional[bool]` Go 零值: `unset`	显示文件预览信息。
`Variant`	`UploadVariant` Go 零值: `zero value`	组件外观样式，支持范围取决于组件。
`Layout`	`UploadLayout` Go 零值: `zero value`	文件列表的布局方式。
`Color`	`Color` Go 零值: `ColorDefault`	语义颜色；默认值继承主题或组件配色。
`Size`	`Size` Go 零值: `SizeDefault`	组件尺寸；默认值继承主题或组件尺寸。
`Rules`	`UploadRules` Go 零值: `zero value`	文件数量、类型和大小检查规则。
`Dialog`	`mygo.OpenDialogOptions` Go 零值: `zero value`	原生文件选择框的配置。
`Choose`	`func(context.Context) ([]UploadFile, error)` Go 零值: `nil`	后台执行的文件选择函数；不要直接修改 UI 状态。
`OnChange`	`func([]UploadFile)` Go 零值: `nil`	值发生变化时通知应用的回调。
`OnCancel`	`func(string)` Go 零值: `nil`	取消任务时通知应用的回调。
`OnRemove`	`func(string)` Go 零值: `nil`	移除项目时通知应用的回调。
`UI`	`Styles` Go 零值: `zero value`	以部件名称为键覆盖外观和间距。
`Style`	`func(Slot, ui.Element)` Go 零值: `nil`	同步配置当前构建的部件；不要保留 Element。