# Link

## **Specs**

| Label                     | Value                         |
| ------------------------- | ----------------------------- |
| **Version**               | 1.1.0 (updated on 2024-09-08) |
| **Developer**             | Labii Inc.                    |
| **Type**                  | Column                        |
| **Support Configuration** | No                            |
| **Support Readonly view** | Yes                           |
| **Support Edit view**     | Yes                           |
| **Support Form view**     | No                            |
| **Support Default value** | Yes                           |
| **Support Import**        | Yes                           |
| **Allow multiple**        | Yes                           |

## Overview

The Link widget is a versatile tool that transforms the provided text into a clickable hyperlink. This enables users to effortlessly access a predefined web link or resource with a simple click. By integrating this widget, user navigation and interaction are significantly enhanced, as it seamlessly associates specific text with external content or URLs. This functionality is particularly useful in creating intuitive and user-friendly interfaces, where direct access to more information, related content, or additional resources is essential. The ease of use and streamlined user experience provided by the Link widget ensures that users can efficiently locate and utilize the linked information, contributing to a more dynamic and engaging digital environment.

## Use case

1. Use this widget to display PMID and linked to PubMed website.
2. Display a payment button in invoice.
3. Display a "Convert to invoice" button in quote.

## Configuration

No configuration required.

## Views

See the interface of the widget in the following views.

### **Readonly view**

Readonly view display the values of the column.

<figure><img src="https://github.com/Labii/labii-gitbook-docs/blob/gitbook/widgets/column-widgets/.gitbook/assets/widget-column-link-readonly.webp" alt=""><figcaption></figcaption></figure>

<figure><img src="https://github.com/Labii/labii-gitbook-docs/blob/gitbook/widgets/column-widgets/.gitbook/assets/widget-column-link-readonly-button.webp" alt=""><figcaption></figcaption></figure>

You have the option to display the hyperlink either as a text link or as a button. This flexibility allows you to choose the format that best suits your needs and enhances the user experience.

### **Edit view**

The Edit view is the interface that allows you to modify the value.

<figure><img src="https://github.com/Labii/labii-gitbook-docs/blob/gitbook/widgets/column-widgets/.gitbook/assets/widget-column-link-edit.webp" alt=""><figcaption></figcaption></figure>

* **Text** - Text of the link
* **Icon** - Icon of button
* **Link** - The URL. This field support variables. Discover additional information about the array of supportive variables on <https://docs.labii.com/api/variables>
* **Color** - Button color or text color
* **Should display as button** - if checked, the link will be displayed as a button
* **Button size**

### **Form view**

The Form view is the field integrated into the add form for collecting values when creating a new record.

The Form view is same as the Edit view.

## Data

Each widget in Labii stores data in a unique manner; refer below to understand how data from this widget is stored.

### Data format

JSON

```json
{
    "text": "",
    "icon": "",
    "link": "",
    "color": "",
    "should_display_as_button": false,
    "button_size": "btn"
}
```

### **Default value**

The Default Value field within the column allows you to specify the default value when a record is created.

Default value can be any URL or JSON.

### **Import value**

The Import Value is the value you need to include in your Excel table for it to be imported into Labii.

Import value can be any URL or JSON.