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:
@@ -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>
|
||||||
|
|||||||
@@ -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>
|
||||||
|
|||||||
@@ -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>
|
||||||
|
|||||||
@@ -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();
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -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;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -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;
|
||||||
}
|
}
|
||||||
|
|||||||
Reference in New Issue
Block a user