您现在的位置是:网站首页> 编程资料编程资料
解读ASP.NET 5 & MVC6系列教程(13):TagHelper_自学过程_
2023-05-24
363人已围观
简介 解读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所在的命名空间 */
这种方式,抛去了服务器端代码,利用自定义html属性显得更加有语义,前端人员开起来也很舒服,极大地提高了前端开发人员的效率。
在默认的TagHelper实现里,不同的元素支持不同的自定义属性,以实现不同的用途,例如大部分元素都支持asp-for,而a元素则支持asp-controller和asp-action等,input元素最强大的,支持各种类型的type以及相关的格式。详细实现,请参考如下章节中的表格内容。
A元素
| 属性 | 描述 |
|---|---|
| asp-controller | Controller的名称 |
| asp-action | Action的名称 |
| asp-host | 网站的Host |
| asp-fragment | URL的fragment名称 |
| asp-protocol | 网站协议(http或https) |
| asp-route | Route名称 |
| asp-route- | |
| href | 默认属性,如果href有值,则其它属性都不能设置任何值。 |
Form元素
| 属性 | 描述 |
|---|---|
| asp-controller | Controller的名称 |
| asp-action | Action的名称 |
| asp-anti-forgery | |
| asp-route- | |
| action | 默认属性,如果action有值,则其它属性都不能设置任何值。 |
Input元素
| 属性 | 描述 |
|---|---|
| asp-for | 模型字段的名称 |
| asp-format | 设置Type格式,具体如下: |
| 格式 | 标准类型 |
|---|---|
| HiddenInput | hidden |
| Password | password |
| Text | text |
| PhoneNumber | tel |
| Url | url |
| EmailAddress | |
| Date | date |
| DateTime | datetime |
| DateTime-local | datetime-local |
| Time | time |
| Byte/SByte/Int16/UInt16/Int32/UInt32/Int64/UInt64/Single/Double | number |
| Boolean | checkbox |
| Decimal | text |
| String | text |
| IFormFile | file |
| IEnumerable`IFormFile | file |
其中关于时间的具体格式如下:
| 属性 | 描述 |
|---|---|
| date | {0:yyyy-MM-dd} |
| datetime | {0:yyyy-MM-ddTHH:mm:ss.fffK} |
| datetime-local | {0:yyyy-MM-ddTHH:mm:ss.fff} |
| time | {0:HH:mm:ss.fff} |
Label元素
| 属性 | 描述 |
|---|---|
| asp-for | 模型字段的名称 |
textarea元素
| 属性 | 描述 |
|---|---|
| asp-for | 模型字段的名称 |
span元素
| 属性 | 描述 |
|---|---|
| asp-validation-for | 模型字段的名称 |
div元素
| 属性 | 描述 |
|---|---|
| asp-validation-aummary | ValidationSummary枚举值: ValidationSummary.All ValidationSummary.ModelOnly ValidationSummary.None。 |
验证描述类型,只有选择了ValidationSummary.All和ValidationSummary.ModelOnly才能渲染该div元素。
select元素
| 属性 | 描述 |
|---|---|
| asp-for | 模型字段名称 |
| asp-items | 模型字段名称 |
link元素
| 属性 | 描述 |
|---|---|
| asp-href-include | |
| asp-href-exclude | |
| asp-fallback-href | 默认href加载失败时的备用地址 |
| asp-fallback-href-include | |
| asp-fallback-href-exclude | |
| asp-fallback-test-class | 判断加载失败时用到的class样式 |
| asp-fallback-test-property | 判断加载失败时用到的class样式中的属性 |
| asp-fallback-test-value | 判断加载失败时用到的class样式中的属性对应的值 |
| asp-file-version | |
| href | 默认加载的css文件地址。 |
link的使用示例如下,比如我们定义如下代码:
则该段代码表示,默认先加载aspnetcdn.com上的css文件,如果加载失败了,再加载本地网站里的css文件,加载失败的判断条件是:检测carousel-caption样式十分应用上了,即该应用了该样式的元素的display属性是否等于none。运行网站后,这段代码的生成html如下:
从中,我们看到,生成的HTML代码在link元素之后多了两个元素,一个是带有class="carousel-caption"属性的meta元素,一个是script脚本标签。其主要原理是如下:
在meta元素上应用定义的carousel-caption样式。通过JS代码检测该meta元素的display属性是否等于none。如果不等于none,重新加载本地的备用css文件。
注意,这里的js脚本是利用document.getElementsByTagName("SCRIPT"),获取最后一个SCRIPT标签的上一个兄弟元素的形式,来获取meta元素的。
script元素
| 属性 | 描述 |
|---|---|
| asp-src-include | |
| asp-src-exclude | |
| asp-fallback-src | 备用js文件地址 |
| asp-fallback-src-include | |
| asp-fallback-src-exclude | |
| asp-fallback-test | 判断默认js文件是否加载成功用到的对象 |
| asp-file-version | |
| src | 默认的js文件地址。 |
script标签元素的fallback功能,和link元素记载css文件类型,只不过这里判断的不是class样式,而是检测某个对象是否存在,来判断默认的js文件是否加载成功,示例如下:
生成后的HTML代码,相对比较简单,示例如下:
多生成了一个script标签元素,然后判断jQuery对象是否存在,如果不存在则表示加载失败,那就再加载本地的备用js文件。
Cache
| 属性 | 描述 |
|---|---|
| vary-by | |
| vary-by-header | |
| vary-by-query | |
| vary-by-route | |
| vary-by-cookie | |
| vary-by-user | |
| expires-on | |
| expires-after | |
| expires-sliding | |
| priority | |
| enabled | . |
利用EnvironmentTagHelper来控制不同运行环境的输出结果
在很多情况下,我们想再开发环境使用一套配置信息,在生产环境又是另外一套,这时候就需要使用条件判断语句了,不过在新版的MVC中,使用EnvironmentTagHelper提供的Environment元素标签就可以了,示例如下:
在上述代码中,我们定于,如果是Development环境就使用本地的js文件,否则(Staging或Production环境)就先加载cdn的文件(只不过还留有备用方案)。
该names里的值判断依据是,查找IHostingEnvironment的EnvironmentName属性,并与其进行比较,然后再进行相应的处理。
自定义TagHelper
MVC所有TagHelper的实现,都继承了Microsoft.AspNet.Razor.Runtime.TagHelpers.ITagHelper接口,所以我们只要实现该接口就可以实现自定义的TagHelper,该接口的定义如下:
public interface I
相关内容
- 解读ASP.NET 5 & MVC6系列教程(12):基于Lamda表达式的强类型Routing实现_自学过程_
- 解读ASP.NET 5 & MVC6系列教程(11):Routing路由_自学过程_
- 解读ASP.NET 5 & MVC6系列教程(10):Controller与Action_自学过程_
- 解读ASP.NET 5 & MVC6系列教程(9):日志框架_自学过程_
- 解读ASP.NET 5 & MVC6系列教程(8):Session与Caching_自学过程_
- 解读ASP.NET 5 & MVC6系列教程(7):依赖注入_自学过程_
- 微信公众平台开发之获得ACCESSTOKEN .Net代码解析_实用技巧_
- 解读ASP.NET 5 & MVC6系列教程(6):Middleware详解_自学过程_
- 微信公众平台开发之认证"成为开发者".Net代码解析_实用技巧_
- ABP框架中的日志功能完全解析_实用技巧_
点击排行
本栏推荐
