.net core页面使用layui的HtmlHelper扩展
Vino.Core.Extensions.Layui
如果您的.net core 2.0项目使用layui来渲染表单,那么您可以尝试使用这个扩展库可以帮你减少代码和工作量。
项目地址:https://github.com/kulend/Vino.Core.Extensions
安装方法
PM> Install-Package Vino.Core.Extensions.Layui -Version 2.0.2.1
dotnet add package Vino.Core.Extensions.Layui --version 2.0.2.1
使用方法
- 在Startup的ConfigureServices方法中
//使用Layui services.AddLayui();
- _ViewImports.cshtml文件中添加
@addTagHelper *, Vino.Core.Extensions.Layui
- 定义Model及其属性,例如:
public class DemoModel { /// <summary> /// ID /// </summary> [DataType("hidden")] public long Id { get; set; } /// <summary> /// 名称 /// </summary> [Required, MaxLength(20)] [Display(Name = "名称")] public string Name { get; set; } /// <summary> /// 地址 /// </summary> [MaxLength(256)] [Display(Name = "链接")] public string Url { get; set; } /// <summary> /// 序号 /// </summary> [Display(Name = "序号", Prompt ="0~9999")] public int OrderIndex { get; set; } = 0; /// <summary> /// 开关 /// </summary> [Display(Name = "开关", Prompt = "开|关")] public bool Switch { get; set; } = true; [Display(Name = "时间")] [DisplayFormat(DataFormatString = "yyyy-MM-dd HH:mm:ss")] //定义显示格式 [DataType(DataType.DateTime)] //也可以这样[DataType("datetime")] public DateTime? Date { set; get; } [Display(Name = "年份")] [DataType("year")] public int Year { set; get; } [Display(Name = "月份")] [DisplayFormat(DataFormatString = "现在是yyyy年MM月")] [DataType("month")] public string Month { set; get; } /// <summary> /// 枚举 /// </summary> [Display(Name = "性别")] public EmSex Sex { set; get; } /// <summary> /// 多行文本 /// </summary> [Display(Name = "备注", Prompt = "请输入您的备注信息...")] [MaxLength(500)] [DataType(DataType.MultilineText)] //或者[DataType("textarea")] public string Remark { set; get; } } /// <summary> /// 性别 /// </summary> public enum EmSex : short { [Display(Name = "保密")] Secret = 0, [Display(Name = "男")] Male = 1, [Display(Name = "女")] Female = 2 }
- 在form中使用@Html.InputFor,如
@using (Html.BeginForm<DemoModel>("Save")) { @Html.InputFor(x => x.Id) @Html.InputFor(x => x.Name) @Html.InputFor(x => x.Url) @Html.InputFor(x => x.OrderIndex) @Html.InputFor(x => x.Switch) @Html.InputFor(x => x.Date) @Html.InputFor(x => x.Year) @Html.InputFor(x => x.Month) @Html.InputFor(x => x.Sex) @Html.InputFor(x => x.Remark) @Html.ActionsForSubmitAndReset() }
Ok, 是不是很简单?
看下效果图:
-
其他说明
-
设定字段类型是int或short,这input标签会添加input-length-num样式css,如果是字符串字段,设定MaxLengthAttribute,长度>=50,添加样式"input-length-long",如果长度20~50,添加样式"input-length-middle",如果长度小于20,则添加样式"input-length-short"。用户可在css文件中自定义文本框宽度。
-
bool型字段默认会渲染成switch,lay-text需要这样设置:
[Display(Name = "开关", Prompt = "开|关")]
-
除了字段类型,很多时候需要DataTypeAttribute来判断渲染方式,默认为text,还可设置hidden,password,multilinetext,textarea,datetime,date,year,month,time等。multilinetext和textarea会渲染成Textarea。
-
关于Action按钮,
1). @Html.ActionsForSubmit(), 添加保存按钮(提交表单)。
2). @Html.ActionsForSubmitAndClose(), 添加保存和关闭按钮。
3). @Html.ActionsForSubmitAndReset(), 添加保存和重置按钮。
4). @Html.ActionsFor(btns), 添加自定义按钮,例如:
@Html.ActionsFor( new SubmitButton(), new CloseButton(), new ResetButton { Text = "重置表单" }, new ActionButton { Id = "btn_test", Text = "自定义按钮", Css = "btn-test", OnClick = "alert(1);" } )
效果图:
- 修改全局默认配置
//使用Layui services.AddLayui(opt => { opt.SubmitButtonText = "保 存"; //默认提交按钮文字 opt.CloseButtonTest = "关 闭";//默认关闭按钮文字 opt.ResetButtonText = "重 置";//默认重置表单按钮文字 opt.CloseButtonOnClick = "closeWindow()";//默认关闭按钮OnClick事件 });
- 关于laydate组件,需要在页面添加以下js脚本:
layui.use(['laydate'], function () { var $ = layui.jquery , laydate = layui.laydate; $(".layui-input.laydate").each(function () { var self = $(this); var type = self.data("type") || 'date'; var format = self.data("format") || 'yyyy-MM-dd'; laydate.render({ elem: self[0], type: type, format: format }); }); });
-
-
如有bug或其他建议,可以提交issue。也可邮件给我:kulend@qq.com