解读ASP.NET 5 & MVC6系列教程（13）：TagHelper
在新版的MVC6中，微软提供了强大的TagHelper功能，以便让我们摆脱如下的臃肿代码：
@Html.LabelFor(model=>model.FullName) @Html.EditFor(model=>model.FullName) @Html.ValidationMessageFor(model=>model.FullName)
引入新功能TagHelper以后，我们只需要这样定义就可以了，代码如下：
@addTagHelper"*,Microsoft.AspNet.Mvc.TagHelpers"/*这里需要首先引用TagHelper所在的命名空间*/ <labelasp-for="FullName"class="control-labelcol-md-2"></label> <divclass="col-md-10"> <inputasp-for="FullName"class="form-control"/> <spanasp-validation-for="FullName"></span> </div>
这种方式，抛去了服务器端代码，利用自定义html属性显得更加有语义，前端人员开起来也很舒服，极大地提高了前端开发人员的效率。
在默认的TagHelper实现里，不同的元素支持不同的自定义属性，以实现不同的用途，例如大部分元素都支持asp-for，而a元素则支持asp-controller和asp-action等，input元素最强大的，支持各种类型的type以及相关的格式。详细实现，请参考如下章节中的表格内容。
A元素
Form元素
Input元素
其中关于时间的具体格式如下：
Label元素
textarea元素
span元素
div元素
ValidationSummary.All
ValidationSummary.ModelOnly
ValidationSummary.None。
验证描述类型，只有选择了ValidationSummary.All和ValidationSummary.ModelOnly才能渲染该div元素。
select元素
link元素
link的使用示例如下，比如我们定义如下代码：
<linkrel="stylesheet" href="//ajax.aspnetcdn.com/ajax/bootstrap-touch-carousel/0.8.0/css/bootstrap-touch-carousel.css" asp-fallback-href="~/lib/bootstrap-touch-carousel/css/bootstrap-touch-carousel.css" asp-fallback-test-class="carousel-caption" asp-fallback-test-property="display" asp-fallback-test-value="none"/>
则该段代码表示，默认先加载aspnetcdn.com上的css文件，如果加载失败了，再加载本地网站里的css文件，加载失败的判断条件是：检测carousel-caption样式十分应用上了，即该应用了该样式的元素的display属性是否等于none。运行网站后，这段代码的生成html如下：
<linkrel="stylesheet"href="//ajax.aspnetcdn.com/ajax/bootstrap-touch-carousel/0.8.0/css/bootstrap-touch-carousel.css"/>
<metaname="x-stylesheet-fallback-test"class="carousel-caption"/>
<script>
!function(a,b,c){
vard,e=document,
f=e.getElementsByTagName("SCRIPT"),
g=f[f.length-1].previousElementSibling,
h=e.defaultView&&e.defaultView.getComputedStyle?e.defaultView.getComputedStyle(g):g.currentStyle;
if(h&&h[a]!==b){
for(d=0;d<c.length;d++){
e.write('<linkrel="stylesheet"href="'+c[d]+'"/>')
}
}
}("display","none",["\/lib\/bootstrap-touch-carousel\/css\/bootstrap-touch-carousel.css"]);
</script>
从中，我们看到，生成的HTML代码在link元素之后多了两个元素，一个是带有class="carousel-caption"属性的meta元素，一个是script脚本标签。其主要原理是如下：
在meta元素上应用定义的carousel-caption样式。通过JS代码检测该meta元素的display属性是否等于none。如果不等于none，重新加载本地的备用css文件。
注意，这里的js脚本是利用document.getElementsByTagName("SCRIPT")，获取最后一个SCRIPT标签的上一个兄弟元素的形式，来获取meta元素的。
script元素
script标签元素的fallback功能，和link元素记载css文件类型，只不过这里判断的不是class样式，而是检测某个对象是否存在，来判断默认的js文件是否加载成功，示例如下：
<scriptsrc="https://ajax.aspnetcdn.com/ajax/jquery/jquery-1.10.2.min.js" asp-fallback-src="~/lib/jquery/jquery.min.js" asp-fallback-test="window.jQuery"> </script>
生成后的HTML代码，相对比较简单，示例如下：
<scriptsrc="https://ajax.aspnetcdn.com/ajax/jquery/jquery-1.10.2.min.js">
</script>
<script>(window.jQuery||document.write("<scriptsrc=\"\/lib\/jquery\/jquery.min.js\"><\/script>"));</script>
多生成了一个script标签元素，然后判断jQuery对象是否存在，如果不存在则表示加载失败，那就再加载本地的备用js文件。
Cache
利用EnvironmentTagHelper来控制不同运行环境的输出结果
在很多情况下，我们想再开发环境使用一套配置信息，在生产环境又是另外一套，这时候就需要使用条件判断语句了，不过在新版的MVC中，使用EnvironmentTagHelper提供的Environment元素标签就可以了，示例如下：
<environmentnames="Development"> <scriptsrc="~/lib/jquery/jquery.js"></script> <scriptsrc="~/lib/bootstrap/js/bootstrap.js"></script> <scriptsrc="~/lib/hammer.js/hammer.js"></script> <scriptsrc="~/lib/bootstrap-touch-carousel/js/bootstrap-touch-carousel.js"></script> </environment> <environmentnames="Staging,Production"> <scriptsrc="https://ajax.aspnetcdn.com/ajax/jquery/jquery-1.10.2.min.js" asp-fallback-src="~/lib/jquery/jquery.min.js" asp-fallback-test="window.jQuery"> </script> <scriptsrc="https://ajax.aspnetcdn.com/ajax/bootstrap/3.0.0/bootstrap.min.js" asp-fallback-src="~/lib/bootstrap/js/bootstrap.min.js" asp-fallback-test="window.jQuery"> </script> <scriptsrc="https://ajax.aspnetcdn.com/ajax/hammer.js/2.0.4/hammer.min.js" asp-fallback-src="~/lib/hammer.js/hammer.js" asp-fallback-test="window.Hammer"> </script> <scriptsrc="https://ajax.aspnetcdn.com/ajax/bootstrap-touch-carousel/0.8.0/js/bootstrap-touch-carousel.js" asp-fallback-src="~/lib/bootstrap-touch-carousel/js/bootstrap-touch-carousel.js" asp-fallback-test="window.Zepto"> </script> </environment>
在上述代码中，我们定于，如果是Development环境就使用本地的js文件，否则（Staging或Production环境）就先加载cdn的文件（只不过还留有备用方案）。
该names里的值判断依据是，查找IHostingEnvironment的EnvironmentName属性，并与其进行比较，然后再进行相应的处理。
自定义TagHelper
MVC所有TagHelper的实现，都继承了Microsoft.AspNet.Razor.Runtime.TagHelpers.ITagHelper接口，所以我们只要实现该接口就可以实现自定义的TagHelper，该接口的定义如下：
publicinterfaceITagHelper
{
intOrder{get;}
TaskProcessAsync(TagHelperContextcontext,TagHelperOutputoutput);
}
不过，我们一般自定义的时候，只需要继承该接口的默认实现TagHelper类，并重载其虚方法Process方法即可，如下是几个示例，我们来详细研究一下。
1.在a元素上直接支持controller和action属性
publicclassATagHelper:TagHelper
{
[Activate]
publicIUrlHelperUrlHelper{get;set;}
publicstringController{get;set;}
publicstringAction{get;set;}
publicoverridevoidProcess(TagHelperContextcontext,TagHelperOutputoutput)
{
if(Controller!=null&&Action!=null)
{
varmethodParameters=output.Attributes.ToDictionary(attribute=>attribute.Key,
attribute=>(object)attribute.Value);
//删除所有的attributes，因为路由里已经可以自动生成了
output.Attributes.Clear();
output.Attributes["href"]=UrlHelper.Action(Action,Controller,methodParameters);
output.PreContent.SetContent("My");
}
}
}
2.自动识别Text文本中的链接，并提取出来
[TargetElement("p")]
publicclassAutoLinkerTagHelper:TagHelper
{
publicoverrideasyncTaskProcessAsync(TagHelperContextcontext,TagHelperOutputoutput)
{
varchildContent=awaitcontext.GetChildContentAsync();
//FindUrlsinthecontentandreplacethemwiththeiranchortagequivalent.
output.Content.SetContent(Regex.Replace(
childContent.GetContent(),
@"\b(?:https?://|www\.)(\S+)\b",
"<strong><atarget=\"_blank\"href=\"http://$0\">$0</a></strong>"));
}
}
3.条件判断
定义一个condiction，符合条件才显示该元素，示例如下（只有Model.Approved为true时才显示该元素）：
<pcondition="Model.Approved">©@Model.CopyrightYear-MyASP.NETApplication</p>
实现代码如下：
[TargetElement("div")]
[TargetElement("style")]
[TargetElement("p")]
publicclassConditionTagHelper:TagHelper
{
publicbool?Condition{get;set;}
publicoverridevoidProcess(TagHelperContextcontext,TagHelperOutputoutput)
{
//如果设置了condition，并且该值为false，则不渲染该元素
if(Condition.HasValue&&!Condition.Value)
{
output.SuppressOutput();
}
}
}
4.自定义元素的TagHelper
如果我们要为自定义元素定义TagHelper，则我们要符合约定规范，示例代码如下：
publicclassWebsiteInformationTagHelper:TagHelper
{
publicWebsiteContextInfo{get;set;}
publicoverridevoidProcess(TagHelperContextcontext,TagHelperOutputoutput)
{
output.TagName="section";
output.PostContent.SetContent(string.Format(
"<p><strong>Version:</strong>{0}</p>"+Environment.NewLine+
"<p><strong>CopyrightYear:</strong>{1}</p>"+Environment.NewLine+
"<p><strong>Approved:</strong>{2}</p>"+Environment.NewLine+
"<p><strong>Numberoftagstoshow:</strong>{3}</p>"+Environment.NewLine,
Info.Version.ToString(),
Info.CopyrightYear.ToString(),
Info.Approved.ToString(),
Info.TagsToShow.ToString()));
output.SelfClosing=false;
}
}
则使用的时候，我们需要使用website-information标签，并将info属性赋值一个强类型的值，示例如下：
<website-informationinfo="newWebsiteContext{
Version=newVersion(1,1),
CopyrightYear=1990,
Approved=true,
TagsToShow=30}"/>
其渲染结果，则是渲染成一个包含4个p元素的section元素。