docs/versioned_docs/version-2.36.0/widgets/link.md
The Link widget allows you to add a hyperlink and navigate to the external URL.
<div style={{paddingTop:'24px', paddingBottom:'24px'}}>| <div style={{ width:"100px"}}> Properties </div> | <div style={{ width:"100px"}}> Description </div> | <div style={{ width:"135px"}}> Expected Value </div> |
|---|---|---|
| Link target | This property sets the URL where the user needs to be taken on clicking the link | example: https://dev.to/tooljet or {{queries.xyz.data.url}} |
| Link text | This property sets the text for the Link widget | example: Click here or Open webpage |
| Target type | This property specifies the link to be opened in the same tab or new tab on clicking the link | Options: New Tab & Same Tab |
To add an event to a link, click on the widget handle to open the widget properties on the right sidebar. Go to the Events section and click on Add handler.
| <div style={{ width:"100px"}}> Event </div> | <div style={{ width:"100px"}}> Description </div> |
|---|---|
| On click | On Click event is triggered when the link is clicked. Just like any other event on ToolJet, you can set multiple handlers for on click event. |
| On hover | On Hover event is triggered when the link is hovered. Just like any other event on ToolJet, you can set multiple handlers for on click event. |
:::info Check Action Reference docs to get the detailed information about all the Actions. :::
</div> <div style={{paddingTop:'24px', paddingBottom:'24px'}}>Following actions of link component can be controlled using the component specific actions(CSA):
| <div style={{ width:"100px"}}> Actions </div> | <div style={{ width:"100px"}}> Description </div> | <div style={{ width:"135px"}}> How To Access </div> |
|---|---|---|
| click | You can trigger the click action of the Link component via a component-specific action within any event handler. | Employ a RunJS query to execute component-specific actions such as await components.link1.click() |
There are currently no exposed variables for the component.
</div> <div style={{paddingTop:'24px', paddingBottom:'24px'}}>A Tooltip is often used to specify extra information about something when the user hovers the mouse pointer over the widget.
Under the <b>General</b> accordion, you can set the value in the string format. Now hovering over the widget will display the string as the tooltip.
</div> <div style={{paddingTop:'24px', paddingBottom:'24px'}}>| <div style={{ width:"100px"}}> Layout </div> | <div style={{ width:"100px"}}> Description </div> | <div style={{ width:"135px"}}> Expected Value </div> |
|---|---|---|
| Show on desktop | Toggle on or off to display desktop view. | You can programmatically determining the value by clicking on Fx to set the value {{true}} or {{false}} |
| Show on mobile | Toggle on or off to display mobile view. | You can programmatically determining the value by clicking on Fx to set the value {{true}} or {{false}} |
| <div style={{ width:"100px"}}> Style </div> | <div style={{ width:"100px"}}> Description </div> |
|---|---|
| Text color | You can change the background color of the text by entering the Hex color code or choosing a color of your choice from the color picker. |
| Text size | By default, the text size is set to 14. You can enter any value from 1-100 to set custom text size. |
| Underline | You can change the underline of the text in the following ways: on-hover (default), never, always |
| Visibility | Toggle on or off to control the visibility of the widget. You can programmatically change its value by clicking on the Fx button next to it. If {{false}} the widget will not visible after the app is deployed. By default, it's set to {{true}}. |
:::info
Any property having Fx button next to its field can be programmatically configured.
:::