在早期版本BeetleX.WebFamily只提供了vuejs+element的集成,由于element只适合PC管理应用开发相对于移动应用适配则没这么方便。在新版本组件集成了bootstrap5可以更好地适配移动Web应用;同时也集成了Fontawesome和bootstrapIcons,这样在开发过程中使用字体图标就更方便了。
在开发时以上组件并不会打包到一起,而是根据实际需要选择element或bootstrap作为当前应用的样式主题,而基础开发框架还是基于vuejs,ajax数据交互则使用axios。
使用
在使用之前还是选了解一下BeetleX.WebFamily是如何开发SPA应用,并有那些基础功能BeetleX.WebFamily针对Web SPA应用的改进。第一步使用vs或vscode创建控台项目,引用BeetleX.WebFamily后在main方法中添加以下代码:
class Program
{static void Main(string[] args){WebHost host = new WebHost();host.RegisterController<Program>().Setting(o =>{o.SetDebug();o.Port = 80;o.LogLevel = EventArgs.LogType.Info;o.LogToConsole = true;}).UseFontawesome()//加入Fontawesome.UseBootstrap(PageStyle.Bootstrap)//设置使用bootstrap.Initialize((http, vue, resoure) =>{vue.Debug();}).Run();}
}
启动项目后,可以从浏览器访问得到以下结果:
以上是基于bootstrap的SPA应用默认主页,当然这并不是你所需要的。
定义功能
接下来在Main方法修改SPA应用的内容,通过修改这些配置可以让你马上把主页更换成实际应用的功能。
class Program
{static void Main(string[] args){//更改应用标题WebHost.Title = "beetlex & bootstrap!";//更新应用LogoWebHost.LogoImg = "/images/icons-hero.png";//设置头部组件WebHost.HeaderModel = "custom-header";//设置需要登陆WebHost.MustLogin = true;//定义页面的功能菜单WebHost.GetMenus = (usr, role, http) =>{List<Menu> result = new List<Menu>();var item = new Menu();item.ID = "home";item.Img = "fas fa-home";item.Name = "主页";item.Model = "webfamily-home";result.Add(item);//....return Task.FromResult(result);};WebHost host = new WebHost();host.RegisterController<Program>().Setting(o =>{o.SetDebug();o.Port = 80;o.LogLevel = EventArgs.LogType.Info;o.LogToConsole = true;}).UseJWT()//开启jwt验证.UseFontawesome()//开启Fontawesome.UseBootstrap(PageStyle.Bootstrap)//开启bootstrap.Initialize((http, vue, resoure) =>{resoure.AddCss("website.css");//加入本项目的CSSresoure.AddScript("echarts.js");//加入本项目的jsvue.Debug();}).Run();}
}
由于开启了登陆和验证,所以这一次访问页面会默认是一个登陆窗体
登陆后就可以进行主页面了,这里并没有定义登陆过程,任意用户密码都能登陆成功能。
自动适配手机端下的效果。
组件针对bootstrap提供两种菜单布局方式,上面设置的是顶部菜单,可以通过配置来实现右边菜单显示;只需要调整以下代码即可:
.UseBootstrap(PageStyle.BootstrapDashboard)
以上BeetleX.WebFamily使用bootstrap5开发SPA应用的效果,组件现有已经提升为开源项目,了解项目和示例可访问:
https://github.com/beetlex-io/WebFamily
BeetleX
开源跨平台通讯框架(支持TLS)
提供高性能服务和大数据处理解决方案
https://beetlex.io