مرجع API لمكوّن منتقي التاريخ

الاستيراد

import-date-picker.ts

import {
  NuiDateField,
  NuiDatePicker,
  NuiDateRangePicker,
  NuiTimeField,
} from '@needless-ui/angular/date-picker';

تاريخ، أو تاريخ ووقت، يُكتب على أجزاء.

NuiDateField: الخصائص
الاسم	النوع	القيمة الافتراضية	الوصف
`value`ثنائي الاتجاه	`NuiDate \| NuiDateTime \| null`	`null`	القيمة، أو null حتى تمتلئ الأجزاء كلها.
`granularity`مُدخَل	`'day' \| 'hour' \| 'minute' \| 'second'`	`'day'`	يتوقف عند اليوم، أو يمتد إلى الساعة أو الدقيقة أو الثانية.
`min, max`مُدخَل	`string \| null`		أقدم قيمة وأحدث قيمة. وخارجهما يكون الحقل غير صالح.
`placeholder`مُدخَل	`string \| null`	`now`	القيمة التي تبدأ منها الأجزاء الفارغة مع مفاتيح الأسهم.
`hourCycle`مُدخَل	`12 \| 24`		نظام الساعة، 12 ساعة أو 24. وافتراضيًا، نظام اللغة والمنطقة.
`minuteStep`مُدخَل	`number`	`1`	مقدار ما تُغيّره مفاتيح الأسهم في الدقائق.
`disabled, readonly`مُدخَل	`boolean`	`false`	يمنعان التغيير.
`locale`مُدخَل	`string`	`LOCALE_ID`	يحدد الترتيب والفواصل والأرقام ونظام الساعة.
`labels`مُدخَل	`Partial<NuiDateFieldLabels>`		كل نص يُعلنه الحقل، لترجمته.
`invalid`خاصية	`Signal<boolean>`		ما إذا كانت القيمة خارج `min` و`max`.
`focus`دالة	`() => void`		ينقل التركيز إلى أول جزء فارغ.

وقت من اليوم يُكتب على أجزاء. ويقبل مُدخلات حقل التاريخ نفسها.

NuiTimeField: الخصائص
الاسم	النوع	القيمة الافتراضية	الوصف
`granularity`مُدخَل	`'hour' \| 'minute' \| 'second'`	`'minute'`	يتوقف عند الساعة أو الدقيقة أو الثانية.

حقل تاريخ مع تقويم في نافذة منبثقة. ويقبل مُدخلات حقل التاريخ، وهذه أيضًا.

NuiDatePicker: الخصائص
الاسم	النوع	الوصف
`unavailable`مُدخَل	`(date: NuiDate) => boolean`	أيام لا يسمح التقويم باختيارها.
`firstDay, weekNumbers`مُدخَل	`1 … 7, boolean`	تُمرَّر إلى التقويم.
`labels`مُدخَل	`Partial<NuiDatePickerLabels>`	نصوص الحقل والزر والتقويم.
`corners`مُدخَل	`NuiCorners`	شكل زواياه: `round` أو `squircle` أو `bevel` أو `scoop` أو `notch` أو `square`.
`radius`مُدخَل	`NuiRadius`	حجم زواياه: `none` أو `small` أو `medium` أو `large` أو `full`.
`density`مُدخَل	`NuiDensity`	المساحة التي يشغلها: `compact` أو `regular` أو `roomy`.
`show`دالة	`() => void`	يفتح التقويم.

مُدخلات التخصيص التي تتركها دون ضبط تتبع أقرب سمة data-nui-*. راجع دليل التخصيص.

حقلا تاريخ مع تقويم للنطاقات. ويقبل مُدخلات منتقي التاريخ، وهذه أيضًا.

NuiDateRangePicker: الخصائص
الاسم	النوع	القيمة الافتراضية	الوصف
`value`ثنائي الاتجاه	`NuiDateRange \| null`	`null`	النطاق، أو null حتى يُضبط الطرفان بالترتيب الصحيح.
`presets`مُدخَل	`NuiDateRangePreset[]`	`[]`	نطاقات مسمّاة تُختار بنقرة واحدة.
`months`مُدخَل	`number`	`2`	عدد الأشهر المتجاورة في التقويم.

نطاق مسمّى، ثابت أو يُنشأ عند اختياره.

NuiDateRangePreset: الخصائص
الاسم	النوع	القيمة الافتراضية	الوصف
`label`خاصية	`string`		اسمه.
`range`خاصية	`NuiDateRange \| (() => NuiDateRange)`		النطاق، أو دالة تُنشئه.