## Description This PR's adds the custom widget. #### PR fixes following issue(s) Fixes #28607 Fixes #28610 Fixes #28615 Fixes #28608 Fixes #28612 > if no issue exists, please create an issue and ask the maintainers about this first > > #### Media > A video or a GIF is preferred. when using Loom, don’t embed because it looks like it’s a GIF. instead, just link to the video > > #### Type of change - New feature (non-breaking change which adds functionality) > > > ## Testing > #### How Has This Been Tested? > Please describe the tests that you ran to verify your changes. Also list any relevant details for your test configuration. > Delete anything that is not relevant - [ ] Manual - [ ] JUnit - [x] Jest - [x] Cypress > > #### Test Plan > Add Testsmith test cases links that relate to this PR > > #### Issues raised during DP testing > Link issues raised during DP testing for better visiblity and tracking (copy link from comments dropped on this PR) > > > ## Checklist: #### Dev activity - [x] My code follows the style guidelines of this project - [x] I have performed a self-review of my own code - [x] I have commented my code, particularly in hard-to-understand areas - [ ] I have made corresponding changes to the documentation - [x] My changes generate no new warnings - [x] I have added tests that prove my fix is effective or that my feature works - [x] New and existing unit tests pass locally with my changes - [x] PR is being merged under a feature flag #### QA activity: - [ ] [Speedbreak features](https://github.com/appsmithorg/TestSmith/wiki/Guidelines-for-test-plans#speedbreakers-) have been covered - [ ] Test plan covers all impacted features and [areas of interest](https://github.com/appsmithorg/TestSmith/wiki/Guidelines-for-test-plans#areas-of-interest-) - [ ] Test plan has been peer reviewed by project stakeholders and other QA members - [ ] Manually tested functionality on DP - [ ] We had an implementation alignment call with stakeholders post QA Round 2 - [ ] Cypress test cases have been added and approved by SDET/manual QA - [ ] Added `Test Plan Approved` label after Cypress tests were reviewed - [ ] Added `Test Plan Approved` label after JUnit tests were reviewed <!-- This is an auto-generated comment: release notes by coderabbit.ai --> ## Summary by CodeRabbit - **New Features** - Introduced search functionality with a wildcard option for unmatched widget searches. - Added new routes for custom widget editing. - Implemented additional editor modes for HTML and CSS. - Created new code templates and help components for custom widget builders. - Enhanced property controls with new button controls for custom widget editing. - Updated theming interfaces and constants for better theming support. - Added the CustomWidget component for embedding custom widgets in iframes. - Expanded widgets library to include the CustomWidget. - **Enhancements** - Improved `CodeEditor` with additional modes, props, and resize behavior. - Enhanced `PropertyPaneControlConfig` interface with dynamic dependencies and additional properties. - Refined custom widget scripts with communication channel and event handling. - **Bug Fixes** - Fixed visibility logic for the `ExternalWidget` card. - **Documentation** - Added new messages and documentation links for custom widget features. - **Tests** - Implemented new Cypress tests for custom widget default components and property pane interactions. - Updated workspace commands in Cypress tests. - **Refactor** - Streamlined `PropertyControl` state management and editing functions. - Refactored code editor hint helper logic. - **Style** - Added `borderLess` prop to style components without borders. - **Chores** - Updated constants and messages related to custom widget features. - Adjusted webpack configuration to ignore specific module warnings. <!-- end of auto-generated comment: release notes by coderabbit.ai -->
227 lines
6.2 KiB
TypeScript
227 lines
6.2 KiB
TypeScript
import React, { useEffect, useMemo, useRef, useState } from "react";
|
|
import styled from "styled-components";
|
|
|
|
// eslint-disable-next-line @typescript-eslint/ban-ts-comment
|
|
//@ts-ignore
|
|
import script from "!!raw-loader!./customWidgetscript.js";
|
|
|
|
// eslint-disable-next-line @typescript-eslint/ban-ts-comment
|
|
//@ts-ignore
|
|
import appsmithConsole from "!!raw-loader!./appsmithConsole.js";
|
|
|
|
// eslint-disable-next-line @typescript-eslint/ban-ts-comment
|
|
//@ts-ignore
|
|
import css from "!!raw-loader!./reset.css";
|
|
import clsx from "clsx";
|
|
import type { AppThemeProperties } from "entities/AppTheming";
|
|
|
|
const StyledIframe = styled.iframe<{ width: number; height: number }>`
|
|
width: ${(props) => props.width - 8}px;
|
|
height: ${(props) => props.height - 8}px;
|
|
`;
|
|
|
|
const OverlayDiv = styled.div`
|
|
position: absolute;
|
|
top: 0;
|
|
left: 0;
|
|
width: 100%;
|
|
height: 100%;
|
|
`;
|
|
|
|
const EVENTS = {
|
|
CUSTOM_WIDGET_READY: "CUSTOM_WIDGET_READY",
|
|
CUSTOM_WIDGET_READY_ACK: "CUSTOM_WIDGET_READY_ACK",
|
|
CUSTOM_WIDGET_UPDATE_MODEL: "CUSTOM_WIDGET_UPDATE_MODEL",
|
|
CUSTOM_WIDGET_TRIGGER_EVENT: "CUSTOM_WIDGET_TRIGGER_EVENT",
|
|
CUSTOM_WIDGET_MODEL_CHANGE: "CUSTOM_WIDGET_MODEL_CHANGE",
|
|
CUSTOM_WIDGET_UI_CHANGE: "CUSTOM_WIDGET_UI_CHANGE",
|
|
CUSTOM_WIDGET_MESSAGE_RECEIVED_ACK: "CUSTOM_WIDGET_MESSAGE_RECEIVED_ACK",
|
|
CUSTOM_WIDGET_THEME_UPDATE: "CUSTOM_WIDGET_THEME_UPDATE",
|
|
};
|
|
|
|
// this is the padding set by the canvas
|
|
const WIDGET_PADDING = 8;
|
|
|
|
function CustomComponent(props: CustomComponentProps) {
|
|
const iframe = useRef<HTMLIFrameElement>(null);
|
|
|
|
const [loading, setLoading] = React.useState(true);
|
|
|
|
const [isIframeReady, setIsIframeReady] = useState(false);
|
|
|
|
const theme = useMemo(() => {
|
|
return {
|
|
...props.theme?.colors,
|
|
borderRadius: props.theme?.borderRadius?.appBorderRadius,
|
|
boxShadow: props.theme?.boxShadow?.appBoxShadow,
|
|
};
|
|
}, [props.theme]);
|
|
|
|
useEffect(() => {
|
|
const handler = (event: MessageEvent) => {
|
|
const iframeWindow =
|
|
iframe.current?.contentWindow ||
|
|
iframe.current?.contentDocument?.defaultView;
|
|
|
|
if (event.source === iframeWindow) {
|
|
// Sending acknowledgement for all messages since we're queueing all the postmessage from iframe
|
|
iframe.current?.contentWindow?.postMessage(
|
|
{
|
|
type: EVENTS.CUSTOM_WIDGET_MESSAGE_RECEIVED_ACK,
|
|
key: event.data.key,
|
|
success: true,
|
|
},
|
|
"*",
|
|
);
|
|
|
|
const message = event.data;
|
|
|
|
switch (message.type) {
|
|
case EVENTS.CUSTOM_WIDGET_READY:
|
|
setIsIframeReady(true);
|
|
iframe.current?.contentWindow?.postMessage(
|
|
{
|
|
type: EVENTS.CUSTOM_WIDGET_READY_ACK,
|
|
model: props.model,
|
|
ui: {
|
|
width: props.width - WIDGET_PADDING,
|
|
height: props.height - WIDGET_PADDING,
|
|
},
|
|
mode: props.renderMode,
|
|
theme,
|
|
},
|
|
"*",
|
|
);
|
|
break;
|
|
case EVENTS.CUSTOM_WIDGET_UPDATE_MODEL:
|
|
props.update(message.data);
|
|
break;
|
|
case EVENTS.CUSTOM_WIDGET_TRIGGER_EVENT:
|
|
props.execute(message.data.eventName, message.data.contextObj);
|
|
break;
|
|
case "UPDATE_HEIGHT":
|
|
const height = message.data.height;
|
|
|
|
if (height) {
|
|
iframe.current!.style.height = `${height}px`;
|
|
}
|
|
break;
|
|
case "CUSTOM_WIDGET_CONSOLE_EVENT":
|
|
props.onConsole &&
|
|
props.onConsole(message.data.type, message.data.args);
|
|
break;
|
|
}
|
|
}
|
|
};
|
|
|
|
window.addEventListener("message", handler, false);
|
|
|
|
return () => window.removeEventListener("message", handler, false);
|
|
}, [props.model, props.width, props.height]);
|
|
|
|
useEffect(() => {
|
|
if (iframe.current && iframe.current.contentWindow && isIframeReady) {
|
|
iframe.current.contentWindow.postMessage(
|
|
{
|
|
type: EVENTS.CUSTOM_WIDGET_MODEL_CHANGE,
|
|
model: props.model,
|
|
},
|
|
"*",
|
|
);
|
|
}
|
|
}, [props.model]);
|
|
|
|
useEffect(() => {
|
|
if (iframe.current && iframe.current.contentWindow && isIframeReady) {
|
|
iframe.current.contentWindow.postMessage(
|
|
{
|
|
type: EVENTS.CUSTOM_WIDGET_UI_CHANGE,
|
|
ui: {
|
|
width: props.width - 8,
|
|
height: props.height - 8,
|
|
},
|
|
},
|
|
"*",
|
|
);
|
|
}
|
|
}, [props.width, props.height]);
|
|
|
|
useEffect(() => {
|
|
if (iframe.current && iframe.current.contentWindow && isIframeReady) {
|
|
iframe.current.contentWindow.postMessage(
|
|
{
|
|
type: EVENTS.CUSTOM_WIDGET_THEME_UPDATE,
|
|
theme,
|
|
},
|
|
"*",
|
|
);
|
|
}
|
|
}, [theme]);
|
|
|
|
const srcDoc = `
|
|
<html>
|
|
<head>
|
|
<style>${css}</style>
|
|
</head>
|
|
<body>
|
|
<script type="text/javascript">${
|
|
props.onConsole ? appsmithConsole : ""
|
|
}</script>
|
|
<script type="module">
|
|
${script}
|
|
main();
|
|
</script>
|
|
${props.srcDoc.html}
|
|
<script type="module">
|
|
${props.srcDoc.js}
|
|
</script>
|
|
<style>${props.srcDoc.css}</style>
|
|
</body>
|
|
</html>
|
|
`;
|
|
|
|
useEffect(() => {
|
|
setLoading(true);
|
|
}, [srcDoc]);
|
|
|
|
return (
|
|
<div
|
|
className={clsx({
|
|
"bp3-skeleton": loading,
|
|
})}
|
|
>
|
|
{props.needsOverlay && <OverlayDiv data-testid="iframe-overlay" />}
|
|
<StyledIframe
|
|
height={props.height}
|
|
onLoad={() => {
|
|
setLoading(false);
|
|
}}
|
|
ref={iframe}
|
|
sandbox="allow-scripts allow-downloads"
|
|
srcDoc={srcDoc}
|
|
width={props.width}
|
|
/>
|
|
</div>
|
|
);
|
|
}
|
|
|
|
export interface CustomComponentProps {
|
|
execute: (eventName: string, contextObj: Record<string, unknown>) => void;
|
|
update: (data: Record<string, unknown>) => void;
|
|
model: Record<string, unknown>;
|
|
srcDoc: {
|
|
html: string;
|
|
js: string;
|
|
css: string;
|
|
};
|
|
width: number;
|
|
height: number;
|
|
onLoadingStateChange?: (state: string) => void;
|
|
needsOverlay?: boolean;
|
|
onConsole?: (type: string, message: string) => void;
|
|
renderMode: "EDITOR" | "DEPLOYED" | "BUILDER";
|
|
theme: AppThemeProperties;
|
|
}
|
|
|
|
export default CustomComponent;
|