Guides

表单属性设置

通过 formsConfig.initAttribute 可设置各表单类型的默认属性。创建新表单控件时将自动应用这些属性。

文本输入框（TextField）

{
  "formsConfig": {
    "initAttribute": {
      "textField": {
        "fillColor": "#DDE9FF",
        "borderColor": "#1460F3",
        "borderWidth": 2,
        "fontColor": "#000000",
        "fontSize": 20,
        "isBold": false,
        "isItalic": false,
        "alignment": "left",
        "multiline": true,
        "familyName": "Helvetica",
        "styleName": "Regular"
      }
    }
  }
}

字段	说明
fillColor	背景填充颜色
borderColor	边框颜色
borderWidth	边框宽度
fontColor	文字颜色
fontSize	字号
isBold	是否加粗
isItalic	是否斜体
alignment	文字对齐方式："left"、"center"、"right"
multiline	是否多行输入
familyName	字体名称
styleName	字体样式

复选框（CheckBox）

{
  "formsConfig": {
    "initAttribute": {
      "checkBox": {
        "fillColor": "#DDE9FF",
        "borderColor": "#1460F3",
        "borderWidth": 2,
        "checkedColor": "#43474D",
        "isChecked": false,
        "checkedStyle": "check"
      }
    }
  }
}

字段	说明
fillColor	背景颜色
borderColor	边框颜色
borderWidth	边框宽度
checkedColor	选中标记颜色
isChecked	默认选中状态
checkedStyle	选中样式："check"（勾选）、"circle"（圆形）、"cross"（叉号）、"diamond"（菱形）、"square"（方块）、"star"（星星）

单选按钮（RadioButton）

{
  "formsConfig": {
    "initAttribute": {
      "radioButton": {
        "fillColor": "#DDE9FF",
        "borderColor": "#1460F3",
        "borderWidth": 2,
        "checkedColor": "#43474D",
        "isChecked": false,
        "checkedStyle": "circle"
      }
    }
  }
}

属性与复选框类似，checkedStyle 同样支持 6 种样式。

列表框（ListBox）

{
  "formsConfig": {
    "initAttribute": {
      "listBox": {
        "fillColor": "#DDE9FF",
        "borderColor": "#1460F3",
        "borderWidth": 2,
        "fontColor": "#000000",
        "fontSize": 20,
        "isBold": false,
        "isItalic": false,
        "familyName": "Helvetica",
        "styleName": "Regular"
      }
    }
  }
}

下拉框（ComboBox）

{
  "formsConfig": {
    "initAttribute": {
      "comboBox": {
        "fillColor": "#DDE9FF",
        "borderColor": "#1460F3",
        "borderWidth": 2,
        "fontColor": "#000000",
        "fontSize": 20,
        "isBold": false,
        "isItalic": false,
        "familyName": "Helvetica",
        "styleName": "Regular"
      }
    }
  }
}

属性结构与列表框完全一致。

按钮（PushButton）

{
  "formsConfig": {
    "initAttribute": {
      "pushButton": {
        "fillColor": "#DDE9FF",
        "borderColor": "#1460F3",
        "borderWidth": 2,
        "fontColor": "#000000",
        "fontSize": 20,
        "title": "Button",
        "isBold": false,
        "isItalic": false,
        "familyName": "Helvetica",
        "styleName": "Regular"
      }
    }
  }
}

字段	说明
title	按钮默认显示文本

签名域（SignaturesFields）

{
  "formsConfig": {
    "initAttribute": {
      "signaturesFields": {
        "fillColor": "#DDE9FF",
        "borderColor": "#1460F3",
        "borderWidth": 2
      }
    }
  }
}

签名域仅支持基础外观属性。

属性编辑组件

每种表单类型都有对应的属性编辑 Fragment：

表单类型	Fragment 类
TextField	CTextFieldStyleFragment
CheckBox	CCheckBoxStyleFragment
RadioButton	CRadioButtonStyleFragment
ListBox	CListBoxStyleFragment
ComboBox	CComboBoxStyleFragment
PushButton	CPushButtonStyleFragment
SignaturesFields	CSignFieldStyleFragment

在源码集成模式下，可继承或修改这些 Fragment 以自定义表单属性面板 UI。