webkitgtk-2.16.5HEADwebkitgtk-2.16.5master

1 files changed, 297 insertions, 0 deletions

diff --git a/Source/WebInspectorUI/UserInterface/Views/Sidebar.js b/Source/WebInspectorUI/UserInterface/Views/Sidebar.js
new file mode 100644
index 000000000..6071fa6ba
--- /dev/null
+++ b/Source/WebInspectorUI/UserInterface/Views/Sidebar.js
@@ -0,0 +1,297 @@
+/*
+ * Copyright (C) 2013, 2015 Apple Inc. All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ * 1. Redistributions of source code must retain the above copyright
+ *    notice, this list of conditions and the following disclaimer.
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ *
+ * THIS SOFTWARE IS PROVIDED BY APPLE INC. AND ITS CONTRIBUTORS ``AS IS''
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
+ * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+ * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL APPLE INC. OR ITS CONTRIBUTORS
+ * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
+ * THE POSSIBILITY OF SUCH DAMAGE.
+ */
+
+WebInspector.Sidebar = class Sidebar extends WebInspector.View
+{
+    constructor(element, side, sidebarPanels, role, label, hasNavigationBar)
+    {
+        super(element);
+
+        console.assert(!side || side === WebInspector.Sidebar.Sides.Left || side === WebInspector.Sidebar.Sides.Right);
+        this._side = side || WebInspector.Sidebar.Sides.Left;
+        this._collapsed = true;
+
+        this.element.classList.add("sidebar", this._side, WebInspector.Sidebar.CollapsedStyleClassName);
+
+        this.element.setAttribute("role", role || "group");
+        if (label)
+            this.element.setAttribute("aria-label", label);
+
+        if (hasNavigationBar) {
+            this.element.classList.add("has-navigation-bar");
+
+            this._navigationBar = new WebInspector.NavigationBar(null, null, "tablist");
+            this._navigationBar.addEventListener(WebInspector.NavigationBar.Event.NavigationItemSelected, this._navigationItemSelected, this);
+            this.addSubview(this._navigationBar);
+        }
+
+        this._resizer = new WebInspector.Resizer(WebInspector.Resizer.RuleOrientation.Vertical, this);
+        this.element.insertBefore(this._resizer.element, this.element.firstChild);
+
+        this._sidebarPanels = [];
+
+        if (sidebarPanels) {
+            for (let sidebarPanel of sidebarPanels)
+                this.addSidebarPanel(sidebarPanel);
+        }
+    }
+
+    // Public
+
+    addSidebarPanel(sidebarPanel)
+    {
+        console.assert(sidebarPanel instanceof WebInspector.SidebarPanel);
+        if (!(sidebarPanel instanceof WebInspector.SidebarPanel))
+            return null;
+
+        console.assert(!sidebarPanel.parentSidebar);
+        if (sidebarPanel.parentSidebar)
+            return null;
+
+        this._sidebarPanels.push(sidebarPanel);
+        this.addSubview(sidebarPanel);
+
+        if (this._navigationBar) {
+            console.assert(sidebarPanel.navigationItem);
+            this._navigationBar.addNavigationItem(sidebarPanel.navigationItem);
+        }
+
+        sidebarPanel.added();
+
+        return sidebarPanel;
+    }
+
+    removeSidebarPanel(sidebarPanelOrIdentifierOrIndex)
+    {
+        var sidebarPanel = this.findSidebarPanel(sidebarPanelOrIdentifierOrIndex);
+        if (!sidebarPanel)
+            return null;
+
+        sidebarPanel.selected = false;
+
+        if (sidebarPanel.visible) {
+            sidebarPanel.hidden();
+            sidebarPanel.visibilityDidChange();
+        }
+
+        if (this._selectedSidebarPanel === sidebarPanel) {
+            var index = this._sidebarPanels.indexOf(sidebarPanel);
+            this.selectedSidebarPanel = this._sidebarPanels[index - 1] || this._sidebarPanels[index + 1] || null;
+        }
+
+        this._sidebarPanels.remove(sidebarPanel);
+        this.removeSubview(sidebarPanel);
+
+        if (this._navigationBar) {
+            console.assert(sidebarPanel.navigationItem);
+            this._navigationBar.removeNavigationItem(sidebarPanel.navigationItem);
+        }
+
+        sidebarPanel.removed();
+
+        return sidebarPanel;
+    }
+
+    get selectedSidebarPanel()
+    {
+        return this._selectedSidebarPanel || null;
+    }
+
+    set selectedSidebarPanel(sidebarPanelOrIdentifierOrIndex)
+    {
+        var sidebarPanel = this.findSidebarPanel(sidebarPanelOrIdentifierOrIndex);
+        if (this._selectedSidebarPanel === sidebarPanel)
+            return;
+
+        if (this._selectedSidebarPanel) {
+            var wasVisible = this._selectedSidebarPanel.visible;
+
+            this._selectedSidebarPanel.selected = false;
+
+            if (wasVisible) {
+                this._selectedSidebarPanel.hidden();
+                this._selectedSidebarPanel.visibilityDidChange();
+            }
+        }
+
+        this._selectedSidebarPanel = sidebarPanel || null;
+
+        if (this._navigationBar)
+            this._navigationBar.selectedNavigationItem = sidebarPanel ? sidebarPanel.navigationItem : null;
+
+        if (this._selectedSidebarPanel) {
+            this._selectedSidebarPanel.selected = true;
+
+            if (this._selectedSidebarPanel.visible) {
+                this._selectedSidebarPanel.shown();
+                this._selectedSidebarPanel.visibilityDidChange();
+            }
+        }
+
+        this.dispatchEventToListeners(WebInspector.Sidebar.Event.SidebarPanelSelected);
+    }
+
+    get minimumWidth()
+    {
+        if (this._navigationBar)
+            return Math.max(WebInspector.Sidebar.AbsoluteMinimumWidth, this._navigationBar.minimumWidth);
+        if (this._selectedSidebarPanel)
+            return Math.max(WebInspector.Sidebar.AbsoluteMinimumWidth, this._selectedSidebarPanel.minimumWidth);
+        return WebInspector.Sidebar.AbsoluteMinimumWidth;
+    }
+
+    get maximumWidth()
+    {
+        // FIXME: This is kind of arbitrary and ideally would be a more complex calculation based on the
+        // available space for the sibling elements.
+        return Math.round(window.innerWidth / 3);
+    }
+
+    get width()
+    {
+        return this.element.offsetWidth;
+    }
+
+    set width(newWidth)
+    {
+        if (newWidth === this.width)
+            return;
+
+        this._recalculateWidth(newWidth);
+    }
+
+    get collapsed()
+    {
+        return this._collapsed;
+    }
+
+    set collapsed(flag)
+    {
+        if (flag === this._collapsed)
+            return;
+
+        this._collapsed = flag || false;
+        this.element.classList.toggle(WebInspector.Sidebar.CollapsedStyleClassName);
+
+        if (!this._collapsed && this._navigationBar)
+            this._navigationBar.needsLayout();
+
+        if (this._selectedSidebarPanel) {
+            if (this._selectedSidebarPanel.visible)
+                this._selectedSidebarPanel.shown();
+            else
+                this._selectedSidebarPanel.hidden();
+
+            this._selectedSidebarPanel.visibilityDidChange();
+        }
+
+        this.dispatchEventToListeners(WebInspector.Sidebar.Event.CollapsedStateDidChange);
+        this.dispatchEventToListeners(WebInspector.Sidebar.Event.WidthDidChange);
+    }
+
+    get sidebarPanels()
+    {
+        return this._sidebarPanels;
+    }
+
+    get side()
+    {
+        return this._side;
+    }
+
+    findSidebarPanel(sidebarPanelOrIdentifierOrIndex)
+    {
+        var sidebarPanel = null;
+
+        if (sidebarPanelOrIdentifierOrIndex instanceof WebInspector.SidebarPanel) {
+            if (this._sidebarPanels.includes(sidebarPanelOrIdentifierOrIndex))
+                sidebarPanel = sidebarPanelOrIdentifierOrIndex;
+        } else if (typeof sidebarPanelOrIdentifierOrIndex === "number") {
+            sidebarPanel = this._sidebarPanels[sidebarPanelOrIdentifierOrIndex];
+        } else if (typeof sidebarPanelOrIdentifierOrIndex === "string") {
+            for (var i = 0; i < this._sidebarPanels.length; ++i) {
+                if (this._sidebarPanels[i].identifier === sidebarPanelOrIdentifierOrIndex) {
+                    sidebarPanel = this._sidebarPanels[i];
+                    break;
+                }
+            }
+        }
+
+        return sidebarPanel;
+    }
+
+    // Protected
+
+    resizerDragStarted(resizer)
+    {
+        this._widthBeforeResize = this.width;
+    }
+
+    resizerDragging(resizer, positionDelta)
+    {
+        if (this._side === WebInspector.Sidebar.Sides.Left)
+            positionDelta *= -1;
+
+        var newWidth = positionDelta + this._widthBeforeResize;
+        this.width = newWidth;
+        this.collapsed = (newWidth < (this.minimumWidth / 2));
+    }
+
+    // Private
+
+    _recalculateWidth(newWidth = this.width)
+    {
+        // Need to add 1 because of the 1px border-right.
+        newWidth = Math.ceil(Number.constrain(newWidth, this.minimumWidth + 1, this.maximumWidth));
+        this.element.style.width = `${newWidth}px`;
+
+        if (!this.collapsed && this._navigationBar)
+            this._navigationBar.needsLayout();
+
+        if (!this.collapsed && this._selectedSidebarPanel)
+            this._selectedSidebarPanel.updateLayoutIfNeeded(WebInspector.View.LayoutReason.Resize);
+
+        this.dispatchEventToListeners(WebInspector.Sidebar.Event.WidthDidChange, {newWidth});
+    }
+
+    _navigationItemSelected(event)
+    {
+        this.selectedSidebarPanel = event.target.selectedNavigationItem ? event.target.selectedNavigationItem.identifier : null;
+    }
+};
+
+WebInspector.Sidebar.CollapsedStyleClassName = "collapsed";
+WebInspector.Sidebar.AbsoluteMinimumWidth = 200;
+
+WebInspector.Sidebar.Sides = {
+    Right: "right",
+    Left: "left"
+};
+
+WebInspector.Sidebar.Event = {
+    SidebarPanelSelected: "sidebar-panel-selected",
+    CollapsedStateDidChange: "sidebar-collapsed-state-did-change",
+    WidthDidChange: "sidebar-width-did-change",
+};