<Cthuvien:ckb>
thông tin
Controls thay thế: BSSCheckBox
Mô tả
Cthuvien:ckb là một control checkbox (sinh thẻ <input type="checkbox" >). Control này bổ sung thêm các thuộc tính dùng để quản lý trạng thái xóa form (kt_xoa), khởi tạo giá trị (gtriDau), đồng thời tự động tự tích hợp với cơ chế GridX ở client-side (thông qua việc bind sự kiện onblur, onfocus, onchange) nếu control có khai báo class dành cho grid (css_G...).
Thuộc tính
Thuộc tính chung
| Tên | Kiểu | Mặc định | Có thể có | Mục đích | Thuộc tính mới | Ghi chú |
|---|---|---|---|---|---|---|
| Checked | bool | false | true / false | Trạng thái tích hoặc không tích của Checkbox | ||
| kt_xoa | string | "K" | K: không bao giờ xóa, G: dùng cho mã, L: dùng cho một số thông tin đến mã nhưng vẫn cần giữ khi làm mới form, X: cứ làm mới form là xóa | Đánh dấu cấu hình có làm mới/xóa trạng thái khi reset form hay không | ||
| gtriDau | string | "" | C/K | Giá trị khởi tạo ban đầu | ||
| nhap | bool | true | true / false | Đánh dấu ấn nhập có lấy thông tin hay không (C/K) | Nếu checkbox đặt trong lưới css_G... thì cờ này tự động gán là K |
Khởi tạo
Trong OnPreRender, control thực hiện tuần tự:
- Gán
ten_goc = IDvàtenKieu = "ckb"lên thẻ HTML. - Nếu
gtriDaucó giá trị, gán attributegtriDaulên thẻ. - Gán
kt_xoalên thẻ. - Kiểm tra
class: nếu bắt đầu bằngcss_G(đang nằm trong lưới GridX), tự động gán các sự kiện lưới và épnhap = "K". Ngược lại, gánnhaptheo giá trị thuộc tính.
Attributes render ra client:
| Attribute | Giá trị | Mô tả |
|---|---|---|
ten_goc | ID | ID gốc của control |
tenKieu | "ckb" | Xác định loại control |
kt_xoa | Giá trị kt_xoa | Cơ chế xóa/làm mới |
gtriDau | Giá trị gtriDau | Giá trị mặc định (chỉ khi có) |
nhap | "C" / "K" | Có lấy thông tin khi nhập hay không |
Khi nằm trong lưới (css_G...), bổ sung thêm:
| Attribute | Giá trị |
|---|---|
onblur | "GridX_doiMauBF(event);" |
onfocus | "GridX_doiMauBF(event);" |
onchange | "GridX_hamUp(event)" |
Ví dụ
Khai báo thông thường:
<Cthuvien:ckb ID="chkHoatDong" runat="server" nhap="true" kt_xoa="K" gtriDau="C" />
Mã HTML sinh ra (Client):
<input type="checkbox" id="ctl00_MainContent_chkHoatDong" ten_goc="chkHoatDong" tenKieu="ckb" kt_xoa="K" gtriDau="C" nhap="C" />
Khai báo trong lưới GridX:
<Cthuvien:ckb ID="chkChon" runat="server" class="css_Gckb" kt_xoa="K" />
Mã HTML sinh ra (Client):
<input type="checkbox" id="ctl00_MainContent_chkChon" class="css_Gckb" ten_goc="chkChon" tenKieu="ckb" kt_xoa="K" nhap="K"
onblur="GridX_doiMauBF(event);"
onfocus="GridX_doiMauBF(event);"
onchange="GridX_hamUp(event)" />