perf(ui): contract hysteresis on the AlbumGrid mounted band
Split the row band into pure target props and a stored mounted band. Expansion still follows the target immediately (cards mount before reaching the visible area); contraction lags by one row, so a few-px oscillation across a row boundary no longer mounts/unmounts a whole row of AlbumCards per direction change. window-changed now fires only when the mounted band actually moves. Non-windowed consumers (Discover/Favorites/Labels/grouped) are behavior-identical. cc
This commit is contained in:
1 file changed
+45
-7
@@ -47,23 +47,61 @@ component AlbumGrid inherits Rectangle {
|
|||||||
? self.rows * root.card-height + Math.max(0, self.rows - 1) * root.card-gap
|
? self.rows * root.card-height + Math.max(0, self.rows - 1) * root.card-gap
|
||||||
: 0px;
|
: 0px;
|
||||||
|
|
||||||
// Row band = visible rows ± one full viewport. Row-granular ints, so the
|
// Target band = visible rows ± one full viewport. Row-granular ints, so
|
||||||
// `changed` handlers only fire when a row boundary is crossed (~every
|
// the `changed` handlers only fire when a row boundary is crossed (~every
|
||||||
// 270px of scroll), not per scrolled pixel.
|
// 270px of scroll), not per scrolled pixel.
|
||||||
property <length> row-stride: root.card-height + root.card-gap;
|
property <length> row-stride: root.card-height + root.card-gap;
|
||||||
property <length> local-top: root.visible-top - root.content-offset;
|
property <length> local-top: root.visible-top - root.content-offset;
|
||||||
property <int> first-window-row: root.windowed
|
property <int> target-first-row: root.windowed
|
||||||
? Math.max(0, Math.floor((root.local-top - root.visible-height) / root.row-stride))
|
? Math.max(0, Math.floor((root.local-top - root.visible-height) / root.row-stride))
|
||||||
: 0;
|
: 0;
|
||||||
property <int> last-window-row: root.windowed
|
property <int> target-last-row: root.windowed
|
||||||
? Math.max(0, Math.floor((root.local-top + 2 * root.visible-height) / root.row-stride))
|
? Math.max(0, Math.floor((root.local-top + 2 * root.visible-height) / root.row-stride))
|
||||||
: 0;
|
: 0;
|
||||||
changed first-window-row => { root.notify-window(); }
|
// Mounted band = target band + contract hysteresis. Expansion follows the
|
||||||
changed last-window-row => { root.notify-window(); }
|
// target immediately (a card must be mounted before it can reach the
|
||||||
|
// visible area); contraction lags by `hysteresis-rows`, so a few-px
|
||||||
|
// oscillation across a row boundary cannot mount/unmount a whole row of
|
||||||
|
// cards on every direction change.
|
||||||
|
property <int> hysteresis-rows: 1;
|
||||||
|
property <int> first-window-row: 0;
|
||||||
|
property <int> last-window-row: 0;
|
||||||
|
pure function desired-first-row() -> int {
|
||||||
|
if (root.target-first-row < root.first-window-row) {
|
||||||
|
return root.target-first-row;
|
||||||
|
}
|
||||||
|
if (root.target-first-row > root.first-window-row + root.hysteresis-rows) {
|
||||||
|
return root.target-first-row - root.hysteresis-rows;
|
||||||
|
}
|
||||||
|
return root.first-window-row;
|
||||||
|
}
|
||||||
|
pure function desired-last-row() -> int {
|
||||||
|
if (root.target-last-row > root.last-window-row) {
|
||||||
|
return root.target-last-row;
|
||||||
|
}
|
||||||
|
if (root.target-last-row < root.last-window-row - root.hysteresis-rows) {
|
||||||
|
return root.target-last-row + root.hysteresis-rows;
|
||||||
|
}
|
||||||
|
return root.last-window-row;
|
||||||
|
}
|
||||||
|
function apply-window() {
|
||||||
|
if (root.desired-first-row() != root.first-window-row
|
||||||
|
|| root.desired-last-row() != root.last-window-row) {
|
||||||
|
root.first-window-row = root.desired-first-row();
|
||||||
|
root.last-window-row = root.desired-last-row();
|
||||||
|
root.notify-window();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
changed target-first-row => { root.apply-window(); }
|
||||||
|
changed target-last-row => { root.apply-window(); }
|
||||||
// Column count changes on first layout and on window resize — the band's
|
// Column count changes on first layout and on window resize — the band's
|
||||||
// ITEM indices depend on it, so re-notify.
|
// ITEM indices depend on it, so re-notify.
|
||||||
changed columns => { root.notify-window(); }
|
changed columns => { root.notify-window(); }
|
||||||
init => { root.notify-window(); }
|
init => {
|
||||||
|
root.first-window-row = root.target-first-row;
|
||||||
|
root.last-window-row = root.target-last-row;
|
||||||
|
root.notify-window();
|
||||||
|
}
|
||||||
function notify-window() {
|
function notify-window() {
|
||||||
if (root.windowed) {
|
if (root.windowed) {
|
||||||
root.window-changed(
|
root.window-changed(
|
||||||
|
|||||||
Reference in new issue
Block a user