sprotty/src/features/bounds/stack-layout.ts

A next-gen framework for graphical views

/********************************************************************************
 * Copyright (c) 2017-2024 TypeFox and others.
 *
 * This program and the accompanying materials are made available under the
 * terms of the Eclipse Public License v. 2.0 which is available at
 * http://www.eclipse.org/legal/epl-2.0.
 *
 * This Source Code may also be made available under the following Secondary
 * Licenses when the conditions for such availability set forth in the Eclipse
 * Public License v. 2.0 are satisfied: GNU General Public License, version 2
 * with the GNU Classpath Exception which is available at
 * https://www.gnu.org/software/classpath/license.html.
 *
 * SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
 ********************************************************************************/

import { injectable } from 'inversify';
import { Bounds, Dimension, Point } from 'sprotty-protocol/lib/utils/geometry';
import { SParentElementImpl, SChildElementImpl } from "../../base/model/smodel";
import { AbstractLayout } from './abstract-layout';
import { AbstractLayoutOptions } from './layout-options';
import { BoundsData } from './hidden-bounds-updater';
import { InternalLayoutContainer, isLayoutableChild } from './model';
import { StatefulLayouter } from './layout';
import { VAlignment, HAlignment } from 'sprotty-protocol/lib/model';

export interface StackLayoutOptions extends AbstractLayoutOptions {
    paddingFactor: number
    vAlign: VAlignment
    hAlign: HAlignment
}

@injectable()
export class StackLayouter extends AbstractLayout<StackLayoutOptions> {

    static KIND = 'stack';

    protected getChildrenSize(container: SParentElementImpl & InternalLayoutContainer,
                            options: StackLayoutOptions,
                            layouter: StatefulLayouter) {
        let maxWidth = -1;
        let maxHeight = -1;
        container.children.forEach(
            child => {
                if (isLayoutableChild(child)) {
                    const bounds = layouter.getBoundsData(child).bounds;
                    if (bounds !== undefined && Dimension.isValid(bounds)) {
                        maxWidth = Math.max(maxWidth, bounds.width);
                        maxHeight = Math.max(maxHeight, bounds.height);
                    }
                }
            }
        );
        return {
            width: maxWidth,
            height: maxHeight
        };
    }

    protected layoutChild(child: SChildElementImpl,
                        boundsData: BoundsData,
                        bounds: Bounds,
                        childOptions: StackLayoutOptions,
                        containerOptions: StackLayoutOptions,
                        currentOffset: Point,
                        maxWidth: number, maxHeight: number): Point {
        const dx = this.getDx(childOptions.hAlign, bounds, maxWidth);
        const dy = this.getDy(childOptions.vAlign, bounds, maxHeight);
        boundsData.bounds = {
            x: containerOptions.paddingLeft + (child as any).bounds.x - bounds.x + dx,
            y: containerOptions.paddingTop + (child as any).bounds.y - bounds.y + dy,
            width: bounds.width,
            height: bounds.height
        };
        boundsData.boundsChanged = true;
        return currentOffset;
    }

    protected getDefaultLayoutOptions(): StackLayoutOptions {
        return {
            resizeContainer: true,
            paddingTop: 5,
            paddingBottom: 5,
            paddingLeft: 5,
            paddingRight: 5,
            paddingFactor: 1,
            hAlign: 'center',
            vAlign: 'center',
            minWidth: 0,
            minHeight: 0
        };
    }

    protected spread(a: StackLayoutOptions, b: StackLayoutOptions): StackLayoutOptions {
        return { ...a, ...b };
    }
}