|
|
| ||||||||||||||||||
|
|
Initial Display The first calendar view item displayed contains the start date (figure 1) and possibly, the initial date. For calendar the initial date is highlighted by default. Highlighting of the initial date is enabled/disabled through the showHighlight attribute of the <cal:display> tag. The initial date value is either an implicit date, an attribute, or a calculated date. Implicitly, the initial date is either the startDate attribute of the <cal:display> tag, the calculated start date, or the current date. The initial date may be defined by the initialDate attribute of the <cal:calendar> tag. The initial date may be calculated using the initDay, initMonth, or initYear attributes of the <cal:calendar> tag. An absolue date is calculated by combining all of the values provided by the initDay, initMonth, and initYear attributes. A relative date is calculated by combining any values of initDay, initMonth, or initYear attributes with the implicit or explicit intermediate initial date. The initDay, initMonth, or initYear attributes may replace the corresponding value or, using a preceedning '+' and '-' to identify an offset from the intermediate initial date, a relative initial date may be calculated. The start date (startDate) is an attribute of the <cal:display> tag. When start date is undefined, it's value is implictly assigned from either · the <cal:click> tag scrolling parameter name (toField value), · the default scrolling parameter name ('startDate'), · the initial date defined by the <cal:calendar> tag attributes, or · the current date. Weekend Display The weekend may be displayed in natural order, first, last, or hidden. The weekend display is altered by the displayWeekend attribute of the <cal:display> tag. This attribute is ignored for weekday and day views. View Display imCalendar displays a single view item, like month, by default. Multiple items are displayed in rows and columns. The number of view items displayed is controled through attributes of the <cal:display> tag. The attributes maxCount, rowCount, columnCount, and contentCount identify a specific number of view items displayed. The attributes startDate and endDate identify specific dates that must be displayed. Each of these attributes may be combined as individual needs dictate. The maxCount attribute defaults to 1 and is calculated when a value is not provided and endDate, rowCount, or columnCount is provided. When endDate is provided, maxCount is calculated based on endDate minus startDate. When rowCount and columnCount are provided, maxCount is calculated based on rowCount multiplied by columnCount. The columnCount attribute defaults to maxCount or 3, whichever is smaller and is calculated when a value for columnCount is not provided. When maxCount is greater than columnCount, and rowCount is not provided, rowCount is calculated based on maxCount divided by columnCount. View items are displayed in each and every row and column, even when the number of view items would exceed the value of maxCount. The attribute contentCount defines an additional dimension for display of week and weekday view items only. The attribute contentCount determines the number of rows displayed within each view item. Title Display Figures 1-8 show the default titles for month, week, weekday, and day views using the compressed and list templates. The list and fulllist templates for the month, week, and weekday views, display an additional title (figures 5-7) using the contentColumnTitle title. The month and week views show the weekday and the weekday view shows the month. Each template provides a different default titleFormat for contentColumnTitle. Use the <cal:display> tag to control title display and the <cal:title> tag to control title content. Content Display The layout of each date is controlled by the <cal:dayGroup> and <cal:dayDisplay> tags. By default there are three day groups defined: weekend, week, and weekodd. The weekend day group controls the layout of Saturday and Sunday. The week day group controls the layout of Monday, Wednesday, and Friday. The weekodd day group controls the layout of Tuesday and Thursday. The default day groups are disabled through the <cal:dayGroup> tag: <cal:dayGroup name='defaults' enabled='false'/>. The <cal:dayGroup> tag identifies the weekdays and default color of a day group definition. The <cal:dayDisplay> tag identifies the size and location of components by name. Valid components include date, and text. By default date displays the date of the month, as in 31 for May 31, 2004 using the 'dayText' title. Text displays text in block, list, and fulllist templates using the <cal:title> tag 'calendarText'. Title Examples Figure 1: <cal:calendar initialDate='5/31/2004'/> Figure 2: <cal:calendar view='week' initialDate='5/31/2004'/> Figure 3: <cal:calendar view='weekday' initialDate='5/31/2004'/> Figure 4: <cal:calendar view='day' initialDate='5/31/2004'/> Figure 5: <cal:calendar view='month' template='list' initialDate='5/31/2004'/> Figure 6: <cal:calendar view='week' template='list' initialDate='5/31/2004'/> Figure 7: <cal:calendar view='weekday' template='list' initialDate='5/31/2004'/> Figure 8: <cal:calendar view='day' template='list' initialDate='5/31/2004'/> Figure 9: <cal:calendar view='day' template='block' initialDate='5/31/2004'> <cal:namedDayGroup name="defaults" enabled="false"/> <cal:dayGroup name="defaults" enabled="false"/> <cal:dayGroup name="week" all="true" color="#ccffcc"> <cal:dayDisplay name="date" width='30' height='30'/> <cal:dayDisplay name="text" width='80' height='60'/> </cal:dayGroup> </cal:calendar> |
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
