> ## Documentation Index
> Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 属性类型与设置器

> 组件属性类型与设置器为使用者预设了不同的配置方案，以满足多样的使用需求。属性类型与设置器存在对应关系，包括文本、布尔、数字、对象等类型及其对应的设置器如TextSetter, BoolSetter, NumberSetter等。

<Note>
  当前文档可见范围为知识小组成员，审核通过后会进行上架，勿动。
</Note>

组件属性类型与设置器为使用者预设了不同的配置方案，以满足多样的使用需求。属性类型与设置器存在对应的关系，详细介绍见下表。

<table>
  <tr>
    <td>**属性类型**</td>
    <td>**设置器名称**</td>
    <td>**说明**</td>
    <td>**图示**</td>
  </tr>

  <tr>
    <td rowSpan={5}>**文本**</td>
    <td>TextSetter</td>
    <td>文本设置器：文本类型组件的常见样式，可进行常规的文本输入。</td>
    <td>![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1646382212325-2556ee69-baf9-4bd7-aba1-57c18e1a6031.png)</td>
  </tr>

  <tr>
    <td>I18nSetter</td>
    <td>刚拖入的组件，默认是不会开启国际化功能的，要开启国际化功能请点击位于属性设置栏上面的国际化按钮，点击国际化按钮之后将启动编辑器，可以「新建」或者「搜索」已有的国际化词条进行绑定。<br />对于已经绑定好的国际化词条，点击国际化按钮之后可以直接编辑对应语言下的国际化文案。</td>
    <td>![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1646385131219-8785c49a-c31a-4a76-8cb1-8306e698b1cf.png)</td>
  </tr>

  <tr>
    <td>DateSetter</td>
    <td>提供日期选择框，并会将所选时间以时间戳的形式展示在页面上。</td>
    <td>![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1646378716528-b482625d-639f-417a-ae93-9f3c30a51c3a.png)<br />![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1646379294587-3759f9a0-0363-4e92-9942-f8b0bd112a3d.png)</td>
  </tr>

  <tr>
    <td>ChoiceSetter</td>
    <td>自定义组件属性以选项的形式存在于属性栏中，当选择不同的选项时，页面的组件内容也会变为预设的选项值。</td>
    <td>![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1646379755317-3a33f6c1-0ad9-4a80-b4c1-2767fa0d22b7.png)<br />![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1646379885469-c428d3eb-9165-4360-98d3-b857db0d317b.png)</td>
  </tr>

  <tr>
    <td>ImageSetter</td>

    <td />

    <td>![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1646380160847-d748209d-d729-48d9-8af0-cac826551d26.png)</td>
  </tr>

  <tr>
    <td>**布尔**</td>
    <td>BoolSetter</td>
    <td>自定义组件属性以开关的形式存在于表单设计页属性栏中，开启组件内容显示`true`；关闭则显示`false`。</td>
    <td>![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1646382657256-96200b53-48d8-4828-ba93-06dbc4f17b72.png)<br />![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1646382499605-de051d92-1996-4745-81ed-72bee0f96624.png)</td>
  </tr>

  <tr>
    <td>**数字**</td>
    <td>NumberSetter</td>
    <td>自定义表单变成类似于宜搭数值组件的形式，阻止了出数字以外任意数据格式内容的输入，且在属性栏输入的数值会显示在组件的内容上。</td>
    <td>![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1646382776430-eee2d1ad-081b-4d34-afc2-5ec9b19a669f.png)<br />![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1646382808971-f2002e0b-6092-48be-a908-a78e7c726778.png)</td>
  </tr>

  <tr>
    <td>**对象**</td>
    <td>JsonSetter</td>
    <td>允许组件属性值以对象格式代码形式进行输入，且在组件内容中以`[object Object]`形式存在</td>
    <td>![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1646383219306-d10ba63d-0aaa-4f4c-bfb7-51f2b8142175.png)<br />![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1646383268937-4f0977d8-220f-41bb-a4ec-522bd8249c61.png)</td>
  </tr>

  <tr>
    <td rowSpan={3}>**数组**</td>
    <td>OptionsSetter</td>
    <td>用来产生简单的数组对象，一般用在下拉选择里的选项配置</td>
    <td>![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1646645988643-95c9b8ec-f82e-4b4b-ad8d-dec5b82aaadc.png)</td>
  </tr>

  <tr>
    <td>ListSetter</td>
    <td>用来产生复杂的对象组件，配置相对复杂。<br />![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1646647016936-2c56f225-460e-4baf-a08b-86bf9ecff882.png)</td>
    <td>![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1646646008847-19b965a8-90aa-460f-a36b-0e22f70f714b.png)</td>
  </tr>

  <tr>
    <td>JsonSetter</td>
    <td>同对象设置器 JsonSetter</td>
    <td>效果同对象设置器 JsonSetter</td>
  </tr>

  <tr>
    <td rowSpan={2}>**函数**</td>
    <td>ActionSetter</td>
    <td>用来配置回调函数，选择了 ActionSetter 在使用态时，属性会在 「高级」下变成动作设置。<br />ActionSetter 需要绑定后使用，如果需要默认绑定事件回调可以使用 CodeSetter。</td>
    <td>![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1646646076897-293efaaf-5901-42c8-9cd1-4cf608c4785a.png)<br />![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1646646094233-fc6c41b0-3145-4e9f-b405-34421edbcfd7.png)</td>
  </tr>

  <tr>
    <td>CodeSetter</td>
    <td>用来配置回调函数，和 ActionSetter 的区别是在使用态时是直接生成一个代码框。</td>
    <td>![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1646646031931-a8cd2cee-8436-4da3-9e7f-d3cd538afdad.png)</td>
  </tr>

  <tr>
    <td>**元素**</td>
    <td>SlotSetter</td>
    <td>用来做容器型的组件，可以拖入其他组件。<br />使用时先声明一个属性，选择 SlotSetter，然后需要先拖入「插槽占位」组件，并且绑定好声明的属性<br />![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1646646672710-c34d1c1a-8606-49c1-bdd7-b3bdd99fb13c.png)</td>
    <td>![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1646646283616-d7859573-936c-4443-9480-6ecdccb25273.png)<br />![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1646646304761-a0d8a0a4-4d1e-438c-a737-7b71c4f61fe7.png)</td>
  </tr>
</table>