Properties

User manual for Servoy Developer Properties View

Overview

The Properties View in Servoy Developer is a versatile and essential tool that displays context-specific information about a selected item. This view is integral to the development and customization of solutions, forms, and components in Servoy. The properties displayed are tailored to the selected item, providing specific options and configurations pertinent to that item's functionality and characteristics.

Once a property item is modified or set, this property is saved with no further action required.

General Features

Toolbar Buttons

Pin

Pins the property view to the current selection.

Show Advanced Properties

Displays advanced or less commonly used properties.

Restore Default Value

Resets a property to its default value, undoing any customizations made to that property.

View Menu

Displays the following options:

• New Properties View: Opens a new instance of the Properties View, allowing for comparison between different items.

• Pin to Selection: Pins the current selection, so the view remains focused on the pinned item even if other items are selected.

• Show Categories: Toggles the grouping of properties into categories for easier navigation.

• Show Advanced Properties: Displays advanced or less commonly used properties.

• Configure Columns: Customizes the columns displayed in the Properties View for better visualization and organization.

Categories of Properties

Commands

Actions that can be executed on the selected item.

Events

Event handlers that respond to specific events (e.g., onClick, onLoad) triggered by the item.

Properties

General settings and attributes specific to the item, such as size, style, and data bindings.

Layout

Positioning and size properties that control the appearance of the item within its container.

Context-Specific Information

The Properties View adjusts its content based on the currently selected item in the Editor window. This ensures that developers have access to relevant properties and settings for the item they are working on.

Common Property Categories

While the specific properties vary between items, the general categories of properties available in the Properties View include:

Commands

Actions or operations that can be performed on the item, such as sorting or executing specific methods.

Events

Event handlers that allow developers to define custom behavior when certain events occur. Common events include onClick, onLoad, onShow, and onHide.

General Properties

Basic settings that define the characteristics and behavior of the item. These can include:

• Name: The identifier for the item.

• Text: The displayed text for components like labels or buttons.

• DataSource: The data source from which the item retrieves its data.

• StyleClass: CSS classes that define the visual appearance of the item.

• Enabled: A boolean property indicating whether the item is interactive.

Layout Properties

Properties that control the positioning and size of the item within its parent container. These include:

• Position: CSS positioning properties such as top, left, width, and height.

• Visibility: Controls whether the item is visible or hidden.

Advanced Properties

Additional settings that provide more control over the item's functionality and appearance. These properties might be less frequently used but offer deeper customization options.

Usage

The Properties View is used extensively in the design and development process to fine-tune the behavior and appearance of items in a Servoy solution. By providing a centralized interface for managing properties, it helps streamline development and ensures that all necessary configurations are easily accessible.