Skip to content

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ệuComponentGhi chú
Chữ ngắnCInputallow-clear cho ô lọc
Chữ dàiCTextareaLuôn đặt :rows
Số đếmCInputNumber:min, :max; thêm style="width: 100%" trong form
TiềnCInputCurrencyModel là số
Phần trămCInputPercentModel là chuỗi
Chọn mộtCSelect + CSelectOptionshow-search khi trên 10 lựa chọn
Chọn nhiềuCSelect mode="multiple"
Hai trạng tháiCSwitchĐổi là áp dụng ngay
Số trong một khoảng hẹpCSliderXem Thanh kéo
Nhiều lựa chọn độc lậpCCheckboxGroup
Một trong vài lựa chọn nhìn thấy hếtCRadioGroupTrên 5 lựa chọn thì dùng CSelect
NgàyCDatePicker
Khoảng ngàyCRangePicker
TệpCUploadGử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}`"
/>
  • marks hiệ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ùng aria-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ùng disabled khi 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ó CFormItem với label — placeholder không thay được nhãn.
  • Đặt style="width: 100%" cho CInputNumber, CSelect, CDatePicker khi 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ăm CSelectOption.

Liên quan ​