Shigo da shi
import { NuiScheduler, type NuiSchedulerHandle } from '@needless-ui/react/scheduler';NuiScheduler
Events a wata, mako, rana, ajanda ko timeline.
| Suna | Iri | Na asali | Bayani |
|---|---|---|---|
eventsProp | NuiSchedulerEvent<T>[] | [] | Events da za a nuna. |
resourcesProp | NuiSchedulerResource[] | [] | Ɗakuna, mutane ko injuna: layukan timeline, da ginshiƙan rana da na mako. |
viewdefaultViewonViewChangeYanayi | 'month' | 'week' | 'day' | 'agenda' | 'timeline' | 'week' | Kallon da ake nunawa. |
viewsProp | NuiSchedulerView[] | all | Nau’o’in kallo da mutane za su iya sauyawa a tsakaninsu. Idan ba a saita ba, duka ne, amma timeline sai da resources. |
timelineSpanProp | 'day' | 'week' | 'month' | 'day' | Abin da timeline ke nunawa: rana bisa slots ɗinta, ko mako ko wata bisa kwanakinsu. |
datedefaultDateonDateChangeYanayi | NuiDate | today | Ranar da ake nunawa, da inda focus na allon madannai yake. Ku ba da defaultDate idan server ne ke nuna jadawalin: ranar yau a server ba lallai ta zama ranar yau ga mai karatu ba. |
slotMinutesProp | number | 30 | Mintunan kowane layi a grid na lokaci, ko na kowane ginshiƙi a timeline na rana. |
snapMinutesProp | number | slotMinutes | Matakin da events ke matsawa da sauya tsawo da shi. |
dayStart, dayEndProp | number | 0, 24 | Sa’ar farko da ta ƙarshe da grid na lokaci ke nunawa. |
scrollHourProp | number | 8 | Sa’ar da grid na lokaci ke buɗewa a kanta. |
agendaDaysProp | number | 30 | Kwanakin da ajanda ke dubawa a gaba. |
businessHoursProp | NuiSchedulerHours[] | Sa’o’in aiki, kamar { days: [1, 2, 3, 4, 5], start: '09:00', end: '17:00' }. Sauran lokaci yana da inuwa. | |
weekendsProp | boolean | true | Yana nuna ƙarshen mako. Idan an kashe shi, kowane kallo yana cire ƙarshen mako na yankin. |
weekNumbersProp | boolean | false | Yana nuna lambobin mako na ISO a cikin wata, da kuma saman lokuta. |
editableProp | boolean | false | Ana iya matsar da events da sauya tsawonsu, da linzami da allon madannai. |
selectableProp | boolean | false | Ana iya zaɓar lokaci a kan grid, don ƙirƙirar events. |
allowProp | (time) => boolean | Yana yanke hukunci ko matsarwa, sauya tsawo ko zaɓin lokaci zai iya faruwa. | |
toolbarProp | boolean | ((toolbar: NuiSchedulerToolbar) => ReactNode) | true | Yana nuna toolbar, ko ya zana naku daga abin da aka ba shi. |
firstDayProp | 1 … 7 | Ranar farko ta mako, 1 ita ce Litinin. Idan ba a saita ba, ta yankin ce. | |
headingLevelProp | number | 2 | Matakin heading na take; kwanakin ajanda suna sauka mataki ɗaya. |
localeProp | string | 'en-US' | Yana tsara kwanaki da lokuta. |
labelsProp | Partial<NuiSchedulerLabels> | Kowane rubutu da jadawalin ke nunawa ko sanarwa, don fassarawa. | |
cornersProp | NuiCorners | Siffar kusurwoyinsa: round, squircle, bevel, scoop, notch ko square. | |
radiusProp | NuiRadius | Girman kusurwoyinsa: none, small, medium, large ko full. | |
densityProp | NuiDensity | Yawan sararin da yake ɗauka: compact, regular ko roomy. | |
renderEventRender prop | (event, { time }) => ReactNode | Ku zana events da kanku, daga event ɗin da lokacinsa a matsayin rubutu. | |
renderResourceRender prop | (resource) => ReactNode | Ku zana taken resources da kanku. | |
onEventClickCallback | (event: NuiSchedulerEvent<T>) => void | Ana kiransa da event da aka danna, ko aka buɗe da Enter. | |
onEventChangeCallback | ({ event, start, end, resource? }) => void | Ana kiransa da sabbin lokutan event bayan an matsar da shi ko an sauya tsawonsa, da resources ɗinsa idan sun canza. Ku sabunta events don riƙe canjin. | |
onSlotSelectCallback | ({ start, end, allDay, resource? }) => void | Ana kiransa da lokacin da aka zaɓa a kan grid, da resource ɗinsa. | |
onRangeChangeCallback | ({ start, end }) => void | Ana kiransa da rana ta farko da ta ƙarshe da ake nunawa idan sun canza, don ku ɗauko events ɗinsu. | |
refProp | Ref<NuiSchedulerHandle> | Abin da ref na jadawalin ke kaiwa: sauya shafi, don toolbar naku. | |
previous, next, goTodayMethod | () => void | Suna nuna shafin baya ko na gaba, ko yau, don toolbar naku. | |
titleKadara | string | Abin da ake nunawa, kamar yadda taken toolbar ke faɗa. |
Yanayi yana aiki kamar inputs na React da kansu: ku ba da ƙima, ku sabunta ta daga callback ɗinta na on…Change, ko ku ba da ƙimar default…, ku bar component ɗin ya riƙe ta.
Props na keɓancewa da ba ku saita ba suna bin attribute na data-nui-* mafi kusa. Ku duba jagorar keɓancewa.
NuiSchedulerToolbar
Abin da function na toolbar ke samu, don zana toolbar naku.
| Suna | Iri | Na asali | Bayani |
|---|---|---|---|
titleKadara | string | Abin da ake nunawa, kamar yadda taken toolbar ke faɗa. | |
view, viewsKadara | NuiSchedulerView, NuiSchedulerView[] | Kallon da ake nunawa, da nau’o’in kallon da ake bayarwa. | |
setView, previous, next, goTodayMethod | (view?) => void | Suna sauya kallo, suna nuna shafin baya ko na gaba, ko yau. |
NuiSchedulerEvent
Event ɗaya. Ƙarshen event mai lokaci ba ya ciki; ƙarshen event na duk yini shi ne ranarsa ta ƙarshe.
| Suna | Iri | Na asali | Bayani |
|---|---|---|---|
id, titleKadara | string | Key ɗinsa, da abin da yake nunawa. | |
start, endKadara | NuiDateTime | NuiDate | Kwanan wata da lokaci, ko kwanan wata kawai ga events na duk yini. | |
allDayKadara | boolean | Idan ba a saita ba, ko start ba shi da lokaci. | |
toneKadara | 'accent' | 'neutral' | 'success' | 'warning' | 'danger' | 'accent' | Palette ɗinsa. |
color, classKadara | string | Kowane launi na CSS, wanda ke rinjayar tone ɗinsa, da classes don ba shi salo. | |
resourceKadara | string | string[] | Resources ɗin da yake da alaƙa da su. | |
rruleKadara | string | Dokar maimaitawa daga RFC 5545, kamar FREQ=WEEKLY;BYDAY=MO. | |
exdateKadara | string[] | Lokutan farawa na maimaitawa da aka cire. | |
recurrenceIdKadara | NuiDateTime | NuiDate | A kan maimaitawar da jadawalin ke ba da rahotonta: farkon da dokar maimaitawa ta ba ta. | |
editableKadara | boolean | Ko ana iya matsar da shi, ko mene ne jadawalin ya ce. | |
dataKadara | T | Duk wani abu da za a ajiye tare da shi. |
NuiSchedulerResource
Ɗaki, mutum ko inji da events ke da alaƙa da shi.
| Suna | Iri | Na asali | Bayani |
|---|---|---|---|
id, titleKadara | string | Key ɗinsa, da sunan da yake nunawa. | |
tone, colorKadara | NuiSchedulerTone, string | Launukan events ɗinsa, sai dai idan suna da nasu. | |
businessHoursKadara | NuiSchedulerHours[] | Lokacin da yake samuwa, maimakon sa’o’in aiki na jadawalin. | |
dataKadara | R | Duk wani abu da za a ajiye tare da shi. |
Helpers
Functions don events masu maimaituwa da fayilolin iCalendar.
| Suna | Iri | Na asali | Bayani |
|---|---|---|---|
nuiSchedulerOccurrencesMethod | (event, first, last) => NuiSchedulerEvent[] | Event kamar yadda yake bayyana a kwanakin da aka bayar: kowace maimaitawa ta event mai maimaituwa. | |
nuiSchedulerRuleMethod | (text: string) => NuiSchedulerRule | null | Yana karanta dokar maimaitawa, ko yana dawo da null. | |
nuiSchedulerToIcsMethod | (events, options?) => string | Yana rubuta events a matsayin fayil na iCalendar. | |
nuiSchedulerFromIcsMethod | (text, { timeZone? }) => NuiSchedulerEvent[] | Yana karanta events na fayil na iCalendar, tare da lokutansu a yankin lokaci ɗaya. |