waibu-mpa 2.13.2 → 2.14.0

package/lib/class/widget.js

@@ -1,7 +1,8 @@
 import path from 'path'
 
 async function widgetFactory () {
-  const { kebabCase } = this.app.lib._
+  const { kebabCase, get } = this.app.lib._
+
   class MpaWidget extends this.app.baseClass.MpaTools {
     static scripts = []
     static css = []
@@ -21,6 +22,9 @@ async function widgetFactory () {
       this.params = params
       this.block = {}
       this.setting = this._parseBase64Attr(this.params.attr.setting)
+      this.formData = get(this, `component.locals.${this.params.attr.keyLocals ?? 'form'}`, {})
+      this.oldData = get(this, `component.locals.${this.params.attr.keyOldData ?? 'oldData'}`, {})
+      this.schema = get(this, `component.locals.${this.params.attr.keySchema ?? 'schema'}`, {})
     }
 
     _parseBase64Attr = (text, defValue = {}) => {
@@ -93,6 +97,47 @@ async function widgetFactory () {
       if (!escape) return content
       return content.replaceAll("'", "\\'")
     }
+
+    getProp = (name) => {
+      const { find } = this.app.lib._
+      const prop = find(this.schema.properties ?? [], { name }) ?? {}
+      return prop
+    }
+
+    getRef = ({ field, refName, returning } = {}) => {
+      const { get, find } = this.app.lib._
+      const prop = find(this.schema.properties ?? [], p => p.name === field)
+      if (!prop) return {}
+      if (!refName && field.endsWith('Id')) refName = field.slice(0, -2)
+      const key = this.params.attr.refName ?? refName
+      const ref = get(prop, `ref.${key}`, {})
+      if (returning === 'all') return { ref, key }
+      else if (returning === 'key') return key
+      return ref
+    }
+
+    getRefValue = ({ field, data, labelField, refName } = {}) => {
+      const { get, isEmpty } = this.app.lib._
+      const { ref, key } = this.getRef({ field, refName, returning: 'all' })
+      if (isEmpty(ref)) return undefined
+      labelField = labelField ?? ref.labelField ?? 'id'
+      return (get(data ?? this.formData, `_ref.${key}.${labelField}`))
+    }
+
+    getRefName = (field) => {
+      const { get } = this.app.lib._
+      let refName = get(this.schema, `view.widget.${field}.attr.ref-name`, this.params.attr.refName)
+      if (!refName && this.params.attr[field] && this.params.attr[field].endsWith('Id')) refName = this.params.attr[field].slice(0, -2)
+      return refName
+    }
+
+    getSetting = (key, defValue) => {
+      const { get, camelCase } = this.app.lib._
+      const widgetName = camelCase(this.constructor.name)
+      key = key.replaceAll('{self}', widgetName)
+      const cfg = this.app.waibu.getSetting(`${this.plugin.ns}:${key}`, { defValue, req: this.component.req })
+      return get(this.schema, `view.${key}`, cfg)
+    }
   }
 
   this.app.baseClass.MpaWidget = MpaWidget

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "waibu-mpa",
-  "version": "2.13.2",
+  "version": "2.14.0",
   "description": "MPA support for Waibu Framework",
   "main": "index.js",
   "scripts": {

package/wiki/CHANGES.md

@@ -1,5 +1,13 @@
 # Changes
 
+## 2026-04-17
+
+- [2.14.0] Add data binding properties to ```Widget``` base class
+- [2.14.0] Add ```Widget.getRef()```
+- [2.14.0] Add ```Widget.getRefValue()```
+- [2.14.0] Add ```Widget.getRefName()```
+- [2.14.0] Add ```Widget.getSetting()```
+
 ## 2026-04-11
 
 - [2.13.2] Bug fix in ```Wmpa.parseValue()```