My:request-form
出自Manyou开发者指南
目录 |
描述
本标签用于生成一个表单（form），发送被选中的好友的信息。要同时发送邀请或请求给多个用户，可以结合使用一个my:multi-friend-selector或者my:request-form-submit标签。当用户确认发送请求之后，本表单会被提交。
my:multi-friend-selector（好友选择器）适用于一次选择较多数量的好友并发送邀请（或请求）。
如果你只想邀请一个用户，可以在my:request-form中加入一个my:request-form-submit标签，并指定要邀请的用户的uid。
属性
| 必选性 | 参数名 | 类型 | 描述 | |
| 必需 | type | string | 邀请或请求的类型。 会影响到邀请页面和按钮的文字。通常把本属性设置为App名称，如发送一个 $type 邀请给 friend的结果为：发送一个 停车大战 邀请给 小明 | |
|---|---|---|---|---|
| content | bool | 邀请或请求的内容。 其中可以包含my:req-choice标签，该标签用于指定用户接收到的邀请上的按钮文字。本属性中只能包含文字内容，超级链接<a>及my:name标签。 | ||
| 可选 | invite | bool | 是否是一个邀请。如果设置为true，则为邀请；如果设置为false，则只是一个普通的请求。 两者的区别在于用户看到的文字不同。（例如invite设置为true，用户看到的文字为“王小明给你发送了一个**邀请”；如果设置为false，则用户看到的是“王小明给你发送了一个**请求”）。 | |
| action | string | 表单提交后跳转到的地址，或者用户点击“跳过”按钮后跳到的地址。 注意只能为/index.php或index.php这样的本地地址，不能是http://url形式 | ||
| method | string | 发送表单数据的方法。可以是POST或GET其中之一。 |
POST变量
| 必选性 | 参数名 | 类型 | 描述 | |
| typeahead | string | 用户填入搜索好友表单的内容 | ||
| ids | array | 被选中的好友的uid组成的数组 |
范例
<my:request-form method="POST"
type='真心话大冒险' invite="true"
content="hello<my:req-choice url='/game.php' label='我愿意'>"
id="myformb" invite="true" action="/index.php">
<my:multi-friend-selector actiontext="邀请好友加入真心话大冒险游戏" showborder="false" rows="4" max="20">
</my:request-form>
说明
- action属性不能设置为http://abc.com这样的外部URL，只能设置为本地URL形式，如“/post.php”或“post.php”，表单提交后会跳转到App下的post.php。
