# FreeFormLayoutElementProperty

An element within a free-form layout.

- Source: Generated code
- Type last changed: v2.272.0 · 30 Sep 2026

## Example

```ts
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { aws_quicksight as quicksight } from 'aws-cdk-lib';
const freeFormLayoutElementProperty: quicksight.CfnAnalysis.FreeFormLayoutElementProperty = {
  elementId: 'elementId',
  elementType: 'elementType',
  height: 'height',
  width: 'width',
  xAxisLocation: 'xAxisLocation',
  yAxisLocation: 'yAxisLocation',

  // the properties below are optional
  backgroundStyle: {
    color: 'color',
    visibility: 'visibility',
  },
  borderRadius: 'borderRadius',
  borderStyle: {
    color: 'color',
    visibility: 'visibility',
    width: 'width',
  },
  loadingAnimation: {
    visibility: 'visibility',
  },
  padding: 'padding',
  renderingRules: [{
    configurationOverrides: {
      visibility: 'visibility',
    },
    expression: 'expression',
  }],
  selectedBorderStyle: {
    color: 'color',
    visibility: 'visibility',
    width: 'width',
  },
  visibility: 'visibility',
};
```

## Properties

- `backgroundStyle`: [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [CfnAnalysis.FreeFormLayoutElementBackgroundStyleProperty](/cdk/api/v2/docs/aws-cdk-lib.aws_quicksight.CfnAnalysis.FreeFormLayoutElementBackgroundStyleProperty.html) — The background style configuration of a free-form layout element.

- `borderRadius`: string

- `borderStyle`: [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [CfnAnalysis.FreeFormLayoutElementBorderStyleProperty](/cdk/api/v2/docs/aws-cdk-lib.aws_quicksight.CfnAnalysis.FreeFormLayoutElementBorderStyleProperty.html) — The border style configuration of a free-form layout element.

- `elementId`: string (required) — A unique identifier for an element within a free-form layout.

- `elementType`: string (required) — The type of element.

- `height`: string (required) — The height of an element within a free-form layout.

- `loadingAnimation`: [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [CfnAnalysis.LoadingAnimationProperty](/cdk/api/v2/docs/aws-cdk-lib.aws_quicksight.CfnAnalysis.LoadingAnimationProperty.html) — The loading animation configuration of a free-form layout element.

- `padding`: string

- `renderingRules`: [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [CfnAnalysis.SheetElementRenderingRuleProperty](/cdk/api/v2/docs/aws-cdk-lib.aws_quicksight.CfnAnalysis.SheetElementRenderingRuleProperty.html)[] — The rendering rules that determine when an element should be displayed within a free-form layout.

- `selectedBorderStyle`: [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [CfnAnalysis.FreeFormLayoutElementBorderStyleProperty](/cdk/api/v2/docs/aws-cdk-lib.aws_quicksight.CfnAnalysis.FreeFormLayoutElementBorderStyleProperty.html) — The border style configuration of a free-form layout element.

  This border style is used when the element is selected.

- `visibility`: string — The visibility of an element within a free-form layout.

- `width`: string (required) — The width of an element within a free-form layout.

- `xAxisLocation`: string (required) — The x-axis coordinate of the element.

- `yAxisLocation`: string (required) — The y-axis coordinate of the element.
