ASP.NET Core MVC如何自定义Tag Helpers
这篇文章主要为大家展示了“ASP.NETCoreMVC如何自定义TagHelpers”,内容简而易懂,条理清晰,希望能够帮助大家解决疑惑,下面让小编带领大家一起研究并学习一下“ASP.NETCoreMVC如何自定义TagHelpers”这篇文章吧。
介绍通过创建自定义Tag Helpers,我们可以扩展现有元素或创建我们自己的元素。
Tag Helper是实现ITagHelper接口类的统称。MVC为我们提供了该接口的抽象类TagHelper,它位于Microsoft.AspNetCore.Razor.Runtime程序集中。因此,我们可以直接从TagHelper类继承,我们主要需要实现以下方法:
publicvirtualvoidProcess(TagHelperContextcontext,TagHelperOutputoutput);publicvirtualTaskProcessAsync(TagHelperContextcontext,TagHelperOutputoutput);
Process方法是具体的逻辑实现。它需要传递 Tag Helper上下文的实例和Tag Helper输出(我们可以用它来读取和更改Tag Helper范围内的实际内容)。
简单示例我们创建自己的Tag Helper。假设我们将使用<simple> </simple>Tag Helper,其中的内容将是粗体。
我们将要创建一个名为CustomTagHelpers的新项目。因此,程序集名称也将是CustomTagHelpers。
首先,我们创建一个新的Tag Helper。使用Visual Studio,我们可以这样操作添加 - > 新建项 - > Web - > Razor 标记帮助器。
这是默认生成的代码:
publicclassSimpleTagHelper:TagHelper{publicoverridevoidProcess(TagHelperContextcontext,TagHelperOutputoutput){}}
我们需要做的是将输出标签名称设置为strong:
publicclassSimpleTagHelper:TagHelper{publicoverridevoidProcess(TagHelperContextcontext,TagHelperOutputoutput){output.TagName="strong";}}
为了能够在我们的视图中使用新创建的Tag Helper,我们必须在ViewImports.cshtml文件中添加下面这一行:
@addTagHelper*,CustomTagHelpers
在_ @addTagHelper _指令后可以注意到两个字符串:
它的第二部分 -CustomTagHelpers表示从哪个程序集名称里加载Tag Helper;
第一个字符串在_ @addTagHelper _指令之后表示要加载的TagHelper的名称,通配符(*)表示我们将使用给定程序集中所有Tag Helper。
如果我们现在转到其中一个页面并写入如下代码:
<simple>CodingBlast</simple>
我们将在Visual Studio中看到这个**simple **的标签已经变成紫色,并且被识别为Tag Helper。如果我们运行应用程序,我们将以粗体显示此文本。
如果我们查看HTML输出,我们可以看到simple标签被strong所替代:
<strong>CodingBlast</strong>改变属性
我们来构建另外一个Tag Helper,作为img标签的另一种方式。我们将添加一个名称是CuteTagHelper
的新的Tag Helper。
usingMicrosoft.AspNetCore.Razor.TagHelpers;namespaceCustomTagHelpers.TagHelpers{[HtmlTargetElement("cute")]publicclassCuteTagHelper:TagHelper{publicstringImageLink{get;set;}publicstringAlternativeText{get;set;}publicoverridevoidProcess(TagHelperContextcontext,TagHelperOutputoutput){output.TagName="img";output.TagMode=TagMode.StartTagOnly;output.Attributes.SetAttribute("src",ImageLink);output.Attributes.SetAttribute("alt",AlternativeText);}}
如果我现在转到_.cshtml_文件并开始输入:
你可以看到**cute **的是紫色的,说明Visual Studio认为它是一个Tag Helper。此外,它为我们在CuteTagHelper
类中指定的两个属性提供了智能提示。
我们在TagHelper类中指定的任何公共属性将在.cshtml文件中显示为一个属性。
总结使用Tag Helper,我们可以使用属性扩展现有元素或创建新元素
一旦我们创建了一个Tag Helper,我们通常会有一个可重用的属性或元素
MVC附带的TagHelper类提供了编写Tag Helpers的方法和属性
Tag Helpers使用命名约定(就像MVC中的控制器一样),所以如果使用类名称CoolTagHelper,您将能够在代码中使用<cool>标签
以上是“ASP.NETCoreMVC如何自定义TagHelpers”这篇文章的所有内容,感谢各位的阅读!相信大家都有了一定的了解,希望分享的内容对大家有所帮助,如果还想学习更多知识,欢迎关注亿速云行业资讯频道!
声明:本站所有文章资源内容,如无特殊说明或标注,均为采集网络资源。如若本站内容侵犯了原著者的合法权益,可联系本站删除。