macroLink: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
Line 17: Line 17:
* ''text'' is the text to display for the link.
* ''text'' is the text to display for the link.
* ''macro'' is the name of the macro to run when the link is clicked.
* ''macro'' is the name of the macro to run when the link is clicked.
The macro is in the same format that is used for [[Macros:Roll:macro |[macro(...): ...] ]]
The macro is in the same format that is used for [[Macros:Branching_and_Looping#MACRO_Option |[macro(...): ...] ]]
e.g. Test@Lib:test
e.g. Test@Lib:test
* ''output'' contains who the output of the macro should go to, values are (defaults to none)
* ''output'' contains who the output of the macro should go to, values are (defaults to none)

Revision as of 04:32, 23 December 2008

Function macroLink

Creates the HTML for a link which will run the specified macro when clicked on.



Usage

[r: = macroLink(text, macro)]
[r: = macroLink(text, macro, output, args)]
[r: = macroLink(text, macro, output, args)]
[r: = macroLink(text, macro, output, args, target)]


  • text is the text to display for the link.
  • macro is the name of the macro to run when the link is clicked.

The macro is in the same format that is used for [macro(...): ...] e.g. Test@Lib:test

  • output contains who the output of the macro should go to, values are (defaults to none)
    • self - Display only to person who clicked on the link.
    • gm - Display to GM.
    • all - everyone (acts like a /say)
    • none - discard any output.
  • args Any arguments to be passed to the macro when it is called.
  • target Which tokens to run the macro on. Target can be one or more of the following (separated by ",")

Examples

To create a link that will call a macro called Test on the Lib:Token named Lib:Test that says "click on me" and displays the output to the GM.

[r: macroLinkText("Test@Lib:Test", "", "gm")]