This action sends a message to the event handler on the server.<\/p>\n
Example:<\/p>\n
{% button text="Go" action={postback postback="go" action={growl text="sent message"}} %}\n<\/code><\/pre>\nNote<\/p>
The scomp#button<\/code><\/a> scomp can also take a postback argument directly.<\/p><\/div>\nAfter clicking the button the event go will be sent to the controller<\/a> module on the\nserver and an action#growl<\/code><\/a> message will be displayed.<\/p>\nThe event\/2 function in the controller module will be called as:<\/p>\n
event(#postback{message=go, trigger=TriggerId, target=TargetId}, Context)\n<\/code><\/pre>\nThis action can have the following arguments:<\/p>\n
Argument<\/th> Description<\/th> Example<\/th><\/tr><\/thead> postback<\/td> The message that will be sent to the server module.<\/td> postback={my_message arg="hello"}<\/code><\/td><\/tr>delegate<\/td> The name of the Erlang module that will be called. Defaults to the controller module generating the page.<\/td> delegate="my_module"<\/code><\/td><\/tr>action<\/td> Any other actions that will be executed when the postback is done. This parameter can be repeated.<\/td> action={show target="wait"}<\/code><\/td><\/tr>inject_args<\/td> If set to true, and postback is a tuple (as in the my_message<\/code> example in this table), any values from the args in the postback will replace the arg value in the postback argument. This is useful when the arg is coming from an outer action and not set explicitly in the template code (as is done in the example for illustration). The value of some_arg<\/code> in the postback handler will be 123<\/code>.<\/td>{postback postback={my_event some_arg} inject_args some_arg=123}<\/code><\/td><\/tr>qarg<\/td> Post the value of an input or select with the postback. The value of the qarg<\/code> argument is the id of the element to be posted. Multiple qarg<\/code> arguments can be given. On the server the value will be available as a normal query argument using z_context:get_q\/2<\/code><\/td>qarg="my-input-id"<\/code><\/td><\/tr><\/tbody><\/table>\nNew in version 0.9.0: Added inject_args option.<\/p>","slug":"postback","is_protected":false,"visible_for":0,"tz":"UTC","language":["en"],"doc_source_hash":"c6296256a709471ae8f39e21f037aed68f28159d488d710e425d9141df816936","is_featured":false,"content_group_id":{"id":2551,"is_a":["meta","content_group"],"name":"content_group_imported_docs","title":"Imported documentation","uri":"https:\/\/zotonic.com\/id\/content_group_imported_docs"},"category_id":{"id":326,"is_a":["meta","category"],"name":"template_action","title":"Actions","uri":"https:\/\/test.zotonic.com\/id\/326"},"doc_source_path":"apps\/zotonic_mod_wires\/src\/actions\/action_wires_postback.erl","publication_start":"2023-01-30T19:23:57Z","github_url":"https:\/\/github.com\/zotonic\/zotonic\/blob\/master\/apps\/zotonic_mod_wires\/src\/actions\/action_wires_postback.erl","pivot_location_lng":null,"doc_source_kind":"action","name":"doc_template_action_action_postback","is_unfindable":false,"is_published":true,"pivot_geocode":null,"created":"2020-05-30T05:47:28Z","uri":null,"doc_status":"current","is_dependent":false,"erlang_app":"zotonic_mod_wires","publication_end":"9999-06-01T00:00:00Z","modifier_id":{"id":1,"is_a":["person"],"name":"administrator","title":"Site Administrator","uri":"https:\/\/zotonic.com\/id\/1"},"privacy":0,"doc_source_commit":"fcd7360cf6d307f08dac71bede7378e2b4ac72f0\n","erlang_module":"action_wires_postback","creator_id":{"id":336,"is_a":["person","robot"],"name":"gitbot","title":"Git","uri":"https:\/\/zotonic.com\/id\/336"},"modified":"2026-10-01T12:53:31Z","title_slug":"postback"},"uri":"https:\/\/zotonic.com\/id\/1630","uri_template":"https:\/\/zotonic.com\/id\/:id","websub":{"hub":"https:\/\/zotonic.com\/.zotonic\/websub","topic":"https:\/\/zotonic.com\/.zotonic\/websub\/topic\/1630"}},"status":"ok"}