/
index.md
128 lines (89 loc) · 3.98 KB
/
index.md
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
127
128
---
title: "HTMLElement: dragenter イベント"
slug: Web/API/HTMLElement/dragenter_event
l10n:
sourceCommit: a3d9f61a8990ba7b53bda9748d1f26a9e9810b18
---
{{APIRef}}
`dragenter` イベントは、ドラッグ中のイベントやテキストの選択範囲が、妥当なドロップターゲットに入ったときに発生します。
ターゲットのオブジェクトは*ユーザーによる直接の選択範囲*(ドロップターゲットとしてユーザーによって直接示された要素)、または {{HTMLElement("body")}} 要素です。
## 構文
このイベント名を {{domxref("EventTarget.addEventListener", "addEventListener()")}} のようなメソッドで使用するか、イベントハンドラープロパティを設定するかします。
```js
addEventListener("dragenter", (event) => {});
ondragenter = (event) => {};
```
## イベント型
{{domxref("DragEvent")}} です。 {{domxref("Event")}} を継承しています。
{{InheritanceDiagram("DragEvent")}}
## イベントプロパティ
_以下に挙げたプロパティに加えて、親である {{domxref("Event")}} から継承したプロパティもあります。_
- {{domxref('DragEvent.dataTransfer')}} {{ReadOnlyInline}}
- : ドラッグ&ドロップ操作の間に転送されるデータです。
## 例
### dragenter のドロップゾーンのスタイル付け
この例では、コンテナーの中にドラッグ可能な要素を入れています。この要素を掴んで、他のコンテナーの上にドラッグし、そして放してみましょう。
ドラッグ可能な要素がコンテナーの上にある間、 `dragenter` イベントを待ち受けて、他のコンテナーの背景を紫色にし、ドラッグ可能な要素がコンテナーにドロップされることを知らせます。
ドラッグ&ドロップの完全な例については、[`drag`](/ja/docs/Web/API/HTMLElement/drag_event) イベントのページを参照してください。
#### HTML
```html
<div class="dropzone">
<div id="draggable" draggable="true">この div はドラッグ可</div>
</div>
<div class="dropzone" id="droptarget"></div>
```
#### CSS
```css
body {
/* 例でユーザーがテキストを選択するのを防ぐ */
user-select: none;
}
#draggable {
text-align: center;
background: white;
}
.dropzone {
width: 200px;
height: 20px;
background: blueviolet;
margin: 10px;
padding: 10px;
}
.dropzone.dragover {
background-color: purple;
}
```
#### JavaScript
```js
const target = document.getElementById("droptarget");
target.addEventListener("dragenter", (event) => {
// ドラッグ可能な要素がドロップ先に入ったときに、ドロップ先の候補を強調表示する
if (event.target.classList.contains("dropzone")) {
event.target.classList.add("dragover");
}
});
target.addEventListener("dragleave", (event) => {
// ドラッグ可能な要素がドロップ先から離れたときに、ドロップ先の候補の背景をリセットする
if (event.target.classList.contains("dropzone")) {
event.target.classList.remove("dragover");
}
});
```
#### 結果
{{EmbedLiveSample('Styling drop zones on dragenter')}}
## 仕様書
{{Specifications}}
## ブラウザーの互換性
{{Compat}}
## 関連情報
- その他のドラッグ&ドロップイベント:
- {{domxref("HTMLElement/drag_event", "drag")}}
- {{domxref("HTMLElement/dragstart_event", "dragstart")}}
- {{domxref("HTMLElement/dragend_event", "dragend")}}
- {{domxref("HTMLElement/dragover_event", "dragover")}}
- {{domxref("HTMLElement/dragleave_event", "dragleave")}}
- {{domxref("HTMLElement/drop_event", "drop")}}
- 他を対象としたこのイベント:
- {{domxref("Window")}}: {{domxref("Window/dragenter_event", "dragenter")}} イベント
- {{domxref("Document")}}: {{domxref("Document/dragenter_event", "dragenter")}} イベント
- {{domxref("SVGElement")}}: {{domxref("SVGElement/dragenter_event", "dragenter")}} イベント