@ihma-io/form

@ihma-io/form

IHMA form maydonlari va data-entry komponentlari. Paket vee-validate, @ihma-io/ui va umumiy useFormField kontrakti ustida qurilgan.

import {
  FormFileUpload,
  FormInput,
  FormSelect,
  FormTable,
  FormWizard,
  useFormField,
} from '@ihma-io/form'

Named importlardan foydalaning; @ihma-io/ui yoki @ihma-io/form komponentlarini global ro'yxatdan o'tkazish paketning talabi emas.

CSS

Formning build qilingan CSS fayli alohida public export hisoblanadi:

@import 'tailwindcss';
@import '@ihma-io/tokens/tokens.css';
@import '@ihma-io/tokens/theme.css';
@import '@ihma-io/form/form.css';

@source '../node_modules/@ihma-io/ui/dist';
@source '../node_modules/@ihma-io/form/dist';

Tarkib

• Maydonlar: input, textarea, number, select, combobox, picker, checkbox, radio, switch, tags va tree select.
• Murakkab oqimlar: table, filters/actions, tabs/tab row, wizard, data card va file history.
• File upload: adapter, chunk upload, preview, validation va persistence composablelari.

Upload resume persistence tenant/user bilan izolyatsiyalangan bo'lishi shart. persist yoqilsa, barqaror identity scope ham bering; scope bo'sh bo'lsa persistence xavfsizlik uchun fail-closed tarzda ishlamaydi:

<FormFileUpload
  :config="{ persist: true, persistenceScope: `${tenantId}:${userId}` }"
/>

Scope runtime'da o'zgarsa eski scope'ning in-memory chunk sessiyasi bekor qilinadi va yangi scope eski uploadIdni ishlatmaydi.

vue, vue-i18n, vee-validate, @vueuse/core, reka-ui, lucide-vue-next va @internationalized/date required peer hisoblanadi. axios, vue-sonner va xlsx faqat tegishli optional funksiyalar uchun kerak bo'ladi.

Excel preview va eksport

Excel funksiyalari ishlatilsa, SheetJS CE 0.20.3 ni rasmiy tarball orqali o'rnating. npm registry'dagi xlsx paketi eski 0.18.5 versiyada qolgan:

npm install --save https://cdn.sheetjs.com/xlsx-0.20.3/xlsx-0.20.3.tgz
# yoki
pnpm install --save https://cdn.sheetjs.com/xlsx-0.20.3/xlsx-0.20.3.tgz

SheetJS Node.js o'rnatish yo'riqnomasi tarballni vendoring qilishni ham tavsiya qiladi.

useFormField standart required xabari uchun t('validation.required') dan foydalanadi. Ilova shu i18n kalitini berishi yoki componentning errorMessages propi orqali xabarni almashtirishi kerak.