Tham chiếu đầy đủ events

Cấu hình Component.Events JSON map {<event>: <method>}. Quy tắc: DOM event lowercase, CustomEventType PascalCase. Xem Cấu hình UI → Events cho cú pháp.

A. DOM Events (EventType.*)

Viết lowercase trong JSON — vd "click": "OnClick".

Mouse / Click

Keyboard

Form / Input

input vs change — dùng input khi cần realtime (autocomplete suggestion); dùng change khi chỉ cần phản ứng sau khi user đã hoàn thành nhập.

Focus

Scroll / Visibility / Resize

Lifecycle

Print / Window

B. Custom Events (CustomEventType.*)

Viết PascalCase y hệt enum trong JSON — vd "AfterCreated": "OnRowAdded".

Lifecycle row trong List/Grid

Lifecycle update / patch

Delete / Copy / Paste

Selection / Pointer trong row

Metadata / sync

Save / Download / Report

Search / Date

AI / Chat

Cheat sheet — chọn event nào?

Method signature pattern

Tất cả method nhận object entity làm tham số đầu, args sau tùy event. Xem Tham chiếu component để biết chính xác từng signature.

public class MyFormBL : TabEditor
{
    public MyFormBL() : base(nameof(MyEntity)) { }

    // DOM event
    public void OnClicked(object entity, object btn) { /* ... */ }
    public async Task OnValueChanged(object entity, object newVal, object oldVal, object parent) { /* ... */ }

    // CustomEventType
    public void OnRowAdded(object rowData) { /* ... */ }
    public async Task OnBeforeDelete(object deletedItems) { /* ... */ }
    public void OnAfterChat(object taskComment, object result, object timeLine) { /* ... */ }
}

Bẫy hay gặp

• Sai case — "Click" (capitalize) thay vì "click" (lowercase) → method không bao giờ chạy. Tương tự "aftercreated" (lowercase) thay vì "AfterCreated" (PascalCase) → không chạy.
• Method tên không khớp — case-sensitive. OnClick ≠ onClick.
• Tham số không khớp số args — method declare 2 args mà event pass 4 → 2 args còn lại bị bỏ silently. Khai báo theo bảng Tham chiếu component.
• Async method không return Task — async void chạy được nhưng exception bị nuốt. Dùng async Task<bool> hoặc async Task để Core await đúng cách.