模板引擎开发（三）-自定义标签的处理
自定义标签大致可以理解为一个HTML代码块，也可以指向一个HTML文件。
在模板页中，很多地方需要相同的内容，例如页面的头部、尾部等，这个时候，可以利用自定义标签来定义HTML代码，然后在模板页中引用就可以了。
自定义标签的格式如下：
{%@ pageTop%} 页面顶部的顶部的自定义标签；
自定义标签中的HTML代码，我用了XML来记录，当然也有可视化的编辑界面来操作，在这里就不再缀述，只是说明一下原理即可，XML如下：
<Tag Uid="5895643"> <Name>PageTop</Name> <Type>page</Type> <Intro><![CDATA[所有页面的顶部]]></Intro> <Page>PageTop.html</Page> <Context><![CDATA[<div id="pagetop">logo 信息化动力核心 </div> <div></div>]]></Context> </Tag>
上述代码，标明了自定义标签的唯一标识、名称、类型（指定某个页面）、介绍、html文件名、html代码块；
说到这里就简单了，我们只需要把自定义标签从模板页中检索出来，替换成HTML代码就行了。代码如下：
/// <summary> /// 将模板内容中的所有自定义标签，替换为实际的值 /// </summary> /// <param name="html">要处理的模板对象</param> /// <returns></returns> public string Transact(TemplateBuider.PageTransact.Html html) { string patt = @"{%@\s*(\S[^\s%]+)\s*%}"; Regex rex = new Regex(patt, RegexOptions.Singleline); MatchCollection mc = rex.Matches(html.HtmlContext); for (int i = 0; i < mc.Count; i++) { Match ma = mc[i]; string key = ma.Groups[1].Value; //获取当前标签对象 Song.TemplateManager.Tags.CustomTag custom = _tags.Find(delegate(TemplateManager.Tags.CustomTag p) { return p.Name.ToLower() == key.ToLower(); }); if (custom == null) continue; //转换自定义标签中的路径，使之与当前模板页为相对路径 string context =_replacePath(html, custom); //将自定义标签合并到的模板 html.HtmlContext = Microsoft.VisualBasic.Strings.Replace(html.HtmlContext, ma.Value, context, 1, -1, Microsoft.VisualBasic.CompareMethod.Text); } return html.HtmlContext; }
上述代码有一些是我系统中相关方法，大家不必关注，关键是正则表达式。
可这个时候，有个问题。各个模板页并不在一个文件夹下，路径各不相同，自定义标签中的HTML如果有超链接，在模板页引用后，如果只是简单的替换，这些超链接就有可能出错，找不到指定的内容。所以，我们必须将自定义标签中的链接对象转换成当前模板的路径名。
思路是这样的，首先找出自定义标签的路径，如果自定义标签是指向HTML文件的，则按Html路径；如果是纯HTML代码，则以当前模板库的路径为路径；自定义标签中的所有链接，包括超链接、CSS引用、Js引用、iframe等，转换为相对于自定义标签路径的路径；然后找当前模板页的路径；将所有的链接转换为当前模板页的路径。
这中间牵涉到一个算法，从A文件到B文件的相对路径。举例说：A文件在/3/4/5/q/w/a.html，B文件在/3/4/6/s/b.html，如果A文件中写一个超链接引用B文件，这个超链接怎么写？
我这里写了一个方法。计算两个文件的相对路径，代码如下：
/// <summary> /// 计算两个文件的相对路径 /// </summary> /// <param name="baseFile">用于参照的文件，就从当前文件开始查找另一个文件</param> /// <param name="targetFile">目标文件，就是求它的相对路径</param> /// <returns>返回targetFile相对于baseFile的相对路径</returns> private string _getRelativePath(string baseFile, string targetFile) { baseFile = baseFile.Replace("\\", "/"); baseFile = baseFile.ToLower(); targetFile = targetFile.ToLower(); // while (baseFile.IndexOf("/") > -1 && targetFile.IndexOf("/") > -1) { string b = baseFile.Substring(0, baseFile.IndexOf("/")); string t = targetFile.Substring(0, targetFile.IndexOf("/")); if (b != t) break; baseFile = baseFile.Substring(baseFile.IndexOf("/") + 1); targetFile = targetFile.Substring(targetFile.IndexOf("/") + 1); } string path = ""; while (baseFile.IndexOf("/") > -1) { baseFile = baseFile.Substring(baseFile.IndexOf("/") + 1); path += "../"; } return path + targetFile; }
有了上面的方法，就好处理了，真正的超链接转换，就是正则匹配处理了。方法如下：
/// <summary> /// 将模板页中的路径处理成相对于当前模板页的路径 /// </summary> /// <param name="html"></param> /// <param name="tag"></param> /// <returns></returns> private string _replacePath(TemplateBuider.PageTransact.Html html, TemplateManager.Tags.CustomTag tag) { string context = tag.Context; //处理自定义标签中的超链接，使其相对于当前文件路径 string cutomPath = _cutomPath(tag); //将超链接处理为相对于模板页的路径 string linkExpr = @"(?<=\s+)(?<key>href|src|action|background[^=""']*)=([""'])?(?<value>[^'"">]*)\1?"; Regex regex = new Regex(linkExpr, RegexOptions.Multiline | RegexOptions.IgnorePatternWhitespace | RegexOptions.IgnoreCase); MatchCollection mc = regex.Matches(tag.Context); foreach (Match m in mc) { string link = m.Groups["value"].Value.Trim(); if (link == "") continue; //外网链接不处理，如Http://开头的超链接 if (new Regex(@"[a-zA-z]+://[^\s]*", RegexOptions.Singleline).IsMatch(link)) continue; //根路径不处理，如/manage/index.aspx，第一个字符是/ if (new Regex(@"^\/\w+.").IsMatch(link)) continue; //如果是参数标签，则不处理 if (new Regex(@"^{.+").IsMatch(link)) continue; //将超链接转换为相对于静态化目录的路径 link = _getCutomLinkPath(cutomPath, link); //将超链接转换为基于当前模板页的相对路径 link = _getRelativePath(html.TagetFile, link); link = m.Groups[2].Value + "=\"" + link + "\""; context = context.Replace(m.Value, link); } return context; }
在上述代码中，根路径不处理、站外链接不处理、以｛开头的链接不处理。
总结
我的这个自定义标签功能并不强，虽然自定义标签中也可以有其它组件，但其本质未变，只是HTML代码块的替换。本来想写带参数的自定义标签呢，这样就更类似于asp.net的用户控件，精力有限，暂时先这样吧。
