FBML Essentials

Name

<fb:multi-friend-input/>

Synopsis

<fb:multi-friend-input/>

Renders a form input text box that produces a drop-down list of suggestions for friends as the user types. The difference between this tag and the <fb:friend-input/> tag is that this one allows the user to select multiple friends. The tag produces an array in the POST variables with a list of user IDs that the user selected. The submitted form returns an Array of id[] variables.

FBML-Specific Attributes

Required

None.

Optional

width=[string] default: 350px

The width of the field.

border_color=[string] default: #8496ba

The color of the border.

include_me=[true|false] default: false

If true, includes the logged-in user in the list of friends from which to select.

max=[int] default: 20

The maximum number of friends that can be selected.

exclude_ids=[array] default: none

A comma-separated list of friends to be excluded from the list. This can be useful when used within <fb:request-form/> tags to exclude users who have been invited.

prefill_ids=[array] default: none

A comma-separated list of friends to include as already selected in the selector when the page loads. This cannot be used in <fb:request-form/> tags.

prefill_locked=[true|false] default: false

When true, prevents editing of the preselected prefill_ids IDs. The user also cannot add other users.

Example FBML

Here is example FBML code for <fb:multi-friend-input/>:

<form> <fb:multi-friend-input width="400px" border_color="#000" include_me="true" max="30" exclude_ids="4,1,2,3" prefill_ids="683545112"/> ...