扩展dreamweaver：自定义第三方标签的解析_drea…

扩展 Dreamweaver：自定义第三方标签的解析

因为最近一直在做 Dreamweaver 插件的研发，中文的资料很少，自己英文又差，查看英文资料的时候不由头昏脑胀。迫不得已把其中一些重要的内容翻译成中文之后，看的时候才觉得爽快不少。本节选自 Dreamweaver 8 附带的《Extending Dreamweaver 8》，翻译的时候参考了一下侠客岛翻译的《Dreamweaver 4 中文帮助》。但是老实不客气地说，我有点怀疑那个帮助的某些部分是用金山快译之类的软件翻译的，反正读起来比英文还难懂。

服务器端技术，比如ASP、Macromedia ColdFusion，JSP，连同 PHP 在 HTML 文档里面使用特别的非 HTML 语法，服务器在这些代码的基础上创建和提供 HTML 格式的内容。当 Dreamweaver 检测到非 HTML 标签，Dreamweaver 会调用第三方标签的定义文档来比较他们，这些文档指定 Dreamweaver 如何读取和显示这些标签。

举个例子，在标准的 HTML 语言之外，ASP 文档还包含了供服务器解析的 ASP 代码。ASP 代码看起来和 HTML 标签类似，他由一对标签，开始的 <% 和关闭的 %>，来作标记。在 Dreamweaver 的 Configuration/ThirdPartyTags 文档夹里有一个名为 Tags.xml 的文档，这个文档就是用来描述包括 ASP 在内的各种第三方标签规范的，并定义了 Dreamweaver 如何来显示这些代码。使用这种方法，ASP 代码在 Tags.xml 中已被规范了，所以 Dreamweaver 不会再试着在 <%...%>之间解析任何代码。但是在设计视图里面，他会显示一个图标以表示这是 ASP 代码。您能够定义自己的标签，并且能为每套标签创建一个新的标签库文档，来指定 Dreamweaver 如何读取和显示您的标签。

注意：这部分说明了如何定义 Dreamweaver 显示一个自定义标签的方法，但是没有描述如何编辑自定义标签的内容或是属性。如何创建属性检查器来检查和修改自定义标签的属性，请查看属性检查器以获得相关信息。

每个标签库文档都会定义一个或多个自定义标签的名称、类型、内容模式、显示规范和图标。您能够创建任意数量的标签库文档，但是他们必须位于 Configuration/ThirdPartyTags 文档夹以便被 Dreamweaver 读取和处理。标签库文档使用 .xml 文档扩展名。

提示：假如您同时进行着好几个不同网站的工作（假定当您是个自由职业者的时候），您能够把任何的标签规范定义在一个文档里面，并存放在一个特别的站点上，将来由其他人维护这个站点的时候，您就能够完整地把包含自定义图标和属性检查器在内的标签库移交给他。

您需要使用一个名为 tagspec 的 XML 标签来定义一个标签规范。举例来说，下面的代码表示一个名为 happy 的标签规范。

<tagspec tag_name="happy" tag_type="nonempty" render_contents="false" content_model="marker_model" icon="happy.gif" icon_width="18" icon_height="18"></tagspec>

您能够使用 tagspec 来定义两种标签：
·HTML 格式的普通标签
happy 标签范例是个 HTML 格式的普通标签。他开始于 <happy> 标签，在开始标签和结束标签之间包含数据，最后结束于</happy> 标签。

·字符串界定的标签
字符串界定的标签用一个字符串开始，用另一个字符串结束，他们和 HTML 空标签（诸如 img 之类）有类似之处，因为他们既不包含内容也没有关闭标签。假如 happy 也是个字符串界定的标签，那他的定义规范里面必须包括 start_string 和 end_string 两个属性。ASP 标签都是字符串界定的标签，他们从 <% 开始，到 %> 结束，也没有关闭标签。

下面的信息罗列了 tagspec 标签的各个属性和有效值。带有星号（“*”）的属性表示不适用于字符串界定的标签，可选属性则使用了大括号（{}）来标识；不难推断，其他没有使用大括号标识的都属于必要的属性。

<tagspec>

说明

关于第三方标签的预设信息

属性

tag_name，{tag_type}，{render_contents}，{content_model}，{start_string}，{end_string}，{detect_in_attribute}，{parse_attributes}，icon，icon_width，icon_height，{equivalent_tag}，{is_visual}，{server_model}

tag_name 表示自定义的名称。对于字符串界定的标签，tag_name 仅用于检测一个特定的属性检查器是否适用于这个标签。假如属性检查器的第一行在符合规范的位置（其实就是在第一行的声明里面）包含了这个标签名并标上星号（“*”），那么这个检查器将被允许检查该类型的标签。举个例子，ASP 代码的标签名就是 ASP，允许检查 ASP 代码的检查器必须在第一行包含 *ASP*。关于属性检查器 API 的信息，请参看 属性检查器。

tag_type 确定这个标签是空的（像前面提到的 img 那样），还是允许在开始和关闭标签之间放置内容（像 code 标签那样）。这个属性对于普通（非字符串界定的）标签是必要的，但是对字符串界定的标签不生效，因为他们总是空的。有效值包括 "empty" 和 "nonempty"。

render_contents 确定在设计视图中，该标签显示内容，还是代之以特定的图标。该属性仅对非空标签是必要的，对于空标签则不生效（空标签本身没有内容可供显示）。该属性仅应用于插入到属性外部的标签，假如一个标签插入其他标签的属性值内，他的内容将不会显示（这一段有点难理解，我想到的是 RealMedia、Flash 之类的 Object，里面的那些 param 标签？）。有效值为 "true" 或是 "false"。

content_model 描述这个标签能包含哪种内容，更有这个标签能插入到 HTML 文档的什么地方。有效值包括 "block_model"，"head_model"，"marker_model"，连同"script_model"：

·block_model 表示该标签能够包含 div、p之类的块状对象，并且该标签只能够出现在 body 区域，或是插入到其他的 body-content 标签内，比如 div、layer 连同 td 等。

·head_model 表示该标签只能包含文字而且只能出现在 HEAD 范围内。

·marker_model 表示该标签能包含任何有效的 HTML 代码，并且能够放在 HTML 文档内的任何位置。Dreamweaver 内置的 HTML 检验程式将忽略定义为 marker_model 的标签。但是，检验程式不会忽略这些标签包含的内容；所以，尽管标签本身能够随处放置，但是他的内容却可能导致 HTML 的某些地方产生错误。例如，纯文本不能出现（除去合法的 head 元素）在文档的 head 区域，所以您不能把一个包含纯文本的 marker_model 标签放在 head 区域（假如您要这么做，那您必须把这个标签的内容模式由 marker_model 替换为 head_model）。使用 marker_model 的标签将会在一行内显示（位于 p 或 div 这样的块状元素内——举个例子，在一个段落里面），假如想让这个标签内显示他自己的段落，前后都留出空行，那么建议不要使用这个模式。

标签：

版权申明：本站文章部分自网络，如有侵权，请联系：west999com@outlook.com
特别注意：本站所有转载文章言论不代表本站观点，本站所提供的摄影照片，插画，设计作品，如需使用，请与原作者联系，版权归原作者所有