База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / HTML

ondragstart — обработване на началото на плъзгането

Атрибутът ondragstart задава JavaScript код, който се изпълнява при събитието dragstart в началото на плъзгането. С него могат да се подготвят данните за операцията или да се отмени започването ѝ; сам по себе си той не прави елемента плъзгаем.

Версия: WHATWG HTML Living Standard; index snapshot date recorded separately

Синтаксис

ondragstart="JavaScript statements"

ondragstart е атрибут за обработване на събития, наличен за HTML елементите. Стойността му е JavaScript код, а не булева стойност. Той обработва dragstart в началото на операцията по плъзгане, а не при всяко движение на показалеца.

В кода на атрибута event обозначава обекта DragEvent. По време на нативно събитие dragstart хранилището за данни на плъзгането може да се чете и записва: event.dataTransfer.setData('text/plain', 'Hello') задава прехвърляния текст. Извикването на event.preventDefault() или изпълнението на return false в този обработчик отменя започването на плъзгането.

ondragstart самостоятелно не разрешава плъзгането. За обикновен изходен елемент може да се зададе draggable="true". ondragstart е и името на JavaScript свойство, което приема функция; при addEventListener името на събитието е dragstart, без префикса on.

Примерът умишлено отменя операцията след промяна на съобщението за състоянието. Той показва обработване на началото на плъзгането, а не цялостна реализация на пускането.

Примери

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>ondragstart example</title>
<p draggable="true"
   ondragstart="document.getElementById('status').textContent = 'dragstart: canceled'; event.preventDefault();">
  Drag this text.
</p>
<p id="status" role="status">Ready</p>
</html>

Резултат

dragstart: canceled

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници