dojo() 视图助手用来简化设置 Dojo 环境，包括下列职责: 指定一个 CDN 或一个本地路径给 Dojo 安装。 指定路径给定制的 Dojo 模块。 指定 dojo.require 语句。 指定 dijit 风格主题来使用。 指定 dojo.addOnLoad() 事件。 dojo() 视图助手实现是占位符实现的一个范例；数据集在视图对象之间持久， 并可能从布局脚本被直接显示。 对本范例，假设开发者将从本地路径使用 Dojo 表单，需要请求若干个 dijits， 并将使用 Tundra dijit 主题。 在许多页面上，开发者可能根本不使用 Dojo。所以，我们集中精力在需要 Dojo 的视图脚本上， 然后是布局脚本，在那里，我们将设置一个 Dojo 环境和解析它。 首先，我们需要告诉视图对象使用 Dojo 视图助手路径。这可以在引导文件里或早期运行的插件里做； 简单地抓取你的视图对象并执行下列代码： addHelperPath('Zend/Dojo/View/Helper/', 'Zend_Dojo_View_Helper'); ]]> 接着是视图脚本。在本例中，我们打算指定使用 FilteringSelect － 它需要基于 QueryReadStore 的定制的存储， 我们将调用 'PairedStore' 并存储到我们的 'custom' 模块。

State: dojo()->enable() ->setDjConfigOption('parseOnLoad', true) ->registerModulePath('../custom/') ->requireModule('dijit.form.FilteringSelect') ->requireModule('custom.PairedStore'); ]]> 在布局脚本中，我们接着检查是否开启了 Dojo，如果是，我们将做一些基本配置和组装： doctype() ?> headTitle() ?> headMeta() ?> headLink() ?> headStyle() ?> dojo()->isEnabled()): $this->dojo()->setLocalPath('/js/dojo/dojo.js') ->addStyleSheetModule('dijit.themes.tundra'); echo $this->dojo(); ?> headScript() ?> layout()->content ?> inlineScript() ?> ]]> 在这点上，你只需要确保你的文件在正确的位置并且你已经为 FilteringSelect 创建了终点动作！ Dojo 在其许多功能上使用 declarative 和 programmatic。 Declarative 用法使用标准的带有当页面加载时解析的非标准属性的 HTML 元素。 虽然强大并且语法简单，对大多数开发者来说，它在页面校验时容易出问题。 Programmatic 用法让开发者通过用ID或 CSS 选择器把它们来出来并解析 到合适的在 Dojo 里的对象构造器来装饰存在的元素。因为没有使用非标准 HTML 属性，页面可以继续校验。 在实践中，当禁止 javascript 或不能获取部分 Dojo 脚本资源，上述两个用例都考虑了完美的降级。 为提升标准和文档校验， Zend Framework 缺省使用 programmatic 用法，各种 视图助手将生成 javascript 并压到 dojo() 视图助手，在解析时包含。 用这个技术的开发者可能也想探索写自己的页面 programmatic 装饰器。 一个好处是可以指定 dijit 事件的句柄。 为使用此功能，同时也使用 declarative 语法，有许多静态方法可以全局使用。 为指定 declarative 用法，简单地调用静态方法 setUseDeclarative()： 如果你决定使用 programmatic 用法，调用静态方法 setUseProgrammatic()： 最后，如果你想生成自己的 programmatic 规则，你应当指定 programmatic 用法， 但是传递值 '-1'；在这种情况下，不生成用于装饰 dijit 的 javascript。 Dojo 允许为它的 dijits（小部件）生成主题。你可以通过传递模块路径来选择一个： dojo()->addStylesheetModule('dijit.themes.tundra'); ]]> 模块路径通过使用字符 '.'作为目录分隔符和在主题目录里列表中最后的值作为CSS文件的名称来找出。 在上述例子中，Dojo 在 'dijit/themes/tundra/tundra.css' 中寻找主题。 当使用主题时，记住传递主题类很重要，至少，传递在你使用的 dijits 周围的容器； 最常用的用例是在 body 里传递它： ]]> 缺省地，当你使用 dojo.require 语句，dojo 将请求服务器抓取适当的 javascript 文件。 如果你有许多 dijits ，将导致许多对服务器请求，－ 这不是很理想。 Dojo 的解决方案是提供生成 定制 的能力，定制做如下事情： 把请求文件集中到 layers，layer 把所有的请求 文件集中成一个单个的 JS 文件。（Hence the name of this section.） "Interns" non-javascript files used by dijits (typically, template files). These are also grouped in the same JS file as the layer. 通过 ShrinkSafe 传递文件，它剥离了空白字符和注释，还缩短了短变量名。 有些文件不能被 layered，但定制处理将生成一个特别的目录来放 layer 文件和其它所有文件。 这会对你的站点或应用需求减少发行定制。 为了使用 layer，dojo() 视图助手有一个 addLayer() 方法来添加路径到请求 layers: dojo()->addLayer('/js/foo/foo.js'); ]]> 更多关于生成定制的信息，请 refer 参考 Dojo 构造文档. dojo() 视图助手总返回 dojo 占位符容器的实例。 这容器对象有下列方法可用： setView(Zend_View_Interface $view): 在容器中设置一个视图实例。 enable(): 显式地开启 Dojo 集成。 disable(): 关闭 Dojo 集成。 isEnabled(): 确定是否 Dojo 集成已经开启。 requireModule($module): 设置一条 dojo.require 语句。 getModules(): 确定模块 已经被请求。 registerModulePath($module, $path): 注册一个定制的 Dojo 模块路径。 getModulePaths(): 获得已注册模块路径列表。 addLayer($path): 添加一个 layer （定制） 路径。 getLayers(): 获得已注册的 layer 路径（定制）的列表。 removeLayer($path): 从已注册的 layers （定制）列表里删除匹配 $path 的 layer。 setCdnBase($url): 为 CDN 设置基础 URL； 一般地是 Zend_Dojo::CDN_BASE_AOL 或 Zend_Dojo::CDN_BASE_GOOGLE 其中之一， 但它只需要在版本号之前的 URL 字符串。 getCdnBase(): 获取基础 CDN url setCdnVersion($version = null): 从 CDN 设置 Dojo 的版本。 getCdnVersion(): 从将要用的 CDN 获取 Dojo 的版本。 setCdnDojoPath($path): 在一个 CDN 中设置 dojo.js 或 dojo.xd.js 文件的相对路径 ； 一般地是 Zend_Dojo::CDN_DOJO_PATH_AOL 或 Zend_Dojo::CDN_DOJO_PATH_GOOGLE 其中之一，但 它只需要是带版本号的路径字符串。 getCdnDojoPath(): 获取最后的 CDN url 指向 dojo.js文件的路径段。 useCdn(): 告诉容器使用 CDN；显式地开启集成。 setLocalPath($path): 告诉容器指向本地 Dojo 安装（和服务器相关的路径，包括 dojo.js 文件自己） 的路径。显式地开启集成。 getLocalPath(): 确定使用哪个本地 Dojo 路径。 useLocalPath(): 是否集成使用 Dojo 本地路径？ setDjConfig(array $config): 设置 dojo/dijit 配置值（需要联合数组）。 setDjConfigOption($option, $value): 设置一单个的 dojo/dijit 配置值。 getDjConfig(): 获取所有的 dojo/dijit 配置值。 getDjConfigOption($option, $default = null): 获取一单个的 dojo/dijit 配置值。 addStylesheetModule($module): 基于模块主题添加风格。 getStylesheetModules(): 获取注册为模块主题的风格。 addStylesheet($path): 添加一个本地风格来和 Dojo 一起使用。 getStylesheets(): 获取本地 Dojo 风格。 addOnLoad($spec, $function = null): 为 dojo.onLoad 添加一个 lambda 来调用。如果传递一个参数，那就是 函数名或一个 javascript closure。如果传递两个参数，第一参数是 对象实例变量的名字，第二个参数是该对象的方法名或使用这个对象的 一个 closure。 getOnLoadActions(): 获取所有用容器注册的 dojo.onLoad 动作，将是一个数组的数组。 onLoadCaptureStart($obj = null): 为 dojo.onLoad() 抓取用做 lambda 的数据。如果提供了 $obj， 那么 JS 抓取代码被认为是一个和 Javascript 对象一起使用的 closure 。 onLoadCaptureEnd($obj = null): 停止为使用 dojo.onLoad() 抓取数据。 javascriptCaptureStart(): 抓取任意的 javascript 包含到 Dojo JS （onLoad、 require 等语句）。 javascriptCaptureEnd(): 停止抓取 javascript。 __toString(): 转换容器为字符串；解析所有的 HTMl 风格和脚本元素。