第四十五章 开发自定义标签 - 规则和操作

第四十五章 开发自定义标签 - 规则和操作

CSP允许你开发自定义的HTML标签用于CSP文件。CSP标记语言本身是使用自定义标记机制实现的。自定义标签提供了一种方式:

  • 使用熟悉的语法为HTML作者提供附加功能
  • 为web应用程序开发可重用的组件

规则和操作

CSP编译器将带标记的HTML文档转换成Caché类(参见“CSP编译器”)。CSP编译器的一些功能来自于它能够

  1. 识别CSP文档中嵌入的#()#表达式，以及
  2. 识别HTML(或XML)文档中的某些标签或标签组合，并用开发人员提供的动作替换它们。这被称为标签匹配，在本章中有所描述。

如果熟悉XML的XSL技术，会认识到CSP是XSL的一种变体，添加了额外的特性来为应用程序生成HTML。

以下CSP页面示例包含一个自定义标记<my:COMPANY>，该标记在HTML页面中显示公司名称:

<html>
<body>
<my:COMPANY>
</body>
</html>

处理该页面时，望CSP编译器用合适的HTML文本替换<my:COMPANY>标记，例如:

<html>
<body>
<b>Octoglomerate</b>
</body>
</html>

CSP编译器对<my:COMPANY>标记采取的操作是在带有<csr:action>标记的规则文件中定义的。规则文件是带有.csr (Caché Server Rule)文件扩展名的XML文档，它定义了识别标签的规则以及找到这些标签时要执行的操作。它还可以包括附加信息，例如规则的描述。

<my:COMPANY>标记的规则文件可能如下所示，并可能被命名为company.csr:

<csr:rule name="myCOMPANY" match="my:COMPANY" empty>
<csr:action>
<b>Octoglomerate</b>
</csr:action>
</csr:rule>

这个规则文件规定:

使用<csr:rule>标记，该文件定义了一个名为myCOMPANY的规则。
属性empty指定<my:COMPANY>标记没有结束标记。

规则名具有与Caché类相同的命名限制。
规则只在定义它的Caché名称空间中活动，以%开头的规则除外，这些规则定义在%SYS名称空间中，并且对所有其他名称空间可见。

<csr:action>标记指定要采取的操作。
<csr:action>标签的内容必须是HTML和以下任何一种:

  • #()# 表达式
  • ##()## 表达式
  • <script>标签
  • 附加的<csr:>标记(稍后讨论)。
  • <csr:action>标签不能包含CSP标签;
    也就是说，CSP编译器不对操作的内容执行标记转换。
 Do $System.CSP.LoadRuleFile("company.csr")

这会将指定文件中的规则定义加载到当前名称空间中。还可以使用Studio的File > New > Caché Server Page来加载和编译规则文件。将文件保存在/csp/user目录中。可以使用csp示例提供的rulemgr.csp页面来观察哪些规则是有效的。

CSP的大部分是使用规则文件实现的。可以在Studio、%SYS命名空间、工作区窗口、命名空间选项卡中的CSP文件下查看系统规则文件。

posted @   M技术分享  阅读(24)  评论(0)  编辑  收藏  举报
相关博文：
·  第四十七章 开发自定义标签 - 服务器文档对象模型
·  第二十六章 使用 CSP 进行基于标签的开发
·  jsp自定义标签
·  （13）JSP自定义标签开发
·  Web基础知识（15）- JSP (七) | JSP 标准标签库（JSTL）、JSP 自定义标签
阅读排行：
· TypeScript + Deepseek 打造卜卦网站：技术与玄学的结合
· Manus的开源复刻OpenManus初探
· AI 智能体引爆开源社区「GitHub 热点速览」
· C#/.NET/.NET Core技术前沿周刊 | 第 29 期（2025年3.1-3.9）
· 从HTTP原因短语缺失研究HTTP/2和HTTP/3的设计差异
点击右上角即可分享
微信分享提示
SQL AI 助手