Docusign API技术问询：如何添加指定坐标的空文本框

我正在使用DocuSign API从我方网站生成信封（用户支付服务费用后，系统会将其信息填充到信封并发送）。目前我已能通过以下代码向信封添加静态文本字段，但如何在指定坐标添加一个空文本框？即如何让代码中的$s2显示为空的可编辑文本框，而非静态不可编辑的值？是否存在替代textTabs的文本框专属数组？

$s2 = array(
    'documentId' => '3',
    'pageNumber' => '2',
    'xPosition' => '275',
    'yPosition' => '94',
    'value' => substr($first_name, 0, -2),
);
array_push($textTabs, $s2);

$recipients[] = array(
    'roleName' => $client,
    'email' => $email,
    'name' => $name,
    'tabs' => array('textTabs' => $textTabs, 'initialHereTabs' => $initials, 'checkboxTabs' => $checkboxes),
);

etc. 

解决方案 #

不需要替换textTabs，调整现有配置就能实现可编辑空文本框：

• 移除value字段（或者把value设为空字符串''），这样文本框初始就是空的。
• 显式设置editable属性为true（默认是true，但显式声明能避免全局配置覆盖的问题）。

修改后的s2代码示例：

$s2 = array(
    'documentId' => '3',
    'pageNumber' => '2',
    'xPosition' => '275',
    'yPosition' => '94',
    'editable' => true,
    // 去掉value字段，或者写 'value' => ''
);
array_push($textTabs, $s2);

额外提示 #

如果需要给文本框加提示文字（比如“请输入信息”），可以用placeholder属性，而不是value——收件人输入内容时，提示文字会自动消失：

'placeholder' => '请输入您的信息'

内容的提问来源于stack exchange，提问作者Ping