S2 skatu tipi 

piektdien, 4.06.2004 @1:40 pm | x-ƒ

S2 valodā visi žūrnāla skati (views) ir definēti vienā izkārtojumā (layout). Katru skatu skatu var aplūkot kā objektu, kas satur funcijas un mainīgos, kas var tikt izmantoti šim lapas tipam. "Page" pats par sevi ir kā lietussargs visiem pārējiem, saturot funkcijas un mainīgos, kas var tikt izmantoti visos skatos, un katrs skats var pievienot kaut ko īpašu (savas funkcijas un mainīgos) galvenajai lapai ("Page").

Page
"Page" ir pati augšējā klase visiem S2 skatiem. Tas nozīmē, ka visi pārējie "skati" izriet (rodas) no šī objekta. "Page" ir ievada klase skatiem: kad Tu pirmoreiz raksti kodu savam izkārtojumam (layout), funkcija, kas izvada visu informāciju, ir Page::print. Visi pārējie skati ir "Page" apakšklases. Visiem pārējiem lapu tipiem būs iespējams piekļūt un izmantot jebkuru "Page" klases funkciju vai mainīgo.
Šajā lapā aprakstītas visas funkcijas un mainīgie, kas pieejami "Page" klasei. Lai noteiktu, kādu lapu Tu tieši pašlaik skaties, katra "Page" apakšklase satur mainīgo "view", kurš nosaka kāds lapas tips pašlaik tiek aplūkots. Šim mainīgajam var piekļūt, izmantojot "view" mainīgo, kurš atrodas visos lapu objektos. (Tas nozīmē, ka jebkurā "Page" klasē vai apakšklasē var vienkārši piekļūt "$.view".)

RecentPage – $.view == "recent"
Klases "Page" apakšklase. Šī ir pati žūrnāla lapa, nesenie ieraksti. Vecajā S1 stilu sistēmā to sauca par "LASTN" skatu. "RecentPage" klase satur dažas funkcijas un mainīgos, kas attiecas tieši uz šo lapu, piemēram, izvadāmo ierakstu masīvu.

FriendsPage – $.view == "friends"
Klases "RecentPage" apakšklases. Šis ir draugu skats, kurā tiek attēloti visu Tavu draugu apkopotie ieraksti. Šī skata ieraksti satur nedaudz vairāk informācijas (draugu krāsas) un ir pieejama papildus nosaukuma teksts draugu lapai, kuru var noteikt līdz ar savu personālo informāciju. Visādi citādi nav nemaz lielu atšķirību starp draugu un žūrnāla lapu.
(Patiesībā var arī vispār iztikt bez FriendsPage klases izmantošanas, ja vien atceras, ka tā ir RecentPage apakšklase un savā kodā ievieto nepieciešamās "$.view" pārbaudes. Tad gan jāiztiek bez draugu iekrāsošanas.)

YearPage – $.view == "archive"
"YearPage" ir tas pats, kas kalendāra skats vecajā S1 stilu sistēmā. Šis skatu tips satur informāciju par mēnešiem un katras dienas ierakstu skaitu. Šis ir vienīgais skats, kurš nesatur nekādu informāciju par pašiem ierakstiem, piemēram, ieraksta virsrakstu vai tekstu.

MonthPage – $.view == "month"
"MonthPage" satur informāciju par visiem ierakstiem, kas veikti norādītajā mēnesī. Šis skatu tips satur šo ierakstu metadatus, lai gan tam nav pieejami ierakstu teksti vai lietotāja attēli. Šo skatu parasti izmanto, lai ģenerētu norādītā mēneša ierakstu virsrakstu sarakstu.

DayPage – $.view == "day"
Šis skats attēlo visus vienas dienas ierakstus. Informācija par pašu ierakstu ir tieši tāda pati, kā RecentPage skatā. Tas nozīmē, ka tā satur ieraksta pilno tekstu, virsrakstu, lietotāja attēlu, metadatus u.t.t. Ieraksti šajā lapā pēc noklusējuma tiek kārtoti hronoloģiskā kārtībā, atšķirībā no apgriezti hronoloģiskās kārtības, kāda tiek izmantota draugu vai žūrnāla lapā.

EntryPage – $.view == "entry"
Atsevišķs ieraksts un šim ierakstam pievienotie komentāri. Šis skats satur pilnu ieraksta informāciju, kā arī informāciju par visiem lietotāju atstātajiem komentāriem. Šis ir viens no skatiem, kurš nosaka, kā ieraksti patiesībā izskatīsies.

ReplyPage – $.view == "reply"
Lapa, lai atbildētu uz žūrnāla ierakstu vai komentāru. Šī lapa nosaka, kā Tavs žūrnāls rīkosies, kad Tu atstāsi komentāru vai atbildēsi uz citu komentāru. Tā satur īpašas funkcijas, lai ģenerētu atbildes formu, kā arī informāciju par to, kā formatēt atbildes.

Tulkots no S2 HOWTO kopienas, saite.

Šis jau reiz tika publicēts, taču atkārtot der. :)
 Page
   |– RecentPage
   |      |
   |   FriendsPage
   |– EntryPage
   |– ReplyPage
   |– YearPage
   |– MonthPage
   |– DayPage