版博士V2.0程序
Nie możesz wybrać więcej, niż 25 tematów Tematy muszą się zaczynać od litery lub cyfry, mogą zawierać myślniki ('-') i mogą mieć do 35 znaków.

Document.d.ts 16 KiB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544
  1. import IWindow from '../../window/IWindow';
  2. import Node from '../node/Node';
  3. import TreeWalker from '../../tree-walker/TreeWalker';
  4. import Event from '../../event/Event';
  5. import DOMImplementation from '../../dom-implementation/DOMImplementation';
  6. import INodeFilter from '../../tree-walker/INodeFilter';
  7. import IDocument from './IDocument';
  8. import CSSStyleSheet from '../../css/CSSStyleSheet';
  9. import CookieJar from '../../cookie/CookieJar';
  10. import IElement from '../element/IElement';
  11. import IHTMLScriptElement from '../html-script-element/IHTMLScriptElement';
  12. import IHTMLElement from '../html-element/IHTMLElement';
  13. import IDocumentType from '../document-type/IDocumentType';
  14. import INode from '../node/INode';
  15. import IComment from '../comment/IComment';
  16. import IText from '../text/IText';
  17. import IDocumentFragment from '../document-fragment/IDocumentFragment';
  18. import INodeList from '../node/INodeList';
  19. import IHTMLCollection from '../element/IHTMLCollection';
  20. import DocumentReadyStateEnum from './DocumentReadyStateEnum';
  21. import DocumentReadyStateManager from './DocumentReadyStateManager';
  22. import Location from '../../location/Location';
  23. import Selection from '../../selection/Selection';
  24. import Range from '../../range/Range';
  25. import IAttr from '../attr/IAttr';
  26. import IProcessingInstruction from '../processing-instruction/IProcessingInstruction';
  27. import VisibilityStateEnum from './VisibilityStateEnum';
  28. /**
  29. * Document.
  30. */
  31. export default class Document extends Node implements IDocument {
  32. static _defaultView: IWindow;
  33. nodeType: import("../node/NodeTypeEnum").default;
  34. adoptedStyleSheets: CSSStyleSheet[];
  35. implementation: DOMImplementation;
  36. readonly children: IHTMLCollection<IElement>;
  37. readonly readyState = DocumentReadyStateEnum.interactive;
  38. readonly isConnected: boolean;
  39. readonly defaultView: IWindow;
  40. readonly _readyStateManager: DocumentReadyStateManager;
  41. _activeElement: IHTMLElement;
  42. _cacheID: number;
  43. _cookie: CookieJar;
  44. protected _isFirstWrite: boolean;
  45. protected _isFirstWriteAfterOpen: boolean;
  46. private _selection;
  47. onreadystatechange: (event: Event) => void;
  48. onpointerlockchange: (event: Event) => void;
  49. onpointerlockerror: (event: Event) => void;
  50. onbeforecopy: (event: Event) => void;
  51. onbeforecut: (event: Event) => void;
  52. onbeforepaste: (event: Event) => void;
  53. onfreeze: (event: Event) => void;
  54. onresume: (event: Event) => void;
  55. onsearch: (event: Event) => void;
  56. onvisibilitychange: (event: Event) => void;
  57. onfullscreenchange: (event: Event) => void;
  58. onfullscreenerror: (event: Event) => void;
  59. onwebkitfullscreenchange: (event: Event) => void;
  60. onwebkitfullscreenerror: (event: Event) => void;
  61. onbeforexrselect: (event: Event) => void;
  62. onabort: (event: Event) => void;
  63. onbeforeinput: (event: Event) => void;
  64. onblur: (event: Event) => void;
  65. oncancel: (event: Event) => void;
  66. oncanplay: (event: Event) => void;
  67. oncanplaythrough: (event: Event) => void;
  68. onchange: (event: Event) => void;
  69. onclick: (event: Event) => void;
  70. onclose: (event: Event) => void;
  71. oncontextlost: (event: Event) => void;
  72. oncontextmenu: (event: Event) => void;
  73. oncontextrestored: (event: Event) => void;
  74. oncuechange: (event: Event) => void;
  75. ondblclick: (event: Event) => void;
  76. ondrag: (event: Event) => void;
  77. ondragend: (event: Event) => void;
  78. ondragenter: (event: Event) => void;
  79. ondragleave: (event: Event) => void;
  80. ondragover: (event: Event) => void;
  81. ondragstart: (event: Event) => void;
  82. ondrop: (event: Event) => void;
  83. ondurationchange: (event: Event) => void;
  84. onemptied: (event: Event) => void;
  85. onended: (event: Event) => void;
  86. onerror: (event: Event) => void;
  87. onfocus: (event: Event) => void;
  88. onformdata: (event: Event) => void;
  89. oninput: (event: Event) => void;
  90. oninvalid: (event: Event) => void;
  91. onkeydown: (event: Event) => void;
  92. onkeypress: (event: Event) => void;
  93. onkeyup: (event: Event) => void;
  94. onload: (event: Event) => void;
  95. onloadeddata: (event: Event) => void;
  96. onloadedmetadata: (event: Event) => void;
  97. onloadstart: (event: Event) => void;
  98. onmousedown: (event: Event) => void;
  99. onmouseenter: (event: Event) => void;
  100. onmouseleave: (event: Event) => void;
  101. onmousemove: (event: Event) => void;
  102. onmouseout: (event: Event) => void;
  103. onmouseover: (event: Event) => void;
  104. onmouseup: (event: Event) => void;
  105. onmousewheel: (event: Event) => void;
  106. onpause: (event: Event) => void;
  107. onplay: (event: Event) => void;
  108. onplaying: (event: Event) => void;
  109. onprogress: (event: Event) => void;
  110. onratechange: (event: Event) => void;
  111. onreset: (event: Event) => void;
  112. onresize: (event: Event) => void;
  113. onscroll: (event: Event) => void;
  114. onsecuritypolicyviolation: (event: Event) => void;
  115. onseeked: (event: Event) => void;
  116. onseeking: (event: Event) => void;
  117. onselect: (event: Event) => void;
  118. onslotchange: (event: Event) => void;
  119. onstalled: (event: Event) => void;
  120. onsubmit: (event: Event) => void;
  121. onsuspend: (event: Event) => void;
  122. ontimeupdate: (event: Event) => void;
  123. ontoggle: (event: Event) => void;
  124. onvolumechange: (event: Event) => void;
  125. onwaiting: (event: Event) => void;
  126. onwebkitanimationend: (event: Event) => void;
  127. onwebkitanimationiteration: (event: Event) => void;
  128. onwebkitanimationstart: (event: Event) => void;
  129. onwebkittransitionend: (event: Event) => void;
  130. onwheel: (event: Event) => void;
  131. onauxclick: (event: Event) => void;
  132. ongotpointercapture: (event: Event) => void;
  133. onlostpointercapture: (event: Event) => void;
  134. onpointerdown: (event: Event) => void;
  135. onpointermove: (event: Event) => void;
  136. onpointerrawupdate: (event: Event) => void;
  137. onpointerup: (event: Event) => void;
  138. onpointercancel: (event: Event) => void;
  139. onpointerover: (event: Event) => void;
  140. onpointerout: (event: Event) => void;
  141. onpointerenter: (event: Event) => void;
  142. onpointerleave: (event: Event) => void;
  143. onselectstart: (event: Event) => void;
  144. onselectionchange: (event: Event) => void;
  145. onanimationend: (event: Event) => void;
  146. onanimationiteration: (event: Event) => void;
  147. onanimationstart: (event: Event) => void;
  148. ontransitionrun: (event: Event) => void;
  149. ontransitionstart: (event: Event) => void;
  150. ontransitionend: (event: Event) => void;
  151. ontransitioncancel: (event: Event) => void;
  152. oncopy: (event: Event) => void;
  153. oncut: (event: Event) => void;
  154. onpaste: (event: Event) => void;
  155. onbeforematch: (event: Event) => void;
  156. /**
  157. * Creates an instance of Document.
  158. *
  159. */
  160. constructor();
  161. /**
  162. * Returns character set.
  163. *
  164. * @deprecated
  165. * @returns Character set.
  166. */
  167. get charset(): string;
  168. /**
  169. * Returns character set.
  170. *
  171. * @returns Character set.
  172. */
  173. get characterSet(): string;
  174. /**
  175. * Returns title.
  176. *
  177. * @returns Title.
  178. */
  179. get title(): string;
  180. /**
  181. * Returns set title.
  182. *
  183. */
  184. set title(title: string);
  185. /**
  186. * Last element child.
  187. *
  188. * @returns Element.
  189. */
  190. get childElementCount(): number;
  191. /**
  192. * First element child.
  193. *
  194. * @returns Element.
  195. */
  196. get firstElementChild(): IElement;
  197. /**
  198. * Last element child.
  199. *
  200. * @returns Element.
  201. */
  202. get lastElementChild(): IElement;
  203. /**
  204. * Returns cookie string.
  205. *
  206. * @returns Cookie.
  207. */
  208. get cookie(): string;
  209. /**
  210. * Sets a cookie string.
  211. *
  212. * @param cookie Cookie string.
  213. */
  214. set cookie(cookie: string);
  215. /**
  216. * Node name.
  217. *
  218. * @returns Node name.
  219. */
  220. get nodeName(): string;
  221. /**
  222. * Returns <html> element.
  223. *
  224. * @returns Element.
  225. */
  226. get documentElement(): IHTMLElement;
  227. /**
  228. * Returns document type element.
  229. *
  230. * @returns Document type.
  231. */
  232. get doctype(): IDocumentType;
  233. /**
  234. * Returns <body> element.
  235. *
  236. * @returns Element.
  237. */
  238. get body(): IHTMLElement;
  239. /**
  240. * Returns <head> element.
  241. *
  242. * @returns Element.
  243. */
  244. get head(): IHTMLElement;
  245. /**
  246. * Returns CSS style sheets.
  247. *
  248. * @returns CSS style sheets.
  249. */
  250. get styleSheets(): CSSStyleSheet[];
  251. /**
  252. * Returns active element.
  253. *
  254. * @returns Active element.
  255. */
  256. get activeElement(): IHTMLElement;
  257. /**
  258. * Returns scrolling element.
  259. *
  260. * @returns Scrolling element.
  261. */
  262. get scrollingElement(): IHTMLElement;
  263. /**
  264. * Returns location.
  265. *
  266. * @returns Location.
  267. */
  268. get location(): Location;
  269. /**
  270. * Returns scripts.
  271. *
  272. * @returns Scripts.
  273. */
  274. get scripts(): IHTMLCollection<IHTMLScriptElement>;
  275. /**
  276. * Returns base URI.
  277. *
  278. * @override
  279. * @returns Base URI.
  280. */
  281. get baseURI(): string;
  282. /**
  283. * Returns URL.
  284. *
  285. * @returns the URL of the current document.
  286. * */
  287. get URL(): string;
  288. /**
  289. * Returns document URI.
  290. *
  291. * @returns the URL of the current document.
  292. * */
  293. get documentURI(): string;
  294. /**
  295. * Returns document visibility state.
  296. *
  297. * @returns the visibility state of the current document.
  298. * */
  299. get visibilityState(): VisibilityStateEnum;
  300. /**
  301. * Returns document hidden state.
  302. *
  303. * @returns the hidden state of the current document.
  304. * */
  305. get hidden(): boolean;
  306. /**
  307. * Inserts a set of Node objects or DOMString objects after the last child of the ParentNode. DOMString objects are inserted as equivalent Text nodes.
  308. *
  309. * @param nodes List of Node or DOMString.
  310. */
  311. append(...nodes: (INode | string)[]): void;
  312. /**
  313. * Inserts a set of Node objects or DOMString objects before the first child of the ParentNode. DOMString objects are inserted as equivalent Text nodes.
  314. *
  315. * @param nodes List of Node or DOMString.
  316. */
  317. prepend(...nodes: (INode | string)[]): void;
  318. /**
  319. * Replaces the existing children of a node with a specified new set of children.
  320. *
  321. * @param nodes List of Node or DOMString.
  322. */
  323. replaceChildren(...nodes: (INode | string)[]): void;
  324. /**
  325. * Query CSS selector to find matching elments.
  326. *
  327. * @param selector CSS selector.
  328. * @returns Matching elements.
  329. */
  330. querySelectorAll(selector: string): INodeList<IElement>;
  331. /**
  332. * Query CSS Selector to find a matching element.
  333. *
  334. * @param selector CSS selector.
  335. * @returns Matching element.
  336. */
  337. querySelector(selector: string): IElement;
  338. /**
  339. * Returns an elements by class name.
  340. *
  341. * @param className Tag name.
  342. * @returns Matching element.
  343. */
  344. getElementsByClassName(className: string): IHTMLCollection<IElement>;
  345. /**
  346. * Returns an elements by tag name.
  347. *
  348. * @param tagName Tag name.
  349. * @returns Matching element.
  350. */
  351. getElementsByTagName(tagName: string): IHTMLCollection<IElement>;
  352. /**
  353. * Returns an elements by tag name and namespace.
  354. *
  355. * @param namespaceURI Namespace URI.
  356. * @param tagName Tag name.
  357. * @returns Matching element.
  358. */
  359. getElementsByTagNameNS(namespaceURI: string, tagName: string): IHTMLCollection<IElement>;
  360. /**
  361. * Returns an element by ID.
  362. *
  363. * @param id ID.
  364. * @returns Matching element.
  365. */
  366. getElementById(id: string): IElement;
  367. /**
  368. * Returns an element by Name.
  369. *
  370. * @returns Matching element.
  371. * @param name
  372. */
  373. getElementsByName(name: string): INodeList<IElement>;
  374. /**
  375. * Clones a node.
  376. *
  377. * @override
  378. * @param [deep=false] "true" to clone deep.
  379. * @returns Cloned node.
  380. */
  381. cloneNode(deep?: boolean): IDocument;
  382. /**
  383. * Append a child node to childNodes.
  384. *
  385. * @override
  386. * @param node Node to append.
  387. * @returns Appended node.
  388. */
  389. appendChild(node: INode): INode;
  390. /**
  391. * Remove Child element from childNodes array.
  392. *
  393. * @override
  394. * @param node Node to remove.
  395. */
  396. removeChild(node: INode): INode;
  397. /**
  398. * Inserts a node before another.
  399. *
  400. * @override
  401. * @param newNode Node to insert.
  402. * @param [referenceNode] Node to insert before.
  403. * @returns Inserted node.
  404. */
  405. insertBefore(newNode: INode, referenceNode?: INode): INode;
  406. /**
  407. * Replaces the document HTML with new HTML.
  408. *
  409. * @param html HTML.
  410. */
  411. write(html: string): void;
  412. /**
  413. * Opens the document.
  414. *
  415. * @returns Document.
  416. */
  417. open(): IDocument;
  418. /**
  419. * Closes the document.
  420. */
  421. close(): void;
  422. /**
  423. * Creates an element.
  424. *
  425. * @param qualifiedName Tag name.
  426. * @param [options] Options.
  427. * @param [options.is] Tag name of a custom element previously defined via customElements.define().
  428. * @returns Element.
  429. */
  430. createElement(qualifiedName: string, options?: {
  431. is?: string;
  432. }): IElement;
  433. /**
  434. * Creates an element with the specified namespace URI and qualified name.
  435. *
  436. * @param namespaceURI Namespace URI.
  437. * @param qualifiedName Tag name.
  438. * @param [options] Options.
  439. * @param [options.is] Tag name of a custom element previously defined via customElements.define().
  440. * @returns Element.
  441. */
  442. createElementNS(namespaceURI: string, qualifiedName: string, options?: {
  443. is?: string;
  444. }): IElement;
  445. /**
  446. * Creates a text node.
  447. *
  448. * @param [data] Text data.
  449. * @returns Text node.
  450. */
  451. createTextNode(data?: string): IText;
  452. /**
  453. * Creates a comment node.
  454. *
  455. * @param [data] Text data.
  456. * @returns Text node.
  457. */
  458. createComment(data?: string): IComment;
  459. /**
  460. * Creates a document fragment.
  461. *
  462. * @returns Document fragment.
  463. */
  464. createDocumentFragment(): IDocumentFragment;
  465. /**
  466. * Creates a Tree Walker.
  467. *
  468. * @param root Root.
  469. * @param [whatToShow] What to show.
  470. * @param [filter] Filter.
  471. */
  472. createTreeWalker(root: INode, whatToShow?: number, filter?: INodeFilter): TreeWalker;
  473. /**
  474. * Creates an event.
  475. *
  476. * @deprecated
  477. * @param type Type.
  478. * @returns Event.
  479. */
  480. createEvent(type: string): Event;
  481. /**
  482. * Creates an Attr node.
  483. *
  484. * @param qualifiedName Name.
  485. * @returns Attribute.
  486. */
  487. createAttribute(qualifiedName: string): IAttr;
  488. /**
  489. * Creates a namespaced Attr node.
  490. *
  491. * @param namespaceURI Namespace URI.
  492. * @param qualifiedName Qualified name.
  493. * @returns Element.
  494. */
  495. createAttributeNS(namespaceURI: string, qualifiedName: string): IAttr;
  496. /**
  497. * Imports a node.
  498. *
  499. * @param node Node to import.
  500. * @param [deep=false] Set to "true" if the clone should be deep.
  501. */
  502. importNode(node: INode, deep?: boolean): INode;
  503. /**
  504. * Creates a range.
  505. *
  506. * @returns Range.
  507. */
  508. createRange(): Range;
  509. /**
  510. * Adopts a node.
  511. *
  512. * @param node Node to adopt.
  513. * @returns Adopted node.
  514. */
  515. adoptNode(node: INode): INode;
  516. /**
  517. * Returns selection.
  518. *
  519. * @returns Selection.
  520. */
  521. getSelection(): Selection;
  522. /**
  523. * Returns a boolean value indicating whether the document or any element inside the document has focus.
  524. *
  525. * @returns "true" if the document has focus.
  526. */
  527. hasFocus(): boolean;
  528. /**
  529. * @override
  530. */
  531. dispatchEvent(event: Event): boolean;
  532. /**
  533. * Triggered by window when it is ready.
  534. */
  535. _onWindowReady(): void;
  536. /**
  537. * Creates a Processing Instruction node.
  538. *
  539. * @returns IProcessingInstruction.
  540. * @param target
  541. * @param data
  542. */
  543. createProcessingInstruction(target: string, data: string): IProcessingInstruction;
  544. }