當(dāng)前位置：首頁 > 前端技术 > vue >内容正文

vue

BeetleX之vue-autoui自匹配UI插件

發(fā)布時間：2023/12/4 vue 42 豆豆

生活随笔收集整理的這篇文章主要介紹了 BeetleX之vue-autoui自匹配UI插件小編覺得挺不錯的,現(xiàn)在分享給大家,幫大家做個參考.

vue-autoui 是一款基于vue和element擴展的一個自動化UI控件，它主要提供兩個控件封裝分別是auto-form和auto-grid; 通過這兩個控件可以完成大多數(shù)的信息輸入和查詢輸出的需要.auto-form和auto-grid是通過json來描述展示的結(jié)構(gòu)，在處理上要比寫html標(biāo)簽來得方便簡單，但這控件的最大優(yōu)勢并不是在這里，它最重要的功能是可以結(jié)合webapi的信息來自動輸出界面，只需要調(diào)整webapi的信息結(jié)構(gòu)即可完成UI的調(diào)整。

基礎(chǔ)使用

控件可以直接在vuejs功能中使用，但需要結(jié)合json來設(shè)置具體UI展示，以下是一個簡單的例子

<auto-form ref="form" v-model="data" size="mini" :info="info"></auto-form><el-button @click="if($refs.form.success()){alert(JSON.stringify(data))}">確定</el-button>

功能很簡單就是顯示當(dāng)前輸入并驗證通過的數(shù)據(jù)，下面用json描述信息輸入源。

data(){return {info: { items: [] },data: { },};},mounted(){var items = [];items.push({name: 'active', label: '活動名稱', rules: [{ required: true, message: '請輸入活動名稱', trigger: 'blur' },{ min: 3, max: 5, message: '長度在 3 到 5 個字符', trigger: 'blur' }]});items.push({name: 'region', label: '活動區(qū)域', type: 'select',data: [{ value: '廣州' }, { value: '深圳' }, { value: '上海' }, { value: '北京' }],rules: [{ required: true, message: '請選擇活動區(qū)域', trigger: 'change' }],eof: true});items.push({ name: 'starttime', label: '開啟時間', type: 'date', rules: [{ type: 'date', required: true, message: '請選擇日期', trigger: 'change' }] });items.push({ name: 'endtime', label: '-', type: 'date', eof: true, rules: [{ type: 'date', required: true, message: '請選擇日期', trigger: 'change' }] });items.push({ name: 'instant', type: 'switch', label: '即時配送', eof: true });items.push({name: 'nature', type: 'checkbox', label: '活動性質(zhì)',rules: [{ type: 'array', required: true, message: '請至少選擇一個活動性質(zhì)', trigger: 'change' }],data: [{ value: '美食/餐廳線上活動' }, { value: '地推活動' }, { value: '線下主題活動' }, { value: '單純品牌暴光' }], eof: true});items.push({name: 'resource', label: '特殊資源', type: 'radio', rules: [{ required: true, message: '請選擇活動資源', trigger: 'change' }],data: [{ value: '線上品牌商贊助' }, { value: '線下場地免費' }], eof: true});items.push({ name: 'remark', label: '活動形式', type: 'remark', rules: [{ required: true, message: '請?zhí)顚懟顒有问?#39;, trigger: 'blur' }] })this.info = { items: items}}

以上是使用json來描述一個輸出的界面，具體效果如下:

雖然用json來描述界面會比html描述會方便一些，但總體上來說工作量還是有些大的，在調(diào)整界面的時候也不方便。接下介紹一下如何結(jié)合BeetleX.FastHttpApi來進一步簡化這些繁瑣的操作。

Webapi動態(tài)輸出

其實在構(gòu)建vue-autoui的時候更多是考慮和BeetleX.FastHttpApi進行一個整合，通過和后端融合可以把這些UI編寫的工作量大大節(jié)省下來，讓開發(fā)這些功能變得更簡單方便，更重要的是api變化后界面就自動適應(yīng)。使用要求：在和BeetleX.FastHttpApi整合還需要引用BeetleX.FastHttpApi.ApiDoc插件，因為這個插件用于給接口輸出對應(yīng)UI的JSON信息。接下來通過幾個示例來介紹整合的方便性：

登陸

登陸功能是比較常見的，接下來看一下使用auto-form如何結(jié)合webapi來完成這個功能。

以上是一個登陸功能UI的定義，是不是很簡單呢？通過指定url的webapi連接即可以自動適應(yīng)UI;這時候只需要針對登陸接口進行一個定義即可:

[Input(Label = "用戶名", Name = "name", Eof = true)][Required("用戶名不能為空", Name = "name")][Input(Label = "密碼", Name = "pwd", Type = "password", Eof = true)][Required("用戶密碼不能為空", Name = "pwd")][Input(Label = "保存狀態(tài)", Value = true, Name = "saveStatus")]public bool Login(string name, string pwd, bool saveStatus){Console.WriteLine($"name:{name} pwd:{pwd} saveStatus:{saveStatus}");return name == "admin";}

注冊

接下來定義一個信息多些的注冊界面

在UI定義上基于沒什么變化，只是調(diào)整一下對應(yīng)的url地址，在這里多了一下completed事件，這個事件主要是通過接口加載UI信息才會觸發(fā)的。對應(yīng)功能的javascript代碼

data(){return {register: new beetlexAction('/register', {}),checkConfirmPassword: (rule, value, callback) => {var password = this.$refs.login.getField('Password');var cpassword = this.$refs.login.getField('ConfirmPassword');if (password.value != cpassword.value)callback(new Error('確認密碼不正確!'));elsecallback();},}},methods: {onCompleted(){this.$refs.login.getField('ConfirmPassword').rules.push({ validator: this.checkConfirmPassword, trigger: 'blur' });},},mounted() {this.register.requested = (r) => {alert(JSON.stringify(r));};}

代碼主要是定密碼和確認密碼的對比驗證，接下來看一下后臺注冊對應(yīng)的接口

[Post]public RegisterDto Register(RegisterDto register){Console.WriteLine(Newtonsoft.Json.JsonConvert.SerializeObject(register));return register;}public class RegisterDto{[Input(Label = "用戶名", Eof = true)][Required("用戶名不能為空")][DataRange("用戶名的必須大于3個字符", Min = 3)]public string Name { get; set; }[Input(Label = "郵箱地址", Eof = true)][Required("郵件地址無效", Type = "email")]public string Email { get; set; }[Input(Label = "密碼", Eof = true, Type = "password")][Required("輸入密碼")]public string Password { get; set; }[Input(Label = "確認密碼", Eof = true, Type = "password")][Required("輸入確認密碼")]public string ConfirmPassword { get; set; }[GenderInput(Label = "性別", Value = "男", Eof = true)]public string Gender { get; set; }[Required("選擇所在城市")][CityInput(Label = "城市", Eof = true)]public string City { get; set; }[HobbyInput(Label = "愛好")][Required("選擇愛好", Type = "array", Trigger = "change")]public string[] Hobby { get; set; }}

服務(wù)代碼也沒太多的變化，只是通過一些標(biāo)簽來標(biāo)記一下相關(guān)屬性的數(shù)據(jù)源和輸入要求.具體運行效果如下:

數(shù)據(jù)列表

有應(yīng)用中除了數(shù)據(jù)輸出外更多的數(shù)據(jù)列表，auto-grid即是專門用于處理列表的一個控件，這個控件提供分頁，選擇，編輯和刪除的功能；接下來做一個簡單的雇員列表示例:

<auto-grid url="/employees" @completed="employees.get()"@itemchange="onItemChange" @itemdelete="onItemDelete"@command="onCommand":data="employees.result" size="mini" height="100%" edit="true" delete="true"> </auto-grid>

這個列表提供編輯和刪除功能，相關(guān)腳本代碼如下:

data(){return {employees: new beetlexAction('/employees', {}, [])}},methods: {onCommand(e){this.$open('models-employee', e.data);},onItemChange(item){if (confirm('是否要修改' + item.data.FirstName + '?')) {item.success();}},onItemDelete(item){if (confirm('是否要刪除' + item.data.FirstName + '?')) {item.success();}},},mounted() {}

接下來的工作就是在服務(wù)端定義api來輸出結(jié)果

[Column("FirstName", Type = "link")][Column("LastName", Read = true)][Column("Title")][Column("HomePhone")][Column("City")][Column("Address")]public object Employees(){return DataHelper.Defalut.Employees;}

動態(tài)查詢

實際應(yīng)用中需要提供查詢條件輸入，這個時候就可以把auto-form和auto-grid整合起來，以下通過一個簡單的訂單查詢來展示這兩個控件結(jié)合使用

<auto-form url="/orders" v-model="orders.data" @completed="orders.get()" size="mini" @fieldchange="orders.get()"></auto-form><auto-grid url="/orders" height="300" :data="orders.result.items" :pages="orders.result.pages" :currentpage="orders.result.index" @pagechange="onPageChange" size="mini"></auto-grid>

可以在auto-form的fieldchange事件中自動執(zhí)行查詢,對應(yīng)的腳本代碼如下:

data(){return {orders: new beetlexAction("/orders", {}, { index: 0, pages: 0, items: [] })};},methods: {onPageChange(page){this.orders.data.index = page;this.orders.get();},},mounted(){}

接下來需要實現(xiàn)服務(wù)端代碼，由于方法需要描述輸入和列表所以對應(yīng)的標(biāo)簽比較多

[Input(Name = "id", Type = "select", DataUrl = "/EmployeeSelecter", Label = "雇員",NullOption =true)][Input(Name = "customerid", Type = "select", DataUrl = "/CustomerSelecter", Label = "客戶",NullOption =true, Eof = true)][SizeInput(Name = "size", Label = "分頁記錄數(shù)")][Input(Name = "index", Hide = true)][Column("OrderID", Read = true)][Column("EmployeeID", Type = "select", DataUrl = "/EmployeeSelecter")][Column("CustomerID", Type = "select", DataUrl = "/CustomerSelecter")][Column("OrderDate", Type = "date")][Column("RequiredDate", Type = "date")][Column("ShippedDate", Type = "date")]public object Orders(int id, string customerid, int index, int size, IHttpContext context){Func<Order, bool> exp = o => (id == 0 || o.EmployeeID == id)&& (string.IsNullOrEmpty(customerid) || o.CustomerID == customerid);int count = DataHelper.Defalut.Orders.Count(exp);if (size == 0)size = 20;int pages = count / size;if (count % size > 0)pages++;var items = DataHelper.Defalut.Orders.Where(exp).Skip(index * size).Take(size);return new { pages, index, items };}

插件詳細代碼?https://github.com/IKende/BeetleX-Samples/tree/master/Web.AutoUI

總結(jié)

以上是生活随笔為你收集整理的BeetleX之vue-autoui自匹配UI插件的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔推薦給好友。

上一篇：基于 Roslyn 实现一个简单的条件解
下一篇： .NET Core开发实战（第27课：定