Giao diện
Primitive — nhập liệu
Ô nhập của form. Import từ @tasco-fe/ui, dùng như antdv.
ts
import {
CInput, CTextarea, CInputNumber, CInputSearch, CInputPassword,
CSelect, CSelectOption, CSelectOptGroup, CCheckbox, CCheckboxGroup,
CRadio, CRadioButton, CRadioGroup, CSwitch, CSlider,
CDatePicker, CRangePicker, CWeekPicker, CMonthPicker, CQuarterPicker,
CTimePicker, CTimeRangePicker, CFormItem, CUpload, CUploadDragger,
CAutoComplete, CAutoCompleteOption, CAutoCompleteOptGroup, CCascader, CTreeSelect, CTreeSelectNode,
CTransfer, CRate, CMentions, CMentionsOption, CSegmented,
} from '@tasco-fe/ui'Chọn đúng component
| Dữ liệu | Component | Ghi chú |
|---|---|---|
| Chữ ngắn | CInput | allow-clear cho ô lọc |
| Chữ dài | CTextarea | Luôn đặt :rows |
| Số đếm | CInputNumber | :min, :max; thêm style="width: 100%" trong form |
| Tiền | CInputCurrency | Model là số |
| Phần trăm | CInputPercent | Model là chuỗi |
| Chọn một | CSelect + CSelectOption | show-search khi trên 10 lựa chọn |
| Chọn nhiều | CSelect mode="multiple" | |
| Hai trạng thái | CSwitch | Đổi là áp dụng ngay |
| Số trong một khoảng hẹp | CSlider | Xem Thanh kéo |
| Nhiều lựa chọn độc lập | CCheckboxGroup | |
| Một trong vài lựa chọn nhìn thấy hết | CRadioGroup | Trên 5 lựa chọn thì dùng CSelect |
| Ngày | CDatePicker | |
| Khoảng ngày | CRangePicker | |
| Tệp | CUpload | Gửi bằng FormData qua useApi |
Ngày tháng
vue
<CDatePicker v-model:value="model.date" value-format="YYYY-MM-DD" />
<CRangePicker v-model:value="model.range" value-format="YYYY-MM-DD" />Luôn khai value-format: không có nó, model là đối tượng dayjs và backend nhận được chuỗi khó đoán. YYYY-MM-DD là định dạng thống nhất của framework — xem Hợp đồng dữ liệu.
Giao diện hiển thị theo locale vi_VN mà layer đã áp. Tên tháng và thứ đến từ dayjs — dự án cần tiếng Việt cho phần đó thì nạp dayjs/locale/vi.
Thanh kéo
vue
<CSlider
v-model:value="point"
:min="range.from"
:max="range.to"
:marks="{ [range.from]: `${range.from}`, [range.to]: `${range.to}` }"
:tip-formatter="(v) => `+${v}`"
/>markshiện số ở hai đầu thanh. Bong bóng giá trị hiện khi rê chuột, kéo hoặc focus bằng bàn phím;:tip-formatter="null"để tắt.- Núm nhận focus bằng Tab, đổi giá trị bằng phím mũi tên, và có sẵn
role="slider"cùngaria-valuemin/max/now. min/maxđổi động thì tự kẹp lại model — antdv không sửa giá trị nằm ngoài khoảng mới.- Giá trị cố định, không cho chọn: ẩn bằng
v-if. Chỉ dùngdisabledkhi vẫn cần cho thấy thanh.
CFormItem
vue
<CFormItem label="Khách hàng" name="customer">
<CInput v-model:value="model.customer" />
</CFormItem>name phải trùng khoá trong model và rules, nếu không rule không chạy. Xem CForm.
Tải tệp
vue
<CUpload
:max-count="1"
:before-upload="() => false"
@change="onFileChange"
>
<CButton variant="outline">Chọn tệp</CButton>
</CUpload>:before-upload="() => false" chặn antd tự gửi — dự án gửi qua useApi để request đi đúng đường BFF và có token:
ts
const form = new FormData()
form.append('file', file)
await api('/orders/import', { method: 'POST', body: form })Lưu ý
- Ô nhập trong form luôn có
CFormItemvớilabel— placeholder không thay được nhãn. - Đặt
style="width: 100%"choCInputNumber,CSelect,CDatePickerkhi nằm trong form dọc, nếu không chúng co lại theo nội dung. - Danh sách lựa chọn dài thì tải từ backend và bật
show-search, đừng render vài trămCSelectOption.