ობიექტი event

ობიექტი event გენერირდება მოვლენის დაწყების დროს და შეიცავს ინფორმაციას მასზე. მოვლენის გაჩენისას ობიექტი event გადაეცემა ფუნქცია-დამმუშავებელს.

ობიექტი event-ის თვისებები და მეთოდები

ქვემოთ მოცემულ ცხრილში მითითებულია ობიექტი event-ის თვისებები და მეთოდები და მათი აღწერა:

სახელი	აღწერა
`event.currentTarget`	მიმდინარე DOM ელემენტი მოვლენის ამოსვლის სტადიაზე. ჩვეულებრივ ეს თვისება ექვივალენტურია `this` ფუნქციის.
`event.data`	არასავალდებულო პარამეტრი. მონაცემთა ობიექტი, რომელიც გადაეცემა მოვლენის მეთოდს შესრულებადი დამმუშავებლის მიმაგრების დროს.
`event.delegateTarget`	ელემენტი, რომელსაც მიამაგრეს ახლახან გამოძახებული jQuery მოვლენის დამმუშავებელი. ეს თვისება ყველაზე გამოსადეგია დელეგირებულ მოვლენებში, როდესაც დამმუშავებელი მიბმულია დამუშავებადი ელემენტის წინაპარზე. არადელეგირებული დამმუშავებლებისთვის, რომლებიც უშუალოდ არის მიბმული ელემენტზე, მნიშვნელობა `event.delegateTarget` შეესაბამება მნიშვნელობას `event.currentTarget`.
`event.isDefaultPrevented`	მეთოდი ამოწმებს გამოიძახეს თუ არა მეთოდი `event.preventDefault` ამ მოვლენის ობიექტისთვის.
`event.isImmediatePropagationStopped`	მეთოდი ამოწმებს გამოიძახეს თუ არა მეთოდი `event.stopImmediatePropagation` ამ მოვლენის ობიექტისთვის.
`event.isPropagationStopped`	მეთოდი ამოწმებს გამოიძახეს თუ არა მეთოდი `event.stopPropagation` ამ მოვლენის ობიექტისთვის.
`event.isPropagationStopped`	მეთოდი ამოწმებს გამოიძახეს თუ არა მეთოდი `event.stopPropagation` ამ მოვლენის ობიექტისთვის.
`event.metaKey`	მეთოდი ამოწმებს დააწევინ თუ არა ღილაკი `META` მოვლენის დაწყების მომენტში. პლატფორმიდან გამომდინარე ღილაკი შეიძლება განსხვავდებოდეს. აბრუნებს `true` ან `false`.
`event.namespace`	სახელთა სივრცე, რომელიც მითითებული იყო მოვლენის გამოძახების დროს. ეს თვისება გამოგადგებათ პლაგინების ავტორებისთვის, რომელთა ამოცანები დამოკიდებულია გამოყენებულ სახელთა სივრცეზე.
`event.pageX`	აჩვენებს თაგვის პოზიციას დოკუმენტის მარცხენა კიდესთან მიმართებით.
`event.pageY`	აჩვენებს თაგვის პოზიციას დოკუმენტის ზედა კიდესთან მიმართებით.
`event.preventDefault`	თუ ეს მეთოდი გამოიძახება, მაშინ ქმედება ნაგულისხმევად ამ მოვლენისთვის არ შესრულდება. მაგალითად ბმულზე დაწკაპუნება არ გამოიწვევს გადასვლას ახალ URL-ზე. იმისთვის, რომ შეამოწმოთ გამოიძახეს თუ არა ეს მეთოდი, შეგიძლიათ გამოიყენოთ მეთოდი `event.isDefaultPrevented`.
`event.relatedTarget`	აბრუნებს სხვა DOM ელემენტს, რომელიც მონაწილეობს მოვლენაში, თუ ასეთი არსებობს. `mouseout`-ისთვის აჩვენებს რომელ ელემენტზეა თაგვი მიბმული, `mouseover`-ისთვის რომელი ელემენტიდან იქნა თაგვის კურსორი მოცილებული.
`event.result`	ბოლო მნიშვნელობა, რომელიც დააბრუნა დამმუშავებელმა მოხდენილი მოვლენის, არა ტოლი `undefined`-ის. თვისება შეიძლება იყოს გამოსადეგი საკუთარი მოვლენების მნიშვნელობების მისაღებად.
`event.stopImmediatePropagation`	აუქმებს ყველა დარჩენილი დამმუშავებლის მუშაობას მოვლენების, დაკავშირებული ელემენტთან და უშლის მოვლენის ამოსვლას ზემოთ DOM ხეში. იმისთვის, რომ უბრალოდ აეკრძალოს მოვლენას ამოსვლა წინაპარ ელემენტებამდე, მაგრამ ნება დართოს სხვა მოვლენების დამმუშავებლების მუშაობა, შეგიძლიათ გამოიყენოთ მეთოდი `event.stopPropagation`. გამოიყენეთ მეთოდი `event.isImmediatePropagationStopped`, რომ შეამოწმოთ გამოიძახეს თუ არა `event.stopImmediatePropagation` ამ მოვლენის ობიექტისთვის.
`event.stopPropagation`	შლის მოვლენის ამოსვლას ზემოთ DOM ხეში. გახსოვდეთ, რომ სხვა დამმუშავებლები გააგრძელებენ მუშაობას ამ ელემენტისთვის. ეს მეთოდი მუშაობს საკუთარი მოვლენებისთვის, გამოწვეული მეთოდით `trigger`. იმისთვის, რომ შეამოწმოთ გამოიძახეს თუ არა ეს მეთოდი, გამოიყენეთ `event.isPropagationStopped`.
`event.target`	DOM ელემენტი, რომელმაც დაიწყო მოვლენა. ეს შეიძლება იყოს ელემენტი რეგისტრირებული მოვლენისთვის ან მისი შთამომავალი. ძალიან გამოსადეგია შედარება `event.target` და `this`, მოვლენის ამოსვლის დასადგენად. თვისება გამოსადეგია მოვლენის დელეგირებისას, როდესაც მოვლენები ამოდის.
`event.timeStamp`	დროის სხვაობა მილიწამებში მოვლენის შექმნის მომენტებს შორის ბრაუზერის მიერ და 1 იანვარი, 1970 წელი. თვისება შეიძლება იყოს გამოსადეგი მოვლენის პროდუქტიულობის დასადგენად მნიშვნელობების სხვაობის მიღებით `event.timeStamp` ორი მომენტისთვის დროში კოდში. თუ თქვენ უბრალოდ გსურთ მიიღოთ მიმდინარე დრო დამმუშავებლის შიგნით მოვლენის, გამოიყენეთ მეთოდი `getTime`.
`event.type`	ამ თვისებაში მითითებულია მოვლენის ტიპი.
`event.which`	ეს თვისება მიუთითებს რომელი ღილაკი კლავიატურის ან თაგვის იყო დაწეული. თაგვისთვის: `1` - მარცხენა ღილაკი, `2` - ბორბალი, `3` - მარჯვენა ღილაკი. გამოიყენეთ `event.which` `event.button`-ის ნაცვლად.

ობიექტი event-ის სხვა თვისებები

არსებობს სხვა თვისებებიც, რომლებიც კოპირდება ობიექტში event:

altKey, button, buttons, cancelable, char, charCode, clientX, clientY, ctrlKey, detail, eventPhase, key, keyCode, offsetX, offsetY, originalTarget, screenX, screenY, shiftKey, toElement, view.

რომ მიიღოთ წვდომა თვისებებზე, რომლებიც არ არის ჩამოთვლილი ზემოთ, შეგიძლიათ გამოიყენოთ ობიექტი event.originalEvent.

მაგალითი

მოდით ვაჩვენოთ დივში - რომელი ღილაკები იყო დაწეული:

<input id="test" value="აკრიფეთ რამე">
<div id="text"></div>

$('#test').on('keydown', function(event) {
	$('#text').html(event.type + ": " +  event.which);
});

მაგალითი

მოდით ვაჩვენოთ დივში - რომელ ტეგზე ჩვენ დავაწკაპუნებთ:

<body>
	<div id="text"></div>
	<div>
		<p>
			<strong><span>დაწკაპუნება</span></strong>
		</p>
	</div>
</body>

span, strong, p {
	display: block;
	padding: 10px;
	border: 1px solid black;
}

$('body').click(function(event) {
	$('#text').html('დაწკაპუნებული: ' + event.target.nodeName);
});

იხილეთ აგრეთვე

მეთოდი on,
რომელიც საშუალებას აძლევს მიბაძოს მოვლენის დამმუშავებელი ელემენტს
მეთოდი trigger,
რომელიც საშუალებას აძლევს გაუშვას ყველა დამმუშავებელი მოვლენის, მიბმული ელემენტზე მოცემული ტიპის მოვლენებისთვის
მეთოდი triggerHandler,
რომელიც საშუალებას აძლევს გაუშვას ყველა დამმუშავებელი მოვლენის, მიბმული ელემენტზე
jQuery მოვლენები