BeetleX使用bootstrap5开发SPA应用
在早期版本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!";
- //更新应用Logo
- WebHost.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");//加入本项目的CSS
- resoure.AddScript("echarts.js");//加入本项目的js
- vue.Debug();
- }).Run();
- }
- }
由于开启了登陆和验证,所以这一次访问页面会默认是一个登陆窗体
登陆后就可以进行主页面了,这里并没有定义登陆过程,任意用户密码都能登陆成功能。
自动适配手机端下的效果。
组件针对bootstrap提供两种菜单布局方式,上面设置的是顶部菜单,可以通过配置来实现右边菜单显示;只需要调整以下代码即可:
- .UseBootstrap(PageStyle.BootstrapDashboard)
以上BeetleX.WebFamily使用bootstrap5开发SPA应用的效果,组件现有已经提升为开源项目,了解项目和示例可访问: