# Default Properties

This page outlines the **Default Properties** available to widgets in Digia Studio. These properties are grouped into three main sections:

1. **Layout** – for controlling spacing, dimensions, and alignment
2. **Appearance** – for customizing the visual presentation
3. **Interactions** – for attaching user actions

Widgets may support all or only some of these sections depending on their nature. Refer to each widget’s documentation to confirm which sections apply.

***

### Layout Properties

These properties define how the widget is laid out within its parent.

| Property  | Description                                                                              |
| --------- | ---------------------------------------------------------------------------------------- |
| `width`   | Sets the fixed width of the widget. Accepts numeric or percentage values.                |
| `height`  | Sets the fixed height of the widget. Accepts numeric or percentage values.               |
| `padding` | Space **inside** the widget, between its content and border. Can be uniform or per-side. |
| `margin`  | Space **outside** the widget, between it and other widgets.                              |
| `align`   | Alignment within the parent container (e.g., `topLeft`, `center`, `bottomRight`).        |

***

### Appearance Properties

These properties control how the widget looks.

| Property             | Description                                                                          |
| -------------------- | ------------------------------------------------------------------------------------ |
| `bgColor`            | Background color of the widget in HEX format.                                        |
| `borderRadius`       | Controls the curvature of the widget’s corners. Can be a single or per-corner value. |
| `border`             | Contains all border-related styling.                                                 |
| `border.borderWidth` | Thickness of the border in pixels.                                                   |
| `border.borderColor` | Color of the border in HEX format.                                                   |
| `border.borderType`  | Pattern type of the border (`solid`, `dashed`).                                      |
| `border.strokeAlign` | Whether the border is drawn `inside`, `center`, or `outside` the widget’s bounds.    |

***

### Interactions

These properties define user-triggered actions.

| Property  | Description                                                                                                       |
| --------- | ----------------------------------------------------------------------------------------------------------------- |
| `onClick` | Action to be triggered when the widget is tapped or clicked. Supports navigation, state changes, animations, etc. |

***

Use these properties to control layout, appearance, and interactivity consistently across widgets in your application.

For examples and usage, refer back to each individual widget’s documentation.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.digia.tech/ui-building-blocks/widgets/default-properties.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
