HTML组件(2)-控件新闻-慧都网

HTML组件(2)

翻译|其它|编辑：郝浩|2004-02-17 22:54:00.000|阅读 1342 次

概述：

class=souceCode>您可能已经注意到HTC可以包含别的HTC，calendar.htc包括两个别的HTML组件，每个月的所有日期:day.htc和与当前日期一致的today.htc,以下是canlendar.htc的顶部15行：

<HTML XMLNS:MYCAL XMLNS:TODAY XMLNS:ANYDAY>
<HEAD>
<?IMPORT NAMESPACE="ANYDAY" IMPLEMENTATION="day.htc"/>
<?IMPORT NAMESPACE="TODAY" IMPLEMENTATION="today.htc"/>

<PUBLIC:COMPONENT tagName="CALENDAR">
<ATTACH EVENT="oncontentready" ONEVENT="fnInit()"/>
</PUBLIC:COMPONENT>
<SCRIPT LANGUAGE="JavaScript">

</SCRIPT>

　　第一行在这些HTC会用到的XML命名空间。这些命名空间即包括本页自己要用到的，也包括页面需调用的命名空间（ANYDAY 和 TODAY ），注意命名空间并不一定要和HTC文件文件名一致。接着，我们导入这些HTC：

<?IMPORT NAMESPACE="ANYDAY" IMPLEMENTATION="day.htc"/>
<?IMPORT NAMESPACE="TODAY" IMPLEMENTATION="today.htc"/>

　　当我们解析到这些行，浏览器将一直等到要导入的文件被导入才继续页面解析（同步导入）。

然后我们定义CALENDAR自定义标记：

<PUBLIC:COMPONENT tagName="CALENDAR">
<ATTACH EVENT="oncontentready" ONEVENT="fnInit()"/>
</PUBLIC:COMPONENT>

　　PUBLIC:COMPONENT用来描述CALENDAR标记，在开始和结束标记之间，您可以将事件附加到CALENDAR标记上，事件oncontentready将在calendar.htc文件全部被导入，并被解析时，指定处理时间的是定义在JAVASCRIPT的函数：fnInit()：

<SCRIPT LANGUAGE="JavaScript">

</SCRIPT>

　　viewLink指定的值非常重要，它是HTML组件的基础，它连接了HTML组件和调用该HTML组件的页面，defaults对象有别的属性并且会在别的地方被覆盖，我们给viewLink属性赋的是HTML文档对象，正因为该连接，我们才可以建立HTC组件和包含页面互访。
　　我们将在后面解释日历的层。注意，尽管在日历中当月的当天框和其他天框、空框的样式不一样，但是我们通过优先级法则来实现在包含页中，HTML组件忽略任何相互冲突的样式定义。calendar.htc的样式定义如下：

<STYLE>
TD {
background-color:tan;
width:50;
height:50;
}
</STYLE>

　　现在将该定义和日历比较，只有空框是的颜色是黄褐色的，我们调用的HTC忽略了这些定义，被调用的页面都嵌入了页面定制。以下调用TODAY:DAY HTML组件：

<TODAY:DAY value=' + dayOfMonth + '></TODAY:DAY>

　　我们只是简单的传入了当月中的第几天，同样的调用ANYDAY:DAY 也是简单的传入当月中的第几天：

<ANYDAY:DAY value=' + dayOfMonth + '></ANYDAY:DAY>

===编写日历一===

　　当calendar.html调用 MYCAL:CALENDAR,当月的日历将会显示在页面中，函数setCal()是主要程序段，它初始化一些变量并调用drawCal()函数。我们也使用了三个别的函数：getMonthName()、 getDays() 和 leapYear()。让我们从最后一个函数开始：

　　getDays()函数接收哪月值和哪年值，并且建立一个有12个元素的数组，用来存放每月的天数，哪一年用来决定是不是闰年，在闰年中二月是29天，而不是闰年是28天。该函数返回指定月份的天数。

以下是getDays()：

function getDays(month, year) {
// create array to hold number of days in each month
var ar = new Array(12);
ar[0] = 31; // January
ar[1] = (leapYear(year)) ? 29 : 28; // February
ar[2] = 31; // March
ar[3] = 30; // April
ar[4] = 31; // May
ar[5] = 30; // June
ar[6] = 31; // July
ar[7] = 31; // August
ar[8] = 30; // September
ar[9] = 31; // October
ar[10] = 30; // November
ar[11] = 31; // December

// return number of days in the specified month (parameter)
return ar[month];
}

如果指定的年数可以被4整除，那么leapYear()函数将返回“true”，否则返回”false“：

function leapYear(year) {
if (year % 4 == 0) // basic rule
return true; // is leap year
/* else */ // else not needed when statement is "return"
return false; // is not leap year
}
getMonthName()函数返回指定月份的名字：
function getMonthName(month) {
// create array to hold name of each month
var ar = new Array(12);
ar[0] = "January";
ar[1] = "February";
ar[2] = "March";
ar[3] = "April";
ar[4] = "May";
ar[5] = "June";
ar[6] = "July";
ar[7] = "August";
ar[8] = "September";
ar[9] = "October";
ar[10] = "November";
ar[11] = "December";

// return name of specified month (parameter)
return ar[month];
}

setCal()函数是主模块，我们在脚本的第一行调用它。该函数为当天（now）、和每月的第一天（firstDayInstance）建立一个Date对象。用这些对象，setCal()函数解析出关于一个月的第一天、当日，和最后一天的所有信息。

function setCal() {
// standard time attributes
var now = new Date();
var year = now.getFullYear();
var month = now.getMonth();
var monthName = getMonthName(month);
var date = now.getDate();
now = null;

// create instance of first day of month, and extract the day on which it occurs
var firstDayInstance = new Date(year, month, 1);
var firstDay = firstDayInstance.getDay();
firstDayInstance = null;

// number of days in current month
var days = getDays(month, year);

// call function to draw calendar
drawCal(firstDay + 1, days, date, monthName, year);
}

ANYDAY组件定义在day,htc中，该组件是日历单元的一个封装。组件的名字是由定义在第一行的XML命名空间决定的。

<HTML XMLNS:ANYDAY>

　　正如canlenar.htc一样，你只有一个命名空间定义，原因是在该页不用调用其他的HTC，也就是说该HCT是叶子HTC，在这里我们定义的自定义标签是DAY，同样我们也定义它的行为，实际上，HTML组件的定义就是自定义标签行为的定义，该行为包括一个属性和一个事件：

<PUBLIC:COMPONENT tagName="DAY">
<PROPERTY NAME="value"></PROPERTY>
<ATTACH EVENT="oncontentready" ONEVENT="fnInit()"<>/ATTACH>
</PUBLIC:COMPONENT>

　　注意事件 oncontentready ，当它的调用者calendar.htc要求导入day.htc并且被完全导入，该事件就会产生，事件的处理者是fnInit().我们来看看它：

function fnInit() {
document.body.innerHTML = element.value;
document.body.className = "clsDay";
defaults.viewLink = document;
element.appointments = "";
element.date = element.value;
}

　　fnInit()演示了很多重要的HTC章节。第一行把 element.value 指定给调用页的 innerHTML 属性。HTML组件总是封装在element对象里。value属性一般定义在PROPERTY标签中，作为提醒，实际的值从调用页面传入，canlendar.htc:
text += '<TD><ANYDAY:DAY value=' + dayOfMonth + '></ANYDAY:DAY></TD>'
单元样式在第二行指定：

document.body.className = "clsDay";

样式类 clsDay 定义在该页的别处：

<STYLE>
.clsDay {
width:50;
height:50;
background-color:lightyellow;
align:center;
text-align:right;
}
</STYLE>

　　注意在日历中日期的被填色为亮黄色，这证明HTC的格式的指定模式被它的调用者所支配，即：calendar.htc.
　　fninit()的第三行设置default对象的viewlink属性，viewLink属性是HTML组件的基础，它可以使得一个HTC文档(day.htc)对另一个HTML组件(calendar.htc)来说可见.这儿就是viewLink的设置：

defaults.viewLink = document;

　　注意您需要联接的是整个document对象。fnInit()的最后两行初始化我们将在以后解释的两个内部属性：

element.appointments = "";
element.date = element.value;

用于它本身的显示，DAY HTML组件和鼠标点击相关：

<BODY onclick="fnShowAppts()">

当该天被点击，用户被提醒在该天加上他或她的约会，或者修改已经存在的约会：

function fnShowAppts() {
newAppointments = prompt("Add your appointment:", element.appointments);
if (newAppointments != null) element.appointments = newAppointments;
document.body.innerHTML = '<FONT COLOR="red">' + element.date + '</FONT>' + "<BR>" + '<FONT SIZE="1">' + element.appointments + '</FONT>';
}

　　这里的输入机制非常原始，用户在约会指定中加入新行标签(<BR>)，否则他们将都显示在一行。最后innerHTML是日期数据(element.date)和约会指定(element.appointments) 的连接纽带。
　　TODAY HTML组件(today.htc)和ANYDAY组件(day.htc)非常类似。唯一的不同是样式快中的background-color是pink而不是lightyellow,并且字体颜色是blue 而不是red.
　　注意在日历中当前日期是粉红色(pink)背景蓝色的字。

　　下节将列出我们所讲的日历的完整代码和一个不用HTC组件方法实现的日历代码