@loomidev/floating-panel 0.5.0 → 0.6.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +14 -14
- package/package.json +4 -4
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# @loomidev/floating-panel
|
|
2
2
|
|
|
3
|
-
`<loomi-floating-panel>`
|
|
3
|
+
`<loomi-floating-panel>` - a draggable, resizable panel that floats above the page,
|
|
4
4
|
unanchored to any trigger. Think devtools panel, help widget, or a chat window you can
|
|
5
5
|
drag around and resize.
|
|
6
6
|
|
|
@@ -60,7 +60,7 @@ removes all eight resize handles.
|
|
|
60
60
|
|
|
61
61
|
```html
|
|
62
62
|
<loomi-floating-panel name="pinned" title="Pinned" no-drag resizable="false">
|
|
63
|
-
Fixed in place
|
|
63
|
+
Fixed in place - no header drag, no resize handles.
|
|
64
64
|
</loomi-floating-panel>
|
|
65
65
|
```
|
|
66
66
|
|
|
@@ -71,7 +71,7 @@ from that edge/corner. Hold <kbd>Shift</kbd> for a bigger step.
|
|
|
71
71
|
## Minimize, Maximize & Drag Handle
|
|
72
72
|
|
|
73
73
|
`minimize` and `maximize` add header buttons that toggle collapsing the panel to just its
|
|
74
|
-
title bar, or expanding it to fill the viewport
|
|
74
|
+
title bar, or expanding it to fill the viewport - both off by default. `drag-handle`
|
|
75
75
|
restricts dragging to a small grip icon instead of the whole header, useful once you add
|
|
76
76
|
your own interactive content there.
|
|
77
77
|
|
|
@@ -83,13 +83,13 @@ your own interactive content there.
|
|
|
83
83
|
|
|
84
84
|
Toggling either fires `loomi-minimize`/`loomi-maximize`; maximizing clears `minimized` and
|
|
85
85
|
vice versa, since a panel can't be both at once. Restoring from maximized snaps back to
|
|
86
|
-
the exact rect the panel had before
|
|
86
|
+
the exact rect the panel had before - dragging and resizing are disabled while maximized
|
|
87
87
|
(and resizing while minimized, since there's no body to resize into). Double-clicking the
|
|
88
88
|
header also toggles maximize, when `maximize` is enabled.
|
|
89
89
|
|
|
90
90
|
## Multiple Panels & Stacking
|
|
91
91
|
|
|
92
|
-
Open as many panels as you like
|
|
92
|
+
Open as many panels as you like - clicking or dragging anywhere inside a panel (header,
|
|
93
93
|
body, or a resize handle) brings it to the front of the stack automatically, so the last
|
|
94
94
|
one you touched is always on top.
|
|
95
95
|
|
|
@@ -111,22 +111,22 @@ page reloads.
|
|
|
111
111
|
|
|
112
112
|
## Accessibility
|
|
113
113
|
|
|
114
|
-
`<loomi-floating-panel>` renders as `role="dialog"` with `aria-modal="false"`
|
|
114
|
+
`<loomi-floating-panel>` renders as `role="dialog"` with `aria-modal="false"` - it never
|
|
115
115
|
traps focus or blocks the rest of the page, since it floats alongside content rather than
|
|
116
116
|
over it. Opening a panel moves focus to its header; closing it restores focus to whatever
|
|
117
117
|
was focused before, and <kbd>Escape</kbd> closes the panel only while focus is inside it
|
|
118
118
|
(so multiple open panels don't all close on one keypress).
|
|
119
119
|
|
|
120
|
-
- <kbd>Tab</kbd> / <kbd>Shift+Tab</kbd>
|
|
120
|
+
- <kbd>Tab</kbd> / <kbd>Shift+Tab</kbd> - reach the minimize/maximize/close buttons,
|
|
121
121
|
slotted content, and every resize handle (or the grip, when `drag-handle` is set).
|
|
122
|
-
- Arrow keys on the focused header (or grip)
|
|
122
|
+
- Arrow keys on the focused header (or grip) - move the panel; hold <kbd>Shift</kbd> for
|
|
123
123
|
a 10px step.
|
|
124
|
-
- Arrow keys on a focused resize handle
|
|
124
|
+
- Arrow keys on a focused resize handle - resize from that edge/corner; hold
|
|
125
125
|
<kbd>Shift</kbd> for a 10px step.
|
|
126
|
-
- <kbd>Escape</kbd>
|
|
126
|
+
- <kbd>Escape</kbd> - close, while focus is inside the panel.
|
|
127
127
|
- Visible `:focus-visible` rings on the header, grip, header buttons, and resize handles.
|
|
128
128
|
|
|
129
|
-
For the library-wide baseline, see [Foundations
|
|
129
|
+
For the library-wide baseline, see [Foundations - Accessibility](https://loomiui.com/foundations/#accessibility).
|
|
130
130
|
|
|
131
131
|
## Responsive behavior
|
|
132
132
|
|
|
@@ -135,7 +135,7 @@ The panel caps itself to `100dvw`/`100dvh` so it can never overflow the viewport
|
|
|
135
135
|
edges from being dragged or resized outside the viewport. On narrow viewports the header
|
|
136
136
|
and body padding tighten below a `480px` breakpoint.
|
|
137
137
|
|
|
138
|
-
For the shared container and viewport rules, see [Foundations
|
|
138
|
+
For the shared container and viewport rules, see [Foundations - Responsive behavior](https://loomiui.com/foundations/#responsive-behavior).
|
|
139
139
|
|
|
140
140
|
## Dark mode
|
|
141
141
|
|
|
@@ -144,7 +144,7 @@ Uses semantic `--loomi-surface`, `--loomi-surface-border`, `--loomi-text`, and
|
|
|
144
144
|
`.dark` to your app root with `@loomidev/theme-switcher`, or provide your own token
|
|
145
145
|
overrides, and the panel inherits the dark-mode values through its shadow DOM.
|
|
146
146
|
|
|
147
|
-
For theme activation, token overrides, and contrast guidance, see [Foundations
|
|
147
|
+
For theme activation, token overrides, and contrast guidance, see [Foundations - Dark mode](https://loomiui.com/foundations/#dark-mode).
|
|
148
148
|
|
|
149
149
|
## Attributes
|
|
150
150
|
|
|
@@ -212,7 +212,7 @@ panel.addEventListener("loomi-maximize", (e) => console.log("maximized:", e.deta
|
|
|
212
212
|
min-height="180"
|
|
213
213
|
auto-save-id="support-chat"
|
|
214
214
|
>
|
|
215
|
-
<p>Drag me, resize me, reload the page
|
|
215
|
+
<p>Drag me, resize me, reload the page - I'll come back right here.</p>
|
|
216
216
|
</loomi-floating-panel>
|
|
217
217
|
```
|
|
218
218
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@loomidev/floating-panel",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.6.0",
|
|
4
4
|
"description": "<loomi-floating-panel> — a draggable, resizable panel that floats above the page.",
|
|
5
5
|
"repository": {
|
|
6
6
|
"type": "git",
|
|
@@ -30,8 +30,8 @@
|
|
|
30
30
|
}
|
|
31
31
|
},
|
|
32
32
|
"dependencies": {
|
|
33
|
-
"@loomidev/core": "^0.
|
|
34
|
-
"@loomidev/icon": "^0.
|
|
33
|
+
"@loomidev/core": "^0.6.0",
|
|
34
|
+
"@loomidev/icon": "^0.6.0"
|
|
35
35
|
},
|
|
36
36
|
"peerDependencies": {
|
|
37
37
|
"lit": "^3.0.0"
|
|
@@ -41,7 +41,7 @@
|
|
|
41
41
|
"lit": "^3.3.3",
|
|
42
42
|
"tailwindcss": "^4.3.3",
|
|
43
43
|
"typescript": "^5.6.3",
|
|
44
|
-
"@loomidev/theme": "^0.
|
|
44
|
+
"@loomidev/theme": "^0.6.0"
|
|
45
45
|
},
|
|
46
46
|
"keywords": [
|
|
47
47
|
"web-components",
|