Skip to content

Commit 93636fb

Browse files
kyerebodiekusakyereboahtabatkins
authored
[css-ui-4] add the window-drag text (#13801)
* Adds the draggable CSS property - adds `window-drag` to css-ui-4 * Adds window-drag - changes the computed value - updates line width styling * Updates css-ui-4 with `window-drag` Updates the spec text with the naming resolution by the CSSWG. #13102 * Adding note about `app-region` alias * Clarifying web event dispatch behavior and initial value * Simplifying `window-drag` description * Clarifying element's draggable target * Minor tweaks Co-authored-by: Tab Atkins Jr. <jackalmage@gmail.com> --------- Co-authored-by: diekus <73939538+diekus@users.noreply.github.com> Co-authored-by: Alexander Kyereboah <akyereboah@microsoft.com> Co-authored-by: Tab Atkins Jr. <jackalmage@gmail.com>
1 parent 3dfb0d9 commit 93636fb

1 file changed

Lines changed: 53 additions & 0 deletions

File tree

css-ui-4/Overview.bs

Lines changed: 53 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4153,6 +4153,59 @@ Single-Line Text Input Controls</h4>
41534153
* The content does not wrap
41544154
* The 'text-overflow' property applies regardless of the value of the 'overflow' property
41554155

4156+
<h2 id="window-interaction">
4157+
Window Interaction</h2>
4158+
4159+
<h3 id="window-drag">
4160+
Moving the window: the 'window-drag' property</h3>
4161+
4162+
<pre class=propdef>
4163+
Name: window-drag
4164+
Value: none | move
4165+
Initial: none
4166+
Applies to: all elements
4167+
Inherited: yes
4168+
Percentages: N/A
4169+
Computed value: as specified
4170+
Canonical order: per grammar
4171+
Animation type: discrete
4172+
</pre>
4173+
4174+
<wpt>
4175+
</wpt>
4176+
4177+
An installed application's window typically has a designated area where it can be dragged to move the window.
4178+
This area is generally at the top of the window
4179+
(usually part of the titlebar, toolbar, or both),
4180+
outside of the region that the page is actually rendered in.
4181+
For installed web apps,
4182+
APIs or capabilities like [[WINDOW-CONTROLS-OVERLAY]]
4183+
can alter and remove the surfaces where users can move a window.
4184+
The 'window-drag' property allows the author to specify an area <em>within</em> the page
4185+
where a user can drag to move the window.
4186+
Values have the following meanings:
4187+
4188+
<dl dfn-for=window-drag dfn-type=value>
4189+
<dt><dfn>none</dfn>
4190+
<dd>
4191+
Specifies that the element cannot be used as a drag area.
4192+
4193+
<dt><dfn>move</dfn>
4194+
<dd>
4195+
Specifies that the element's [=principal box=] can be used as a [=window drag area=].
4196+
</dl>
4197+
4198+
Note: Some UAs may support <css>app-region</css> as a [=legacy shorthand=] for 'window-drag'.
4199+
4200+
When a [=box=] is a <dfn export>window drag area</dfn>,
4201+
a drag gesture on that element initiates a window move operation
4202+
instead of normal web event processing.
4203+
The UA must not fire pointer events, mouse events, or drag events
4204+
on the element for the duration of the window move gesture.
4205+
4206+
Note: This means the [[HTML]] <{html-global/draggable}> attribute
4207+
has no effect on elements with ''window-drag: move'';
4208+
the window move behavior takes precedence.
41564209

41574210
<hr title="Separator from footer">
41584211

0 commit comments

Comments
 (0)