Improve document upload UX and refactor wizard layout

Enhanced the `CreateEnvelopeWizardPopup` component:
- Added a new grid layout (`sender-create-wizard__body-layout`) to separate main content and side panel.
- Introduced a collapsible side panel for document upload and preview.
- Replaced old upload logic with `PdfFileDropZone` and added support for displaying document metadata (name, size) and replacement hints.
- Added asynchronous document preview rendering with `EnsureDocumentPreviewPreparedAsync`.

Localization updates:
- Added new localized strings for document upload hints in `de-DE`, `en-US`, and `fr-FR`.

CSS updates:
- Styled the new layout and side panel with transitions.
- Updated `PdfFileDropZone` styles for different states (e.g., document uploaded).

Refactored code for better maintainability and improved user feedback during document upload and preview preparation.
This commit is contained in:
2026-11-10 19:29:33 +01:00
parent c6fe7722b4
commit b65098fafb
6 changed files with 502 additions and 348 deletions

View File

@@ -778,6 +778,8 @@
<data name="SignedDocument" xml:space="preserve"><value>Signiertes Dokument</value></data> <data name="SignedDocument" xml:space="preserve"><value>Signiertes Dokument</value></data>
<data name="System" xml:space="preserve"><value>System</value></data> <data name="System" xml:space="preserve"><value>System</value></data>
<data name="SenderWizard_Step_Start" xml:space="preserve"><value>Start</value></data> <data name="SenderWizard_Step_Start" xml:space="preserve"><value>Start</value></data>
<data name="SenderWizard_DocumentUploadSimpleHint" xml:space="preserve"><value>Dokument hinzufuegen: klicken oder per Drag-and-Drop ablegen</value></data>
<data name="SenderWizard_DocumentReplaceHint" xml:space="preserve"><value>Zum Ersetzen klicken oder eine Datei auf diese Flaeche ziehen.</value></data>
<data name="UnexpectedErrorTryAgainLater" xml:space="preserve"><value>Ein unerwarteter Fehler ist aufgetreten. Bitte versuchen Sie es später erneut.</value></data> <data name="UnexpectedErrorTryAgainLater" xml:space="preserve"><value>Ein unerwarteter Fehler ist aufgetreten. Bitte versuchen Sie es später erneut.</value></data>
<data name="UploadPdf" xml:space="preserve"><value>PDF hochladen</value></data> <data name="UploadPdf" xml:space="preserve"><value>PDF hochladen</value></data>
<data name="UserName" xml:space="preserve"><value>Benutzername</value></data> <data name="UserName" xml:space="preserve"><value>Benutzername</value></data>

View File

@@ -778,6 +778,8 @@
<data name="SignedDocument" xml:space="preserve"><value>Signed document</value></data> <data name="SignedDocument" xml:space="preserve"><value>Signed document</value></data>
<data name="System" xml:space="preserve"><value>System</value></data> <data name="System" xml:space="preserve"><value>System</value></data>
<data name="SenderWizard_Step_Start" xml:space="preserve"><value>Start</value></data> <data name="SenderWizard_Step_Start" xml:space="preserve"><value>Start</value></data>
<data name="SenderWizard_DocumentUploadSimpleHint" xml:space="preserve"><value>Add document: click or drag and drop</value></data>
<data name="SenderWizard_DocumentReplaceHint" xml:space="preserve"><value>Click to replace or drag a file onto this area.</value></data>
<data name="UnexpectedErrorTryAgainLater" xml:space="preserve"><value>An unexpected error occurred. Please try again later.</value></data> <data name="UnexpectedErrorTryAgainLater" xml:space="preserve"><value>An unexpected error occurred. Please try again later.</value></data>
<data name="UploadPdf" xml:space="preserve"><value>Upload PDF</value></data> <data name="UploadPdf" xml:space="preserve"><value>Upload PDF</value></data>
<data name="UserName" xml:space="preserve"><value>Username</value></data> <data name="UserName" xml:space="preserve"><value>Username</value></data>

View File

@@ -778,6 +778,8 @@
<data name="SignedDocument" xml:space="preserve"><value>Document signé</value></data> <data name="SignedDocument" xml:space="preserve"><value>Document signé</value></data>
<data name="System" xml:space="preserve"><value>Système</value></data> <data name="System" xml:space="preserve"><value>Système</value></data>
<data name="SenderWizard_Step_Start" xml:space="preserve"><value>Démarrer</value></data> <data name="SenderWizard_Step_Start" xml:space="preserve"><value>Démarrer</value></data>
<data name="SenderWizard_DocumentUploadSimpleHint" xml:space="preserve"><value>Ajouter un document : cliquer ou glisser-deposer</value></data>
<data name="SenderWizard_DocumentReplaceHint" xml:space="preserve"><value>Cliquez pour remplacer ou glissez un fichier sur cette zone.</value></data>
<data name="UnexpectedErrorTryAgainLater" xml:space="preserve"><value>Une erreur inattendue s'est produite. Veuillez réessayer plus tard.</value></data> <data name="UnexpectedErrorTryAgainLater" xml:space="preserve"><value>Une erreur inattendue s'est produite. Veuillez réessayer plus tard.</value></data>
<data name="UploadPdf" xml:space="preserve"><value>Téléverser un PDF</value></data> <data name="UploadPdf" xml:space="preserve"><value>Téléverser un PDF</value></data>
<data name="UserName" xml:space="preserve"><value>Nom d'utilisateur</value></data> <data name="UserName" xml:space="preserve"><value>Nom d'utilisateur</value></data>

View File

@@ -28,6 +28,7 @@
<div class="sender-create-wizard" <div class="sender-create-wizard"
tabindex="0" tabindex="0"
@onkeydown="OnWizardKeyDownAsync"> @onkeydown="OnWizardKeyDownAsync">
<div class="sender-create-wizard__body-layout @(_currentStep == 4 ? "sender-create-wizard__body-layout--document" : string.Empty)">
<MudPaper Class="sender-create-wizard__stepper-shell" Elevation="0"> <MudPaper Class="sender-create-wizard__stepper-shell" Elevation="0">
<MudStepper Vertical="true" <MudStepper Vertical="true"
NonLinear="false" NonLinear="false"
@@ -51,6 +52,8 @@
@if (stepIndex == _currentStep) @if (stepIndex == _currentStep)
{ {
<div class="sender-create-wizard__step-content"> <div class="sender-create-wizard__step-content">
<div class="sender-create-wizard__step-layout">
<div class="sender-create-wizard__step-main">
@if (_currentStep == 0) @if (_currentStep == 0)
{ {
<div class="sender-create-wizard__form-grid"> <div class="sender-create-wizard__form-grid">
@@ -403,6 +406,8 @@
</div> </div>
} }
</div> </div>
</div>
</div>
} }
</MudStep> </MudStep>
} }
@@ -410,6 +415,18 @@
</MudStepper> </MudStepper>
</MudPaper> </MudPaper>
<aside class="sender-create-wizard__wizard-side @(_currentStep == 4 ? "sender-create-wizard__wizard-side--hidden" : string.Empty)" aria-hidden="@(_currentStep == 4)">
<PdfFileDropZone Disabled="@IsActionLocked"
HasDocument="@(_documentBytes is { Length: > 0 })"
DocumentName="@_documentFileName"
DocumentSizeText="@_documentSizeText"
UploadText='@L("SenderWizard_DocumentUploadSimpleHint", "Dokument hinzufuegen: klicken oder per Drag-and-Drop ablegen")'
ReplaceText='@L("SenderWizard_DocumentUploadSimpleHint", "Dokument hinzufuegen: klicken oder per Drag-and-Drop ablegen")'
UploadedHintText='@L("SenderWizard_DocumentReplaceHint", "Zum Ersetzen klicken oder eine Datei auf diese Fläche ziehen.")'
FileSelected="OnDocumentSelectedAsync" />
</aside>
</div>
@if (!string.IsNullOrWhiteSpace(_validationMessage)) @if (!string.IsNullOrWhiteSpace(_validationMessage))
{ {
<div class="sender-create-wizard__validation">@_validationMessage</div> <div class="sender-create-wizard__validation">@_validationMessage</div>
@@ -507,6 +524,7 @@
private int _documentPreviewPageCount; private int _documentPreviewPageCount;
private List<PdfPageImageDto> _documentPreviewPages = []; private List<PdfPageImageDto> _documentPreviewPages = [];
private bool _isDocumentUploading; private bool _isDocumentUploading;
private bool _isDocumentPreviewPrepared;
private bool _isStepActionRunning; private bool _isStepActionRunning;
private bool _isFinishing; private bool _isFinishing;
@@ -736,22 +754,12 @@
_documentBytes = ms.ToArray(); _documentBytes = ms.ToArray();
_documentFileName = file.Name; _documentFileName = file.Name;
_documentSizeText = FormatSize(_documentBytes.Length); _documentSizeText = FormatSize(_documentBytes.Length);
_documentPreviewPages = []; _documentPreviewPages = [];
try _documentPreviewPageCount = 0;
{ _isDocumentPreviewPrepared = false;
_documentPreviewPages = (await PdfRenderService.RenderPagesAsync(_documentBytes))
.OrderBy(x => x.PageNumber)
.ToList();
}
catch
{
_documentPreviewPages = [];
}
_documentPreviewPageCount = _documentPreviewPages.Count > 0 if (_currentStep == 4)
? _documentPreviewPages.Count await EnsureDocumentPreviewPreparedAsync();
: EstimatePdfPageCount(_documentBytes) ?? 1;
} }
finally finally
{ {
@@ -792,6 +800,9 @@
if (_currentStep == 1) if (_currentStep == 1)
await EnsureRecentSuggestionsLoadedAsync(); await EnsureRecentSuggestionsLoadedAsync();
if (_currentStep == 4)
await EnsureDocumentPreviewPreparedAsync();
} }
} }
finally finally
@@ -948,6 +959,33 @@
await AddReceiver(); await AddReceiver();
} }
private async Task EnsureDocumentPreviewPreparedAsync()
{
if (_documentBytes is null || _documentBytes.Length == 0 || _isDocumentPreviewPrepared)
return;
try
{
_isDocumentUploading = true;
_documentPreviewPages = (await PdfRenderService.RenderPagesAsync(_documentBytes))
.OrderBy(x => x.PageNumber)
.ToList();
}
catch
{
_documentPreviewPages = [];
}
finally
{
_documentPreviewPageCount = _documentPreviewPages.Count > 0
? _documentPreviewPages.Count
: EstimatePdfPageCount(_documentBytes) ?? 1;
_isDocumentPreviewPrepared = true;
_isDocumentUploading = false;
}
}
private bool ValidateCurrentStep() private bool ValidateCurrentStep()
{ {
if (_currentStep == 0) if (_currentStep == 0)
@@ -1260,6 +1298,7 @@
_documentSizeText = string.Empty; _documentSizeText = string.Empty;
_documentPreviewPageCount = 0; _documentPreviewPageCount = 0;
_documentPreviewPages = []; _documentPreviewPages = [];
_isDocumentPreviewPrepared = false;
ApplyDefaultEnvelopeType(); ApplyDefaultEnvelopeType();
} }

View File

@@ -2,10 +2,24 @@
<div class="sender-pdf-dropzone @DropZoneClass"> <div class="sender-pdf-dropzone @DropZoneClass">
<div class="sender-pdf-dropzone__content"> <div class="sender-pdf-dropzone__content">
<div class="sender-pdf-dropzone__title">@CurrentActionText</div> @if (HasDocument)
@if (!string.IsNullOrWhiteSpace(DragDropHintText))
{ {
<div class="sender-pdf-dropzone__hint">@DragDropHintText</div> @if (!string.IsNullOrWhiteSpace(DocumentName))
{
<div class="sender-pdf-dropzone__doc-name">@DocumentName</div>
}
@if (!string.IsNullOrWhiteSpace(DocumentSizeText))
{
<div class="sender-pdf-dropzone__doc-size">@DocumentSizeText</div>
}
@if (!string.IsNullOrWhiteSpace(UploadedHintText))
{
<div class="sender-pdf-dropzone__hint">@UploadedHintText</div>
}
}
else if (!string.IsNullOrWhiteSpace(CurrentActionText))
{
<div class="sender-pdf-dropzone__hint">@CurrentActionText</div>
} }
</div> </div>
@@ -38,6 +52,15 @@
[Parameter] [Parameter]
public string DragDropHintText { get; set; } = "Datei hierhin ziehen oder klicken"; public string DragDropHintText { get; set; } = "Datei hierhin ziehen oder klicken";
[Parameter]
public string? DocumentName { get; set; }
[Parameter]
public string? DocumentSizeText { get; set; }
[Parameter]
public string UploadedHintText { get; set; } = "Zum Ersetzen klicken oder eine Datei hierher ziehen.";
[Parameter] [Parameter]
public EventCallback<InputFileChangeEventArgs> FileSelected { get; set; } public EventCallback<InputFileChangeEventArgs> FileSelected { get; set; }
@@ -53,6 +76,9 @@
if (Disabled) if (Disabled)
return "sender-pdf-dropzone--disabled"; return "sender-pdf-dropzone--disabled";
if (HasDocument)
return "sender-pdf-dropzone--has-document";
return _isDragActive ? "sender-pdf-dropzone--drag-active" : string.Empty; return _isDragActive ? "sender-pdf-dropzone--drag-active" : string.Empty;
} }
} }

View File

@@ -1103,6 +1103,20 @@
outline: none; outline: none;
} }
.sender-create-wizard__body-layout {
display: grid;
grid-template-columns: minmax(0, 1fr) minmax(240px, 280px);
gap: 0.85rem;
align-items: stretch;
min-height: min(66vh, 620px);
transition: grid-template-columns 220ms ease 0.2s, gap 220ms ease 0.2s;
}
.sender-create-wizard__body-layout--document {
grid-template-columns: minmax(0, 1fr) 0;
gap: 0;
}
.sender-create-wizard-popup .dxbl-popup-content { .sender-create-wizard-popup .dxbl-popup-content {
max-height: min(78vh, 760px); max-height: min(78vh, 760px);
overflow: auto; overflow: auto;
@@ -1121,6 +1135,7 @@
border-radius: 10px; border-radius: 10px;
background: rgba(126, 34, 206, 0.04); background: rgba(126, 34, 206, 0.04);
padding: 0.75rem; padding: 0.75rem;
height: 100%;
} }
.sender-create-wizard__stepper { .sender-create-wizard__stepper {
@@ -1214,6 +1229,47 @@
margin-top: 0.7rem; margin-top: 0.7rem;
} }
.sender-create-wizard__step-layout {
display: block;
}
.sender-create-wizard__step-main {
min-width: 0;
}
.sender-create-wizard__wizard-side {
min-width: 0;
max-width: 280px;
border: 1px solid rgba(126, 34, 206, 0.12);
border-radius: 10px;
background: rgba(126, 34, 206, 0.04);
padding: 0.75rem;
display: flex;
flex-direction: column;
justify-content: stretch;
opacity: 1;
transition: opacity 220ms ease 0.2s, transform 220ms ease 0.2s;
}
.sender-create-wizard__wizard-side--hidden {
opacity: 0;
transform: translateX(12px);
pointer-events: none;
}
.sender-create-wizard__body-layout--document .sender-create-wizard__wizard-side {
max-width: 0;
padding-left: 0;
padding-right: 0;
border-width: 0;
overflow: hidden;
}
.sender-create-wizard__wizard-side .sender-pdf-dropzone {
height: 100%;
min-height: 100%;
}
.sender-create-wizard__meta { .sender-create-wizard__meta {
display: flex; display: flex;
flex-direction: column; flex-direction: column;
@@ -1658,6 +1714,11 @@
box-shadow: 0 0 0 3px rgba(16, 185, 129, 0.16); box-shadow: 0 0 0 3px rgba(16, 185, 129, 0.16);
} }
.sender-pdf-dropzone--has-document {
border-color: rgba(16, 185, 129, 0.55);
background: linear-gradient(180deg, rgba(16, 185, 129, 0.16), rgba(16, 185, 129, 0.07));
}
.sender-pdf-dropzone--disabled { .sender-pdf-dropzone--disabled {
opacity: 0.55; opacity: 0.55;
cursor: not-allowed; cursor: not-allowed;
@@ -1680,6 +1741,18 @@
color: #64748b; color: #64748b;
} }
.sender-pdf-dropzone__doc-name {
font-size: 0.82rem;
font-weight: 700;
color: #065f46;
line-height: 1.25;
}
.sender-pdf-dropzone__doc-size {
font-size: 0.76rem;
color: #047857;
}
.sender-pdf-dropzone__input { .sender-pdf-dropzone__input {
position: absolute; position: absolute;
inset: 0; inset: 0;
@@ -1786,6 +1859,16 @@
width: 100%; width: 100%;
} }
.sender-create-wizard__body-layout {
grid-template-columns: 1fr;
gap: 0.7rem;
min-height: 0;
}
.sender-create-wizard__wizard-side {
max-width: none;
}
.sender-create-wizard__receiver-remove-btn { .sender-create-wizard__receiver-remove-btn {
align-self: flex-end; align-self: flex-end;
} }