flea-qml 0.0.0-stage → 0.2.0

package/ui/ViewportScrollBar.qml

@@ -0,0 +1,195 @@
+import QtQuick
+import qs.Commons
+import "." as Flea
+import "js/Scroll.js" as Scroll
+
+// An overlay on the viewport, never content; inside a Flickable it anchors to parent, never the Flickable id.
+Item {
+    id: root
+
+    required property var flickable
+    property int orientation: Qt.Vertical
+    property var ctrlWheelAction: null
+    property real endInset: 0
+    // The operator took the view: a press on the lane or a wheel over it, never the owner's own position writes.
+    signal userScrolled()
+
+    readonly property bool vertical: root.orientation === Qt.Vertical
+    // A flickable scrolls from origin less its leading margin to its content end plus the trailing margin, so the bar measures that span.
+    readonly property real leadMargin: root.vertical ? root.flickable.topMargin : root.flickable.leftMargin
+    readonly property real trailMargin: root.vertical ? root.flickable.bottomMargin : root.flickable.rightMargin
+    readonly property real contentLength: (root.vertical ? root.flickable.contentHeight : root.flickable.contentWidth)
+                                          + root.leadMargin + root.trailMargin
+    readonly property real viewportLength: root.vertical ? root.flickable.height : root.flickable.width
+    readonly property real origin: (root.vertical ? root.flickable.originY : root.flickable.originX) - root.leadMargin
+    readonly property real contentPosition: root.vertical ? root.flickable.contentY : root.flickable.contentX
+    readonly property real trackLength: Math.max(0, (root.vertical ? root.height : root.width) - root.endInset)
+    readonly property real handleLength: Scroll.handleLength(root.trackLength, root.contentLength,
+                                                              root.viewportLength, Theme.hitMin)
+    readonly property real handleOffset: Scroll.handleOffset(root.contentPosition, root.origin,
+                                                              root.contentLength, root.viewportLength,
+                                                              root.trackLength, Theme.hitMin)
+    readonly property bool overflow: Scroll.range(root.contentLength, root.viewportLength) > Scroll.OVERFLOW_PX
+    readonly property bool dragging: pointer.pressed && pointer.onHandle
+    // What the lane test reads beside the bar's own rect: the knob's drawn box in window pixels.
+    readonly property alias knobItem: handle
+    // Finder's overlay scroller: drawn only while the view moves, the pointer is in the lane or a press is down.
+    property bool moving: false
+    // A new listing resets the position in the same frame its length changes, which is not a scroll.
+    property bool settling: false
+    // A HoverHandler, not the MouseArea's containsMouse: a press reparents that area onto the window, and its hover goes stale.
+    readonly property bool inLane: lane.hovered
+    readonly property bool shown: Scroll.revealed(root.overflow, root.moving, root.inLane, pointer.pressed)
+    readonly property bool wide: root.inLane || pointer.pressed
+    readonly property real knobWidth: Math.round((root.wide ? Scroll.KNOB_WIDE_PX : Scroll.KNOB_REST_PX) * Theme.sizeRatio)
+    readonly property real knobInset: Math.round(Scroll.KNOB_INSET_PX * Theme.sizeRatio)
+    readonly property real knobAlpha: pointer.pressed ? Scroll.KNOB_PRESSED_ALPHA
+                                                      : root.wide ? Scroll.KNOB_HOVER_ALPHA : Scroll.KNOB_ALPHA
+
+    onContentLengthChanged: {
+        root.settling = true
+        Qt.callLater(function() { root.settling = false })
+    }
+    onContentPositionChanged: {
+        // A hidden view's move is no scroll anyone saw, so it never shows the bar on the view's return.
+        if (root.settling || !root.flickable.visible)
+            return
+        root.moving = true
+        hold.restart()
+    }
+
+    HoverHandler {
+        id: lane
+    }
+
+    Timer {
+        id: hold
+        interval: Scroll.HOLD_MS
+        onTriggered: root.moving = false
+    }
+
+    visible: root.overflow && root.flickable.visible
+    width: root.vertical ? Theme.spacing.rowPaddingX : root.flickable.width
+    height: root.vertical ? root.flickable.height : Theme.spacing.rowPaddingX
+    z: Scroll.BAR_Z
+
+    function setPosition(value) {
+        root.flickable.cancelFlick()
+        Scroll.stopTail(root.flickable)
+        if (root.vertical)
+            root.flickable.contentY = Scroll.bounded(value, root.flickable.originY, root.flickable.contentHeight,
+                root.flickable.height, root.flickable.topMargin, root.flickable.bottomMargin)
+        else
+            root.flickable.contentX = Scroll.bounded(value, root.flickable.originX, root.flickable.contentWidth,
+                root.flickable.width, root.flickable.leftMargin, root.flickable.rightMargin)
+    }
+
+    function page(direction) {
+        root.setPosition(root.contentPosition + direction * root.viewportLength)
+    }
+
+    function localAt(mouse) {
+        if (pointer.parent === root)
+            return root.vertical ? mouse.y : mouse.x
+        var p = pointer.mapToItem(root, mouse.x, mouse.y)
+        return root.vertical ? p.y : p.x
+    }
+
+    // Every press saved the view's own flag; a second end (released, then canceled) finds onHandle false.
+    function endDrag() {
+        pointer.parent = root
+        if (pointer.onHandle)
+            root.flickable.interactive = pointer.savedInteractive
+        pointer.onHandle = false
+    }
+
+    Accessible.role: Accessible.ScrollBar
+    Accessible.name: root.vertical ? "Vertical scroll bar" : "Horizontal scroll bar"
+    Accessible.description: "Scroll position"
+    Accessible.onIncreaseAction: root.page(1)
+    Accessible.onDecreaseAction: root.page(-1)
+
+    // Everything drawn fades together; the entrance is instant, and reduced motion snaps the exit too.
+    Item {
+        anchors.fill: parent
+        opacity: root.shown ? 1 : 0
+        Behavior on opacity {
+            enabled: !root.shown && !Theme.reducedMotion
+            NumberAnimation { duration: Scroll.FADE_MS }
+        }
+
+        // The track fills the lane with the pointer in it, never a line along it.
+        Rectangle {
+            visible: root.wide
+            x: 0
+            y: 0
+            width: root.vertical ? root.width : root.trackLength
+            height: root.vertical ? root.trackLength : root.height
+            color: Qt.rgba(Theme.color.foreground.r, Theme.color.foreground.g, Theme.color.foreground.b, Scroll.TRACK_ALPHA)
+        }
+
+        Rectangle {
+            id: handle
+            x: root.vertical ? root.width - root.knobInset - width : root.handleOffset
+            y: root.vertical ? root.handleOffset : root.height - root.knobInset - height
+            width: root.vertical ? root.knobWidth : root.handleLength
+            height: root.vertical ? root.handleLength : root.knobWidth
+            radius: Scroll.knobRadius(Style.cornerRadius, width, height)
+            color: Qt.rgba(Theme.color.foreground.r, Theme.color.foreground.g, Theme.color.foreground.b, root.knobAlpha)
+        }
+    }
+
+    // The drag reparents this grab onto the window, so no Flickable child over recycling rows becomes Qt's retarget.
+    MouseArea {
+        id: pointer
+        anchors.fill: parent
+        acceptedButtons: Qt.LeftButton
+        hoverEnabled: true
+        preventStealing: true
+        z: pointer.parent === root ? 0 : Scroll.GRAB_Z
+        property bool onHandle: false
+        property real grabOffset: 0
+        property bool savedInteractive: true
+
+        onPressed: function(mouse) {
+            root.userScrolled()
+            var at = root.localAt(mouse)
+            var start = root.handleOffset
+            if (at < start || at > start + root.handleLength) {
+                // Finder's jump to the spot clicked: the knob's centre goes under the pointer, and the press drags on from there.
+                var room = Scroll.travel(root.trackLength, root.contentLength, root.viewportLength, Theme.hitMin)
+                start = Scroll.jumpOffset(at, root.handleLength, room)
+                root.setPosition(Scroll.positionForHandle(start, root.origin, root.contentLength,
+                    root.viewportLength, root.trackLength, Theme.hitMin))
+            }
+            pointer.onHandle = true
+            pointer.grabOffset = at - start
+            pointer.savedInteractive = root.flickable.interactive
+            root.flickable.interactive = false
+            root.flickable.cancelFlick()
+            Scroll.stopTail(root.flickable)
+            var win = root.Window.window
+            if (win && win.contentItem)
+                pointer.parent = win.contentItem
+        }
+        onPositionChanged: function(mouse) {
+            if (!pointer.pressed || !pointer.onHandle)
+                return
+            // A track no longer than the minimum handle leaves it no travel, and a drag with none moves nothing.
+            if (Scroll.travel(root.trackLength, root.contentLength, root.viewportLength, Theme.hitMin) === 0)
+                return
+            var at = root.localAt(mouse) - pointer.grabOffset
+            root.setPosition(Scroll.positionForHandle(at, root.origin, root.contentLength,
+                root.viewportLength, root.trackLength, Theme.hitMin))
+        }
+        onReleased: root.endDrag()
+        onCanceled: root.endDrag()
+    }
+
+    Flea.FastScrollHandler {
+        parent: root
+        flickable: root.flickable
+        ctrlWheelAction: root.ctrlWheelAction
+        onWheeled: root.userScrolled()
+    }
+}

package/ui/ViewportScrollBars.qml

@@ -0,0 +1,25 @@
+import QtQuick
+import "." as Flea
+import "js/Scroll.js" as Scroll
+
+// Both axes of a pannable document, sharing the trailing corner rather than painting through it.
+Item {
+    id: root
+    required property var flickable
+    anchors.fill: parent
+    z: Scroll.BAR_Z
+
+    Flea.ViewportScrollBar {
+        parent: root
+        anchors { top: parent.top; right: parent.right }
+        flickable: root.flickable
+        endInset: Theme.spacing.rowPaddingX
+    }
+    Flea.ViewportScrollBar {
+        parent: root
+        anchors { left: parent.left; bottom: parent.bottom }
+        flickable: root.flickable
+        orientation: Qt.Horizontal
+        endInset: Theme.spacing.rowPaddingX
+    }
+}

package/ui/WebPreview.qml

@@ -0,0 +1,33 @@
+import QtQuick
+
+// A passive HTML page in a sandboxed web view, shared by the previews that can use one: a
+// WebEngineView where the runtime has it (buninu-browser's iframe, or Quickshell with Qt
+// WebEngine). `available` stays false where it does not, and the host keeps its own view.
+Item {
+    id: root
+
+    // The whole page to show; empty shows nothing new.
+    property string html: ""
+    readonly property bool available: viewLoader.status === Loader.Ready
+    // An http(s) or mailto link the reader activated, already refused by the view.
+    signal linkActivated(string url)
+
+    function show() {
+        if (viewLoader.item !== null && root.html !== "")
+            viewLoader.item.loadHtml(root.html)
+    }
+    onHtmlChanged: root.show()
+
+    Loader {
+        id: viewLoader
+        anchors.fill: parent
+        source: "WebPreviewView.qml"
+        onLoaded: root.show()
+    }
+
+    Connections {
+        target: viewLoader.item
+        ignoreUnknownSignals: true
+        function onLinkActivated(url) { root.linkActivated(url) }
+    }
+}

package/ui/WebPreviewView.qml

@@ -0,0 +1,26 @@
+import QtQuick
+import QtWebEngine
+
+// The web view WebPreview loads, and the only file that imports QtWebEngine: where the module
+// is missing this file fails to load and WebPreview reports itself unavailable. The page comes
+// from loadHtml, already rebuilt from an allowlist (src/markdown-html.js); this view adds no
+// script, no plugin, no window and no reach from that local page to remote or file URLs.
+WebEngineView {
+    id: view
+
+    // An activated link, refused here so the view keeps its page; the host decides what opens it.
+    signal linkActivated(string url)
+
+    settings.javascriptEnabled: false
+    settings.javascriptCanOpenWindows: false
+    settings.pluginsEnabled: false
+    settings.localContentCanAccessRemoteUrls: false
+    settings.localContentCanAccessFileUrls: false
+
+    onNavigationRequested: function (request) {
+        if (request.navigationType !== WebEngineNavigationRequest.LinkClickedNavigation)
+            return
+        request.reject()
+        view.linkActivated(String(request.url))
+    }
+}