pantoken / formats/interactions/src / CommandEventish

رابط: CommandEventish ​

شکل command/source یک CommandEvent دستورات Invoker (هنوز در انواع کتابخانه DOM نیست).

گسترش می‌دهد ​

  • Event

خصوصیات ​

command ​

command: string

source ​

source: Element | null

bubbles ​

readonly bubbles: boolean

خصوصیت فقط‌خواندنی bubbles در رابط Event نشان می‌دهد که آیا رویداد درخت DOM را به سمت بالا حبابی می‌شود یا خیر.

MDN Reference

ارث‌بری از ​

Event.bubbles

cancelBubble ​

cancelBubble: boolean

خصوصیت cancelBubble از رابط Event منسوخ شده است. به‌جای آن از Event.stopPropagation() استفاده کنید. تنظیم این مقدار روی true پیش از بازگشت از هندلر رویداد، از انتشار رویداد جلوگیری می‌کند. در پیاده‌سازی‌های جدیدتر، تنظیم آن روی false هیچ تاثیری ندارد. برای جزئیات سازگاری مرورگرها را ببینید.

منسوخ ​

MDN Reference

ارث‌بری از ​

Event.cancelBubble

cancelable ​

readonly cancelable: boolean

خصوصیت فقط‌خواندنی cancelable در رابط Event نشان می‌دهد که آیا رویداد قابل لغو است و بنابراین می‌توان آن را طوری جلوگیری کرد که انگار هرگز اتفاق نیفتاده است.

MDN Reference

ارث‌بری از ​

Event.cancelable

composed ​

readonly composed: boolean

خصوصیت فقط‌خواندنی composed از رابط Event مقدار بولی‌ای برمی‌گرداند که نشان می‌دهد آیا رویداد از مرز shadow DOM به DOM استاندارد منتشر می‌شود یا نه.

MDN Reference

ارث‌بری از ​

Event.composed

currentTarget ​

readonly currentTarget: EventTarget | null

خصوصیت فقط‌خواندنی currentTarget در رابط Event عنصری را که هندلر رویداد به آن پیوست شده شناسایی می‌کند.

MDN Reference

ارث‌بری از ​

CommandEventish.currentTarget

defaultPrevented ​

readonly defaultPrevented: boolean

خصوصیت فقط‌خواندنی defaultPrevented در رابط Event مقدار بولی‌ای برمی‌گرداند که نشان می‌دهد آیا فراخوانی Event.preventDefault() رویداد را لغو کرده است یا خیر.

MDN Reference

ارث‌بری از ​

Event.defaultPrevented

eventPhase ​

readonly eventPhase: number

خصوصیت فقط‌خواندنی eventPhase در رابط Event نشان می‌دهد که در حال حاضر کدام فاز جریان رویداد در حال ارزیابی است.

MDN Reference

ارث‌بری از ​

Event.eventPhase

isTrusted ​

readonly isTrusted: boolean

خصوصیت فقط‌خواندنی isTrusted در رابط Event یک مقدار بولی است که زمانی true است که رویداد توسط عامل کاربر تولید شده باشد (شامل اقدامات کاربر و روش‌های برنامه‌ای مانند HTMLElement.focus())، و false زمانی است که رویداد از طریق EventTarget.dispatchEvent() ارسال شده باشد. تنها استثنا رویداد click است که در عامل‌های کاربر مقدار isTrusted را به false مقداردهی اولیه می‌کند.

MDN Reference

ارث‌بری از ​

Event.isTrusted

returnValue ​

returnValue: boolean

خصوصیت Event با نام returnValue نشان می‌دهد که آیا اقدام پیش‌فرض برای این رویداد جلوگیری شده است یا خیر.

منسوخ ​

MDN Reference

ارث‌بری از ​

Event.returnValue

srcElement ​

readonly srcElement: EventTarget | null

مخدوش‌شده Event.srcElement معادلِ مستعارِ Event.target است. به‌جای آن از Event.target استفاده کنید.

منسوخ ​

MDN Reference

ارث‌بری از ​

CommandEventish.srcElement

target ​

readonly target: EventTarget | null

خصوصیت فقط‌خواندنی target در رابط Event مرجعی به شیئی است که رویداد روی آن ارسال شده است. این در زمانی که هندلر رویداد در فاز حبابی یا ضبطی فراخوانی می‌شود با Event.currentTarget متفاوت است.

MDN Reference

ارث‌بری از ​

CommandEventish.target

timeStamp ​

readonly timeStamp: number

خصوصیت فقط‌خواندنی timeStamp در رابط Event زمان (برحسب میلی‌ثانیه) ایجاد رویداد را برمی‌گرداند.

MDN Reference

ارث‌بری از ​

Event.timeStamp

type ​

readonly type: string

خصوصیت فقط‌خواندنی type در رابط Event رشته‌ای حاوی نوع رویداد را برمی‌گرداند. این مقدار هنگام ساخت رویداد تعیین می‌شود و نامی است که معمولاً برای اشاره به رویداد خاص استفاده می‌شود، مانند click، load، یا error.

MDN Reference

ارث‌بری از ​

Event.type

NONE ​

readonly NONE: 0

ارث‌بری از ​

Event.NONE

CAPTURING_PHASE ​

readonly CAPTURING_PHASE: 1

ارث‌بری از ​

Event.CAPTURING_PHASE

AT_TARGET ​

readonly AT_TARGET: 2

ارث‌بری از ​

Event.AT_TARGET

BUBBLING_PHASE ​

readonly BUBBLING_PHASE: 3

ارث‌بری از ​

Event.BUBBLING_PHASE

متدها ​

composedPath() ​

composedPath(): EventTarget[]

متد composedPath() از رابط Event مسیر رویداد را برمی‌گرداند که آرایه‌ای از اشیائی است که روی آن‌ها لیسنرها فراخوانی می‌شوند. این شامل گره‌ها در درخت‌های shadow نمی‌شود اگر ریشهٔ shadow با ShadowRoot.mode بسته ایجاد شده باشد.

MDN Reference

مقدار بازگشتی ​

EventTarget[]

ارث‌بری از ​

Event.composedPath

initEvent() ​

initEvent(type, bubbles?, cancelable?): void

متد Event.initEvent() برای مقداردهی اولیهٔ یک رویداد ایجادشده با استفاده از Document.createEvent() استفاده می‌شود.

پارامترها ​

type ​

string

bubbles? ​

boolean

cancelable? ​

boolean

مقدار بازگشتی ​

void

منسوخ ​

MDN Reference

ارث‌بری از ​

Event.initEvent

preventDefault() ​

preventDefault(): void

متد preventDefault() از رابط Event به عامل کاربر اعلام می‌کند که رویداد به‌طور صریح توسط کاربر هندل می‌شود، پس اقدام پیش‌فرض آن، مانند اسکرول صفحه، هدایت لینک، یا چسباندن متن، نباید انجام شود.

MDN Reference

مقدار بازگشتی ​

void

ارث‌بری از ​

Event.preventDefault

stopImmediatePropagation() ​

stopImmediatePropagation(): void

متد stopImmediatePropagation() از رابط Event از فراخوانی سایر لیسنرهای همان رویداد جلوگیری می‌کند.

MDN Reference

مقدار بازگشتی ​

void

ارث‌بری از ​

Event.stopImmediatePropagation

stopPropagation() ​

stopPropagation(): void

متد stopPropagation() از رابط Event از انتشار بیشتر رویداد جاری در فازهای ضبط و حبابی جلوگیری می‌کند. اما این روش مانع رخ دادن رفتارهای پیش‌فرض نمی‌شود؛ برای مثال، کلیک روی لینک‌ها همچنان پردازش می‌شود. اگر می‌خواهید آن رفتارها را متوقف کنید، متد preventDefault() را ببینید. همچنین این روش مانع انتشار به دیگر هندلرهای رویداد روی عنصر جاری نمی‌شود. اگر می‌خواهید آن‌ها را متوقف کنید، stopImmediatePropagation() را ببینید.

MDN Reference

مقدار بازگشتی ​

void

ارث‌بری از ​

Event.stopPropagation