您现在的位置:e-works > 智造书屋 > 书籍列表 > HTML5 Canvas核心技术—图形、动画与游戏开发 > 本书程序清单的规范格式

第一章 基础知识

第三节 本书程序清单的规范格式

    本书中的许多程序清单都将使用如下规范格式:

<!-- example.html -->

<!DOCTYPE html>

<html>

   <head>

     <title>Canonical Canvas used in this book</title>

      <style>

         ...

         #canvas {

            ...

         }

      </style>

   </head>

      <body>

         <canvas id='canvas' width='600'height='300'>

            Canvas not supported

         </canvas>

         <script src='example.js'></script>

      </body>

   </html>

  // example.js

  var canvas = document.getElementById('canvas'),

      context = canvas.getContext('2d');

  // Use the context...

    刚才这段范例代码中包含一个canvas元素,它的ID属性是canvas,而且这段代码使用了一个名为example.js的JavaScript源代码文件。那份文件的代码中有两个变量,一个用于保存canvas,一个用于保存其绘制环境。前述范例代码先使用document.getElementById()方法来获取指向canvas对象的引用,然后又获取了一份指向canvas绘图环境对象的引用。


    本书中的大多数应用程序代码都会遵循上述规范格式,为了行文简洁,以后将会省略HTML部分的程序清单。与之类似,对于以行内形式印刷的程序清单,也就是像刚才那段代码一样,没有冠以“程序清单”的代码段,我们将直接使用canvas与context变量,而不再列出它们的初始化代码。

    最后要说的是,为了简洁起见,本书中的程序清单代码并非都是完整的。书中经常会有一些范例,它们是构建在其他范例基础之上的。如果出现这种情况,那么你会看到最终那个范例的完整程序清单,同时也会部分列出其他相关程序清单的代码。

    提示:谈一谈User Agent

    在Canvas规范书中,将canvas元素的实现者称为User Agent(中文意为“用户代理”,是指代表软件用户发出行为指令的软件程序,业内一般直呼其英文,不做翻译。—译者注),简称UA。该规范书使用的是这个术语,而不是“浏览器”(browser)一词,因为任何软件都可以实现canvas元素的功能,并不只有浏览器才行。

    然而,本书还是将canvas元素的实现者叫做“浏览器”,因为如果使用“User Agent”这个术语,或是更糟糕地将其简称为UA的话,读者看起来会觉得陌生和困惑。

    提示:本书中所引用的URL

    在本书中,有时会看到一些作为深入阅读参考资料的URL网址。如果它们都是可读的字符,而且不是很长的话,那么将会给出实际的URL来。对于那些不便输入的URL,本书将使用缩略网址(shortened URL),它们虽然很难记忆,但是输入起来却很方便。