kibana/docs/canvas/canvas-client-functions.asciidoc
Sarah Hersh 8b304217b5
[DOCS] Adds Kibana docs for Canvas functions (#26467)
* [DOCS] Migrates Canvas function docs to Kibana docs

* [DOCS] Add docs for TinyMath Canvas functions
2018-12-05 16:02:44 -05:00

83 lines
1.4 KiB
Plaintext

[[canvas-client-functions]]
=== Canvas client functions
beta[]These functions must execute in a browser. They are only available
from within the Canvas application, not via the Canvas HTTP API. These functions must
execute in the browser because they use browser specific APIs, such as location,
or interact with the workpad to read filters.
A *** denotes a required argument.
[float]
=== asset
Uses Canvas workpad asset objects to provide argument values. Usually images.
*Accepts:* null
[cols="3*^<"]
|===
s|Argument
s|Type
s|Description
|_Unnamed_*
|string
|The ID of the asset value to return
|===
*Returns:* string
[float]
=== browser
Forces the interpreter to return to the browser.
*Accepts:* Anything or nothing
*Returns:* Depends on your input and arguments
[float]
=== filters
Collects element filters on the workpad, usually to provide them to a data source.
*Accepts:* null
*Returns:* filter
[float]
=== location
Uses the browser's location functionality to get your current location. Usually
quite slow, but fairly accurate.
*Accepts:* null
*Returns:* datatable
[float]
=== urlparam
Accesses URL parameters and use them in expressions. This will always return a string.
*Accepts:* null
[cols="3*^<"]
|===
s|Argument
s|Type
s|Description
|_Unnamed_* (Aliases: `var`, `variable`)
|string
|The URL hash parameter to access
|default
|string
|Return this string if the url parameter is not defined (default: `""`)
|===
*Returns:* string