From a895736f74be17b8780a53f8514b6a6c73bf6426 Mon Sep 17 00:00:00 2001
From: Anna Hariprasad
Date: Tue, 21 May 2024 16:28:29 +0530
Subject: [PATCH] docs: Github document update - Widget Development API
(#33612)
**What's in this PR?**
- Added descriptions and png files for the new
`getPropertyPaneContentConfig` and `getPropertyPaneStyleConfig` APIs.
- Added descriptions for the `isDeprecated` property.
Fixes #22771
Thank you.
---
.../AppsmithWidgetDevelopmentGuide.md | 27 ++++++++++++++++++
.../assets/propertyContentConfig.png | Bin 0 -> 348944 bytes
contributions/assets/propertyStyleConfig.png | Bin 0 -> 267909 bytes
3 files changed, 27 insertions(+)
create mode 100644 contributions/assets/propertyContentConfig.png
create mode 100644 contributions/assets/propertyStyleConfig.png
diff --git a/contributions/AppsmithWidgetDevelopmentGuide.md b/contributions/AppsmithWidgetDevelopmentGuide.md
index 82ef0590f1..c6e541a511 100644
--- a/contributions/AppsmithWidgetDevelopmentGuide.md
+++ b/contributions/AppsmithWidgetDevelopmentGuide.md
@@ -122,6 +122,7 @@ This exports the widget configuration as an object usually named `CONFIG`. The d
- `name` (required): The display name of this widget. This can contain spaces.
- `iconSVG` (required): `IconSVG`, where `IconSVG` is the import from the `./icon.svg`
- `needsMeta` (optional): `true`, if this widget stores temporary values. For example, a user input value or state.
+- `isDeprecated` (optional): This property indicates whether the widget is deprecated. If set to `true`, it means the widget is no longer recommended for use, and developers should consider using the specified replacement widget.
- `isCanvas` (optional): `true`, if this widget contains a Canvas within itself, to allow for widgets to be placed within.
- `properties` (required):
@@ -149,6 +150,8 @@ The widget code must be all available in the `widget` folder. `index.tsx` should
### Static methods:
- `getPropertyPaneConfig` (required, `[PropertyPaneConfig[]](#property-pane-configuration)`): returns the [property pane](#property-pane-configuration) configuration
+- `getPropertyPaneContentConfig` (required, `[PropertyPaneConfig[]](#property-pane-content-configuration)`): returns the [property pane content](#property-pane-content-configuration) configuration
+- `getPropertyPaneStyleConfig` (required, `[PropertyPaneConfig[]](#property-pane-style-configuration)`): returns the [property pane style](#property-pane-style-configuration) configuration
- `getDerivedPropertiesMap` (optional, [DerivedPropertiesMap](#derived-properties-configuration)): returns the map of properties which can be derived from other properties. We can see more details [here](#derived-properties-configuration)
- `getDefaultPropertiesMap` (optional, object): returns the list of properties which by default takes the value of a [default property](#default-properties-configuration)
- `getMetaPropertiesMap` (optional, object): returns the properties which will be considered and stored as [meta properties](#meta-properties-configuration).
@@ -231,6 +234,30 @@ Example:
+## Property pane content configuration
+
+Property pane content configuration defines the settings related to the content and functionality of the widget, including the order of property controls, their validations, grouping, types, etc.
+
+The type is `[Array](https://github.com/appsmithorg/appsmith/blob/e772fd4ff96accfb94818fa9f0b58dc6851a1cf0/app/client/src/constants/PropertyControlConstants.tsx#L100)``.
+
+Example:
+
+
+
+
+
+## Property pane style configuration
+
+Property pane style configuration defines the settings related to the appearance and styling of the widget, including the order of property controls, their validations, grouping, types, etc.
+
+The type is `[Array](https://github.com/appsmithorg/appsmith/blob/e772fd4ff96accfb94818fa9f0b58dc6851a1cf0/app/client/src/constants/PropertyControlConstants.tsx#L100)``.
+
+Example:
+
+
+
+
+
### PropertyPaneSectionConfig
This object defines sections in the property pane.
diff --git a/contributions/assets/propertyContentConfig.png b/contributions/assets/propertyContentConfig.png
new file mode 100644
index 0000000000000000000000000000000000000000..eeaccdf67a7f12370a8827ef7fa0743a5655062f
GIT binary patch
literal 348944
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