GML/Widget/DynamicWidgetContainer(5) - SerenityOS man pages

#Name

GML DynamicWidgetContainer

#Description

Defines a container widget that will group its child widgets together so that they can be collapsed, expanded or detached to a new window as one unit. If DynamicWidgetContainers are nested within one DynamicWidgetContainer it is possible to move the positions of the child containers dynamically.

Property	Description
config_domain	Defines if the changes to the widget's view state should be persisted. It is required that the domain has been already pleged by the application.
detached_size	Defines a size that the detached widget window should initially have. If not defined, the window will have the current size of the widget.
section_label	The label that will be used for the section.
show_controls	Defines if the buttons and label should be visible or not. This allows e.g. a parent container to hide its controls but provide rearrenage functionality.
with_individual_order	Configured on a parent container to enable the persistence of rearranged child containers.

#Synopsis

@GUI::DynamicWidgetContainer

#Examples

Simple container:

@GUI::DynamicWidgetContainer {
    section_label: "Section 1"

    @GUI::Widget {
    }
    
    @GUI::Widget {
    }
}

Nested containers with persistence:

@GUI::DynamicWidgetContainer {
    section_label: "Parent Section"
    config_domain: "abc"
    with_individual_order: true
    detached_size: [200, 640]

    @GUI::DynamicWidgetContainer {
        section_label: "Section 1"
        config_domain: "abc"

        @GUI::Widget {
        }
        
        @GUI::Widget {
        }
    }
    
    @GUI::DynamicWidgetContainer {
        section_label: "Section 2"
        config_domain: "abc"

        @GUI::Widget {
        }
        
        @GUI::Widget {
        }
    } 
}