تا اینجا با مبانی Blazor آشنا شدیم. در این قسمت میخواهیم مثالی را بررسی کنیم که بسیاری از این مفاهیم ابتدایی را پوشش میدهد. برای نمونه میخواهیم یک کامپوننت modal بوت استرپی را جهت دریافت تائیدیهی حذف اتاقهای تعریف شدهی در مثال این سری نمایش دهیم که به همراه مفاهیمی است مانند فرگمنتها جهت تعیین محتوای نمایشی مودال به صورت پویا، ارسال نتیجهی انتخاب بله یا خیر از کامپوننت دریافت تائید، به کامپوننت والد، ارسال پارامترها به کامپوننت فرزند جهت نمایش عنوان و فراخوانی متدهای نمایش و مخفی کردن وهلهای از کامپوننت مودال، در کامپوننت والد؛ بدون یک سطر کدنویسی جاوا اسکریپتی!
مرور مثال این قسمت
تا اینجا در مثالی که بررسی کردیم، لیست اتاقها توسط کامپوننت IndividualRoom.razor و لیست خدمات رفاهی یک هتل توسط کامپوننت IndividualAmenity.razor در کامپوننت والد DemoHotel.razor، نمایش داده شدهاند:
دکمههای حذف و ویرایش هر اتاق نیز در کامپوننت EditDeleteButton.razor قرار دارند که توسط کامپوننت IndividualRoom.razor مورد استفاده قرار میگیرند.
اکنون میخواهیم با کلیک بر روی دکمهی حذف کامپوننت EditDeleteButton، یک modal بوت استرپی جهت دریافت تائیدیهی عملیات، نمایش داده شود و در صورت تائید آن، اتاق انتخابی از لیست اتاقهای کامپوننت DemoHotel حذف گردد.
بنابراین در ابتدا کامپوننت EditDeleteButton، به کامپوننت IndividualRoom خبر درخواست حذف یک اتاق را میدهد. سپس کامپوننت IndividualRoom، یک مودال دریافت تائیدیهی حذف را نمایش میدهد. پس از تائید حذف توسط کاربر، این رویداد به کامپوننت DemoHotel، جهت حذف اتاق انتخابی از لیست اتاقها، اطلاع رسانی خواهد شد.
ایجاد کامپوننت مودال دریافت تائید
در ابتدا، فایل جدید Pages\LearnBlazor\LearnBlazorComponents\Confirmation.razor را ایجاد کرده و به صورت زیر تکمیل میکنیم:
توضیحات:
- در اینجا در ابتدا تگها و کلاسهای مرتبط با نمایش یک modal استاندارد بوت استرپی را مشاهده میکنید.
- اگر فیلد خصوصی ShowModal به false تنظیم شود، چون کل محتوای این کامپوننت از DOM حذف خواهد شد (اثر if@ تعریف شده)، سبب مخفی شدن و عدم نمایش آن میگردد.
- این کامپوننت عنوان و برچسبهای دکمههای خودش را به صورت پارامتر دریافت میکند.
- برای اینکه بتوان محتوای نمایشی این کامپوننت را پویا کرد، از یک RenderFragment استفاده کردهایم:
- خروجی این کامپوننت به والد یا فراخوان آن، دو رویداد OnConfirm و OnCancel هستند. همچنین چون نمیخواهیم کدهای مخفی کردن modal را به ازای هربار کلیک بر روی این دکمهها فراخوانی کنیم، این رویدادها، ابتدا به دو متد خصوصی OnConfirmClicked و OnCancelClicked متصل شدهاند، تا کار مخفی سازی و سپس هدایت این رویدادها را به کامپوننت والد انجام دهند.
- همچنین میخواهیم به کامپوننت فراخوان این امکان را بدهیم تا بتواند به صورت مستقل، سبب نمایش یا مخفی شدن وهلهای از این کامپوننت شود. به همین جهت دو متد عمومی Show و Hide نیز تعریف شدهاند.
هدایت درخواست Delete به کامپوننت نمایش مشخصات اتاق
با توجه به اینکه دکمههای حذف و ویرایش هر اتاق، در کامپوننت Pages\LearnBlazor\LearnBlazorComponents\EditDeleteButton.razor قرار دارند، به آن مراجعه کرده و امکان انتشار این رخداد را به فراخوان آن، با تعریف رویداد OnDelete میدهیم:
واکنش نشان دادن کامپوننت IndividualRoom.razor به درخواست حذف آن اتاق
کامپوننت Pages\LearnBlazor\LearnBlazorComponents\IndividualRoom.razor که نمایش دهندهی جزئیات هر اتاق است، با مدیریت رویداد OnDelete کامپوننت EditDeleteButton، از درخواست حذف اتاق جاری مطلع میشود:
- در اینجا در ابتدا کامپوننت جدید Confirmation را مورد استفاده قرار داده و برای مثال محتوای «آیا میخواهید این اتاق را حذف کنید؟»، به صورت پویا به آن ارسال میکنیم که در این کامپوننت، توسط فرگمنت مرتبطی نمایش داده میشود.
- سپس نیاز است زمانیکه OnDelete کامپوننت EditDeleteButton رخداد، این modal دریافت تائید را نمایش دهیم. به همین جهت باید بتوانیم متد عمومی Show آنرا فراخوانی کنیم. بنابراین از ref@ برای دسترسی به وهلهای از این کامپوننت تعریف شده استفاده کردهایم تا توسط شیء Confirmation1، بتوانیم متد عمومی Show را در رویدادگردان منتسب به OnDelete فراخوانی کنیم.
- همچنین دو رویداد OnCancel و OnConfirm کامپوننت دریافت تائید را به متد خصوصی OnCancelClicked و رویداد جدید OnDeleteSelectedRoom متصل کردهایم. یعنی زمانیکه کاربر بر روی دکمهی OK مودال ظاهر شده کلیک میکند، Room جاری، از طریق رویداد OnDeleteSelectedRoom به فراخوان کامپوننت IndividualRoom ارسال میشود تا دقیقا بداند که چه اتاقی را بایدحذف کند:
بنابراین کامپوننت IndividualRoom، یک شیء Room را از والد خود دریافت کرده و مشخصات آنرا نمایش میدهد. همچنین پس از تائید حذف این اتاق، آنرا از طریق رویداد جدید OnDeleteSelectedRoom به والد خود اطلاع رسانی میکند.
حذف اتاق انتخابی در کامپوننت نمایش لیست اتاقها
مرحلهی آخر این مثال، بسیار سادهاست. در حلقهای که هر اتاق را توسط کامپوننت IndividualRoom نمایش میدهد، به رویداد OnDeleteSelectedRoom گوش فرا داده و selectedRoom یا همان BlazorRoom ارسالی را، دریافت و از لیست Rooms کامپوننت جاری حذف میکنیم. این حذف شدن، بلافاصله سبب رندر مجدد UI و حذف آن از رابط کاربری نیز خواهد شد:
کدهای کامل این مطلب را از اینجا میتوانید دریافت کنید: Blazor-5x-Part-12.zip
مرور مثال این قسمت
تا اینجا در مثالی که بررسی کردیم، لیست اتاقها توسط کامپوننت IndividualRoom.razor و لیست خدمات رفاهی یک هتل توسط کامپوننت IndividualAmenity.razor در کامپوننت والد DemoHotel.razor، نمایش داده شدهاند:
دکمههای حذف و ویرایش هر اتاق نیز در کامپوننت EditDeleteButton.razor قرار دارند که توسط کامپوننت IndividualRoom.razor مورد استفاده قرار میگیرند.
اکنون میخواهیم با کلیک بر روی دکمهی حذف کامپوننت EditDeleteButton، یک modal بوت استرپی جهت دریافت تائیدیهی عملیات، نمایش داده شود و در صورت تائید آن، اتاق انتخابی از لیست اتاقهای کامپوننت DemoHotel حذف گردد.
بنابراین در ابتدا کامپوننت EditDeleteButton، به کامپوننت IndividualRoom خبر درخواست حذف یک اتاق را میدهد. سپس کامپوننت IndividualRoom، یک مودال دریافت تائیدیهی حذف را نمایش میدهد. پس از تائید حذف توسط کاربر، این رویداد به کامپوننت DemoHotel، جهت حذف اتاق انتخابی از لیست اتاقها، اطلاع رسانی خواهد شد.
ایجاد کامپوننت مودال دریافت تائید
در ابتدا، فایل جدید Pages\LearnBlazor\LearnBlazorComponents\Confirmation.razor را ایجاد کرده و به صورت زیر تکمیل میکنیم:
@if (ShowModal) { <div class="modal-backdrop show"></div> <div class="modal fade show" id="exampleModal" tabindex="-1" role="dialog" aria-labelledby="exampleModalLabel" aria-hidden="true" style="display: block;"> <div class="modal-dialog" role="document"> <div class="modal-content"> <div class="modal-header"> <h5 class="modal-title"> @Title </h5> <button @onclick="OnCancelClicked" type="button" class="close"> <span aria-hidden="true">×</span> </button> </div> <div class="modal-body"> @ChildContent </div> <div class="modal-footer"> <button @onclick="OnCancelClicked" type="button" class="btn btn-secondary">@CancelButtonLabel</button> <button @onclick="OnConfirmClicked" type="button" class="btn btn-primary">@OkButtonLabel</button> </div> </div> </div> </div> } @code { private bool ShowModal; [Parameter] public string Title { get; set; } = "Confirm"; [Parameter] public string CancelButtonLabel { get; set; } = "Cancel"; [Parameter] public string OkButtonLabel { get; set; } = "Ok"; [Parameter] public RenderFragment ChildContent { get; set; } [Parameter] public EventCallback OnConfirm { get; set; } [Parameter] public EventCallback OnCancel { get; set; } public void Show() => ShowModal = true; public void Hide() => ShowModal = false; private async Task OnConfirmClicked() { ShowModal = false; await OnConfirm.InvokeAsync(); } private async Task OnCancelClicked() { ShowModal = false; await OnCancel.InvokeAsync(); } }
- در اینجا در ابتدا تگها و کلاسهای مرتبط با نمایش یک modal استاندارد بوت استرپی را مشاهده میکنید.
- اگر فیلد خصوصی ShowModal به false تنظیم شود، چون کل محتوای این کامپوننت از DOM حذف خواهد شد (اثر if@ تعریف شده)، سبب مخفی شدن و عدم نمایش آن میگردد.
- این کامپوننت عنوان و برچسبهای دکمههای خودش را به صورت پارامتر دریافت میکند.
- برای اینکه بتوان محتوای نمایشی این کامپوننت را پویا کرد، از یک RenderFragment استفاده کردهایم:
[Parameter] public RenderFragment ChildContent { get; set; }
- همچنین میخواهیم به کامپوننت فراخوان این امکان را بدهیم تا بتواند به صورت مستقل، سبب نمایش یا مخفی شدن وهلهای از این کامپوننت شود. به همین جهت دو متد عمومی Show و Hide نیز تعریف شدهاند.
هدایت درخواست Delete به کامپوننت نمایش مشخصات اتاق
با توجه به اینکه دکمههای حذف و ویرایش هر اتاق، در کامپوننت Pages\LearnBlazor\LearnBlazorComponents\EditDeleteButton.razor قرار دارند، به آن مراجعه کرده و امکان انتشار این رخداد را به فراخوان آن، با تعریف رویداد OnDelete میدهیم:
@if (IsAdmin) { <input type="button" class="btn btn-danger" value="Delete" @onclick="OnDelete" /> <input type="button" class="btn btn-success" value="Edit" /> } @code { [Parameter] public bool IsAdmin { get; set; } [Parameter] public EventCallback OnDelete { get; set; } }
کامپوننت Pages\LearnBlazor\LearnBlazorComponents\IndividualRoom.razor که نمایش دهندهی جزئیات هر اتاق است، با مدیریت رویداد OnDelete کامپوننت EditDeleteButton، از درخواست حذف اتاق جاری مطلع میشود:
<EditDeleteButton IsAdmin="true" OnDelete="OnDeleteClicked"></EditDeleteButton> <Confirmation @ref="Confirmation1" OnCancel="OnCancelClicked" OnConfirm="@(() => OnDeleteSelectedRoom.InvokeAsync(Room))"> <div> Do you want to delete `@Room.Name`? </div> </Confirmation>
- سپس نیاز است زمانیکه OnDelete کامپوننت EditDeleteButton رخداد، این modal دریافت تائید را نمایش دهیم. به همین جهت باید بتوانیم متد عمومی Show آنرا فراخوانی کنیم. بنابراین از ref@ برای دسترسی به وهلهای از این کامپوننت تعریف شده استفاده کردهایم تا توسط شیء Confirmation1، بتوانیم متد عمومی Show را در رویدادگردان منتسب به OnDelete فراخوانی کنیم.
- همچنین دو رویداد OnCancel و OnConfirm کامپوننت دریافت تائید را به متد خصوصی OnCancelClicked و رویداد جدید OnDeleteSelectedRoom متصل کردهایم. یعنی زمانیکه کاربر بر روی دکمهی OK مودال ظاهر شده کلیک میکند، Room جاری، از طریق رویداد OnDeleteSelectedRoom به فراخوان کامپوننت IndividualRoom ارسال میشود تا دقیقا بداند که چه اتاقی را بایدحذف کند:
@code { Confirmation Confirmation1; [Parameter] public BlazorRoom Room { get; set; } [Parameter] public EventCallback<BlazorRoom> OnDeleteSelectedRoom { get; set; } void OnDeleteClicked() { Confirmation1.Show(); } void OnCancelClicked() { // Confirmation1.Hide(); } // ... }
حذف اتاق انتخابی در کامپوننت نمایش لیست اتاقها
مرحلهی آخر این مثال، بسیار سادهاست. در حلقهای که هر اتاق را توسط کامپوننت IndividualRoom نمایش میدهد، به رویداد OnDeleteSelectedRoom گوش فرا داده و selectedRoom یا همان BlazorRoom ارسالی را، دریافت و از لیست Rooms کامپوننت جاری حذف میکنیم. این حذف شدن، بلافاصله سبب رندر مجدد UI و حذف آن از رابط کاربری نیز خواهد شد:
@foreach (var room in Rooms) { <IndividualRoom OnRoomCheckBoxSelection="RoomSelectionCounterChanged" Room="room" OnDeleteSelectedRoom="@(selectedRoom => Rooms.Remove(selectedRoom))"> </IndividualRoom> }
کدهای کامل این مطلب را از اینجا میتوانید دریافت کنید: Blazor-5x-Part-12.zip