My:multi-friend-selector
出自Manyou开发者指南
目录 |
描述
本标签生成一个好友选择器。用户可以通过点击好友选择器上的好友头像来选择好友，并发送请求或邀请。本标签必须置于my:request-form标签内部，否则无效。
用户发送邀请或请求时，会跳出一个对话框，要求用户确认。同时用户可以填写一些附加的消息给好友。
用户每天通过某个应用发送的请求数量有一定限制，如果超出限制，将无法继续发送请求。
属性
| 必选性 | 参数名 | 类型 | 描述 | |
| 必需 | actiontext | string | 好友选择框上方的说明文字。 如“邀请好友加入游戏” | |
|---|---|---|---|---|
| 可选 | showborder | bool | 是否显示好友选择器的边框。 值可以是'true'或'false'。 默认值为'false'。 | |
| rows | int | 显示几行好友头像 | ||
| max | int | 最多可以选择多少个好友 | ||
| exclude_ids | string | 不显示在选择器中的好友uid。 多个用户可以用逗号隔开。（例如开发者可能想排除当前用户的某些特定好友，就可以使用本属性） | ||
| exclude_friends_added | bool | 是否排除已经安装当前应用的好友。 值可以是'true'或'false'。 默认值为'false'（不排除已安装当前应用的好友）。 | ||
| bypass | string | 指定“取消”按钮上的文字。 其值可以为step, cancel,或skip，分别使按钮文字设置为“下一步”、“取消”和“跳过”。 |
POST变量
| 必选性 | 参数名 | 类型 | 描述 | |
| 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" exclude_friends_added="true">
</my:request-form>
 |
用户点击发送邀请按钮后，会跳出一个对话框要求确认。效果如下图：
 |
说明
- 好友选择器外部的my:request-form的action属性不能设置为http://abc.com这样的外部URL，只能设置为本地URL形式，如“/post.php”或“post.php”，表单提交后会跳转到App下的post.php。
