查看: 2082|回复: 0

[.NET源码] asp.net core新特性之TagHelper标签助手

发表于 2018-1-13 09:29:03

今天开始,我就来说说asp.net core的新特性,今天就说说TagHelper标签助手。虽然学习.net,最有帮助的就是microsoft的官方说明文档了,里面把一些使用说明都写的非常清楚,但奈何.net core放入文档微软还没来得及翻译,对于英文不好的人来说简直就是看的艰辛。所以今天就来学习学习这标签助手,和博客园大佬分享分享经验。

  想看Microsoft官方文档和Git项目的可以直接点击以下传送门~~

  asp.net core 官方文档

  asp.net core github项目

  说起TagHelper给我的印象,有点像asp.net form当中的服务器端控件,又有点像Angular或者Vue当中的“组件”的后端实现版本。用户可以将一组html标签集合转换为一个自定义标签,实现了html代码的复用。

  那么正文开始~~

  首先,我们需要安装一个vs2017插件:Razor Language Services。这个插件能在html中智能提示用户自定义的标签助手。

  https://marketplace.visualstudio ... zorLanguageServices

创建一个asp.net core项目

使用微软定义的标签助手,在安装了插件后,使用标签助手的标签会进行高亮显示

上图中environment、link、a标签均使用了标签助手实现各自的功能

  1. <a asp-area="" asp-controller="Home" asp-action="Index" class="navbar-brand">taghelpersample</a>
复制代码

a标签中通过使用asp-controller,asp-action自定义属性来实现路由访问。

这时有人会说,我也可以使用@Html类来实现相同功能,为什么需要使用TagHelper?

  1. @Html.ActionLink("taghelpersample", "Index", "Home",null, new { Class = "navbar-brand" })
复制代码

确实,使用@Html帮助类我们能实现相同的功能,但是使用标签助手的方式不是更加符合html的标签语法吗,对于强迫症程序员简直就是福音~~。而且对于标签的原有属性的添加例如class,标签助手的使用也更加方便。

  1. <!--标签助手版form-->
  2. <form asp-controller="Home" asp-action="Index" class="form-horizontal" method="post">
  3. </form>
  4. <!--Html帮助类版form-->
  5. @using (Html.BeginForm("Index", "Home", FormMethod.Post,, new { Class = "form-horizontal" }))
  6. {
  7. }
复制代码

此外,标签助手的另外一个特色就是可以自定义,具体步骤如下:

(1)创建派生自TagHelper类的Class

  1. //类会默认转换为<text-collection></text-collection>
  2.    public class TextCollectionTagHelper:TagHelper
  3. {
  4. public override void Process(TagHelperContext context, TagHelperOutput output)
  5. {
  6. base.Process(context, output);
  7. }
  8. }
复制代码

(2)设置属性与基本类

  1. public string Color { get; set; }
  2. public override void Process(TagHelperContext context, TagHelperOutput output)
  3. {
  4. output.TagName = "div";
  5. output.Attributes.Add("style", "color:" + Color);
  6. var text = "Hello,World";
  7. var h1 = new TagBuilder("h1");
  8. var h2 = new TagBuilder("h2");
  9. var h3 = new TagBuilder("h3");
  10. var h4 = new TagBuilder("h4");
  11. var h5 = new TagBuilder("h5");
  12. var h6 = new TagBuilder("h6");
  13. h1.InnerHtml.Append(text);
  14. h2.InnerHtml.Append(text);
  15. h3.InnerHtml.Append(text);
  16. h4.InnerHtml.Append(text);
  17. h5.InnerHtml.Append(text);
  18. h6.InnerHtml.Append(text);
  19. output.Content.AppendHtml(h1);
  20. output.Content.AppendHtml(h2);
  21. output.Content.AppendHtml(h3);
  22. output.Content.AppendHtml(h4);
  23. output.Content.AppendHtml(h5);
  24. output.Content.AppendHtml(h6);
  25. }
复制代码

(3)在_ViewImports.cshtml导入类命名空间

  1. @addTagHelper *,taghelpersample
复制代码

(4)在cshtml中使用标签助手

  1. <text-collection color="red"></text-collection>
  2. <text-collection color="blue"></text-collection>
  3. <text-collection color="#666"></text-collection>
复制代码

(5)调试效果

OK,今天关于TagHelper就分享到这。

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持程序员之家



回复

使用道具 举报