← All Components
<mth-upload-progress>
File upload progress row displaying filename, size, CSP-safe adopted stylesheet progress bar, pause/resume/cancel/retry controls, and accessible progressbar state.
When NOT to use: Use a lightweight @methane-ui/css layout class instead of a custom element when static CSS suffices.
Live Interactive Preview
Ready · interact with <mth-upload-progress>, or toggle Theme, Direction (LTR/RTL), or props above.
Multi-Framework Playground & Snippets
<script type="module" src="@methane-ui/ui/upload-progress"></script>
<mth-upload-progress value="0" size="0"></mth-upload-progress>import '@methane-ui/ui/upload-progress';
import '@methane-ui/react';
export function Example() {
return <mth-upload-progress value="0" size="0"></mth-upload-progress>;
}<script setup lang="ts">
import '@methane-ui/ui/upload-progress';
</script>
<template>
<mth-upload-progress value="0" size="0"></mth-upload-progress>
</template>import { Component, CUSTOM_ELEMENTS_SCHEMA } from '@angular/core';
import '@methane-ui/ui/upload-progress';
import { MthUploadProgressDirective } from '@methane-ui/angular';
@Component({
standalone: true,
schemas: [CUSTOM_ELEMENTS_SCHEMA],
imports: [MthUploadProgressDirective],
template: `<mth-upload-progress value="0" size="0"></mth-upload-progress>`,
})
export class ExampleComponent {}<script lang="ts">
import '@methane-ui/ui/upload-progress';
import MthUploadProgress from '@methane-ui/svelte/MthUploadProgress.svelte';
</script>
<MthUploadProgress value="0" size="0"></MthUploadProgress>Properties & Attributes
| Property | Attribute | Type | Default | Description |
|---|---|---|---|---|
filename | filename | string | "" | Display name of the uploading file. |
value | value | number | 0 | Percentage complete between 0 and 100. |
size | size | number | 0 | Optional file size in bytes. |
status | status | 'queued' | 'uploading' | 'paused' | 'complete' | 'error' | "queued" | Transfer status (queued, uploading, paused, complete, or error). |
errorMessage | error-message | string | "" | Error description displayed when status="error". |
pausable | pausable | boolean | true | Enables pause/resume controls while uploading or paused. |
cancellable | cancellable | boolean | true | Enables the cancel button while not yet complete. |
Events
| Event | Detail Type | Description |
|---|---|---|
mth-pause | undefined | Fired when pausing an active upload. |
mth-resume | undefined | Fired when resuming a paused upload. |
mth-cancel | undefined | Fired when cancelling the upload. |
mth-retry | undefined | Fired when retrying a failed upload. |
Accessibility Checklist
| Category | Requirement | Verified By |
|---|---|---|
| aria | All aria-* IDREFs resolve within the same DOM root (ADR-003). | scanSameRootAria |
| focus | Focus ownership matches focusModel="none". | lint-plugin & spec-compiler |
| contrast | Renders legible borders, focus outlines, and selection indicators under forced-colors: active. | Playwright forced-colors matrix |
| states | Exposes ElementInternals CustomStateSet flags: :state(queued), :state(uploading), :state(paused), :state(complete), :state(error). | Conformance suite |
| i18n | Routes 10 UI/ARIA strings through @methane-ui/core i18n catalog. | Locale context test |