mirror of https://github.com/ToolJet/ToolJet synced 2026-04-21 21:47:17 +00:00

* docs: jira

* docs: formatting + Client Credentials grant type

* docs: connection string pgsql

* docs: parameterized queries mysql

* docs: parameterized queries in PostgreSQL

* docs: update mysql example

* docs: TJDB sql editor

* docs: add metadata to REST API

* docs: add, update  postgresql media

* docs: add metadata to graphql

* docs: update parameterized queries

* docs: add parameterized queries for mssql

* docs: add SSL Cert to mysql

* docs: TJDB SQL restricted commands

* docs: update JIRA token location

* docs: update delete issue example

* docs: update find user by query example

* docs: remove session id from get assignable users

* docs: use correct image for get issues for board

* docs: update create issue example

* docs: update delete issue media

* docs: update assignable users media

* docs: update examples

* docs: update key desc

* docs: v2.68.0-Beta

2024-09-13 19:23:19 +05:30

5.4 KiB

Raw Permalink Blame History

id	title
custom-component	Custom Component

Custom Component

Custom Component can be used to do create your own React component when the needed functionality isn't available in other components.

Properties

Data

The data needs to be an objects which needs to be passed as data props to the Custom Component

Example:

{{{
    title: "Hi! There",
    buttonText: "Updated Text",
    queryName: "runjs1"
}}}

Code

This field is used to add a React code for your custom component. The packages for the custom component can be imported from Skypack or esm. For example, to import React package into the custom component it can be imported as import React from 'https://cdn.skypack.dev/react'.

Tooljet provides 3 props to interact with the app: data, updateData and runQuery.

data is a shared object between custom component and Tooljet app.
updateData is a function which accepts a single object used to update the data passed to the custom component.
runQuery is a function which accepts a query name as a string used to run the query from the custom component.

Example:

import React from "https://cdn.skypack.dev/react";
import ReactDOM from "https://cdn.skypack.dev/react-dom";
import { Button, Container, Link } from "https://cdn.skypack.dev/@material-ui/core";

const MyCustomComponent = ({data, updateData, runQuery}) => (
    <Container>
        <h1>{data.title}</h1>
        <Button
            color="primary"
            variant="outlined"
            onClick={() => {updateData({...data, title: 'Hello World!!'})}}>
            {data.buttonText}
        </Button>
        <Button
            color="primary"
            variant="outlined"
            onClick={() => {runQuery(data.queryName)}}
        >
            Run Query
        </Button>
    </Container>
);

const ConnectedComponent = Tooljet.connectComponent(MyCustomComponent);

ReactDOM.render(<ConnectedComponent />, document.body);

:::info Tooljet.connectComponent acts as a HOC and it is required to get access to the data passed into the custom component and run the query :::

Component Specific Actions (CSA)

There are currently no CSA (Component-Specific Actions) implemented to regulate or control the component.

Exposed Variables

<div style={{ width:"100px"}}> Variables	<div style={{ width:"135px"}}> Description	<div style={{ width:"135px"}}> How To Access
data	This variable will hold the variables assigned inside the `code` for custom component.	Access the value dynamically using JS: `{{components.customcomponent1.data.title}}`

General

A Tooltip is often used to specify extra information about something when the user hovers the mouse pointer over the widget.

Under the General accordion, you can set the value in the string format. Now hovering over the widget will display the string as the tooltip.

Layout

<div style={{ width:"100px"}}> Layout	<div style={{ width:"100px"}}> Description	<div style={{ width:"135px"}}> Expected Value
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}}`

Styles

<div style={{ width:"100px"}}> Style	<div style={{ width:"100px"}}> Description	<div style={{ width:"100px"}}> Default value
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. :::

5.4 KiB Raw Permalink Blame History