PromucFlow_constructor/app/client/src/widgets/CustomWidget/component/index.tsx
balajisoundar f376d362e4
chore: custom widget onReady warning and template updates (#30335)
## Description
Update tempaltes and add warning message when onReady function is
missing.

> 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
> Please delete options that are not relevant.
- Bug fix (non-breaking change which fixes an issue)
- New feature (non-breaking change which adds functionality)
- Breaking change (fix or feature that would cause existing
functionality to not work as expected)
- Chore (housekeeping or task changes that don't impact user perception)
- This change requires a documentation update
>
>
>
## 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
- [ ] Jest
- [ ] 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
- [ ] My code follows the style guidelines of this project
- [ ] I have performed a self-review of my own code
- [ ] I have commented my code, particularly in hard-to-understand areas
- [ ] I have made corresponding changes to the documentation
- [ ] My changes generate no new warnings
- [ ] I have added tests that prove my fix is effective or that my
feature works
- [ ] New and existing unit tests pass locally with my changes
- [ ] 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 a new Vanilla JavaScript template for custom widgets.
- Enhanced Vue.js custom widget template with new design and
functionality.
- Added a warning system to alert users when certain expected code
patterns are missing.

- **Bug Fixes**
	- Updated the `appsmithConsole` to include error handling.

- **Documentation**
	- Added new documentation URLs for custom widget development guidance.

- **Refactor**
	- Replaced the `blank` module with `vanillaJs` in code templates.
	- Removed unused styles and code comments from React template.
	- Streamlined default context values for widget development.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->
2024-01-17 19:44:14 +05:30

281 lines
8.1 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";
import WidgetStyleContainer from "components/designSystems/appsmith/WidgetStyleContainer";
import type { BoxShadow } from "components/designSystems/appsmith/WidgetStyleContainer";
import type { Color } from "constants/Colors";
import { connect } from "react-redux";
import type { AppState } from "@appsmith/reducers";
import { combinedPreviewModeSelector } from "selectors/editorSelectors";
import { getAppMode } from "@appsmith/selectors/applicationSelectors";
import { APP_MODE } from "entities/App";
import { getWidgetPropsForPropertyPane } from "selectors/propertyPaneSelectors";
import AnalyticsUtil from "utils/AnalyticsUtil";
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,
},
"*",
);
if (
props.renderMode === "DEPLOYED" ||
props.renderMode === "EDITOR"
) {
AnalyticsUtil.logEvent("CUSTOM_WIDGET_LOAD_INIT", {
widgetId: props.widgetId,
renderMode: props.renderMode,
});
}
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" />}
<WidgetStyleContainer
backgroundColor={props.backgroundColor}
borderColor={props.borderColor}
borderRadius={props.borderRadius}
borderWidth={props.borderWidth}
boxShadow={props.boxShadow}
widgetId={props.widgetId}
>
<StyledIframe
height={props.height}
loading="lazy"
onLoad={() => {
setLoading(false);
}}
ref={iframe}
sandbox="allow-scripts allow-downloads"
srcDoc={srcDoc}
width={props.width}
/>
</WidgetStyleContainer>
</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;
borderColor?: Color;
backgroundColor?: Color;
borderWidth?: number;
borderRadius?: number;
boxShadow?: BoxShadow;
widgetId: string;
}
/**
* TODO: Balaji soundararajan - to refactor code to move out selected widget details to platform
*/
export const mapStateToProps = (
state: AppState,
ownProps: CustomComponentProps,
) => {
const isPreviewMode = combinedPreviewModeSelector(state);
const appMode = getAppMode(state);
return {
needsOverlay:
appMode == APP_MODE.EDIT &&
!isPreviewMode &&
ownProps.widgetId !== getWidgetPropsForPropertyPane(state)?.widgetId,
};
};
export default connect(mapStateToProps)(CustomComponent);