jufubao-third 1.0.19-beta2 → 1.0.19-beta3

package/docs/modules/uni-attr.md

@@ -898,14 +898,78 @@ handleCustom({ action, data }) {
 
 #### 1.3 XdFont 字体样式
 
-**功能**：配置文字样式，包括颜色、字号、行高、粗细、对齐等。
+**功能**：配置文字样式，包括颜色、字号、行高、粗细、对齐等。返回对象格式 `{color, fontSize, fontWeight, ...}`。
 
 **用途**：用于设置字体样式，如字号、颜色、粗细等，支持默认、自定义等选项。
 
-**完整例子**（在 Attr.js 中配置）：
+**返回值格式**：
+| 属性 | 类型 | 说明 |
+|------|------|------|
+| `color` | String | 文字颜色，如 `'#333'` |
+| `fontSize` | String | 字号，如 `'28rpx'` |
+| `fontWeight` | String/Number | 字重，如 `'normal'`、`'bold'` |
+| `lineHeight` | String | 行高，如 `'40rpx'` |
+| `textAlign` | String | 对齐方式 |
+
+**完整例子 — 配合 D/C 默认/自定义组**（在 Attr.js 中配置）：
 
 ```javascript
-// 来源：示例代码（可参考 JfbMallHomeProductList/cusAttr/style.js 中的 xd-text-and-bgc 配置）
+// 来源：/JfbThirdCopyUrl/cusAttr/content.js:145-190
+// 完整 D/C 组包装模式
+// D/C 单选
+{
+  label: '文字',
+  ele: 'xd-radio',
+  groupKey: 'content',
+  valueKey: 'btnFontStatus',
+  value: statusDataVal({data, key: 'btnFontStatus', fields: ['btnFont'], gValue}),
+  labelInline: true,
+  list: [
+    {label: '默认', value: 'D'},
+    {label: '自定义', value: 'C'},
+  ]
+},
+{ele: 'group_start'},
+{
+  label: '',
+  ele: 'xd-font',
+  groupKey: 'content',
+  valueKey: 'btnFont',
+  // 注意：xd-font 返回对象，dValue 设为 null
+  value: dataVal({data, key: 'btnFont', dValue: null, gValue}),
+  hidden: !statusShow({data, key: 'btnFontStatus', fields: ['btnFont'], gValue}),
+  setting: {
+    color: true,        // 文字颜色
+    fontSize: true,     // 字号（启用后必须配置 handleCustom）
+    weight: true,       // 字重
+    lineHeight: false,
+    align: false,
+    icon: false,
+    default: {
+      color: '#333',
+      fontSize: '28',
+      weight: 'normal',
+    },
+  },
+  // 启用 fontSize 时必须配置，用于获取字号选项列表
+  handleCustom({action, data}) {
+    XdBus.getParentApi('getOptionsSettingList')({setting_id: 'edtix_style_font_size'})
+      .then(res => {
+        data.cb(res.list)
+      })
+      .catch(error => {
+        console.error(error);
+        data.cb([])
+      });
+  },
+},
+{ele: 'group_end'},
+```
+
+**简化例子 — 无 D/C 组**（在 Attr.js 中配置）：
+
+```javascript
+// 来源：/JfbMallHomeProductList/cusAttr/style.js
 {
   label: '标题字体样式',
   ele: 'xd-font',
@@ -945,6 +1009,39 @@ handleCustom({ action, data }) {
 }
 ```
 
+**Vue 组件取值与样式应用**：
+
+```javascript
+// init 中获取 xd-font 返回值（对象格式）
+this.btnFont = gCPVal(container, 'btnFont', [{color: '#333', fontSize: '28rpx', fontWeight: 'normal'}], {
+  sKey: 'btnFontStatus', fields: ['btnFont']
+});
+
+// 应用到行内样式
+if(this.btnFont) {
+  if(this.btnFont.color) style.color = this.btnFont.color;
+  if(this.btnFont.fontSize) style.fontSize = this.btnFont.fontSize;
+  if(this.btnFont.fontWeight) style.fontWeight = this.btnFont.fontWeight;
+}
+```
+
+**setting 配置说明**：
+
+| 属性 | 类型 | 说明 |
+|------|------|------|
+| color | Boolean | 是否启用颜色选择 |
+| fontSize | Boolean | 是否启用字号选择（启用必须配置 handleCustom） |
+| weight | Boolean | 是否启用字重选择 |
+| lineHeight | Boolean | 是否启用行高设置 |
+| align | Boolean | 是否启用对齐方式 |
+| icon | Boolean | 是否启用图标选择 |
+| decoration | Boolean | 是否启用装饰线 |
+| isEmpty | Boolean | 是否清空所有默认值 |
+| default | Object | 默认值对象，属性取决于启用的功能 |
+| default.color | String | 默认颜色 |
+| default.fontSize | String/Number | 默认字号（数字格式，不含单位） |
+| default.weight | String/Number | 默认字重 |
+
 #### 1.4 XdBorder 边框设置
 
 **功能**：配置元素边框样式、宽度和颜色。
@@ -1409,6 +1506,39 @@ handleCustom({ action, data }) {
 // statusShow - 判断是否显示关联字段
 ```
 
+**技巧 — 背景图建议尺寸动态计算**：
+
+`tipsformet` 中的建议宽度不应写死，可通过 `getAttrData` 动态计算：
+
+```javascript
+// Attr.js 中配置（静态 part）
+tipsformet: '上传文件格式：@imageType@，不超过@size@MB., 建议宽度为：<span style="color:red">'+ this.x_outerW +'</span>像素',
+```
+
+```javascript
+// Vue init() 中动态计算 x_outerW
+init(container) {
+  getAttrData({
+    sel: this.getInitData,
+    objData: {
+      // 根据外边距 + 组件高度计算背景图建议宽度
+      _outerW: (container) => {
+        const marginData = this.getPMarginRLTB(this.getButtonMarginData(container));
+        const targetH = gCPVal(container, 'btnHeight', [48]);
+        this.x_outerW = marginData ? `${750 * targetH / 48}` : '750';
+      }
+    }
+  });
+}
+```
+
+**要点**：
+- `this.x_outerW` 作为动态属性挂载，在 `tipsformet` 字符串中直接引用
+- 需要在 `init()` 中先计算再渲染，确保 `tipsformet` 获取到的是计算后的值
+- 计算公式可根据组件实际尺寸比例调整（如 `宽度 = 基准宽度 × 高度 / 基准高度`）
+
+---
+
 ### 2、Selector 选择器组件
 
 #### 2.1 XdIconSelect 图标选择器

package/docs/modules/uni-template.md

@@ -1187,6 +1187,25 @@ module.exports = {
 2. **语义化命名**：类名应清晰表达区域功能，避免无意义命名
 3. **避免过深层级**：嵌套建议不超过 5 层，过深时应考虑拆分组件
 4. **使用 Less 变量**：颜色、间距等优先使用项目统一变量
+5. **避免 CSS `background` 简写覆盖**：使用 `background` 简写属性会重置所有子属性（background-size、background-repeat、background-position 等），导致背景图配置失效。应拆分为独立属性：
+
+```less
+// ❌ 错误：简写会重置 background-size 等
+.btn {
+  background: url('xxx.png') #fff;
+  background-size: cover;  // 被上一行重置，无效！
+}
+
+// ✅ 正确：使用独立属性，互不影响
+.btn {
+  background-color: #fff;
+  background-image: url('xxx.png');
+  background-size: cover;
+  background-repeat: no-repeat;
+}
+```
+
+**典型场景**：组件中背景色和背景图分别由 `content.btnBgColor` 和 `content.btnBgImage` 控制，动态 computed style 中应分别设置 `background-color` 和 `background-image`，而非合并为 `background`。
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jufubao-third",
-  "version": "1.0.19-beta2",
+  "version": "1.0.19-beta3",
   "private": false,
   "description": "聚福宝业务组件第三方购物平台包",
   "main": "index.js",

package/src/components/JfbThirdCopyUrl/JfbThirdCopyUrl.vue

@@ -115,7 +115,7 @@
        */
       init(container) {
         //基础
-        this.serverApi = '/thirdmall-apiuri/v1/food/haiwei365/brand/20045'///gCPVal(container, 'serverApi', '');
+        this.serverApi = gCPVal(container, 'serverApi', '');
         this.btnText = gCPVal(container, 'btnText', '复制链接');
         //样式设置
         this.height = gCPVal(container, 'height', 48, {sKey: 'heightStatus', fields: ['height']});
@@ -166,7 +166,7 @@
         }
         // #ifdef H5
         this.$copyText(this.copyUrl).then(() => {
-          this.$xdAlert({content: '复制成功'});
+          this.$xdAlert({content: '内容已复制'});
         }).catch(() => {
           this.$xdAlert({content: '复制失败，请手动复制'});
         });
@@ -174,8 +174,9 @@
         // #ifndef H5
         uni.setClipboardData({
           data: this.copyUrl,
+          showToast:false,
           success: () => {
-            this.$xdAlert({content: '复制成功'});
+            //this.$xdAlert({content: '内容已复制'});
           },
           fail: () => {
             this.$xdAlert({content: '复制失败，请手动复制'});