demos/draggable/snap-to.html


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68

<!DOCTYPE html>
<html lang="en">
<head>
	<meta charset="utf-8">
	<title>jQuery UI Draggable - Snap to element or grid</title>
	<link rel="stylesheet" href="../../themes/base/jquery.ui.all.css">
	<script src="../../jquery-1.7.2.js"></script>
	<script src="../../ui/jquery.ui.core.js"></script>
	<script src="../../ui/jquery.ui.widget.js"></script>
	<script src="../../ui/jquery.ui.mouse.js"></script>
	<script src="../../ui/jquery.ui.draggable.js"></script>
	<link rel="stylesheet" href="../demos.css">
	<style>
	.draggable { width: 90px; height: 80px; padding: 5px; float: left; margin: 0 10px 10px 0; font-size: .9em; }
	.ui-widget-header p, .ui-widget-content p { margin: 0; }
	#snaptarget { height: 140px; }
	</style>
	<script>
	$(function() {
		$( "#draggable" ).draggable({ snap: true });
		$( "#draggable2" ).draggable({ snap: ".ui-widget-header" });
		$( "#draggable3" ).draggable({ snap: ".ui-widget-header", snapMode: "outer" });
		$( "#draggable4" ).draggable({ grid: [ 20,20 ] });
		$( "#draggable5" ).draggable({ grid: [ 80, 80 ] });
	});
	</script>
</head>
<body>

<div class="demo">

<div id="snaptarget" class="ui-widget-header">
	<p>I'm a snap target</p>
</div>

<br style="clear:both" />

<div id="draggable" class="draggable ui-widget-content">
	<p>Default (snap: true), snaps to all other draggable elements</p>
</div>

<div id="draggable2" class="draggable ui-widget-content">
	<p>I only snap to the big box</p>
</div>

<div id="draggable3" class="draggable ui-widget-content">
	<p>I only snap to the outer edges of the big box</p>
</div>

<div id="draggable4" class="draggable ui-widget-content">
	<p>I snap to a 20 x 20 grid</p>
</div>

<div id="draggable5" class="draggable ui-widget-content">
	<p>I snap to a 80 x 80 grid</p>
</div>

</div><!-- End demo -->


<div class="demo-description">
<p>Snap the draggable to the inner or outer boundaries of a DOM element.  Use the <code>snap</code>, <code>snapMode</code> (inner, outer, both), and <code>snapTolerance</code> (distance in pixels the draggable must be from the element when snapping is invoked) options. </p>
<p>Or snap the draggable to a grid.  Set the dimensions of grid cells (height and width in pixels) with the <code>grid</code> option.</p>
</div><!-- End demo-description -->

</body>
</html>

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126

<?php

/**
 * SPDX-FileCopyrightText: 2016-2024 Nextcloud GmbH and Nextcloud contributors
 * SPDX-FileCopyrightText: 2016 ownCloud, Inc.
 * SPDX-License-Identifier: AGPL-3.0-only
 */
namespace OCP;

/**
 * Interface IDateTimeFormatter
 *
 * @since 8.0.0
 */
interface IDateTimeFormatter {
	/**
	 * Formats the date of the given timestamp
	 *
	 * @param int|\DateTime $timestamp
	 * @param string $format Either 'full', 'long', 'medium' or 'short'
	 *                       full:	e.g. 'EEEE, MMMM d, y'	=> 'Wednesday, August 20, 2014'
	 *                       long:	e.g. 'MMMM d, y'		=> 'August 20, 2014'
	 *                       medium:	e.g. 'MMM d, y'			=> 'Aug 20, 2014'
	 *                       short:	e.g. 'M/d/yy'			=> '8/20/14'
	 *                       The exact format is dependent on the language
	 * @param \DateTimeZone|null $timeZone The timezone to use
	 * @param \OCP\IL10N|null $l The locale to use
	 * @return string Formatted date string
	 * @since 8.0.0
	 */
	public function formatDate($timestamp, $format = 'long', ?\DateTimeZone $timeZone = null, ?\OCP\IL10N $l = null);

	/**
	 * Formats the date of the given timestamp
	 *
	 * @param int|\DateTime $timestamp
	 * @param string $format Either 'full', 'long', 'medium' or 'short'
	 *                       full:	e.g. 'EEEE, MMMM d, y'	=> 'Wednesday, August 20, 2014'
	 *                       long:	e.g. 'MMMM d, y'		=> 'August 20, 2014'
	 *                       medium:	e.g. 'MMM d, y'			=> 'Aug 20, 2014'
	 *                       short:	e.g. 'M/d/yy'			=> '8/20/14'
	 *                       The exact format is dependent on the language
	 *                       Uses 'Today', 'Yesterday' and 'Tomorrow' when applicable
	 * @param \DateTimeZone|null $timeZone The timezone to use
	 * @param \OCP\IL10N|null $l The locale to use
	 * @return string Formatted relative date string
	 * @since 8.0.0
	 */
	public function formatDateRelativeDay($timestamp, $format = 'long', ?\DateTimeZone $timeZone = null, ?\OCP\IL10N $l = null);

	/**
	 * Gives the relative date of the timestamp
	 * Only works for past dates
	 *
	 * @param int|\DateTime $timestamp
	 * @param int|\DateTime|null $baseTimestamp Timestamp to compare $timestamp against, defaults to current time
	 * @param \OCP\IL10N|null $l The locale to use
	 * @return string Dates returned are:
	 *                <  1 month	=> Today, Yesterday, n days ago
	 *                < 13 month	=> last month, n months ago
	 *                >= 13 month	=> last year, n years ago
	 * @since 8.0.0
	 */
	public function formatDateSpan($timestamp, $baseTimestamp = null, ?\OCP\IL10N $l = null);

	/**
	 * Formats the time of the given timestamp
	 *
	 * @param int|\DateTime $timestamp
	 * @param string $format Either 'full', 'long', 'medium' or 'short'
	 *                       full:	e.g. 'h:mm:ss a zzzz'	=> '11:42:13 AM GMT+0:00'
	 *                       long:	e.g. 'h:mm:ss a z'		=> '11:42:13 AM GMT'
	 *                       medium:	e.g. 'h:mm:ss a'		=> '11:42:13 AM'
	 *                       short:	e.g. 'h:mm a'			=> '11:42 AM'
	 *                       The exact format is dependent on the language
	 * @param \DateTimeZone|null $timeZone The timezone to use
	 * @param \OCP\IL10N|null $l The locale to use
	 * @return string Formatted time string
	 * @since 8.0.0
	 */
	public function formatTime($timestamp, $format = 'medium', ?\DateTimeZone $timeZone = null, ?\OCP\IL10N $l = null);

	/**
	 * Gives the relative past time of the timestamp
	 *
	 * @param int|\DateTime $timestamp
	 * @param int|\DateTime|null $baseTimestamp Timestamp to compare $timestamp against, defaults to current time
	 * @param \OCP\IL10N|null $l The locale to use
	 * @return string Dates returned are:
	 *                < 60 sec	=> seconds ago
	 *                <  1 hour	=> n minutes ago
	 *                <  1 day	=> n hours ago
	 *                <  1 month	=> Yesterday, n days ago
	 *                < 13 month	=> last month, n months ago
	 *                >= 13 month	=> last year, n years ago
	 * @since 8.0.0
	 */
	public function formatTimeSpan($timestamp, $baseTimestamp = null, ?\OCP\IL10N $l = null);

	/**
	 * Formats the date and time of the given timestamp
	 *
	 * @param int|\DateTime $timestamp
	 * @param string $formatDate See formatDate() for description
	 * @param string $formatTime See formatTime() for description
	 * @param \DateTimeZone|null $timeZone The timezone to use
	 * @param \OCP\IL10N|null $l The locale to use
	 * @return string Formatted date and time string
	 * @since 8.0.0
	 */
	public function formatDateTime($timestamp, $formatDate = 'long', $formatTime = 'medium', ?\DateTimeZone $timeZone = null, ?\OCP\IL10N $l = null);

	/**
	 * Formats the date and time of the given timestamp
	 *
	 * @param int|\DateTime $timestamp
	 * @param string $formatDate See formatDate() for description
	 *                           Uses 'Today', 'Yesterday' and 'Tomorrow' when applicable
	 * @param string $formatTime See formatTime() for description
	 * @param \DateTimeZone|null $timeZone The timezone to use
	 * @param \OCP\IL10N|null $l The locale to use
	 * @return string Formatted relative date and time string
	 * @since 8.0.0
	 */
	public function formatDateTimeRelativeDay($timestamp, $formatDate = 'long', $formatTime = 'medium', ?\DateTimeZone $timeZone = null, ?\OCP\IL10N $l = null);
}