From c05efa8d7ae464235cf83d7c0956e42dc6974103 Mon Sep 17 00:00:00 2001 From: julieng Date: Sat, 2 Oct 2021 17:20:14 +0200 Subject: move *.html to *.md --- .../fr/web/api/window/afterprint_event/index.html | 64 --- files/fr/web/api/window/afterprint_event/index.md | 64 +++ files/fr/web/api/window/alert/index.html | 36 -- files/fr/web/api/window/alert/index.md | 36 ++ .../fr/web/api/window/applicationcache/index.html | 35 -- files/fr/web/api/window/applicationcache/index.md | 35 ++ files/fr/web/api/window/back/index.html | 59 --- files/fr/web/api/window/back/index.md | 59 +++ .../fr/web/api/window/beforeprint_event/index.html | 75 --- files/fr/web/api/window/beforeprint_event/index.md | 75 +++ .../web/api/window/beforeunload_event/index.html | 140 ----- .../fr/web/api/window/beforeunload_event/index.md | 140 +++++ files/fr/web/api/window/blur/index.html | 46 -- files/fr/web/api/window/blur/index.md | 46 ++ .../web/api/window/cancelanimationframe/index.html | 77 --- .../web/api/window/cancelanimationframe/index.md | 77 +++ .../web/api/window/cancelidlecallback/index.html | 40 -- .../fr/web/api/window/cancelidlecallback/index.md | 40 ++ files/fr/web/api/window/captureevents/index.html | 57 --- files/fr/web/api/window/captureevents/index.md | 57 +++ files/fr/web/api/window/clearimmediate/index.html | 65 --- files/fr/web/api/window/clearimmediate/index.md | 65 +++ files/fr/web/api/window/close/index.html | 46 -- files/fr/web/api/window/close/index.md | 46 ++ files/fr/web/api/window/closed/index.html | 55 -- files/fr/web/api/window/closed/index.md | 55 ++ files/fr/web/api/window/confirm/index.html | 47 -- files/fr/web/api/window/confirm/index.md | 47 ++ files/fr/web/api/window/console/index.html | 56 -- files/fr/web/api/window/console/index.md | 56 ++ files/fr/web/api/window/content/index.html | 26 - files/fr/web/api/window/content/index.md | 26 + files/fr/web/api/window/controllers/index.html | 40 -- files/fr/web/api/window/controllers/index.md | 40 ++ files/fr/web/api/window/copy_event/index.html | 75 --- files/fr/web/api/window/copy_event/index.md | 75 +++ files/fr/web/api/window/customelements/index.html | 68 --- files/fr/web/api/window/customelements/index.md | 68 +++ files/fr/web/api/window/cut_event/index.html | 74 --- files/fr/web/api/window/cut_event/index.md | 74 +++ files/fr/web/api/window/defaultstatus/index.html | 50 -- files/fr/web/api/window/defaultstatus/index.md | 50 ++ .../web/api/window/devicemotion_event/index.html | 98 ---- .../fr/web/api/window/devicemotion_event/index.md | 98 ++++ .../api/window/deviceorientation_event/index.html | 84 --- .../api/window/deviceorientation_event/index.md | 84 +++ .../fr/web/api/window/devicepixelratio/index.html | 45 -- files/fr/web/api/window/devicepixelratio/index.md | 45 ++ files/fr/web/api/window/dialogarguments/index.html | 26 - files/fr/web/api/window/dialogarguments/index.md | 26 + files/fr/web/api/window/directories/index.html | 43 -- files/fr/web/api/window/directories/index.md | 43 ++ files/fr/web/api/window/document/index.html | 45 -- files/fr/web/api/window/document/index.md | 45 ++ .../api/window/domcontentloaded_event/index.html | 81 --- .../web/api/window/domcontentloaded_event/index.md | 81 +++ files/fr/web/api/window/dump/index.html | 25 - files/fr/web/api/window/dump/index.md | 25 + files/fr/web/api/window/event/index.html | 49 -- files/fr/web/api/window/event/index.md | 49 ++ files/fr/web/api/window/find/index.html | 78 --- files/fr/web/api/window/find/index.md | 78 +++ files/fr/web/api/window/focus/index.html | 37 -- files/fr/web/api/window/focus/index.md | 37 ++ files/fr/web/api/window/frameelement/index.html | 66 --- files/fr/web/api/window/frameelement/index.md | 66 +++ files/fr/web/api/window/frames/index.html | 43 -- files/fr/web/api/window/frames/index.md | 43 ++ files/fr/web/api/window/fullscreen/index.html | 32 -- files/fr/web/api/window/fullscreen/index.md | 32 ++ .../api/window/gamepadconnected_event/index.html | 86 ---- .../web/api/window/gamepadconnected_event/index.md | 86 ++++ .../window/gamepaddisconnected_event/index.html | 74 --- .../api/window/gamepaddisconnected_event/index.md | 74 +++ .../fr/web/api/window/getcomputedstyle/index.html | 116 ----- files/fr/web/api/window/getcomputedstyle/index.md | 116 +++++ .../api/window/getdefaultcomputedstyle/index.html | 87 ---- .../api/window/getdefaultcomputedstyle/index.md | 87 ++++ files/fr/web/api/window/getselection/index.html | 47 -- files/fr/web/api/window/getselection/index.md | 47 ++ .../fr/web/api/window/hashchange_event/index.html | 139 ----- files/fr/web/api/window/hashchange_event/index.md | 139 +++++ files/fr/web/api/window/history/index.html | 53 -- files/fr/web/api/window/history/index.md | 53 ++ files/fr/web/api/window/home/index.html | 36 -- files/fr/web/api/window/home/index.md | 36 ++ files/fr/web/api/window/index.html | 568 --------------------- files/fr/web/api/window/index.md | 568 +++++++++++++++++++++ files/fr/web/api/window/innerheight/index.html | 95 ---- files/fr/web/api/window/innerheight/index.md | 95 ++++ files/fr/web/api/window/innerwidth/index.html | 68 --- files/fr/web/api/window/innerwidth/index.md | 68 +++ files/fr/web/api/window/issecurecontext/index.html | 58 --- files/fr/web/api/window/issecurecontext/index.md | 58 +++ .../web/api/window/languagechange_event/index.html | 79 --- .../web/api/window/languagechange_event/index.md | 79 +++ files/fr/web/api/window/length/index.html | 27 - files/fr/web/api/window/length/index.md | 27 + files/fr/web/api/window/load_event/index.html | 91 ---- files/fr/web/api/window/load_event/index.md | 91 ++++ files/fr/web/api/window/localstorage/index.html | 91 ---- files/fr/web/api/window/localstorage/index.md | 91 ++++ files/fr/web/api/window/location/index.html | 197 ------- files/fr/web/api/window/location/index.md | 197 +++++++ files/fr/web/api/window/locationbar/index.html | 72 --- files/fr/web/api/window/locationbar/index.md | 72 +++ files/fr/web/api/window/matchmedia/index.html | 51 -- files/fr/web/api/window/matchmedia/index.md | 51 ++ files/fr/web/api/window/menubar/index.html | 72 --- files/fr/web/api/window/menubar/index.md | 72 +++ files/fr/web/api/window/message_event/index.html | 82 --- files/fr/web/api/window/message_event/index.md | 82 +++ .../web/api/window/messageerror_event/index.html | 77 --- .../fr/web/api/window/messageerror_event/index.md | 77 +++ files/fr/web/api/window/mozinnerscreenx/index.html | 47 -- files/fr/web/api/window/mozinnerscreenx/index.md | 47 ++ files/fr/web/api/window/mozinnerscreeny/index.html | 47 -- files/fr/web/api/window/mozinnerscreeny/index.md | 47 ++ files/fr/web/api/window/mozpaintcount/index.html | 35 -- files/fr/web/api/window/mozpaintcount/index.md | 35 ++ files/fr/web/api/window/name/index.html | 54 -- files/fr/web/api/window/name/index.md | 54 ++ files/fr/web/api/window/navigator/index.html | 48 -- files/fr/web/api/window/navigator/index.md | 48 ++ files/fr/web/api/window/offline_event/index.html | 73 --- files/fr/web/api/window/offline_event/index.md | 73 +++ files/fr/web/api/window/online_event/index.html | 77 --- files/fr/web/api/window/online_event/index.md | 77 +++ files/fr/web/api/window/onpaint/index.html | 37 -- files/fr/web/api/window/onpaint/index.md | 37 ++ files/fr/web/api/window/open/index.html | 518 ------------------- files/fr/web/api/window/open/index.md | 518 +++++++++++++++++++ files/fr/web/api/window/opendialog/index.html | 102 ---- files/fr/web/api/window/opendialog/index.md | 102 ++++ files/fr/web/api/window/opener/index.html | 24 - files/fr/web/api/window/opener/index.md | 24 + files/fr/web/api/window/orientation/index.html | 35 -- files/fr/web/api/window/orientation/index.md | 35 ++ files/fr/web/api/window/outerheight/index.html | 62 --- files/fr/web/api/window/outerheight/index.md | 62 +++ files/fr/web/api/window/outerwidth/index.html | 59 --- files/fr/web/api/window/outerwidth/index.md | 59 +++ files/fr/web/api/window/pagehide_event/index.html | 70 --- files/fr/web/api/window/pagehide_event/index.md | 70 +++ files/fr/web/api/window/pageshow_event/index.html | 110 ---- files/fr/web/api/window/pageshow_event/index.md | 110 ++++ files/fr/web/api/window/parent/index.html | 25 - files/fr/web/api/window/parent/index.md | 25 + files/fr/web/api/window/paste_event/index.html | 71 --- files/fr/web/api/window/paste_event/index.md | 71 +++ files/fr/web/api/window/popstate_event/index.html | 111 ---- files/fr/web/api/window/popstate_event/index.md | 111 ++++ files/fr/web/api/window/postmessage/index.html | 179 ------- files/fr/web/api/window/postmessage/index.md | 179 +++++++ files/fr/web/api/window/print/index.html | 50 -- files/fr/web/api/window/print/index.md | 50 ++ files/fr/web/api/window/prompt/index.html | 91 ---- files/fr/web/api/window/prompt/index.md | 91 ++++ .../api/window/rejectionhandled_event/index.html | 82 --- .../web/api/window/rejectionhandled_event/index.md | 82 +++ .../api/window/requestanimationframe/index.html | 93 ---- .../web/api/window/requestanimationframe/index.md | 93 ++++ .../web/api/window/requestidlecallback/index.html | 65 --- .../fr/web/api/window/requestidlecallback/index.md | 65 +++ files/fr/web/api/window/resizeby/index.html | 73 --- files/fr/web/api/window/resizeby/index.md | 73 +++ files/fr/web/api/window/screen/index.html | 55 -- files/fr/web/api/window/screen/index.md | 55 ++ files/fr/web/api/window/screenx/index.html | 52 -- files/fr/web/api/window/screenx/index.md | 52 ++ files/fr/web/api/window/scroll/index.html | 24 - files/fr/web/api/window/scroll/index.md | 24 + files/fr/web/api/window/scrollbars/index.html | 73 --- files/fr/web/api/window/scrollbars/index.md | 73 +++ files/fr/web/api/window/scrollby/index.html | 56 -- files/fr/web/api/window/scrollby/index.md | 56 ++ files/fr/web/api/window/scrollbylines/index.html | 49 -- files/fr/web/api/window/scrollbylines/index.md | 49 ++ files/fr/web/api/window/scrollbypages/index.html | 42 -- files/fr/web/api/window/scrollbypages/index.md | 42 ++ files/fr/web/api/window/scrollto/index.html | 38 -- files/fr/web/api/window/scrollto/index.md | 38 ++ files/fr/web/api/window/scrolly/index.html | 71 --- files/fr/web/api/window/scrolly/index.md | 71 +++ files/fr/web/api/window/sessionstorage/index.html | 89 ---- files/fr/web/api/window/sessionstorage/index.md | 89 ++++ files/fr/web/api/window/showmodaldialog/index.html | 87 ---- files/fr/web/api/window/showmodaldialog/index.md | 87 ++++ files/fr/web/api/window/stop/index.html | 54 -- files/fr/web/api/window/stop/index.md | 54 ++ files/fr/web/api/window/storage_event/index.html | 83 --- files/fr/web/api/window/storage_event/index.md | 83 +++ files/fr/web/api/window/top/index.html | 54 -- files/fr/web/api/window/top/index.md | 54 ++ files/fr/web/api/window/unload_event/index.html | 156 ------ files/fr/web/api/window/unload_event/index.md | 156 ++++++ .../api/window/vrdisplayconnect_event/index.html | 81 --- .../web/api/window/vrdisplayconnect_event/index.md | 81 +++ .../window/vrdisplaydisconnect_event/index.html | 81 --- .../api/window/vrdisplaydisconnect_event/index.md | 81 +++ .../window/vrdisplaypresentchange_event/index.html | 89 ---- .../window/vrdisplaypresentchange_event/index.md | 89 ++++ 202 files changed, 7721 insertions(+), 7721 deletions(-) delete mode 100644 files/fr/web/api/window/afterprint_event/index.html create mode 100644 files/fr/web/api/window/afterprint_event/index.md delete mode 100644 files/fr/web/api/window/alert/index.html create mode 100644 files/fr/web/api/window/alert/index.md delete mode 100644 files/fr/web/api/window/applicationcache/index.html create mode 100644 files/fr/web/api/window/applicationcache/index.md delete mode 100644 files/fr/web/api/window/back/index.html create mode 100644 files/fr/web/api/window/back/index.md delete mode 100644 files/fr/web/api/window/beforeprint_event/index.html create mode 100644 files/fr/web/api/window/beforeprint_event/index.md delete mode 100644 files/fr/web/api/window/beforeunload_event/index.html create mode 100644 files/fr/web/api/window/beforeunload_event/index.md delete mode 100644 files/fr/web/api/window/blur/index.html create mode 100644 files/fr/web/api/window/blur/index.md delete mode 100644 files/fr/web/api/window/cancelanimationframe/index.html create mode 100644 files/fr/web/api/window/cancelanimationframe/index.md delete mode 100644 files/fr/web/api/window/cancelidlecallback/index.html create mode 100644 files/fr/web/api/window/cancelidlecallback/index.md delete mode 100644 files/fr/web/api/window/captureevents/index.html create mode 100644 files/fr/web/api/window/captureevents/index.md delete mode 100644 files/fr/web/api/window/clearimmediate/index.html create mode 100644 files/fr/web/api/window/clearimmediate/index.md delete mode 100644 files/fr/web/api/window/close/index.html create mode 100644 files/fr/web/api/window/close/index.md delete mode 100644 files/fr/web/api/window/closed/index.html create mode 100644 files/fr/web/api/window/closed/index.md delete mode 100644 files/fr/web/api/window/confirm/index.html create mode 100644 files/fr/web/api/window/confirm/index.md delete mode 100644 files/fr/web/api/window/console/index.html create mode 100644 files/fr/web/api/window/console/index.md delete mode 100644 files/fr/web/api/window/content/index.html create mode 100644 files/fr/web/api/window/content/index.md delete mode 100644 files/fr/web/api/window/controllers/index.html create mode 100644 files/fr/web/api/window/controllers/index.md delete mode 100644 files/fr/web/api/window/copy_event/index.html create mode 100644 files/fr/web/api/window/copy_event/index.md delete mode 100644 files/fr/web/api/window/customelements/index.html create mode 100644 files/fr/web/api/window/customelements/index.md delete mode 100644 files/fr/web/api/window/cut_event/index.html create mode 100644 files/fr/web/api/window/cut_event/index.md delete mode 100644 files/fr/web/api/window/defaultstatus/index.html create mode 100644 files/fr/web/api/window/defaultstatus/index.md delete mode 100644 files/fr/web/api/window/devicemotion_event/index.html create mode 100644 files/fr/web/api/window/devicemotion_event/index.md delete mode 100644 files/fr/web/api/window/deviceorientation_event/index.html create mode 100644 files/fr/web/api/window/deviceorientation_event/index.md delete mode 100644 files/fr/web/api/window/devicepixelratio/index.html create mode 100644 files/fr/web/api/window/devicepixelratio/index.md delete mode 100644 files/fr/web/api/window/dialogarguments/index.html create mode 100644 files/fr/web/api/window/dialogarguments/index.md delete mode 100644 files/fr/web/api/window/directories/index.html create mode 100644 files/fr/web/api/window/directories/index.md delete mode 100644 files/fr/web/api/window/document/index.html create mode 100644 files/fr/web/api/window/document/index.md delete mode 100644 files/fr/web/api/window/domcontentloaded_event/index.html create mode 100644 files/fr/web/api/window/domcontentloaded_event/index.md delete mode 100644 files/fr/web/api/window/dump/index.html create mode 100644 files/fr/web/api/window/dump/index.md delete mode 100644 files/fr/web/api/window/event/index.html create mode 100644 files/fr/web/api/window/event/index.md delete mode 100644 files/fr/web/api/window/find/index.html create mode 100644 files/fr/web/api/window/find/index.md delete mode 100644 files/fr/web/api/window/focus/index.html create mode 100644 files/fr/web/api/window/focus/index.md delete mode 100644 files/fr/web/api/window/frameelement/index.html create mode 100644 files/fr/web/api/window/frameelement/index.md delete mode 100644 files/fr/web/api/window/frames/index.html create mode 100644 files/fr/web/api/window/frames/index.md delete mode 100644 files/fr/web/api/window/fullscreen/index.html create mode 100644 files/fr/web/api/window/fullscreen/index.md delete mode 100644 files/fr/web/api/window/gamepadconnected_event/index.html create mode 100644 files/fr/web/api/window/gamepadconnected_event/index.md delete mode 100644 files/fr/web/api/window/gamepaddisconnected_event/index.html create mode 100644 files/fr/web/api/window/gamepaddisconnected_event/index.md delete mode 100644 files/fr/web/api/window/getcomputedstyle/index.html create mode 100644 files/fr/web/api/window/getcomputedstyle/index.md delete mode 100644 files/fr/web/api/window/getdefaultcomputedstyle/index.html create mode 100644 files/fr/web/api/window/getdefaultcomputedstyle/index.md delete mode 100644 files/fr/web/api/window/getselection/index.html create mode 100644 files/fr/web/api/window/getselection/index.md delete mode 100644 files/fr/web/api/window/hashchange_event/index.html create mode 100644 files/fr/web/api/window/hashchange_event/index.md delete mode 100644 files/fr/web/api/window/history/index.html create mode 100644 files/fr/web/api/window/history/index.md delete mode 100644 files/fr/web/api/window/home/index.html create mode 100644 files/fr/web/api/window/home/index.md delete mode 100644 files/fr/web/api/window/index.html create mode 100644 files/fr/web/api/window/index.md delete mode 100644 files/fr/web/api/window/innerheight/index.html create mode 100644 files/fr/web/api/window/innerheight/index.md delete mode 100644 files/fr/web/api/window/innerwidth/index.html create mode 100644 files/fr/web/api/window/innerwidth/index.md delete mode 100644 files/fr/web/api/window/issecurecontext/index.html create mode 100644 files/fr/web/api/window/issecurecontext/index.md delete mode 100644 files/fr/web/api/window/languagechange_event/index.html create mode 100644 files/fr/web/api/window/languagechange_event/index.md delete mode 100644 files/fr/web/api/window/length/index.html create mode 100644 files/fr/web/api/window/length/index.md delete mode 100644 files/fr/web/api/window/load_event/index.html create mode 100644 files/fr/web/api/window/load_event/index.md delete mode 100644 files/fr/web/api/window/localstorage/index.html create mode 100644 files/fr/web/api/window/localstorage/index.md delete mode 100644 files/fr/web/api/window/location/index.html create mode 100644 files/fr/web/api/window/location/index.md delete mode 100644 files/fr/web/api/window/locationbar/index.html create mode 100644 files/fr/web/api/window/locationbar/index.md delete mode 100644 files/fr/web/api/window/matchmedia/index.html create mode 100644 files/fr/web/api/window/matchmedia/index.md delete mode 100644 files/fr/web/api/window/menubar/index.html create mode 100644 files/fr/web/api/window/menubar/index.md delete mode 100644 files/fr/web/api/window/message_event/index.html create mode 100644 files/fr/web/api/window/message_event/index.md delete mode 100644 files/fr/web/api/window/messageerror_event/index.html create mode 100644 files/fr/web/api/window/messageerror_event/index.md delete mode 100644 files/fr/web/api/window/mozinnerscreenx/index.html create mode 100644 files/fr/web/api/window/mozinnerscreenx/index.md delete mode 100644 files/fr/web/api/window/mozinnerscreeny/index.html create mode 100644 files/fr/web/api/window/mozinnerscreeny/index.md delete mode 100644 files/fr/web/api/window/mozpaintcount/index.html create mode 100644 files/fr/web/api/window/mozpaintcount/index.md delete mode 100644 files/fr/web/api/window/name/index.html create mode 100644 files/fr/web/api/window/name/index.md delete mode 100644 files/fr/web/api/window/navigator/index.html create mode 100644 files/fr/web/api/window/navigator/index.md delete mode 100644 files/fr/web/api/window/offline_event/index.html create mode 100644 files/fr/web/api/window/offline_event/index.md delete mode 100644 files/fr/web/api/window/online_event/index.html create mode 100644 files/fr/web/api/window/online_event/index.md delete mode 100644 files/fr/web/api/window/onpaint/index.html create mode 100644 files/fr/web/api/window/onpaint/index.md delete mode 100644 files/fr/web/api/window/open/index.html create mode 100644 files/fr/web/api/window/open/index.md delete mode 100644 files/fr/web/api/window/opendialog/index.html create mode 100644 files/fr/web/api/window/opendialog/index.md delete mode 100644 files/fr/web/api/window/opener/index.html create mode 100644 files/fr/web/api/window/opener/index.md delete mode 100644 files/fr/web/api/window/orientation/index.html create mode 100644 files/fr/web/api/window/orientation/index.md delete mode 100644 files/fr/web/api/window/outerheight/index.html create mode 100644 files/fr/web/api/window/outerheight/index.md delete mode 100644 files/fr/web/api/window/outerwidth/index.html create mode 100644 files/fr/web/api/window/outerwidth/index.md delete mode 100644 files/fr/web/api/window/pagehide_event/index.html create mode 100644 files/fr/web/api/window/pagehide_event/index.md delete mode 100644 files/fr/web/api/window/pageshow_event/index.html create mode 100644 files/fr/web/api/window/pageshow_event/index.md delete mode 100644 files/fr/web/api/window/parent/index.html create mode 100644 files/fr/web/api/window/parent/index.md delete mode 100644 files/fr/web/api/window/paste_event/index.html create mode 100644 files/fr/web/api/window/paste_event/index.md delete mode 100644 files/fr/web/api/window/popstate_event/index.html create mode 100644 files/fr/web/api/window/popstate_event/index.md delete mode 100644 files/fr/web/api/window/postmessage/index.html create mode 100644 files/fr/web/api/window/postmessage/index.md delete mode 100644 files/fr/web/api/window/print/index.html create mode 100644 files/fr/web/api/window/print/index.md delete mode 100644 files/fr/web/api/window/prompt/index.html create mode 100644 files/fr/web/api/window/prompt/index.md delete mode 100644 files/fr/web/api/window/rejectionhandled_event/index.html create mode 100644 files/fr/web/api/window/rejectionhandled_event/index.md delete mode 100644 files/fr/web/api/window/requestanimationframe/index.html create mode 100644 files/fr/web/api/window/requestanimationframe/index.md delete mode 100644 files/fr/web/api/window/requestidlecallback/index.html create mode 100644 files/fr/web/api/window/requestidlecallback/index.md delete mode 100644 files/fr/web/api/window/resizeby/index.html create mode 100644 files/fr/web/api/window/resizeby/index.md delete mode 100644 files/fr/web/api/window/screen/index.html create mode 100644 files/fr/web/api/window/screen/index.md delete mode 100644 files/fr/web/api/window/screenx/index.html create mode 100644 files/fr/web/api/window/screenx/index.md delete mode 100644 files/fr/web/api/window/scroll/index.html create mode 100644 files/fr/web/api/window/scroll/index.md delete mode 100644 files/fr/web/api/window/scrollbars/index.html create mode 100644 files/fr/web/api/window/scrollbars/index.md delete mode 100644 files/fr/web/api/window/scrollby/index.html create mode 100644 files/fr/web/api/window/scrollby/index.md delete mode 100644 files/fr/web/api/window/scrollbylines/index.html create mode 100644 files/fr/web/api/window/scrollbylines/index.md delete mode 100644 files/fr/web/api/window/scrollbypages/index.html create mode 100644 files/fr/web/api/window/scrollbypages/index.md delete mode 100644 files/fr/web/api/window/scrollto/index.html create mode 100644 files/fr/web/api/window/scrollto/index.md delete mode 100644 files/fr/web/api/window/scrolly/index.html create mode 100644 files/fr/web/api/window/scrolly/index.md delete mode 100644 files/fr/web/api/window/sessionstorage/index.html create mode 100644 files/fr/web/api/window/sessionstorage/index.md delete mode 100644 files/fr/web/api/window/showmodaldialog/index.html create mode 100644 files/fr/web/api/window/showmodaldialog/index.md delete mode 100644 files/fr/web/api/window/stop/index.html create mode 100644 files/fr/web/api/window/stop/index.md delete mode 100644 files/fr/web/api/window/storage_event/index.html create mode 100644 files/fr/web/api/window/storage_event/index.md delete mode 100644 files/fr/web/api/window/top/index.html create mode 100644 files/fr/web/api/window/top/index.md delete mode 100644 files/fr/web/api/window/unload_event/index.html create mode 100644 files/fr/web/api/window/unload_event/index.md delete mode 100644 files/fr/web/api/window/vrdisplayconnect_event/index.html create mode 100644 files/fr/web/api/window/vrdisplayconnect_event/index.md delete mode 100644 files/fr/web/api/window/vrdisplaydisconnect_event/index.html create mode 100644 files/fr/web/api/window/vrdisplaydisconnect_event/index.md delete mode 100644 files/fr/web/api/window/vrdisplaypresentchange_event/index.html create mode 100644 files/fr/web/api/window/vrdisplaypresentchange_event/index.md (limited to 'files/fr/web/api/window') diff --git a/files/fr/web/api/window/afterprint_event/index.html b/files/fr/web/api/window/afterprint_event/index.html deleted file mode 100644 index c63ed6bc56..0000000000 --- a/files/fr/web/api/window/afterprint_event/index.html +++ /dev/null @@ -1,64 +0,0 @@ ---- -title: afterprint -slug: Web/API/Window/afterprint_event -translation_of: Web/API/Window/afterprint_event -original_slug: Web/Events/afterprint ---- -

L'événement afterprint est déclenché après que le document associé a été imprimé ou que l'aperçu avant impression a été fermé.

- -

Informations générales

- -
-
Spécification
-
HTML5
-
Interface
-
Event
-
Propagation
-
Non
-
Annulable
-
Non
-
Cible
-
DefaultView (<window>)
-
Action par défaut
-
Aucune
-
- -

Propriétés

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
PropertyTypeDescription
target {{readonlyInline}}{{domxref("EventTarget")}}The event target (the topmost target in the DOM tree).
type {{readonlyInline}}{{domxref("DOMString")}}The type of event.
bubbles {{readonlyInline}}{{jsxref("Boolean")}}Whether the event normally bubbles or not.
cancelable {{readonlyInline}}{{jsxref("Boolean")}}Whether the event is cancellable or not.
- -

Evénements liés

- - diff --git a/files/fr/web/api/window/afterprint_event/index.md b/files/fr/web/api/window/afterprint_event/index.md new file mode 100644 index 0000000000..c63ed6bc56 --- /dev/null +++ b/files/fr/web/api/window/afterprint_event/index.md @@ -0,0 +1,64 @@ +--- +title: afterprint +slug: Web/API/Window/afterprint_event +translation_of: Web/API/Window/afterprint_event +original_slug: Web/Events/afterprint +--- +

L'événement afterprint est déclenché après que le document associé a été imprimé ou que l'aperçu avant impression a été fermé.

+ +

Informations générales

+ +
+
Spécification
+
HTML5
+
Interface
+
Event
+
Propagation
+
Non
+
Annulable
+
Non
+
Cible
+
DefaultView (<window>)
+
Action par défaut
+
Aucune
+
+ +

Propriétés

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
PropertyTypeDescription
target {{readonlyInline}}{{domxref("EventTarget")}}The event target (the topmost target in the DOM tree).
type {{readonlyInline}}{{domxref("DOMString")}}The type of event.
bubbles {{readonlyInline}}{{jsxref("Boolean")}}Whether the event normally bubbles or not.
cancelable {{readonlyInline}}{{jsxref("Boolean")}}Whether the event is cancellable or not.
+ +

Evénements liés

+ + diff --git a/files/fr/web/api/window/alert/index.html b/files/fr/web/api/window/alert/index.html deleted file mode 100644 index 9f41bd3dff..0000000000 --- a/files/fr/web/api/window/alert/index.html +++ /dev/null @@ -1,36 +0,0 @@ ---- -title: window.alert -slug: Web/API/Window/alert -tags: - - DOM - - DOM_0 - - Référence_du_DOM_Gecko -translation_of: Web/API/Window/alert ---- -

{{ ApiRef() }}

-

Résumé

-

Affiche un dialogue d'alerte contenant le texte spécifié.

-

Syntaxe

-
window.alert(message);
-
- -

Exemple

-
window.alert("Bonjour !");
-
-

produira :

- -

- -

Notes

-

Le dialogue d'alerte doit être utilisé pour les messages qui ne demandent aucune réponse de la part de l'utilisateur, à part son acceptation du message.

-

Le texte suivant est commun à cet article, DOM:window.prompt et DOM:window.confirm Les boîtes de dialogue sont des fenêtres modales : elles empêchent l'utilisateur d'accéder au reste de l'interface du programme tant qu'elles ne sont pas fermées. C'est pourquoi il ne faut pas abuser des fonctions créant une boîte de dialogue (ou fenêtre modale).

-

Les applications utilisant le chrome (par exemple les extensions) devront plutôt utiliser les méthodes de nsIPromptService.

-

Spécification

-

{{ DOM0() }}

-

Voir aussi

- \ No newline at end of file diff --git a/files/fr/web/api/window/alert/index.md b/files/fr/web/api/window/alert/index.md new file mode 100644 index 0000000000..9f41bd3dff --- /dev/null +++ b/files/fr/web/api/window/alert/index.md @@ -0,0 +1,36 @@ +--- +title: window.alert +slug: Web/API/Window/alert +tags: + - DOM + - DOM_0 + - Référence_du_DOM_Gecko +translation_of: Web/API/Window/alert +--- +

{{ ApiRef() }}

+

Résumé

+

Affiche un dialogue d'alerte contenant le texte spécifié.

+

Syntaxe

+
window.alert(message);
+
+ +

Exemple

+
window.alert("Bonjour !");
+
+

produira :

+ +

+ +

Notes

+

Le dialogue d'alerte doit être utilisé pour les messages qui ne demandent aucune réponse de la part de l'utilisateur, à part son acceptation du message.

+

Le texte suivant est commun à cet article, DOM:window.prompt et DOM:window.confirm Les boîtes de dialogue sont des fenêtres modales : elles empêchent l'utilisateur d'accéder au reste de l'interface du programme tant qu'elles ne sont pas fermées. C'est pourquoi il ne faut pas abuser des fonctions créant une boîte de dialogue (ou fenêtre modale).

+

Les applications utilisant le chrome (par exemple les extensions) devront plutôt utiliser les méthodes de nsIPromptService.

+

Spécification

+

{{ DOM0() }}

+

Voir aussi

+ \ No newline at end of file diff --git a/files/fr/web/api/window/applicationcache/index.html b/files/fr/web/api/window/applicationcache/index.html deleted file mode 100644 index 7518fb40ed..0000000000 --- a/files/fr/web/api/window/applicationcache/index.html +++ /dev/null @@ -1,35 +0,0 @@ ---- -title: Window.applicationCache -slug: Web/API/Window/applicationCache -translation_of: Web/API/Window/applicationCache ---- -
-

Attention : Le cache d'application est obsolète depuis Firefox 44, et n'est plus disponible dans un contexte non sécurisé depuis Firefox 60 ({{bug(1354175)}}, actuellemet Nightly/Beta seulement). Ne pas l'utiliser sur des sites hors lignes — envisager l'utilisation de service workers à la place.

-
- -

{{APIRef}}

- -

Retourne une référence à l'objet du cache d'application pour la fenêtre.

- -

Syntaxe

- -
cache = window.applicationCache
-
- -

Paramètres

- - - -

Spécification

- - - -

Voir aussi

- - diff --git a/files/fr/web/api/window/applicationcache/index.md b/files/fr/web/api/window/applicationcache/index.md new file mode 100644 index 0000000000..7518fb40ed --- /dev/null +++ b/files/fr/web/api/window/applicationcache/index.md @@ -0,0 +1,35 @@ +--- +title: Window.applicationCache +slug: Web/API/Window/applicationCache +translation_of: Web/API/Window/applicationCache +--- +
+

Attention : Le cache d'application est obsolète depuis Firefox 44, et n'est plus disponible dans un contexte non sécurisé depuis Firefox 60 ({{bug(1354175)}}, actuellemet Nightly/Beta seulement). Ne pas l'utiliser sur des sites hors lignes — envisager l'utilisation de service workers à la place.

+
+ +

{{APIRef}}

+ +

Retourne une référence à l'objet du cache d'application pour la fenêtre.

+ +

Syntaxe

+ +
cache = window.applicationCache
+
+ +

Paramètres

+ + + +

Spécification

+ + + +

Voir aussi

+ + diff --git a/files/fr/web/api/window/back/index.html b/files/fr/web/api/window/back/index.html deleted file mode 100644 index 9743d49f37..0000000000 --- a/files/fr/web/api/window/back/index.html +++ /dev/null @@ -1,59 +0,0 @@ ---- -title: Window.back() -slug: Web/API/Window/back -tags: - - API - - Firefox - - Gecko - - HTML DOM - - Méthode - - Non-standard - - Obsolete - - Window - - back -translation_of: Web/API/Window/back ---- -
{{APIRef}}{{ Non-standard_header() }}{{deprecated_header}}
- -

La méthode obsolète et non standard back() sur l'objet {{domxref("window")}} renvoie la fenêtre à l'élément précédent de l'historique. Il s'agissait d'une méthode spécifique à Firefox et a été supprimée dans Firefox 31.

- -
-

Note: Utilisez plutôt la méthode standard {{domxref("history.back")}}.

-
- -

Syntaxe

- -
window.back();
- -

Paramètres

- -

Aucun.

- -

Valeur de retour

- -

undefined.

- -

Exemple

- -

Cet exemple simple gère un clic sur un bouton "Retour" en rappelant back().

- -
function boutonRetour() {
-  if (peutRevenirEnArriere) {
-    window.back();
-  }
-}
- -

Spécification

- -

Cela ne fait partie d'aucune spécification.

- -

Compatibilité des navigateurs

- -

Cette méthode non standard n'a été implémentée que dans Firefox et a été supprimée dans Firefox 31.

- -

Voir également

- - diff --git a/files/fr/web/api/window/back/index.md b/files/fr/web/api/window/back/index.md new file mode 100644 index 0000000000..9743d49f37 --- /dev/null +++ b/files/fr/web/api/window/back/index.md @@ -0,0 +1,59 @@ +--- +title: Window.back() +slug: Web/API/Window/back +tags: + - API + - Firefox + - Gecko + - HTML DOM + - Méthode + - Non-standard + - Obsolete + - Window + - back +translation_of: Web/API/Window/back +--- +
{{APIRef}}{{ Non-standard_header() }}{{deprecated_header}}
+ +

La méthode obsolète et non standard back() sur l'objet {{domxref("window")}} renvoie la fenêtre à l'élément précédent de l'historique. Il s'agissait d'une méthode spécifique à Firefox et a été supprimée dans Firefox 31.

+ +
+

Note: Utilisez plutôt la méthode standard {{domxref("history.back")}}.

+
+ +

Syntaxe

+ +
window.back();
+ +

Paramètres

+ +

Aucun.

+ +

Valeur de retour

+ +

undefined.

+ +

Exemple

+ +

Cet exemple simple gère un clic sur un bouton "Retour" en rappelant back().

+ +
function boutonRetour() {
+  if (peutRevenirEnArriere) {
+    window.back();
+  }
+}
+ +

Spécification

+ +

Cela ne fait partie d'aucune spécification.

+ +

Compatibilité des navigateurs

+ +

Cette méthode non standard n'a été implémentée que dans Firefox et a été supprimée dans Firefox 31.

+ +

Voir également

+ + diff --git a/files/fr/web/api/window/beforeprint_event/index.html b/files/fr/web/api/window/beforeprint_event/index.html deleted file mode 100644 index b0e96ca975..0000000000 --- a/files/fr/web/api/window/beforeprint_event/index.html +++ /dev/null @@ -1,75 +0,0 @@ ---- -title: beforeprint -slug: Web/API/Window/beforeprint_event -tags: - - Evènement - - Reference -translation_of: Web/API/Window/beforeprint_event -original_slug: Web/Events/beforeprint ---- -

L'événement beforeprint est déclenché lorsque le document associé est sur le point d'être imprimé ou qu'un "aperçu avant impression" est lancé.

- -

Informations générales

- -
-
Spécification
-
HTML5
-
Interface
-
Event
-
Propagation
-
Non
-
Annulable
-
Non
-
Cible
-
DefaultView (<window>)
-
Action par défaut
-
Aucune
-
- -

Exemples

- -

En utilisant window.addEventListener() :

- -
window.addEventListener("beforeprint", (evenement) => {
-  console.log("Before print");
-});
- -

Propriétés

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
PropertyTypeDescription
target {{readonlyInline}}{{domxref("EventTarget")}}The event target (the topmost target in the DOM tree).
type {{readonlyInline}}{{domxref("DOMString")}}The type of event.
bubbles {{readonlyInline}}{{jsxref("Boolean")}}Whether the event normally bubbles or not.
cancelable {{readonlyInline}}{{jsxref("Boolean")}}Whether the event is cancellable or not.
- -

Evénements liés

- - diff --git a/files/fr/web/api/window/beforeprint_event/index.md b/files/fr/web/api/window/beforeprint_event/index.md new file mode 100644 index 0000000000..b0e96ca975 --- /dev/null +++ b/files/fr/web/api/window/beforeprint_event/index.md @@ -0,0 +1,75 @@ +--- +title: beforeprint +slug: Web/API/Window/beforeprint_event +tags: + - Evènement + - Reference +translation_of: Web/API/Window/beforeprint_event +original_slug: Web/Events/beforeprint +--- +

L'événement beforeprint est déclenché lorsque le document associé est sur le point d'être imprimé ou qu'un "aperçu avant impression" est lancé.

+ +

Informations générales

+ +
+
Spécification
+
HTML5
+
Interface
+
Event
+
Propagation
+
Non
+
Annulable
+
Non
+
Cible
+
DefaultView (<window>)
+
Action par défaut
+
Aucune
+
+ +

Exemples

+ +

En utilisant window.addEventListener() :

+ +
window.addEventListener("beforeprint", (evenement) => {
+  console.log("Before print");
+});
+ +

Propriétés

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
PropertyTypeDescription
target {{readonlyInline}}{{domxref("EventTarget")}}The event target (the topmost target in the DOM tree).
type {{readonlyInline}}{{domxref("DOMString")}}The type of event.
bubbles {{readonlyInline}}{{jsxref("Boolean")}}Whether the event normally bubbles or not.
cancelable {{readonlyInline}}{{jsxref("Boolean")}}Whether the event is cancellable or not.
+ +

Evénements liés

+ + diff --git a/files/fr/web/api/window/beforeunload_event/index.html b/files/fr/web/api/window/beforeunload_event/index.html deleted file mode 100644 index 249644f9e3..0000000000 --- a/files/fr/web/api/window/beforeunload_event/index.html +++ /dev/null @@ -1,140 +0,0 @@ ---- -title: beforeunload -slug: Web/API/Window/beforeunload_event -translation_of: Web/API/Window/beforeunload_event -original_slug: Web/Events/beforeunload ---- -

L'événement beforeunload est déclenché quand la fênetre, ou le document, et leurs resources sont sur le point d'être déchargés.

- -

Lorsqu'une chaîne de caractères est assignée à la propriété returnValue de {{domxref("Event")}}, une boîte de dialogue apparaît demandant confirmation avant de quitter la page (voir exemple plus bas). Certains navigateurs affichent la valeur retournée, alors que d'autres affichent leur propre message. Si aucune valeur n'est fournie, l'événement est traité silencieusement.

- -
-

Note : Afin d'éviter les "pop-ups" indésirables, les navigateurs peuvent ne pas afficher les alertes créées dans les gestionnaires beforeunload.

-
- -
-

Attention : Attacher un gestionnaire d'événement beforeunload à window ou à document empêche les navigateurs d'utiliser leur mémoire cache ; consulter Utilisation du cache de Firefox 1.5 ou WebKit's Page Cache (en anglais).

-
- - - - - - - - - - - - - - - - - - - - -
PropagationNon
AnnulableOui
Object cibledefaultView
Interface{{domxref("Event")}}
- -

Propriétés

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
PropriétéTypeDescription
target {{readOnlyInline}}{{domxref("EventTarget")}}La cible de l'événement (la plus haute cible dans l'arbre du DOM).
type {{readOnlyInline}}{{domxref("DOMString")}}Le type de l'événement.
bubbles {{readOnlyInline}}{{jsxref("Boolean")}}Est-ce que l'événement se propage ?
cancelable {{readOnlyInline}}{{jsxref("Boolean")}}Est-il possible d'annuler l'événement ?
returnValue{{domxref("DOMString")}}La valeur de retour de l'événement (le message à afficher à l'utlisateur)
- -

Exemples

- -
window.addEventListener("beforeunload", function (event) {
-  event.returnValue = "\o/";
-});
-
-// est équivalent à
-window.addEventListener("beforeunload", function (event) {
-  event.preventDefault();
-});
- -

Les navigateurs basés sur WebKit ne suivent pas les spécifications pour la boîte de dialogue. Un exemple pratiquement compatible entre les navigateurs serait à peu près comme suit:

- -
window.addEventListener("beforeunload", function (e) {
-  var confirmationMessage = "\o/";
-
-  e.returnValue = confirmationMessage;     // Gecko, Trident, Chrome 34+
-  return confirmationMessage;              // Gecko, WebKit, Chrome <34
-});
- -

Notes

- -

Quand l'événement retourne une valeur non nulle, l'utilisateur est invité à confirmer le déchargement de la page. Dans la plupart des navigateurs, la valeur de retour de l'événement est affiché dans une boîte de dialogue. Dans Firefox 4 et plus, la chaine de caractères retournée n'est pas affiché à l'utilisateur. A la place, Firefox affiche "Cette page demande de confirmer sa fermeture ; des données saisies pourraient ne pas être enregistrées". Voir {{bug("588292")}}.

- -

Depuis le 25 Mai 2011, la spécification HTML5 indique ques les appels aux méthodes {{domxref("window.alert()")}}, {{domxref("window.confirm()")}} et {{domxref("window.prompt()")}} peuvent être ignorés durant l'événement. Voir specification HTML5 pour plus de détails.

- -

Noter aussi que de nombreux navigateurs ignorent le résultat  de l'événement (il n'y a donc aucune demande de confirmation). Firefox a une préférence cachée dans about:config pour faire de même. Essentiellement, cela signifie que l'utilisateur confirme toujours silencieusement que le document peut être déchargé.

- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName("HTML WHATWG", "indices.html#event-beforeunload", "beforeunload")}}{{Spec2("HTML WHATWG")}}
{{SpecName("HTML5 W3C", "browsers.html#unloading-documents", "beforeunload")}}{{Spec2("HTML5 W3C")}}Première définition
- -

Voir aussi

- - diff --git a/files/fr/web/api/window/beforeunload_event/index.md b/files/fr/web/api/window/beforeunload_event/index.md new file mode 100644 index 0000000000..249644f9e3 --- /dev/null +++ b/files/fr/web/api/window/beforeunload_event/index.md @@ -0,0 +1,140 @@ +--- +title: beforeunload +slug: Web/API/Window/beforeunload_event +translation_of: Web/API/Window/beforeunload_event +original_slug: Web/Events/beforeunload +--- +

L'événement beforeunload est déclenché quand la fênetre, ou le document, et leurs resources sont sur le point d'être déchargés.

+ +

Lorsqu'une chaîne de caractères est assignée à la propriété returnValue de {{domxref("Event")}}, une boîte de dialogue apparaît demandant confirmation avant de quitter la page (voir exemple plus bas). Certains navigateurs affichent la valeur retournée, alors que d'autres affichent leur propre message. Si aucune valeur n'est fournie, l'événement est traité silencieusement.

+ +
+

Note : Afin d'éviter les "pop-ups" indésirables, les navigateurs peuvent ne pas afficher les alertes créées dans les gestionnaires beforeunload.

+
+ +
+

Attention : Attacher un gestionnaire d'événement beforeunload à window ou à document empêche les navigateurs d'utiliser leur mémoire cache ; consulter Utilisation du cache de Firefox 1.5 ou WebKit's Page Cache (en anglais).

+
+ + + + + + + + + + + + + + + + + + + + +
PropagationNon
AnnulableOui
Object cibledefaultView
Interface{{domxref("Event")}}
+ +

Propriétés

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
PropriétéTypeDescription
target {{readOnlyInline}}{{domxref("EventTarget")}}La cible de l'événement (la plus haute cible dans l'arbre du DOM).
type {{readOnlyInline}}{{domxref("DOMString")}}Le type de l'événement.
bubbles {{readOnlyInline}}{{jsxref("Boolean")}}Est-ce que l'événement se propage ?
cancelable {{readOnlyInline}}{{jsxref("Boolean")}}Est-il possible d'annuler l'événement ?
returnValue{{domxref("DOMString")}}La valeur de retour de l'événement (le message à afficher à l'utlisateur)
+ +

Exemples

+ +
window.addEventListener("beforeunload", function (event) {
+  event.returnValue = "\o/";
+});
+
+// est équivalent à
+window.addEventListener("beforeunload", function (event) {
+  event.preventDefault();
+});
+ +

Les navigateurs basés sur WebKit ne suivent pas les spécifications pour la boîte de dialogue. Un exemple pratiquement compatible entre les navigateurs serait à peu près comme suit:

+ +
window.addEventListener("beforeunload", function (e) {
+  var confirmationMessage = "\o/";
+
+  e.returnValue = confirmationMessage;     // Gecko, Trident, Chrome 34+
+  return confirmationMessage;              // Gecko, WebKit, Chrome <34
+});
+ +

Notes

+ +

Quand l'événement retourne une valeur non nulle, l'utilisateur est invité à confirmer le déchargement de la page. Dans la plupart des navigateurs, la valeur de retour de l'événement est affiché dans une boîte de dialogue. Dans Firefox 4 et plus, la chaine de caractères retournée n'est pas affiché à l'utilisateur. A la place, Firefox affiche "Cette page demande de confirmer sa fermeture ; des données saisies pourraient ne pas être enregistrées". Voir {{bug("588292")}}.

+ +

Depuis le 25 Mai 2011, la spécification HTML5 indique ques les appels aux méthodes {{domxref("window.alert()")}}, {{domxref("window.confirm()")}} et {{domxref("window.prompt()")}} peuvent être ignorés durant l'événement. Voir specification HTML5 pour plus de détails.

+ +

Noter aussi que de nombreux navigateurs ignorent le résultat  de l'événement (il n'y a donc aucune demande de confirmation). Firefox a une préférence cachée dans about:config pour faire de même. Essentiellement, cela signifie que l'utilisateur confirme toujours silencieusement que le document peut être déchargé.

+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName("HTML WHATWG", "indices.html#event-beforeunload", "beforeunload")}}{{Spec2("HTML WHATWG")}}
{{SpecName("HTML5 W3C", "browsers.html#unloading-documents", "beforeunload")}}{{Spec2("HTML5 W3C")}}Première définition
+ +

Voir aussi

+ + diff --git a/files/fr/web/api/window/blur/index.html b/files/fr/web/api/window/blur/index.html deleted file mode 100644 index 75091cf2a6..0000000000 --- a/files/fr/web/api/window/blur/index.html +++ /dev/null @@ -1,46 +0,0 @@ ---- -title: Window.blur() -slug: Web/API/Window/blur -tags: - - API - - DOM - - Gecko - - Méthode -translation_of: Web/API/Window/blur ---- -

{{APIRef}}

- -

Éloigne la mise au point de la fenêtre.

- -

Syntaxe

- -
window.blur()
- -

Exemple

- -
window.blur();
- -

Notes

- -

La méthode window.blur() est l'équivalent programmatique du déplacement du focus de l'utilisateur loin de la fenêtre courante.

- -

Spécification

- - - - - - - - - - - - - - -
SpécificationStatutCommentair
{{SpecName('HTML WHATWG','interaction.html#dom-window-blur','Window.blur()')}}{{Spec2('HTML WHATWG')}}
- -

Compatibilité des navigateurs

- -

{{Compat("api.Window.blur")}}

diff --git a/files/fr/web/api/window/blur/index.md b/files/fr/web/api/window/blur/index.md new file mode 100644 index 0000000000..75091cf2a6 --- /dev/null +++ b/files/fr/web/api/window/blur/index.md @@ -0,0 +1,46 @@ +--- +title: Window.blur() +slug: Web/API/Window/blur +tags: + - API + - DOM + - Gecko + - Méthode +translation_of: Web/API/Window/blur +--- +

{{APIRef}}

+ +

Éloigne la mise au point de la fenêtre.

+ +

Syntaxe

+ +
window.blur()
+ +

Exemple

+ +
window.blur();
+ +

Notes

+ +

La méthode window.blur() est l'équivalent programmatique du déplacement du focus de l'utilisateur loin de la fenêtre courante.

+ +

Spécification

+ + + + + + + + + + + + + + +
SpécificationStatutCommentair
{{SpecName('HTML WHATWG','interaction.html#dom-window-blur','Window.blur()')}}{{Spec2('HTML WHATWG')}}
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Window.blur")}}

diff --git a/files/fr/web/api/window/cancelanimationframe/index.html b/files/fr/web/api/window/cancelanimationframe/index.html deleted file mode 100644 index a0c27fc7eb..0000000000 --- a/files/fr/web/api/window/cancelanimationframe/index.html +++ /dev/null @@ -1,77 +0,0 @@ ---- -title: window.cancelAnimationFrame() -slug: Web/API/Window/cancelAnimationFrame -tags: - - API - - Animation - - DOM - - Experimental - - Méthode - - Reference - - Window -translation_of: Web/API/Window/cancelAnimationFrame ---- -
{{APIRef}}
- -
La méthode window.cancelAnimationFrame() met fin à une animation précédement configurée par un appel à {{domxref("window.requestAnimationFrame()")}}.
- -

Syntaxe

- -
window.cancelAnimationFrame(requestID);
- -

Paramètres

- -
-
requestID
-
L'identifiant retourné par l'appel à {{domxref("window.requestAnimationFrame()")}} qui a généré la fonction de rappel (callback)
-
- -

Exemples

- -
var requestAnimationFrame = window.requestAnimationFrame || window.mozRequestAnimationFrame ||
-                            window.webkitRequestAnimationFrame || window.msRequestAnimationFrame;
-
-var cancelAnimationFrame = window.cancelAnimationFrame || window.mozCancelAnimationFrame;
-
-var start = window.mozAnimationStartTime;  // Seulement supporté par Firefox. Les autre navigateurs peuvent utiliser quelque chose comme Date.now()..
-
-var myReq; // Déclarer la variable globalement avant de lancer l'animation
-
-function step(timestamp) {
-  var progress = timestamp - start;
-  d.style.left = Math.min(progress / 10, 200) + 'px';
-  if (progress < 2000) {
-    // Ne pas oublier de récupérer l'identifiant à chaque appel de la fonction
-    myReq = requestAnimationFrame(step);
-  }
-}
-myReq = requestAnimationFrame(step);
-// L'annulation utilise le dernier identifiant
-cancelAnimationFrame(myReq);
-
- -

Spécifications

- - - - - - - - - - - - -
Spécification
{{spec("https://www.w3.org/TR/html51/webappapis.html#animation-frames", "Timing control for script-based animations: cancelAnimationFrame", "WD")}}
- -

Compatibilité des navigateurs

- -

{{Compat("api.Window.cancelAnimationFrame")}}

- -

Voir aussi

- - diff --git a/files/fr/web/api/window/cancelanimationframe/index.md b/files/fr/web/api/window/cancelanimationframe/index.md new file mode 100644 index 0000000000..a0c27fc7eb --- /dev/null +++ b/files/fr/web/api/window/cancelanimationframe/index.md @@ -0,0 +1,77 @@ +--- +title: window.cancelAnimationFrame() +slug: Web/API/Window/cancelAnimationFrame +tags: + - API + - Animation + - DOM + - Experimental + - Méthode + - Reference + - Window +translation_of: Web/API/Window/cancelAnimationFrame +--- +
{{APIRef}}
+ +
La méthode window.cancelAnimationFrame() met fin à une animation précédement configurée par un appel à {{domxref("window.requestAnimationFrame()")}}.
+ +

Syntaxe

+ +
window.cancelAnimationFrame(requestID);
+ +

Paramètres

+ +
+
requestID
+
L'identifiant retourné par l'appel à {{domxref("window.requestAnimationFrame()")}} qui a généré la fonction de rappel (callback)
+
+ +

Exemples

+ +
var requestAnimationFrame = window.requestAnimationFrame || window.mozRequestAnimationFrame ||
+                            window.webkitRequestAnimationFrame || window.msRequestAnimationFrame;
+
+var cancelAnimationFrame = window.cancelAnimationFrame || window.mozCancelAnimationFrame;
+
+var start = window.mozAnimationStartTime;  // Seulement supporté par Firefox. Les autre navigateurs peuvent utiliser quelque chose comme Date.now()..
+
+var myReq; // Déclarer la variable globalement avant de lancer l'animation
+
+function step(timestamp) {
+  var progress = timestamp - start;
+  d.style.left = Math.min(progress / 10, 200) + 'px';
+  if (progress < 2000) {
+    // Ne pas oublier de récupérer l'identifiant à chaque appel de la fonction
+    myReq = requestAnimationFrame(step);
+  }
+}
+myReq = requestAnimationFrame(step);
+// L'annulation utilise le dernier identifiant
+cancelAnimationFrame(myReq);
+
+ +

Spécifications

+ + + + + + + + + + + + +
Spécification
{{spec("https://www.w3.org/TR/html51/webappapis.html#animation-frames", "Timing control for script-based animations: cancelAnimationFrame", "WD")}}
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Window.cancelAnimationFrame")}}

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/window/cancelidlecallback/index.html b/files/fr/web/api/window/cancelidlecallback/index.html deleted file mode 100644 index 39c94deb9a..0000000000 --- a/files/fr/web/api/window/cancelidlecallback/index.html +++ /dev/null @@ -1,40 +0,0 @@ ---- -title: window.cancelIdleCallback() -slug: Web/API/Window/cancelIdleCallback -translation_of: Web/API/Window/cancelIdleCallback ---- -
{{APIRef}}{{SeeCompatTable}}
- -

La méthode window.cancelIdleCallback() annule une fonction précedemment planifiée via {{domxref("window.requestIdleCallback()")}}.

- -

Syntaxe

- -
window.cancelIdleCallback(idleCallbackId);
- -

Paramètres

- -
-
idleCallbackId
-
L'entier long non-signé retourné par {{domxref("window.requestIdleCallback()")}}.
-
- -

Spécifications

- - - - - - - - - - - - - - -
SpécificationStatusCommentaire
{{SpecName('Background Tasks')}}{{Spec2('Background Tasks')}}Définition initiale.
- -

Compatibilité des navigateurs

- -

{{Compat("api.Window.cancelIdleCallback")}}

diff --git a/files/fr/web/api/window/cancelidlecallback/index.md b/files/fr/web/api/window/cancelidlecallback/index.md new file mode 100644 index 0000000000..39c94deb9a --- /dev/null +++ b/files/fr/web/api/window/cancelidlecallback/index.md @@ -0,0 +1,40 @@ +--- +title: window.cancelIdleCallback() +slug: Web/API/Window/cancelIdleCallback +translation_of: Web/API/Window/cancelIdleCallback +--- +
{{APIRef}}{{SeeCompatTable}}
+ +

La méthode window.cancelIdleCallback() annule une fonction précedemment planifiée via {{domxref("window.requestIdleCallback()")}}.

+ +

Syntaxe

+ +
window.cancelIdleCallback(idleCallbackId);
+ +

Paramètres

+ +
+
idleCallbackId
+
L'entier long non-signé retourné par {{domxref("window.requestIdleCallback()")}}.
+
+ +

Spécifications

+ + + + + + + + + + + + + + +
SpécificationStatusCommentaire
{{SpecName('Background Tasks')}}{{Spec2('Background Tasks')}}Définition initiale.
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Window.cancelIdleCallback")}}

diff --git a/files/fr/web/api/window/captureevents/index.html b/files/fr/web/api/window/captureevents/index.html deleted file mode 100644 index cac350b130..0000000000 --- a/files/fr/web/api/window/captureevents/index.html +++ /dev/null @@ -1,57 +0,0 @@ ---- -title: Window.captureEvents() -slug: Web/API/Window/captureEvents -tags: - - API - - Gecko - - HTML DOM - - Méthode - - Non-standard -translation_of: Web/API/Window/captureEvents ---- -
{{ ApiRef() }} {{deprecated_header(1.9)}} {{Non-standard_header}}
- -

La méthode Window.captureEvents() enregistre la fenêtre pour capturer tous les événements du type spécifié.

- -

Syntaxe

- -
window.captureEvents(eventType)
-
- -

eventType est une combinaison des valeurs suivantes: Event.ABORT, Event.BLUR, Event.CLICK, Event.CHANGE, Event.DBLCLICK, Event.DRAGDDROP, Event.ERROR, Event.FOCUS, Event.KEYDOWN, Event.KEYPRESS, Event.KEYUP, Event.LOAD, Event.MOUSEDOWN, Event.MOUSEMOVE, Event.MOUSEOUT, Event.MOUSEOVER, Event.MOUSEUP, Event.MOVE, Event.RESET, Event.RESIZE, Event.SELECT, Event.SUBMIT, Event.UNLOAD.

- -

Exemple

- -
<!DOCTYPE html>
-<html lang="fr">
-<head>
-<!-- ... -->
-<script>
-function reg() {
-  window.captureEvents(Event.CLICK);
-  window.onclick = page_click;
-}
-
-function page_click() {
-  alert('événement de clic sur la page détecté!');
-}
-</script>
-</head>
-
-<body onload="reg();">
-<p>cliquez n'importe où sur cette page.</p>
-</body>
-</html>
-
- -

Notes

- -

Les événements déclenchés dans le DOM par l'activité de l'utilisateur (tels que cliquer sur des boutons ou déplacer le focus loin du document actuel) passent généralement par la window de haut niveau et les objets de document avant d'arriver à l'objet qui a déclenché l'événement.

- -

Lorsque vous appelez la méthode captureEvents() sur window, événements du type que vous spécifier (par exemple, Event.CLICK) ne passe plus par les objets "inférieurs" de la hiérarchie. Pour que les événements "bouillonnent" comme ils le font normalement, vous devez appeler window.releaseEvents() ({{deprecated_inline}}) sur la fenêtre pour l'empêcher de piéger les événements.

- -

Notez que vous pouvez transmettre une liste d'événements à cette méthode en utilisant la syntaxe suivante : window.captureEvents(Event.KEYPRESS | Event.KEYDOWN | Event.KEYUP).

- -

Spécification

- -

Cela ne fait partie d'aucune spécification.

diff --git a/files/fr/web/api/window/captureevents/index.md b/files/fr/web/api/window/captureevents/index.md new file mode 100644 index 0000000000..cac350b130 --- /dev/null +++ b/files/fr/web/api/window/captureevents/index.md @@ -0,0 +1,57 @@ +--- +title: Window.captureEvents() +slug: Web/API/Window/captureEvents +tags: + - API + - Gecko + - HTML DOM + - Méthode + - Non-standard +translation_of: Web/API/Window/captureEvents +--- +
{{ ApiRef() }} {{deprecated_header(1.9)}} {{Non-standard_header}}
+ +

La méthode Window.captureEvents() enregistre la fenêtre pour capturer tous les événements du type spécifié.

+ +

Syntaxe

+ +
window.captureEvents(eventType)
+
+ +

eventType est une combinaison des valeurs suivantes: Event.ABORT, Event.BLUR, Event.CLICK, Event.CHANGE, Event.DBLCLICK, Event.DRAGDDROP, Event.ERROR, Event.FOCUS, Event.KEYDOWN, Event.KEYPRESS, Event.KEYUP, Event.LOAD, Event.MOUSEDOWN, Event.MOUSEMOVE, Event.MOUSEOUT, Event.MOUSEOVER, Event.MOUSEUP, Event.MOVE, Event.RESET, Event.RESIZE, Event.SELECT, Event.SUBMIT, Event.UNLOAD.

+ +

Exemple

+ +
<!DOCTYPE html>
+<html lang="fr">
+<head>
+<!-- ... -->
+<script>
+function reg() {
+  window.captureEvents(Event.CLICK);
+  window.onclick = page_click;
+}
+
+function page_click() {
+  alert('événement de clic sur la page détecté!');
+}
+</script>
+</head>
+
+<body onload="reg();">
+<p>cliquez n'importe où sur cette page.</p>
+</body>
+</html>
+
+ +

Notes

+ +

Les événements déclenchés dans le DOM par l'activité de l'utilisateur (tels que cliquer sur des boutons ou déplacer le focus loin du document actuel) passent généralement par la window de haut niveau et les objets de document avant d'arriver à l'objet qui a déclenché l'événement.

+ +

Lorsque vous appelez la méthode captureEvents() sur window, événements du type que vous spécifier (par exemple, Event.CLICK) ne passe plus par les objets "inférieurs" de la hiérarchie. Pour que les événements "bouillonnent" comme ils le font normalement, vous devez appeler window.releaseEvents() ({{deprecated_inline}}) sur la fenêtre pour l'empêcher de piéger les événements.

+ +

Notez que vous pouvez transmettre une liste d'événements à cette méthode en utilisant la syntaxe suivante : window.captureEvents(Event.KEYPRESS | Event.KEYDOWN | Event.KEYUP).

+ +

Spécification

+ +

Cela ne fait partie d'aucune spécification.

diff --git a/files/fr/web/api/window/clearimmediate/index.html b/files/fr/web/api/window/clearimmediate/index.html deleted file mode 100644 index 886d10eb4f..0000000000 --- a/files/fr/web/api/window/clearimmediate/index.html +++ /dev/null @@ -1,65 +0,0 @@ ---- -title: Window.clearImmediate() -slug: Web/API/Window/clearImmediate -tags: - - API - - HTML DOM - - Méthode - - Window -translation_of: Web/API/Window/clearImmediate ---- -

{{APIRef("HTML DOM")}}{{Non-standard_header}}

- -

Cette méthode efface l'action spécifiée par {{DOMxRef("window.setImmediate")}}.

- -
-

Note : Cette méthode ne devrait pas devenir standard et n'est implémentée que par les versions récentes d'Internet Explorer et de Node.js 0.10+. Il rencontre la résistance à la fois de Gecko (Firefox) et Webkit (Google/Apple).

-
- -

Syntaxe

- -
window.clearImmediate( immediateID )
-
- -

où immediateID est un ID retourné par {{DOMxRef("window.setImmediate")}}.

- -

Exemples

- -
let immediateID = setImmediate(() => {
-  // Exécute du code
-}
-
-document.getElementById("bouton")
-  .addEventListener(() => {
-  clearImmediate(immediateID);
-});
-
- -

Spécifications

- - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
Efficient Script Yielding La définition de setImmediate dans cette spécification.Editor's DraftInitial definition.
- -

Compatibilité des navigateurs

- -

{{Compat("api.Window.clearImmediate")}}

- -

Voir également

- - diff --git a/files/fr/web/api/window/clearimmediate/index.md b/files/fr/web/api/window/clearimmediate/index.md new file mode 100644 index 0000000000..886d10eb4f --- /dev/null +++ b/files/fr/web/api/window/clearimmediate/index.md @@ -0,0 +1,65 @@ +--- +title: Window.clearImmediate() +slug: Web/API/Window/clearImmediate +tags: + - API + - HTML DOM + - Méthode + - Window +translation_of: Web/API/Window/clearImmediate +--- +

{{APIRef("HTML DOM")}}{{Non-standard_header}}

+ +

Cette méthode efface l'action spécifiée par {{DOMxRef("window.setImmediate")}}.

+ +
+

Note : Cette méthode ne devrait pas devenir standard et n'est implémentée que par les versions récentes d'Internet Explorer et de Node.js 0.10+. Il rencontre la résistance à la fois de Gecko (Firefox) et Webkit (Google/Apple).

+
+ +

Syntaxe

+ +
window.clearImmediate( immediateID )
+
+ +

où immediateID est un ID retourné par {{DOMxRef("window.setImmediate")}}.

+ +

Exemples

+ +
let immediateID = setImmediate(() => {
+  // Exécute du code
+}
+
+document.getElementById("bouton")
+  .addEventListener(() => {
+  clearImmediate(immediateID);
+});
+
+ +

Spécifications

+ + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
Efficient Script Yielding La définition de setImmediate dans cette spécification.Editor's DraftInitial definition.
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Window.clearImmediate")}}

+ +

Voir également

+ + diff --git a/files/fr/web/api/window/close/index.html b/files/fr/web/api/window/close/index.html deleted file mode 100644 index b5ea2c278c..0000000000 --- a/files/fr/web/api/window/close/index.html +++ /dev/null @@ -1,46 +0,0 @@ ---- -title: window.close -slug: Web/API/Window/close -tags: - - Référence_du_DOM_Gecko -translation_of: Web/API/Window/close ---- -

{{ ApiRef() }}

-

Résumé

-

Ferme la fenêtre référencée.

-

Syntaxe

-
window.close();
-
-

Description

-

Lorsque cette méthode est appelée, la fenêtre référencée est fermée.

-

Cette méthode est uniquement autorisée à être appelée pour des fenêtres qui ont été ouvertes par un script à l'aide de la méthode window.open. Si la fenêtre n'a pas été ouverte par un script, l'erreur suivante apparaît dans la console JavaScript : Scripts may not close windows that were not opened by script.

-

Exemples

-
Fermeture d'une fenêtre ouverte avec window.open()
-
<script type="text/javascript">
-// Variable globale pour stocker une référence vers la fenêtre ouverte
-var fenetreOuverte;
-
-function ouvrirFenetre()
-{
-  fenetreOuverte = window.open('details.html');
-}
-function fermerFenetreOuverte()
-{
-  fenetreOuverte.close();
-}
-</script>
-
-
Fermeture de la fenêtre courante
-
<script type="text/javascript">
-function fermerFenetreCourante()
-{
-  window.close();
-}
-</script>
-
-

Spécification

-

DOM Level 0. window.close() ne fait partie d'aucune spécification ni recommandation technique du W3C.

-

Référence additionnelle

- \ No newline at end of file diff --git a/files/fr/web/api/window/close/index.md b/files/fr/web/api/window/close/index.md new file mode 100644 index 0000000000..b5ea2c278c --- /dev/null +++ b/files/fr/web/api/window/close/index.md @@ -0,0 +1,46 @@ +--- +title: window.close +slug: Web/API/Window/close +tags: + - Référence_du_DOM_Gecko +translation_of: Web/API/Window/close +--- +

{{ ApiRef() }}

+

Résumé

+

Ferme la fenêtre référencée.

+

Syntaxe

+
window.close();
+
+

Description

+

Lorsque cette méthode est appelée, la fenêtre référencée est fermée.

+

Cette méthode est uniquement autorisée à être appelée pour des fenêtres qui ont été ouvertes par un script à l'aide de la méthode window.open. Si la fenêtre n'a pas été ouverte par un script, l'erreur suivante apparaît dans la console JavaScript : Scripts may not close windows that were not opened by script.

+

Exemples

+
Fermeture d'une fenêtre ouverte avec window.open()
+
<script type="text/javascript">
+// Variable globale pour stocker une référence vers la fenêtre ouverte
+var fenetreOuverte;
+
+function ouvrirFenetre()
+{
+  fenetreOuverte = window.open('details.html');
+}
+function fermerFenetreOuverte()
+{
+  fenetreOuverte.close();
+}
+</script>
+
+
Fermeture de la fenêtre courante
+
<script type="text/javascript">
+function fermerFenetreCourante()
+{
+  window.close();
+}
+</script>
+
+

Spécification

+

DOM Level 0. window.close() ne fait partie d'aucune spécification ni recommandation technique du W3C.

+

Référence additionnelle

+ \ No newline at end of file diff --git a/files/fr/web/api/window/closed/index.html b/files/fr/web/api/window/closed/index.html deleted file mode 100644 index e01f35054b..0000000000 --- a/files/fr/web/api/window/closed/index.html +++ /dev/null @@ -1,55 +0,0 @@ ---- -title: window.closed -slug: Web/API/Window/closed -tags: - - Référence_du_DOM_Gecko -translation_of: Web/API/Window/closed ---- -

{{ ApiRef() }}

-

Résumé

-

Cette propriété indique si la fenêtre référencée est fermée ou non.

-

Syntaxe

-
isClosed = window.closed;
-
-

Cette propriété est en lecture seule.

-

Valeur renvoyée

-
-
- isClosed
-
- Un booléen. Les valeurs possibles sont :
-
- -

Exemples

-

Chargement d'une page dans la fenêtre principale depuis un popup

-

L'exemple suivant montre comment un popup peut transmettre un choix de l'utilisateur à la fenêtre principale en y ouvrant une URL différente. Mais il faut d'abord vérifier que la fenêtre principale et encore ouverte.

-
if (!window.opener.closed) {
-  // La fenêtre principale est encore là,
-  // on peut donc y charger une autre page
-  window.opener.location.href = newURL;
-}
-
-

Appel d'une fonction dans un popup ouvert précédemment

-

Dans cette exemple, la fonction refreshPopupWindow() appelle une fonction dans le popup pour rafraichir son contenu. Cependant, si le popup n'a pas encore été ouvert ou si l'utilisateur l'a fermé, un nouveau popup est ouvert.

-
var popupWindow = null;
-
-function refreshPopupWindow() {
-  if (popupWindow && !popupWindow.closed) {
-    // Le popup a déjà été ouvert et il l'est encore.
-    // On peut donc appeler sa fonction doRefresh().
-    popupWindow.doRefresh();
-  } else {
-    // Il est nécessaire d'ouvrir d'abord le popup.
-    popupWindow = window.open("popup.html");
-  }
-}
-
-

Spécification

-

DOM Level 0. window.closed ne fait partie d'aucune spécification ou recommandation technique du W3C.

-

Référence supplémentaire

- \ No newline at end of file diff --git a/files/fr/web/api/window/closed/index.md b/files/fr/web/api/window/closed/index.md new file mode 100644 index 0000000000..e01f35054b --- /dev/null +++ b/files/fr/web/api/window/closed/index.md @@ -0,0 +1,55 @@ +--- +title: window.closed +slug: Web/API/Window/closed +tags: + - Référence_du_DOM_Gecko +translation_of: Web/API/Window/closed +--- +

{{ ApiRef() }}

+

Résumé

+

Cette propriété indique si la fenêtre référencée est fermée ou non.

+

Syntaxe

+
isClosed = window.closed;
+
+

Cette propriété est en lecture seule.

+

Valeur renvoyée

+
+
+ isClosed
+
+ Un booléen. Les valeurs possibles sont :
+
+ +

Exemples

+

Chargement d'une page dans la fenêtre principale depuis un popup

+

L'exemple suivant montre comment un popup peut transmettre un choix de l'utilisateur à la fenêtre principale en y ouvrant une URL différente. Mais il faut d'abord vérifier que la fenêtre principale et encore ouverte.

+
if (!window.opener.closed) {
+  // La fenêtre principale est encore là,
+  // on peut donc y charger une autre page
+  window.opener.location.href = newURL;
+}
+
+

Appel d'une fonction dans un popup ouvert précédemment

+

Dans cette exemple, la fonction refreshPopupWindow() appelle une fonction dans le popup pour rafraichir son contenu. Cependant, si le popup n'a pas encore été ouvert ou si l'utilisateur l'a fermé, un nouveau popup est ouvert.

+
var popupWindow = null;
+
+function refreshPopupWindow() {
+  if (popupWindow && !popupWindow.closed) {
+    // Le popup a déjà été ouvert et il l'est encore.
+    // On peut donc appeler sa fonction doRefresh().
+    popupWindow.doRefresh();
+  } else {
+    // Il est nécessaire d'ouvrir d'abord le popup.
+    popupWindow = window.open("popup.html");
+  }
+}
+
+

Spécification

+

DOM Level 0. window.closed ne fait partie d'aucune spécification ou recommandation technique du W3C.

+

Référence supplémentaire

+ \ No newline at end of file diff --git a/files/fr/web/api/window/confirm/index.html b/files/fr/web/api/window/confirm/index.html deleted file mode 100644 index bed8eb3463..0000000000 --- a/files/fr/web/api/window/confirm/index.html +++ /dev/null @@ -1,47 +0,0 @@ ---- -title: window.confirm -slug: Web/API/Window/confirm -tags: - - DOM - - DOM_0 -translation_of: Web/API/Window/confirm ---- -

{{ApiRef("Window")}}

- -

Résumé

- -

Affiche un dialogue modal avec un message et deux boutons, OK et Annuler.

- -

Syntaxe

- -
resultat = window.confirm(message);
-
- - - -

Exemple

- -
if (window.confirm("Une nouvelle fenêtre va s'ouvrir.")) {
-    window.open("fenetre.html", "Nouvelle fenêtre", "");
-}
-
- -

Notes

- -

Le texte suivant est commun à cet article, DOM:window.prompt et DOM:window.confirm Les boîtes de dialogue sont des fenêtres modales : elles empêchent l'utilisateur d'accéder au reste de l'interface du programme tant qu'elles ne sont pas fermées. C'est pourquoi il ne faut pas abuser des fonctions créant une boîte de dialogue (ou fenêtre modale).

- -

Les applications utilisant le chrome (par exemple les extensions) devront plutôt utiliser les méthodes de nsIPromptService.

- -

Spécification

- -

{{ DOM0() }}

- -

Voir aussi

- - \ No newline at end of file diff --git a/files/fr/web/api/window/confirm/index.md b/files/fr/web/api/window/confirm/index.md new file mode 100644 index 0000000000..bed8eb3463 --- /dev/null +++ b/files/fr/web/api/window/confirm/index.md @@ -0,0 +1,47 @@ +--- +title: window.confirm +slug: Web/API/Window/confirm +tags: + - DOM + - DOM_0 +translation_of: Web/API/Window/confirm +--- +

{{ApiRef("Window")}}

+ +

Résumé

+ +

Affiche un dialogue modal avec un message et deux boutons, OK et Annuler.

+ +

Syntaxe

+ +
resultat = window.confirm(message);
+
+ + + +

Exemple

+ +
if (window.confirm("Une nouvelle fenêtre va s'ouvrir.")) {
+    window.open("fenetre.html", "Nouvelle fenêtre", "");
+}
+
+ +

Notes

+ +

Le texte suivant est commun à cet article, DOM:window.prompt et DOM:window.confirm Les boîtes de dialogue sont des fenêtres modales : elles empêchent l'utilisateur d'accéder au reste de l'interface du programme tant qu'elles ne sont pas fermées. C'est pourquoi il ne faut pas abuser des fonctions créant une boîte de dialogue (ou fenêtre modale).

+ +

Les applications utilisant le chrome (par exemple les extensions) devront plutôt utiliser les méthodes de nsIPromptService.

+ +

Spécification

+ +

{{ DOM0() }}

+ +

Voir aussi

+ + \ No newline at end of file diff --git a/files/fr/web/api/window/console/index.html b/files/fr/web/api/window/console/index.html deleted file mode 100644 index cbb2e643a9..0000000000 --- a/files/fr/web/api/window/console/index.html +++ /dev/null @@ -1,56 +0,0 @@ ---- -title: Window.console -slug: Web/API/Window/console -tags: - - API - - Propriété - - Reference - - Window - - console - - lecture seule -translation_of: Web/API/Window/console ---- -

{{ APIRef }}

- -

La propriété Window.console en lecture seule retourne une référence à l'objet {{domxref("Console")}}, qui founit des méthodes pour afficher des information sur la console du navigateur. Ces méthodes ont pour seul but le débogage et ne devraient pas servir à présenter des informations au utilisateurs.

- -

Syntaxe

- -
var consoleObj = window.console;
-
- -

Exemples

- -

Afficher dans la console

- -

Le premier exemple affiche du texte dans la console.

- -
console.log("An error occurred while loading the content");
-
- -

L'exemple suivant affiche un objet dans la console, et les champs de l'objet y sont écrit:

- -
console.dir(someObject);
- -

Voir {{SectionOnPage("/en-US/docs/Web/API/Console", "Usage")}} pour plus d'exemples appronfondit.

- -

Spécifications

- - - - - - - - - - - - - - -
SpécificationStatusCommentaire
{{SpecName('Console API')}}{{Spec2('Console API')}}Définition Initiale.
- -
-

Note : Actuellement il y a beaucoup de différences d'implémentation entre les navigateurs, mais ils sont en train d'être standardisés pour les rendre plus consistants entre eux.

-
diff --git a/files/fr/web/api/window/console/index.md b/files/fr/web/api/window/console/index.md new file mode 100644 index 0000000000..cbb2e643a9 --- /dev/null +++ b/files/fr/web/api/window/console/index.md @@ -0,0 +1,56 @@ +--- +title: Window.console +slug: Web/API/Window/console +tags: + - API + - Propriété + - Reference + - Window + - console + - lecture seule +translation_of: Web/API/Window/console +--- +

{{ APIRef }}

+ +

La propriété Window.console en lecture seule retourne une référence à l'objet {{domxref("Console")}}, qui founit des méthodes pour afficher des information sur la console du navigateur. Ces méthodes ont pour seul but le débogage et ne devraient pas servir à présenter des informations au utilisateurs.

+ +

Syntaxe

+ +
var consoleObj = window.console;
+
+ +

Exemples

+ +

Afficher dans la console

+ +

Le premier exemple affiche du texte dans la console.

+ +
console.log("An error occurred while loading the content");
+
+ +

L'exemple suivant affiche un objet dans la console, et les champs de l'objet y sont écrit:

+ +
console.dir(someObject);
+ +

Voir {{SectionOnPage("/en-US/docs/Web/API/Console", "Usage")}} pour plus d'exemples appronfondit.

+ +

Spécifications

+ + + + + + + + + + + + + + +
SpécificationStatusCommentaire
{{SpecName('Console API')}}{{Spec2('Console API')}}Définition Initiale.
+ +
+

Note : Actuellement il y a beaucoup de différences d'implémentation entre les navigateurs, mais ils sont en train d'être standardisés pour les rendre plus consistants entre eux.

+
diff --git a/files/fr/web/api/window/content/index.html b/files/fr/web/api/window/content/index.html deleted file mode 100644 index ef73a10622..0000000000 --- a/files/fr/web/api/window/content/index.html +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: window.content -slug: Web/API/Window/content -tags: - - Référence_du_DOM_Gecko -translation_of: Web/API/Window/content ---- -

{{ ApiRef() }}

-

Résumé

-

Renvoie un objet Window pour la fenêtre de contenu principale. C'est utile pour les fenêtres XUL qui ont un <browser> (ou tabbrowser ou <iframe>) avec l'attribut type="content-primary" défini - l'exemple le plus célèbre étant la fenêtre principale de Firefox, browser.xul. Dans de tels cas, content renvoie une référence à l'objet Window pour le document actuellement affiché dans le navigateur. Il s'agit d'un raccourci pour browserRef.contentWindow.

-

Dans du contenu non privilégié (des pages Web), content est normalement équivalent à top (sauf dans le cas d'une page chargée dans un panneau latéral, où content se réfère à l'objet Window de l'onglet sélectionné).

-

Certains exemples utilisent _content à la place de content. Cette forme est dépréciée depuis un long moment, et vous devriez toujours utiliser content dans du nouveau code.

-

Syntaxe

-
var windowObject = window.content;
-
-

Exemple

-

L'exécution du code suivant dans une fenêtre chrome XUL contenant un élement <browser type="content-primary"/> dessine une bordure rouge autour du premier élément div de la page actuellement affichée dans le navigateur :

-
content.document.getElementsByTagName("div")[0].style.border = "solid red 1px";
-
-

Spécification

-

Ne fait partie d'aucune spécification du W3C.

-

Voir aussi

- \ No newline at end of file diff --git a/files/fr/web/api/window/content/index.md b/files/fr/web/api/window/content/index.md new file mode 100644 index 0000000000..ef73a10622 --- /dev/null +++ b/files/fr/web/api/window/content/index.md @@ -0,0 +1,26 @@ +--- +title: window.content +slug: Web/API/Window/content +tags: + - Référence_du_DOM_Gecko +translation_of: Web/API/Window/content +--- +

{{ ApiRef() }}

+

Résumé

+

Renvoie un objet Window pour la fenêtre de contenu principale. C'est utile pour les fenêtres XUL qui ont un <browser> (ou tabbrowser ou <iframe>) avec l'attribut type="content-primary" défini - l'exemple le plus célèbre étant la fenêtre principale de Firefox, browser.xul. Dans de tels cas, content renvoie une référence à l'objet Window pour le document actuellement affiché dans le navigateur. Il s'agit d'un raccourci pour browserRef.contentWindow.

+

Dans du contenu non privilégié (des pages Web), content est normalement équivalent à top (sauf dans le cas d'une page chargée dans un panneau latéral, où content se réfère à l'objet Window de l'onglet sélectionné).

+

Certains exemples utilisent _content à la place de content. Cette forme est dépréciée depuis un long moment, et vous devriez toujours utiliser content dans du nouveau code.

+

Syntaxe

+
var windowObject = window.content;
+
+

Exemple

+

L'exécution du code suivant dans une fenêtre chrome XUL contenant un élement <browser type="content-primary"/> dessine une bordure rouge autour du premier élément div de la page actuellement affichée dans le navigateur :

+
content.document.getElementsByTagName("div")[0].style.border = "solid red 1px";
+
+

Spécification

+

Ne fait partie d'aucune spécification du W3C.

+

Voir aussi

+ \ No newline at end of file diff --git a/files/fr/web/api/window/controllers/index.html b/files/fr/web/api/window/controllers/index.html deleted file mode 100644 index 9f96ce9c98..0000000000 --- a/files/fr/web/api/window/controllers/index.html +++ /dev/null @@ -1,40 +0,0 @@ ---- -title: Window.controllers -slug: Web/API/Window/controllers -tags: - - API - - HTML DOM - - NeedMarkupWork - - NeedSpecTavle - - NeedsCompatTable - - Property - - Reference - - Window -translation_of: Web/API/Window/controllers ---- -
{{APIRef}}{{non-standard_header}}
- -

Retourne les contrôleurs XUL de la fenêtre chrome.

- -

Syntaxe

- -
controleurs = window.controllers
-
- - - -

Spécification

- -

Spécifique à XUL. Ne fait pas partie de la spécification.

- -

Par défaut, le contrôleur d'une fenêtre contient le code qui prend en charge les commandes globales de la fenêtre.

- -

Le code Chrome peut ajouter des contrôleurs (à utiliser conjointement avec les fonctions goDoCommand et goUpdateCommand dans globalOverlay.js).

- -

Cependant, les contrôleurs ajoutés doivent être explicitement supprimés lorsque la fenêtre est déchargée, car cela n'est pas fait automatiquement.
- Chaque suppression manquante peut provoquer le

-bug 415775: - -
ASSERTION: XPConnect is being called on a scope without a 'Components' property!
\ No newline at end of file diff --git a/files/fr/web/api/window/controllers/index.md b/files/fr/web/api/window/controllers/index.md new file mode 100644 index 0000000000..9f96ce9c98 --- /dev/null +++ b/files/fr/web/api/window/controllers/index.md @@ -0,0 +1,40 @@ +--- +title: Window.controllers +slug: Web/API/Window/controllers +tags: + - API + - HTML DOM + - NeedMarkupWork + - NeedSpecTavle + - NeedsCompatTable + - Property + - Reference + - Window +translation_of: Web/API/Window/controllers +--- +
{{APIRef}}{{non-standard_header}}
+ +

Retourne les contrôleurs XUL de la fenêtre chrome.

+ +

Syntaxe

+ +
controleurs = window.controllers
+
+ + + +

Spécification

+ +

Spécifique à XUL. Ne fait pas partie de la spécification.

+ +

Par défaut, le contrôleur d'une fenêtre contient le code qui prend en charge les commandes globales de la fenêtre.

+ +

Le code Chrome peut ajouter des contrôleurs (à utiliser conjointement avec les fonctions goDoCommand et goUpdateCommand dans globalOverlay.js).

+ +

Cependant, les contrôleurs ajoutés doivent être explicitement supprimés lorsque la fenêtre est déchargée, car cela n'est pas fait automatiquement.
+ Chaque suppression manquante peut provoquer le

+bug 415775: + +
ASSERTION: XPConnect is being called on a scope without a 'Components' property!
\ No newline at end of file diff --git a/files/fr/web/api/window/copy_event/index.html b/files/fr/web/api/window/copy_event/index.html deleted file mode 100644 index bde3e7a47c..0000000000 --- a/files/fr/web/api/window/copy_event/index.html +++ /dev/null @@ -1,75 +0,0 @@ ---- -title: 'Window: copy event' -slug: Web/API/Window/copy_event -tags: - - API - - Clippboard API - - Copie - - Event - - Evènement - - Reference - - Window - - copy -translation_of: Web/API/Window/copy_event ---- -
{{APIRef}}
- -

L'événement copy se déclenche lorsque l'utilisateur lance une action de copie via l'interface utilisateur du nagivateur.

- - - - - - - - - - - - - - - - - - - - -
BullesOui
AnnulableOui
Interface{{domxref("ClipboardEvent")}}
Propriété de gestionnaire d'événement{{domxref("HTMLElement/oncopy", "oncopy")}}
- -

La cible d'origine de cet événement est le {{domxref ("Element")}} qui était la cible prévue de l'action de copie. Vous pouvez écouter cet événement sur l'interface {{domxref ("Window")}} pour le gérer dans les phases de capture ou de bullage. Pour plus de détails sur cet événement, veuillez consulter la page sur le Element: copy event.

- -

Exemples

- -
window.addEventListener('copy', (event) => {
-    console.log('action de copie lancée')
-});
- -

Spécifications

- - - - - - - - - - - - - - -
SpécificationStatut
{{SpecName('Clipboard API', '#clipboard-event-copy')}}{{Spec2('Clipboard API')}}
- -

Compatibilité des navigateurs

- -

{{Compat("api.Window.copy_event")}}

- -

Voir également

- - diff --git a/files/fr/web/api/window/copy_event/index.md b/files/fr/web/api/window/copy_event/index.md new file mode 100644 index 0000000000..bde3e7a47c --- /dev/null +++ b/files/fr/web/api/window/copy_event/index.md @@ -0,0 +1,75 @@ +--- +title: 'Window: copy event' +slug: Web/API/Window/copy_event +tags: + - API + - Clippboard API + - Copie + - Event + - Evènement + - Reference + - Window + - copy +translation_of: Web/API/Window/copy_event +--- +
{{APIRef}}
+ +

L'événement copy se déclenche lorsque l'utilisateur lance une action de copie via l'interface utilisateur du nagivateur.

+ + + + + + + + + + + + + + + + + + + + +
BullesOui
AnnulableOui
Interface{{domxref("ClipboardEvent")}}
Propriété de gestionnaire d'événement{{domxref("HTMLElement/oncopy", "oncopy")}}
+ +

La cible d'origine de cet événement est le {{domxref ("Element")}} qui était la cible prévue de l'action de copie. Vous pouvez écouter cet événement sur l'interface {{domxref ("Window")}} pour le gérer dans les phases de capture ou de bullage. Pour plus de détails sur cet événement, veuillez consulter la page sur le Element: copy event.

+ +

Exemples

+ +
window.addEventListener('copy', (event) => {
+    console.log('action de copie lancée')
+});
+ +

Spécifications

+ + + + + + + + + + + + + + +
SpécificationStatut
{{SpecName('Clipboard API', '#clipboard-event-copy')}}{{Spec2('Clipboard API')}}
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Window.copy_event")}}

+ +

Voir également

+ + diff --git a/files/fr/web/api/window/customelements/index.html b/files/fr/web/api/window/customelements/index.html deleted file mode 100644 index 7d7d57c203..0000000000 --- a/files/fr/web/api/window/customelements/index.html +++ /dev/null @@ -1,68 +0,0 @@ ---- -title: Window.customElements -slug: Web/API/Window/customElements -tags: - - API - - CustomElementRegistry - - Property - - Reference - - Web Components - - Window - - custom elements -translation_of: Web/API/Window/customElements ---- -
{{APIRef}}
- -

La propriété en lecture seule customElements de l'interface {{domxref("Window")}} renvoie une référence à l'objet {{domxref("CustomElementRegistry")}}, qui peut être utilisée pour enregistrer de nouveaux éléments personnalisés et obtenir des informations sur des éléments personnalisés enregistrés.

- -

Syntaxe

- -
let registreElementsPersonnalises = window.customElements;
- -

Valeur retournée

- -

Une instance d'objet {{domxref("CustomElementRegistry")}} représentant le registre des éléments personnalisés pour la fenêtre en cours.

- -

Exemples

- -

L'exemple le plus courant d'utilisation de cette propriété que vous verrez sera d'obtenir l'accès à la méthode {{domxref ("CustomElementRegistry.define()")}} pour définir et enregistrer un nouvel élément personnalisé, par exemple :

- -
let registreElementsPersonnalises = window.customElements;
-registreElementsPersonnalises.define('mon-element-personnalise', MonElementPersonnalise);
- -

Cependant, il est généralement raccourci en quelque chose comme :

- -
customElements.define('details-element',
-  class extends HTMLElement {
-    constructor() {
-      super();
-      const modele = document
-        .getElementById('modele-details-element')
-        .content;
-      const racineOmbre = this.attachShadow({mode: 'open'})
-        .appendChild(template.cloneNode(true));
-  }
-});
- -

Voir notre repo web-components-examples pour davantage d'exemples d'utilisation.

- -

Spécification

- - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName("HTML WHATWG", "custom-elements.html#dom-window-customelements", "window.customElements")}}{{Spec2("HTML WHATWG")}}Définition initiale.
- -

Compatibilité des navigateurs

- -

{{Compat("api.Window.customElements")}}

diff --git a/files/fr/web/api/window/customelements/index.md b/files/fr/web/api/window/customelements/index.md new file mode 100644 index 0000000000..7d7d57c203 --- /dev/null +++ b/files/fr/web/api/window/customelements/index.md @@ -0,0 +1,68 @@ +--- +title: Window.customElements +slug: Web/API/Window/customElements +tags: + - API + - CustomElementRegistry + - Property + - Reference + - Web Components + - Window + - custom elements +translation_of: Web/API/Window/customElements +--- +
{{APIRef}}
+ +

La propriété en lecture seule customElements de l'interface {{domxref("Window")}} renvoie une référence à l'objet {{domxref("CustomElementRegistry")}}, qui peut être utilisée pour enregistrer de nouveaux éléments personnalisés et obtenir des informations sur des éléments personnalisés enregistrés.

+ +

Syntaxe

+ +
let registreElementsPersonnalises = window.customElements;
+ +

Valeur retournée

+ +

Une instance d'objet {{domxref("CustomElementRegistry")}} représentant le registre des éléments personnalisés pour la fenêtre en cours.

+ +

Exemples

+ +

L'exemple le plus courant d'utilisation de cette propriété que vous verrez sera d'obtenir l'accès à la méthode {{domxref ("CustomElementRegistry.define()")}} pour définir et enregistrer un nouvel élément personnalisé, par exemple :

+ +
let registreElementsPersonnalises = window.customElements;
+registreElementsPersonnalises.define('mon-element-personnalise', MonElementPersonnalise);
+ +

Cependant, il est généralement raccourci en quelque chose comme :

+ +
customElements.define('details-element',
+  class extends HTMLElement {
+    constructor() {
+      super();
+      const modele = document
+        .getElementById('modele-details-element')
+        .content;
+      const racineOmbre = this.attachShadow({mode: 'open'})
+        .appendChild(template.cloneNode(true));
+  }
+});
+ +

Voir notre repo web-components-examples pour davantage d'exemples d'utilisation.

+ +

Spécification

+ + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName("HTML WHATWG", "custom-elements.html#dom-window-customelements", "window.customElements")}}{{Spec2("HTML WHATWG")}}Définition initiale.
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Window.customElements")}}

diff --git a/files/fr/web/api/window/cut_event/index.html b/files/fr/web/api/window/cut_event/index.html deleted file mode 100644 index ad3a5de15d..0000000000 --- a/files/fr/web/api/window/cut_event/index.html +++ /dev/null @@ -1,74 +0,0 @@ ---- -title: 'Window: cut event' -slug: Web/API/Window/cut_event -tags: - - API - - API Presse-papiers - - Cut - - Evènement - - Reference - - Web - - Window -translation_of: Web/API/Window/cut_event ---- -
{{APIRef}}
- -

L'événement cut est déclenché lorsque l'utilisateur a lancé une action de "cut" via l'interface utilisateur du navigateur.

- - - - - - - - - - - - - - - - - - - - -
BullesOui
AnnulableOui
Interface{{domxref("ClipboardEvent")}}
Propriété de gestionnaire d'événements{{domxref("HTMLElement/oncut", "oncut")}}
- -

La cible d'origine de cet événement est le {{domxref("Element")}} qui était la cible prévue de l'action cut. Vous pouvez écouter cet événement sur l'interface {{domxref("Window")}} pour le gérer dans les phases de capture ou de bullage. Pour plus de détails sur cet événement, veuillez consulter la page sur l'événement Element: cut event.

- -

Exemples

- -
window.addEventListener('cut', (event) => {
-    console.log('cut action initiated')
-});
- -

Spécifications

- - - - - - - - - - - - - - -
SpécificationStatut
{{SpecName('Clipboard API', '#clipboard-event-cut')}}{{Spec2('Clipboard API')}}
- -

Compatibilité des navigateurs

- -

{{Compat("api.Window.cut_event")}}

- -

Voir également

- - diff --git a/files/fr/web/api/window/cut_event/index.md b/files/fr/web/api/window/cut_event/index.md new file mode 100644 index 0000000000..ad3a5de15d --- /dev/null +++ b/files/fr/web/api/window/cut_event/index.md @@ -0,0 +1,74 @@ +--- +title: 'Window: cut event' +slug: Web/API/Window/cut_event +tags: + - API + - API Presse-papiers + - Cut + - Evènement + - Reference + - Web + - Window +translation_of: Web/API/Window/cut_event +--- +
{{APIRef}}
+ +

L'événement cut est déclenché lorsque l'utilisateur a lancé une action de "cut" via l'interface utilisateur du navigateur.

+ + + + + + + + + + + + + + + + + + + + +
BullesOui
AnnulableOui
Interface{{domxref("ClipboardEvent")}}
Propriété de gestionnaire d'événements{{domxref("HTMLElement/oncut", "oncut")}}
+ +

La cible d'origine de cet événement est le {{domxref("Element")}} qui était la cible prévue de l'action cut. Vous pouvez écouter cet événement sur l'interface {{domxref("Window")}} pour le gérer dans les phases de capture ou de bullage. Pour plus de détails sur cet événement, veuillez consulter la page sur l'événement Element: cut event.

+ +

Exemples

+ +
window.addEventListener('cut', (event) => {
+    console.log('cut action initiated')
+});
+ +

Spécifications

+ + + + + + + + + + + + + + +
SpécificationStatut
{{SpecName('Clipboard API', '#clipboard-event-cut')}}{{Spec2('Clipboard API')}}
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Window.cut_event")}}

+ +

Voir également

+ + diff --git a/files/fr/web/api/window/defaultstatus/index.html b/files/fr/web/api/window/defaultstatus/index.html deleted file mode 100644 index 125688eca6..0000000000 --- a/files/fr/web/api/window/defaultstatus/index.html +++ /dev/null @@ -1,50 +0,0 @@ ---- -title: Window.defaultStatus -slug: Web/API/Window/defaultStatus -tags: - - API - - HTML DOM - - NeedsCompatTable - - NeedsExample - - NeedsMarkupWork - - NeedsSpecTable - - Obsolete - - Propriété - - Reference - - Window -translation_of: Web/API/Window/defaultStatus ---- -

{{ obsolete_header(23) }}

- -

{{ APIRef() }}

- -

Obtient / définit le texte de la barre d'état pour la fenêtre donnée.

- -

Syntaxe

- -
var sMsg = window.defaultStatus;
-window.defaultStatus = sMsg;
-
- -

Paramètres

- - - -

Exemple

- -
<html>
- <body onload="window.defaultStatus='salut!';"/>
-  <button onclick="window.confirm('Êtes-vous sûr de vouloir quitter?');">confirmer</button>
- </body>
-</html>
-
- -

Notes

- -

Pour définir le statut une fois la fenêtre ouverte, utilisez {{domxref("window.status")}}.

- -

Spécification

- -

HTML5

diff --git a/files/fr/web/api/window/defaultstatus/index.md b/files/fr/web/api/window/defaultstatus/index.md new file mode 100644 index 0000000000..125688eca6 --- /dev/null +++ b/files/fr/web/api/window/defaultstatus/index.md @@ -0,0 +1,50 @@ +--- +title: Window.defaultStatus +slug: Web/API/Window/defaultStatus +tags: + - API + - HTML DOM + - NeedsCompatTable + - NeedsExample + - NeedsMarkupWork + - NeedsSpecTable + - Obsolete + - Propriété + - Reference + - Window +translation_of: Web/API/Window/defaultStatus +--- +

{{ obsolete_header(23) }}

+ +

{{ APIRef() }}

+ +

Obtient / définit le texte de la barre d'état pour la fenêtre donnée.

+ +

Syntaxe

+ +
var sMsg = window.defaultStatus;
+window.defaultStatus = sMsg;
+
+ +

Paramètres

+ + + +

Exemple

+ +
<html>
+ <body onload="window.defaultStatus='salut!';"/>
+  <button onclick="window.confirm('Êtes-vous sûr de vouloir quitter?');">confirmer</button>
+ </body>
+</html>
+
+ +

Notes

+ +

Pour définir le statut une fois la fenêtre ouverte, utilisez {{domxref("window.status")}}.

+ +

Spécification

+ +

HTML5

diff --git a/files/fr/web/api/window/devicemotion_event/index.html b/files/fr/web/api/window/devicemotion_event/index.html deleted file mode 100644 index aa77418513..0000000000 --- a/files/fr/web/api/window/devicemotion_event/index.html +++ /dev/null @@ -1,98 +0,0 @@ ---- -title: devicemotion -slug: Web/API/Window/devicemotion_event -translation_of: Web/API/Window/devicemotion_event -original_slug: FUEL/Window/devicemotion_event ---- -

L'événement devicemotion est déclenché à intervalles réguliers et indique la quantité de force physique d'accélération que le périphérique reçoit à ce moment. Il fournit également des informations sur le taux de rotation, si disponible.

- -

Informations générales

- -
-
Spécification
-
DeviceOrientation Event
-
Interface
-
DeviceMotionEvent
-
Propagation
-
Non
-
Annulable
-
Non
-
Cible
-
DefaultView (window)
-
Action par défaut
-
Aucune
-
- -

Propriétés

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
PropertyTypeDescription
target Lecture seule EventTargetThe event target (the topmost target in the DOM tree).
type Lecture seule DOMStringThe type of event.
bubbles Lecture seule BooleanWhether the event normally bubbles or not
cancelable Lecture seule BooleanWhether the event is cancellable or not?
acceleration Lecture seule DeviceAccelerationThe acceleration of the device. This value has taken into account the effect of gravity and removed it from the figures. This value may not exist if the hardware doesn't know how to remove gravity from the acceleration data.
accelerationIncludingGravity Lecture seule DeviceAccelerationThe acceleration of the device. This value includes the effect of gravity, and may be the only value available on devices that don't have a gyroscope to allow them to properly remove gravity from the data.
interval Lecture seule doubleThe interval, in milliseconds, at which the DeviceMotionEvent is fired. The next event will be fired in approximately this amount of time.
rotationRate Lecture seule DeviceRotationRateThe rates of rotation of the device about all three axes.
- -

Exemple

- -
function handleMotionEvent(event) {
-
-    var x = event.accelerationIncludingGravity.x;
-    var y = event.accelerationIncludingGravity.y;
-    var z = event.accelerationIncludingGravity.z;
-
-    // Faire quelque chose de génial.
-}
-
-window.addEventListener("devicemotion", handleMotionEvent, true);
-
- -

Evénements liés

- - diff --git a/files/fr/web/api/window/devicemotion_event/index.md b/files/fr/web/api/window/devicemotion_event/index.md new file mode 100644 index 0000000000..aa77418513 --- /dev/null +++ b/files/fr/web/api/window/devicemotion_event/index.md @@ -0,0 +1,98 @@ +--- +title: devicemotion +slug: Web/API/Window/devicemotion_event +translation_of: Web/API/Window/devicemotion_event +original_slug: FUEL/Window/devicemotion_event +--- +

L'événement devicemotion est déclenché à intervalles réguliers et indique la quantité de force physique d'accélération que le périphérique reçoit à ce moment. Il fournit également des informations sur le taux de rotation, si disponible.

+ +

Informations générales

+ +
+
Spécification
+
DeviceOrientation Event
+
Interface
+
DeviceMotionEvent
+
Propagation
+
Non
+
Annulable
+
Non
+
Cible
+
DefaultView (window)
+
Action par défaut
+
Aucune
+
+ +

Propriétés

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
PropertyTypeDescription
target Lecture seule EventTargetThe event target (the topmost target in the DOM tree).
type Lecture seule DOMStringThe type of event.
bubbles Lecture seule BooleanWhether the event normally bubbles or not
cancelable Lecture seule BooleanWhether the event is cancellable or not?
acceleration Lecture seule DeviceAccelerationThe acceleration of the device. This value has taken into account the effect of gravity and removed it from the figures. This value may not exist if the hardware doesn't know how to remove gravity from the acceleration data.
accelerationIncludingGravity Lecture seule DeviceAccelerationThe acceleration of the device. This value includes the effect of gravity, and may be the only value available on devices that don't have a gyroscope to allow them to properly remove gravity from the data.
interval Lecture seule doubleThe interval, in milliseconds, at which the DeviceMotionEvent is fired. The next event will be fired in approximately this amount of time.
rotationRate Lecture seule DeviceRotationRateThe rates of rotation of the device about all three axes.
+ +

Exemple

+ +
function handleMotionEvent(event) {
+
+    var x = event.accelerationIncludingGravity.x;
+    var y = event.accelerationIncludingGravity.y;
+    var z = event.accelerationIncludingGravity.z;
+
+    // Faire quelque chose de génial.
+}
+
+window.addEventListener("devicemotion", handleMotionEvent, true);
+
+ +

Evénements liés

+ + diff --git a/files/fr/web/api/window/deviceorientation_event/index.html b/files/fr/web/api/window/deviceorientation_event/index.html deleted file mode 100644 index 3978ebe617..0000000000 --- a/files/fr/web/api/window/deviceorientation_event/index.html +++ /dev/null @@ -1,84 +0,0 @@ ---- -title: 'Window : l''événement deviceorientation' -slug: Web/API/Window/deviceorientation_event -tags: - - Device Orientation API - - Sensors - - Window Event - - events -translation_of: Web/API/Window/deviceorientation_event -original_slug: FUEL/Window/deviceorientation ---- -
{{APIRef}}
- -

L'événement deviceorientation est déclenché lorsque des données sont disponibles, à partir d'un capteur d'orientation, sur l'orientation actuelle de l'appareil par rapport au cadre de coordonnées de la Terre. Ces données sont recueillies à partir d'un magnétomètre à l'intérieur de l'appareil. Voir Données d'orientation et de mouvement expliquées pour plus de détails.

- - - - - - - - - - - - - - - - - - - - -
PropagationNon
AnnulableNon
InterfaceDeviceOrientationEvent
Propriété du gestionnaire d'événementswindow.ondeviceorientation
- -

Exemple

- -
if (window.DeviceOrientationEvent) {
-  window.addEventListener("deviceorientation", function(event) {
-    // alpha : rotation autour de l'axe z
-    var rotateDegrees = event.alpha;
-    // gamma : de gauche à droite
-    var leftToRight = event.gamma;
-    // bêta : mouvement avant-arrière
-    var frontToBack = event.beta;
-
-    handleOrientationEvent(frontToBack, leftToRight, rotateDegrees);
-  }, true);
-}
-
-var handleOrientationEvent = function(frontToBack, leftToRight, rotateDegrees) {
-  // faire quelque chose d'étonnant
-};
- -

Spécifications

- - - - - - - - - - - - - - -
SpécificationStatut
{{SpecName("Device Orientation", "#deviceorientation", "l'événement DeviceOrientation")}}{{Spec2("Device Orientation")}}
- -

Compatibilité des navigateurs

- -

{{Compat("api.Window.deviceorientation_event")}}

- -

Voir aussi

- - diff --git a/files/fr/web/api/window/deviceorientation_event/index.md b/files/fr/web/api/window/deviceorientation_event/index.md new file mode 100644 index 0000000000..3978ebe617 --- /dev/null +++ b/files/fr/web/api/window/deviceorientation_event/index.md @@ -0,0 +1,84 @@ +--- +title: 'Window : l''événement deviceorientation' +slug: Web/API/Window/deviceorientation_event +tags: + - Device Orientation API + - Sensors + - Window Event + - events +translation_of: Web/API/Window/deviceorientation_event +original_slug: FUEL/Window/deviceorientation +--- +
{{APIRef}}
+ +

L'événement deviceorientation est déclenché lorsque des données sont disponibles, à partir d'un capteur d'orientation, sur l'orientation actuelle de l'appareil par rapport au cadre de coordonnées de la Terre. Ces données sont recueillies à partir d'un magnétomètre à l'intérieur de l'appareil. Voir Données d'orientation et de mouvement expliquées pour plus de détails.

+ + + + + + + + + + + + + + + + + + + + +
PropagationNon
AnnulableNon
InterfaceDeviceOrientationEvent
Propriété du gestionnaire d'événementswindow.ondeviceorientation
+ +

Exemple

+ +
if (window.DeviceOrientationEvent) {
+  window.addEventListener("deviceorientation", function(event) {
+    // alpha : rotation autour de l'axe z
+    var rotateDegrees = event.alpha;
+    // gamma : de gauche à droite
+    var leftToRight = event.gamma;
+    // bêta : mouvement avant-arrière
+    var frontToBack = event.beta;
+
+    handleOrientationEvent(frontToBack, leftToRight, rotateDegrees);
+  }, true);
+}
+
+var handleOrientationEvent = function(frontToBack, leftToRight, rotateDegrees) {
+  // faire quelque chose d'étonnant
+};
+ +

Spécifications

+ + + + + + + + + + + + + + +
SpécificationStatut
{{SpecName("Device Orientation", "#deviceorientation", "l'événement DeviceOrientation")}}{{Spec2("Device Orientation")}}
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Window.deviceorientation_event")}}

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/window/devicepixelratio/index.html b/files/fr/web/api/window/devicepixelratio/index.html deleted file mode 100644 index f7a9d3a7bf..0000000000 --- a/files/fr/web/api/window/devicepixelratio/index.html +++ /dev/null @@ -1,45 +0,0 @@ ---- -title: Window.devicePixelRatio -slug: Web/API/Window/devicePixelRatio -translation_of: Web/API/Window/devicePixelRatio ---- -

{{APIRef}}

- -

La propriété en lecture seule Window.devicePixelRatio retourne le rapport entre la taille (verticale) d'un pixel physique sur le périphérique d'affichage et la taille d'un pixel indépendant du matériel (abrégé en anglais "dips").

- -

Aucun rappel ni événement ne se déclenche lorsque la valeur change (par exemple, si vous glissez la fenêtre entre deux écrans à densités de pixels différentes).

- -

Syntaxe

- -
valeur = window.devicePixelRatio;
-
- -

Spécifications

- - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName("CSSOM View", "#dom-window-devicepixelratio", "Window.devicePixelRatio")}}{{Spec2("CSSOM View")}}Définition initiale
- -

Compatibilité des navigateurs

- -

{{Compat("api.Window.devicePixelRatio")}}

- -

Voir aussi

- - diff --git a/files/fr/web/api/window/devicepixelratio/index.md b/files/fr/web/api/window/devicepixelratio/index.md new file mode 100644 index 0000000000..f7a9d3a7bf --- /dev/null +++ b/files/fr/web/api/window/devicepixelratio/index.md @@ -0,0 +1,45 @@ +--- +title: Window.devicePixelRatio +slug: Web/API/Window/devicePixelRatio +translation_of: Web/API/Window/devicePixelRatio +--- +

{{APIRef}}

+ +

La propriété en lecture seule Window.devicePixelRatio retourne le rapport entre la taille (verticale) d'un pixel physique sur le périphérique d'affichage et la taille d'un pixel indépendant du matériel (abrégé en anglais "dips").

+ +

Aucun rappel ni événement ne se déclenche lorsque la valeur change (par exemple, si vous glissez la fenêtre entre deux écrans à densités de pixels différentes).

+ +

Syntaxe

+ +
valeur = window.devicePixelRatio;
+
+ +

Spécifications

+ + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName("CSSOM View", "#dom-window-devicepixelratio", "Window.devicePixelRatio")}}{{Spec2("CSSOM View")}}Définition initiale
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Window.devicePixelRatio")}}

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/window/dialogarguments/index.html b/files/fr/web/api/window/dialogarguments/index.html deleted file mode 100644 index 1bd4d4ece5..0000000000 --- a/files/fr/web/api/window/dialogarguments/index.html +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: Window.dialogArguments -slug: Web/API/Window/dialogArguments -tags: - - API - - Déprécié - - HTML DOM - - NeedsExample - - NeedsMarkupWork - - NeedsSpecTable - - Property - - Reference - - Window -translation_of: Web/API/Window/dialogArguments ---- -

{{ deprecated_header() }}{{APIRef}}

- -

La propriété dialogArguments renvoie les paramètres qui ont été transmis à la méthode {{domxref("window.showModalDialog()")}} method. Cela vous permet de déterminer quels paramètres ont été spécifiés lors de la boîte de dialogue modale.

- -

Syntaxe

- -
valeur = window.dialogArguments;
- -

Compatibilité des navigateurs

- -

{{Compat("api.Window.dialogArguments")}}

diff --git a/files/fr/web/api/window/dialogarguments/index.md b/files/fr/web/api/window/dialogarguments/index.md new file mode 100644 index 0000000000..1bd4d4ece5 --- /dev/null +++ b/files/fr/web/api/window/dialogarguments/index.md @@ -0,0 +1,26 @@ +--- +title: Window.dialogArguments +slug: Web/API/Window/dialogArguments +tags: + - API + - Déprécié + - HTML DOM + - NeedsExample + - NeedsMarkupWork + - NeedsSpecTable + - Property + - Reference + - Window +translation_of: Web/API/Window/dialogArguments +--- +

{{ deprecated_header() }}{{APIRef}}

+ +

La propriété dialogArguments renvoie les paramètres qui ont été transmis à la méthode {{domxref("window.showModalDialog()")}} method. Cela vous permet de déterminer quels paramètres ont été spécifiés lors de la boîte de dialogue modale.

+ +

Syntaxe

+ +
valeur = window.dialogArguments;
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Window.dialogArguments")}}

diff --git a/files/fr/web/api/window/directories/index.html b/files/fr/web/api/window/directories/index.html deleted file mode 100644 index b0255c82be..0000000000 --- a/files/fr/web/api/window/directories/index.html +++ /dev/null @@ -1,43 +0,0 @@ ---- -title: Window.directories -slug: Web/API/Window/directories -tags: - - API - - HTML DOM - - NeedsCompatTable - - NeedsExample - - NeedsMarkupWork - - NeedsSpecTable - - Obsolete - - Propriété - - Reference - - Window -translation_of: Web/API/Window/directories ---- -

{{ obsolete_header("2.0") }}

- -

{{ APIRef() }}

- -

Retourne l'objet de la barre d'outils de la barre personnelle de la fenêtre. Utilisez plutôt {{ domxref("window.personalbar") }}.

- -

Syntaxe

- -
var dirBar = window.directories;
-
- -

Paramètres

- -

dirBar est un objet du type BarProp.

- -

Exemple

- -
<script>
- function dirs() {
-  alert(window.directories);
- }
-</script>
-
- -

Spécification

- -

Ne fait pas partie des spécifications.

diff --git a/files/fr/web/api/window/directories/index.md b/files/fr/web/api/window/directories/index.md new file mode 100644 index 0000000000..b0255c82be --- /dev/null +++ b/files/fr/web/api/window/directories/index.md @@ -0,0 +1,43 @@ +--- +title: Window.directories +slug: Web/API/Window/directories +tags: + - API + - HTML DOM + - NeedsCompatTable + - NeedsExample + - NeedsMarkupWork + - NeedsSpecTable + - Obsolete + - Propriété + - Reference + - Window +translation_of: Web/API/Window/directories +--- +

{{ obsolete_header("2.0") }}

+ +

{{ APIRef() }}

+ +

Retourne l'objet de la barre d'outils de la barre personnelle de la fenêtre. Utilisez plutôt {{ domxref("window.personalbar") }}.

+ +

Syntaxe

+ +
var dirBar = window.directories;
+
+ +

Paramètres

+ +

dirBar est un objet du type BarProp.

+ +

Exemple

+ +
<script>
+ function dirs() {
+  alert(window.directories);
+ }
+</script>
+
+ +

Spécification

+ +

Ne fait pas partie des spécifications.

diff --git a/files/fr/web/api/window/document/index.html b/files/fr/web/api/window/document/index.html deleted file mode 100644 index 70769ed0b9..0000000000 --- a/files/fr/web/api/window/document/index.html +++ /dev/null @@ -1,45 +0,0 @@ ---- -title: Window.document -slug: Web/API/Window/document -tags: - - API - - HTML DOM - - Propriété - - Reference - - Window -translation_of: Web/API/Window/document ---- -
{{APIRef}}
- -

window.document renvoie une référence au document contenu dans la fenêtre.

- -

Exemple

- -
console.log(window.document.title);
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - -
SpécificationsStatutCommentaires
{{SpecName('HTML WHATWG', '#dom-document-2', 'Window.document')}}{{Spec2('HTML WHATWG')}}
{{SpecName('HTML5 W3C', 'browsers.html#dom-document-0', 'Window.document')}}{{Spec2('HTML5 W3C')}}
- -

Compatibilité des navigateurs

- -

{{Compat("api.Window.document")}}

diff --git a/files/fr/web/api/window/document/index.md b/files/fr/web/api/window/document/index.md new file mode 100644 index 0000000000..70769ed0b9 --- /dev/null +++ b/files/fr/web/api/window/document/index.md @@ -0,0 +1,45 @@ +--- +title: Window.document +slug: Web/API/Window/document +tags: + - API + - HTML DOM + - Propriété + - Reference + - Window +translation_of: Web/API/Window/document +--- +
{{APIRef}}
+ +

window.document renvoie une référence au document contenu dans la fenêtre.

+ +

Exemple

+ +
console.log(window.document.title);
+
+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + +
SpécificationsStatutCommentaires
{{SpecName('HTML WHATWG', '#dom-document-2', 'Window.document')}}{{Spec2('HTML WHATWG')}}
{{SpecName('HTML5 W3C', 'browsers.html#dom-document-0', 'Window.document')}}{{Spec2('HTML5 W3C')}}
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Window.document")}}

diff --git a/files/fr/web/api/window/domcontentloaded_event/index.html b/files/fr/web/api/window/domcontentloaded_event/index.html deleted file mode 100644 index a2e989049d..0000000000 --- a/files/fr/web/api/window/domcontentloaded_event/index.html +++ /dev/null @@ -1,81 +0,0 @@ ---- -title: DOMContentLoaded -slug: Web/API/Window/DOMContentLoaded_event -translation_of: Web/API/Window/DOMContentLoaded_event -original_slug: Web/Events/DOMContentLoaded ---- -
{{APIRef}}
- -

L’évènement DOMContentLoaded est émis lorsque le document HTML initial a été complètement chargé et analysé, sans attendre que les feuilles de style, images et sous-documents aient terminé de charger.

- - - - - - - - - - - - - - - - - - - - -
BouillonneOui
AnnulableOui (bien que spécifié comme évènement simple non annulable)
Interface{{domxref("Event")}}
Propriété de gestion de l’évènementAucune
- -

La cible originale pour cet évènement est le {{domxref("Document")}} qui a terminé de charger. Vous pouvez observer cet évènement sur l’interface Window pour le gérer dans les phases de capture ou de bouillonnement. Pour plus de détails, veuillez consulter la page de l’évènement {{domxref("Document/DOMContentLoaded_event", "Document: DOMContent​Loaded event")}}.

- -

L’évènement load, très différent, doit être utilisé uniquement pour détecter qu’une page est entièrement chargée. C’est une erreur répandue d’utiliser load là où DOMContentLoaded serait beaucoup plus approprié.

- -
-

Note : Le JavaScript synchrone interromp l’analyse du DOM.

-
- -
-

Note : Il existe également de nombreuses bibliothèques indépendantes à usage général qui offrent des méthodes multi-navigateur pour détecter quand le DOM est prêt.

-
- -

Accélérer

- -

Si vous voulez que le DOM soit analysé aussi rapidement que possible après que l’utilisateur ou l’utilisatrice a demandé la page, vous pouvez rendre votre JavaScript asynchrone et optimiser le chargement des feuilles de style. Ces dernières, sans optimisation, ralentissent le chargement de la page parce qu’elles sont chargées en parallèle, et « subtilisent » de la bande passante au document html principal.

- -

Exemples

- -

Utilisation basique

- -
window.addEventListener("DOMContentLoaded", (event) => {
-    console.log("DOM entièrement chargé et analysé");
-  });
-
- -

Spécifications

- - - - - - - - - - - - -
SpécificationStatut
{{SpecName('HTML WHATWG', 'indices.html#event-domcontentloaded')}}{{Spec2('HTML WHATWG')}}
- -

Compatibilité des navigateurs

- -

{{Compat("api.Window.DOMContentLoaded_event")}}

- -

Voir aussi

- - diff --git a/files/fr/web/api/window/domcontentloaded_event/index.md b/files/fr/web/api/window/domcontentloaded_event/index.md new file mode 100644 index 0000000000..a2e989049d --- /dev/null +++ b/files/fr/web/api/window/domcontentloaded_event/index.md @@ -0,0 +1,81 @@ +--- +title: DOMContentLoaded +slug: Web/API/Window/DOMContentLoaded_event +translation_of: Web/API/Window/DOMContentLoaded_event +original_slug: Web/Events/DOMContentLoaded +--- +
{{APIRef}}
+ +

L’évènement DOMContentLoaded est émis lorsque le document HTML initial a été complètement chargé et analysé, sans attendre que les feuilles de style, images et sous-documents aient terminé de charger.

+ + + + + + + + + + + + + + + + + + + + +
BouillonneOui
AnnulableOui (bien que spécifié comme évènement simple non annulable)
Interface{{domxref("Event")}}
Propriété de gestion de l’évènementAucune
+ +

La cible originale pour cet évènement est le {{domxref("Document")}} qui a terminé de charger. Vous pouvez observer cet évènement sur l’interface Window pour le gérer dans les phases de capture ou de bouillonnement. Pour plus de détails, veuillez consulter la page de l’évènement {{domxref("Document/DOMContentLoaded_event", "Document: DOMContent​Loaded event")}}.

+ +

L’évènement load, très différent, doit être utilisé uniquement pour détecter qu’une page est entièrement chargée. C’est une erreur répandue d’utiliser load là où DOMContentLoaded serait beaucoup plus approprié.

+ +
+

Note : Le JavaScript synchrone interromp l’analyse du DOM.

+
+ +
+

Note : Il existe également de nombreuses bibliothèques indépendantes à usage général qui offrent des méthodes multi-navigateur pour détecter quand le DOM est prêt.

+
+ +

Accélérer

+ +

Si vous voulez que le DOM soit analysé aussi rapidement que possible après que l’utilisateur ou l’utilisatrice a demandé la page, vous pouvez rendre votre JavaScript asynchrone et optimiser le chargement des feuilles de style. Ces dernières, sans optimisation, ralentissent le chargement de la page parce qu’elles sont chargées en parallèle, et « subtilisent » de la bande passante au document html principal.

+ +

Exemples

+ +

Utilisation basique

+ +
window.addEventListener("DOMContentLoaded", (event) => {
+    console.log("DOM entièrement chargé et analysé");
+  });
+
+ +

Spécifications

+ + + + + + + + + + + + +
SpécificationStatut
{{SpecName('HTML WHATWG', 'indices.html#event-domcontentloaded')}}{{Spec2('HTML WHATWG')}}
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Window.DOMContentLoaded_event")}}

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/window/dump/index.html b/files/fr/web/api/window/dump/index.html deleted file mode 100644 index 8a44c0818d..0000000000 --- a/files/fr/web/api/window/dump/index.html +++ /dev/null @@ -1,25 +0,0 @@ ---- -title: window.dump -slug: Web/API/Window/dump -tags: - - DOM - - DOM_0 - - Référence_du_DOM_Gecko -translation_of: Web/API/Window/dump ---- -

{{ ApiRef() }}

-

Résumé

-

Affiche des messages dans la console (native).

-

Syntaxe

-
dump(message);
-
- -

Notes

-

dump est habituellement utilisé pour débogage du JavaScript. Du code avec permissions peut également utiliser Components.utils.reportError et nsIConsoleService pour afficher des messages dans la console JavaScript.

-

Dans Gecko, dump est désactivé par défaut – il ne fait rien mais ne génère aucune erreur. Pour que dump écrive dans le flux standard de sortie, vous devez l'activer en mettant la préférence browser.dom.window.dump.enabled à true. Vous pouvez définir cette préférence dans about:config ou dans un fichier user.js.

-

Vous aurez besoin d'une console pour voir quelque chose. Si vous n'en avez pas déjà une, fermez et réouvrez le programme en ajoutant le paramètre -console à la ligne de commande.

-

dump est également disponible au composants XPCOM implémentés en JavaScript, même si window n'est pas l'objet global dans ce contexte.

-

Spécification

-

{{ DOM0() }}

\ No newline at end of file diff --git a/files/fr/web/api/window/dump/index.md b/files/fr/web/api/window/dump/index.md new file mode 100644 index 0000000000..8a44c0818d --- /dev/null +++ b/files/fr/web/api/window/dump/index.md @@ -0,0 +1,25 @@ +--- +title: window.dump +slug: Web/API/Window/dump +tags: + - DOM + - DOM_0 + - Référence_du_DOM_Gecko +translation_of: Web/API/Window/dump +--- +

{{ ApiRef() }}

+

Résumé

+

Affiche des messages dans la console (native).

+

Syntaxe

+
dump(message);
+
+ +

Notes

+

dump est habituellement utilisé pour débogage du JavaScript. Du code avec permissions peut également utiliser Components.utils.reportError et nsIConsoleService pour afficher des messages dans la console JavaScript.

+

Dans Gecko, dump est désactivé par défaut – il ne fait rien mais ne génère aucune erreur. Pour que dump écrive dans le flux standard de sortie, vous devez l'activer en mettant la préférence browser.dom.window.dump.enabled à true. Vous pouvez définir cette préférence dans about:config ou dans un fichier user.js.

+

Vous aurez besoin d'une console pour voir quelque chose. Si vous n'en avez pas déjà une, fermez et réouvrez le programme en ajoutant le paramètre -console à la ligne de commande.

+

dump est également disponible au composants XPCOM implémentés en JavaScript, même si window n'est pas l'objet global dans ce contexte.

+

Spécification

+

{{ DOM0() }}

\ No newline at end of file diff --git a/files/fr/web/api/window/event/index.html b/files/fr/web/api/window/event/index.html deleted file mode 100644 index 9876f88745..0000000000 --- a/files/fr/web/api/window/event/index.html +++ /dev/null @@ -1,49 +0,0 @@ ---- -title: Window.event -slug: Web/API/Window/event -tags: - - API - - Evènement - - Gestionnaire d'évènements - - HTML DOM - - Lecture seulement - - Propriété - - Window -translation_of: Web/API/Window/event ---- -
{{APIRef("DOM")}}
- -

L'événement de propriété {{domxref("Window")}} en lecture seule renvoie le {{domxref("Event")}} qui est actuellement géré par le code du site. En dehors du contexte d'un gestionnaire d'événements, la valeur est toujours undefined.

- -

Vous devez éviter d'utiliser cette propriété dans un nouveau code et utiliser à la place le {{domxref ("Event")}} transmis à la fonction de gestionnaire d'événements. Cette propriété n'est pas prise en charge universellement et même lorsqu'elle est prise en charge, elle introduit une fragilité potentielle dans votre code.

- -
-

Note: Cette propriété peut être fragile, dans la mesure où il peut y avoir des situations dans lesquelles l'événement renvoyé n'est pas la valeur attendue. De plus, Window.event n'est pas précis pour les événements distribués dans {{Glossary("shadow tree", "shadow trees")}}.

-
- -

Spécifications

- - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('DOM WHATWG', "#dom-window-event", "Window.event")}}{{Spec2('DOM WHATWG')}}Définition initiale.
- -

Compatibilité des navigateurs

- -

{{Compat("api.Window.event")}}

- -

Voir également

- - diff --git a/files/fr/web/api/window/event/index.md b/files/fr/web/api/window/event/index.md new file mode 100644 index 0000000000..9876f88745 --- /dev/null +++ b/files/fr/web/api/window/event/index.md @@ -0,0 +1,49 @@ +--- +title: Window.event +slug: Web/API/Window/event +tags: + - API + - Evènement + - Gestionnaire d'évènements + - HTML DOM + - Lecture seulement + - Propriété + - Window +translation_of: Web/API/Window/event +--- +
{{APIRef("DOM")}}
+ +

L'événement de propriété {{domxref("Window")}} en lecture seule renvoie le {{domxref("Event")}} qui est actuellement géré par le code du site. En dehors du contexte d'un gestionnaire d'événements, la valeur est toujours undefined.

+ +

Vous devez éviter d'utiliser cette propriété dans un nouveau code et utiliser à la place le {{domxref ("Event")}} transmis à la fonction de gestionnaire d'événements. Cette propriété n'est pas prise en charge universellement et même lorsqu'elle est prise en charge, elle introduit une fragilité potentielle dans votre code.

+ +
+

Note: Cette propriété peut être fragile, dans la mesure où il peut y avoir des situations dans lesquelles l'événement renvoyé n'est pas la valeur attendue. De plus, Window.event n'est pas précis pour les événements distribués dans {{Glossary("shadow tree", "shadow trees")}}.

+
+ +

Spécifications

+ + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('DOM WHATWG', "#dom-window-event", "Window.event")}}{{Spec2('DOM WHATWG')}}Définition initiale.
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Window.event")}}

+ +

Voir également

+ + diff --git a/files/fr/web/api/window/find/index.html b/files/fr/web/api/window/find/index.html deleted file mode 100644 index b9743102e6..0000000000 --- a/files/fr/web/api/window/find/index.html +++ /dev/null @@ -1,78 +0,0 @@ ---- -title: Window.find() -slug: Web/API/Window/find -tags: - - API - - HTML DOM - - Méthode - - NeedsCompatTable - - NeedsContent - - Non-standard - - Reference - - Window - - find -translation_of: Web/API/Window/find ---- -
{{ApiRef}}{{Non-standard_Header}}
- -
-

Note: La prise en charge de Window.find() pourrait changer dans les futures versions de Gecko. Voir {{Bug("672395")}}.

-
- -

La méthode Window.find() trouve une chaîne dans une fenêtre.

- -

Syntaxe

- -
window.find(aString, aCaseSensitive, aBackwards, aWrapAround,
-            aWholeWord, aSearchInFrames, aShowDialog);
- -
-
aString
-
La chaîne de caractère à rechercher.
-
aCaseSensitive
-
{{jsxref("Boolean")}}. Si true, spécifie une recherche sensible à la casse.
-
aBackwards
-
{{jsxref("Boolean")}}. Si true, spécifie une recherche vers l'arrière.
-
aWrapAround
-
{{jsxref("Boolean")}}. Si true, spécifie une recherche enveloppante.
-
aWholeWord {{Unimplemented_Inline}}
-
{{jsxref("Boolean")}}. Si true, spécifie une recherche de mot entier. Ceci n'est pas implémenté; voir {{bug(481513)}}.
-
aSearchInFrames
-
{{jsxref("Boolean")}}. Si true, spécifie une recherche dans les cadres.
-
- -

Retourne

- -

true si la chaîne est trouvé; autrement, false.

- -

Exemple

- -

JavaScript

- -
findString = function findText(text) {
-  alert("String \x22" + text + "\x22 found? " + window.find(text));
-}
- -

HTML

- -
<p>Apples, Bananas, and Oranges.</p>
-<button type="button" onClick='findString("Apples")'>Search for Apples</button>
-<button type="button" onClick='findString("Banana")'>Search for Banana</button>
-<button type="button" onClick='findString("Orange")'>Search for Orange</button>
-
- -

Résultat

- -

{{EmbedLiveSample("Example")}}

- -

Notes

- -

Dans certains navigateurs, Window.find() sélectionne (met en évidence) le contenu trouvé sur le site.

- -

Spécification

- -

Cela ne fait partie d'aucune spécification.

- -

Compatibilité des navigateurs

- -

Cette méthode fonctionne dans de nombreux navigateurs modernes, notamment Firefox, Chrome, et Safari.

diff --git a/files/fr/web/api/window/find/index.md b/files/fr/web/api/window/find/index.md new file mode 100644 index 0000000000..b9743102e6 --- /dev/null +++ b/files/fr/web/api/window/find/index.md @@ -0,0 +1,78 @@ +--- +title: Window.find() +slug: Web/API/Window/find +tags: + - API + - HTML DOM + - Méthode + - NeedsCompatTable + - NeedsContent + - Non-standard + - Reference + - Window + - find +translation_of: Web/API/Window/find +--- +
{{ApiRef}}{{Non-standard_Header}}
+ +
+

Note: La prise en charge de Window.find() pourrait changer dans les futures versions de Gecko. Voir {{Bug("672395")}}.

+
+ +

La méthode Window.find() trouve une chaîne dans une fenêtre.

+ +

Syntaxe

+ +
window.find(aString, aCaseSensitive, aBackwards, aWrapAround,
+            aWholeWord, aSearchInFrames, aShowDialog);
+ +
+
aString
+
La chaîne de caractère à rechercher.
+
aCaseSensitive
+
{{jsxref("Boolean")}}. Si true, spécifie une recherche sensible à la casse.
+
aBackwards
+
{{jsxref("Boolean")}}. Si true, spécifie une recherche vers l'arrière.
+
aWrapAround
+
{{jsxref("Boolean")}}. Si true, spécifie une recherche enveloppante.
+
aWholeWord {{Unimplemented_Inline}}
+
{{jsxref("Boolean")}}. Si true, spécifie une recherche de mot entier. Ceci n'est pas implémenté; voir {{bug(481513)}}.
+
aSearchInFrames
+
{{jsxref("Boolean")}}. Si true, spécifie une recherche dans les cadres.
+
+ +

Retourne

+ +

true si la chaîne est trouvé; autrement, false.

+ +

Exemple

+ +

JavaScript

+ +
findString = function findText(text) {
+  alert("String \x22" + text + "\x22 found? " + window.find(text));
+}
+ +

HTML

+ +
<p>Apples, Bananas, and Oranges.</p>
+<button type="button" onClick='findString("Apples")'>Search for Apples</button>
+<button type="button" onClick='findString("Banana")'>Search for Banana</button>
+<button type="button" onClick='findString("Orange")'>Search for Orange</button>
+
+ +

Résultat

+ +

{{EmbedLiveSample("Example")}}

+ +

Notes

+ +

Dans certains navigateurs, Window.find() sélectionne (met en évidence) le contenu trouvé sur le site.

+ +

Spécification

+ +

Cela ne fait partie d'aucune spécification.

+ +

Compatibilité des navigateurs

+ +

Cette méthode fonctionne dans de nombreux navigateurs modernes, notamment Firefox, Chrome, et Safari.

diff --git a/files/fr/web/api/window/focus/index.html b/files/fr/web/api/window/focus/index.html deleted file mode 100644 index 02c25eb163..0000000000 --- a/files/fr/web/api/window/focus/index.html +++ /dev/null @@ -1,37 +0,0 @@ ---- -title: Window.focus() -slug: Web/API/Window/focus -translation_of: Web/API/Window/focus ---- -

{{APIRef}}

- -

Résumé

- -

Demande la mise au premier plan de la fenêtre. Cet appel peut échouer en fonction des réglages utilisateurs, et ne garantit pas que la fenêtre sera au-dessus des autres au retour de cette méthode.

- -

Syntaxe

- -
window.focus()
-
- -

Exemple

- -
if (clicked) { window.focus(); }
-
- -

Spécification

- - - - - - - - - - - - - - -
SpecificationStatusComment
{{SpecName('HTML WHATWG','interaction.html#dom-window-focus','Window.focus()')}}{{Spec2('HTML WHATWG')}} 
\ No newline at end of file diff --git a/files/fr/web/api/window/focus/index.md b/files/fr/web/api/window/focus/index.md new file mode 100644 index 0000000000..02c25eb163 --- /dev/null +++ b/files/fr/web/api/window/focus/index.md @@ -0,0 +1,37 @@ +--- +title: Window.focus() +slug: Web/API/Window/focus +translation_of: Web/API/Window/focus +--- +

{{APIRef}}

+ +

Résumé

+ +

Demande la mise au premier plan de la fenêtre. Cet appel peut échouer en fonction des réglages utilisateurs, et ne garantit pas que la fenêtre sera au-dessus des autres au retour de cette méthode.

+ +

Syntaxe

+ +
window.focus()
+
+ +

Exemple

+ +
if (clicked) { window.focus(); }
+
+ +

Spécification

+ + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('HTML WHATWG','interaction.html#dom-window-focus','Window.focus()')}}{{Spec2('HTML WHATWG')}} 
\ No newline at end of file diff --git a/files/fr/web/api/window/frameelement/index.html b/files/fr/web/api/window/frameelement/index.html deleted file mode 100644 index 4a36ff3fd6..0000000000 --- a/files/fr/web/api/window/frameelement/index.html +++ /dev/null @@ -1,66 +0,0 @@ ---- -title: Window.frameElement -slug: Web/API/Window/frameElement -tags: - - API - - DOM - - Propriété - - Reference - - Window -translation_of: Web/API/Window/frameElement ---- -
{{ApiRef}}
- -

La propriété Window.frameElement renvoie l'élément (tel que {{HTMLElement("iframe")}} ou {{HTMLElement("object")}}) dans lequel la fenêtre est intégrée.

- -
-

Note: Malgré le nom de cette propriété, elle fonctionne pour les documents intégrés dans n'importe quel point d'incorporation, y compris {{HTMLElement("object")}}, {{HTMLElement("iframe")}}, ou {{HTMLElement("embed")}}.

-
- -

Syntaxe

- -
const frameEl = window.frameElement
-
- -

Valeur

- -

L'élément dans lequel la fenêtre est intégrée. Si la fenêtre n'est pas intégrée dans un autre document, ou si le document dans lequel elle est intégrée a un {{glossary("origin")}}, la valeur est {{jsxref("null")}} à la place.

- -

Exemple

- -
const frameEl = window.frameElement;
-// Si nous sommes incorporés, modifiez l'URL de l'élément contenant en 'http://mozilla.org/'
-if (frameEl) {
-  frameEl.src = 'http://mozilla.org/';
-}
-
- -

Spécifications

- - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('HTML WHATWG', 'browsers.html#dom-frameelement', 'Window.frameElement')}}{{ Spec2('WebRTC 1.0') }}Spécification initiale.
- -

Compatibilité des navigateurs

- -

{{Compat("api.Window.frameElement")}}

- -

Voir également

- - diff --git a/files/fr/web/api/window/frameelement/index.md b/files/fr/web/api/window/frameelement/index.md new file mode 100644 index 0000000000..4a36ff3fd6 --- /dev/null +++ b/files/fr/web/api/window/frameelement/index.md @@ -0,0 +1,66 @@ +--- +title: Window.frameElement +slug: Web/API/Window/frameElement +tags: + - API + - DOM + - Propriété + - Reference + - Window +translation_of: Web/API/Window/frameElement +--- +
{{ApiRef}}
+ +

La propriété Window.frameElement renvoie l'élément (tel que {{HTMLElement("iframe")}} ou {{HTMLElement("object")}}) dans lequel la fenêtre est intégrée.

+ +
+

Note: Malgré le nom de cette propriété, elle fonctionne pour les documents intégrés dans n'importe quel point d'incorporation, y compris {{HTMLElement("object")}}, {{HTMLElement("iframe")}}, ou {{HTMLElement("embed")}}.

+
+ +

Syntaxe

+ +
const frameEl = window.frameElement
+
+ +

Valeur

+ +

L'élément dans lequel la fenêtre est intégrée. Si la fenêtre n'est pas intégrée dans un autre document, ou si le document dans lequel elle est intégrée a un {{glossary("origin")}}, la valeur est {{jsxref("null")}} à la place.

+ +

Exemple

+ +
const frameEl = window.frameElement;
+// Si nous sommes incorporés, modifiez l'URL de l'élément contenant en 'http://mozilla.org/'
+if (frameEl) {
+  frameEl.src = 'http://mozilla.org/';
+}
+
+ +

Spécifications

+ + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('HTML WHATWG', 'browsers.html#dom-frameelement', 'Window.frameElement')}}{{ Spec2('WebRTC 1.0') }}Spécification initiale.
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Window.frameElement")}}

+ +

Voir également

+ + diff --git a/files/fr/web/api/window/frames/index.html b/files/fr/web/api/window/frames/index.html deleted file mode 100644 index 9a1c20a92f..0000000000 --- a/files/fr/web/api/window/frames/index.html +++ /dev/null @@ -1,43 +0,0 @@ ---- -title: Window.frames -slug: Web/API/Window/frames -tags: - - API - - DOM - - DOM Reference - - DOM_0 - - Gecko - - NeedsContent - - NeedsUpdate - - Property - - Reference -translation_of: Web/API/Window/frames ---- -

{{ApiRef("Window")}}

- -

Renvoie la fenêtre elle-même, qui est semblable à un objet de type Array, listant les frames présentes dans la fenêtre courante.

- -

Syntaxe

- -
frameList = window.frames;
-
- - - -

Exemple

- -
var frames = window.frames; // ou // var frames = window.parent.frames;
-for (var i = 0; i < frames.length; i++) {
-  // faire quelque chose avec chaque subframe en tant que frames[i]
-  frames[i].document.body.style.background = "red";
-}
-
- -

Spécifications

- -

{{SpecName('HTML WHATWG','browsers.html#dom-frames','Window.frames')}}

\ No newline at end of file diff --git a/files/fr/web/api/window/frames/index.md b/files/fr/web/api/window/frames/index.md new file mode 100644 index 0000000000..9a1c20a92f --- /dev/null +++ b/files/fr/web/api/window/frames/index.md @@ -0,0 +1,43 @@ +--- +title: Window.frames +slug: Web/API/Window/frames +tags: + - API + - DOM + - DOM Reference + - DOM_0 + - Gecko + - NeedsContent + - NeedsUpdate + - Property + - Reference +translation_of: Web/API/Window/frames +--- +

{{ApiRef("Window")}}

+ +

Renvoie la fenêtre elle-même, qui est semblable à un objet de type Array, listant les frames présentes dans la fenêtre courante.

+ +

Syntaxe

+ +
frameList = window.frames;
+
+ + + +

Exemple

+ +
var frames = window.frames; // ou // var frames = window.parent.frames;
+for (var i = 0; i < frames.length; i++) {
+  // faire quelque chose avec chaque subframe en tant que frames[i]
+  frames[i].document.body.style.background = "red";
+}
+
+ +

Spécifications

+ +

{{SpecName('HTML WHATWG','browsers.html#dom-frames','Window.frames')}}

\ No newline at end of file diff --git a/files/fr/web/api/window/fullscreen/index.html b/files/fr/web/api/window/fullscreen/index.html deleted file mode 100644 index dbd330f4f5..0000000000 --- a/files/fr/web/api/window/fullscreen/index.html +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: window.fullScreen -slug: Web/API/Window/fullScreen -tags: - - DOM - - DOM_0 - - Référence_du_DOM_Gecko -translation_of: Web/API/Window/fullScreen ---- -

{{ ApiRef() }}

-

Résumé

-

Cette propriété indique si la fenêtre est affichée en mode plein écran ou non. Elle n'est fiable qu'à partir de Gecko 1.9 (Firefox 3), voir les Notes plus bas.

-

Syntaxe

-
var isInFullScreen = windowRef.fullScreen;
-
-

Avec les privilèges chrome, la propriété est modifiable ; autrement elle est en lecture seule. Souvenez-vous que si vous essayez de définir cette propriété sans les privilèges chrome, aucune exception ne sera déclenchée et l'appel échouera juste silencieusement. Cela permet d'empêcher que des scripts conçus pour utiliser cette propriété dans Internet Explorer cessent de fonctionner.

-

Valeur de retour

-
-
- isInFullScreen
-
- Une valeur booléenne. Signification des valeurs :
-
- -

Exemples

-

Spécification

-

{{ DOM0() }}

-

Notes

-

Cette propriété n'est fiable qu'à partir de Mozilla 1.9 (Firefox 3). Mozilla 1.8 et les versions antérieures disposent de cette propriété, mais elle renvoie toujours false, même quand la fenêtre est en mode plein écran ({{ Bug(127013) }}).

\ No newline at end of file diff --git a/files/fr/web/api/window/fullscreen/index.md b/files/fr/web/api/window/fullscreen/index.md new file mode 100644 index 0000000000..dbd330f4f5 --- /dev/null +++ b/files/fr/web/api/window/fullscreen/index.md @@ -0,0 +1,32 @@ +--- +title: window.fullScreen +slug: Web/API/Window/fullScreen +tags: + - DOM + - DOM_0 + - Référence_du_DOM_Gecko +translation_of: Web/API/Window/fullScreen +--- +

{{ ApiRef() }}

+

Résumé

+

Cette propriété indique si la fenêtre est affichée en mode plein écran ou non. Elle n'est fiable qu'à partir de Gecko 1.9 (Firefox 3), voir les Notes plus bas.

+

Syntaxe

+
var isInFullScreen = windowRef.fullScreen;
+
+

Avec les privilèges chrome, la propriété est modifiable ; autrement elle est en lecture seule. Souvenez-vous que si vous essayez de définir cette propriété sans les privilèges chrome, aucune exception ne sera déclenchée et l'appel échouera juste silencieusement. Cela permet d'empêcher que des scripts conçus pour utiliser cette propriété dans Internet Explorer cessent de fonctionner.

+

Valeur de retour

+
+
+ isInFullScreen
+
+ Une valeur booléenne. Signification des valeurs :
+
+ +

Exemples

+

Spécification

+

{{ DOM0() }}

+

Notes

+

Cette propriété n'est fiable qu'à partir de Mozilla 1.9 (Firefox 3). Mozilla 1.8 et les versions antérieures disposent de cette propriété, mais elle renvoie toujours false, même quand la fenêtre est en mode plein écran ({{ Bug(127013) }}).

\ No newline at end of file diff --git a/files/fr/web/api/window/gamepadconnected_event/index.html b/files/fr/web/api/window/gamepadconnected_event/index.html deleted file mode 100644 index 4452ac1892..0000000000 --- a/files/fr/web/api/window/gamepadconnected_event/index.html +++ /dev/null @@ -1,86 +0,0 @@ ---- -title: gamepadconnected -slug: Web/API/Window/gamepadconnected_event -translation_of: Web/API/Window/gamepadconnected_event ---- -

L'événement gamepadconnected est déclenché lorsque le navigateur détecte quand une manette a été connecté ou qu'un button/axe de la manette a été utilisé pour la première fois.
-  

- -

Informations générales

- -
-
Spécification
-
Gamepad
-
Interface
-
Event
-
Propagation
-
Non
-
Annulable
-
Non
-
Cible
-
DefaultView (<window>)
-
Action par défaut
-
Aucune
-
- -

Propriétés

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
PropertyTypeDescription
target {{readonlyInline}}{{domxref("EventTarget")}}The event target (the topmost target in the DOM tree).
type {{readonlyInline}}{{domxref("DOMString")}}The type of event.
bubbles {{readonlyInline}}{{jsxref("Boolean")}}Whether the event normally bubbles or not.
cancelable {{readonlyInline}}{{jsxref("Boolean")}}Whether the event is cancellable or not.
gamepad {{readonlyInline}}{{domxref("Gamepad")}}The single gamepad attribute provides access to the associated gamepad data for this event.
- -

Exemple

- -
// Noter que l'API a toujours des préfixes vendeur dans les navigateurs l'implémentant
-window.addEventListener("gamepadconnected", function( event ) {
-
-    // Toutes la valeurs d'axes et les buttons sont accessibles à travers:
-    event.gamepad;
-
-});
-
- -

Evénements liés

- - - -

Voir aussi

- - diff --git a/files/fr/web/api/window/gamepadconnected_event/index.md b/files/fr/web/api/window/gamepadconnected_event/index.md new file mode 100644 index 0000000000..4452ac1892 --- /dev/null +++ b/files/fr/web/api/window/gamepadconnected_event/index.md @@ -0,0 +1,86 @@ +--- +title: gamepadconnected +slug: Web/API/Window/gamepadconnected_event +translation_of: Web/API/Window/gamepadconnected_event +--- +

L'événement gamepadconnected est déclenché lorsque le navigateur détecte quand une manette a été connecté ou qu'un button/axe de la manette a été utilisé pour la première fois.
+  

+ +

Informations générales

+ +
+
Spécification
+
Gamepad
+
Interface
+
Event
+
Propagation
+
Non
+
Annulable
+
Non
+
Cible
+
DefaultView (<window>)
+
Action par défaut
+
Aucune
+
+ +

Propriétés

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
PropertyTypeDescription
target {{readonlyInline}}{{domxref("EventTarget")}}The event target (the topmost target in the DOM tree).
type {{readonlyInline}}{{domxref("DOMString")}}The type of event.
bubbles {{readonlyInline}}{{jsxref("Boolean")}}Whether the event normally bubbles or not.
cancelable {{readonlyInline}}{{jsxref("Boolean")}}Whether the event is cancellable or not.
gamepad {{readonlyInline}}{{domxref("Gamepad")}}The single gamepad attribute provides access to the associated gamepad data for this event.
+ +

Exemple

+ +
// Noter que l'API a toujours des préfixes vendeur dans les navigateurs l'implémentant
+window.addEventListener("gamepadconnected", function( event ) {
+
+    // Toutes la valeurs d'axes et les buttons sont accessibles à travers:
+    event.gamepad;
+
+});
+
+ +

Evénements liés

+ + + +

Voir aussi

+ + diff --git a/files/fr/web/api/window/gamepaddisconnected_event/index.html b/files/fr/web/api/window/gamepaddisconnected_event/index.html deleted file mode 100644 index e4c36c1ece..0000000000 --- a/files/fr/web/api/window/gamepaddisconnected_event/index.html +++ /dev/null @@ -1,74 +0,0 @@ ---- -title: gamepaddisconnected -slug: Web/API/Window/gamepaddisconnected_event -translation_of: Web/API/Window/gamepaddisconnected_event ---- -

L'événement gamepaddisconnected est déclenché lorsque le navigateur détecte le fait qu'une manette ait été débranchée.

- -

Informations générales

- -
-
Spécification
-
Gamepad
-
Interface
-
{{domxref("Event")}}
-
Propagation
-
Non
-
Annulable
-
Non
-
Cible
-
DefaultView (<window>)
-
Action par défaut
-
Aucune
-
- -

Propriétés

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
PropertyTypeDescription
target {{readonlyInline}}{{domxref("EventTarget")}}The event target (the topmost target in the DOM tree).
type {{readonlyInline}}{{domxref("DOMString")}}The type of event.
bubbles {{readonlyInline}}{{jsxref("Boolean")}}Whether the event normally bubbles or not.
cancelable {{readonlyInline}}{{jsxref("Boolean")}}Whether the event is cancellable or not.
gamepad {{readonlyInline}}{{domxref("Gamepad")}}The single gamepad attribute provides access to the associated gamepad data for this event.
- -

Evénements liés

- - - -

Voir aussi

- - diff --git a/files/fr/web/api/window/gamepaddisconnected_event/index.md b/files/fr/web/api/window/gamepaddisconnected_event/index.md new file mode 100644 index 0000000000..e4c36c1ece --- /dev/null +++ b/files/fr/web/api/window/gamepaddisconnected_event/index.md @@ -0,0 +1,74 @@ +--- +title: gamepaddisconnected +slug: Web/API/Window/gamepaddisconnected_event +translation_of: Web/API/Window/gamepaddisconnected_event +--- +

L'événement gamepaddisconnected est déclenché lorsque le navigateur détecte le fait qu'une manette ait été débranchée.

+ +

Informations générales

+ +
+
Spécification
+
Gamepad
+
Interface
+
{{domxref("Event")}}
+
Propagation
+
Non
+
Annulable
+
Non
+
Cible
+
DefaultView (<window>)
+
Action par défaut
+
Aucune
+
+ +

Propriétés

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
PropertyTypeDescription
target {{readonlyInline}}{{domxref("EventTarget")}}The event target (the topmost target in the DOM tree).
type {{readonlyInline}}{{domxref("DOMString")}}The type of event.
bubbles {{readonlyInline}}{{jsxref("Boolean")}}Whether the event normally bubbles or not.
cancelable {{readonlyInline}}{{jsxref("Boolean")}}Whether the event is cancellable or not.
gamepad {{readonlyInline}}{{domxref("Gamepad")}}The single gamepad attribute provides access to the associated gamepad data for this event.
+ +

Evénements liés

+ + + +

Voir aussi

+ + diff --git a/files/fr/web/api/window/getcomputedstyle/index.html b/files/fr/web/api/window/getcomputedstyle/index.html deleted file mode 100644 index 2c4294f100..0000000000 --- a/files/fr/web/api/window/getcomputedstyle/index.html +++ /dev/null @@ -1,116 +0,0 @@ ---- -title: window.getComputedStyle -slug: Web/API/Window/getComputedStyle -translation_of: Web/API/Window/getComputedStyle ---- -

{{ ApiRef() }}

- -

Résumé

- -

La méthode window.getComputedStyle() donne la  valeur calculée finale de toutes les propriétés CSS sur un élément.

- -

Syntaxe

- -
var style = window.getComputedStyle(element[, pseudoElt]);
- -
-
element
-
L’{{ domxref("Element") }} pour lequel vous voulez obtenir une valeur calculée.
-
pseudoElt {{ optional_inline() }}
-
Chaîne de caractère spécifiant le pseudo-élément à cibler. Doit être null (ou non spécifiée) pour les éléments communs.
-
- -
-

Note : Avant Gecko 2.0 {{ geckoRelease("2.0") }}, le paramètre pseudoElt était obligatoire. Aucun autre navigateur majeur ne requiert que ce paramètre soit renseigné si il est null. Gecko a été modifié pour se comporter comme les autres navigateurs.

-
- -

La valeur de retour style est un objet CSSStyleDeclaration.

- -

Exemple

- -
var elem1 = document.getElementById("elemId");
-var style = window.getComputedStyle(elem1, null);
-
-// Ce qui équivaut à :
-// var style = document.defaultView.getComputedStyle(elem1, null);
-
- -
<style>
- #elem-container{
-   position: absolute;
-   left:     100px;
-   top:      200px;
-   height:   100px;
- }
-</style>
-
-<div id="elem-container">dummy</div>
-<div id="output"></div>
-
-<script>
-  function getTheStyle(){
-    var elem = document.getElementById("elem-container");
-    var theCSSprop = window.getComputedStyle(elem,null).getPropertyValue("height");
-    document.getElementById("output").innerHTML = theCSSprop;
-   }
-  getTheStyle();
-</script>
-
- -
function dumpComputedStyles(elem,prop) {
-
-  var cs = window.getComputedStyle(elem,null);
-  if (prop) {
-    console.log(prop+" : "+cs.getPropertyValue(prop));
-    return;
-  }
-  var len = cs.length;
-  for (var i=0;i<len;i++) {
-
-    var style = cs[i];
-    console.log(style+" : "+cs.getPropertyValue(style));
-  }
-
-}
- -

Description

- -

L'objet retourné est du même type que celui de la propriété {{domxref("HTMLElement.style", "style")}} de l'élément ciblé. Toutefois les deux objets ont des buts distincts. L'objet retourné par la méthode getComputedStyle est en lecture seule et peut être utilisée pour inspecter le style de l'élément y compris ceux ajoutés via un élément <style> ou une feuille de style externe. L'objet elt.style doit quant à lui être utilisé pour mettre à jour une propriété de style sur un élément donné.

- -

Le premier argument doit être un Element, sinon, si par exemple un #text Node est utilisé, une exception sera lancée. Depuis la version 1.9.2 de Gecko {{geckoRelease("1.9.2")}}, les URLs renvoyées ont désormais des guillemets autour de celles-ci: url("http://foo.com/bar.jpg").

- -

Spécification

- - - - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName("CSSOM", "#dom-window-getcomputedstyle", "getComputedStyle()")}}{{Spec2("CSSOM")}}
{{SpecName("DOM2 Style", "#CSS-CSSview-getComputedStyle", - "getComputedStyle()")}}{{Spec2("DOM2 Style")}}Définition initiale.
- -

Compatibilité des navigateurs

- -

{{Compat("api.Window.getComputedStyle")}}

- -

Voir aussi

- - diff --git a/files/fr/web/api/window/getcomputedstyle/index.md b/files/fr/web/api/window/getcomputedstyle/index.md new file mode 100644 index 0000000000..2c4294f100 --- /dev/null +++ b/files/fr/web/api/window/getcomputedstyle/index.md @@ -0,0 +1,116 @@ +--- +title: window.getComputedStyle +slug: Web/API/Window/getComputedStyle +translation_of: Web/API/Window/getComputedStyle +--- +

{{ ApiRef() }}

+ +

Résumé

+ +

La méthode window.getComputedStyle() donne la  valeur calculée finale de toutes les propriétés CSS sur un élément.

+ +

Syntaxe

+ +
var style = window.getComputedStyle(element[, pseudoElt]);
+ +
+
element
+
L’{{ domxref("Element") }} pour lequel vous voulez obtenir une valeur calculée.
+
pseudoElt {{ optional_inline() }}
+
Chaîne de caractère spécifiant le pseudo-élément à cibler. Doit être null (ou non spécifiée) pour les éléments communs.
+
+ +
+

Note : Avant Gecko 2.0 {{ geckoRelease("2.0") }}, le paramètre pseudoElt était obligatoire. Aucun autre navigateur majeur ne requiert que ce paramètre soit renseigné si il est null. Gecko a été modifié pour se comporter comme les autres navigateurs.

+
+ +

La valeur de retour style est un objet CSSStyleDeclaration.

+ +

Exemple

+ +
var elem1 = document.getElementById("elemId");
+var style = window.getComputedStyle(elem1, null);
+
+// Ce qui équivaut à :
+// var style = document.defaultView.getComputedStyle(elem1, null);
+
+ +
<style>
+ #elem-container{
+   position: absolute;
+   left:     100px;
+   top:      200px;
+   height:   100px;
+ }
+</style>
+
+<div id="elem-container">dummy</div>
+<div id="output"></div>
+
+<script>
+  function getTheStyle(){
+    var elem = document.getElementById("elem-container");
+    var theCSSprop = window.getComputedStyle(elem,null).getPropertyValue("height");
+    document.getElementById("output").innerHTML = theCSSprop;
+   }
+  getTheStyle();
+</script>
+
+ +
function dumpComputedStyles(elem,prop) {
+
+  var cs = window.getComputedStyle(elem,null);
+  if (prop) {
+    console.log(prop+" : "+cs.getPropertyValue(prop));
+    return;
+  }
+  var len = cs.length;
+  for (var i=0;i<len;i++) {
+
+    var style = cs[i];
+    console.log(style+" : "+cs.getPropertyValue(style));
+  }
+
+}
+ +

Description

+ +

L'objet retourné est du même type que celui de la propriété {{domxref("HTMLElement.style", "style")}} de l'élément ciblé. Toutefois les deux objets ont des buts distincts. L'objet retourné par la méthode getComputedStyle est en lecture seule et peut être utilisée pour inspecter le style de l'élément y compris ceux ajoutés via un élément <style> ou une feuille de style externe. L'objet elt.style doit quant à lui être utilisé pour mettre à jour une propriété de style sur un élément donné.

+ +

Le premier argument doit être un Element, sinon, si par exemple un #text Node est utilisé, une exception sera lancée. Depuis la version 1.9.2 de Gecko {{geckoRelease("1.9.2")}}, les URLs renvoyées ont désormais des guillemets autour de celles-ci: url("http://foo.com/bar.jpg").

+ +

Spécification

+ + + + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName("CSSOM", "#dom-window-getcomputedstyle", "getComputedStyle()")}}{{Spec2("CSSOM")}}
{{SpecName("DOM2 Style", "#CSS-CSSview-getComputedStyle", + "getComputedStyle()")}}{{Spec2("DOM2 Style")}}Définition initiale.
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Window.getComputedStyle")}}

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/window/getdefaultcomputedstyle/index.html b/files/fr/web/api/window/getdefaultcomputedstyle/index.html deleted file mode 100644 index 7c2363a4e4..0000000000 --- a/files/fr/web/api/window/getdefaultcomputedstyle/index.html +++ /dev/null @@ -1,87 +0,0 @@ ---- -title: Window.getDefaultComputedStyle() -slug: Web/API/Window/getDefaultComputedStyle -tags: - - API - - CSS - - Method - - Reference -translation_of: Web/API/window/getDefaultComputedStyle ---- -
{{APIRef("CSSOM")}}{{Non-standard_header}}
- -

getDefaultComputedStyle() fournit les valeurs calculées par défaut de toutes les propriétés CSS d'un élément, en ignorant la mise en forme de l'auteur. C'est-à-dire que seules les mises en forme de l'agent utilisateur et de l'utilisateur sont pris en compte.

- -

Syntaxe

- -
var miseEnForme = window.getDefaultComputedStyle(element[, pseudoElt]);
-
- -
-
element
-
L'{{domxref("Element")}} dont on veut obtenir la mise en forme calculée.
-
pseudoElt {{optional_inline}}
-
Une chaîne indiquant le pseudo-élément à rechercher. Doit être null (ou non indiqué) pour les éléments ordinaires.
-
- -

Le style retourné est un objet CSSStyleDeclaration.

- -

Exemples

- -
var elem1 = document.getElementById("IdElem");
-var miseEnForme = window.getDefaultComputedStyle(elem1);
-
- -
<style>
-#conteneur-elem {
-   position: absolute;
-   left:     100px;
-   top:      200px;
-   height:   100px;
- }
-</style>
-
-<div id="conteneur-elem">factice</div>
-<div id="sortie"></div>
-
-<script>
-    var elem = document.getElementById("conteneur-elem");
-    var laPropCSS = window.getDefaultComputedStyle(elem).position;
-    document.getElementById("sortie").innerHTML = laPropCSS; // affichera "static"
-</script>
- -

Description

- -

L'objet retourné est du même type que l'objet retourné par getComputedStyle, mais il ne prend en compte que les règles user-agent et user.

- -

Utilisation avec des pseudo-éléments

- -

getDefaultComputedStyle peut extraire des informations de mise en forme à partir de pseudo-éléments (par exemple, ::after, ::before).

- -
<style>
- h3:after {
-   content: ' déchire !';
- }
-</style>
-
-<h3>contenu généré</h3>
-
-<script>
-  var h3       = document.querySelector('h3'),
-      resultat = getDefaultComputedStyle(h3, ':after').content;
-
-  console.log('le contenu généré est : ', resultat); // retourne 'none'
-</script>
-
- -

Notes

- -

La valeur retournée est, dans certains cas connus, expressément incorrecte par intention délibérée. En particulier, pour éviter le problème de sécurité appelé CSS History Leak, les navigateurs peuvent "mentir" sur la valeur utilisée pour un lien et toujours retourner des valeurs comme si l'utilisateur n'avait jamais visité le site concerné, et/ou limiter les styles qui peuvent être appliqués via l'utilisation du pseudo-sélecteur :visited. Voir http://blog.mozilla.com/security/2010/03/31/plugging-the-css-history-leak/ et http://hacks.mozilla.org/2010/03/privacy-related-changes-coming-to-css-visited/ pour le détail des exemples de la manière dont cela est implémenté.

- -

Spécifications

- -

Proposé au groupe de travail CSS.

- -

Compatibilité des navigateurs

- -

{{Compat("api.Window.getDefaultComputedStyle")}}

diff --git a/files/fr/web/api/window/getdefaultcomputedstyle/index.md b/files/fr/web/api/window/getdefaultcomputedstyle/index.md new file mode 100644 index 0000000000..7c2363a4e4 --- /dev/null +++ b/files/fr/web/api/window/getdefaultcomputedstyle/index.md @@ -0,0 +1,87 @@ +--- +title: Window.getDefaultComputedStyle() +slug: Web/API/Window/getDefaultComputedStyle +tags: + - API + - CSS + - Method + - Reference +translation_of: Web/API/window/getDefaultComputedStyle +--- +
{{APIRef("CSSOM")}}{{Non-standard_header}}
+ +

getDefaultComputedStyle() fournit les valeurs calculées par défaut de toutes les propriétés CSS d'un élément, en ignorant la mise en forme de l'auteur. C'est-à-dire que seules les mises en forme de l'agent utilisateur et de l'utilisateur sont pris en compte.

+ +

Syntaxe

+ +
var miseEnForme = window.getDefaultComputedStyle(element[, pseudoElt]);
+
+ +
+
element
+
L'{{domxref("Element")}} dont on veut obtenir la mise en forme calculée.
+
pseudoElt {{optional_inline}}
+
Une chaîne indiquant le pseudo-élément à rechercher. Doit être null (ou non indiqué) pour les éléments ordinaires.
+
+ +

Le style retourné est un objet CSSStyleDeclaration.

+ +

Exemples

+ +
var elem1 = document.getElementById("IdElem");
+var miseEnForme = window.getDefaultComputedStyle(elem1);
+
+ +
<style>
+#conteneur-elem {
+   position: absolute;
+   left:     100px;
+   top:      200px;
+   height:   100px;
+ }
+</style>
+
+<div id="conteneur-elem">factice</div>
+<div id="sortie"></div>
+
+<script>
+    var elem = document.getElementById("conteneur-elem");
+    var laPropCSS = window.getDefaultComputedStyle(elem).position;
+    document.getElementById("sortie").innerHTML = laPropCSS; // affichera "static"
+</script>
+ +

Description

+ +

L'objet retourné est du même type que l'objet retourné par getComputedStyle, mais il ne prend en compte que les règles user-agent et user.

+ +

Utilisation avec des pseudo-éléments

+ +

getDefaultComputedStyle peut extraire des informations de mise en forme à partir de pseudo-éléments (par exemple, ::after, ::before).

+ +
<style>
+ h3:after {
+   content: ' déchire !';
+ }
+</style>
+
+<h3>contenu généré</h3>
+
+<script>
+  var h3       = document.querySelector('h3'),
+      resultat = getDefaultComputedStyle(h3, ':after').content;
+
+  console.log('le contenu généré est : ', resultat); // retourne 'none'
+</script>
+
+ +

Notes

+ +

La valeur retournée est, dans certains cas connus, expressément incorrecte par intention délibérée. En particulier, pour éviter le problème de sécurité appelé CSS History Leak, les navigateurs peuvent "mentir" sur la valeur utilisée pour un lien et toujours retourner des valeurs comme si l'utilisateur n'avait jamais visité le site concerné, et/ou limiter les styles qui peuvent être appliqués via l'utilisation du pseudo-sélecteur :visited. Voir http://blog.mozilla.com/security/2010/03/31/plugging-the-css-history-leak/ et http://hacks.mozilla.org/2010/03/privacy-related-changes-coming-to-css-visited/ pour le détail des exemples de la manière dont cela est implémenté.

+ +

Spécifications

+ +

Proposé au groupe de travail CSS.

+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Window.getDefaultComputedStyle")}}

diff --git a/files/fr/web/api/window/getselection/index.html b/files/fr/web/api/window/getselection/index.html deleted file mode 100644 index 579af3f9a0..0000000000 --- a/files/fr/web/api/window/getselection/index.html +++ /dev/null @@ -1,47 +0,0 @@ ---- -title: window.getSelection -slug: Web/API/Window/getSelection -translation_of: Web/API/Window/getSelection ---- -

{{ ApiRef() }}

- -

Renvoie un objet selection représentant le ou les objets sélectionnés.

- -

Syntaxe

- -
selection = window.getSelection()
-
- -

Paramètres

- - - -

Exemple

- -
function foo() {
-   var selObj = window.getSelection();
-   alert(selObj);
-   var selRange = selObj.getRangeAt(0);
-   // travailler avec la sélection
-}
-
- -

Notes

- -

En JavaScript, lorsqu'un objet de type Selection est passé à une fonction, c'est une représentation sous forme de chaîne (string), c'est-à-dire le texte sélectionné, qui lui est passée à la place. L'objet selection apparaît donc comme une chaîne, alors qu'il s'agit en réalité d'un objet possédant ses propres propriétés et méthodes. En pratique, c'est donc la valeur renvoyée par la méthode toString de l'objet Selection qui est passée. Dans l'exemple ci-dessus, selObj est automatiquement « convertie » lorsqu'elle est passée à window.alert. Cependant, pour utiliser une propriété ou méthode JavaScript de String comme length ou substr, il est nécessaire d'appeler manuellement la méthode toString. I'm treading carefully with the word "convert" here because it could be misinterpreted as a permanent convert - Maian

- -

Spécification

- -

DOM Level 0. Ne fait partie d'aucune spécification.

- -

Voir aussi

- - diff --git a/files/fr/web/api/window/getselection/index.md b/files/fr/web/api/window/getselection/index.md new file mode 100644 index 0000000000..579af3f9a0 --- /dev/null +++ b/files/fr/web/api/window/getselection/index.md @@ -0,0 +1,47 @@ +--- +title: window.getSelection +slug: Web/API/Window/getSelection +translation_of: Web/API/Window/getSelection +--- +

{{ ApiRef() }}

+ +

Renvoie un objet selection représentant le ou les objets sélectionnés.

+ +

Syntaxe

+ +
selection = window.getSelection()
+
+ +

Paramètres

+ + + +

Exemple

+ +
function foo() {
+   var selObj = window.getSelection();
+   alert(selObj);
+   var selRange = selObj.getRangeAt(0);
+   // travailler avec la sélection
+}
+
+ +

Notes

+ +

En JavaScript, lorsqu'un objet de type Selection est passé à une fonction, c'est une représentation sous forme de chaîne (string), c'est-à-dire le texte sélectionné, qui lui est passée à la place. L'objet selection apparaît donc comme une chaîne, alors qu'il s'agit en réalité d'un objet possédant ses propres propriétés et méthodes. En pratique, c'est donc la valeur renvoyée par la méthode toString de l'objet Selection qui est passée. Dans l'exemple ci-dessus, selObj est automatiquement « convertie » lorsqu'elle est passée à window.alert. Cependant, pour utiliser une propriété ou méthode JavaScript de String comme length ou substr, il est nécessaire d'appeler manuellement la méthode toString. I'm treading carefully with the word "convert" here because it could be misinterpreted as a permanent convert - Maian

+ +

Spécification

+ +

DOM Level 0. Ne fait partie d'aucune spécification.

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/window/hashchange_event/index.html b/files/fr/web/api/window/hashchange_event/index.html deleted file mode 100644 index 59f62fcdd1..0000000000 --- a/files/fr/web/api/window/hashchange_event/index.html +++ /dev/null @@ -1,139 +0,0 @@ ---- -title: hashchange -slug: Web/API/Window/hashchange_event -tags: - - Reference - - Web -translation_of: Web/API/Window/hashchange_event ---- -

L'événement hashchange est déclenché lorsque l'identificateur de fragment de l'URL a changé (la partie de l'URL qui suit le symbole #, y compris le symbole # lui-même).

- - - - - - - - - - - - - - - - - - - - - - - - -
BullesOui
AnnulableNon
Objets cibles{{domxref("Window")}}
Interface{{domxref("HashChangeEvent")}}
Action par défautAucune
- -

Propriétés

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
PropriétéTypeDescription
target {{readonlyInline}}{{domxref("EventTarget")}}The browsing context (window).
type {{readonlyInline}}{{domxref("DOMString")}}Type de l'évènement
bubbles {{readonlyInline}}{{jsxref("Boolean")}}Whether the event normally bubbles or not.
cancelable {{readonlyInline}}{{jsxref("Boolean")}}Whether the event is cancellable or not.
oldURL {{readonlyInline}}{{jsxref("String")}}The previous URL from which the window was navigated.
newURL {{readonlyInline}}{{jsxref("String")}}
- -

Il existe plusieurs scripts de secours listés sur cette page. Fondamentalement, ces scripts vérifient le location.hash à intervalles réguliers. Voici une version qui n'autorise qu'un seul gestionnaire à être lié à la propriété window.onhashchange:

- -
;(function(window) {
-
-  // Sortir si le navigateur implémente cet événement
-  if ("onhashchange" in window) { return; }
-
-  var location = window.location,
-    oldURL = location.href,
-    oldHash = location.hash;
-
-  // Vérifie la hash de la barre d'adresse toutes les 100ms
-  setInterval(function() {
-    var newURL = location.href,
-      newHash = location.hash;
-
-    // Si le hash a été changé et qu'un gestionnaire a été lié...
-    if (newHash != oldHash && typeof window.onhashchange === "function") {
-      // exécute le gestionnaire
-      window.onhashchange({
-        type: "hashchange",
-        oldURL: oldURL,
-        newURL: newURL
-      });
-
-      oldURL = newURL;
-      oldHash = newHash;
-    }
-  }, 100);
-
-})(window);
-
- -

Spécifications

- - - - - - - - - - - - - - -
SpécificationStatusCommentaire
{{SpecName('HTML WHATWG', 'indices.html#event-hashchange', 'hashchange')}}{{Spec2('HTML WHATWG')}}Définition initiale
- -

Compatibilité des navigateurs

- -

{{Compat("api.Window.hashchange_event")}}

- -

Voir aussi

- - diff --git a/files/fr/web/api/window/hashchange_event/index.md b/files/fr/web/api/window/hashchange_event/index.md new file mode 100644 index 0000000000..59f62fcdd1 --- /dev/null +++ b/files/fr/web/api/window/hashchange_event/index.md @@ -0,0 +1,139 @@ +--- +title: hashchange +slug: Web/API/Window/hashchange_event +tags: + - Reference + - Web +translation_of: Web/API/Window/hashchange_event +--- +

L'événement hashchange est déclenché lorsque l'identificateur de fragment de l'URL a changé (la partie de l'URL qui suit le symbole #, y compris le symbole # lui-même).

+ + + + + + + + + + + + + + + + + + + + + + + + +
BullesOui
AnnulableNon
Objets cibles{{domxref("Window")}}
Interface{{domxref("HashChangeEvent")}}
Action par défautAucune
+ +

Propriétés

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
PropriétéTypeDescription
target {{readonlyInline}}{{domxref("EventTarget")}}The browsing context (window).
type {{readonlyInline}}{{domxref("DOMString")}}Type de l'évènement
bubbles {{readonlyInline}}{{jsxref("Boolean")}}Whether the event normally bubbles or not.
cancelable {{readonlyInline}}{{jsxref("Boolean")}}Whether the event is cancellable or not.
oldURL {{readonlyInline}}{{jsxref("String")}}The previous URL from which the window was navigated.
newURL {{readonlyInline}}{{jsxref("String")}}
+ +

Il existe plusieurs scripts de secours listés sur cette page. Fondamentalement, ces scripts vérifient le location.hash à intervalles réguliers. Voici une version qui n'autorise qu'un seul gestionnaire à être lié à la propriété window.onhashchange:

+ +
;(function(window) {
+
+  // Sortir si le navigateur implémente cet événement
+  if ("onhashchange" in window) { return; }
+
+  var location = window.location,
+    oldURL = location.href,
+    oldHash = location.hash;
+
+  // Vérifie la hash de la barre d'adresse toutes les 100ms
+  setInterval(function() {
+    var newURL = location.href,
+      newHash = location.hash;
+
+    // Si le hash a été changé et qu'un gestionnaire a été lié...
+    if (newHash != oldHash && typeof window.onhashchange === "function") {
+      // exécute le gestionnaire
+      window.onhashchange({
+        type: "hashchange",
+        oldURL: oldURL,
+        newURL: newURL
+      });
+
+      oldURL = newURL;
+      oldHash = newHash;
+    }
+  }, 100);
+
+})(window);
+
+ +

Spécifications

+ + + + + + + + + + + + + + +
SpécificationStatusCommentaire
{{SpecName('HTML WHATWG', 'indices.html#event-hashchange', 'hashchange')}}{{Spec2('HTML WHATWG')}}Définition initiale
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Window.hashchange_event")}}

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/window/history/index.html b/files/fr/web/api/window/history/index.html deleted file mode 100644 index 80fc573e76..0000000000 --- a/files/fr/web/api/window/history/index.html +++ /dev/null @@ -1,53 +0,0 @@ ---- -title: Window.history -slug: Web/API/Window/history -translation_of: Web/API/Window/history ---- -
{{APIRef}}
- -

La propriété en lecture seule Window.history renvoie une référence à l'objet {{domxref("History")}}, qui offre la possibilité de manipuler l'historique de session du navigateur (pages visitées dans l'onglet ou le cadre dans lesquels la page courante est chargée).

- -

L'objet History obtenu a les méthodes suivantes : voir la manipulation de l'historique du navigateur pour avoir plus de détails ainsi que des exemples.
- En particulier, cet article explique les caractéristiques des méthodes pushState() et replaceState()qu'il est utile de connaître avant de les utiliser.

- -

Exemple

- -
history.back();     // similaire au bouton de retour
-history.go(-1);     // similaire à history.back();
-
- -

Notes

- -

Pour les pages de niveau supérieur, vous pourrez voir la liste des pages dans l'historique des sessions, accessibles grâce à l'objet History, situé dans le menu déroulant près des boutons précédent et suivant.

- -

Pour des raisons de sécurité, l'objet History n'autorise pas l'accès au URL d'autres pages présentes dans l'historique de la session mais autorise d'y naviguer.

- -

Il n'y a pas de possibilité de nettoyer l'historique de la session ou de désactiver les boutons précédent et suivant. La solution éventuelle la plus proche serait la méthode location.replace(), permettant de remplacer l'élément actuel de l'historique de la session par l'URL fournie.

- -

Spécification

- - - - - - - - - - - - - - - - - - - -
SpecificationStatusCommentaire
{{SpecName('HTML WHATWG', 'browsers.html#the-history-interface', 'The History interface')}}{{Spec2('HTML WHATWG')}}
{{SpecName('HTML5 W3C', 'browsers.html#the-history-interface', 'The History interface')}}{{Spec2('HTML5 W3C')}}
- -

Compatibilité des navigateurs

- - - -

{{Compat("api.Window.history")}}

diff --git a/files/fr/web/api/window/history/index.md b/files/fr/web/api/window/history/index.md new file mode 100644 index 0000000000..80fc573e76 --- /dev/null +++ b/files/fr/web/api/window/history/index.md @@ -0,0 +1,53 @@ +--- +title: Window.history +slug: Web/API/Window/history +translation_of: Web/API/Window/history +--- +
{{APIRef}}
+ +

La propriété en lecture seule Window.history renvoie une référence à l'objet {{domxref("History")}}, qui offre la possibilité de manipuler l'historique de session du navigateur (pages visitées dans l'onglet ou le cadre dans lesquels la page courante est chargée).

+ +

L'objet History obtenu a les méthodes suivantes : voir la manipulation de l'historique du navigateur pour avoir plus de détails ainsi que des exemples.
+ En particulier, cet article explique les caractéristiques des méthodes pushState() et replaceState()qu'il est utile de connaître avant de les utiliser.

+ +

Exemple

+ +
history.back();     // similaire au bouton de retour
+history.go(-1);     // similaire à history.back();
+
+ +

Notes

+ +

Pour les pages de niveau supérieur, vous pourrez voir la liste des pages dans l'historique des sessions, accessibles grâce à l'objet History, situé dans le menu déroulant près des boutons précédent et suivant.

+ +

Pour des raisons de sécurité, l'objet History n'autorise pas l'accès au URL d'autres pages présentes dans l'historique de la session mais autorise d'y naviguer.

+ +

Il n'y a pas de possibilité de nettoyer l'historique de la session ou de désactiver les boutons précédent et suivant. La solution éventuelle la plus proche serait la méthode location.replace(), permettant de remplacer l'élément actuel de l'historique de la session par l'URL fournie.

+ +

Spécification

+ + + + + + + + + + + + + + + + + + + +
SpecificationStatusCommentaire
{{SpecName('HTML WHATWG', 'browsers.html#the-history-interface', 'The History interface')}}{{Spec2('HTML WHATWG')}}
{{SpecName('HTML5 W3C', 'browsers.html#the-history-interface', 'The History interface')}}{{Spec2('HTML5 W3C')}}
+ +

Compatibilité des navigateurs

+ + + +

{{Compat("api.Window.history")}}

diff --git a/files/fr/web/api/window/home/index.html b/files/fr/web/api/window/home/index.html deleted file mode 100644 index 856f95067c..0000000000 --- a/files/fr/web/api/window/home/index.html +++ /dev/null @@ -1,36 +0,0 @@ ---- -title: Window.home() -slug: Web/API/Window/home -tags: - - API - - Gecko - - HTML DOM - - Méthode - - Obsolete - - Reference - - Window -translation_of: Web/API/Window/home ---- -
{{APIRef}}{{ Non-standard_header() }} {{ obsolete_header(31) }}
- -

La méthode Window.home() renvoie la fenêtre à la page d'accueil.

- -

Syntaxe

- -
window.home();
-
- -

Exemple

- -
function goHome() {
-  window.home();
-}
-
- -

Spécification

- -

DOM Niveau 0. Ne fait pas partie de la spécification.

- -

Compatibilité des navigateurs

- -

{{Compat("api.Window.home")}}

diff --git a/files/fr/web/api/window/home/index.md b/files/fr/web/api/window/home/index.md new file mode 100644 index 0000000000..856f95067c --- /dev/null +++ b/files/fr/web/api/window/home/index.md @@ -0,0 +1,36 @@ +--- +title: Window.home() +slug: Web/API/Window/home +tags: + - API + - Gecko + - HTML DOM + - Méthode + - Obsolete + - Reference + - Window +translation_of: Web/API/Window/home +--- +
{{APIRef}}{{ Non-standard_header() }} {{ obsolete_header(31) }}
+ +

La méthode Window.home() renvoie la fenêtre à la page d'accueil.

+ +

Syntaxe

+ +
window.home();
+
+ +

Exemple

+ +
function goHome() {
+  window.home();
+}
+
+ +

Spécification

+ +

DOM Niveau 0. Ne fait pas partie de la spécification.

+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Window.home")}}

diff --git a/files/fr/web/api/window/index.html b/files/fr/web/api/window/index.html deleted file mode 100644 index d5c5e70052..0000000000 --- a/files/fr/web/api/window/index.html +++ /dev/null @@ -1,568 +0,0 @@ ---- -title: window -slug: Web/API/Window -tags: - - API - - DOM - - Interface - - JavaScript - - Reference - - Window -translation_of: Web/API/Window ---- -

{{APIRef}}

- -

L'objet window représente une fenêtre contenant un document DOM ; la propriété document pointe vers le document DOM chargé dans cette fenêtre. Une fenêtre pour un document donné peut être obtenue en utilisant la propriété {{Domxref("document.defaultView")}}.

- -

Cette section fournit une brève référence pour toutes les méthodes, propriétés et événements disponibles via l'objet DOM window. L'objet window implémente l'interface Window, qui à son tour hérite de l'interface AbstractView. Certaines fonctions globales supplémentaires, espaces de noms, objets, interfaces et constructeurs, non typiquement associés à la fenêtre, mais disponibles sur celle-ci, sont répertoriés dans la Référence JavaScript et la Référence DOM.

- -

Dans un navigateur utilisant des onglets, comme Firefox, chaque onglet contient son propre objet window (et si vous écrivez une extension, la fenêtre du navigateur elle-même est un objet window séparé — consultez Travailler avec des fenêtres dans du code chrome pour plus d'informations). C'est-à-dire que l'objet window n'est pas partagé entre les onglets dans la même fenêtre. Certaines méthodes, notamment {{ Domxref("window.resizeTo") }} et {{ Domxref("window.resizeBy") }}, s'appliquent à la fenêtre entière et non à l'onglet spécifique auquel l'objet window appartient. En général, ce qui ne peut raisonnablement pas concerner un onglet se rapporte à la fenêtre à la place.

- -

{{InheritanceDiagram}}

- -

Propriétés

- -

Cette interface hérite des propriétés de l'interface {{domxref("EventTarget")}} et implémente les propriétés des mixins {{domxref("WindowOrWorkerGlobalScope")}} et {{domxref("WindowEventHandlers")}}.

- -

Notez que les propriétés qui sont des objets (par exemple, pour redéfinir le prototype d'éléments intrinsèques) sont répertoriées dans une section distincte ci-dessous.

- -
-
{{domxref("Window.closed")}} {{Non-standard_inline}}{{readOnlyInline}}
-
Cette propriété indique si la fenêtre en cours est fermée ou non.
-
{{domxref("Window.console")}} {{ReadOnlyInline}}
-
Renvoie une référence à l'objet console qui fournit l'accès à la console de débogage du navigateur.
-
{{domxref("Window.content")}} et Window._content {{Non-standard_inline}} {{obsolete_inline}}{{ReadOnlyInline}}
-
Renvoie une référence à l'élément de contenu dans la fenêtre en cours. Depuis Firefox 57 (initialement Nightly uniquement), les deux versions sont uniquement disponibles à partir du code chrome (privilégié) et ne sont plus disponibles sur le Web.
-
{{domxref("Window.controllers")}}{{non-standard_inline}}{{ReadOnlyInline}}
-
Renvoie les objets du contrôleur XUL pour la fenêtre chrome en cours.
-
{{domxref("Window.customElements")}}{{ReadOnlyInline}}
-
renvoie une référence à l'objet {{domxref("CustomElementRegistry")}}, qui peut être utilisée pour enregistrer de nouveaux éléments personnalisés et obtenir des informations à propos d'éléments personnalisés précédemment enregistrés.
-
{{domxref("Window.crypto")}} {{readOnlyInline}}
-
Retourne l'objet crypto du navigateur.
-
{{domxref("Window.defaultStatus")}} {{Obsolete_inline("gecko23")}}
-
Récupère / définit le texte de la barre d'état pour la fenêtre donnée.
-
{{domxref("Window.devicePixelRatio")}} {{non-standard_inline}}{{ReadOnlyInline}}
-
Renvoie le rapport entre les pixels physiques et les pixels indépendants du périphérique dans l'affichage en cours.
-
{{domxref("Window.dialogArguments")}} {{ReadOnlyInline}}
-
Récupère les arguments passés à la fenêtre (si c'est une boîte de dialogue) au moment où {{domxref ("window.showModalDialog()")}} a été appelé. C'est un {{Interface("nsIArray")}}.
-
{{domxref("Window.directories")}} {{obsolete_inline}}
-
Synonyme de {{domxref("window.personalbar")}}
-
{{domxref("Window.document")}} {{ReadOnlyInline}}
-
Renvoie une référence au document que la fenêtre contient.
-
{{domxref("Window.DOMMatrix")}} {{readOnlyInline}} {{experimental_inline}}
-
Renvoie une référence à un objet {{domxref("DOMMatrix")}} représentant des matrices 4x4, adapté aux opérations 2D et 3D.
-
{{domxref("Window.DOMMatrixReadOnly")}} {{readOnlyInline}} {{experimental_inline}}
-
Renvoie une référence à un objet {{domxref("DOMMatrixReadOnly")}} représentant des matrices 4x4, adapté aux opérations 2D et 3D.
-
{{domxref("Window.DOMPoint")}} {{readOnlyInline}} {{experimental_inline}}
-
Renvoie une référence à un objet {{domxref("DOMPoint")}} représentant un point 2D ou 3D dans un système de coordonnées.
-
{{domxref("Window.DOMPointReadOnly")}} {{readOnlyInline}} {{experimental_inline}}
-
Renvoie une référence à un objet {{domxref("DOMPointReadOnly")}} représentant un point 2D ou 3D dans un système de coordonnées.
-
{{domxref("Window.DOMQuad")}} {{readOnlyInline}} {{experimental_inline}}
-
Renvoie une référence à un objet {{domxref("DOMQuad")}}, qui fournit un objet quadrilatère, c'est-à-dire, ayant quatre coins et quatre côtés.
-
{{domxref("Window.DOMRect")}} {{readOnlyInline}} {{experimental_inline}}
-
Returns a reference to a {{domxref("DOMRect")}} object, which represents a rectangle.
-
{{domxref("Window.DOMRectReadOnly")}} {{readOnlyInline}} {{experimental_inline}}
-
Renvoie une référence à un objet {{domxref("DOMRectReadOnly")}} représentant un rectangle.
-
{{domxref("Window.frameElement")}} {{readOnlyInline}}
-
Renvoie l'élément dans lequel la fenêtre est intégrée, ou null si la fenêtre n'est pas intégrée.
-
{{domxref("Window.frames")}} {{readOnlyInline}}
-
Renvoie un tableau des sous-cadres dans la fenêtre en cours.
-
{{domxref("Window.fullScreen")}} {{gecko_minversion_inline("1.9")}}
-
Cette propriété indique si la fenêtre est affichée en plein écran ou non.
-
{{domxref("Window.globalStorage")}} {{gecko_minversion_inline("1.8.1")}} {{Non-standard_inline}} {{Obsolete_inline("gecko13")}}
-
Non supporté depuis Gecko 13 (Firefox 13). Utilisez {{domxref("Window.localStorage")}} à la place.
- Était : divers objets de stockage utilisés pour stocker des données sur plusieurs pages.
-
{{domxref("Window.history")}} {{ReadOnlyInline}}
-
Retourne une référence à l'objet d'historique.
-
{{domxref("Window.innerHeight")}} {{readOnlyInline}}
-
Récupère la hauteur de la zone de contenu de la fenêtre du navigateur, y compris, si affichée, la barre de défilement horizontale.
-
{{domxref("Window.innerWidth")}} {{readOnlyInline}}
-
Récupère la largeur de la zone de contenu de la fenêtre du navigateur, y compris, si affichée, la barre de défilement verticale.
-
{{domxref("Window.isSecureContext")}} {{readOnlyInline}}
-
Indique si un contexte est capable d'utiliser des fonctionnalités nécessitant des contextes sécurisés.
-
{{domxref("Window.length")}} {{readOnlyInline}}
-
Renvoie le nombre de cadres dans la fenêtre. Voir également {{domxref("window.frames")}}.
-
{{domxref("Window.location")}}
-
Récupère/définit l'emplacement, ou l'URL en cours, de l'objet de fenêtre.
-
{{domxref("Window.locationbar")}} {{ReadOnlyInline}}
-
Renvoie l'objet de la barre d'adresse, dont la visibilité peut être inversée dans la fenêtre.
-
{{domxref("Window.localStorage")}} {{readOnlyInline}}{{gecko_minversion_inline("1.9.1")}}
-
Renvoie une référence à l'objet de stockage local utilisé pour stocker les données accessibles uniquement par l'origine qui les a créées.
-
{{domxref("Window.menubar")}} {{ReadOnlyInline}}
-
Renvoie l'objet barre de menus, dont la visibilité peut être inversée dans la fenêtre.
-
{{domxref("Window.messageManager")}} {{gecko_minversion_inline("2.0")}}
-
Renvoie l'objet gestionnaire de messages pour cette fenêtre.
-
{{domxref("Window.mozAnimationStartTime")}} {{ReadOnlyInline}}{{gecko_minversion_inline("2.0")}} {{Deprecated_inline}}
-
Le temps en millisecondes depuis l'instant auquel le cycle d'animation en cours a commencé.
-
{{domxref("Window.mozInnerScreenX")}} {{ReadOnlyInline}}{{non-standard_inline}}{{gecko_minversion_inline("1.9.2")}}
-
Renvoie la coordonnée horizontale (X) du coin supérieur gauche du point de vue de la fenêtre, en coordonnées d'écran. Cette valeur est restituée en pixels CSS. Voir mozScreenPixelsPerCSSPixel dans {{interface("nsIDOMWindowUtils")}} pour un facteur de conversion pour s'adapter aux pixels de l'écran si nécessaire.
-
{{domxref("Window.mozInnerScreenY")}} {{ReadOnlyInline}} {{non-standard_inline}}{{gecko_minversion_inline("1.9.2")}}
-
Renvoie la coordonnée verticale (Y) du coin supérieur gauche du point de vue de la fenêtre, en coordonnées d'écran. Cette valeur est indiquée en pixels CSS. Voir mozScreenPixelsPerCSSPixel pour un facteur de conversion pour s'adapter aux pixels de l'écran si nécessaire.
-
{{domxref("Window.mozPaintCount")}} {{non-standard_inline}}{{ReadOnlyInline}} {{gecko_minversion_inline("2.0")}}
-
Renvoie le nombre de fois où le document en cours a été réaffiché à l'écran dans cette fenêtre. Cela peut être utilisé pour calculer les performances d'affichage.
-
{{domxref("Window.name")}}
-
Récupère / définit le nom de la fenêtre.
-
{{domxref("Window.navigator")}} {{readOnlyInline}}
-
Renvoie une référence à l'objet navigateur.
-
{{domxref("Window.NetworkInformation")}} {{readOnlyInline}} {{experimental_inline}}
-
Renvoie une référence à l'interface {{domxref("NetworkInformation")}}, qui fournit des informations sur la connexion qu'un périphérique est en train d'utiliser pour communiquer avec le réseau et fournit un moyen pour les scripts d'être notifiés si le type de connexion change. 
-
{{domxref("Window.opener")}}
-
Renvoie une référence à la fenêtre qui a ouvert la fenêtre en cours.
-
{{domxref("Window.orientation")}}{{non-standard_inline}}{{deprecated_inline}}{{readOnlyInline}}
-
Renvoie l'orientation en degrés (par incréments de 90 degrés) du point de vue par rapport à l'orientation naturelle du périphérique.
-
{{domxref("Window.outerHeight")}} {{readOnlyInline}}
-
Récupère la hauteur de l'extérieur de la fenêtre du navigateur.
-
{{domxref("Window.outerWidth")}} {{readOnlyInline}}
-
Récupère la largeur de l'extérieur de la fenêtre du navigateur.
-
{{domxref("Window.scrollX","Window.pageXOffset")}} {{readOnlyInline}}
-
Un alias pour {{domxref("window.scrollX")}}.
-
{{domxref("Window.scrollY","Window.pageYOffset")}}{{readOnlyInline}}
-
Un alias pour {{domxref("window.scrollY")}}
-
{{domxref("Window.sessionStorage")}} {{readOnlyInline}}
-
Renvoie une référence à l'objet de stockage de session utilisé pour stocker les données accessibles uniquement par l'origine qui les a créées..
-
{{domxref("Window.parent")}} {{readOnlyInline}}
-
Renvoie une référence au parent de la fenêtre ou du sous-cadre en cours.
-
{{domxref("Window.performance")}} {{readOnlyInline}}
-
Renvoie un objet {{domxref("Performance")}}, qui inclut les attributs {{domxref("Performance.timing", "timing")}} et {{domxref("Performance.navigation", "navigation")}}, dont chacun est un objet fournissant des données liées aux performances. Voir aussi Utilisation de Chronométrage de Navigation pour plus d'informations et d'exemples.
-
{{domxref("Window.personalbar")}} {{readOnlyInline}}
-
Renvoie l'objet barre personnelle, dont la visibilité peut être inversée dans la fenêtre.
-
{{domxref("Window.pkcs11")}} {{obsolete_inline(29)}}
-
Fournissait précédemment un accès pour installer et supprimer des modules PKCS11.
-
{{domxref("Window.returnValue")}}
-
La valeur de retour à renvoyer à la fonction qui a appelé {{domxref("window.showModalDialog()")}} pour afficher la fenêtre comme boîte de dialogue modale.
-
{{domxref("Window.screen")}} {{readOnlyInline}}
-
Renvoie une référence à l'objet écran associé à la fenêtre.
-
{{domxref("Window.screenX")}} {{readOnlyInline}}
-
Renvoie la distance horizontale de la bordure gauche du navigateur de l'utilisateur à partir du côté gauche de l'écran.
-
{{domxref("Window.screenY")}} {{readOnlyInline}}
-
Renvoie la distance verticale de la bordure supérieure du navigateur de l'utilisateur à partir du haut de l'écran.
-
{{domxref("Window.scrollbars")}} {{readOnlyInline}}
-
Renvoie l'objet barres de défilement, dont la visibilité peut être modifiée dans la fenêtre.
-
{{domxref("Window.scrollMaxX")}}{{non-standard_inline}}{{ReadOnlyInline}}
-
Le décalage maximal dont la fenêtre peut étre décalée horizontalement, c'est-à-dire la largeur du document moins la largeur du point de vue.
-
{{domxref("Window.scrollMaxY")}}{{non-standard_inline}}{{ReadOnlyInline}}
-
Le décalage maximal dont la fenêtre peut étre décalée verticalement (c'est-à-dire, la hauteur du document moins la hauteur du point de vue).
-
{{domxref("Window.scrollX")}} {{readOnlyInline}}
-
Renvoie le nombre de pixels dont le document a déjà été décalé horizontalement.
-
{{domxref("Window.scrollY")}} {{readOnlyInline}}
-
Renvoie le nombre de pixels dont le document a déjà été décalé verticalement.
-
{{domxref("Window.self")}} {{ReadOnlyInline}}
-
Renvoie une référence d'objet à l'objet fenêtre lui-même.
-
{{domxref("Window.sessionStorage")}}
-
Renvoie un objet de stockage pour stocker des données dans une session de page unique.
-
{{domxref("Window.sidebar")}} {{non-standard_inline}}{{ReadOnlyInline}}
-
Renvoie une référence à l'objet fenêtre de la barre latérale.
-
{{domxref("Window.speechSynthesis")}} {{ReadOnlyInline}}
-
Renvoie un objet {{domxref("SpeechSynthesis")}}, qui est le point d'entrée pour l'utilisation de la fonctionnalité de synthèse vocale de l'API Web Speech.
-
{{domxref("Window.status")}}
-
Récupère/définit le texte dans la barre d'état en bas du navigateur.
-
{{domxref("Window.statusbar")}} {{readOnlyInline}}
-
Renvoie l'objet barre d'état, dont la visibilité peut être inversée dans la fenêtre.
-
{{domxref("Window.toolbar")}} {{readOnlyInline}}
-
Renvoie l'objet barre d'outils, dont la visibilité peut être inversée dans la fenêtre.
-
{{domxref("Window.top")}} {{readOnlyInline}}
-
Renvoie une référence à la fenêtre la plus haute dans la hiérarchie des fenêtres. Cette propriété est en lecture seule.
-
{{domxref("Window.visualViewport")}} {{readOnlyInline}}
-
Renvoie un objet {{domxref("VisualViewport")}} représentant le point de vue visuel pour une fenêtre donnée.
-
{{domxref("Window.window")}} {{ReadOnlyInline}}
-
Renvoie une référence à la fenêtre en cours.
-
window[0], window[1], etc.
-
Renvoie une référence à l'objet window dans les cadres. Voir {{domxref("Window.frames")}}} pour plus de détails.
-
- -

Propriétés implémentées depuis ailleurs

- -
-
{{domxref("WindowOrWorkerGlobalScope.caches")}} {{readOnlyinline}}
-
Renvoie l'objet {{domxref("CacheStorage")}} associé au contexte en cours. Cet objet active des fonctionnalités telles que le stockage des ressources pour une utilisation hors connexion, et la génération de réponses personnalisées aux requêtes.
-
{{domxref("WindowOrWorkerGlobalScope.indexedDB")}} {{readonlyInline}}
-
Fournit un mécanisme permettant aux applications d'accéder de manière asynchrone à des bases de données indexées ; renvoie un objet {{domxref("IDBFactory")}}.
-
{{domxref("WindowOrWorkerGlobalScope.isSecureContext")}} {{readOnlyinline}}
-
Renvoie un booléen indiquant si le contexte actuel est sécurisé (true) ou non (false).
-
{{domxref("WindowOrWorkerGlobalScope.origin")}} {{readOnlyinline}}
-
Renvoie l'origine de l'objet global, sérialisé comme une chaîne. (Cela ne semble pas encore être implémenté dans aucun navigateur.)
-
- -

Méthodes

- -

Cette interface hérite des méthodes de l'interface {{domxref("EventTarget")}} et implémente les méthodes de {{domxref("WindowOrWorkerGlobalScope")}} et {{domxref("EventTarget")}}.

- -
-
{{domxref("Window.alert()")}}
-
Affiche une boîte de message d'alerte.
-
{{domxref("Window.back()")}} {{Non-standard_inline}} {{obsolete_inline}}
-
Recule d'une page dans l'historique de la fenêtre.
-
{{domxref("Window.blur()")}}
-
Déplace la focalisation hors de la fenêtre.
-
{{domxref("Window.cancelAnimationFrame()")}} {{experimental_inline}}
-
Vous permet d'annuler un rappel précédemment planifié avec {{domxref("Window.requestAnimationFrame")}}.
-
{{domxref("Window.cancelIdleCallback()")}} {{experimental_inline}}
-
Vous permet d'annuler un rappel précédemment planifié avec {{domxref("Window.requestIdleCallback")}}.
-
{{domxref("Window.captureEvents()")}} {{Deprecated_inline}}
-
Enregistre la fenêtre pour qu'elle capture tous les évènements du type spécifié.
-
{{domxref("Window.clearImmediate()")}}
-
Annule l'exécution répétée définie en utilisant setImmediate.
-
{{domxref("Window.close()")}}
-
Ferme la fenêtre en cours.
-
{{domxref("Window.confirm()")}}
-
Affiche une boîte de dialogue avec un message auquel l'utilisateur doit répondre.
-
{{domxref("Window.disableExternalCapture()")}} {{obsolete_inline(24)}}
-
{{todo("NeedsContents")}}
-
{{domxref("Window.dispatchEvent()")}}
-
Utilisé pour déclencher un évènement.
-
{{domxref("Window.dump()")}} {{Non-standard_inline}}
-
Écrit un message à la console.
-
{{domxref("Window.enableExternalCapture()")}} {{obsolete_inline(24)}}
-
{{todo("NeedsContents")}}
-
{{domxref("Window.find()")}}
-
Recherche la chaîne de caractères donnée dans une fenêtre.
-
{{domxref("Window.focus()")}}
-
Donne la focalisation à la fenêtre en cours.
-
{{domxref("Window.forward()")}} {{Non-standard_inline}} {{obsolete_inline}}
-
Avance la fenêtre d'un document dans l'historique.
-
{{domxref("Window.getAttention()")}} {{Non-standard_inline}} {{obsolete_inline}}
-
Fait flasher l'icône de l'application.
-
{{domxref("Window.getAttentionWithCycleCount()")}}
-
{{todo("NeedsContents")}}
-
{{domxref("Window.getComputedStyle()")}}
-
Récupère un style calculé pour l'élément donné. Un style calculé indique les valeurs de toutes les propriétés CSS de l'élément.
-
{{domxref("Window.getDefaultComputedStyle()")}} {{Non-standard_inline}}
-
Récupère le style calculé par défaut pour l'élément indiqué, en ignorant les feuilles de style d'auteur.
-
{{domxref("Window.getSelection()")}}
-
Renvoie l'objet de sélection représentant les éléments sélectionnés.
-
{{domxref("Window.home()")}} {{Non-standard_inline}} {{obsolete_inline}}
-
Renvoie le navigateur à la page d'accueil.
-
{{domxref("Window.matchMedia()")}} {{gecko_minversion_inline("6.0")}}
-
Renvoie un objet {{domxref("MediaQueryList")}} représentant la chaîne d'interrogation de média spécifiée.
-
{{domxref("Window.maximize()")}}
-
{{todo("NeedsContents")}}
-
{{domxref("Window.minimize()")}} (top-level XUL windows only)
-
Minimize la fenêtre.
-
{{domxref("Window.moveBy()")}}
-
Déplace la fenêtre en cours de la quantité indiquée.
-
{{domxref("Window.moveTo()")}}
-
Déplace la fenêtre vers les coordonnées spécifiées.
-
{{domxref("Window.open()")}}
-
Ouvre une nouvelle fenêtre.
-
{{domxref("Window.openDialog()")}} {{Non-standard_inline}} {{obsolete_inline}}
-
Ouvre une nouvelle fenêtre de dialogue.
-
{{domxref("Window.postMessage()")}}
-
Fournit un moyen sécurisé pour une fenêtre d'envoyer une chaîne de données à une autre fenêtre, qui n'a pas besoin d'être dans le même domaine que la première.
-
{{domxref("Window.prompt()")}}
-
Ouvre la boîte de dialogue d'impression du document en cours.
-
{{domxref("Window.prompt()")}}
-
Renvoie le texte saisi par l'utilisateur dans une boîte de dialogue à invite.
-
{{domxref("Window.releaseEvents()")}} {{Non-standard_inline}} {{Deprecated_inline}}
-
Annule la capture des évènements d'un certain type par la fenêtre.
-
{{domxref("Window.requestAnimationFrame()")}} {{gecko_minversion_inline("2.0")}}
-
Indique au navigateur qu'une animation est en cours, en demandant au navigateur de planifier une redessinage de la fenêtre lors de l'image d'animation suivante.
-
{{domxref("Window.requestIdleCallback()")}}  {{experimental_inline}}
-
Active la planification de tâches pendant les périodes d'inactivité du navigateur.
-
{{domxref("Window.resizeBy()")}}
-
Redimensionne la fenêtre en cours d'une certaine quantité.
-
{{domxref("Window.resizeTo()")}}
-
Redimensionne dynamiquement la fenêtre.
-
{{domxref("Window.restore()")}} {{Non-standard_inline}} {{obsolete_inline}}
-
{{todo("NeedsContents")}}
-
{{domxref("Window.routeEvent()")}} {{obsolete_inline(24)}}
-
{{todo("NeedsContents")}}
-
{{domxref("Window.scroll()")}}
-
Fait défiler la fenêtre à un endroit particulier dans le document.
-
{{domxref("Window.scrollBy()")}}
-
Fait défiler le document dans la fenêtre de la quantité indiquée.
-
{{domxref("Window.scrollByLines()")}} {{Non-standard_inline}}
-
Fait défiler le document du nombre de lignes indiqué.
-
{{domxref("Window.scrollByPages()")}} {{Non-standard_inline}}
-
Fait défiler le document en cours du nombre de pages indiqué.
-
{{domxref("Window.scrollTo()")}}
-
Fait défiler à un jeu de coordonnées particulier dans le document.
-
{{domxref("Window.setCursor()")}} {{Non-standard_inline}} (top-level XUL windows only)
-
Change le curseur pour la fenêtre en cours.
-
{{domxref("Window.setImmediate()")}}
-
Exécute une fonction après que le navigateur a terminé d'autres tâches lourdes
-
{{domxref("Window.setResizable()")}} {{Non-standard_inline}}
-
Inverse la possibilité pour un utilisateur de redimensionner une fenêtre.
-
{{domxref("Window.sizeToContent()")}} {{Non-standard_inline}}
-
Dimensionne la fenêtre en fonction de son contenu.
-
{{domxref("Window.stop()")}}
-
Cette méthode arrête le chargement de la fenêtre.
-
{{domxref("Window.updateCommands()")}} {{Non-standard_inline}}
-
Met à jour l'état des commandes de la fenêtre chrome en cours (IU).
-
- -

Méthodes implémentées depuis ailleurs

- -
-
{{domxref("EventTarget.addEventListener()")}}
-
Enregistre un gestionnaire d'événement pour un type d'événement spécifique dans la fenêtre.
-
{{domxref("WindowOrWorkerGlobalScope.atob()")}}
-
Décode une chaîne de données qui a été codée en utilisant l'encodage en base 64.
-
{{domxref("WindowOrWorkerGlobalScope.btoa()")}}
-
Crée une chaîne ASCII codée en base 64 à partir d'une chaîne de données binaires.
-
{{domxref("WindowOrWorkerGlobalScope.clearInterval()")}}
-
Annule l'exécution répétée définie en utilisant {{domxref("WindowOrWorkerGlobalScope.setInterval ()")}}.
-
{{domxref("WindowOrWorkerGlobalScope.clearTimeout()")}}
-
Annule l'exécution différée définie en utilisant {{domxref("WindowOrWorkerGlobalScope.setTimeout ()")}}.
-
{{domxref("WindowOrWorkerGlobalScope.createImageBitmap()")}}
-
Accepte une variété de sources d'images différentes, et renvoie un {{domxref("Promise")}} qui se résout en une {{domxref("ImageBitmap")}}. En option, la source est détourée avec le rectangle des pixels d'origine en (sx, sy) et de largeur sw, et de hauteur sh.
-
{{domxref("WindowOrWorkerGlobalScope.fetch()")}}
-
Démarre le processus de récupération d'une ressource à partir du réseau.
-
{{domxref("EventTarget.removeEventListener")}}
-
Supprime un gestionnaire d'événement de la fenêtre.
-
{{domxref("WindowOrWorkerGlobalScope.setInterval()")}}
-
Planifie une fonction à exécuter à chaque fois qu'un nombre donné de millisecondes s'est écoulé.
-
{{domxref("WindowOrWorkerGlobalScope.setTimeout()")}}
-
Planifie une fonction à exécuter dans un laps de temps donné.
-
- -

Méthodes obsolètes

- -
-
{{domxref("Window.showModalDialog()")}} {{obsolete_inline}}
-
Affiche un dialogue modal. Cette méthode a été complètement supprimée dans Chrome 43, et dans Firefox 55.
-
- -

Gestionnaires d'évènements

- -

Ce sont des propriétés de l'objet window qui peuvent être définies pour établir des gestionnaires d'événements pour les différentes choses qui peuvent se produire dans la fenêtre et qui pourraient être intéressantes.

- -

Cette interface hérite des gestionnaires d'événements de l'interface {{domxref("EventTarget")}} et elle implémente les gestionnaires d'événements de {{domxref("WindowEventHandlers")}}.

- -
-

Note : à partir de {{Gecko ("9.0")}}, vous pouvez maintenant utiliser la syntaxe if ("onabort" in window) pour déterminer si une propriété de gestionnaire d'événements donnée existe ou non. Cela est dû au fait que les interfaces du gestionnaire d'événements ont été mises à jour pour être des interfaces Web IDL correctes. Voir les gestionnaires d'événements DOM pour plus de détails.

-
- -
-
{{domxref("GlobalEventHandlers.onabort")}}
-
 
-
Appelé quand le chargement d'une ressource a été avorté, comme par le fait qu'un utilisateur annule un chargement alors qu'il était encore en cours.
-
- -
-
{{domxref("WindowEventHandlers.onafterprint")}}
-
Appelé lorsque la boîte de dialogue d'impression est fermée. Voir l'événement {{event ("afterprint")}}.
-
{{domxref("WindowEventHandlers.onbeforeprint")}}
-
Appelé lorsque la boîte de dialogue d'impression est ouverte. Voir l'événement {{event ("beforeprint")}}.
-
{{domxref("Window.onbeforeinstallprompt")}}
-
Propriété de gestionnaire d'événements qui est déclenchée avant qu'un utilisateur ne soit invité à enregistrer un site Web sur un écran d'accueil sur mobile.
-
{{domxref("WindowEventHandlers.onbeforeunload")}}
-
Propriété de gestionnaire d'événements pour les événements avant-déchargement dans la fenêtre.
-
- -
-
{{domxref("GlobalEventHandlers.onblur")}}
-
Appelé après que la fenêtre a perdu la focalisation, comme en raison d'une fenêtre contextuelle.
-
- -
-
{{domxref("GlobalEventHandlers.onchange")}}
-
Propriété de gestionnaire d'événements pour les événements de changement dans la fenêtre.
-
- -
-
{{domxref("GlobalEventHandlers.onclick")}}
-
Appelé après qu'un QUELCONQUE bouton de la souris est pressé & relâché.
-
- -
-
{domxref("GlobalEventHandlers.ondblclick")}}
-
Appelé quand un double clic est fait avec un QUELCONQUE bouton de la souris.
-
{{domxref("GlobalEventHandlers.onclose")}}
-
Appelé après la fermeture de la fenêtre.
-
- -
-
{{domxref("GlobalEventHandlers.oncontextmenu")}}
-
Appelé lorsque le bouton DROIT de la souris est enfoncé.
-
- -
-
{{domxref("Window.ondevicelight")}}
-
Propriété de gestionnaire d'événements pour tous les changements de niveaux de luminosité ambiante.
-
{{domxref("Window.ondevicemotion")}} {{gecko_minversion_inline("6.0")}}
-
Appelé si l'accéléromètre détecte un changement (pour les appareils mobiles).
-
{{domxref("Window.ondeviceorientation")}} {{gecko_minversion_inline("6.0")}}
-
Appelé lorsque l'orientation est modifiée (pour les appareils mobiles).
-
{{domxref("Window.ondeviceorientationabsolute")}} {{non-standard_inline}} Chrome only
-
Propriété de gestionnaire d'événements pour tout changement d'orientation de l'appareil.
-
{{domxref("Window.ondeviceproximity")}}
-
Propriété de gestionnaire d'événement pour l'événement de proximité de l'appareil.
-
- -
-
{{domxref("GlobalEventHandlers.onerror")}}
-
Appelé lorsqu'une ressource ne se charge pas OU lorsqu'une erreur se produit lors de l'exécution. Voir l'événement {{event("error")}}.
-
- -
-
{{domxref("GlobalEventHandlers.onfocus")}}
-
Appelé après que la fenêtre a reçu ou récupéré la focalisation. Voir les événements {{event("focus")}}.
-
- -
-
{{domxref("WindowEventHandlers.onhashchange")}} {{gecko_minversion_inline("1.9.2")}}
-
Propriété de gestionnaire d'événements pour les événements {{event('hashchange')}} dans la fenêtre ; appelé lorsque la partie de l'URL après la marque hash ("#") change.
-
{{domxref("Window.onappinstalled")}}
-
Appelé lorsque la page est installée en tant que webapp. Voir l'événement {{event('appinstalled')}}.
-
{{domxref("Window.ongamepadconnected")}}
-
Représente un gestionnaire d'événements qui sera exécuté lorsqu'une manette de jeu est branchée (lorsque l'événement {{event('gamepadconnected')}} se déclenche).
-
{{domxref("Window.ongamepaddisconnected")}}
-
Représente un gestionnaire d'événements qui s'exécutera quand une manette de jeu est débranchée (lorsque l'événement {{event('gamepaddisconnected')}} se déclenche).
-
{{domxref("Window.oninput")}}
-
Appelée lorsque la valeur d'un élément <input> change.
-
{{domxref("GlobalEventHandlers.onkeydown")}}
-
Appelé lorsque vous commencez à presser une touche QUELCONQUE. Voir l'événement {{event("keydown")}}.
-
- -
-
{{domxref("GlobalEventHandlers.onkeypress")}}
-
Appelé lorsqu'une touche (à l'exception de Shift, Fn et CapsLock) est en position pressée. Voir l'événement {{event("keypress")}}.
-
- -
-
{{domxref("GlobalEventHandlers.onkeyup")}}
-
Appelé lorsque vous avez fini de relâcher une touche QUELCONQUE. Voir l'événement {{event("keyup")}}.
-
- -
-
{{domxref("WindowEventHandlers.onlanguagechange")}}
-
Propriété de gestionnaire d'événements pour les événements {{event("languagechange")}} dans la fenêtre.
-
{{domxref("GlobalEventHandlers.onload")}}
-
Appelé après que toutes les ressources et les DOM ont été entièrement chargés. NE SERA PAS appelé lorsque la page est chargée à partir du cache, comme avec le bouton arrière.
-
- -
-
{{domxref("GlobalEventHandlers.onmousedown")}}
-
Appelé quand un bouton QUELCONQUE de la souris est pressé.
-
- -
-
{{domxref("GlobalEventHandlers.onmousemove")}}
-
Appelé en continu quand la souris est déplacée dans la fenêtre.
-
- -
-
{{domxref("GlobalEventHandlers.onmouseout")}}
-
Appelé lorsque le pointeur quitte la fenêtre.
-
- -
-
{{domxref("GlobalEventHandlers.onmouseover")}}
-
Appelé lorsque le pointeur entre dans la fenêtre.
-
- -
-
{{domxref("GlobalEventHandlers.onmouseup")}}
-
Appelé quand un bouton QUELCONQUE de la souris est relâché.
-
- -
-
{{domxref("Window.onmozbeforepaint")}} {{gecko_minversion_inline("2.0")}}
-
Propriété de gestionnaire d'événements pour l'événement MozBeforePaint, qui est déclenché avant de repeindre la fenêtre si l'événement a été demandé par un appel à la méthode {{domxref("Window.mozRequestAnimationFrame()")}}.
-
{{domxref("WindowEventHandlers.onoffline")}}
-
Appelé lorsque la connexion réseau est perdue. Voir l'événement {{event("offline")}}.
-
{{domxref("WindowEventHandlers.ononline")}}
-
Appelé lorsque la connexion réseau est établie. Voir l'événement {{event("online")}}.
-
{{domxref("WindowEventHandlers.onpagehide")}}
-
Appelé lorsque l'utilisateur quitte la page, avant l'événement onunload. Voir l'événement {{event("pagehide")}}.
-
{{domxref("WindowEventHandlers.onpageshow")}}
-
Appelé après toutes les ressources et les DOM ont été entièrement chargés. Voir l'événement {{event("pageshow")}}.
-
{{domxref("Window.onpaint")}}
-
Propriété de gestionnaire d'évènement pour les évènements de dessin de la fenêtre.
-
- -
-
{{domxref("WindowEventHandlers.onpopstate")}} {{gecko_minversion_inline("2.0")}}
-
Appelé quand le bouton arrière est pressé.
-
{{domxref("Window.onrejectionhandled")}} {{experimental_inline}}
-
Gestionnaire d'événements pour les événements de rejet {{jsxref("Promise")}} gérés.
-
{{domxref("GlobalEventHandlers.onreset")}}
-
Appelé lorsqu'un formulaire est réinitialisé
-
- -
-
{{domxref("GlobalEventHandlers.onresize")}}
-
Appelé en continu lorsque vous redimensionnez la fenêtre.
-
- -
-
{{domxref("GlobalEventHandlers.onscroll")}}
-
Appelé lorsque la barre de défilement est déplacée par un moyen QUELCONQUE. Si la ressource correspond entièrement à la fenêtre, cet événement ne peut pas être invoqué.
-
- -
-
{{domxref("GlobalEventHandlers.onwheel")}}
-
Appelé lorsque la roue de la souris est tournée autour d'un axe quelconque.
-
{{domxref("GlobalEventHandlers.onselect")}}
-
Appelé après le texte dans un champ de saisie est sélectionné.
-
- -
-
{{domxref("GlobalEventHandlers.onselectionchange")}}
-
Est un {{event("Event_handlers", "event handler")}} représentant le code à appeler lorsque l'événement {{event("selectionchange")}} est déclenché.
-
{{domxref("WindowEventHandlers.onstorage")}}
-
Appelé en cas de changement dans le stockage de session ou le stockage local. Voir l'événement {{event("storage")}}.
-
{{domxref("GlobalEventHandlers.onsubmit")}}
-
Appelé lorsqu'un formulaire est soumis.
-
- -
-
{{domxref("WindowEventHandlers.onunhandledrejection")}} {{experimental_inline}}
-
Gestionnaire d'événements pour les événements de rejet {{jsxref("Promise")}} non gérés.
-
{{domxref("WindowEventHandlers.onunload")}}
-
Appelé lorsque l'utilisateur quitte la page.
-
- -
-
{{domxref("Window.onuserproximity")}}
-
Propriété de gestionnaire d'événements pour les événements de proximité d'utilisateur.
-
{{domxref("Window.onvrdisplayconnect")}}
-
Représente un gestionnaire d'événements qui s'exécutera lorsqu'un périphérique RV compatible a été connecté à l'ordinateur (lorsque l'événement {{event("vrdisplayconnected")}} se déclenche).
-
{{domxref("Window.onvrdisplaydisconnect")}}
-
Représente un gestionnaire d'événements qui s'exécutera lorsqu'un périphérique RV compatible a été déconnecté de l'ordinateur (lorsque l'événement {{event("vrdisplaydisconnected")}} se déclenche).
-
{{domxref("Window.onvrdisplayactivate")}}
-
Représente un gestionnaire d'événements qui s'exécutera lorsqu'un affichage peut être présenté (lorsque l'événement {{event("vrdisplayactivate")}} se déclenche), par exemple si un HMD a été déplacé pour sortir de veille, ou a été réveillé en le mettant sur soi.
-
{{domxref("Window.onvrdisplaydeactivate")}}
-
Représente un gestionnaire d'événements qui s'exécute lorsqu'un affichage ne peut plus être présenté (lorsque l'événement {{event ("vrdisplaydeactivate")}} se déclenche), par exemple si un HMD est passé en veille ou en hibernation en raison d'une période d'inactivité.
-
{{domxref("Window.onvrdisplayblur")}}
-
Représente un gestionnaire d'événements qui s'exécutera lorsque la présentation sur un affichage a été suspendue pour une raison quelconque par le navigateur, le SE ou le matériel de RV (lorsque l'événement {{event("vrdisplayblur")}} se déclenche - par exemple, lorsque l'utilisateur interagit avec un menu système ou un navigateur, pour empêcher le suivi ou la perte d'expérience.
-
{{domxref("Window.onvrdisplayfocus")}}
-
Représente un gestionnaire d'événements qui sera exécuté lorsque la présentation sur un afficheur a repris après avoir perdu la focalisation (lorsque l'événement {{event("vrdisplayfocus")}} se déclenche).
-
{{domxref("Window.onvrdisplaypresentchange")}}
-
Représente un gestionnaire d'événements qui s'exécute lorsque l'état de présentation d'un périphérique de RV change, c'est-à-dire qu'il passe de présentation à non présentation, ou vice versa (lorsque l'événement {{event("vrdisplaypresentchange")}} se déclenche).
-
- -

Constructeurs

- -

Voir aussi les Interfaces DOM.

- -
-
{{domxref("DOMParser")}}
-
DOMParser peut analyser un source XML ou HTML stocké dans une chaîne de caractères en un Document DOM. DOMParser est spécifié dans DOM Parsing et Serialization.
-
{{domxref("Window.GeckoActiveXObject")}}
-
{{todo("NeedsContents")}}
-
{{domxref("Image")}}
-
Used for creating an {{domxref("HTMLImageElement")}}.
-
{{domxref("Option")}}
-
Used for creating an {{domxref("HTMLOptionElement")}}
-
{{domxref("Window.QueryInterface")}}
-
{{todo("NeedsContents")}}
-
{{domxref("Window.XMLSerializer")}}
-
{{todo("NeedsContents")}}
-
{{domxref("Worker")}}
-
Used for creating a Web worker
-
{{domxref("Window.XPCNativeWrapper")}}
-
{{todo("NeedsContents")}}
-
{{domxref("Window.XPCSafeJSObjectWrapper")}}
-
{{todo("NeedsContents")}}
-
- -

Interfaces

- -

Voir Référence du DOM

- -

Voir aussi

- - diff --git a/files/fr/web/api/window/index.md b/files/fr/web/api/window/index.md new file mode 100644 index 0000000000..d5c5e70052 --- /dev/null +++ b/files/fr/web/api/window/index.md @@ -0,0 +1,568 @@ +--- +title: window +slug: Web/API/Window +tags: + - API + - DOM + - Interface + - JavaScript + - Reference + - Window +translation_of: Web/API/Window +--- +

{{APIRef}}

+ +

L'objet window représente une fenêtre contenant un document DOM ; la propriété document pointe vers le document DOM chargé dans cette fenêtre. Une fenêtre pour un document donné peut être obtenue en utilisant la propriété {{Domxref("document.defaultView")}}.

+ +

Cette section fournit une brève référence pour toutes les méthodes, propriétés et événements disponibles via l'objet DOM window. L'objet window implémente l'interface Window, qui à son tour hérite de l'interface AbstractView. Certaines fonctions globales supplémentaires, espaces de noms, objets, interfaces et constructeurs, non typiquement associés à la fenêtre, mais disponibles sur celle-ci, sont répertoriés dans la Référence JavaScript et la Référence DOM.

+ +

Dans un navigateur utilisant des onglets, comme Firefox, chaque onglet contient son propre objet window (et si vous écrivez une extension, la fenêtre du navigateur elle-même est un objet window séparé — consultez Travailler avec des fenêtres dans du code chrome pour plus d'informations). C'est-à-dire que l'objet window n'est pas partagé entre les onglets dans la même fenêtre. Certaines méthodes, notamment {{ Domxref("window.resizeTo") }} et {{ Domxref("window.resizeBy") }}, s'appliquent à la fenêtre entière et non à l'onglet spécifique auquel l'objet window appartient. En général, ce qui ne peut raisonnablement pas concerner un onglet se rapporte à la fenêtre à la place.

+ +

{{InheritanceDiagram}}

+ +

Propriétés

+ +

Cette interface hérite des propriétés de l'interface {{domxref("EventTarget")}} et implémente les propriétés des mixins {{domxref("WindowOrWorkerGlobalScope")}} et {{domxref("WindowEventHandlers")}}.

+ +

Notez que les propriétés qui sont des objets (par exemple, pour redéfinir le prototype d'éléments intrinsèques) sont répertoriées dans une section distincte ci-dessous.

+ +
+
{{domxref("Window.closed")}} {{Non-standard_inline}}{{readOnlyInline}}
+
Cette propriété indique si la fenêtre en cours est fermée ou non.
+
{{domxref("Window.console")}} {{ReadOnlyInline}}
+
Renvoie une référence à l'objet console qui fournit l'accès à la console de débogage du navigateur.
+
{{domxref("Window.content")}} et Window._content {{Non-standard_inline}} {{obsolete_inline}}{{ReadOnlyInline}}
+
Renvoie une référence à l'élément de contenu dans la fenêtre en cours. Depuis Firefox 57 (initialement Nightly uniquement), les deux versions sont uniquement disponibles à partir du code chrome (privilégié) et ne sont plus disponibles sur le Web.
+
{{domxref("Window.controllers")}}{{non-standard_inline}}{{ReadOnlyInline}}
+
Renvoie les objets du contrôleur XUL pour la fenêtre chrome en cours.
+
{{domxref("Window.customElements")}}{{ReadOnlyInline}}
+
renvoie une référence à l'objet {{domxref("CustomElementRegistry")}}, qui peut être utilisée pour enregistrer de nouveaux éléments personnalisés et obtenir des informations à propos d'éléments personnalisés précédemment enregistrés.
+
{{domxref("Window.crypto")}} {{readOnlyInline}}
+
Retourne l'objet crypto du navigateur.
+
{{domxref("Window.defaultStatus")}} {{Obsolete_inline("gecko23")}}
+
Récupère / définit le texte de la barre d'état pour la fenêtre donnée.
+
{{domxref("Window.devicePixelRatio")}} {{non-standard_inline}}{{ReadOnlyInline}}
+
Renvoie le rapport entre les pixels physiques et les pixels indépendants du périphérique dans l'affichage en cours.
+
{{domxref("Window.dialogArguments")}} {{ReadOnlyInline}}
+
Récupère les arguments passés à la fenêtre (si c'est une boîte de dialogue) au moment où {{domxref ("window.showModalDialog()")}} a été appelé. C'est un {{Interface("nsIArray")}}.
+
{{domxref("Window.directories")}} {{obsolete_inline}}
+
Synonyme de {{domxref("window.personalbar")}}
+
{{domxref("Window.document")}} {{ReadOnlyInline}}
+
Renvoie une référence au document que la fenêtre contient.
+
{{domxref("Window.DOMMatrix")}} {{readOnlyInline}} {{experimental_inline}}
+
Renvoie une référence à un objet {{domxref("DOMMatrix")}} représentant des matrices 4x4, adapté aux opérations 2D et 3D.
+
{{domxref("Window.DOMMatrixReadOnly")}} {{readOnlyInline}} {{experimental_inline}}
+
Renvoie une référence à un objet {{domxref("DOMMatrixReadOnly")}} représentant des matrices 4x4, adapté aux opérations 2D et 3D.
+
{{domxref("Window.DOMPoint")}} {{readOnlyInline}} {{experimental_inline}}
+
Renvoie une référence à un objet {{domxref("DOMPoint")}} représentant un point 2D ou 3D dans un système de coordonnées.
+
{{domxref("Window.DOMPointReadOnly")}} {{readOnlyInline}} {{experimental_inline}}
+
Renvoie une référence à un objet {{domxref("DOMPointReadOnly")}} représentant un point 2D ou 3D dans un système de coordonnées.
+
{{domxref("Window.DOMQuad")}} {{readOnlyInline}} {{experimental_inline}}
+
Renvoie une référence à un objet {{domxref("DOMQuad")}}, qui fournit un objet quadrilatère, c'est-à-dire, ayant quatre coins et quatre côtés.
+
{{domxref("Window.DOMRect")}} {{readOnlyInline}} {{experimental_inline}}
+
Returns a reference to a {{domxref("DOMRect")}} object, which represents a rectangle.
+
{{domxref("Window.DOMRectReadOnly")}} {{readOnlyInline}} {{experimental_inline}}
+
Renvoie une référence à un objet {{domxref("DOMRectReadOnly")}} représentant un rectangle.
+
{{domxref("Window.frameElement")}} {{readOnlyInline}}
+
Renvoie l'élément dans lequel la fenêtre est intégrée, ou null si la fenêtre n'est pas intégrée.
+
{{domxref("Window.frames")}} {{readOnlyInline}}
+
Renvoie un tableau des sous-cadres dans la fenêtre en cours.
+
{{domxref("Window.fullScreen")}} {{gecko_minversion_inline("1.9")}}
+
Cette propriété indique si la fenêtre est affichée en plein écran ou non.
+
{{domxref("Window.globalStorage")}} {{gecko_minversion_inline("1.8.1")}} {{Non-standard_inline}} {{Obsolete_inline("gecko13")}}
+
Non supporté depuis Gecko 13 (Firefox 13). Utilisez {{domxref("Window.localStorage")}} à la place.
+ Était : divers objets de stockage utilisés pour stocker des données sur plusieurs pages.
+
{{domxref("Window.history")}} {{ReadOnlyInline}}
+
Retourne une référence à l'objet d'historique.
+
{{domxref("Window.innerHeight")}} {{readOnlyInline}}
+
Récupère la hauteur de la zone de contenu de la fenêtre du navigateur, y compris, si affichée, la barre de défilement horizontale.
+
{{domxref("Window.innerWidth")}} {{readOnlyInline}}
+
Récupère la largeur de la zone de contenu de la fenêtre du navigateur, y compris, si affichée, la barre de défilement verticale.
+
{{domxref("Window.isSecureContext")}} {{readOnlyInline}}
+
Indique si un contexte est capable d'utiliser des fonctionnalités nécessitant des contextes sécurisés.
+
{{domxref("Window.length")}} {{readOnlyInline}}
+
Renvoie le nombre de cadres dans la fenêtre. Voir également {{domxref("window.frames")}}.
+
{{domxref("Window.location")}}
+
Récupère/définit l'emplacement, ou l'URL en cours, de l'objet de fenêtre.
+
{{domxref("Window.locationbar")}} {{ReadOnlyInline}}
+
Renvoie l'objet de la barre d'adresse, dont la visibilité peut être inversée dans la fenêtre.
+
{{domxref("Window.localStorage")}} {{readOnlyInline}}{{gecko_minversion_inline("1.9.1")}}
+
Renvoie une référence à l'objet de stockage local utilisé pour stocker les données accessibles uniquement par l'origine qui les a créées.
+
{{domxref("Window.menubar")}} {{ReadOnlyInline}}
+
Renvoie l'objet barre de menus, dont la visibilité peut être inversée dans la fenêtre.
+
{{domxref("Window.messageManager")}} {{gecko_minversion_inline("2.0")}}
+
Renvoie l'objet gestionnaire de messages pour cette fenêtre.
+
{{domxref("Window.mozAnimationStartTime")}} {{ReadOnlyInline}}{{gecko_minversion_inline("2.0")}} {{Deprecated_inline}}
+
Le temps en millisecondes depuis l'instant auquel le cycle d'animation en cours a commencé.
+
{{domxref("Window.mozInnerScreenX")}} {{ReadOnlyInline}}{{non-standard_inline}}{{gecko_minversion_inline("1.9.2")}}
+
Renvoie la coordonnée horizontale (X) du coin supérieur gauche du point de vue de la fenêtre, en coordonnées d'écran. Cette valeur est restituée en pixels CSS. Voir mozScreenPixelsPerCSSPixel dans {{interface("nsIDOMWindowUtils")}} pour un facteur de conversion pour s'adapter aux pixels de l'écran si nécessaire.
+
{{domxref("Window.mozInnerScreenY")}} {{ReadOnlyInline}} {{non-standard_inline}}{{gecko_minversion_inline("1.9.2")}}
+
Renvoie la coordonnée verticale (Y) du coin supérieur gauche du point de vue de la fenêtre, en coordonnées d'écran. Cette valeur est indiquée en pixels CSS. Voir mozScreenPixelsPerCSSPixel pour un facteur de conversion pour s'adapter aux pixels de l'écran si nécessaire.
+
{{domxref("Window.mozPaintCount")}} {{non-standard_inline}}{{ReadOnlyInline}} {{gecko_minversion_inline("2.0")}}
+
Renvoie le nombre de fois où le document en cours a été réaffiché à l'écran dans cette fenêtre. Cela peut être utilisé pour calculer les performances d'affichage.
+
{{domxref("Window.name")}}
+
Récupère / définit le nom de la fenêtre.
+
{{domxref("Window.navigator")}} {{readOnlyInline}}
+
Renvoie une référence à l'objet navigateur.
+
{{domxref("Window.NetworkInformation")}} {{readOnlyInline}} {{experimental_inline}}
+
Renvoie une référence à l'interface {{domxref("NetworkInformation")}}, qui fournit des informations sur la connexion qu'un périphérique est en train d'utiliser pour communiquer avec le réseau et fournit un moyen pour les scripts d'être notifiés si le type de connexion change. 
+
{{domxref("Window.opener")}}
+
Renvoie une référence à la fenêtre qui a ouvert la fenêtre en cours.
+
{{domxref("Window.orientation")}}{{non-standard_inline}}{{deprecated_inline}}{{readOnlyInline}}
+
Renvoie l'orientation en degrés (par incréments de 90 degrés) du point de vue par rapport à l'orientation naturelle du périphérique.
+
{{domxref("Window.outerHeight")}} {{readOnlyInline}}
+
Récupère la hauteur de l'extérieur de la fenêtre du navigateur.
+
{{domxref("Window.outerWidth")}} {{readOnlyInline}}
+
Récupère la largeur de l'extérieur de la fenêtre du navigateur.
+
{{domxref("Window.scrollX","Window.pageXOffset")}} {{readOnlyInline}}
+
Un alias pour {{domxref("window.scrollX")}}.
+
{{domxref("Window.scrollY","Window.pageYOffset")}}{{readOnlyInline}}
+
Un alias pour {{domxref("window.scrollY")}}
+
{{domxref("Window.sessionStorage")}} {{readOnlyInline}}
+
Renvoie une référence à l'objet de stockage de session utilisé pour stocker les données accessibles uniquement par l'origine qui les a créées..
+
{{domxref("Window.parent")}} {{readOnlyInline}}
+
Renvoie une référence au parent de la fenêtre ou du sous-cadre en cours.
+
{{domxref("Window.performance")}} {{readOnlyInline}}
+
Renvoie un objet {{domxref("Performance")}}, qui inclut les attributs {{domxref("Performance.timing", "timing")}} et {{domxref("Performance.navigation", "navigation")}}, dont chacun est un objet fournissant des données liées aux performances. Voir aussi Utilisation de Chronométrage de Navigation pour plus d'informations et d'exemples.
+
{{domxref("Window.personalbar")}} {{readOnlyInline}}
+
Renvoie l'objet barre personnelle, dont la visibilité peut être inversée dans la fenêtre.
+
{{domxref("Window.pkcs11")}} {{obsolete_inline(29)}}
+
Fournissait précédemment un accès pour installer et supprimer des modules PKCS11.
+
{{domxref("Window.returnValue")}}
+
La valeur de retour à renvoyer à la fonction qui a appelé {{domxref("window.showModalDialog()")}} pour afficher la fenêtre comme boîte de dialogue modale.
+
{{domxref("Window.screen")}} {{readOnlyInline}}
+
Renvoie une référence à l'objet écran associé à la fenêtre.
+
{{domxref("Window.screenX")}} {{readOnlyInline}}
+
Renvoie la distance horizontale de la bordure gauche du navigateur de l'utilisateur à partir du côté gauche de l'écran.
+
{{domxref("Window.screenY")}} {{readOnlyInline}}
+
Renvoie la distance verticale de la bordure supérieure du navigateur de l'utilisateur à partir du haut de l'écran.
+
{{domxref("Window.scrollbars")}} {{readOnlyInline}}
+
Renvoie l'objet barres de défilement, dont la visibilité peut être modifiée dans la fenêtre.
+
{{domxref("Window.scrollMaxX")}}{{non-standard_inline}}{{ReadOnlyInline}}
+
Le décalage maximal dont la fenêtre peut étre décalée horizontalement, c'est-à-dire la largeur du document moins la largeur du point de vue.
+
{{domxref("Window.scrollMaxY")}}{{non-standard_inline}}{{ReadOnlyInline}}
+
Le décalage maximal dont la fenêtre peut étre décalée verticalement (c'est-à-dire, la hauteur du document moins la hauteur du point de vue).
+
{{domxref("Window.scrollX")}} {{readOnlyInline}}
+
Renvoie le nombre de pixels dont le document a déjà été décalé horizontalement.
+
{{domxref("Window.scrollY")}} {{readOnlyInline}}
+
Renvoie le nombre de pixels dont le document a déjà été décalé verticalement.
+
{{domxref("Window.self")}} {{ReadOnlyInline}}
+
Renvoie une référence d'objet à l'objet fenêtre lui-même.
+
{{domxref("Window.sessionStorage")}}
+
Renvoie un objet de stockage pour stocker des données dans une session de page unique.
+
{{domxref("Window.sidebar")}} {{non-standard_inline}}{{ReadOnlyInline}}
+
Renvoie une référence à l'objet fenêtre de la barre latérale.
+
{{domxref("Window.speechSynthesis")}} {{ReadOnlyInline}}
+
Renvoie un objet {{domxref("SpeechSynthesis")}}, qui est le point d'entrée pour l'utilisation de la fonctionnalité de synthèse vocale de l'API Web Speech.
+
{{domxref("Window.status")}}
+
Récupère/définit le texte dans la barre d'état en bas du navigateur.
+
{{domxref("Window.statusbar")}} {{readOnlyInline}}
+
Renvoie l'objet barre d'état, dont la visibilité peut être inversée dans la fenêtre.
+
{{domxref("Window.toolbar")}} {{readOnlyInline}}
+
Renvoie l'objet barre d'outils, dont la visibilité peut être inversée dans la fenêtre.
+
{{domxref("Window.top")}} {{readOnlyInline}}
+
Renvoie une référence à la fenêtre la plus haute dans la hiérarchie des fenêtres. Cette propriété est en lecture seule.
+
{{domxref("Window.visualViewport")}} {{readOnlyInline}}
+
Renvoie un objet {{domxref("VisualViewport")}} représentant le point de vue visuel pour une fenêtre donnée.
+
{{domxref("Window.window")}} {{ReadOnlyInline}}
+
Renvoie une référence à la fenêtre en cours.
+
window[0], window[1], etc.
+
Renvoie une référence à l'objet window dans les cadres. Voir {{domxref("Window.frames")}}} pour plus de détails.
+
+ +

Propriétés implémentées depuis ailleurs

+ +
+
{{domxref("WindowOrWorkerGlobalScope.caches")}} {{readOnlyinline}}
+
Renvoie l'objet {{domxref("CacheStorage")}} associé au contexte en cours. Cet objet active des fonctionnalités telles que le stockage des ressources pour une utilisation hors connexion, et la génération de réponses personnalisées aux requêtes.
+
{{domxref("WindowOrWorkerGlobalScope.indexedDB")}} {{readonlyInline}}
+
Fournit un mécanisme permettant aux applications d'accéder de manière asynchrone à des bases de données indexées ; renvoie un objet {{domxref("IDBFactory")}}.
+
{{domxref("WindowOrWorkerGlobalScope.isSecureContext")}} {{readOnlyinline}}
+
Renvoie un booléen indiquant si le contexte actuel est sécurisé (true) ou non (false).
+
{{domxref("WindowOrWorkerGlobalScope.origin")}} {{readOnlyinline}}
+
Renvoie l'origine de l'objet global, sérialisé comme une chaîne. (Cela ne semble pas encore être implémenté dans aucun navigateur.)
+
+ +

Méthodes

+ +

Cette interface hérite des méthodes de l'interface {{domxref("EventTarget")}} et implémente les méthodes de {{domxref("WindowOrWorkerGlobalScope")}} et {{domxref("EventTarget")}}.

+ +
+
{{domxref("Window.alert()")}}
+
Affiche une boîte de message d'alerte.
+
{{domxref("Window.back()")}} {{Non-standard_inline}} {{obsolete_inline}}
+
Recule d'une page dans l'historique de la fenêtre.
+
{{domxref("Window.blur()")}}
+
Déplace la focalisation hors de la fenêtre.
+
{{domxref("Window.cancelAnimationFrame()")}} {{experimental_inline}}
+
Vous permet d'annuler un rappel précédemment planifié avec {{domxref("Window.requestAnimationFrame")}}.
+
{{domxref("Window.cancelIdleCallback()")}} {{experimental_inline}}
+
Vous permet d'annuler un rappel précédemment planifié avec {{domxref("Window.requestIdleCallback")}}.
+
{{domxref("Window.captureEvents()")}} {{Deprecated_inline}}
+
Enregistre la fenêtre pour qu'elle capture tous les évènements du type spécifié.
+
{{domxref("Window.clearImmediate()")}}
+
Annule l'exécution répétée définie en utilisant setImmediate.
+
{{domxref("Window.close()")}}
+
Ferme la fenêtre en cours.
+
{{domxref("Window.confirm()")}}
+
Affiche une boîte de dialogue avec un message auquel l'utilisateur doit répondre.
+
{{domxref("Window.disableExternalCapture()")}} {{obsolete_inline(24)}}
+
{{todo("NeedsContents")}}
+
{{domxref("Window.dispatchEvent()")}}
+
Utilisé pour déclencher un évènement.
+
{{domxref("Window.dump()")}} {{Non-standard_inline}}
+
Écrit un message à la console.
+
{{domxref("Window.enableExternalCapture()")}} {{obsolete_inline(24)}}
+
{{todo("NeedsContents")}}
+
{{domxref("Window.find()")}}
+
Recherche la chaîne de caractères donnée dans une fenêtre.
+
{{domxref("Window.focus()")}}
+
Donne la focalisation à la fenêtre en cours.
+
{{domxref("Window.forward()")}} {{Non-standard_inline}} {{obsolete_inline}}
+
Avance la fenêtre d'un document dans l'historique.
+
{{domxref("Window.getAttention()")}} {{Non-standard_inline}} {{obsolete_inline}}
+
Fait flasher l'icône de l'application.
+
{{domxref("Window.getAttentionWithCycleCount()")}}
+
{{todo("NeedsContents")}}
+
{{domxref("Window.getComputedStyle()")}}
+
Récupère un style calculé pour l'élément donné. Un style calculé indique les valeurs de toutes les propriétés CSS de l'élément.
+
{{domxref("Window.getDefaultComputedStyle()")}} {{Non-standard_inline}}
+
Récupère le style calculé par défaut pour l'élément indiqué, en ignorant les feuilles de style d'auteur.
+
{{domxref("Window.getSelection()")}}
+
Renvoie l'objet de sélection représentant les éléments sélectionnés.
+
{{domxref("Window.home()")}} {{Non-standard_inline}} {{obsolete_inline}}
+
Renvoie le navigateur à la page d'accueil.
+
{{domxref("Window.matchMedia()")}} {{gecko_minversion_inline("6.0")}}
+
Renvoie un objet {{domxref("MediaQueryList")}} représentant la chaîne d'interrogation de média spécifiée.
+
{{domxref("Window.maximize()")}}
+
{{todo("NeedsContents")}}
+
{{domxref("Window.minimize()")}} (top-level XUL windows only)
+
Minimize la fenêtre.
+
{{domxref("Window.moveBy()")}}
+
Déplace la fenêtre en cours de la quantité indiquée.
+
{{domxref("Window.moveTo()")}}
+
Déplace la fenêtre vers les coordonnées spécifiées.
+
{{domxref("Window.open()")}}
+
Ouvre une nouvelle fenêtre.
+
{{domxref("Window.openDialog()")}} {{Non-standard_inline}} {{obsolete_inline}}
+
Ouvre une nouvelle fenêtre de dialogue.
+
{{domxref("Window.postMessage()")}}
+
Fournit un moyen sécurisé pour une fenêtre d'envoyer une chaîne de données à une autre fenêtre, qui n'a pas besoin d'être dans le même domaine que la première.
+
{{domxref("Window.prompt()")}}
+
Ouvre la boîte de dialogue d'impression du document en cours.
+
{{domxref("Window.prompt()")}}
+
Renvoie le texte saisi par l'utilisateur dans une boîte de dialogue à invite.
+
{{domxref("Window.releaseEvents()")}} {{Non-standard_inline}} {{Deprecated_inline}}
+
Annule la capture des évènements d'un certain type par la fenêtre.
+
{{domxref("Window.requestAnimationFrame()")}} {{gecko_minversion_inline("2.0")}}
+
Indique au navigateur qu'une animation est en cours, en demandant au navigateur de planifier une redessinage de la fenêtre lors de l'image d'animation suivante.
+
{{domxref("Window.requestIdleCallback()")}}  {{experimental_inline}}
+
Active la planification de tâches pendant les périodes d'inactivité du navigateur.
+
{{domxref("Window.resizeBy()")}}
+
Redimensionne la fenêtre en cours d'une certaine quantité.
+
{{domxref("Window.resizeTo()")}}
+
Redimensionne dynamiquement la fenêtre.
+
{{domxref("Window.restore()")}} {{Non-standard_inline}} {{obsolete_inline}}
+
{{todo("NeedsContents")}}
+
{{domxref("Window.routeEvent()")}} {{obsolete_inline(24)}}
+
{{todo("NeedsContents")}}
+
{{domxref("Window.scroll()")}}
+
Fait défiler la fenêtre à un endroit particulier dans le document.
+
{{domxref("Window.scrollBy()")}}
+
Fait défiler le document dans la fenêtre de la quantité indiquée.
+
{{domxref("Window.scrollByLines()")}} {{Non-standard_inline}}
+
Fait défiler le document du nombre de lignes indiqué.
+
{{domxref("Window.scrollByPages()")}} {{Non-standard_inline}}
+
Fait défiler le document en cours du nombre de pages indiqué.
+
{{domxref("Window.scrollTo()")}}
+
Fait défiler à un jeu de coordonnées particulier dans le document.
+
{{domxref("Window.setCursor()")}} {{Non-standard_inline}} (top-level XUL windows only)
+
Change le curseur pour la fenêtre en cours.
+
{{domxref("Window.setImmediate()")}}
+
Exécute une fonction après que le navigateur a terminé d'autres tâches lourdes
+
{{domxref("Window.setResizable()")}} {{Non-standard_inline}}
+
Inverse la possibilité pour un utilisateur de redimensionner une fenêtre.
+
{{domxref("Window.sizeToContent()")}} {{Non-standard_inline}}
+
Dimensionne la fenêtre en fonction de son contenu.
+
{{domxref("Window.stop()")}}
+
Cette méthode arrête le chargement de la fenêtre.
+
{{domxref("Window.updateCommands()")}} {{Non-standard_inline}}
+
Met à jour l'état des commandes de la fenêtre chrome en cours (IU).
+
+ +

Méthodes implémentées depuis ailleurs

+ +
+
{{domxref("EventTarget.addEventListener()")}}
+
Enregistre un gestionnaire d'événement pour un type d'événement spécifique dans la fenêtre.
+
{{domxref("WindowOrWorkerGlobalScope.atob()")}}
+
Décode une chaîne de données qui a été codée en utilisant l'encodage en base 64.
+
{{domxref("WindowOrWorkerGlobalScope.btoa()")}}
+
Crée une chaîne ASCII codée en base 64 à partir d'une chaîne de données binaires.
+
{{domxref("WindowOrWorkerGlobalScope.clearInterval()")}}
+
Annule l'exécution répétée définie en utilisant {{domxref("WindowOrWorkerGlobalScope.setInterval ()")}}.
+
{{domxref("WindowOrWorkerGlobalScope.clearTimeout()")}}
+
Annule l'exécution différée définie en utilisant {{domxref("WindowOrWorkerGlobalScope.setTimeout ()")}}.
+
{{domxref("WindowOrWorkerGlobalScope.createImageBitmap()")}}
+
Accepte une variété de sources d'images différentes, et renvoie un {{domxref("Promise")}} qui se résout en une {{domxref("ImageBitmap")}}. En option, la source est détourée avec le rectangle des pixels d'origine en (sx, sy) et de largeur sw, et de hauteur sh.
+
{{domxref("WindowOrWorkerGlobalScope.fetch()")}}
+
Démarre le processus de récupération d'une ressource à partir du réseau.
+
{{domxref("EventTarget.removeEventListener")}}
+
Supprime un gestionnaire d'événement de la fenêtre.
+
{{domxref("WindowOrWorkerGlobalScope.setInterval()")}}
+
Planifie une fonction à exécuter à chaque fois qu'un nombre donné de millisecondes s'est écoulé.
+
{{domxref("WindowOrWorkerGlobalScope.setTimeout()")}}
+
Planifie une fonction à exécuter dans un laps de temps donné.
+
+ +

Méthodes obsolètes

+ +
+
{{domxref("Window.showModalDialog()")}} {{obsolete_inline}}
+
Affiche un dialogue modal. Cette méthode a été complètement supprimée dans Chrome 43, et dans Firefox 55.
+
+ +

Gestionnaires d'évènements

+ +

Ce sont des propriétés de l'objet window qui peuvent être définies pour établir des gestionnaires d'événements pour les différentes choses qui peuvent se produire dans la fenêtre et qui pourraient être intéressantes.

+ +

Cette interface hérite des gestionnaires d'événements de l'interface {{domxref("EventTarget")}} et elle implémente les gestionnaires d'événements de {{domxref("WindowEventHandlers")}}.

+ +
+

Note : à partir de {{Gecko ("9.0")}}, vous pouvez maintenant utiliser la syntaxe if ("onabort" in window) pour déterminer si une propriété de gestionnaire d'événements donnée existe ou non. Cela est dû au fait que les interfaces du gestionnaire d'événements ont été mises à jour pour être des interfaces Web IDL correctes. Voir les gestionnaires d'événements DOM pour plus de détails.

+
+ +
+
{{domxref("GlobalEventHandlers.onabort")}}
+
 
+
Appelé quand le chargement d'une ressource a été avorté, comme par le fait qu'un utilisateur annule un chargement alors qu'il était encore en cours.
+
+ +
+
{{domxref("WindowEventHandlers.onafterprint")}}
+
Appelé lorsque la boîte de dialogue d'impression est fermée. Voir l'événement {{event ("afterprint")}}.
+
{{domxref("WindowEventHandlers.onbeforeprint")}}
+
Appelé lorsque la boîte de dialogue d'impression est ouverte. Voir l'événement {{event ("beforeprint")}}.
+
{{domxref("Window.onbeforeinstallprompt")}}
+
Propriété de gestionnaire d'événements qui est déclenchée avant qu'un utilisateur ne soit invité à enregistrer un site Web sur un écran d'accueil sur mobile.
+
{{domxref("WindowEventHandlers.onbeforeunload")}}
+
Propriété de gestionnaire d'événements pour les événements avant-déchargement dans la fenêtre.
+
+ +
+
{{domxref("GlobalEventHandlers.onblur")}}
+
Appelé après que la fenêtre a perdu la focalisation, comme en raison d'une fenêtre contextuelle.
+
+ +
+
{{domxref("GlobalEventHandlers.onchange")}}
+
Propriété de gestionnaire d'événements pour les événements de changement dans la fenêtre.
+
+ +
+
{{domxref("GlobalEventHandlers.onclick")}}
+
Appelé après qu'un QUELCONQUE bouton de la souris est pressé & relâché.
+
+ +
+
{domxref("GlobalEventHandlers.ondblclick")}}
+
Appelé quand un double clic est fait avec un QUELCONQUE bouton de la souris.
+
{{domxref("GlobalEventHandlers.onclose")}}
+
Appelé après la fermeture de la fenêtre.
+
+ +
+
{{domxref("GlobalEventHandlers.oncontextmenu")}}
+
Appelé lorsque le bouton DROIT de la souris est enfoncé.
+
+ +
+
{{domxref("Window.ondevicelight")}}
+
Propriété de gestionnaire d'événements pour tous les changements de niveaux de luminosité ambiante.
+
{{domxref("Window.ondevicemotion")}} {{gecko_minversion_inline("6.0")}}
+
Appelé si l'accéléromètre détecte un changement (pour les appareils mobiles).
+
{{domxref("Window.ondeviceorientation")}} {{gecko_minversion_inline("6.0")}}
+
Appelé lorsque l'orientation est modifiée (pour les appareils mobiles).
+
{{domxref("Window.ondeviceorientationabsolute")}} {{non-standard_inline}} Chrome only
+
Propriété de gestionnaire d'événements pour tout changement d'orientation de l'appareil.
+
{{domxref("Window.ondeviceproximity")}}
+
Propriété de gestionnaire d'événement pour l'événement de proximité de l'appareil.
+
+ +
+
{{domxref("GlobalEventHandlers.onerror")}}
+
Appelé lorsqu'une ressource ne se charge pas OU lorsqu'une erreur se produit lors de l'exécution. Voir l'événement {{event("error")}}.
+
+ +
+
{{domxref("GlobalEventHandlers.onfocus")}}
+
Appelé après que la fenêtre a reçu ou récupéré la focalisation. Voir les événements {{event("focus")}}.
+
+ +
+
{{domxref("WindowEventHandlers.onhashchange")}} {{gecko_minversion_inline("1.9.2")}}
+
Propriété de gestionnaire d'événements pour les événements {{event('hashchange')}} dans la fenêtre ; appelé lorsque la partie de l'URL après la marque hash ("#") change.
+
{{domxref("Window.onappinstalled")}}
+
Appelé lorsque la page est installée en tant que webapp. Voir l'événement {{event('appinstalled')}}.
+
{{domxref("Window.ongamepadconnected")}}
+
Représente un gestionnaire d'événements qui sera exécuté lorsqu'une manette de jeu est branchée (lorsque l'événement {{event('gamepadconnected')}} se déclenche).
+
{{domxref("Window.ongamepaddisconnected")}}
+
Représente un gestionnaire d'événements qui s'exécutera quand une manette de jeu est débranchée (lorsque l'événement {{event('gamepaddisconnected')}} se déclenche).
+
{{domxref("Window.oninput")}}
+
Appelée lorsque la valeur d'un élément <input> change.
+
{{domxref("GlobalEventHandlers.onkeydown")}}
+
Appelé lorsque vous commencez à presser une touche QUELCONQUE. Voir l'événement {{event("keydown")}}.
+
+ +
+
{{domxref("GlobalEventHandlers.onkeypress")}}
+
Appelé lorsqu'une touche (à l'exception de Shift, Fn et CapsLock) est en position pressée. Voir l'événement {{event("keypress")}}.
+
+ +
+
{{domxref("GlobalEventHandlers.onkeyup")}}
+
Appelé lorsque vous avez fini de relâcher une touche QUELCONQUE. Voir l'événement {{event("keyup")}}.
+
+ +
+
{{domxref("WindowEventHandlers.onlanguagechange")}}
+
Propriété de gestionnaire d'événements pour les événements {{event("languagechange")}} dans la fenêtre.
+
{{domxref("GlobalEventHandlers.onload")}}
+
Appelé après que toutes les ressources et les DOM ont été entièrement chargés. NE SERA PAS appelé lorsque la page est chargée à partir du cache, comme avec le bouton arrière.
+
+ +
+
{{domxref("GlobalEventHandlers.onmousedown")}}
+
Appelé quand un bouton QUELCONQUE de la souris est pressé.
+
+ +
+
{{domxref("GlobalEventHandlers.onmousemove")}}
+
Appelé en continu quand la souris est déplacée dans la fenêtre.
+
+ +
+
{{domxref("GlobalEventHandlers.onmouseout")}}
+
Appelé lorsque le pointeur quitte la fenêtre.
+
+ +
+
{{domxref("GlobalEventHandlers.onmouseover")}}
+
Appelé lorsque le pointeur entre dans la fenêtre.
+
+ +
+
{{domxref("GlobalEventHandlers.onmouseup")}}
+
Appelé quand un bouton QUELCONQUE de la souris est relâché.
+
+ +
+
{{domxref("Window.onmozbeforepaint")}} {{gecko_minversion_inline("2.0")}}
+
Propriété de gestionnaire d'événements pour l'événement MozBeforePaint, qui est déclenché avant de repeindre la fenêtre si l'événement a été demandé par un appel à la méthode {{domxref("Window.mozRequestAnimationFrame()")}}.
+
{{domxref("WindowEventHandlers.onoffline")}}
+
Appelé lorsque la connexion réseau est perdue. Voir l'événement {{event("offline")}}.
+
{{domxref("WindowEventHandlers.ononline")}}
+
Appelé lorsque la connexion réseau est établie. Voir l'événement {{event("online")}}.
+
{{domxref("WindowEventHandlers.onpagehide")}}
+
Appelé lorsque l'utilisateur quitte la page, avant l'événement onunload. Voir l'événement {{event("pagehide")}}.
+
{{domxref("WindowEventHandlers.onpageshow")}}
+
Appelé après toutes les ressources et les DOM ont été entièrement chargés. Voir l'événement {{event("pageshow")}}.
+
{{domxref("Window.onpaint")}}
+
Propriété de gestionnaire d'évènement pour les évènements de dessin de la fenêtre.
+
+ +
+
{{domxref("WindowEventHandlers.onpopstate")}} {{gecko_minversion_inline("2.0")}}
+
Appelé quand le bouton arrière est pressé.
+
{{domxref("Window.onrejectionhandled")}} {{experimental_inline}}
+
Gestionnaire d'événements pour les événements de rejet {{jsxref("Promise")}} gérés.
+
{{domxref("GlobalEventHandlers.onreset")}}
+
Appelé lorsqu'un formulaire est réinitialisé
+
+ +
+
{{domxref("GlobalEventHandlers.onresize")}}
+
Appelé en continu lorsque vous redimensionnez la fenêtre.
+
+ +
+
{{domxref("GlobalEventHandlers.onscroll")}}
+
Appelé lorsque la barre de défilement est déplacée par un moyen QUELCONQUE. Si la ressource correspond entièrement à la fenêtre, cet événement ne peut pas être invoqué.
+
+ +
+
{{domxref("GlobalEventHandlers.onwheel")}}
+
Appelé lorsque la roue de la souris est tournée autour d'un axe quelconque.
+
{{domxref("GlobalEventHandlers.onselect")}}
+
Appelé après le texte dans un champ de saisie est sélectionné.
+
+ +
+
{{domxref("GlobalEventHandlers.onselectionchange")}}
+
Est un {{event("Event_handlers", "event handler")}} représentant le code à appeler lorsque l'événement {{event("selectionchange")}} est déclenché.
+
{{domxref("WindowEventHandlers.onstorage")}}
+
Appelé en cas de changement dans le stockage de session ou le stockage local. Voir l'événement {{event("storage")}}.
+
{{domxref("GlobalEventHandlers.onsubmit")}}
+
Appelé lorsqu'un formulaire est soumis.
+
+ +
+
{{domxref("WindowEventHandlers.onunhandledrejection")}} {{experimental_inline}}
+
Gestionnaire d'événements pour les événements de rejet {{jsxref("Promise")}} non gérés.
+
{{domxref("WindowEventHandlers.onunload")}}
+
Appelé lorsque l'utilisateur quitte la page.
+
+ +
+
{{domxref("Window.onuserproximity")}}
+
Propriété de gestionnaire d'événements pour les événements de proximité d'utilisateur.
+
{{domxref("Window.onvrdisplayconnect")}}
+
Représente un gestionnaire d'événements qui s'exécutera lorsqu'un périphérique RV compatible a été connecté à l'ordinateur (lorsque l'événement {{event("vrdisplayconnected")}} se déclenche).
+
{{domxref("Window.onvrdisplaydisconnect")}}
+
Représente un gestionnaire d'événements qui s'exécutera lorsqu'un périphérique RV compatible a été déconnecté de l'ordinateur (lorsque l'événement {{event("vrdisplaydisconnected")}} se déclenche).
+
{{domxref("Window.onvrdisplayactivate")}}
+
Représente un gestionnaire d'événements qui s'exécutera lorsqu'un affichage peut être présenté (lorsque l'événement {{event("vrdisplayactivate")}} se déclenche), par exemple si un HMD a été déplacé pour sortir de veille, ou a été réveillé en le mettant sur soi.
+
{{domxref("Window.onvrdisplaydeactivate")}}
+
Représente un gestionnaire d'événements qui s'exécute lorsqu'un affichage ne peut plus être présenté (lorsque l'événement {{event ("vrdisplaydeactivate")}} se déclenche), par exemple si un HMD est passé en veille ou en hibernation en raison d'une période d'inactivité.
+
{{domxref("Window.onvrdisplayblur")}}
+
Représente un gestionnaire d'événements qui s'exécutera lorsque la présentation sur un affichage a été suspendue pour une raison quelconque par le navigateur, le SE ou le matériel de RV (lorsque l'événement {{event("vrdisplayblur")}} se déclenche - par exemple, lorsque l'utilisateur interagit avec un menu système ou un navigateur, pour empêcher le suivi ou la perte d'expérience.
+
{{domxref("Window.onvrdisplayfocus")}}
+
Représente un gestionnaire d'événements qui sera exécuté lorsque la présentation sur un afficheur a repris après avoir perdu la focalisation (lorsque l'événement {{event("vrdisplayfocus")}} se déclenche).
+
{{domxref("Window.onvrdisplaypresentchange")}}
+
Représente un gestionnaire d'événements qui s'exécute lorsque l'état de présentation d'un périphérique de RV change, c'est-à-dire qu'il passe de présentation à non présentation, ou vice versa (lorsque l'événement {{event("vrdisplaypresentchange")}} se déclenche).
+
+ +

Constructeurs

+ +

Voir aussi les Interfaces DOM.

+ +
+
{{domxref("DOMParser")}}
+
DOMParser peut analyser un source XML ou HTML stocké dans une chaîne de caractères en un Document DOM. DOMParser est spécifié dans DOM Parsing et Serialization.
+
{{domxref("Window.GeckoActiveXObject")}}
+
{{todo("NeedsContents")}}
+
{{domxref("Image")}}
+
Used for creating an {{domxref("HTMLImageElement")}}.
+
{{domxref("Option")}}
+
Used for creating an {{domxref("HTMLOptionElement")}}
+
{{domxref("Window.QueryInterface")}}
+
{{todo("NeedsContents")}}
+
{{domxref("Window.XMLSerializer")}}
+
{{todo("NeedsContents")}}
+
{{domxref("Worker")}}
+
Used for creating a Web worker
+
{{domxref("Window.XPCNativeWrapper")}}
+
{{todo("NeedsContents")}}
+
{{domxref("Window.XPCSafeJSObjectWrapper")}}
+
{{todo("NeedsContents")}}
+
+ +

Interfaces

+ +

Voir Référence du DOM

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/window/innerheight/index.html b/files/fr/web/api/window/innerheight/index.html deleted file mode 100644 index 19e63c1f54..0000000000 --- a/files/fr/web/api/window/innerheight/index.html +++ /dev/null @@ -1,95 +0,0 @@ ---- -title: window.innerHeight -slug: Web/API/Window/innerHeight -tags: - - API - - CSSOM View - - Property - - Propriété - - Reference - - Window -translation_of: Web/API/Window/innerHeight ---- -

{{ ApiRef() }}

- -

Récupère la hauteur (en pixels) de la partie visible de la fenêtre de navigation en incluant, si elle est affichée, la barre de défilement horizontale.

- -
-

Note : La valeur retournée par cette propriété correspond le cas échéant à la hauteur de la fenêtre définie par {{ifmethod("nsIDOMWindowUtils", "setCSSViewport")}}, dans le cas où vous utilisez cette méthode pour définir les dimensions de la fenêtre virtuelle dans le but d'agencer la page.

-
- -

Syntaxe

- -
var hauteur = window.innerHeight;
-
- -

Valeur

- -

Renvoie la hauteur de la partie visible de la fenêtre de navigation. La propriété window.innerHeight est accessible en lecture seulement ; elle n'a pas de valeur par défaut.

- -

Notes

- - - -

Exemples

- -

Sur un frameset

- -
var intFrameHeight = window.innerHeight; // ou
-
-var intFrameHeight = self.innerHeight;
-// retournera la hauteur de la partie visible du cadre dans frameset
-
-var intFramesetHeight = parent.innerHeight;
-// retournera la hauteur de la partie visible du frameset le plus proche
-
-var intOuterFramesetHeight = top.innerHeight;
-// retournera la hauteur de la partie visible du frameset le plus éloigné
-
- -

{{todo("ajouter ici un lien vers une démo interactive")}}

- - - -

Exemple graphique

- -

L'illustration suivante montre la différence entre outerHeight et innerHeight.

- -

Illustration de la différence entre innerHeight et outerHeight

- -

Spécification

- - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('CSSOM View', '#dom-window-innerheight', 'window.innerHeight')}}{{Spec2('CSSOM View')}}Définition initiale
- -

Compatibilité des navigateurs

- -

{{Compat("api.Window.innerHeight")}}

- -

Voir aussi

- - diff --git a/files/fr/web/api/window/innerheight/index.md b/files/fr/web/api/window/innerheight/index.md new file mode 100644 index 0000000000..19e63c1f54 --- /dev/null +++ b/files/fr/web/api/window/innerheight/index.md @@ -0,0 +1,95 @@ +--- +title: window.innerHeight +slug: Web/API/Window/innerHeight +tags: + - API + - CSSOM View + - Property + - Propriété + - Reference + - Window +translation_of: Web/API/Window/innerHeight +--- +

{{ ApiRef() }}

+ +

Récupère la hauteur (en pixels) de la partie visible de la fenêtre de navigation en incluant, si elle est affichée, la barre de défilement horizontale.

+ +
+

Note : La valeur retournée par cette propriété correspond le cas échéant à la hauteur de la fenêtre définie par {{ifmethod("nsIDOMWindowUtils", "setCSSViewport")}}, dans le cas où vous utilisez cette méthode pour définir les dimensions de la fenêtre virtuelle dans le but d'agencer la page.

+
+ +

Syntaxe

+ +
var hauteur = window.innerHeight;
+
+ +

Valeur

+ +

Renvoie la hauteur de la partie visible de la fenêtre de navigation. La propriété window.innerHeight est accessible en lecture seulement ; elle n'a pas de valeur par défaut.

+ +

Notes

+ + + +

Exemples

+ +

Sur un frameset

+ +
var intFrameHeight = window.innerHeight; // ou
+
+var intFrameHeight = self.innerHeight;
+// retournera la hauteur de la partie visible du cadre dans frameset
+
+var intFramesetHeight = parent.innerHeight;
+// retournera la hauteur de la partie visible du frameset le plus proche
+
+var intOuterFramesetHeight = top.innerHeight;
+// retournera la hauteur de la partie visible du frameset le plus éloigné
+
+ +

{{todo("ajouter ici un lien vers une démo interactive")}}

+ + + +

Exemple graphique

+ +

L'illustration suivante montre la différence entre outerHeight et innerHeight.

+ +

Illustration de la différence entre innerHeight et outerHeight

+ +

Spécification

+ + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('CSSOM View', '#dom-window-innerheight', 'window.innerHeight')}}{{Spec2('CSSOM View')}}Définition initiale
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Window.innerHeight")}}

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/window/innerwidth/index.html b/files/fr/web/api/window/innerwidth/index.html deleted file mode 100644 index a76af5343a..0000000000 --- a/files/fr/web/api/window/innerwidth/index.html +++ /dev/null @@ -1,68 +0,0 @@ ---- -title: window.innerWidth -slug: Web/API/Window/innerWidth -translation_of: Web/API/Window/innerWidth ---- -

{{ ApiRef() }}

- -

Résumé

- -

Récupère la largeur du contenu visible de la fenêtre de navigation en incluant, s'il est visible, l'ascenseur vertical.
- Permet également de fixer une largeur pour le domaine d'affichage de la fenêtre.

- -

Syntaxe

- -
var largeur = window.innerWidth;
-
- -

Voir aussi : window.innerHeight, window.outerHeight and window.outerWidth.

- -

Valeur renvoyée

- -
-
innerWidth
-
un entier (nombre de pixels);
-
- -

Notes

- -

La propriété innerWidth est supportée par tous les objet "window" comme par exemple une fenêtre, une frame, un frameset, ou une fenêtre secondaire.

- -

Example

- -
// Retourne la largeur de la fenêtre
-var largeur = window.innerWidth;
-
-// Retourn la largeur de la fenêtre à l'intérieur d'une "frameset"
-var largeur = self.innerWidth;
-
-// Retourne la largeur de la fenêtre du "frameset" parent
-var largeurDeLaFrame = parent.innerWidth;
-
-// Retourne la largeur de la fenêtre du "frameset" principal
-var largeurDuFrameset = top.innerWidth;
- -

Pour changer la taille de la fenêtre, voir {{domxref("window.resizeBy")}} and {{domxref("window.resizeTo")}}.

- -

Spécifications

- - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('CSSOM View', '#dom-window-innerwidth', 'window.innerWidth')}}{{Spec2('CSSOM View')}}Définition initiale.
- -

Compatibilité des navigateurs

- -

{{Compat("api.Window.innerWidth")}}

diff --git a/files/fr/web/api/window/innerwidth/index.md b/files/fr/web/api/window/innerwidth/index.md new file mode 100644 index 0000000000..a76af5343a --- /dev/null +++ b/files/fr/web/api/window/innerwidth/index.md @@ -0,0 +1,68 @@ +--- +title: window.innerWidth +slug: Web/API/Window/innerWidth +translation_of: Web/API/Window/innerWidth +--- +

{{ ApiRef() }}

+ +

Résumé

+ +

Récupère la largeur du contenu visible de la fenêtre de navigation en incluant, s'il est visible, l'ascenseur vertical.
+ Permet également de fixer une largeur pour le domaine d'affichage de la fenêtre.

+ +

Syntaxe

+ +
var largeur = window.innerWidth;
+
+ +

Voir aussi : window.innerHeight, window.outerHeight and window.outerWidth.

+ +

Valeur renvoyée

+ +
+
innerWidth
+
un entier (nombre de pixels);
+
+ +

Notes

+ +

La propriété innerWidth est supportée par tous les objet "window" comme par exemple une fenêtre, une frame, un frameset, ou une fenêtre secondaire.

+ +

Example

+ +
// Retourne la largeur de la fenêtre
+var largeur = window.innerWidth;
+
+// Retourn la largeur de la fenêtre à l'intérieur d'une "frameset"
+var largeur = self.innerWidth;
+
+// Retourne la largeur de la fenêtre du "frameset" parent
+var largeurDeLaFrame = parent.innerWidth;
+
+// Retourne la largeur de la fenêtre du "frameset" principal
+var largeurDuFrameset = top.innerWidth;
+ +

Pour changer la taille de la fenêtre, voir {{domxref("window.resizeBy")}} and {{domxref("window.resizeTo")}}.

+ +

Spécifications

+ + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('CSSOM View', '#dom-window-innerwidth', 'window.innerWidth')}}{{Spec2('CSSOM View')}}Définition initiale.
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Window.innerWidth")}}

diff --git a/files/fr/web/api/window/issecurecontext/index.html b/files/fr/web/api/window/issecurecontext/index.html deleted file mode 100644 index dd6a2dbbc3..0000000000 --- a/files/fr/web/api/window/issecurecontext/index.html +++ /dev/null @@ -1,58 +0,0 @@ ---- -title: Window.isSecureContext -slug: Web/API/Window/isSecureContext -tags: - - API - - Propriété - - Reference - - Sécurité - - Window -translation_of: Web/API/Window/isSecureContext ---- -

{{APIRef}}{{SeeCompatTable}}

- -

La propriété en lecteur seule window.isSecureContext indique si un contexte est capable d'utiliser des fonctionnalités qui nécessitent des contextes sécurisés.

- -

Syntaxe

- -
var isSecure = window.isSecureContext
- -

Exemples

- -

Détection des fonctionnalités

- -

Vous pouvez utiliser la détection des fonctionnalités pour vérifier si elles sont dans un contexte sécurisé ou non à l'aide du booléen isSecureContext qui est exposé sur la portée globale.

- -
if (window.isSecureContext) {
-  // La page est un contexte sécurisé afin que les techniciens de service soient désormais disponibles
-  navigator.serviceWorker.register("/offline-worker.js").then(function () {
-    ...
-  });
-}
- -

Spécifications

- - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('Secure Contexts')}}{{Spec2('Secure Contexts','#monkey-patching-global-object','isSecureContext')}}Spécification initiale.
- -

Compatibilité des navigateurs

- -

{{Compat("api.Window.isSecureContext")}}

- -

Voir également

- - diff --git a/files/fr/web/api/window/issecurecontext/index.md b/files/fr/web/api/window/issecurecontext/index.md new file mode 100644 index 0000000000..dd6a2dbbc3 --- /dev/null +++ b/files/fr/web/api/window/issecurecontext/index.md @@ -0,0 +1,58 @@ +--- +title: Window.isSecureContext +slug: Web/API/Window/isSecureContext +tags: + - API + - Propriété + - Reference + - Sécurité + - Window +translation_of: Web/API/Window/isSecureContext +--- +

{{APIRef}}{{SeeCompatTable}}

+ +

La propriété en lecteur seule window.isSecureContext indique si un contexte est capable d'utiliser des fonctionnalités qui nécessitent des contextes sécurisés.

+ +

Syntaxe

+ +
var isSecure = window.isSecureContext
+ +

Exemples

+ +

Détection des fonctionnalités

+ +

Vous pouvez utiliser la détection des fonctionnalités pour vérifier si elles sont dans un contexte sécurisé ou non à l'aide du booléen isSecureContext qui est exposé sur la portée globale.

+ +
if (window.isSecureContext) {
+  // La page est un contexte sécurisé afin que les techniciens de service soient désormais disponibles
+  navigator.serviceWorker.register("/offline-worker.js").then(function () {
+    ...
+  });
+}
+ +

Spécifications

+ + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('Secure Contexts')}}{{Spec2('Secure Contexts','#monkey-patching-global-object','isSecureContext')}}Spécification initiale.
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Window.isSecureContext")}}

+ +

Voir également

+ + diff --git a/files/fr/web/api/window/languagechange_event/index.html b/files/fr/web/api/window/languagechange_event/index.html deleted file mode 100644 index a55d83a36d..0000000000 --- a/files/fr/web/api/window/languagechange_event/index.html +++ /dev/null @@ -1,79 +0,0 @@ ---- -title: 'Window: languagechange event' -slug: Web/API/Window/languagechange_event -tags: - - Evènement - - Expérimentale - - HTML DOM - - Reference - - Window -translation_of: Web/API/Window/languagechange_event ---- -
{{APIRef}}
- -

L'événement languagechange est déclenché sur l'objet d'étendue globale lorsque la langue préférée de l'utilisateur change.

- - - - - - - - - - - - - - - - - - - - -
BullesNon
AnnulableNon
Interface{{domxref("Event")}}
Propriété de gestionnaire d'événements{{domxref("WindowEventHandlers/onlanguagechange", "onlanguagechange")}}
- -

Exemples

- -

Vous pouvez utiliser l'événement languagechange dans une méthode {{domxref("EventTarget/addEventListener", "addEventListener")}} :

- -
window.addEventListener('languagechange', function() {
-  console.log('languagechange event detected!');
-});
- -

Ou utilisez la propriété du gestionnaire d'événements onlanguagechange :

- -
window.onlanguagechange = function(event) {
-  console.log('languagechange event detected!');
-};
- -

Spécification

- - - - - - - - - - - - - - -
SpécificationStatut
{{ SpecName('HTML WHATWG', 'indices.html#event-languagechange', 'languagechange') }}{{ Spec2('HTML WHATWG') }}
- -

Compatibilité des navigateurs

- -

{{Compat("api.Window.languagechange_event")}}

- -

Voir également

- - diff --git a/files/fr/web/api/window/languagechange_event/index.md b/files/fr/web/api/window/languagechange_event/index.md new file mode 100644 index 0000000000..a55d83a36d --- /dev/null +++ b/files/fr/web/api/window/languagechange_event/index.md @@ -0,0 +1,79 @@ +--- +title: 'Window: languagechange event' +slug: Web/API/Window/languagechange_event +tags: + - Evènement + - Expérimentale + - HTML DOM + - Reference + - Window +translation_of: Web/API/Window/languagechange_event +--- +
{{APIRef}}
+ +

L'événement languagechange est déclenché sur l'objet d'étendue globale lorsque la langue préférée de l'utilisateur change.

+ + + + + + + + + + + + + + + + + + + + +
BullesNon
AnnulableNon
Interface{{domxref("Event")}}
Propriété de gestionnaire d'événements{{domxref("WindowEventHandlers/onlanguagechange", "onlanguagechange")}}
+ +

Exemples

+ +

Vous pouvez utiliser l'événement languagechange dans une méthode {{domxref("EventTarget/addEventListener", "addEventListener")}} :

+ +
window.addEventListener('languagechange', function() {
+  console.log('languagechange event detected!');
+});
+ +

Ou utilisez la propriété du gestionnaire d'événements onlanguagechange :

+ +
window.onlanguagechange = function(event) {
+  console.log('languagechange event detected!');
+};
+ +

Spécification

+ + + + + + + + + + + + + + +
SpécificationStatut
{{ SpecName('HTML WHATWG', 'indices.html#event-languagechange', 'languagechange') }}{{ Spec2('HTML WHATWG') }}
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Window.languagechange_event")}}

+ +

Voir également

+ + diff --git a/files/fr/web/api/window/length/index.html b/files/fr/web/api/window/length/index.html deleted file mode 100644 index af1ee54111..0000000000 --- a/files/fr/web/api/window/length/index.html +++ /dev/null @@ -1,27 +0,0 @@ ---- -title: Window.length -slug: Web/API/Window/length -translation_of: Web/API/Window/length ---- -
{{ ApiRef() }}
- -

Retourne le nombre de frames (soit des éléments de frame ou iframe) présent sur la page.

- -

Syntaxe

- -
nombreDeFrames= window.length;
-
- - - -

Exemple

- -
if (window.length) {
-  // La page contient des frames
-}
- -

Specification

- -

{{DOM0}}

diff --git a/files/fr/web/api/window/length/index.md b/files/fr/web/api/window/length/index.md new file mode 100644 index 0000000000..af1ee54111 --- /dev/null +++ b/files/fr/web/api/window/length/index.md @@ -0,0 +1,27 @@ +--- +title: Window.length +slug: Web/API/Window/length +translation_of: Web/API/Window/length +--- +
{{ ApiRef() }}
+ +

Retourne le nombre de frames (soit des éléments de frame ou iframe) présent sur la page.

+ +

Syntaxe

+ +
nombreDeFrames= window.length;
+
+ + + +

Exemple

+ +
if (window.length) {
+  // La page contient des frames
+}
+ +

Specification

+ +

{{DOM0}}

diff --git a/files/fr/web/api/window/load_event/index.html b/files/fr/web/api/window/load_event/index.html deleted file mode 100644 index 9226d9630b..0000000000 --- a/files/fr/web/api/window/load_event/index.html +++ /dev/null @@ -1,91 +0,0 @@ ---- -title: load -slug: Web/API/Window/load_event -tags: - - Event - - Window -translation_of: Web/API/Window/load_event -original_slug: Web/Events/load ---- -

L’évènement load est émis lorsqu’une ressource et ses ressources dépendantes sont completement chargées.

- -

Informations générales

- -
-
Spécification
-
DOM L3
-
Interface
-
UIEvent
-
Bouillonne
-
Non
-
Annulable
-
Non
-
Cible
-
Document, Element
-
Action par défaut
-
Aucune.
-
- -

Propriétés

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
PropriétéTypeDescription
targetEventTargetLa cible de l’évènement (la cible la plus haute dans l’arbre DOM)
typeDOMStringLe type de l’évènement
bubblesbooleanSi l’évènement bouillonne ou non
cancelablebooleanSi l’évènement est annulable ou non
viewWindowProxydocument.defaultView (la fenêtre du document)
detaillong (float)0.
- -

Tous les évènements ci-dessus sont en lecture seule. Vous ne pouvez pas leur affecter de valeur.

- -

Exemple

- -
<script>
-  window.addEventListener("load", function(event) {
-    console.log("Toutes les ressources sont chargées !");
-  });
-</script>
- -

Évènements liés

- - diff --git a/files/fr/web/api/window/load_event/index.md b/files/fr/web/api/window/load_event/index.md new file mode 100644 index 0000000000..9226d9630b --- /dev/null +++ b/files/fr/web/api/window/load_event/index.md @@ -0,0 +1,91 @@ +--- +title: load +slug: Web/API/Window/load_event +tags: + - Event + - Window +translation_of: Web/API/Window/load_event +original_slug: Web/Events/load +--- +

L’évènement load est émis lorsqu’une ressource et ses ressources dépendantes sont completement chargées.

+ +

Informations générales

+ +
+
Spécification
+
DOM L3
+
Interface
+
UIEvent
+
Bouillonne
+
Non
+
Annulable
+
Non
+
Cible
+
Document, Element
+
Action par défaut
+
Aucune.
+
+ +

Propriétés

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
PropriétéTypeDescription
targetEventTargetLa cible de l’évènement (la cible la plus haute dans l’arbre DOM)
typeDOMStringLe type de l’évènement
bubblesbooleanSi l’évènement bouillonne ou non
cancelablebooleanSi l’évènement est annulable ou non
viewWindowProxydocument.defaultView (la fenêtre du document)
detaillong (float)0.
+ +

Tous les évènements ci-dessus sont en lecture seule. Vous ne pouvez pas leur affecter de valeur.

+ +

Exemple

+ +
<script>
+  window.addEventListener("load", function(event) {
+    console.log("Toutes les ressources sont chargées !");
+  });
+</script>
+ +

Évènements liés

+ + diff --git a/files/fr/web/api/window/localstorage/index.html b/files/fr/web/api/window/localstorage/index.html deleted file mode 100644 index 3385e051fb..0000000000 --- a/files/fr/web/api/window/localstorage/index.html +++ /dev/null @@ -1,91 +0,0 @@ ---- -title: Window.localStorage -slug: Web/API/Window/localStorage -tags: - - API - - Propriété - - Reference - - Stockage - - Stockage Web - - Window - - WindowLocalStorage - - lecture seule - - localStorage -translation_of: Web/API/Window/localStorage ---- -

{{APIRef("Web Storage API")}}

- -

La propriété localStorage vous permet d'accéder à un objet local {{domxref("Storage")}}. Le localStorage est similaire au sessionStorage. La seule différence : les données stockées dans le localStorage n'ont pas de délai d'expiration, alors que les données stockées dans le sessionStorage sont nettoyées quand la session navigateur prend fin — donc quand on ferme le navigateur.

- -

Il convient de noter que les données stockées dans localStorage ou sessionStorage sont spécifiques au protocole de la page.

- -

Les clés et les valeurs sont toujours des chaînes de caractères (à noter que, comme pour les objets, les clés entières seront automatiquement converties en chaînes de caractères).

- -

Syntaxe

- -
monStockage = localStorage;
- -

Valeur

- -

Un objet {{DOMxRef("Storage")}} qui peut être utilisé pour accéder à l'espace de stockage local de l'origine actuelle.

- -

Exceptions

- -
-
SecurityError
-
La demande viole une décision politique, ou l'origine n'est pas un schéma/hôte/port valide (cela peut se produire si l'origine utilise le shéma file: ou data:, par exemple). Par exemple, l'utilisateur peut configurer son navigateur de manière à refuser la permission de conserver des données pour l'origine spécifiée.
-
- -

Exemple

- -

L'extrait de code suivant accède à l'objet local {{domxref("Storage")}} du domaine courant et lui ajoute une entrée en utilisant {{domxref("Storage.setItem()")}}.

- -
localStorage.setItem('monChat', 'Tom');
- -

La syntaxe pour la lecture de l'article localStorage est la suivante :

- -
var cat = localStorage.getItem('myCat');
- -

La syntaxe pour la suppression de l'élément localStorage est la suivante :

- -
localStorage.removeItem('myCat');
- -

La syntaxe pour supprimer tous les éléments de localStorage est la suivante :

- -
// Effacer tous les éléments
-localStorage.clear();
-
- -
-

Note : Se référer à l'article Using the Web Storage API pour voir un exemple complet.

-
- -

Spécifications

- - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName("HTML WHATWG", "webstorage.html#dom-localstorage", "localStorage")}}{{Spec2("HTML WHATWG")}}
- -

Compatibilité navigateurs

- -

{{Compat("api.Window.localStorage")}}

- -

Voir aussi

- - diff --git a/files/fr/web/api/window/localstorage/index.md b/files/fr/web/api/window/localstorage/index.md new file mode 100644 index 0000000000..3385e051fb --- /dev/null +++ b/files/fr/web/api/window/localstorage/index.md @@ -0,0 +1,91 @@ +--- +title: Window.localStorage +slug: Web/API/Window/localStorage +tags: + - API + - Propriété + - Reference + - Stockage + - Stockage Web + - Window + - WindowLocalStorage + - lecture seule + - localStorage +translation_of: Web/API/Window/localStorage +--- +

{{APIRef("Web Storage API")}}

+ +

La propriété localStorage vous permet d'accéder à un objet local {{domxref("Storage")}}. Le localStorage est similaire au sessionStorage. La seule différence : les données stockées dans le localStorage n'ont pas de délai d'expiration, alors que les données stockées dans le sessionStorage sont nettoyées quand la session navigateur prend fin — donc quand on ferme le navigateur.

+ +

Il convient de noter que les données stockées dans localStorage ou sessionStorage sont spécifiques au protocole de la page.

+ +

Les clés et les valeurs sont toujours des chaînes de caractères (à noter que, comme pour les objets, les clés entières seront automatiquement converties en chaînes de caractères).

+ +

Syntaxe

+ +
monStockage = localStorage;
+ +

Valeur

+ +

Un objet {{DOMxRef("Storage")}} qui peut être utilisé pour accéder à l'espace de stockage local de l'origine actuelle.

+ +

Exceptions

+ +
+
SecurityError
+
La demande viole une décision politique, ou l'origine n'est pas un schéma/hôte/port valide (cela peut se produire si l'origine utilise le shéma file: ou data:, par exemple). Par exemple, l'utilisateur peut configurer son navigateur de manière à refuser la permission de conserver des données pour l'origine spécifiée.
+
+ +

Exemple

+ +

L'extrait de code suivant accède à l'objet local {{domxref("Storage")}} du domaine courant et lui ajoute une entrée en utilisant {{domxref("Storage.setItem()")}}.

+ +
localStorage.setItem('monChat', 'Tom');
+ +

La syntaxe pour la lecture de l'article localStorage est la suivante :

+ +
var cat = localStorage.getItem('myCat');
+ +

La syntaxe pour la suppression de l'élément localStorage est la suivante :

+ +
localStorage.removeItem('myCat');
+ +

La syntaxe pour supprimer tous les éléments de localStorage est la suivante :

+ +
// Effacer tous les éléments
+localStorage.clear();
+
+ +
+

Note : Se référer à l'article Using the Web Storage API pour voir un exemple complet.

+
+ +

Spécifications

+ + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName("HTML WHATWG", "webstorage.html#dom-localstorage", "localStorage")}}{{Spec2("HTML WHATWG")}}
+ +

Compatibilité navigateurs

+ +

{{Compat("api.Window.localStorage")}}

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/window/location/index.html b/files/fr/web/api/window/location/index.html deleted file mode 100644 index f8074f97f9..0000000000 --- a/files/fr/web/api/window/location/index.html +++ /dev/null @@ -1,197 +0,0 @@ ---- -title: Window.location -slug: Web/API/Window/location -translation_of: Web/API/Window/location -browser-compat: api.Window.location ---- -

{{APIRef}}

- -

La propriété en lecture seule Window.location renvoie un objet Location qui contient des informations à propos de l'emplacement courant du document.

- -

Bien que Window.location soit un objet Location en lecture seule, on peut lui affecter une chaîne de caractères DOMString. Cela signifie qu'on peut, la plupart du temps, manipuler location comme une chaîne de caractères : location = 'http://www.example.com' est par exemple synonyme de location.href = 'http://www.example.com'.

- -

Voir la page de l'interface Location pour connaître l'ensemble des propriétés disponibles.

- -

Syntaxe

- -
-var oldLocation = location;
-location = newLocation;
-
- -

Exemples

- -

Exemple simple

- -
-console.log(location); // affiche "https://developer.mozilla.org/fr/docs/Web/API/Window/location" dans la console
-
- -

Premier exemple : naviguer sur une nouvelle page

- -

Lorsqu'une nouvelle valeur est affectée à l'objet location, un document sera chargé en utilisant l'URL comme si location.assign() avait été invoquée avec l'URL modifiée.

- -
-

Note : Les marqueurs de bac à sable relatifs à la navigation pourront lever une exception et empêcher la navigation.

-
- -
-location.assign("http://www.mozilla.org"); // ou
-location = "http://www.mozilla.org";
-
- -

Deuxième exemple : recharger la page courante

- -
location.reload();
- -

Troisième exemple

- -

Dans cet exemple, on recharge la page avec la méthode replace() afin d'insérer la valeur de location.pathname dans l'ancre :

- -
-function reloadPageWithHash() {
-  var initialPage = location.pathname;
-  location.replace('http://example.com/#' + initialPage);
-}
-
- -

Quatrième exemple : afficher les propriétés de l'URL courante

- -
-function showLoc() {
-  var oLocation = location, aLog = ["Property (Typeof): Value", "location (" + (typeof oLocation) + "): " + oLocation ];
-  for (var sProp in oLocation){
-  aLog.push(sProp + " (" + (typeof oLocation[sProp]) + "): " + (oLocation[sProp] || "n/a"));
-  }
-  console.log(aLog.join("\n"));
-}
-
- - - -
-function sendData (sData) {
-  location.search = sData;
-}
-
-// Dans le HTML: <button onclick="sendData('Des données');">Envoyer des données</button>
-
- -

On ajoutera "?Des%20données" à l'URL courante qui sera alors envoyée au serveur. Si aucune action n'est entreprise par le serveur, le document courant est rechargé avec la chaîne de recherche modifiée.

- -

Sixième exemple : utiliser les marques-pages sans changer la propriété hash

- -
-<!doctype html>
-  <html>
-  <head>
-    <meta charset="UTF-8"/>
-    <title>Exemple MDN</title>
-    <script>
-function showNode (oNode) {
-  document.documentElement.scrollTop = oNode.offsetTop;
-  document.documentElement.scrollLeft = oNode.offsetLeft;
-}
-
-function showBookmark (sBookmark, bUseHash) {
-  if (arguments.length === 1 || bUseHash) { location.hash = sBookmark; return; }
-  var oBookmark = document.querySelector(sBookmark);
-  if (oBookmark) { showNode(oBookmark); }
-}
-    </script>
-    <style>
-span.intLink {
-    cursor: pointer;
-    color: #0000ff;
-    text-decoration: underline;
-}
-    </style>
-  </head>
-
-<body>
-  <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nullam ultrices dolor ac dolor imperdiet ullamcorper. Suspendisse quam libero, luctus auctor mollis sed, malesuada condimentum magna. Quisque in ante tellus, in placerat est. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Donec a mi magna, quis mattis dolor. Etiam sit amet ligula quis urna auctor imperdiet nec faucibus ante. Mauris vel consectetur dolor. Nunc eget elit eget velit pulvinar fringilla consectetur aliquam purus. Curabitur convallis, justo posuere porta egestas, velit erat ornare tortor, non viverra justo diam eget arcu. Phasellus adipiscing fermentum nibh ac commodo. Nam turpis nunc, suscipit a hendrerit vitae, volutpat non ipsum.</p>
-  <p>Duis lobortis sapien quis nisl luctus porttitor. In tempor semper libero, eu tincidunt dolor eleifend sit amet. Ut nec velit in dolor tincidunt rhoncus non non diam. Morbi auctor ornare orci, non euismod felis gravida nec. Curabitur elementum nisi a eros rutrum nec blandit diam placerat. Aenean tincidunt risus ut nisi consectetur cursus. Ut vitae quam elit. Donec dignissim est in quam tempor consequat. Aliquam aliquam diam non felis convallis suscipit. Nulla facilisi. Donec lacus risus, dignissim et fringilla et, egestas vel eros. Duis malesuada accumsan dui, at fringilla mauris bibendum quis. Cras adipiscing ultricies fermentum. Praesent bibendum condimentum feugiat.</p>
-  <p id="myBookmark1">[&nbsp;<span class="intLink" onclick="showBookmark('#myBookmark2');">Aller au marque-page n°2</span>&nbsp;]</p>
-  <p>Vivamus blandit massa ut metus mattis in fringilla lectus imperdiet. Proin ac ante a felis ornare vehicula. Fusce pellentesque lacus vitae eros convallis ut mollis magna pellentesque. Pellentesque placerat enim at lacus ultricies vitae facilisis nisi fringilla. In tincidunt tincidunt tincidunt. Nulla vitae tempor nisl. Etiam congue, elit vitae egestas mollis, ipsum nisi malesuada turpis, a volutpat arcu arcu id risus.</p>
-  <p>Nam faucibus, ligula eu fringilla pulvinar, lectus tellus iaculis nunc, vitae scelerisque metus leo non metus. Proin mattis lobortis lobortis. Quisque accumsan faucibus erat, vel varius tortor ultricies ac. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed nec libero nunc. Nullam tortor nunc, elementum a consectetur et, ultrices eu orci. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque a nisl eu sem vehicula egestas.</p>
-  <p>Aenean viverra varius mauris, sed elementum lacus interdum non. Phasellus sit amet lectus vitae eros egestas pellentesque fermentum eget magna. Quisque mauris nisl, gravida vitae placerat et, condimentum id metus. Nulla eu est dictum dolor pulvinar volutpat. Pellentesque vitae sollicitudin nunc. Donec neque magna, lobortis id egestas nec, sodales quis lectus. Fusce cursus sollicitudin porta. Suspendisse ut tortor in mauris tincidunt rhoncus. Maecenas tincidunt fermentum facilisis. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas.</p>
-  <p>Suspendisse turpis nisl, consectetur in lacinia ut, ornare vel mi. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Proin non lectus eu turpis vulputate cursus. Mauris interdum tincidunt erat id pharetra. Nullam in libero elit, sed consequat lectus. Morbi odio nisi, porta vitae molestie ut, gravida ut nunc. Ut non est dui, id ullamcorper orci. Praesent vel elementum felis. Maecenas ornare, dui quis auctor hendrerit, turpis sem ullamcorper odio, in auctor magna metus quis leo. Morbi at odio ante.</p>
-  <p>Curabitur est ipsum, porta ac viverra faucibus, eleifend sed eros. In sit amet vehicula tortor. Vestibulum viverra pellentesque erat a elementum. Integer commodo ultricies lorem, eget tincidunt risus viverra et. In enim turpis, porttitor ac ornare et, suscipit sit amet nisl. Vestibulum ante ipsum primis in faucibus orci luctus et ultrices posuere cubilia Curae; Pellentesque vel ultrices nibh. Sed commodo aliquam aliquam. Nulla euismod, odio ut eleifend mollis, nisi dui gravida nibh, vitae laoreet turpis purus id ipsum. Donec convallis, velit non scelerisque bibendum, diam nulla auctor nunc, vel dictum risus ipsum sit amet est. Praesent ut nibh sit amet nibh congue pulvinar. Suspendisse dictum porttitor tempor.</p>
-  <p>Vestibulum dignissim erat vitae lectus auctor ac bibendum eros semper. Integer aliquet, leo non ornare faucibus, risus arcu tristique dolor, a aliquet massa mauris quis arcu. In porttitor, lectus ac semper egestas, ligula magna laoreet libero, eu commodo mauris odio id ante. In hac habitasse platea dictumst. In pretium erat diam, nec consequat eros. Praesent augue mi, consequat sed porttitor at, volutpat vitae eros. Sed pretium pharetra dapibus. Donec auctor interdum erat, lacinia molestie nibh commodo ut. Maecenas vestibulum vulputate felis, ut ullamcorper arcu faucibus in. Curabitur id arcu est. In semper mollis lorem at pellentesque. Sed lectus nisl, vestibulum id scelerisque eu, feugiat et tortor. Pellentesque porttitor facilisis ultricies.</p>
-  <p id="myBookmark2">[&nbsp;<span class="intLink" onclick="showBookmark('#myBookmark1');">Aller au marque-page n°1</span> | <span class="intLink" onclick="showBookmark('#myBookmark1', false);">Aller au marque-page n°1 sans utiliser location.hash</span> | <span class="intLink" onclick="showBookmark('#myBookmark3');">Aller au marque-page n°3</span>&nbsp;]</p>
-  <p>Phasellus tempus fringilla nunc, eget sagittis orci molestie vel. Nulla sollicitudin diam non quam iaculis ac porta justo venenatis. Quisque tellus urna, molestie vitae egestas sit amet, suscipit sed sem. Quisque nec lorem eu velit faucibus tristique ut ut dolor. Cras eu tortor ut libero placerat venenatis ut ut massa. Sed quis libero augue, et consequat libero. Morbi rutrum augue sed turpis elementum sed luctus nisl molestie. Aenean vitae purus risus, a semper nisl. Pellentesque malesuada, est id sagittis consequat, libero mauris tincidunt tellus, eu sagittis arcu purus rutrum eros. Quisque eget eleifend mi. Duis pharetra mi ac eros mattis lacinia rutrum ipsum varius.</p>
-  <p>Fusce cursus pulvinar aliquam. Duis justo enim, ornare vitae elementum sed, porta a quam. Aliquam eu enim eu libero mollis tempus. Morbi ornare aliquam posuere. Proin faucibus luctus libero, sed ultrices lorem sagittis et. Vestibulum malesuada, ante nec molestie vehicula, quam diam mollis ipsum, rhoncus posuere mauris lectus in eros. Nullam feugiat ultrices augue, ac sodales sem mollis in.</p>
-  <p id="myBookmark3"><em>Voici le marque-page n°3</em></p>
-  <p>Proin vitae sem non lorem pellentesque molestie. Nam tempus massa et turpis placerat sit amet sollicitudin orci sodales. Pellentesque enim enim, sagittis a lobortis ut, tempus sed arcu. Aliquam augue turpis, varius vel bibendum ut, aliquam at diam. Nam lobortis, dui eu hendrerit pellentesque, sem neque porttitor erat, non dapibus velit lectus in metus. Vestibulum sit amet felis enim. In quis est vitae nunc malesuada consequat nec nec sapien. Suspendisse aliquam massa placerat dui lacinia luctus sed vitae risus. Fusce tempus, neque id ultrices volutpat, mi urna auctor arcu, viverra semper libero sem vel enim. Mauris dictum, elit non placerat malesuada, libero elit euismod nibh, nec posuere massa arcu eu risus. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer urna velit, dapibus eget varius feugiat, pellentesque sit amet ligula. Maecenas nulla nisl, facilisis eu egestas scelerisque, mollis eget metus. Vestibulum ante ipsum primis in faucibus orci luctus et ultrices posuere cubilia Curae; Morbi sed congue mi.</p>
-  <p>Fusce metus velit, pharetra at vestibulum nec, facilisis porttitor mi. Curabitur ligula sapien, fermentum vel porttitor id, rutrum sit amet magna. Sed sit amet sollicitudin turpis. Aenean luctus rhoncus dolor, et pulvinar ante egestas et. Donec ac massa orci, quis dapibus augue. Vivamus consectetur auctor pellentesque. Praesent vestibulum tincidunt ante sed consectetur. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Fusce purus metus, imperdiet vitae iaculis convallis, bibendum vitae turpis.</p>
-  <p>Fusce aliquet molestie dolor, in ornare dui sodales nec. In molestie sollicitudin felis a porta. Mauris nec orci sit amet orci blandit tristique congue nec nunc. Praesent et tellus sollicitudin mauris accumsan fringilla. Morbi sodales, justo eu sollicitudin lacinia, lectus sapien ullamcorper eros, quis molestie urna elit bibendum risus. Proin eget tincidunt quam. Nam luctus commodo mauris, eu posuere nunc luctus non. Nulla facilisi. Vivamus eget leo rhoncus quam accumsan fringilla. Aliquam sit amet lorem est. Nullam vel tellus nibh, id imperdiet orci. Integer egestas leo eu turpis blandit scelerisque.</p>
-  <p>Etiam in blandit tellus. Integer sed varius quam. Vestibulum dapibus mi gravida arcu viverra blandit. Praesent tristique augue id sem adipiscing pellentesque. Sed sollicitudin, leo sed interdum elementum, nisi ante condimentum leo, eget ornare libero diam semper quam. Vivamus augue urna, porta eget ultrices et, dapibus ut ligula. Ut laoreet consequat faucibus. Praesent at lectus ut lectus malesuada mollis. Nam interdum adipiscing eros, nec sodales mi porta nec. Proin et quam vitae sem interdum aliquet. Proin vel odio at lacus vehicula aliquet.</p>
-  <p>Etiam placerat dui ut sem ornare vel vestibulum augue mattis. Sed semper malesuada mi, eu bibendum lacus lobortis nec. Etiam fringilla elementum risus, eget consequat urna laoreet nec. Etiam mollis quam non sem convallis vel consectetur lectus ullamcorper. Aenean mattis lacus quis ligula mattis eget vestibulum diam hendrerit. In non placerat mauris. Praesent faucibus nunc quis eros sagittis viverra. In hac habitasse platea dictumst. Suspendisse eget nisl erat, ac molestie massa. Praesent mollis vestibulum tincidunt. Fusce suscipit laoreet malesuada. Aliquam erat volutpat. Aliquam dictum elementum rhoncus. Praesent in est massa, pulvinar sodales nunc. Pellentesque gravida euismod mi ac convallis.</p>
-  <p>Mauris vel odio vel nulla facilisis lacinia. Aliquam ultrices est at leo blandit tincidunt. Vestibulum ante ipsum primis in faucibus orci luctus et ultrices posuere cubilia Curae; Suspendisse porttitor adipiscing facilisis. Duis cursus quam iaculis augue interdum porttitor. Vestibulum ante ipsum primis in faucibus orci luctus et ultrices posuere cubilia Curae; Duis vulputate magna ac metus pretium condimentum. In tempus, est eget vestibulum blandit, velit massa dignissim nisl, ut scelerisque lorem neque vel velit. Maecenas fermentum commodo viverra. Curabitur a nibh non velit aliquam cursus. Integer semper condimentum tortor a pellentesque. Pellentesque semper, nisl id porttitor vehicula, sem dui feugiat lacus, vitae consequat augue urna vel odio.</p>
-  <p>Vestibulum id neque nec turpis iaculis pulvinar et a massa. Vestibulum sed nibh vitae arcu eleifend egestas. Mauris fermentum ultrices blandit. Suspendisse vitae lorem libero. Aenean et pellentesque tellus. Morbi quis neque orci, eu dignissim dui. Fusce sollicitudin mauris ac arcu vestibulum imperdiet. Proin ultricies nisl sit amet enim imperdiet eu ornare dui tempus. Maecenas lobortis nisi a tortor vestibulum vel eleifend tellus vestibulum. Donec metus sapien, hendrerit a fermentum id, dictum quis libero.</p>
-  <p>Pellentesque a lorem nulla, in tempor justo. Duis odio nisl, dignissim sed consequat sit amet, hendrerit ac neque. Nunc ac augue nec massa tempor rhoncus. Nam feugiat, tellus a varius euismod, justo nisl faucibus velit, ut vulputate justo massa eu nibh. Sed bibendum urna quis magna facilisis in accumsan dolor malesuada. Morbi sit amet nunc risus, in faucibus sem. Nullam sollicitudin magna sed sem mollis id commodo libero condimentum. Duis eu massa et lacus semper molestie ut adipiscing sem.</p>
-  <p>Sed id nulla mi, eget suscipit eros. Aliquam tempus molestie rutrum. In quis varius elit. Nullam dignissim neque nec velit vulputate porttitor. Mauris ac ligula sit amet elit fermentum rhoncus. In tellus urna, pulvinar quis condimentum ut, porta nec justo. In hac habitasse platea dictumst. Proin volutpat elit id quam molestie ac commodo lacus sagittis. Quisque placerat, augue tempor placerat pulvinar, nisi nisi venenatis urna, eget convallis eros velit quis magna. Suspendisse volutpat iaculis quam, ut tristique lacus luctus quis.</p>
-  <p>Nullam commodo suscipit lacus non aliquet. Phasellus ac nisl lorem, sed facilisis ligula. Nam cursus lobortis placerat. Sed dui nisi, elementum eu sodales ac, placerat sit amet mauris. Pellentesque dapibus tellus ut ipsum aliquam eu auctor dui vehicula. Quisque ultrices laoreet erat, at ultrices tortor sodales non. Sed venenatis luctus magna, ultricies ultricies nunc fringilla eget. Praesent scelerisque urna vitae nibh tristique varius consequat neque luctus. Integer ornare, erat a porta tempus, velit justo fermentum elit, a fermentum metus nisi eu ipsum. Vivamus eget augue vel dui viverra adipiscing congue ut massa. Praesent vitae eros erat, pulvinar laoreet magna. Maecenas vestibulum mollis nunc in posuere. Pellentesque sit amet metus a turpis lobortis tempor eu vel tortor. Cras sodales eleifend interdum.</p>
-</body>
-</html>
-
- -

La même chose mais avec un défilement animé :

- -
-var showBookmark = (function () {
-  var  _useHash, _scrollX, _scrollY, _nodeX, _nodeY, _itFrame, _scrollId = -1, _bookMark,
-   /*
-   * nDuration: la durée, exprimée en millisecondes, pour chaque frame
-   * nFrames: le nombre de frames pour chaque défilement
-   */
-   nDuration = 200, nFrames = 10;
-
-  function _next () {
-  if (_itFrame > nFrames) { clearInterval(_scrollId); _scrollId = -1; return; }
-  _isBot = true;
-  document.documentElement.scrollTop = Math.round(_scrollY + (_nodeY - _scrollY) * _itFrame / nFrames);
-  document.documentElement.scrollLeft = Math.round(_scrollX + (_nodeX - _scrollX) * _itFrame / nFrames);
-  if (_useHash && _itFrame === nFrames) { location.hash = _bookMark; }
-  _itFrame++;
-  }
-
-  function _chkOwner () {
-  if (_isBot) { _isBot = false; return; }
-  if (_scrollId > -1) { clearInterval(_scrollId); _scrollId = -1; }
-  }
-
-  if (window.addEventListener) { window.addEventListener("scroll", _chkOwner, false); }
-  else if (window.attachEvent) { window.attachEvent("onscroll", _chkOwner); }
-
-  return function (sBookmark, bUseHash) {
-    var oNode = document.querySelector(sBookmark);
-  _scrollY = document.documentElement.scrollTop;
-  _scrollX = document.documentElement.scrollLeft;
-  _bookMark = sBookmark;
-  _useHash = bUseHash === true;
-  _nodeX = oNode.offsetLeft;
-    _nodeY = oNode.offsetTop;
-    _itFrame = 1;
-  if (_scrollId === -1) { _scrollId = setInterval(_next, Math.round(nDuration / nFrames)); }
-  };
-})();
-
- -

Spécifications

- -

{{Specifications}}

- -

Compatibilité des navigateurs

- -

{{Compat}}

- -

Voir aussi

- - diff --git a/files/fr/web/api/window/location/index.md b/files/fr/web/api/window/location/index.md new file mode 100644 index 0000000000..f8074f97f9 --- /dev/null +++ b/files/fr/web/api/window/location/index.md @@ -0,0 +1,197 @@ +--- +title: Window.location +slug: Web/API/Window/location +translation_of: Web/API/Window/location +browser-compat: api.Window.location +--- +

{{APIRef}}

+ +

La propriété en lecture seule Window.location renvoie un objet Location qui contient des informations à propos de l'emplacement courant du document.

+ +

Bien que Window.location soit un objet Location en lecture seule, on peut lui affecter une chaîne de caractères DOMString. Cela signifie qu'on peut, la plupart du temps, manipuler location comme une chaîne de caractères : location = 'http://www.example.com' est par exemple synonyme de location.href = 'http://www.example.com'.

+ +

Voir la page de l'interface Location pour connaître l'ensemble des propriétés disponibles.

+ +

Syntaxe

+ +
+var oldLocation = location;
+location = newLocation;
+
+ +

Exemples

+ +

Exemple simple

+ +
+console.log(location); // affiche "https://developer.mozilla.org/fr/docs/Web/API/Window/location" dans la console
+
+ +

Premier exemple : naviguer sur une nouvelle page

+ +

Lorsqu'une nouvelle valeur est affectée à l'objet location, un document sera chargé en utilisant l'URL comme si location.assign() avait été invoquée avec l'URL modifiée.

+ +
+

Note : Les marqueurs de bac à sable relatifs à la navigation pourront lever une exception et empêcher la navigation.

+
+ +
+location.assign("http://www.mozilla.org"); // ou
+location = "http://www.mozilla.org";
+
+ +

Deuxième exemple : recharger la page courante

+ +
location.reload();
+ +

Troisième exemple

+ +

Dans cet exemple, on recharge la page avec la méthode replace() afin d'insérer la valeur de location.pathname dans l'ancre :

+ +
+function reloadPageWithHash() {
+  var initialPage = location.pathname;
+  location.replace('http://example.com/#' + initialPage);
+}
+
+ +

Quatrième exemple : afficher les propriétés de l'URL courante

+ +
+function showLoc() {
+  var oLocation = location, aLog = ["Property (Typeof): Value", "location (" + (typeof oLocation) + "): " + oLocation ];
+  for (var sProp in oLocation){
+  aLog.push(sProp + " (" + (typeof oLocation[sProp]) + "): " + (oLocation[sProp] || "n/a"));
+  }
+  console.log(aLog.join("\n"));
+}
+
+ + + +
+function sendData (sData) {
+  location.search = sData;
+}
+
+// Dans le HTML: <button onclick="sendData('Des données');">Envoyer des données</button>
+
+ +

On ajoutera "?Des%20données" à l'URL courante qui sera alors envoyée au serveur. Si aucune action n'est entreprise par le serveur, le document courant est rechargé avec la chaîne de recherche modifiée.

+ +

Sixième exemple : utiliser les marques-pages sans changer la propriété hash

+ +
+<!doctype html>
+  <html>
+  <head>
+    <meta charset="UTF-8"/>
+    <title>Exemple MDN</title>
+    <script>
+function showNode (oNode) {
+  document.documentElement.scrollTop = oNode.offsetTop;
+  document.documentElement.scrollLeft = oNode.offsetLeft;
+}
+
+function showBookmark (sBookmark, bUseHash) {
+  if (arguments.length === 1 || bUseHash) { location.hash = sBookmark; return; }
+  var oBookmark = document.querySelector(sBookmark);
+  if (oBookmark) { showNode(oBookmark); }
+}
+    </script>
+    <style>
+span.intLink {
+    cursor: pointer;
+    color: #0000ff;
+    text-decoration: underline;
+}
+    </style>
+  </head>
+
+<body>
+  <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nullam ultrices dolor ac dolor imperdiet ullamcorper. Suspendisse quam libero, luctus auctor mollis sed, malesuada condimentum magna. Quisque in ante tellus, in placerat est. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Donec a mi magna, quis mattis dolor. Etiam sit amet ligula quis urna auctor imperdiet nec faucibus ante. Mauris vel consectetur dolor. Nunc eget elit eget velit pulvinar fringilla consectetur aliquam purus. Curabitur convallis, justo posuere porta egestas, velit erat ornare tortor, non viverra justo diam eget arcu. Phasellus adipiscing fermentum nibh ac commodo. Nam turpis nunc, suscipit a hendrerit vitae, volutpat non ipsum.</p>
+  <p>Duis lobortis sapien quis nisl luctus porttitor. In tempor semper libero, eu tincidunt dolor eleifend sit amet. Ut nec velit in dolor tincidunt rhoncus non non diam. Morbi auctor ornare orci, non euismod felis gravida nec. Curabitur elementum nisi a eros rutrum nec blandit diam placerat. Aenean tincidunt risus ut nisi consectetur cursus. Ut vitae quam elit. Donec dignissim est in quam tempor consequat. Aliquam aliquam diam non felis convallis suscipit. Nulla facilisi. Donec lacus risus, dignissim et fringilla et, egestas vel eros. Duis malesuada accumsan dui, at fringilla mauris bibendum quis. Cras adipiscing ultricies fermentum. Praesent bibendum condimentum feugiat.</p>
+  <p id="myBookmark1">[&nbsp;<span class="intLink" onclick="showBookmark('#myBookmark2');">Aller au marque-page n°2</span>&nbsp;]</p>
+  <p>Vivamus blandit massa ut metus mattis in fringilla lectus imperdiet. Proin ac ante a felis ornare vehicula. Fusce pellentesque lacus vitae eros convallis ut mollis magna pellentesque. Pellentesque placerat enim at lacus ultricies vitae facilisis nisi fringilla. In tincidunt tincidunt tincidunt. Nulla vitae tempor nisl. Etiam congue, elit vitae egestas mollis, ipsum nisi malesuada turpis, a volutpat arcu arcu id risus.</p>
+  <p>Nam faucibus, ligula eu fringilla pulvinar, lectus tellus iaculis nunc, vitae scelerisque metus leo non metus. Proin mattis lobortis lobortis. Quisque accumsan faucibus erat, vel varius tortor ultricies ac. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed nec libero nunc. Nullam tortor nunc, elementum a consectetur et, ultrices eu orci. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque a nisl eu sem vehicula egestas.</p>
+  <p>Aenean viverra varius mauris, sed elementum lacus interdum non. Phasellus sit amet lectus vitae eros egestas pellentesque fermentum eget magna. Quisque mauris nisl, gravida vitae placerat et, condimentum id metus. Nulla eu est dictum dolor pulvinar volutpat. Pellentesque vitae sollicitudin nunc. Donec neque magna, lobortis id egestas nec, sodales quis lectus. Fusce cursus sollicitudin porta. Suspendisse ut tortor in mauris tincidunt rhoncus. Maecenas tincidunt fermentum facilisis. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas.</p>
+  <p>Suspendisse turpis nisl, consectetur in lacinia ut, ornare vel mi. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Proin non lectus eu turpis vulputate cursus. Mauris interdum tincidunt erat id pharetra. Nullam in libero elit, sed consequat lectus. Morbi odio nisi, porta vitae molestie ut, gravida ut nunc. Ut non est dui, id ullamcorper orci. Praesent vel elementum felis. Maecenas ornare, dui quis auctor hendrerit, turpis sem ullamcorper odio, in auctor magna metus quis leo. Morbi at odio ante.</p>
+  <p>Curabitur est ipsum, porta ac viverra faucibus, eleifend sed eros. In sit amet vehicula tortor. Vestibulum viverra pellentesque erat a elementum. Integer commodo ultricies lorem, eget tincidunt risus viverra et. In enim turpis, porttitor ac ornare et, suscipit sit amet nisl. Vestibulum ante ipsum primis in faucibus orci luctus et ultrices posuere cubilia Curae; Pellentesque vel ultrices nibh. Sed commodo aliquam aliquam. Nulla euismod, odio ut eleifend mollis, nisi dui gravida nibh, vitae laoreet turpis purus id ipsum. Donec convallis, velit non scelerisque bibendum, diam nulla auctor nunc, vel dictum risus ipsum sit amet est. Praesent ut nibh sit amet nibh congue pulvinar. Suspendisse dictum porttitor tempor.</p>
+  <p>Vestibulum dignissim erat vitae lectus auctor ac bibendum eros semper. Integer aliquet, leo non ornare faucibus, risus arcu tristique dolor, a aliquet massa mauris quis arcu. In porttitor, lectus ac semper egestas, ligula magna laoreet libero, eu commodo mauris odio id ante. In hac habitasse platea dictumst. In pretium erat diam, nec consequat eros. Praesent augue mi, consequat sed porttitor at, volutpat vitae eros. Sed pretium pharetra dapibus. Donec auctor interdum erat, lacinia molestie nibh commodo ut. Maecenas vestibulum vulputate felis, ut ullamcorper arcu faucibus in. Curabitur id arcu est. In semper mollis lorem at pellentesque. Sed lectus nisl, vestibulum id scelerisque eu, feugiat et tortor. Pellentesque porttitor facilisis ultricies.</p>
+  <p id="myBookmark2">[&nbsp;<span class="intLink" onclick="showBookmark('#myBookmark1');">Aller au marque-page n°1</span> | <span class="intLink" onclick="showBookmark('#myBookmark1', false);">Aller au marque-page n°1 sans utiliser location.hash</span> | <span class="intLink" onclick="showBookmark('#myBookmark3');">Aller au marque-page n°3</span>&nbsp;]</p>
+  <p>Phasellus tempus fringilla nunc, eget sagittis orci molestie vel. Nulla sollicitudin diam non quam iaculis ac porta justo venenatis. Quisque tellus urna, molestie vitae egestas sit amet, suscipit sed sem. Quisque nec lorem eu velit faucibus tristique ut ut dolor. Cras eu tortor ut libero placerat venenatis ut ut massa. Sed quis libero augue, et consequat libero. Morbi rutrum augue sed turpis elementum sed luctus nisl molestie. Aenean vitae purus risus, a semper nisl. Pellentesque malesuada, est id sagittis consequat, libero mauris tincidunt tellus, eu sagittis arcu purus rutrum eros. Quisque eget eleifend mi. Duis pharetra mi ac eros mattis lacinia rutrum ipsum varius.</p>
+  <p>Fusce cursus pulvinar aliquam. Duis justo enim, ornare vitae elementum sed, porta a quam. Aliquam eu enim eu libero mollis tempus. Morbi ornare aliquam posuere. Proin faucibus luctus libero, sed ultrices lorem sagittis et. Vestibulum malesuada, ante nec molestie vehicula, quam diam mollis ipsum, rhoncus posuere mauris lectus in eros. Nullam feugiat ultrices augue, ac sodales sem mollis in.</p>
+  <p id="myBookmark3"><em>Voici le marque-page n°3</em></p>
+  <p>Proin vitae sem non lorem pellentesque molestie. Nam tempus massa et turpis placerat sit amet sollicitudin orci sodales. Pellentesque enim enim, sagittis a lobortis ut, tempus sed arcu. Aliquam augue turpis, varius vel bibendum ut, aliquam at diam. Nam lobortis, dui eu hendrerit pellentesque, sem neque porttitor erat, non dapibus velit lectus in metus. Vestibulum sit amet felis enim. In quis est vitae nunc malesuada consequat nec nec sapien. Suspendisse aliquam massa placerat dui lacinia luctus sed vitae risus. Fusce tempus, neque id ultrices volutpat, mi urna auctor arcu, viverra semper libero sem vel enim. Mauris dictum, elit non placerat malesuada, libero elit euismod nibh, nec posuere massa arcu eu risus. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer urna velit, dapibus eget varius feugiat, pellentesque sit amet ligula. Maecenas nulla nisl, facilisis eu egestas scelerisque, mollis eget metus. Vestibulum ante ipsum primis in faucibus orci luctus et ultrices posuere cubilia Curae; Morbi sed congue mi.</p>
+  <p>Fusce metus velit, pharetra at vestibulum nec, facilisis porttitor mi. Curabitur ligula sapien, fermentum vel porttitor id, rutrum sit amet magna. Sed sit amet sollicitudin turpis. Aenean luctus rhoncus dolor, et pulvinar ante egestas et. Donec ac massa orci, quis dapibus augue. Vivamus consectetur auctor pellentesque. Praesent vestibulum tincidunt ante sed consectetur. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Fusce purus metus, imperdiet vitae iaculis convallis, bibendum vitae turpis.</p>
+  <p>Fusce aliquet molestie dolor, in ornare dui sodales nec. In molestie sollicitudin felis a porta. Mauris nec orci sit amet orci blandit tristique congue nec nunc. Praesent et tellus sollicitudin mauris accumsan fringilla. Morbi sodales, justo eu sollicitudin lacinia, lectus sapien ullamcorper eros, quis molestie urna elit bibendum risus. Proin eget tincidunt quam. Nam luctus commodo mauris, eu posuere nunc luctus non. Nulla facilisi. Vivamus eget leo rhoncus quam accumsan fringilla. Aliquam sit amet lorem est. Nullam vel tellus nibh, id imperdiet orci. Integer egestas leo eu turpis blandit scelerisque.</p>
+  <p>Etiam in blandit tellus. Integer sed varius quam. Vestibulum dapibus mi gravida arcu viverra blandit. Praesent tristique augue id sem adipiscing pellentesque. Sed sollicitudin, leo sed interdum elementum, nisi ante condimentum leo, eget ornare libero diam semper quam. Vivamus augue urna, porta eget ultrices et, dapibus ut ligula. Ut laoreet consequat faucibus. Praesent at lectus ut lectus malesuada mollis. Nam interdum adipiscing eros, nec sodales mi porta nec. Proin et quam vitae sem interdum aliquet. Proin vel odio at lacus vehicula aliquet.</p>
+  <p>Etiam placerat dui ut sem ornare vel vestibulum augue mattis. Sed semper malesuada mi, eu bibendum lacus lobortis nec. Etiam fringilla elementum risus, eget consequat urna laoreet nec. Etiam mollis quam non sem convallis vel consectetur lectus ullamcorper. Aenean mattis lacus quis ligula mattis eget vestibulum diam hendrerit. In non placerat mauris. Praesent faucibus nunc quis eros sagittis viverra. In hac habitasse platea dictumst. Suspendisse eget nisl erat, ac molestie massa. Praesent mollis vestibulum tincidunt. Fusce suscipit laoreet malesuada. Aliquam erat volutpat. Aliquam dictum elementum rhoncus. Praesent in est massa, pulvinar sodales nunc. Pellentesque gravida euismod mi ac convallis.</p>
+  <p>Mauris vel odio vel nulla facilisis lacinia. Aliquam ultrices est at leo blandit tincidunt. Vestibulum ante ipsum primis in faucibus orci luctus et ultrices posuere cubilia Curae; Suspendisse porttitor adipiscing facilisis. Duis cursus quam iaculis augue interdum porttitor. Vestibulum ante ipsum primis in faucibus orci luctus et ultrices posuere cubilia Curae; Duis vulputate magna ac metus pretium condimentum. In tempus, est eget vestibulum blandit, velit massa dignissim nisl, ut scelerisque lorem neque vel velit. Maecenas fermentum commodo viverra. Curabitur a nibh non velit aliquam cursus. Integer semper condimentum tortor a pellentesque. Pellentesque semper, nisl id porttitor vehicula, sem dui feugiat lacus, vitae consequat augue urna vel odio.</p>
+  <p>Vestibulum id neque nec turpis iaculis pulvinar et a massa. Vestibulum sed nibh vitae arcu eleifend egestas. Mauris fermentum ultrices blandit. Suspendisse vitae lorem libero. Aenean et pellentesque tellus. Morbi quis neque orci, eu dignissim dui. Fusce sollicitudin mauris ac arcu vestibulum imperdiet. Proin ultricies nisl sit amet enim imperdiet eu ornare dui tempus. Maecenas lobortis nisi a tortor vestibulum vel eleifend tellus vestibulum. Donec metus sapien, hendrerit a fermentum id, dictum quis libero.</p>
+  <p>Pellentesque a lorem nulla, in tempor justo. Duis odio nisl, dignissim sed consequat sit amet, hendrerit ac neque. Nunc ac augue nec massa tempor rhoncus. Nam feugiat, tellus a varius euismod, justo nisl faucibus velit, ut vulputate justo massa eu nibh. Sed bibendum urna quis magna facilisis in accumsan dolor malesuada. Morbi sit amet nunc risus, in faucibus sem. Nullam sollicitudin magna sed sem mollis id commodo libero condimentum. Duis eu massa et lacus semper molestie ut adipiscing sem.</p>
+  <p>Sed id nulla mi, eget suscipit eros. Aliquam tempus molestie rutrum. In quis varius elit. Nullam dignissim neque nec velit vulputate porttitor. Mauris ac ligula sit amet elit fermentum rhoncus. In tellus urna, pulvinar quis condimentum ut, porta nec justo. In hac habitasse platea dictumst. Proin volutpat elit id quam molestie ac commodo lacus sagittis. Quisque placerat, augue tempor placerat pulvinar, nisi nisi venenatis urna, eget convallis eros velit quis magna. Suspendisse volutpat iaculis quam, ut tristique lacus luctus quis.</p>
+  <p>Nullam commodo suscipit lacus non aliquet. Phasellus ac nisl lorem, sed facilisis ligula. Nam cursus lobortis placerat. Sed dui nisi, elementum eu sodales ac, placerat sit amet mauris. Pellentesque dapibus tellus ut ipsum aliquam eu auctor dui vehicula. Quisque ultrices laoreet erat, at ultrices tortor sodales non. Sed venenatis luctus magna, ultricies ultricies nunc fringilla eget. Praesent scelerisque urna vitae nibh tristique varius consequat neque luctus. Integer ornare, erat a porta tempus, velit justo fermentum elit, a fermentum metus nisi eu ipsum. Vivamus eget augue vel dui viverra adipiscing congue ut massa. Praesent vitae eros erat, pulvinar laoreet magna. Maecenas vestibulum mollis nunc in posuere. Pellentesque sit amet metus a turpis lobortis tempor eu vel tortor. Cras sodales eleifend interdum.</p>
+</body>
+</html>
+
+ +

La même chose mais avec un défilement animé :

+ +
+var showBookmark = (function () {
+  var  _useHash, _scrollX, _scrollY, _nodeX, _nodeY, _itFrame, _scrollId = -1, _bookMark,
+   /*
+   * nDuration: la durée, exprimée en millisecondes, pour chaque frame
+   * nFrames: le nombre de frames pour chaque défilement
+   */
+   nDuration = 200, nFrames = 10;
+
+  function _next () {
+  if (_itFrame > nFrames) { clearInterval(_scrollId); _scrollId = -1; return; }
+  _isBot = true;
+  document.documentElement.scrollTop = Math.round(_scrollY + (_nodeY - _scrollY) * _itFrame / nFrames);
+  document.documentElement.scrollLeft = Math.round(_scrollX + (_nodeX - _scrollX) * _itFrame / nFrames);
+  if (_useHash && _itFrame === nFrames) { location.hash = _bookMark; }
+  _itFrame++;
+  }
+
+  function _chkOwner () {
+  if (_isBot) { _isBot = false; return; }
+  if (_scrollId > -1) { clearInterval(_scrollId); _scrollId = -1; }
+  }
+
+  if (window.addEventListener) { window.addEventListener("scroll", _chkOwner, false); }
+  else if (window.attachEvent) { window.attachEvent("onscroll", _chkOwner); }
+
+  return function (sBookmark, bUseHash) {
+    var oNode = document.querySelector(sBookmark);
+  _scrollY = document.documentElement.scrollTop;
+  _scrollX = document.documentElement.scrollLeft;
+  _bookMark = sBookmark;
+  _useHash = bUseHash === true;
+  _nodeX = oNode.offsetLeft;
+    _nodeY = oNode.offsetTop;
+    _itFrame = 1;
+  if (_scrollId === -1) { _scrollId = setInterval(_next, Math.round(nDuration / nFrames)); }
+  };
+})();
+
+ +

Spécifications

+ +

{{Specifications}}

+ +

Compatibilité des navigateurs

+ +

{{Compat}}

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/window/locationbar/index.html b/files/fr/web/api/window/locationbar/index.html deleted file mode 100644 index 294652fb88..0000000000 --- a/files/fr/web/api/window/locationbar/index.html +++ /dev/null @@ -1,72 +0,0 @@ ---- -title: Window.locationbar -slug: Web/API/Window/locationbar -tags: - - API - - HTML DOM - - Propriété - - Reference - - Window -translation_of: Web/API/Window/locationbar ---- -
{{APIRef}}
- -

Renvoie l'objet locationbar, dont la visibilité peut être vérifiée.

- -

Syntaxe

- -
objRef = window.locationbar
-
- -

Exemple

- -

L'exemple HTML complet suivant montre comment la propriété visible de l'objet locationbar est utilisée.

- -
<!DOCTYPE html>
-<html lang="fr">
-<head>
-<meta charset="UTF-8" />
-<title>Divers tests DOM</title>
-
-<script>
-var visible = window.locationbar.visible;
-</script>
-
-</head>
-<body>
-  <p>Divers tests DOM</p>
-</body>
-</html>
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaires
{{SpecName('HTML WHATWG', 'browsers.html#dom-window-locationbar', 'Window.locationbar')}}{{Spec2('HTML WHATWG')}}
{{SpecName('HTML5 W3C', 'browsers.html#dom-window-locationbar', 'Window.locationbar')}}{{Spec2('HTML5 W3C')}}
- -

Compatibilité des navigateurs

- -

{{Compat("api.Window.locationbar")}}

- -

Voir également

- - diff --git a/files/fr/web/api/window/locationbar/index.md b/files/fr/web/api/window/locationbar/index.md new file mode 100644 index 0000000000..294652fb88 --- /dev/null +++ b/files/fr/web/api/window/locationbar/index.md @@ -0,0 +1,72 @@ +--- +title: Window.locationbar +slug: Web/API/Window/locationbar +tags: + - API + - HTML DOM + - Propriété + - Reference + - Window +translation_of: Web/API/Window/locationbar +--- +
{{APIRef}}
+ +

Renvoie l'objet locationbar, dont la visibilité peut être vérifiée.

+ +

Syntaxe

+ +
objRef = window.locationbar
+
+ +

Exemple

+ +

L'exemple HTML complet suivant montre comment la propriété visible de l'objet locationbar est utilisée.

+ +
<!DOCTYPE html>
+<html lang="fr">
+<head>
+<meta charset="UTF-8" />
+<title>Divers tests DOM</title>
+
+<script>
+var visible = window.locationbar.visible;
+</script>
+
+</head>
+<body>
+  <p>Divers tests DOM</p>
+</body>
+</html>
+
+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaires
{{SpecName('HTML WHATWG', 'browsers.html#dom-window-locationbar', 'Window.locationbar')}}{{Spec2('HTML WHATWG')}}
{{SpecName('HTML5 W3C', 'browsers.html#dom-window-locationbar', 'Window.locationbar')}}{{Spec2('HTML5 W3C')}}
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Window.locationbar")}}

+ +

Voir également

+ + diff --git a/files/fr/web/api/window/matchmedia/index.html b/files/fr/web/api/window/matchmedia/index.html deleted file mode 100644 index 77fea4b292..0000000000 --- a/files/fr/web/api/window/matchmedia/index.html +++ /dev/null @@ -1,51 +0,0 @@ ---- -title: window.matchMedia -slug: Web/API/Window/matchMedia -translation_of: Web/API/Window/matchMedia ---- -
{{ApiRef}}
- -

Retourne un nouvel objet {{domxref("MediaQueryList")}} contenant les résultats de la chaîne de caractères media query spécifiée.

-

Syntaxe

-
mql = window.matchMedia(mediaQueryString)
-

Ici, mediaQueryString est une chaîne de caractère représentant la media query pour laquelle on retourne un nouvel objet {{domxref("MediaQueryList")}}.

-

Exemple

-
if (window.matchMedia("(min-width: 400px)").matches) {
-  /* the view port is at least 400 pixels wide */
-} else {
-  /* the view port is less than 400 pixels wide */
-}
-

Ce code permet de gérer la mise en page d'une manière différente quand l'écran est moins large.

-

Voir Utiliser les media queries avec du code pour plus d'exemples.

- -

Spécifications

- - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName("CSSOM View", "#dom-window-matchmedia", "Window.matchMedia()")}}{{Spec2("CSSOM View")}}Définition initiale.
- -

Compatibilité des navigateurs

- -

{{Compat("api.Window.matchMedia")}}

- -

Voir aussi

- - diff --git a/files/fr/web/api/window/matchmedia/index.md b/files/fr/web/api/window/matchmedia/index.md new file mode 100644 index 0000000000..77fea4b292 --- /dev/null +++ b/files/fr/web/api/window/matchmedia/index.md @@ -0,0 +1,51 @@ +--- +title: window.matchMedia +slug: Web/API/Window/matchMedia +translation_of: Web/API/Window/matchMedia +--- +
{{ApiRef}}
+ +

Retourne un nouvel objet {{domxref("MediaQueryList")}} contenant les résultats de la chaîne de caractères media query spécifiée.

+

Syntaxe

+
mql = window.matchMedia(mediaQueryString)
+

Ici, mediaQueryString est une chaîne de caractère représentant la media query pour laquelle on retourne un nouvel objet {{domxref("MediaQueryList")}}.

+

Exemple

+
if (window.matchMedia("(min-width: 400px)").matches) {
+  /* the view port is at least 400 pixels wide */
+} else {
+  /* the view port is less than 400 pixels wide */
+}
+

Ce code permet de gérer la mise en page d'une manière différente quand l'écran est moins large.

+

Voir Utiliser les media queries avec du code pour plus d'exemples.

+ +

Spécifications

+ + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName("CSSOM View", "#dom-window-matchmedia", "Window.matchMedia()")}}{{Spec2("CSSOM View")}}Définition initiale.
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Window.matchMedia")}}

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/window/menubar/index.html b/files/fr/web/api/window/menubar/index.html deleted file mode 100644 index 6e5fc9371d..0000000000 --- a/files/fr/web/api/window/menubar/index.html +++ /dev/null @@ -1,72 +0,0 @@ ---- -title: Window.menubar -slug: Web/API/Window/menubar -tags: - - API - - HTML DOM - - Propriété - - Reference - - Window -translation_of: Web/API/Window/menubar ---- -
{{ APIRef() }}
- -

La propriété Window.menubar renvoie l'objet menubar, dont la visibilité peut être vérifiée.

- -

Syntaxe

- -
objRef = window.menubar
-
- -

Exemple

- -

L'exemple HTML complet suivant montre comment la propriété visible de l'objet menubar est utilisée.

- -
<html>
-<head>
-  <title>Divers Tests DOM</title>
-  <script>
-    var visible = window.menubar.visible;
-  </script>
-</head>
-<body>
-  <p>Divers Tests DOM</p>
-</body>
-</html>
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('HTML WHATWG', 'browsers.html#dom-window-menubar', 'Window.menubar')}}{{Spec2('HTML WHATWG')}}
{{SpecName('HTML5 W3C', 'browsers.html#dom-window-menubar', 'Window.menubar')}}{{Spec2('HTML5 W3C')}}
- -

Compatibilité des navigateurs

- -

{{Compat("api.Window.menubar")}}

- -

Voir également

- - diff --git a/files/fr/web/api/window/menubar/index.md b/files/fr/web/api/window/menubar/index.md new file mode 100644 index 0000000000..6e5fc9371d --- /dev/null +++ b/files/fr/web/api/window/menubar/index.md @@ -0,0 +1,72 @@ +--- +title: Window.menubar +slug: Web/API/Window/menubar +tags: + - API + - HTML DOM + - Propriété + - Reference + - Window +translation_of: Web/API/Window/menubar +--- +
{{ APIRef() }}
+ +

La propriété Window.menubar renvoie l'objet menubar, dont la visibilité peut être vérifiée.

+ +

Syntaxe

+ +
objRef = window.menubar
+
+ +

Exemple

+ +

L'exemple HTML complet suivant montre comment la propriété visible de l'objet menubar est utilisée.

+ +
<html>
+<head>
+  <title>Divers Tests DOM</title>
+  <script>
+    var visible = window.menubar.visible;
+  </script>
+</head>
+<body>
+  <p>Divers Tests DOM</p>
+</body>
+</html>
+
+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('HTML WHATWG', 'browsers.html#dom-window-menubar', 'Window.menubar')}}{{Spec2('HTML WHATWG')}}
{{SpecName('HTML5 W3C', 'browsers.html#dom-window-menubar', 'Window.menubar')}}{{Spec2('HTML5 W3C')}}
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Window.menubar")}}

+ +

Voir également

+ + diff --git a/files/fr/web/api/window/message_event/index.html b/files/fr/web/api/window/message_event/index.html deleted file mode 100644 index 7122fbb2d9..0000000000 --- a/files/fr/web/api/window/message_event/index.html +++ /dev/null @@ -1,82 +0,0 @@ ---- -title: 'Window: message event' -slug: Web/API/Window/message_event -tags: - - Evènement - - Window -translation_of: Web/API/Window/message_event ---- -
{{APIRef}}
- -

L'événement message est déclenché sur un objet {{domxref('Window')}} lorsque la fenêtre reçoit un message, par exemple d'un appel a Window.postMessage() depuis un autre contexte de navigation.

- - - - - - - - - - - - - - - - - - - - -
BullesNon
AnnulableNon
Interface{{domxref("MessageEvent")}}
Propriété de gestionnaire d'événementsonmessage
- -

Exemples

- -

Supposons qu'un script envoie un message à un contexte de navigation différent, tel qu'un autre <iframe>, en utilisant un code comme celui-ci:

- -
const targetFrame = window.top.frames[1];
-const targetOrigin = 'https://exemple.org';
-const windowMessageButton = document.querySelector('#window-message');
-
-windowMessageButton.addEventListener('click', () => {
-    targetFrame.postMessage('bonjour', targetOrigin);
-});
- -

Le récepteur peut écouter le message en utilisant addEventListener() avec un code comme celui-ci:

- -
window.addEventListener('message', (event) => {
-    console.log(`Message reçu: ${event.data}`);
-});
- -

Alternativement l'écouteur peut utiliser la propriété du gestionnaire d'événements onmessage:

- -
window.onmessage = (event) => {
-    console.log(`Message reçu: ${event.data}`);
-};
- -

Spécifications

- - - - - - - - - - - - -
SpécificationStatut
{{SpecName('HTML WHATWG', 'indices.html#event-message')}}{{Spec2('HTML WHATWG')}}
- -

Compatibilité des navigateurs

- -

{{Compat("api.Window.message_event")}}

- -

Voir également

- - diff --git a/files/fr/web/api/window/message_event/index.md b/files/fr/web/api/window/message_event/index.md new file mode 100644 index 0000000000..7122fbb2d9 --- /dev/null +++ b/files/fr/web/api/window/message_event/index.md @@ -0,0 +1,82 @@ +--- +title: 'Window: message event' +slug: Web/API/Window/message_event +tags: + - Evènement + - Window +translation_of: Web/API/Window/message_event +--- +
{{APIRef}}
+ +

L'événement message est déclenché sur un objet {{domxref('Window')}} lorsque la fenêtre reçoit un message, par exemple d'un appel a Window.postMessage() depuis un autre contexte de navigation.

+ + + + + + + + + + + + + + + + + + + + +
BullesNon
AnnulableNon
Interface{{domxref("MessageEvent")}}
Propriété de gestionnaire d'événementsonmessage
+ +

Exemples

+ +

Supposons qu'un script envoie un message à un contexte de navigation différent, tel qu'un autre <iframe>, en utilisant un code comme celui-ci:

+ +
const targetFrame = window.top.frames[1];
+const targetOrigin = 'https://exemple.org';
+const windowMessageButton = document.querySelector('#window-message');
+
+windowMessageButton.addEventListener('click', () => {
+    targetFrame.postMessage('bonjour', targetOrigin);
+});
+ +

Le récepteur peut écouter le message en utilisant addEventListener() avec un code comme celui-ci:

+ +
window.addEventListener('message', (event) => {
+    console.log(`Message reçu: ${event.data}`);
+});
+ +

Alternativement l'écouteur peut utiliser la propriété du gestionnaire d'événements onmessage:

+ +
window.onmessage = (event) => {
+    console.log(`Message reçu: ${event.data}`);
+};
+ +

Spécifications

+ + + + + + + + + + + + +
SpécificationStatut
{{SpecName('HTML WHATWG', 'indices.html#event-message')}}{{Spec2('HTML WHATWG')}}
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Window.message_event")}}

+ +

Voir également

+ + diff --git a/files/fr/web/api/window/messageerror_event/index.html b/files/fr/web/api/window/messageerror_event/index.html deleted file mode 100644 index 0f63b05e44..0000000000 --- a/files/fr/web/api/window/messageerror_event/index.html +++ /dev/null @@ -1,77 +0,0 @@ ---- -title: 'Window: messageerror event' -slug: Web/API/Window/messageerror_event -tags: - - API - - Evènement - - Message d'événement - - Reference - - Window -translation_of: Web/API/Window/messageerror_event ---- -
{{APIRef}}
- -

L'événement messageerror est déclenché sur un objet {{domxref('Window')}} lorsqu'il reçoit un message qui ne peut pas être désérialisé.

- - - - - - - - - - - - - - - - - - - - -
BullesNon
AnnulableNon
Interface{{domxref("MessageEvent")}}
Propriété de gestionnaire d'événements{{domxref("WindowEventHandlers/onmessageerror", "onmessageerror")}}
- -

Exemples

- -

Écoutez messageerror en utilisant {{domxref("EventTarget/addEventListener", "addEventListener()")}} :

- -
window.addEventListener('messageerror', (event) => {
-    console.error(event);
-});
- -

Idem, mais en utilisant la propriété de gestionnaire d'événements {{domxref("WindowEventHandlers/onmessageerror", "onmessageerror")}} :

- -
window.onmessageerror = (event) => {
-    console.error(event);
-};
- -

Spécifications

- - - - - - - - - - - - - - -
SpécificationStatut
{{SpecName('HTML WHATWG', 'indices.html#event-messageerror')}}{{Spec2('HTML WHATWG')}}
- -

Compatibilité des navigateurs

- -

{{Compat("api.Window.messageerror_event")}}

- -

Voir également

- - diff --git a/files/fr/web/api/window/messageerror_event/index.md b/files/fr/web/api/window/messageerror_event/index.md new file mode 100644 index 0000000000..0f63b05e44 --- /dev/null +++ b/files/fr/web/api/window/messageerror_event/index.md @@ -0,0 +1,77 @@ +--- +title: 'Window: messageerror event' +slug: Web/API/Window/messageerror_event +tags: + - API + - Evènement + - Message d'événement + - Reference + - Window +translation_of: Web/API/Window/messageerror_event +--- +
{{APIRef}}
+ +

L'événement messageerror est déclenché sur un objet {{domxref('Window')}} lorsqu'il reçoit un message qui ne peut pas être désérialisé.

+ + + + + + + + + + + + + + + + + + + + +
BullesNon
AnnulableNon
Interface{{domxref("MessageEvent")}}
Propriété de gestionnaire d'événements{{domxref("WindowEventHandlers/onmessageerror", "onmessageerror")}}
+ +

Exemples

+ +

Écoutez messageerror en utilisant {{domxref("EventTarget/addEventListener", "addEventListener()")}} :

+ +
window.addEventListener('messageerror', (event) => {
+    console.error(event);
+});
+ +

Idem, mais en utilisant la propriété de gestionnaire d'événements {{domxref("WindowEventHandlers/onmessageerror", "onmessageerror")}} :

+ +
window.onmessageerror = (event) => {
+    console.error(event);
+};
+ +

Spécifications

+ + + + + + + + + + + + + + +
SpécificationStatut
{{SpecName('HTML WHATWG', 'indices.html#event-messageerror')}}{{Spec2('HTML WHATWG')}}
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Window.messageerror_event")}}

+ +

Voir également

+ + diff --git a/files/fr/web/api/window/mozinnerscreenx/index.html b/files/fr/web/api/window/mozinnerscreenx/index.html deleted file mode 100644 index 3cce6881b6..0000000000 --- a/files/fr/web/api/window/mozinnerscreenx/index.html +++ /dev/null @@ -1,47 +0,0 @@ ---- -title: Window.mozInnerScreenX -slug: Web/API/Window/mozInnerScreenX -tags: - - API - - HTML DOM - - NeedsSpecTable - - Propriété - - Reference - - Window -translation_of: Web/API/Window/mozInnerScreenX ---- -
{{APIRef}}{{gecko_minversion_header("1.9.2")}}
- -

Résumé

- -

Obtient la coordonnée X du coin supérieur gauche de la fenêtre de la fenêtre, en coordonnées d'écran.

- -
-

Note : Cette coordonnée est indiquée en pixels CSS et non en pixels matériels. Cela signifie qu'il peut être affecté par le niveau de zoom; pour calculer le nombre réel de pixels d'écran physiques, vous devez utiliser la propriété nsIDOMWindowUtils.screenPixelsPerCSSPixel.

-
- -

Syntaxe

- -
screenX = window.mozInnerScreenX;
- -

Valeur

- - - -

Spécification

- -

Ne fait partie d'aucune spécification ou recommandation technique du W3C.

- -

Compatibilité des navigateurs

- -

{{Compat("api.Window.mozInnerScreenX")}}

- -

Voir également

- - diff --git a/files/fr/web/api/window/mozinnerscreenx/index.md b/files/fr/web/api/window/mozinnerscreenx/index.md new file mode 100644 index 0000000000..3cce6881b6 --- /dev/null +++ b/files/fr/web/api/window/mozinnerscreenx/index.md @@ -0,0 +1,47 @@ +--- +title: Window.mozInnerScreenX +slug: Web/API/Window/mozInnerScreenX +tags: + - API + - HTML DOM + - NeedsSpecTable + - Propriété + - Reference + - Window +translation_of: Web/API/Window/mozInnerScreenX +--- +
{{APIRef}}{{gecko_minversion_header("1.9.2")}}
+ +

Résumé

+ +

Obtient la coordonnée X du coin supérieur gauche de la fenêtre de la fenêtre, en coordonnées d'écran.

+ +
+

Note : Cette coordonnée est indiquée en pixels CSS et non en pixels matériels. Cela signifie qu'il peut être affecté par le niveau de zoom; pour calculer le nombre réel de pixels d'écran physiques, vous devez utiliser la propriété nsIDOMWindowUtils.screenPixelsPerCSSPixel.

+
+ +

Syntaxe

+ +
screenX = window.mozInnerScreenX;
+ +

Valeur

+ + + +

Spécification

+ +

Ne fait partie d'aucune spécification ou recommandation technique du W3C.

+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Window.mozInnerScreenX")}}

+ +

Voir également

+ + diff --git a/files/fr/web/api/window/mozinnerscreeny/index.html b/files/fr/web/api/window/mozinnerscreeny/index.html deleted file mode 100644 index 2b9ebd8564..0000000000 --- a/files/fr/web/api/window/mozinnerscreeny/index.html +++ /dev/null @@ -1,47 +0,0 @@ ---- -title: Window.mozInnerScreenY -slug: Web/API/Window/mozInnerScreenY -tags: - - API - - HTML DOM - - NeedsExample - - Propriété - - Reference - - Window -translation_of: Web/API/Window/mozInnerScreenY ---- -
{{APIRef}}{{gecko_minversion_header("1.9.2")}}
- -

Résumé

- -

Obtient la coordonnée Y du coin supérieur gauche de la fenêtre de la fenêtre, en coordonnées d'écran.

- -
-

Note : Cette coordonnée est indiquée en pixels CSS et non en pixels matériels. Cela signifie qu'il peut être affecté par le niveau de zoom; pour calculer le nombre réel de pixels d'écran physiques, vous devez utiliser la propriété nsIDOMWindowUtils.screenPixelsPerCSSPixel.

-
- -

Syntaxe

- -
screenY = window.mozInnerScreenY;
- -

Valeur

- - - -

Spécification

- -

Ne fait partie d'aucune spécification ou recommandation technique du W3C.

- -

Compatibilité des navigateurs

- -

{{Compat("api.Window.mozInnerScreenY")}}

- -

Voir également

- - diff --git a/files/fr/web/api/window/mozinnerscreeny/index.md b/files/fr/web/api/window/mozinnerscreeny/index.md new file mode 100644 index 0000000000..2b9ebd8564 --- /dev/null +++ b/files/fr/web/api/window/mozinnerscreeny/index.md @@ -0,0 +1,47 @@ +--- +title: Window.mozInnerScreenY +slug: Web/API/Window/mozInnerScreenY +tags: + - API + - HTML DOM + - NeedsExample + - Propriété + - Reference + - Window +translation_of: Web/API/Window/mozInnerScreenY +--- +
{{APIRef}}{{gecko_minversion_header("1.9.2")}}
+ +

Résumé

+ +

Obtient la coordonnée Y du coin supérieur gauche de la fenêtre de la fenêtre, en coordonnées d'écran.

+ +
+

Note : Cette coordonnée est indiquée en pixels CSS et non en pixels matériels. Cela signifie qu'il peut être affecté par le niveau de zoom; pour calculer le nombre réel de pixels d'écran physiques, vous devez utiliser la propriété nsIDOMWindowUtils.screenPixelsPerCSSPixel.

+
+ +

Syntaxe

+ +
screenY = window.mozInnerScreenY;
+ +

Valeur

+ + + +

Spécification

+ +

Ne fait partie d'aucune spécification ou recommandation technique du W3C.

+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Window.mozInnerScreenY")}}

+ +

Voir également

+ + diff --git a/files/fr/web/api/window/mozpaintcount/index.html b/files/fr/web/api/window/mozpaintcount/index.html deleted file mode 100644 index a6f3d9eb7c..0000000000 --- a/files/fr/web/api/window/mozpaintcount/index.html +++ /dev/null @@ -1,35 +0,0 @@ ---- -title: Window.mozPaintCount -slug: Web/API/Window/mozPaintCount -tags: - - API - - 'API:Mozilla Extensions' - - Déprécié - - HTML DOM - - NeedsExample - - Non-standard - - Propriété - - Reference - - Window -translation_of: Web/API/Window/mozPaintCount ---- -

{{APIRef("Mozilla Extensions")}}{{Non-standard_Header}}{{Obsolete_Header("Gecko72")}}{{Gecko_MinVersion_Header("2.0")}}

- -

Renvoie le nombre de fois où le document actuel a été peint à l'écran dans cette fenêtre.

- -

Syntaxe

- -
var paintCount = window.mozPaintCount;
- - - -

Spécification

- -

Ne fait partie d'aucune spécification ou recommandation du W3C.

- -

Compatibilité des navigateurs

- -

{{Compat("api.Window.mozPaintCount")}}

diff --git a/files/fr/web/api/window/mozpaintcount/index.md b/files/fr/web/api/window/mozpaintcount/index.md new file mode 100644 index 0000000000..a6f3d9eb7c --- /dev/null +++ b/files/fr/web/api/window/mozpaintcount/index.md @@ -0,0 +1,35 @@ +--- +title: Window.mozPaintCount +slug: Web/API/Window/mozPaintCount +tags: + - API + - 'API:Mozilla Extensions' + - Déprécié + - HTML DOM + - NeedsExample + - Non-standard + - Propriété + - Reference + - Window +translation_of: Web/API/Window/mozPaintCount +--- +

{{APIRef("Mozilla Extensions")}}{{Non-standard_Header}}{{Obsolete_Header("Gecko72")}}{{Gecko_MinVersion_Header("2.0")}}

+ +

Renvoie le nombre de fois où le document actuel a été peint à l'écran dans cette fenêtre.

+ +

Syntaxe

+ +
var paintCount = window.mozPaintCount;
+ + + +

Spécification

+ +

Ne fait partie d'aucune spécification ou recommandation du W3C.

+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Window.mozPaintCount")}}

diff --git a/files/fr/web/api/window/name/index.html b/files/fr/web/api/window/name/index.html deleted file mode 100644 index ef7efa9448..0000000000 --- a/files/fr/web/api/window/name/index.html +++ /dev/null @@ -1,54 +0,0 @@ ---- -title: Window.name -slug: Web/API/Window/name -tags: - - API - - HTML DOM - - Propriété - - Reference -translation_of: Web/API/Window/name ---- -
{{APIRef}}
- -

En bref

- -

Récupère ou définit le nom de la fenêtre.

- -

Syntaxe

- -
string = window.name;
-window.name = string;
-
- -

Exemple

- -
window.name = "lab_view";
-
- -

Notes

- -

Les noms de fenêtres sont principalement utilisés pour définir les cibles de liens hypertextes et de formulaires. Les fenêtres n'ont pas besoin d'être nommées.

- -

Les noms de fenêtres ont en outre été utilisés par quelques frameworks pour le support des échanges de messages inter-domaines (par exemple SessionVars et dojox.io.windowName de Dojo) comme une alternative plus sécurisée à JSONP. Toutefois, les applications web modernes manipulant des données sensibles devraient utiliser l'API postMessage pour les échanges de messages inter-domaines plutôt que s'appuyer sur window.name.

- -

Spécifications

- - - - - - - - - - - - - - - - - - - -
SpecificationStatusComment
{{SpecName('HTML WHATWG', 'browsers.html#dom-name', 'Window.name')}}{{Spec2('HTML WHATWG')}} 
{{SpecName('HTML5 W3C', 'browsers.html#dom-name', 'Window.name')}}{{Spec2('HTML5 W3C')}} 
diff --git a/files/fr/web/api/window/name/index.md b/files/fr/web/api/window/name/index.md new file mode 100644 index 0000000000..ef7efa9448 --- /dev/null +++ b/files/fr/web/api/window/name/index.md @@ -0,0 +1,54 @@ +--- +title: Window.name +slug: Web/API/Window/name +tags: + - API + - HTML DOM + - Propriété + - Reference +translation_of: Web/API/Window/name +--- +
{{APIRef}}
+ +

En bref

+ +

Récupère ou définit le nom de la fenêtre.

+ +

Syntaxe

+ +
string = window.name;
+window.name = string;
+
+ +

Exemple

+ +
window.name = "lab_view";
+
+ +

Notes

+ +

Les noms de fenêtres sont principalement utilisés pour définir les cibles de liens hypertextes et de formulaires. Les fenêtres n'ont pas besoin d'être nommées.

+ +

Les noms de fenêtres ont en outre été utilisés par quelques frameworks pour le support des échanges de messages inter-domaines (par exemple SessionVars et dojox.io.windowName de Dojo) comme une alternative plus sécurisée à JSONP. Toutefois, les applications web modernes manipulant des données sensibles devraient utiliser l'API postMessage pour les échanges de messages inter-domaines plutôt que s'appuyer sur window.name.

+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('HTML WHATWG', 'browsers.html#dom-name', 'Window.name')}}{{Spec2('HTML WHATWG')}} 
{{SpecName('HTML5 W3C', 'browsers.html#dom-name', 'Window.name')}}{{Spec2('HTML5 W3C')}} 
diff --git a/files/fr/web/api/window/navigator/index.html b/files/fr/web/api/window/navigator/index.html deleted file mode 100644 index 2f763caa88..0000000000 --- a/files/fr/web/api/window/navigator/index.html +++ /dev/null @@ -1,48 +0,0 @@ ---- -title: Window.navigator -slug: Web/API/Window/navigator -tags: - - API - - HTML DOM - - Property - - Read-only - - Reference - - Window -translation_of: Web/API/Window/navigator ---- -
{{APIRef}}
- -

La propriété en lecture-seule Window.navigator renvoie une référence à un objet qui est une instance de {{domxref("Navigator")}} et possède des méthodes et propriétés à propos de l'application qui exécute le script.

- -

Syntaxe

- -
navigatorObject = window.navigator
- -

Exemple

- -
var sUsrAg = navigator.userAgent;
-console.log("Voici l'agent utilisateur du navigateur courant", sUsrAg);
-
- -

Spécifications

- - - - - - - - - - - - - - - - -
SpécificationStatutCommentaires
{{SpecName('HTML WHATWG', '#dom-navigator', 'Window: navigator')}}{{Spec2('HTML WHATWG')}}
- -

Compatibilité des navigateurs

- -

{{Compat("api.Window.navigator")}}

diff --git a/files/fr/web/api/window/navigator/index.md b/files/fr/web/api/window/navigator/index.md new file mode 100644 index 0000000000..2f763caa88 --- /dev/null +++ b/files/fr/web/api/window/navigator/index.md @@ -0,0 +1,48 @@ +--- +title: Window.navigator +slug: Web/API/Window/navigator +tags: + - API + - HTML DOM + - Property + - Read-only + - Reference + - Window +translation_of: Web/API/Window/navigator +--- +
{{APIRef}}
+ +

La propriété en lecture-seule Window.navigator renvoie une référence à un objet qui est une instance de {{domxref("Navigator")}} et possède des méthodes et propriétés à propos de l'application qui exécute le script.

+ +

Syntaxe

+ +
navigatorObject = window.navigator
+ +

Exemple

+ +
var sUsrAg = navigator.userAgent;
+console.log("Voici l'agent utilisateur du navigateur courant", sUsrAg);
+
+ +

Spécifications

+ + + + + + + + + + + + + + + + +
SpécificationStatutCommentaires
{{SpecName('HTML WHATWG', '#dom-navigator', 'Window: navigator')}}{{Spec2('HTML WHATWG')}}
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Window.navigator")}}

diff --git a/files/fr/web/api/window/offline_event/index.html b/files/fr/web/api/window/offline_event/index.html deleted file mode 100644 index fa7752a90c..0000000000 --- a/files/fr/web/api/window/offline_event/index.html +++ /dev/null @@ -1,73 +0,0 @@ ---- -title: 'Window: Evenement offline' -slug: Web/API/Window/offline_event -tags: - - API - - Event - - Offline - - Reference - - Window -translation_of: Web/API/Window/offline_event ---- -

{{APIRef}}

- -

L'événement offline de l'interface {{domxref("Window")}} se déclenche lorsque le navigateur perd la connexion au réseau et la valeur de  {{domxref("Navigator.onLine")}} bascule à false.

- - - - - - - - - - - - - - - - - - - - -
BullesNon
AnnulableNon
Interface{{domxref("Event")}}
Propriété de gestionnaire d'événements{{domxref("GlobalEventHandlers.onoffline", "onoffline")}}
- -

Exemples

- -
//version addEventListener
-window.addEventListener('offline', (event) => {
-    console.log("La Connexion au réseau est perdu.");
-});
-
-// onoffline version
-window.onoffline = (event) => {
-  console.log("La Connexion au réseau a été perdue.");
-};
-
- -

Spécifications

- - - - - - - - - - - - -
SpécificationStatut
{{SpecName('HTML WHATWG', "indices.html#event-offline", "offline event")}}{{Spec2('HTML WHATWG')}}
- -

Compatibilité des Navigateurs

- -

{{Compat("api.Window.offline_event")}}

- -

Voir également

- - diff --git a/files/fr/web/api/window/offline_event/index.md b/files/fr/web/api/window/offline_event/index.md new file mode 100644 index 0000000000..fa7752a90c --- /dev/null +++ b/files/fr/web/api/window/offline_event/index.md @@ -0,0 +1,73 @@ +--- +title: 'Window: Evenement offline' +slug: Web/API/Window/offline_event +tags: + - API + - Event + - Offline + - Reference + - Window +translation_of: Web/API/Window/offline_event +--- +

{{APIRef}}

+ +

L'événement offline de l'interface {{domxref("Window")}} se déclenche lorsque le navigateur perd la connexion au réseau et la valeur de  {{domxref("Navigator.onLine")}} bascule à false.

+ + + + + + + + + + + + + + + + + + + + +
BullesNon
AnnulableNon
Interface{{domxref("Event")}}
Propriété de gestionnaire d'événements{{domxref("GlobalEventHandlers.onoffline", "onoffline")}}
+ +

Exemples

+ +
//version addEventListener
+window.addEventListener('offline', (event) => {
+    console.log("La Connexion au réseau est perdu.");
+});
+
+// onoffline version
+window.onoffline = (event) => {
+  console.log("La Connexion au réseau a été perdue.");
+};
+
+ +

Spécifications

+ + + + + + + + + + + + +
SpécificationStatut
{{SpecName('HTML WHATWG', "indices.html#event-offline", "offline event")}}{{Spec2('HTML WHATWG')}}
+ +

Compatibilité des Navigateurs

+ +

{{Compat("api.Window.offline_event")}}

+ +

Voir également

+ + diff --git a/files/fr/web/api/window/online_event/index.html b/files/fr/web/api/window/online_event/index.html deleted file mode 100644 index c2c93916c8..0000000000 --- a/files/fr/web/api/window/online_event/index.html +++ /dev/null @@ -1,77 +0,0 @@ ---- -title: 'Window: online event' -slug: Web/API/Window/online_event -tags: - - API - - Evènement - - Online - - Reference - - Window -translation_of: Web/API/Window/online_event ---- -
{{APIRef}}
- -

L'événement online de l'interface {{domxref("Window")}} est déclenché lorsque le navigateur a obtenu l'accès au réseau et que la valeur de {{domxref("Navigator.onLine")}} passe à true.

- -
-

Note : Cet événement ne doit pas être utilisé pour déterminer la disponibilité d'un site Web particulier. Des problèmes de réseau ou des pare-feu peuvent encore empêcher l'accès au site Web.

-
- - - - - - - - - - - - - - - - - - - - -
BullesNo
AnnulableNo
Interface{{domxref("Event")}}
Propriété de gestionnaire d'événements{{domxref("GlobalEventHandlers.ononline", "ononline")}}
- -

Exemples

- -
// addEventListener version
-window.addEventListener('online', (event) => {
-    console.log("Vous êtes maintenant connecté au réseau.");
-});
-
-// ononline version
-window.ononline = (event) => {
-  console.log("Vous êtes maintenant connecté au réseau.");
-};
-
- -

Spécifications

- - - - - - - - - - - - -
SpécificationStatut
{{SpecName('HTML WHATWG', "indices.html#event-online", "online event")}}{{Spec2('HTML WHATWG')}}
- -

Compatibilité des navigateurs

- -

{{Compat("api.Window.online_event")}}

- -

Voir également

- - diff --git a/files/fr/web/api/window/online_event/index.md b/files/fr/web/api/window/online_event/index.md new file mode 100644 index 0000000000..c2c93916c8 --- /dev/null +++ b/files/fr/web/api/window/online_event/index.md @@ -0,0 +1,77 @@ +--- +title: 'Window: online event' +slug: Web/API/Window/online_event +tags: + - API + - Evènement + - Online + - Reference + - Window +translation_of: Web/API/Window/online_event +--- +
{{APIRef}}
+ +

L'événement online de l'interface {{domxref("Window")}} est déclenché lorsque le navigateur a obtenu l'accès au réseau et que la valeur de {{domxref("Navigator.onLine")}} passe à true.

+ +
+

Note : Cet événement ne doit pas être utilisé pour déterminer la disponibilité d'un site Web particulier. Des problèmes de réseau ou des pare-feu peuvent encore empêcher l'accès au site Web.

+
+ + + + + + + + + + + + + + + + + + + + +
BullesNo
AnnulableNo
Interface{{domxref("Event")}}
Propriété de gestionnaire d'événements{{domxref("GlobalEventHandlers.ononline", "ononline")}}
+ +

Exemples

+ +
// addEventListener version
+window.addEventListener('online', (event) => {
+    console.log("Vous êtes maintenant connecté au réseau.");
+});
+
+// ononline version
+window.ononline = (event) => {
+  console.log("Vous êtes maintenant connecté au réseau.");
+};
+
+ +

Spécifications

+ + + + + + + + + + + + +
SpécificationStatut
{{SpecName('HTML WHATWG', "indices.html#event-online", "online event")}}{{Spec2('HTML WHATWG')}}
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Window.online_event")}}

+ +

Voir également

+ + diff --git a/files/fr/web/api/window/onpaint/index.html b/files/fr/web/api/window/onpaint/index.html deleted file mode 100644 index d7ae9b979d..0000000000 --- a/files/fr/web/api/window/onpaint/index.html +++ /dev/null @@ -1,37 +0,0 @@ ---- -title: Window.onpaint -slug: Web/API/Window/onpaint -tags: - - API - - Event Handler - - HTML DOM - - Non-standard - - Propriété -translation_of: Web/API/Window/onpaint ---- -
{{ ApiRef() }} {{Non-standard_header}}
- -

Window.onpaint est un gestionnaire d'événements pour l'événement paint sur la fenêtre.

- -
-

Attention : Ne fonctionne pas dans les applications basées sur Gecko actuellement, voir la section Notes!

-
- -

Syntaxe

- -
window.onpaint = funcRef;
-
- - - -

Notes

- -

onpaint ne fonctionne pas actuellement, et il est douteux que cet événement fonctionne du tout, voir {{ Bug(239074) }}.

- -

L'événement paint est déclenché lorsque la fenêtre est rendue. Cet événement se produit après l'événement {{Event ("load")}} pour une fenêtre, et se reproduit chaque fois que la fenêtre doit être restituée, par exemple lorsqu'une autre fenêtre l'obscurcit et est ensuite effacée.

- -

Spécification

- -

Cela ne fait partie d'aucune spécification.

diff --git a/files/fr/web/api/window/onpaint/index.md b/files/fr/web/api/window/onpaint/index.md new file mode 100644 index 0000000000..d7ae9b979d --- /dev/null +++ b/files/fr/web/api/window/onpaint/index.md @@ -0,0 +1,37 @@ +--- +title: Window.onpaint +slug: Web/API/Window/onpaint +tags: + - API + - Event Handler + - HTML DOM + - Non-standard + - Propriété +translation_of: Web/API/Window/onpaint +--- +
{{ ApiRef() }} {{Non-standard_header}}
+ +

Window.onpaint est un gestionnaire d'événements pour l'événement paint sur la fenêtre.

+ +
+

Attention : Ne fonctionne pas dans les applications basées sur Gecko actuellement, voir la section Notes!

+
+ +

Syntaxe

+ +
window.onpaint = funcRef;
+
+ + + +

Notes

+ +

onpaint ne fonctionne pas actuellement, et il est douteux que cet événement fonctionne du tout, voir {{ Bug(239074) }}.

+ +

L'événement paint est déclenché lorsque la fenêtre est rendue. Cet événement se produit après l'événement {{Event ("load")}} pour une fenêtre, et se reproduit chaque fois que la fenêtre doit être restituée, par exemple lorsqu'une autre fenêtre l'obscurcit et est ensuite effacée.

+ +

Spécification

+ +

Cela ne fait partie d'aucune spécification.

diff --git a/files/fr/web/api/window/open/index.html b/files/fr/web/api/window/open/index.html deleted file mode 100644 index 6c44f9dd5c..0000000000 --- a/files/fr/web/api/window/open/index.html +++ /dev/null @@ -1,518 +0,0 @@ ---- -title: window.open -slug: Web/API/Window/open -tags: - - DOM - - DOM_0 -translation_of: Web/API/Window/open ---- -

{{ ApiRef() }}

- -

Définition

- -

Crée une nouvelle fenêtre de navigation secondaire et y charge la ressource référencée.

- -

Syntaxe

- -
var windowObjectReference = window.open(strUrl, strWindowName[, strWindowFeatures]);
- -

Valeur renvoyée et paramètres

- -
-
WindowObjectReference
-
Il s'agit de la référence pointant vers la fenêtre de navigation nouvellement créée. Cette référence est la valeur renvoyée par la méthode open() ; elle sera à null si pour une raison ou une autre l'appel n'a pas réussi à ouvrir une fenêtre. Une variable globale est le meilleur endroit pour stocker une telle référence. Il est alors possible, par exemple, de l'utiliser pour obtenir certaines propriétés de la nouvelle fenêtre, ou accéder à certaines de ses méthodes, à condition que la relation entre votre fenêtre principale et votre fenêtre secondaire se conforme avec les paramètres de sécurité de même origine (Same origin policy security requirements ).
-
strUrl
-
Il s'agit de l'URL à charger dans la fenêtre nouvellement créée. strUrl peut être un document HTML, un fichier image, ou tout autre type de fichier géré par le navigateur.
-
strWindowName
-
Il s'agit de la chaîne d'identification de la nouvelle fenêtre. Celle-ci peut être utilisée pour être la cible de liens et de formulaires lorsque l'attribut target d'un élément <a> ou d'un élément <form> est spécifié. Cette chaîne ne peut contenir d'espaces. strWindowName ne spécifie pas le titre de la fenêtre, juste son nom interne.
-
strWindowFeatures
-
Paramètre optionnel. Il s'agit de la chaîne listant les fonctionnalités de la nouvelle fenêtre de navigation (et de ses barres d'outils). Cette chaîne ne peut contenir d'espaces. Chaque fonctionnalité doit être séparée par une virgule au sein de la chaîne de caractères.
-
- -

Description

- -

La méthode open() crée une nouvelle fenêtre secondaire de navigation, de façon similaire au choix de l'option Nouvelle fenêtre du menu Fichier. Le paramètre strUrl spécifie l'URL à récupérer et à charger dans la nouvelle fenêtre. Si strUrl est une chaîne vide, une nouvelle fenêtre vide de tout contenu (l'URL about:blank sera chargée) est créée avec les barres d'outils par défaut de la fenêtre principale.

- -

Notez que les URL distantes ne seront pas chargées instantanément. Lorsque l'appel à window.open() se termine et renvoie sa valeur, la fenêtre contient toujours about:blank. Le chargement proprement dit de l'URL est reporté et ne commence effectivement qu'après la fin de l'exécution du bloc de script courant. La création de la fenêtre d'une part et le chargement de la ressource référencée d'autre part sont faits de manière asynchrone.

- -

Exemples

- -
var windowObjectReference;
-var strWindowFeatures = "menubar=yes,location=yes,resizable=yes,scrollbars=yes,status=yes";
-
-function openRequestedPopup() {
-  windowObjectReference = window.open("http://www.cnn.com/", "CNN_WindowName", strWindowFeatures);
-}
- -
var windowObjectReference;
-
-function openRequestedPopup() {
-  windowObjectReference = window.open(
-    "http://www.domainname.ext/path/ImageFile.png",
-    "DescriptiveWindowName",
-    "resizable,scrollbars,status"
-  );
-}
- - - -

Si une fenêtre du nom strWindowName existe déjà, alors, au lieu d'ouvrir une nouvelle fenêtre, strUrl est chargée dans cette fenêtre existante. Dans ce cas, la valeur renvoyée par la méthode est la fenêtre existante, et strWindowFeatures est ignorée. Fournir une chaîne vide pour strUrl est une manière d'obtenir une référence à une fenêtre ouverte par son nom sans en changer l'adresse. Si vous désirez ouvrir une nouvelle fenêtre à chaque appel de window.open(), il faut utiliser la nom réservé _blank pour strWindowName.

- -
-

Note : À propos de l'utilisation de window.open pour ré-ouvrir ou donner le focus à une fenêtre existante portant un nom connu du domaine : Cette fonctionalité n'est pas valide pour tous les navigateurs et qui plus est avec des comportement variables. Firefox (50.0.1) fonctionne comme il est décrit ici : depuis le même domaine+port la ré-exécution de window.open avec le même nom va accéder à la fenêtre précédemment ouverte.  Google Chrome (55.0.2883.87 m ) pour sa part ne l'exécutera qu'à partir du même parent (nommé "opener", comme si les fenêtres étaient créées avec une dépendance et uniquement avec window.open). Il s'agit là d'une limitation considérable ce qui génère une incroyable complexité de développement parfois sans issue. Firefox récupère le handle vers toutes les fenêtres du domaine dont le nom est connu, ce qui permet d'accéder à leur données, mais il ne peut exécuter une commande HTMLElement.focus() vers l'une quelconque de ces fenêtres, ce qui interdit de réouvrir la fenêtre pourtant connue comme active. Pour sa part Chrome peut redonner le focus à une fenêtre (onglet) enfant mais l'opération est impossible entre frères et depuis l'enfant vers le parent. Quant aux autres fenêtres du même domaine (même famille ?) non ouvertes avec window.open elles sont inconnues et window.open('',<name>,'') ouvrira alors des doublons. La fonction hw=window.open('',strWindowName ,'') est pourtant la seule qui permette de récupérer un handle en connaissant un nom et théoriquement éviter la création de doublons, mais pour l'instant, 22/02/2017, les différences de comportement des navigateurs ne permettent de l'utiliser que de manière partielle dans des cas très restreints.

-
- -

strWindowFeatures est une chaîne optionnelle contenant une liste, séparée par des virgules, de fonctionnalités demandées pour la nouvelle fenêtre. Après qu'une fenêtre soit ouverte, vous ne pouvez pas utiliser JavaScript pour changer ses fonctionnalités et ses barres d'outils. Si strWindowName ne spécifie pas une fenêtre existante et si vous ne fournissez pas le paramètre strWindowFeatures (ou si celui-ci est une chaîne vide), la nouvelle fenêtre secondaire comportera les barres d'outils par défaut de la fenêtre principale.

- -

Si le paramètre strWindowFeatures est utilisé et si aucune information de taille n'est définie, les dimensions de la nouvelle fenêtre seront les mêmes que celles de la fenêtre ouverte la plus récemment.

- -

Si le paramètre strWindowFeatures est utilisé et qu'aucune information de position n'est définie, les coordonnées du coin en haut à gauche de la nouvelle fenêtre seront décalées de 22 pixels vers le bas et vers la droite par rapport à celles de la fenêtre ouverte le plus récemment. Un décalage est utilisé par tous les concepteurs de navigateurs (il est de 29 pixels dans Internet Explorer 6 SP2 avec le thème par défaut) et son but est d'aider l'utilisateur à remarquer l'ouverture d'une nouvelle fenêtre. Si la fenêtre ouverte le plus récemment était maximisée, il n'y aura pas de décalage et la nouvelle fenêtre secondaire sera maximisée également.

- -

Si le paramètre strWindowFeatures est défini, les fonctionnalités qui ne sont pas listées, explicitement demandées dans la chaîne, seront désactivées ou enlevées (à l'exception de titlebar et close qui sont par défaut à yes).

- -
-

Note : Si vous utilisez le paramètre strWindowFeatures, listez uniquement les fonctionnalités dont vous avez besoin, qui doivent être activées ou affichées. Les autres (à l'exception de titlebar et close) seront désactivées ou enlevées.

-
- -

Fonctionnalités de position et de taille

- -

Note sur les corrections d'erreurs de position et de dimension

- -

{{bug(176320) }}

- -

Note sur les priorités

- -
-
left
-
Spécifie la distance à laquelle la nouvelle fenêtre est placée depuis le bord gauche de la zone de travail destinée aux applications du système d'exploitation de l'utilisateur jusqu'à la bordure extérieure (bordure de redimensionnement) de la fenêtre de navigation. La nouvelle fenêtre ne peut pas être positionnée initialement hors de l'écran.
-
top
-
Spécifie la distance à laquelle la nouvelle fenêtre est placée depuis le bord supérieur de la zone de travail destinée aux applications du système d'exploitation de l'utilisateur jusqu'à la bordure extérieure (bordure de redimensionnement) de la fenêtre de navigation. La nouvelle fenêtre ne peut pas être positionnée initialement hors de l'écran.
-
height
-
Spécifie la hauteur de la zone de contenu, l'espace de visualisation de la nouvelle fenêtre secondaire, en pixels. La valeur de hauteur comprend celle de la barre de défilement horizontale si celle-ci est présente. La valeur minimale requise est 100.
-
width
-
Spécifie la largeur de la zone de contenu, l'espace de visualisation de la nouvelle fenêtre secondaire, en pixels. La valeur de largeur comprend celle de la barre de défilement verticale si celle-ci est présente. Elle ne prend pas en compte un éventuel panneau latéral si celui-ci est déplié. La valeur minimale requise est 100.
-
screenX
-
Mozilla.
-
screenY
-
Mozilla.
-
outerHeight
-

Spécifie la hauteur de toute la fenêtre de navigation en pixels. Cette valeur outerHeight comprend toute barre d'outils présente, la barre de défilement horizontale de la fenêtre (si présente) et les bordures inférieures et supérieures. La valeur minimale requise est 100.

-

Note : étant donné que la barre de titre est toujours visible, demander une valeur outerHeight=100 rendra la valeur innerHeight de la fenêtre de navigation plus petite que les 100 pixels minimaux habituels.

-
outerWidth
-
Spécifie la largeur de toute la fenêtre de navigation en pixels. Cette valeur outerWidth comprend la barre de défilement verticale (si présente) et les bords gauche et droits de la fenêtre.
-
innerHeight
-
de la zone de contenu, l'espace de visualisation de la nouvelle fenêtre secondaire, en pixels. La valeur innerHeight comprend la hauteur de la barre de défilement horizontale si celle-ci est présente. La valeur minimale requise est 100.
-
innerWidth
-
de la zone de contenu, l'espace de visualisation de la nouvelle fenêtre secondaire, en pixels. La valeur innerWidth comprend la largeur de la barre de défilement verticale si celle-ci est présente. Elle ne prend pas en compte un éventuel panneau latéral si celui-ci est déplié. La valeur minimale requise est 100.
-
- -

Fonctionnalités de barres d'outils et de chrome

- -
-
menubar
-

Si cette fonctionnalité est définie à yes, la nouvelle fenêtre secondaire disposera d'une barre de menus. Les utilisateurs de Mozilla et Firefox peuvent obliger les nouvelles fenêtres à toujours avoir une barre de menus en positionnant dom.disable_window_open_feature.menubar à true dans about:config ou dans leur fichier user.js.

-
toolbar
-

Si cette fonctionnalité est définie à yes, la nouvelle fenêtre secondaire disposera d'une barre de navigation (boutons Précédente, Suivante, Actualiser et Arrêter). En plus de la barre de navigation, les navigateurs basés sur Mozilla afficheront également la barre d'onglets si elle est toujours visible et présente dans la fenêtre parente. Les utilisateurs de Mozilla et Firefox peuvent obliger les nouvelles fenêtres à toujours afficher la barre de navigation en positionnant dom.disable_window_open_feature.toolbar à true dans about:config ou dans leur fichier user.js.

-
location
-

Si cette fonctionnalité est définie à yes, la nouvelle fenêtre secondaire affichera une barre d'adresse (ou d'emplacement).Les utilisateurs de Mozilla et Firefox peuvent obliger les nouvelles fenêtres à toujours afficher la barre d'adresse en positionnant dom.disable_window_open_feature.location à true dans about:config ou dans leur fichier user.js. Notez qu'Internet Explorer 7 force la présence de la barre d'adresse : « Nous pensons que la barre d'adresse est aussi importante pour les utilisateurs à voir dans les fenêtres pop-up. Une barre d'adresse manquante crée une opportunité pour un fraudeur de contrefaire une adresse. Pour aider à contrer cela, IE7 va afficher une barre d'adresse sur toutes les fenêtres de navigation pour aider les utilisateurs à voir où ils sont. » provenant de Better Website Identification. Il est également dans les intentions de Mozilla de forcer la présence de la Barre d'adresse dans une prochaine version de Firefox : {{bug(337344) }}

-
directories
-

Si cette fonctionnalité est définie à yes, la nouvelle fenêtre secondaire affichera la barre personnelle dans les navigateurs Netscape 6.x, Netscape 7.x, Mozilla et Firefox. Dans Internet Explorer 5+, la barre de liens sera affichée. En plus de la barre personnelle, les navigateurs Mozilla afficheront la barre de navigation du site si celle-ci est visible et présente dans la fenêtre parente. Les utilisateurs de Mozilla et Firefox peuvent obliger les nouvelles fenêtres à toujours afficher leur barre personnelle en positionnantdom.disable_window_open_feature.directories à true dans about:config ou dans leur fichier user.js.

-
personalbar
-
Similaire à directories, mais ne fonctionne que dans Netscape et les navigateurs basés sur Mozilla.
-
status
-
Si cette fonctionnalité est définie à yes, la nouvelle fenêtre secondaire disposera d'une barre d'état. Les utilisateurs peuvent forcer la présence de la barre d'état dans tous les navigateurs basés sur Mozilla, dans Internet Explorer 6 SP2 (Note sur la barre d'état avec XP SP2) et dans Opera 6+. Les réglages par défaut des navigateurs récents basés sur Mozilla et Firefox 1.0 forcent la présence de la barre d'état.
-
- -

Fonctionnalités relatives à la fenêtre

- -
-
resizable
-

Si cette fonctionnalité est définie à yes, la nouvelle fenêtre secondaire sera redimensionnable À partir de la version 1.4, les navigateurs basés sur Mozilla ont une zone de redimensionnement à l'extrémité droite de la barre d'état. Cela permet de s'assurer que les utilisateurs peuvent toujours redimensionner la fenêtre même si l'auteur de la page Web a demandé que cette fenêtre secondaire ne soit pas redimensionnable. Dans ce cas, les icônes de maximisation/restauration dans la barre de titre de la fenêtre seront désactivées et les bordures de la fenêtre ne permettront pas de la redimensionner, mais celle-ci pourra toujours être redimensionnée via cette zone de la barre d'état. Il est probable qu'à partir de Firefox 3, toutes les fenêtres secondaires seront redimensionnables ({{ Bug(177838) }})

-
-

Note : pour des raisons d'accessibilité, il est vivement recommandé de toujours définir cette fonctionnalité à yes.

-
-

Les utilisateurs de Mozilla et Firefox peuvent obliger les nouvelles fenêtres à être facilement redimensionnables en positionnant dom.disable_window_open_feature.resizable à true dans about:config ou dans leur fichier user.js.

-
-
scrollbars
-

Si cette fonctionnalité est définie à yes, la nouvelle fenêtre secondaire affichera des barres de défilement horizontales et/ou verticales si le document ne rentre pas dans la zone d'affichage de la fenêtre.

-
-

Note : pour des raisons d'accessibilité, il est vivement recommandé de toujours définir cette fonctionnalité à yes.

-
-

Les utilisateurs de Mozilla et Firefox peuvent obliger cette option à être toujours activée en positionnant dom.disable_window_open_feature.scrollbars à true dans about:config ou dans leur fichier user.js.

-
dependent
-
Si définie à yes, la nouvelle fenêtre est dite dépendante de sa fenêtre parente. Une fenêtre dépendante se ferme lorsque sa fenêtre parente est fermée. Une fenêtre dépendante est réduite dans la barre des tâches uniquement lorsque sa fenêtre parente est réduite. Sur les plateformes Windows, une fenêtre dépendante n'est pas affichée sur la barre des tâches. Elle reste également en avant-plan de la fenêtre parente. Les fenêtres dépendantes n'existent pas sous Mac OS X, cette option y sera ignorée. La suppression complète de cette fonctionnalité sur toutes les plateformes est en cours de discussion ({{ Bug(214867) }}) Dans Internet Explorer 6, le plus proche équivalent à cette fonctionnalité est la méthode showModelessDialog().
-
modal
-

Note : à partir de Mozilla 1.2.1, cette fonctionnalité requiert le privilège UniversalBrowserWrite ({{ Bug(180048) }}). Sans ce privilège, elle est équivalente à dependent. Si définie à yes, la nouvelle fenêtre est dite modale. L'utilisateur ne peut pas retourner à la fenêtre principale tant que la fenêtre modale n'est pas fermée. Une fenêtre modale typique est créée par la fonction alert(). Le comportement exact des fenêtres modales dépend de la plateforme et de la version de Mozilla. L'équivalent de cette fonctionnalité dans Internet Explorer 6 est la méthode showModalDialog().

-
dialog
-

La fonctionnalité dialog retire toutes les icônes (restaurer, réduire, agrandir) de la barre de titre de la fenêtre, laissant uniquement le bouton de fermeture. Mozilla 1.2+ et Netscape 7.1 afficheront les autres commandes du menu système (dans Firefox 1.0 et Netscape 7.0x, le menu de commandes système n'est pas associé avec l'icône de Firefox/Netscape 7.0x à l'extrémité gauche de la barre de titre, il s'agit probablement d'un bug. Il est possible d'accéder au menu de commandes système avec un clic droit sur la barre de titre). Les fenêtres de dialogue sont des fenêtres qui n'ont pas d'icône de commande système de réduction ni d'agrandissement/restauration dans la barre de titre, ni dans les choix correspondants du menu de commandes système. On les appelle dialogues car leur utilisation normale est uniquement de notifier une information et d'être ensuite immédiatement fermées. Sur les systèmes Mac, les fenêtres de dialogue ont une bordure différente et peuvent prendre la forme desheets.

-
minimizable
-

Ce paramètre peut uniquement s'appliquer à des fenêtres de dialogue ; l'utilisation de « minimizable » nécessite dialog=yes. Si minimizable est défini à yes, le nouveau dialogue aura une commande système de réduction dans la barre de titre et il sera possible de le réduire dans la barre des tâches. Toute fenêtre n'étant pas un dialogue est toujours réductible, cette option y sera donc ignorée.

-
fullscreen
-

Ce paramètre ne fonctionne plus dans Internet Explorer 6 SP2 de la façon dont il le faisait dans Internet Explorer 5.x. La barre des tâches de Windows, ainsi que la barre de titre et la barre d'état de la fenêtre ne sont ni visibles, ni accessibles lorsque le mode plein écran est activé dans IE 5.x. fullscreen ennuie toujours les utilisateurs disposant d'un grand écran ou de plusieurs écrans. Obliger les autres utilisateurs à passer en plein écran avec fullscreen est également extrêmement impopulaire et est considéré comme une tentative impolie d'imposer les préférences d'affichage de l'auteur à l'utilisateur. fullscreen ne fonctionne plus vraiment dans Internet Explorer 6 SP2.

-
- -

Fonctionnalités nécessitant des privilèges

- -

Les fonctionnalités suivantes nécessitent le privilège UniversalBrowserWrite, autrement elles seront ignorées. Les scripts chrome bénéficient de ce privilège automatiquement, les autres doivent le demander via le PrivilegeManager.

- -
-
chrome
-

Note : à partir de Mozilla 1.7/Firefox 0.9, cette fonctionnalité requiert le privilège UniversalBrowserWrite ({{ Bug(244965) }}). Sans ce privilège, elle est ignorée. Si définie à yes, la page est chargée en tant qu'unique contenu de la fenêtre, sans aucun autre élément de l'interface de navigation. Il n'y aura pas de menu contextuel défini par défaut, et aucun des raccourcis clavier standard ne fonctionnera. La page est supposée fournir sa propre interface utilisateur, et cette fonctionnalité est habituellement utilisée pour ouvrir des documents XUL (les dialogues standard comme la console JavaScript sont ouverts de cette façon).

-
titlebar
-

Par défaut, toutes les nouvelles fenêtres secondaires ont une barre de titre. Si défini à no, ce paramètre enlève la barre de titre de la nouvelle fenêtre secondaire. Les utilisateurs de Mozilla et Firefox peuvent obliger les nouvelles fenêtres à toujours avoir une barre de titre en positionnantdom.disable_window_open_feature.titlebar à true dans about:config ou dans leur fichier user.js.

-
alwaysRaised
-
Si défini à yes, la nouvelle fenêtre sera toujours affichée par dessus les autres fenêtres du navigateur, qu'elle soit active ou non.
-
alwaysLowered
-

Si défini à yes, la nouvelle fenêtre créé flottera par dessous sa propre fenêtre parente tant que celle-ci n'est pas réduite. Les fenêtres utilisant alwaysLowered sont souvent appelées pop-under. Celles-ci ne peuvent pas passer au dessus de leur fenêtre parente, mais celle-ci peut être réduite. Dans Netscape 6.x, les fenêtres alwaysLowered n'ont pas de commande système de réduction ni de commande système restaurer/agrandir.

-
z-lock
-
Identique à alwaysLowered.
-
close
-

Lorsque défini à no, ce paramètre supprime l'icône système de fermeture de la fenêtre, et l'élément de menu correspondant. Il fonctionnera uniquement pour les fenêtres de dialogue (avec la fonctionnalité dialog activée). close=no a précédence sur minimizable=yes.Les utilisateurs de Mozilla et Firefox peuvent obliger les nouvelles fenêtres à toujours avoir un bouton de fermeture en positionnant dom.disable_window_open_feature.close à true dans about:config ou dans leur fichier user.js.

-
- -

Les fonctionnalités de position et de taille nécessitent d'être accompagnées d'un nombre. Les fonctionnalités de barres d'outils et de fenêtre peuvent être accompagnées de yes (oui) ou no (non) ; il est également possible d'utiliser 1 à la place de yes et 0 à la place de no. Les fonctionnalités de barres d'outils et de fenêtre acceptent aussi une forme raccourcie : vous pouvez activer une fonctionnalité en listant simplement son nom dans la chaîne strWindowFeatures. Si vous fournissez le paramètre strWindowFeatures, les fonctionnalités titlebar et close sont toujours à yes par défaut, mais les autres fonctionnalités présentant un choix yes/no seront à no par défaut et seront donc désactivées.

- -

Exemple :

- -
<script type="text/javascript">
-var WindowObjectReference; // variable globale
-
-function openRequestedPopup() {
-  WindowObjectReference = window.open("http://www.nomdedomaine.ext/chemin/FichierImg.png",
-        "NomDeFenetreDescriptif",
-        "width=420,height=230,resizable,scrollbars=yes,status=1");
-}
-</script>
-
- -

Dans cet exemple, la fenêtre sera redimensionnable, elle affichera des barres de défilement si nécessaire (si le contenu dépasse les dimensions de fenêtre demandées) et affichera la barre d'état. Elle n'affichera pas la barre de menus ni la barre d'adresse. Comme l'auteur connaissait la taille de l'image (400 pixels de large et 200 pixels de haut), il a ajouté les marges appliquées à l'élément racine dans Internet Explorer 6, c'est-à-dire 15 pixels en haut, 15 pixels en bas, 10 pixels à gauche et 10 pixels à droite.

- -

Bonnes pratiques

- -
<script type="text/javascript">
-var WindowObjectReference = null; // variable globale
-
-function openFFPromotionPopup() {
-  if (WindowObjectReference == null || WindowObjectReference.closed) {
-    /* si le pointeur vers l'objet window n'existe pas, ou s'il existe
-       mais que la fenêtre a été fermée */
-    WindowObjectReference = window.open("http://www.spreadfirefox.com/",
-           "PromoteFirefoxWindowName", "resizable=yes,scrollbars=yes,status=yes");
-    /* alors, création du pointeur. La nouvelle fenêtre sera créée par dessus
-       toute autre fenêtre existante. */
-  }
-  else {
-    WindowObjectReference.focus();
-    /* sinon, la référence à la fenêtre existe et la fenêtre n'a pas été
-       fermée: la fenêtre est peut-être minimisée ou derrière la fenêtre
-       principale. Par conséquent, on peut l'amener par dessus les autres à
-       l'aide de la méthode focus(). Il n'est pas nécessaire de recréer la fenêtre
-       ou de recharger la ressource référencée. */
-  };
-}
-</script>
-
-(...)
-
-<p><a href="http://www.spreadfirefox.com/" target="PromoteFirefoxWindowName" onclick="openFFPromotionPopup(); return false;" title="Ce lien créera une nouvelle fenêtre ou en réutilisera une déjà ouverte">Promouvoir
-l'adoption de Firefox</a></p>
-
- -

Le code ci-dessus résout un certain nombre de problèmes d'utilisabilité (usability ) relatif aux liens ouvrant des fenêtres secondaires. Le but du return false dans le code est d'annuler l'action par défaut du lien : si le gestionnaire d'évènements onclick est exécuté, il n'est pas nécessaire d'exécuter l'action par défaut du lien. Mais si JavaScript est désactivé ou non existant dans le navigateur de l'utilisateur, c'est l'évènement onclick qui est ignoré et le navigateur charge la ressource référencée dans le cadre ou la fenêtre portant le nom « PromoteFirefoxWindowName ». Si aucun cadre ni fenêtre ne porte ce nom, le navigateur créera une nouvelle fenêtre et l'appellera « PromoteFirefoxWindowName ».

- -

Plus d'informations sur l'utilisation de l'attribut target :

- -

HTML 4.01, section 16.3.2 La sémantique de cible

- -

Comment créer un lien qui ouvre une nouvelle fenêtre?

- -

Vous pouvez également paramétriser la fonction pour la rendre polyvalente, fonctionnelle dans plus de situations, et donc réutilisable dans d'autres scripts et pages Web :

- -
<script type="text/javascript">
-var WindowObjectReference = null; // variable globale
-
-function openRequestedPopup(strUrl, strWindowName) {
-  if(WindowObjectReference == null || WindowObjectReference.closed) {
-    WindowObjectReference = window.open(strUrl, strWindowName,
-           "resizable=yes,scrollbars=yes,status=yes");
-  }
-  else {
-    WindowObjectReference.focus();
-  };
-}
-</script>
-(...)
-
-<p><a href="http://www.spreadfirefox.com/" target="PromoteFirefoxWindow" onclick="openRequestedPopup(this.href, this.target); return false;" title="Ce lien créera une nouvelle fenêtre ou en réutilisera une déjà ouverte">Promouvoir l'adoption de Firefox</a></p>
-
- -

Vous pouvez également ne permettre à cette fonction que d'ouvrir une seule fenêtre secondaire et de la réutiliser pour d'autres liens de cette manière :

- -
<script type="text/javascript">
-var WindowObjectReference = null; // variable globale
-var PreviousUrl; /* variable globale qui stockera l'URL actuellement
-                    chargée dans la fenêtre secondaire */
-
-function openRequestedSinglePopup(strUrl)
-{
-  if(WindowObjectReference == null || WindowObjectReference.closed)
-  {
-    WindowObjectReference = window.open(strUrl, "SingleSecondaryWindowName",
-           "resizable=yes,scrollbars=yes,status=yes");
-  }
-  else if(previousUrl != strUrl)
-  {
-    WindowObjectReference = window.open(strUrl, "SingleSecondaryWindowName",
-        "resizable=yes,scrollbars=yes,status=yes");
-    /* si la ressource à charger est différente, on la charge dans la fenêtre
-       secondaire déjà ouverte, et on ramène ensuite celle-ci par dessus
-       sa fenêtre parente. */
-    WindowObjectReference.focus();
-  }
-  else
-  {
-    WindowObjectReference.focus();
-  };
-  PreviousUrl = strUrl;
-  /* explication : on stocke l'URL courante afin de pouvoir la comparer
-     dans le cas d'un autre appel à cette fonction. */
-}
-</script>
-
-(...)
-
-<p><a href="http://www.spreadfirefox.com/" target="SingleSecondaryWindowName"
-onclick="openRequestedSinglePopup(this.href); return false;"
-title="Ce lien créera une nouvelle fenêtre ou en réutilisera une déjà ouverte">Promouvoir
-l'adoption de Firefox</a></p>
-<p><a href="http://www.mozilla.org/support/firefox/faq"
-target="SingleSecondaryWindowName"
-onclick="openRequestedSinglePopup(this.href); return false;"
-title="Ce lien créera une nouvelle fenêtre ou en réutilisera une déjà ouverte">FAQ
-de Firefox</a></p>
-
- -

FAQ

- -
-
Comment empêcher l'apparition du message de confirmation demandant à l'utilisateur s'il veut fermer la fenêtre ?
-
Vous ne pouvez pas. La règle est que les nouvelles fenêtres qui ne sont pas ouvertes par JavaScript ne peuvent pas être fermées par JavaScript. La console JavaScript dans les navigateurs basés sur Mozilla affichera le message d'avertissement suivant : "Scripts may not close windows that were not opened by script." Si c'était possible, l'historique des URL visitées durant la session de navigation serait perdu au détriment de l'utilisateur. Plus de détails sur la méthode window.close()
-
Comment ramener la fenêtre si elle est réduite ou masquée par une autre fenêtre ?
-
Vérifiez d'abord l'existence de la référence à l'objet window, et si celle-ci existe et n'a pas été fermée, utilisez la méthode focus(). Il n'y a pas d'autre manière fiable. Un exemple montrant comment utiliser la méthode focus() est présenté ci-dessus.
-
Comment forcer une fenêtre à être agrandie/maximisée ?
-
Ce n'est pas possible. Tous les fabricants de navigateurs essaient de rendre l'ouverture d'une nouvelle fenêtre visible et remarquée par les utilisateurs, afin d'éviter de les désorienter.
-
Comment désactiver le redimensionnement des fenêtres ou supprimer les barres d'outils ?
-
Il n'est pas possible de l'imposer. Les utilisateurs de navigateurs basés sur Mozilla ont un contrôle absolu sur les fonctionnalités des fenêtres comme le fait de pouvoir les redimensionner, de les faire défiler et la présence de barres d'outils via les préférences utilisateur dans about:config. Comme vos utilisateurs sont ceux qui sont supposés utiliser de telles fenêtres (et non vous en tant qu'auteur), le mieux est d'éviter d'interférer avec leurs habitudes et préférences. Il est recommandé de toujours positionner la redimensionnabilité et la présence de barres de défilement (si nécessaire) à yes pour assurer l'accessibilité au contenu et l'utilisabilité des fenêtres. Ceci est dans l'intérêt tant de l'auteur Web que de ses utilisateurs.
-
Comment redimensionner une fenêtre en fonction de son contenu ?
-

Ce n'est pas faisable de manière fiable, car les utilisateurs peuvent empêcher la fenêtre d'être redimensionnée en décochant la case Édition/Préférences/Avancé/Scripts & plugins/Autoriser les scripts à/ Déplacer ou redimensionner des fenêtres existantes dans Mozilla ou Outils/Options/Contenu/Activer JavaScript/Bouton Avancé/Déplacer ou redimensionner des fenêtres existantes dans Firefox, ou en positionnant dom.disable_window_move_resize à true dans about:config ou encore en éditant leur fichier user.js. En général, les utilisateurs désactivent le déplacement et le redimensionnement des fenêtres, étant donné qu'autoriser les scripts à le faire a été la source d'énormément d'abus dans le passé, et les rares scripts qui n'en abusent pas sont souvent incorrects dans leur manière de redimensionner la fenêtre. 99% de ces scripts désactivent le redimensionnement manuel des fenêtres et les barres de défilement alors qu'ils devraient en fait activer ces deux fonctionnalités pour permettre un mécanisme de récupération sain et circonspect dans le cas où leurs calculs s'avèreraient incorrects.

La méthode sizeToContent() de l'objet window est également désactivée si l'utilisateur décoche la préférence Déplacer ou redimensionner des fenêtres existantes. Déplacer et redimensionner une fenêtre à distance sur l'écran de l'utilisateur l'ennuiera très souvent, le désorientera, et au mieux sera incorrect. Les auteurs Web espèrent souvent avoir un contrôle absolu (et un pouvoir de décision) sur tous les aspects de positionnement et de taille des fenêtres de l'utilisateur ... ce qui n'est tout simplement pas vrai.

-
Comment ouvrir une ressource référencée par un lien dans un nouvel onglet ? ou dans un onglet spécifique ?
-
Pour l'instant, ce n'est pas possible. Seul l'utilisateur peut modifier ses préférences avancées pour faire cela. K-meleon 1.1, un navigateur basé sur Mozilla, donne un contrôle et un pouvoir complet à l'utilisateur sur la manière dont les liens sont ouverts. Certaines extensions avancées donnent également à Mozilla et Firefox un grand pouvoir concernant la manière dont les ressources référencées sont chargées. Dans quelques années, la propriété target du module CSS3 hyperlien pourrait être implémentée (si le module CSS3 Hyperlink tel qu'il existe à présent est approuvé). Même si cela se fait et lorsque cela se produira, attendez-vous à ce que les développeurs de navigateurs utilisant des onglets donnent un pouvoir de veto à l'utilisateur et un contrôle total de la façon dont les liens peuvent ouvrir des pages Web. La façon d'ouvrir un lien devrait toujours être entièrement sous le contrôle de l'utilisateur.
-
Comment savoir si une fenêtre que j'ai ouverte l'est toujours ?
-
Vous pouvez tester l'existence de la référence à l'objet window, qui est la valeur renvoyée en cas de succès de l'appel à window.open(), et vérifier ensuite que la valeur renvoyée par WindowObjectReference.closed est bien false.
-
Comment savoir si ma fenêtre a été bloquée par un bloqueur de popups ?
-
Avec les bloqueurs de popups intégrés dans Mozilla/Firefox et Internet Explorer 6 SP2, il est possible de vérifier la valeur renvoyée par window.open() : elle sera null si la fenêtre n'a pas été autorisée à s'ouvrir. Cependant, pour la plupart des autres bloqueurs de popups, il n'existe pas de manière fiable.
-
Quelle est la relation JavaScript entre la fenêtre principale et la fenêtre secondaire ?
-
La valeur renvoyée par la méthode window.open() est la propriété opener. La variable WindowObjectReference lie la fenêtre principale (opener) à la fenêtre secondaire qu'elle a ouverte, tandis que le mot-clé opener liera la fenêtre secondaire à sa fenêtre principale (celle qui a déclenché son ouverture).
-
Je n'arrive pas à accéder aux propriétés de la nouvelle fenêtre secondaire. J'obtiens toujours une erreur dans la console JavaScript disant « Erreur : uncaught exception: Permission denied to get property <property_name or method_name> ». Pourquoi cela ?
-

Ceci est causé par la restriction de sécurité des scripts entre domaines (aussi appeléeSame Origin Policy , « Politique de même origine »). Un script chargé dans une fenêtre (ou cadre) d'une origine donnée (nom de domaine) ne peut pas obtenir ou modifier des propriétés d'une autre fenêtre (ou cadre) ou les propriétés d'aucun de ses objets HTML si celle-ci provient d'une autre origine distincte (nom de domaine). C'est pourquoi, avant d'exécuter un script se référant à une fenêtre secondaire depuis la fenêtre principale, le navigateur vérifiera que la fenêtre secondaire possède le même nom de domaine. Plus d'informations à propos de la restriction de sécurité des scripts entre domaines : http://www.mozilla.org/projects/secu...me-origin.html

-
- -

Problèmes d'utilisabilité

- -

Évitez de recourir à window.open()

- -

De manière générale, il est préférable d'éviter d'utiliser window.open() pour plusieurs raisons :

- - - -

Offrez d'ouvrir un lien dans une nouvelle fenêtre, en suivant ces recommandations

- -

Si vous voulez permettre l'ouverture d'un lien dans une nouvelle fenêtre, suivez ces règles d'utilisabilité et d'accessibilité testées et éprouvées :

- -
N'utilisez jamais ce format de code pour les liens :
- <a href="javascript:window.open(...)" ...>
- -

Les liens « javascript: » sont toujours mauvais pour l'accessibilité et l'utilisabilité des pages Web dans tous les navigateurs.

- - - -

Plus d'informations à ce sujet :

- - - -
N'utilisez jamais <a href="#" onclick="window.open(...);">
- -

Un tel pseudo-lien met également en péril l'accessibilité des liens. Utilisez toujours une véritable URL pour la valeur de l'attribut href, afin que si JavaScript s'avère désactivé ou absent, ou si le navigateur ne peut pas ouvrir de fenêtre secondaire (comme Microsoft Web TV, les navigateurs en mode texte, etc.), de tels navigateurs pourront toujours charger la référence référencée dans leur mode de chargement/gestion de nouvelles ressources par défaut. Cette forme de code interfère également avec les fonctionnalités avancées de navigation par onglets de certains navigateurs, comme le clic du milieu et les raccourcis Ctrl+clic et Ctrl+Entrée sur les liens, les « mouse gestures », etc.

- -
Identifiez toujours les liens qui créeront (ou réutiliseront) une nouvelle fenêtre secondaire
- -

Identifiez les liens qui ouvriront de nouvelles fenêtre de manière à aider les utilisateurs en utilisant l'attribut title du lien, en ajoutant une icône à la fin du lien, ou en modifiant le curseur de la souris.

- -

Le but est d'avertir les utilisateurs à l'avance des changements de contexte pour réduire la confusion de leur part : changer la fenêtre courante ou afficher subitement une nouvelle fenêtre peut être très désorientant pour certains utilisateurs (le bouton Précédent devient inutilisable).

- -
-

« Souvent, les utilisateurs ne remarquent pas qu'une nouvelle fenêtre s'est ouverte, particulièrement si ils utilisent un petit écran où les fenêtres sont agrandies pour utiliser toute la surface de l'écran. Ainsi, l'utilisateur voulant retourner à la page initiale sera dérouté par un boutonPrécédente grisé. »
- citation de The Top TenNew Mistakes of Web Design: 2. Opening New Browser Windows, Jakob Nielsen, mai 1999

-
- -

Lorsque des changements complets de contexte sont identifiés explicitement avant qu'ils se produisent, l'utilisateur peut déterminer s'il désire le faire ou s'y préparer : non seulement il ne sera pas perturbé ni désorienté, mais des utilisateurs plus expérimentés pourront eux-mêmes décider comment ouvrir de tels liens (dans une nouvelle fenêtre ou non, dans la même fenêtre, dans un nouvel onglet ou non, en arrière-plan ou non).

- -

Références

- - - -
Utilisez toujours l'attribut target
- -

Si JavaScript est désactivé ou absent, le navigateur créera une fenêtre secondaire ou affichera la ressource demandée selon sa gestion habituelle de l'attribut target : par exemple certains navigateurs ne pouvant pas créer de nouvelles fenêtres comme Microsoft Web TV, chargeront la ressource demandée et l'ajouteront à la fin du document courant. Le but et l'idée est d'essayer de fournir — sans l'imposer — à l'utilisateur une manière d'ouvrir la ressource référencée, de suivre le lien. Votre code ne doit pas interférer avec les fonctionnalités du navigateur à disposition de l'utilisateur, et doit toujours lui laisser le chemin libre et le choix de la décision finale.

- -
N'utilisez pas target="_blank"
- -

Fournissez toujours un nom significatif dans votre attribut target, et essayez de le réutiliser dans votre page afin qu'un clic sur un autre lien puisse charger la ressource dans une fenêtre déjà utilisée (ce qui rend l'opération beaucoup plus rapide pour l'utilisateur), ce qui justifie la raison (et les ressources système, et le temps dépensé) d'avoir créé une fenêtre secondaire. Utiliser une seule cible et la réutiliser pour plusieurs liens est bien moins gourmand en matière de ressources puisqu'une seule fenêtre est créée et recyclée. D'un autre côté, utiliser « _blank » comme attribut target créera plusieurs nouvelles fenêtre anonymes sur le bureau de l'utilisateur qui ne peuvent ni être recyclées ni réutilisées.

- -

Dans tous les cas, si votre code est bien fait, il ne devrait pas interférer avec le choix final de l'utilisateur mais lui offrira plutôt des choix supplémentaires, plus de façons d'ouvrir les liens et plus de pouvoir sur l'outil qu'il utilise (son navigateur).

- -

Glossaire

- -
-
Fenêtre ouvrante, opener, fenêtre parente, fenêtre principale, première fenêtre
-
Termes souvent utilisés pour décrire ou identifier la même fenêtre. Il s'agit de la fenêtre depuis laquelle une nouvelle fenêtre sera créée. C'est la fenêtre dans laquelle l'utilisateur clique sur un lien qui mène à la création d'une autre, nouvelle fenêtre.
-
Sous-fenêtre, fenêtre enfant, fenêtre secondaire, deuxième fenêtre
-
Termes souvent utilisés pour décrire ou identifier la même fenêtre. C'est la nouvelle fenêtre qui a été créée.
-
Fenêtres popup non sollicitées
-
Ouverture automatique de fenêtres initiée par un script sans le consentement de l'utilisateur.
-
- -

Spécification

- -

{{ DOM0() }} window.open() ne fait partie d'aucune spécification ou recommandation technique du W3C.

- -

Notes

- -

Note sur les priorités

- -

Dans les cas où left et screenX (et/ou top et screenY) ont des valeurs contradictoires, left et top ont priorité sur screenX et screenY respectivement. Si left et screenX (et/ou top et screenY) sont définies dans la liste strWindowFeatures, les valeurs left (et/ou top) seront reconnues et utilisées. Dans l'exemple suivant, la nouvelle fenêtre sera positionnée à 100 pixels du bord gauche de la zone de travail des applications du système d'exploitation de l'utilisateur, et non à 200 pixels.

- -
<script type="text/javascript">
-WindowObjectReference = window.open("http://www.lemonde.fr/",
-           "NomDeLaFenetreLeMonde",
-           "left=100,screenX=200,resizable,scrollbars,status");
-</script>
-
- -

Si left est défini, mais que top n'a aucune valeur mais que screenY en a une, left et screenY seront les coordonnées de positionnement de la fenêtre secondaire.

- -

outerWidth a priorité sur width, et width a priorité sur innerWidth. outerHeight a priorité sur height et height a priorité sur innerHeight. Dans l'exemple suivant, les navigateurs basés sur Mozilla créeront une nouvelle fenêtre avec une taille extérieure (outerWidth) de 600 pixels de large et ignoreront la requête d'une largeur (width) de 500 pixels ainsi que celle d'une taille intérieure (innerWidth) de 400 pixels.

- -
<script type="text/javascript">
-WindowObjectReference = window.open("http://www.wwf.org/",
-           "NomDeLaFenetreWWF",
-           "outerWidth=600,width=500,innerWidth=400,resizable,scrollbars,status");
-</script>
-
- -

Note sur les corrections d'erreurs de position et de dimension

- -

Les positions et dimensions demandées dans la liste strWindowFeatures ne seront pas respectées et seront corrigées si n'importe laquelle de ces valeurs ne permet pas à la fenêtre complète d'être affichée dans la zone de travail des applications du système d'exploitation de l'utilisateur. Aucune partie de la nouvelle fenêtre ne peut être initialement positionnée hors de l'écran. Ceci est le réglage par défaut de tous les navigateurs basés sur Mozilla.

- -

Internet Explorer 6 SP2 dispose d'un mécanisme de correction d'erreur similaire, mais celui-ci n'est pas activé par défaut pour tous les niveaux de sécurité : un niveau de sécurité trop bas peut désactiver ce mécanisme de correction d'erreurs.

- -

Note sur les barres de défilement

- -

Lorsque le contenu dépasse les dimensions de la zone de visualisation de la fenêtre, des barres de défilement (ou un mécanisme de définement similaire) sont nécessaires pour s'assurer que les utilisateurs puissent accéder au contenu. Le contenu ou la boîte du document d'une page web peut outrepasser, excéder les dimensions demandées pour la fenêtre pour plusieurs raisons qui sont hors du contrôle des auteurs Web :

- - - -

Note sur la barre d'état

- -

Vous devez vous attendre à ce qu'une large majorité des navigateurs affichent la barre d'état, ou qu'une large majorité des utilisateurs voudront forcer sa présence : le mieux est de toujours positionner cette fonctionnalité à yes. De plus, si vous demandez spécifiquement de retirer la barre d'état, les utilisateurs de Firefox ne pourront plus utilser la barre de navigation de site si elle est installée. Dans Mozilla et dans Firefox, toutes les fenêtres peuvent être redimensionnées à partir de la zone inférieure droite de la barre d'état. Celle-ci fournit également des informations sur la connexion http, l'emplacement des ressources hypertextes, la barre de progression du téléchargement, l'icône de chiffrement/connexion sécurisée avec SSL (affichant une icône de cadenas jaune), des icônes de zones de sécurité, de politique de sécurité en matière de cookies, etc. Enlever la barre d'état retire souvent de très nombreuses fonctionnalités et informations considérées comme utiles (et parfois vitales) par les utilisateurs.

- -

Note sur les problèmes de sécurité liés à la présence de la barre d'état

- -

Dans Internet Explorer 6 pour XP SP2, pour les fenêtres ouvertes à l'aide de window.open() :

- -
-

« Pour les fenêtres ouvertes à l'aide de window.open() :
- Attendez-vous à ce que la barre d'état soit présente, et codez en conséquence. La barre d'état sera activée par défaut et fait entre 20 et 25 pixels de haut. (...) »
- citation de Fine-Tune Your Web Site for Windows XP Service Pack 2, Browser Window Restrictions in XP SP2

-
- -
-

« (...) les fenêtres créées à l'aide de la méthode window.open() peuvent être appelées par des scripts et utilisées pour imiter une fausse interface utilisateur ou bureau, ou pour masquer des informations ou des activités malveillantes en dimensionnant la fenêtre de manière à rendre la barre d'état invisible.
- Les fenêtres d'Internet Explorer fournissent des informations de sécurité visibles par l'utilisateur pour l'aider à identifier avec certitude la source de la page et le niveau de sécurité de la communication avec cette page. Lorsque ces éléments ne sont pas visibles, les utilisateurs peuvent penser qu'ils sont sur une page plus digne de confiance ou interagissent avec un processus système alors qu'il sont en train d'interagir avec un hôte malveillant. (...)
- Les fenêtres lancées par des scripts seront affichées entièrement, avec la barre de titre d'Internet Explorer et sa barre d'état. (...)
- Gestion de la barre d'état d'Internet Explorer par les scripts
- Description détaillée
- Internet Explorer a été modifié pour ne désactiver la barre d'état pour aucune fenêtre. La barre d'état est toujours visible pour toutes les fenêtres d'Internet Explorer. (...) Sans ce changement, les fenêtres créées à l'aide de la méthode window.open() peuvent être appelées par des scripts et imiter une fausse interface utilisateur ou bureau, ou pour masquer des informations importantes pour l'utilisateur.
- La barre d'état est une fonction de sécurité des fenêtres d'Internet Explorer qui fournissent à l'utilisateur des informations sur les zones de sécurité. Cette zone ne peut pas être imitée (...)"
- citation de Changes to Functionality in Microsoft Windows XP Service Pack 2, Internet Explorer Window Restrictions

-
- -

Note sur le plein écran (fullscreen)

- -

Dans Internet Explorer 6 pour XP SP2 :

- - - -

Références :

- - - -

Note sur la différence entre outerHeight et height

- - -

Tutoriels

- -

en français :

- -

Créer des pop-up intelligentes par Fabrice Bonny, OpenWeb

- -

en anglais :

- -

JavaScript windows (tutorial) par Lasse Reichstein Nielsen

- -

The perfect pop-up (tutorial) par Ian Lloyd

- -

Popup windows and Firefox (interactive demos) par Gérard Talbot

- -

Références

- -

Links Want To Be Links by Jukka K. Korpela

- -

Links & JavaScript Living Together in Harmony by Jeff Howden

diff --git a/files/fr/web/api/window/open/index.md b/files/fr/web/api/window/open/index.md new file mode 100644 index 0000000000..6c44f9dd5c --- /dev/null +++ b/files/fr/web/api/window/open/index.md @@ -0,0 +1,518 @@ +--- +title: window.open +slug: Web/API/Window/open +tags: + - DOM + - DOM_0 +translation_of: Web/API/Window/open +--- +

{{ ApiRef() }}

+ +

Définition

+ +

Crée une nouvelle fenêtre de navigation secondaire et y charge la ressource référencée.

+ +

Syntaxe

+ +
var windowObjectReference = window.open(strUrl, strWindowName[, strWindowFeatures]);
+ +

Valeur renvoyée et paramètres

+ +
+
WindowObjectReference
+
Il s'agit de la référence pointant vers la fenêtre de navigation nouvellement créée. Cette référence est la valeur renvoyée par la méthode open() ; elle sera à null si pour une raison ou une autre l'appel n'a pas réussi à ouvrir une fenêtre. Une variable globale est le meilleur endroit pour stocker une telle référence. Il est alors possible, par exemple, de l'utiliser pour obtenir certaines propriétés de la nouvelle fenêtre, ou accéder à certaines de ses méthodes, à condition que la relation entre votre fenêtre principale et votre fenêtre secondaire se conforme avec les paramètres de sécurité de même origine (Same origin policy security requirements ).
+
strUrl
+
Il s'agit de l'URL à charger dans la fenêtre nouvellement créée. strUrl peut être un document HTML, un fichier image, ou tout autre type de fichier géré par le navigateur.
+
strWindowName
+
Il s'agit de la chaîne d'identification de la nouvelle fenêtre. Celle-ci peut être utilisée pour être la cible de liens et de formulaires lorsque l'attribut target d'un élément <a> ou d'un élément <form> est spécifié. Cette chaîne ne peut contenir d'espaces. strWindowName ne spécifie pas le titre de la fenêtre, juste son nom interne.
+
strWindowFeatures
+
Paramètre optionnel. Il s'agit de la chaîne listant les fonctionnalités de la nouvelle fenêtre de navigation (et de ses barres d'outils). Cette chaîne ne peut contenir d'espaces. Chaque fonctionnalité doit être séparée par une virgule au sein de la chaîne de caractères.
+
+ +

Description

+ +

La méthode open() crée une nouvelle fenêtre secondaire de navigation, de façon similaire au choix de l'option Nouvelle fenêtre du menu Fichier. Le paramètre strUrl spécifie l'URL à récupérer et à charger dans la nouvelle fenêtre. Si strUrl est une chaîne vide, une nouvelle fenêtre vide de tout contenu (l'URL about:blank sera chargée) est créée avec les barres d'outils par défaut de la fenêtre principale.

+ +

Notez que les URL distantes ne seront pas chargées instantanément. Lorsque l'appel à window.open() se termine et renvoie sa valeur, la fenêtre contient toujours about:blank. Le chargement proprement dit de l'URL est reporté et ne commence effectivement qu'après la fin de l'exécution du bloc de script courant. La création de la fenêtre d'une part et le chargement de la ressource référencée d'autre part sont faits de manière asynchrone.

+ +

Exemples

+ +
var windowObjectReference;
+var strWindowFeatures = "menubar=yes,location=yes,resizable=yes,scrollbars=yes,status=yes";
+
+function openRequestedPopup() {
+  windowObjectReference = window.open("http://www.cnn.com/", "CNN_WindowName", strWindowFeatures);
+}
+ +
var windowObjectReference;
+
+function openRequestedPopup() {
+  windowObjectReference = window.open(
+    "http://www.domainname.ext/path/ImageFile.png",
+    "DescriptiveWindowName",
+    "resizable,scrollbars,status"
+  );
+}
+ + + +

Si une fenêtre du nom strWindowName existe déjà, alors, au lieu d'ouvrir une nouvelle fenêtre, strUrl est chargée dans cette fenêtre existante. Dans ce cas, la valeur renvoyée par la méthode est la fenêtre existante, et strWindowFeatures est ignorée. Fournir une chaîne vide pour strUrl est une manière d'obtenir une référence à une fenêtre ouverte par son nom sans en changer l'adresse. Si vous désirez ouvrir une nouvelle fenêtre à chaque appel de window.open(), il faut utiliser la nom réservé _blank pour strWindowName.

+ +
+

Note : À propos de l'utilisation de window.open pour ré-ouvrir ou donner le focus à une fenêtre existante portant un nom connu du domaine : Cette fonctionalité n'est pas valide pour tous les navigateurs et qui plus est avec des comportement variables. Firefox (50.0.1) fonctionne comme il est décrit ici : depuis le même domaine+port la ré-exécution de window.open avec le même nom va accéder à la fenêtre précédemment ouverte.  Google Chrome (55.0.2883.87 m ) pour sa part ne l'exécutera qu'à partir du même parent (nommé "opener", comme si les fenêtres étaient créées avec une dépendance et uniquement avec window.open). Il s'agit là d'une limitation considérable ce qui génère une incroyable complexité de développement parfois sans issue. Firefox récupère le handle vers toutes les fenêtres du domaine dont le nom est connu, ce qui permet d'accéder à leur données, mais il ne peut exécuter une commande HTMLElement.focus() vers l'une quelconque de ces fenêtres, ce qui interdit de réouvrir la fenêtre pourtant connue comme active. Pour sa part Chrome peut redonner le focus à une fenêtre (onglet) enfant mais l'opération est impossible entre frères et depuis l'enfant vers le parent. Quant aux autres fenêtres du même domaine (même famille ?) non ouvertes avec window.open elles sont inconnues et window.open('',<name>,'') ouvrira alors des doublons. La fonction hw=window.open('',strWindowName ,'') est pourtant la seule qui permette de récupérer un handle en connaissant un nom et théoriquement éviter la création de doublons, mais pour l'instant, 22/02/2017, les différences de comportement des navigateurs ne permettent de l'utiliser que de manière partielle dans des cas très restreints.

+
+ +

strWindowFeatures est une chaîne optionnelle contenant une liste, séparée par des virgules, de fonctionnalités demandées pour la nouvelle fenêtre. Après qu'une fenêtre soit ouverte, vous ne pouvez pas utiliser JavaScript pour changer ses fonctionnalités et ses barres d'outils. Si strWindowName ne spécifie pas une fenêtre existante et si vous ne fournissez pas le paramètre strWindowFeatures (ou si celui-ci est une chaîne vide), la nouvelle fenêtre secondaire comportera les barres d'outils par défaut de la fenêtre principale.

+ +

Si le paramètre strWindowFeatures est utilisé et si aucune information de taille n'est définie, les dimensions de la nouvelle fenêtre seront les mêmes que celles de la fenêtre ouverte la plus récemment.

+ +

Si le paramètre strWindowFeatures est utilisé et qu'aucune information de position n'est définie, les coordonnées du coin en haut à gauche de la nouvelle fenêtre seront décalées de 22 pixels vers le bas et vers la droite par rapport à celles de la fenêtre ouverte le plus récemment. Un décalage est utilisé par tous les concepteurs de navigateurs (il est de 29 pixels dans Internet Explorer 6 SP2 avec le thème par défaut) et son but est d'aider l'utilisateur à remarquer l'ouverture d'une nouvelle fenêtre. Si la fenêtre ouverte le plus récemment était maximisée, il n'y aura pas de décalage et la nouvelle fenêtre secondaire sera maximisée également.

+ +

Si le paramètre strWindowFeatures est défini, les fonctionnalités qui ne sont pas listées, explicitement demandées dans la chaîne, seront désactivées ou enlevées (à l'exception de titlebar et close qui sont par défaut à yes).

+ +
+

Note : Si vous utilisez le paramètre strWindowFeatures, listez uniquement les fonctionnalités dont vous avez besoin, qui doivent être activées ou affichées. Les autres (à l'exception de titlebar et close) seront désactivées ou enlevées.

+
+ +

Fonctionnalités de position et de taille

+ +

Note sur les corrections d'erreurs de position et de dimension

+ +

{{bug(176320) }}

+ +

Note sur les priorités

+ +
+
left
+
Spécifie la distance à laquelle la nouvelle fenêtre est placée depuis le bord gauche de la zone de travail destinée aux applications du système d'exploitation de l'utilisateur jusqu'à la bordure extérieure (bordure de redimensionnement) de la fenêtre de navigation. La nouvelle fenêtre ne peut pas être positionnée initialement hors de l'écran.
+
top
+
Spécifie la distance à laquelle la nouvelle fenêtre est placée depuis le bord supérieur de la zone de travail destinée aux applications du système d'exploitation de l'utilisateur jusqu'à la bordure extérieure (bordure de redimensionnement) de la fenêtre de navigation. La nouvelle fenêtre ne peut pas être positionnée initialement hors de l'écran.
+
height
+
Spécifie la hauteur de la zone de contenu, l'espace de visualisation de la nouvelle fenêtre secondaire, en pixels. La valeur de hauteur comprend celle de la barre de défilement horizontale si celle-ci est présente. La valeur minimale requise est 100.
+
width
+
Spécifie la largeur de la zone de contenu, l'espace de visualisation de la nouvelle fenêtre secondaire, en pixels. La valeur de largeur comprend celle de la barre de défilement verticale si celle-ci est présente. Elle ne prend pas en compte un éventuel panneau latéral si celui-ci est déplié. La valeur minimale requise est 100.
+
screenX
+
Mozilla.
+
screenY
+
Mozilla.
+
outerHeight
+

Spécifie la hauteur de toute la fenêtre de navigation en pixels. Cette valeur outerHeight comprend toute barre d'outils présente, la barre de défilement horizontale de la fenêtre (si présente) et les bordures inférieures et supérieures. La valeur minimale requise est 100.

+

Note : étant donné que la barre de titre est toujours visible, demander une valeur outerHeight=100 rendra la valeur innerHeight de la fenêtre de navigation plus petite que les 100 pixels minimaux habituels.

+
outerWidth
+
Spécifie la largeur de toute la fenêtre de navigation en pixels. Cette valeur outerWidth comprend la barre de défilement verticale (si présente) et les bords gauche et droits de la fenêtre.
+
innerHeight
+
de la zone de contenu, l'espace de visualisation de la nouvelle fenêtre secondaire, en pixels. La valeur innerHeight comprend la hauteur de la barre de défilement horizontale si celle-ci est présente. La valeur minimale requise est 100.
+
innerWidth
+
de la zone de contenu, l'espace de visualisation de la nouvelle fenêtre secondaire, en pixels. La valeur innerWidth comprend la largeur de la barre de défilement verticale si celle-ci est présente. Elle ne prend pas en compte un éventuel panneau latéral si celui-ci est déplié. La valeur minimale requise est 100.
+
+ +

Fonctionnalités de barres d'outils et de chrome

+ +
+
menubar
+

Si cette fonctionnalité est définie à yes, la nouvelle fenêtre secondaire disposera d'une barre de menus. Les utilisateurs de Mozilla et Firefox peuvent obliger les nouvelles fenêtres à toujours avoir une barre de menus en positionnant dom.disable_window_open_feature.menubar à true dans about:config ou dans leur fichier user.js.

+
toolbar
+

Si cette fonctionnalité est définie à yes, la nouvelle fenêtre secondaire disposera d'une barre de navigation (boutons Précédente, Suivante, Actualiser et Arrêter). En plus de la barre de navigation, les navigateurs basés sur Mozilla afficheront également la barre d'onglets si elle est toujours visible et présente dans la fenêtre parente. Les utilisateurs de Mozilla et Firefox peuvent obliger les nouvelles fenêtres à toujours afficher la barre de navigation en positionnant dom.disable_window_open_feature.toolbar à true dans about:config ou dans leur fichier user.js.

+
location
+

Si cette fonctionnalité est définie à yes, la nouvelle fenêtre secondaire affichera une barre d'adresse (ou d'emplacement).Les utilisateurs de Mozilla et Firefox peuvent obliger les nouvelles fenêtres à toujours afficher la barre d'adresse en positionnant dom.disable_window_open_feature.location à true dans about:config ou dans leur fichier user.js. Notez qu'Internet Explorer 7 force la présence de la barre d'adresse : « Nous pensons que la barre d'adresse est aussi importante pour les utilisateurs à voir dans les fenêtres pop-up. Une barre d'adresse manquante crée une opportunité pour un fraudeur de contrefaire une adresse. Pour aider à contrer cela, IE7 va afficher une barre d'adresse sur toutes les fenêtres de navigation pour aider les utilisateurs à voir où ils sont. » provenant de Better Website Identification. Il est également dans les intentions de Mozilla de forcer la présence de la Barre d'adresse dans une prochaine version de Firefox : {{bug(337344) }}

+
directories
+

Si cette fonctionnalité est définie à yes, la nouvelle fenêtre secondaire affichera la barre personnelle dans les navigateurs Netscape 6.x, Netscape 7.x, Mozilla et Firefox. Dans Internet Explorer 5+, la barre de liens sera affichée. En plus de la barre personnelle, les navigateurs Mozilla afficheront la barre de navigation du site si celle-ci est visible et présente dans la fenêtre parente. Les utilisateurs de Mozilla et Firefox peuvent obliger les nouvelles fenêtres à toujours afficher leur barre personnelle en positionnantdom.disable_window_open_feature.directories à true dans about:config ou dans leur fichier user.js.

+
personalbar
+
Similaire à directories, mais ne fonctionne que dans Netscape et les navigateurs basés sur Mozilla.
+
status
+
Si cette fonctionnalité est définie à yes, la nouvelle fenêtre secondaire disposera d'une barre d'état. Les utilisateurs peuvent forcer la présence de la barre d'état dans tous les navigateurs basés sur Mozilla, dans Internet Explorer 6 SP2 (Note sur la barre d'état avec XP SP2) et dans Opera 6+. Les réglages par défaut des navigateurs récents basés sur Mozilla et Firefox 1.0 forcent la présence de la barre d'état.
+
+ +

Fonctionnalités relatives à la fenêtre

+ +
+
resizable
+

Si cette fonctionnalité est définie à yes, la nouvelle fenêtre secondaire sera redimensionnable À partir de la version 1.4, les navigateurs basés sur Mozilla ont une zone de redimensionnement à l'extrémité droite de la barre d'état. Cela permet de s'assurer que les utilisateurs peuvent toujours redimensionner la fenêtre même si l'auteur de la page Web a demandé que cette fenêtre secondaire ne soit pas redimensionnable. Dans ce cas, les icônes de maximisation/restauration dans la barre de titre de la fenêtre seront désactivées et les bordures de la fenêtre ne permettront pas de la redimensionner, mais celle-ci pourra toujours être redimensionnée via cette zone de la barre d'état. Il est probable qu'à partir de Firefox 3, toutes les fenêtres secondaires seront redimensionnables ({{ Bug(177838) }})

+
+

Note : pour des raisons d'accessibilité, il est vivement recommandé de toujours définir cette fonctionnalité à yes.

+
+

Les utilisateurs de Mozilla et Firefox peuvent obliger les nouvelles fenêtres à être facilement redimensionnables en positionnant dom.disable_window_open_feature.resizable à true dans about:config ou dans leur fichier user.js.

+
+
scrollbars
+

Si cette fonctionnalité est définie à yes, la nouvelle fenêtre secondaire affichera des barres de défilement horizontales et/ou verticales si le document ne rentre pas dans la zone d'affichage de la fenêtre.

+
+

Note : pour des raisons d'accessibilité, il est vivement recommandé de toujours définir cette fonctionnalité à yes.

+
+

Les utilisateurs de Mozilla et Firefox peuvent obliger cette option à être toujours activée en positionnant dom.disable_window_open_feature.scrollbars à true dans about:config ou dans leur fichier user.js.

+
dependent
+
Si définie à yes, la nouvelle fenêtre est dite dépendante de sa fenêtre parente. Une fenêtre dépendante se ferme lorsque sa fenêtre parente est fermée. Une fenêtre dépendante est réduite dans la barre des tâches uniquement lorsque sa fenêtre parente est réduite. Sur les plateformes Windows, une fenêtre dépendante n'est pas affichée sur la barre des tâches. Elle reste également en avant-plan de la fenêtre parente. Les fenêtres dépendantes n'existent pas sous Mac OS X, cette option y sera ignorée. La suppression complète de cette fonctionnalité sur toutes les plateformes est en cours de discussion ({{ Bug(214867) }}) Dans Internet Explorer 6, le plus proche équivalent à cette fonctionnalité est la méthode showModelessDialog().
+
modal
+

Note : à partir de Mozilla 1.2.1, cette fonctionnalité requiert le privilège UniversalBrowserWrite ({{ Bug(180048) }}). Sans ce privilège, elle est équivalente à dependent. Si définie à yes, la nouvelle fenêtre est dite modale. L'utilisateur ne peut pas retourner à la fenêtre principale tant que la fenêtre modale n'est pas fermée. Une fenêtre modale typique est créée par la fonction alert(). Le comportement exact des fenêtres modales dépend de la plateforme et de la version de Mozilla. L'équivalent de cette fonctionnalité dans Internet Explorer 6 est la méthode showModalDialog().

+
dialog
+

La fonctionnalité dialog retire toutes les icônes (restaurer, réduire, agrandir) de la barre de titre de la fenêtre, laissant uniquement le bouton de fermeture. Mozilla 1.2+ et Netscape 7.1 afficheront les autres commandes du menu système (dans Firefox 1.0 et Netscape 7.0x, le menu de commandes système n'est pas associé avec l'icône de Firefox/Netscape 7.0x à l'extrémité gauche de la barre de titre, il s'agit probablement d'un bug. Il est possible d'accéder au menu de commandes système avec un clic droit sur la barre de titre). Les fenêtres de dialogue sont des fenêtres qui n'ont pas d'icône de commande système de réduction ni d'agrandissement/restauration dans la barre de titre, ni dans les choix correspondants du menu de commandes système. On les appelle dialogues car leur utilisation normale est uniquement de notifier une information et d'être ensuite immédiatement fermées. Sur les systèmes Mac, les fenêtres de dialogue ont une bordure différente et peuvent prendre la forme desheets.

+
minimizable
+

Ce paramètre peut uniquement s'appliquer à des fenêtres de dialogue ; l'utilisation de « minimizable » nécessite dialog=yes. Si minimizable est défini à yes, le nouveau dialogue aura une commande système de réduction dans la barre de titre et il sera possible de le réduire dans la barre des tâches. Toute fenêtre n'étant pas un dialogue est toujours réductible, cette option y sera donc ignorée.

+
fullscreen
+

Ce paramètre ne fonctionne plus dans Internet Explorer 6 SP2 de la façon dont il le faisait dans Internet Explorer 5.x. La barre des tâches de Windows, ainsi que la barre de titre et la barre d'état de la fenêtre ne sont ni visibles, ni accessibles lorsque le mode plein écran est activé dans IE 5.x. fullscreen ennuie toujours les utilisateurs disposant d'un grand écran ou de plusieurs écrans. Obliger les autres utilisateurs à passer en plein écran avec fullscreen est également extrêmement impopulaire et est considéré comme une tentative impolie d'imposer les préférences d'affichage de l'auteur à l'utilisateur. fullscreen ne fonctionne plus vraiment dans Internet Explorer 6 SP2.

+
+ +

Fonctionnalités nécessitant des privilèges

+ +

Les fonctionnalités suivantes nécessitent le privilège UniversalBrowserWrite, autrement elles seront ignorées. Les scripts chrome bénéficient de ce privilège automatiquement, les autres doivent le demander via le PrivilegeManager.

+ +
+
chrome
+

Note : à partir de Mozilla 1.7/Firefox 0.9, cette fonctionnalité requiert le privilège UniversalBrowserWrite ({{ Bug(244965) }}). Sans ce privilège, elle est ignorée. Si définie à yes, la page est chargée en tant qu'unique contenu de la fenêtre, sans aucun autre élément de l'interface de navigation. Il n'y aura pas de menu contextuel défini par défaut, et aucun des raccourcis clavier standard ne fonctionnera. La page est supposée fournir sa propre interface utilisateur, et cette fonctionnalité est habituellement utilisée pour ouvrir des documents XUL (les dialogues standard comme la console JavaScript sont ouverts de cette façon).

+
titlebar
+

Par défaut, toutes les nouvelles fenêtres secondaires ont une barre de titre. Si défini à no, ce paramètre enlève la barre de titre de la nouvelle fenêtre secondaire. Les utilisateurs de Mozilla et Firefox peuvent obliger les nouvelles fenêtres à toujours avoir une barre de titre en positionnantdom.disable_window_open_feature.titlebar à true dans about:config ou dans leur fichier user.js.

+
alwaysRaised
+
Si défini à yes, la nouvelle fenêtre sera toujours affichée par dessus les autres fenêtres du navigateur, qu'elle soit active ou non.
+
alwaysLowered
+

Si défini à yes, la nouvelle fenêtre créé flottera par dessous sa propre fenêtre parente tant que celle-ci n'est pas réduite. Les fenêtres utilisant alwaysLowered sont souvent appelées pop-under. Celles-ci ne peuvent pas passer au dessus de leur fenêtre parente, mais celle-ci peut être réduite. Dans Netscape 6.x, les fenêtres alwaysLowered n'ont pas de commande système de réduction ni de commande système restaurer/agrandir.

+
z-lock
+
Identique à alwaysLowered.
+
close
+

Lorsque défini à no, ce paramètre supprime l'icône système de fermeture de la fenêtre, et l'élément de menu correspondant. Il fonctionnera uniquement pour les fenêtres de dialogue (avec la fonctionnalité dialog activée). close=no a précédence sur minimizable=yes.Les utilisateurs de Mozilla et Firefox peuvent obliger les nouvelles fenêtres à toujours avoir un bouton de fermeture en positionnant dom.disable_window_open_feature.close à true dans about:config ou dans leur fichier user.js.

+
+ +

Les fonctionnalités de position et de taille nécessitent d'être accompagnées d'un nombre. Les fonctionnalités de barres d'outils et de fenêtre peuvent être accompagnées de yes (oui) ou no (non) ; il est également possible d'utiliser 1 à la place de yes et 0 à la place de no. Les fonctionnalités de barres d'outils et de fenêtre acceptent aussi une forme raccourcie : vous pouvez activer une fonctionnalité en listant simplement son nom dans la chaîne strWindowFeatures. Si vous fournissez le paramètre strWindowFeatures, les fonctionnalités titlebar et close sont toujours à yes par défaut, mais les autres fonctionnalités présentant un choix yes/no seront à no par défaut et seront donc désactivées.

+ +

Exemple :

+ +
<script type="text/javascript">
+var WindowObjectReference; // variable globale
+
+function openRequestedPopup() {
+  WindowObjectReference = window.open("http://www.nomdedomaine.ext/chemin/FichierImg.png",
+        "NomDeFenetreDescriptif",
+        "width=420,height=230,resizable,scrollbars=yes,status=1");
+}
+</script>
+
+ +

Dans cet exemple, la fenêtre sera redimensionnable, elle affichera des barres de défilement si nécessaire (si le contenu dépasse les dimensions de fenêtre demandées) et affichera la barre d'état. Elle n'affichera pas la barre de menus ni la barre d'adresse. Comme l'auteur connaissait la taille de l'image (400 pixels de large et 200 pixels de haut), il a ajouté les marges appliquées à l'élément racine dans Internet Explorer 6, c'est-à-dire 15 pixels en haut, 15 pixels en bas, 10 pixels à gauche et 10 pixels à droite.

+ +

Bonnes pratiques

+ +
<script type="text/javascript">
+var WindowObjectReference = null; // variable globale
+
+function openFFPromotionPopup() {
+  if (WindowObjectReference == null || WindowObjectReference.closed) {
+    /* si le pointeur vers l'objet window n'existe pas, ou s'il existe
+       mais que la fenêtre a été fermée */
+    WindowObjectReference = window.open("http://www.spreadfirefox.com/",
+           "PromoteFirefoxWindowName", "resizable=yes,scrollbars=yes,status=yes");
+    /* alors, création du pointeur. La nouvelle fenêtre sera créée par dessus
+       toute autre fenêtre existante. */
+  }
+  else {
+    WindowObjectReference.focus();
+    /* sinon, la référence à la fenêtre existe et la fenêtre n'a pas été
+       fermée: la fenêtre est peut-être minimisée ou derrière la fenêtre
+       principale. Par conséquent, on peut l'amener par dessus les autres à
+       l'aide de la méthode focus(). Il n'est pas nécessaire de recréer la fenêtre
+       ou de recharger la ressource référencée. */
+  };
+}
+</script>
+
+(...)
+
+<p><a href="http://www.spreadfirefox.com/" target="PromoteFirefoxWindowName" onclick="openFFPromotionPopup(); return false;" title="Ce lien créera une nouvelle fenêtre ou en réutilisera une déjà ouverte">Promouvoir
+l'adoption de Firefox</a></p>
+
+ +

Le code ci-dessus résout un certain nombre de problèmes d'utilisabilité (usability ) relatif aux liens ouvrant des fenêtres secondaires. Le but du return false dans le code est d'annuler l'action par défaut du lien : si le gestionnaire d'évènements onclick est exécuté, il n'est pas nécessaire d'exécuter l'action par défaut du lien. Mais si JavaScript est désactivé ou non existant dans le navigateur de l'utilisateur, c'est l'évènement onclick qui est ignoré et le navigateur charge la ressource référencée dans le cadre ou la fenêtre portant le nom « PromoteFirefoxWindowName ». Si aucun cadre ni fenêtre ne porte ce nom, le navigateur créera une nouvelle fenêtre et l'appellera « PromoteFirefoxWindowName ».

+ +

Plus d'informations sur l'utilisation de l'attribut target :

+ +

HTML 4.01, section 16.3.2 La sémantique de cible

+ +

Comment créer un lien qui ouvre une nouvelle fenêtre?

+ +

Vous pouvez également paramétriser la fonction pour la rendre polyvalente, fonctionnelle dans plus de situations, et donc réutilisable dans d'autres scripts et pages Web :

+ +
<script type="text/javascript">
+var WindowObjectReference = null; // variable globale
+
+function openRequestedPopup(strUrl, strWindowName) {
+  if(WindowObjectReference == null || WindowObjectReference.closed) {
+    WindowObjectReference = window.open(strUrl, strWindowName,
+           "resizable=yes,scrollbars=yes,status=yes");
+  }
+  else {
+    WindowObjectReference.focus();
+  };
+}
+</script>
+(...)
+
+<p><a href="http://www.spreadfirefox.com/" target="PromoteFirefoxWindow" onclick="openRequestedPopup(this.href, this.target); return false;" title="Ce lien créera une nouvelle fenêtre ou en réutilisera une déjà ouverte">Promouvoir l'adoption de Firefox</a></p>
+
+ +

Vous pouvez également ne permettre à cette fonction que d'ouvrir une seule fenêtre secondaire et de la réutiliser pour d'autres liens de cette manière :

+ +
<script type="text/javascript">
+var WindowObjectReference = null; // variable globale
+var PreviousUrl; /* variable globale qui stockera l'URL actuellement
+                    chargée dans la fenêtre secondaire */
+
+function openRequestedSinglePopup(strUrl)
+{
+  if(WindowObjectReference == null || WindowObjectReference.closed)
+  {
+    WindowObjectReference = window.open(strUrl, "SingleSecondaryWindowName",
+           "resizable=yes,scrollbars=yes,status=yes");
+  }
+  else if(previousUrl != strUrl)
+  {
+    WindowObjectReference = window.open(strUrl, "SingleSecondaryWindowName",
+        "resizable=yes,scrollbars=yes,status=yes");
+    /* si la ressource à charger est différente, on la charge dans la fenêtre
+       secondaire déjà ouverte, et on ramène ensuite celle-ci par dessus
+       sa fenêtre parente. */
+    WindowObjectReference.focus();
+  }
+  else
+  {
+    WindowObjectReference.focus();
+  };
+  PreviousUrl = strUrl;
+  /* explication : on stocke l'URL courante afin de pouvoir la comparer
+     dans le cas d'un autre appel à cette fonction. */
+}
+</script>
+
+(...)
+
+<p><a href="http://www.spreadfirefox.com/" target="SingleSecondaryWindowName"
+onclick="openRequestedSinglePopup(this.href); return false;"
+title="Ce lien créera une nouvelle fenêtre ou en réutilisera une déjà ouverte">Promouvoir
+l'adoption de Firefox</a></p>
+<p><a href="http://www.mozilla.org/support/firefox/faq"
+target="SingleSecondaryWindowName"
+onclick="openRequestedSinglePopup(this.href); return false;"
+title="Ce lien créera une nouvelle fenêtre ou en réutilisera une déjà ouverte">FAQ
+de Firefox</a></p>
+
+ +

FAQ

+ +
+
Comment empêcher l'apparition du message de confirmation demandant à l'utilisateur s'il veut fermer la fenêtre ?
+
Vous ne pouvez pas. La règle est que les nouvelles fenêtres qui ne sont pas ouvertes par JavaScript ne peuvent pas être fermées par JavaScript. La console JavaScript dans les navigateurs basés sur Mozilla affichera le message d'avertissement suivant : "Scripts may not close windows that were not opened by script." Si c'était possible, l'historique des URL visitées durant la session de navigation serait perdu au détriment de l'utilisateur. Plus de détails sur la méthode window.close()
+
Comment ramener la fenêtre si elle est réduite ou masquée par une autre fenêtre ?
+
Vérifiez d'abord l'existence de la référence à l'objet window, et si celle-ci existe et n'a pas été fermée, utilisez la méthode focus(). Il n'y a pas d'autre manière fiable. Un exemple montrant comment utiliser la méthode focus() est présenté ci-dessus.
+
Comment forcer une fenêtre à être agrandie/maximisée ?
+
Ce n'est pas possible. Tous les fabricants de navigateurs essaient de rendre l'ouverture d'une nouvelle fenêtre visible et remarquée par les utilisateurs, afin d'éviter de les désorienter.
+
Comment désactiver le redimensionnement des fenêtres ou supprimer les barres d'outils ?
+
Il n'est pas possible de l'imposer. Les utilisateurs de navigateurs basés sur Mozilla ont un contrôle absolu sur les fonctionnalités des fenêtres comme le fait de pouvoir les redimensionner, de les faire défiler et la présence de barres d'outils via les préférences utilisateur dans about:config. Comme vos utilisateurs sont ceux qui sont supposés utiliser de telles fenêtres (et non vous en tant qu'auteur), le mieux est d'éviter d'interférer avec leurs habitudes et préférences. Il est recommandé de toujours positionner la redimensionnabilité et la présence de barres de défilement (si nécessaire) à yes pour assurer l'accessibilité au contenu et l'utilisabilité des fenêtres. Ceci est dans l'intérêt tant de l'auteur Web que de ses utilisateurs.
+
Comment redimensionner une fenêtre en fonction de son contenu ?
+

Ce n'est pas faisable de manière fiable, car les utilisateurs peuvent empêcher la fenêtre d'être redimensionnée en décochant la case Édition/Préférences/Avancé/Scripts & plugins/Autoriser les scripts à/ Déplacer ou redimensionner des fenêtres existantes dans Mozilla ou Outils/Options/Contenu/Activer JavaScript/Bouton Avancé/Déplacer ou redimensionner des fenêtres existantes dans Firefox, ou en positionnant dom.disable_window_move_resize à true dans about:config ou encore en éditant leur fichier user.js. En général, les utilisateurs désactivent le déplacement et le redimensionnement des fenêtres, étant donné qu'autoriser les scripts à le faire a été la source d'énormément d'abus dans le passé, et les rares scripts qui n'en abusent pas sont souvent incorrects dans leur manière de redimensionner la fenêtre. 99% de ces scripts désactivent le redimensionnement manuel des fenêtres et les barres de défilement alors qu'ils devraient en fait activer ces deux fonctionnalités pour permettre un mécanisme de récupération sain et circonspect dans le cas où leurs calculs s'avèreraient incorrects.

La méthode sizeToContent() de l'objet window est également désactivée si l'utilisateur décoche la préférence Déplacer ou redimensionner des fenêtres existantes. Déplacer et redimensionner une fenêtre à distance sur l'écran de l'utilisateur l'ennuiera très souvent, le désorientera, et au mieux sera incorrect. Les auteurs Web espèrent souvent avoir un contrôle absolu (et un pouvoir de décision) sur tous les aspects de positionnement et de taille des fenêtres de l'utilisateur ... ce qui n'est tout simplement pas vrai.

+
Comment ouvrir une ressource référencée par un lien dans un nouvel onglet ? ou dans un onglet spécifique ?
+
Pour l'instant, ce n'est pas possible. Seul l'utilisateur peut modifier ses préférences avancées pour faire cela. K-meleon 1.1, un navigateur basé sur Mozilla, donne un contrôle et un pouvoir complet à l'utilisateur sur la manière dont les liens sont ouverts. Certaines extensions avancées donnent également à Mozilla et Firefox un grand pouvoir concernant la manière dont les ressources référencées sont chargées. Dans quelques années, la propriété target du module CSS3 hyperlien pourrait être implémentée (si le module CSS3 Hyperlink tel qu'il existe à présent est approuvé). Même si cela se fait et lorsque cela se produira, attendez-vous à ce que les développeurs de navigateurs utilisant des onglets donnent un pouvoir de veto à l'utilisateur et un contrôle total de la façon dont les liens peuvent ouvrir des pages Web. La façon d'ouvrir un lien devrait toujours être entièrement sous le contrôle de l'utilisateur.
+
Comment savoir si une fenêtre que j'ai ouverte l'est toujours ?
+
Vous pouvez tester l'existence de la référence à l'objet window, qui est la valeur renvoyée en cas de succès de l'appel à window.open(), et vérifier ensuite que la valeur renvoyée par WindowObjectReference.closed est bien false.
+
Comment savoir si ma fenêtre a été bloquée par un bloqueur de popups ?
+
Avec les bloqueurs de popups intégrés dans Mozilla/Firefox et Internet Explorer 6 SP2, il est possible de vérifier la valeur renvoyée par window.open() : elle sera null si la fenêtre n'a pas été autorisée à s'ouvrir. Cependant, pour la plupart des autres bloqueurs de popups, il n'existe pas de manière fiable.
+
Quelle est la relation JavaScript entre la fenêtre principale et la fenêtre secondaire ?
+
La valeur renvoyée par la méthode window.open() est la propriété opener. La variable WindowObjectReference lie la fenêtre principale (opener) à la fenêtre secondaire qu'elle a ouverte, tandis que le mot-clé opener liera la fenêtre secondaire à sa fenêtre principale (celle qui a déclenché son ouverture).
+
Je n'arrive pas à accéder aux propriétés de la nouvelle fenêtre secondaire. J'obtiens toujours une erreur dans la console JavaScript disant « Erreur : uncaught exception: Permission denied to get property <property_name or method_name> ». Pourquoi cela ?
+

Ceci est causé par la restriction de sécurité des scripts entre domaines (aussi appeléeSame Origin Policy , « Politique de même origine »). Un script chargé dans une fenêtre (ou cadre) d'une origine donnée (nom de domaine) ne peut pas obtenir ou modifier des propriétés d'une autre fenêtre (ou cadre) ou les propriétés d'aucun de ses objets HTML si celle-ci provient d'une autre origine distincte (nom de domaine). C'est pourquoi, avant d'exécuter un script se référant à une fenêtre secondaire depuis la fenêtre principale, le navigateur vérifiera que la fenêtre secondaire possède le même nom de domaine. Plus d'informations à propos de la restriction de sécurité des scripts entre domaines : http://www.mozilla.org/projects/secu...me-origin.html

+
+ +

Problèmes d'utilisabilité

+ +

Évitez de recourir à window.open()

+ +

De manière générale, il est préférable d'éviter d'utiliser window.open() pour plusieurs raisons :

+ + + +

Offrez d'ouvrir un lien dans une nouvelle fenêtre, en suivant ces recommandations

+ +

Si vous voulez permettre l'ouverture d'un lien dans une nouvelle fenêtre, suivez ces règles d'utilisabilité et d'accessibilité testées et éprouvées :

+ +
N'utilisez jamais ce format de code pour les liens :
+ <a href="javascript:window.open(...)" ...>
+ +

Les liens « javascript: » sont toujours mauvais pour l'accessibilité et l'utilisabilité des pages Web dans tous les navigateurs.

+ + + +

Plus d'informations à ce sujet :

+ + + +
N'utilisez jamais <a href="#" onclick="window.open(...);">
+ +

Un tel pseudo-lien met également en péril l'accessibilité des liens. Utilisez toujours une véritable URL pour la valeur de l'attribut href, afin que si JavaScript s'avère désactivé ou absent, ou si le navigateur ne peut pas ouvrir de fenêtre secondaire (comme Microsoft Web TV, les navigateurs en mode texte, etc.), de tels navigateurs pourront toujours charger la référence référencée dans leur mode de chargement/gestion de nouvelles ressources par défaut. Cette forme de code interfère également avec les fonctionnalités avancées de navigation par onglets de certains navigateurs, comme le clic du milieu et les raccourcis Ctrl+clic et Ctrl+Entrée sur les liens, les « mouse gestures », etc.

+ +
Identifiez toujours les liens qui créeront (ou réutiliseront) une nouvelle fenêtre secondaire
+ +

Identifiez les liens qui ouvriront de nouvelles fenêtre de manière à aider les utilisateurs en utilisant l'attribut title du lien, en ajoutant une icône à la fin du lien, ou en modifiant le curseur de la souris.

+ +

Le but est d'avertir les utilisateurs à l'avance des changements de contexte pour réduire la confusion de leur part : changer la fenêtre courante ou afficher subitement une nouvelle fenêtre peut être très désorientant pour certains utilisateurs (le bouton Précédent devient inutilisable).

+ +
+

« Souvent, les utilisateurs ne remarquent pas qu'une nouvelle fenêtre s'est ouverte, particulièrement si ils utilisent un petit écran où les fenêtres sont agrandies pour utiliser toute la surface de l'écran. Ainsi, l'utilisateur voulant retourner à la page initiale sera dérouté par un boutonPrécédente grisé. »
+ citation de The Top TenNew Mistakes of Web Design: 2. Opening New Browser Windows, Jakob Nielsen, mai 1999

+
+ +

Lorsque des changements complets de contexte sont identifiés explicitement avant qu'ils se produisent, l'utilisateur peut déterminer s'il désire le faire ou s'y préparer : non seulement il ne sera pas perturbé ni désorienté, mais des utilisateurs plus expérimentés pourront eux-mêmes décider comment ouvrir de tels liens (dans une nouvelle fenêtre ou non, dans la même fenêtre, dans un nouvel onglet ou non, en arrière-plan ou non).

+ +

Références

+ + + +
Utilisez toujours l'attribut target
+ +

Si JavaScript est désactivé ou absent, le navigateur créera une fenêtre secondaire ou affichera la ressource demandée selon sa gestion habituelle de l'attribut target : par exemple certains navigateurs ne pouvant pas créer de nouvelles fenêtres comme Microsoft Web TV, chargeront la ressource demandée et l'ajouteront à la fin du document courant. Le but et l'idée est d'essayer de fournir — sans l'imposer — à l'utilisateur une manière d'ouvrir la ressource référencée, de suivre le lien. Votre code ne doit pas interférer avec les fonctionnalités du navigateur à disposition de l'utilisateur, et doit toujours lui laisser le chemin libre et le choix de la décision finale.

+ +
N'utilisez pas target="_blank"
+ +

Fournissez toujours un nom significatif dans votre attribut target, et essayez de le réutiliser dans votre page afin qu'un clic sur un autre lien puisse charger la ressource dans une fenêtre déjà utilisée (ce qui rend l'opération beaucoup plus rapide pour l'utilisateur), ce qui justifie la raison (et les ressources système, et le temps dépensé) d'avoir créé une fenêtre secondaire. Utiliser une seule cible et la réutiliser pour plusieurs liens est bien moins gourmand en matière de ressources puisqu'une seule fenêtre est créée et recyclée. D'un autre côté, utiliser « _blank » comme attribut target créera plusieurs nouvelles fenêtre anonymes sur le bureau de l'utilisateur qui ne peuvent ni être recyclées ni réutilisées.

+ +

Dans tous les cas, si votre code est bien fait, il ne devrait pas interférer avec le choix final de l'utilisateur mais lui offrira plutôt des choix supplémentaires, plus de façons d'ouvrir les liens et plus de pouvoir sur l'outil qu'il utilise (son navigateur).

+ +

Glossaire

+ +
+
Fenêtre ouvrante, opener, fenêtre parente, fenêtre principale, première fenêtre
+
Termes souvent utilisés pour décrire ou identifier la même fenêtre. Il s'agit de la fenêtre depuis laquelle une nouvelle fenêtre sera créée. C'est la fenêtre dans laquelle l'utilisateur clique sur un lien qui mène à la création d'une autre, nouvelle fenêtre.
+
Sous-fenêtre, fenêtre enfant, fenêtre secondaire, deuxième fenêtre
+
Termes souvent utilisés pour décrire ou identifier la même fenêtre. C'est la nouvelle fenêtre qui a été créée.
+
Fenêtres popup non sollicitées
+
Ouverture automatique de fenêtres initiée par un script sans le consentement de l'utilisateur.
+
+ +

Spécification

+ +

{{ DOM0() }} window.open() ne fait partie d'aucune spécification ou recommandation technique du W3C.

+ +

Notes

+ +

Note sur les priorités

+ +

Dans les cas où left et screenX (et/ou top et screenY) ont des valeurs contradictoires, left et top ont priorité sur screenX et screenY respectivement. Si left et screenX (et/ou top et screenY) sont définies dans la liste strWindowFeatures, les valeurs left (et/ou top) seront reconnues et utilisées. Dans l'exemple suivant, la nouvelle fenêtre sera positionnée à 100 pixels du bord gauche de la zone de travail des applications du système d'exploitation de l'utilisateur, et non à 200 pixels.

+ +
<script type="text/javascript">
+WindowObjectReference = window.open("http://www.lemonde.fr/",
+           "NomDeLaFenetreLeMonde",
+           "left=100,screenX=200,resizable,scrollbars,status");
+</script>
+
+ +

Si left est défini, mais que top n'a aucune valeur mais que screenY en a une, left et screenY seront les coordonnées de positionnement de la fenêtre secondaire.

+ +

outerWidth a priorité sur width, et width a priorité sur innerWidth. outerHeight a priorité sur height et height a priorité sur innerHeight. Dans l'exemple suivant, les navigateurs basés sur Mozilla créeront une nouvelle fenêtre avec une taille extérieure (outerWidth) de 600 pixels de large et ignoreront la requête d'une largeur (width) de 500 pixels ainsi que celle d'une taille intérieure (innerWidth) de 400 pixels.

+ +
<script type="text/javascript">
+WindowObjectReference = window.open("http://www.wwf.org/",
+           "NomDeLaFenetreWWF",
+           "outerWidth=600,width=500,innerWidth=400,resizable,scrollbars,status");
+</script>
+
+ +

Note sur les corrections d'erreurs de position et de dimension

+ +

Les positions et dimensions demandées dans la liste strWindowFeatures ne seront pas respectées et seront corrigées si n'importe laquelle de ces valeurs ne permet pas à la fenêtre complète d'être affichée dans la zone de travail des applications du système d'exploitation de l'utilisateur. Aucune partie de la nouvelle fenêtre ne peut être initialement positionnée hors de l'écran. Ceci est le réglage par défaut de tous les navigateurs basés sur Mozilla.

+ +

Internet Explorer 6 SP2 dispose d'un mécanisme de correction d'erreur similaire, mais celui-ci n'est pas activé par défaut pour tous les niveaux de sécurité : un niveau de sécurité trop bas peut désactiver ce mécanisme de correction d'erreurs.

+ +

Note sur les barres de défilement

+ +

Lorsque le contenu dépasse les dimensions de la zone de visualisation de la fenêtre, des barres de défilement (ou un mécanisme de définement similaire) sont nécessaires pour s'assurer que les utilisateurs puissent accéder au contenu. Le contenu ou la boîte du document d'une page web peut outrepasser, excéder les dimensions demandées pour la fenêtre pour plusieurs raisons qui sont hors du contrôle des auteurs Web :

+ + + +

Note sur la barre d'état

+ +

Vous devez vous attendre à ce qu'une large majorité des navigateurs affichent la barre d'état, ou qu'une large majorité des utilisateurs voudront forcer sa présence : le mieux est de toujours positionner cette fonctionnalité à yes. De plus, si vous demandez spécifiquement de retirer la barre d'état, les utilisateurs de Firefox ne pourront plus utilser la barre de navigation de site si elle est installée. Dans Mozilla et dans Firefox, toutes les fenêtres peuvent être redimensionnées à partir de la zone inférieure droite de la barre d'état. Celle-ci fournit également des informations sur la connexion http, l'emplacement des ressources hypertextes, la barre de progression du téléchargement, l'icône de chiffrement/connexion sécurisée avec SSL (affichant une icône de cadenas jaune), des icônes de zones de sécurité, de politique de sécurité en matière de cookies, etc. Enlever la barre d'état retire souvent de très nombreuses fonctionnalités et informations considérées comme utiles (et parfois vitales) par les utilisateurs.

+ +

Note sur les problèmes de sécurité liés à la présence de la barre d'état

+ +

Dans Internet Explorer 6 pour XP SP2, pour les fenêtres ouvertes à l'aide de window.open() :

+ +
+

« Pour les fenêtres ouvertes à l'aide de window.open() :
+ Attendez-vous à ce que la barre d'état soit présente, et codez en conséquence. La barre d'état sera activée par défaut et fait entre 20 et 25 pixels de haut. (...) »
+ citation de Fine-Tune Your Web Site for Windows XP Service Pack 2, Browser Window Restrictions in XP SP2

+
+ +
+

« (...) les fenêtres créées à l'aide de la méthode window.open() peuvent être appelées par des scripts et utilisées pour imiter une fausse interface utilisateur ou bureau, ou pour masquer des informations ou des activités malveillantes en dimensionnant la fenêtre de manière à rendre la barre d'état invisible.
+ Les fenêtres d'Internet Explorer fournissent des informations de sécurité visibles par l'utilisateur pour l'aider à identifier avec certitude la source de la page et le niveau de sécurité de la communication avec cette page. Lorsque ces éléments ne sont pas visibles, les utilisateurs peuvent penser qu'ils sont sur une page plus digne de confiance ou interagissent avec un processus système alors qu'il sont en train d'interagir avec un hôte malveillant. (...)
+ Les fenêtres lancées par des scripts seront affichées entièrement, avec la barre de titre d'Internet Explorer et sa barre d'état. (...)
+ Gestion de la barre d'état d'Internet Explorer par les scripts
+ Description détaillée
+ Internet Explorer a été modifié pour ne désactiver la barre d'état pour aucune fenêtre. La barre d'état est toujours visible pour toutes les fenêtres d'Internet Explorer. (...) Sans ce changement, les fenêtres créées à l'aide de la méthode window.open() peuvent être appelées par des scripts et imiter une fausse interface utilisateur ou bureau, ou pour masquer des informations importantes pour l'utilisateur.
+ La barre d'état est une fonction de sécurité des fenêtres d'Internet Explorer qui fournissent à l'utilisateur des informations sur les zones de sécurité. Cette zone ne peut pas être imitée (...)"
+ citation de Changes to Functionality in Microsoft Windows XP Service Pack 2, Internet Explorer Window Restrictions

+
+ +

Note sur le plein écran (fullscreen)

+ +

Dans Internet Explorer 6 pour XP SP2 :

+ + + +

Références :

+ + + +

Note sur la différence entre outerHeight et height

+ + +

Tutoriels

+ +

en français :

+ +

Créer des pop-up intelligentes par Fabrice Bonny, OpenWeb

+ +

en anglais :

+ +

JavaScript windows (tutorial) par Lasse Reichstein Nielsen

+ +

The perfect pop-up (tutorial) par Ian Lloyd

+ +

Popup windows and Firefox (interactive demos) par Gérard Talbot

+ +

Références

+ +

Links Want To Be Links by Jukka K. Korpela

+ +

Links & JavaScript Living Together in Harmony by Jeff Howden

diff --git a/files/fr/web/api/window/opendialog/index.html b/files/fr/web/api/window/opendialog/index.html deleted file mode 100644 index 7449c15b30..0000000000 --- a/files/fr/web/api/window/opendialog/index.html +++ /dev/null @@ -1,102 +0,0 @@ ---- -title: window.openDialog -slug: Web/API/Window/openDialog -tags: - - DOM - - Gecko - - Window - - boîte de dialogue -translation_of: Web/API/Window/openDialog ---- -

{{ ApiRef() }}

- -

window.openDialog est une extension à window.open(). Elle s'utilise de la même manière, excepté qu'elle peut prendre plusieurs paramètres optionnels aprèswindowFeatures, et quewindowFeatures est traîté différemment.

- -

Les paramètres optionnels, si présents, seront regroupés dans un objet JavaScript Array et seront accessibles depuis la nouvelle fenêtre par la propriété window.arguments. Ils sont accessibles depuis les scripts de la fenêtre à tout moment, notamment lors du traitement d'un évênementload . Ces paramètres peuvent donc être utilisés pour passer des arguments à une boîte de dialogue, et pour les récupérer ensuite.

- -

Notez que l'appel à la méthodeopenDialog() se termine immédiatement. Si vous souhaitez le bloquer jusqu'à ce que l'utilisateur ferme la boîte de dialogue, utilisez la valeurmodal pour le paramètre features. En conséquence, l'utilisateur ne pourra pas interagir avec la fenêtre parente jusqu'à ce qu'il ferme la boîte de dialogue modale.

- -

Syntaxe

- -
newWindow = openDialog(url, name, features, arg1, arg2, ...)
-
- -
-
newWindow
-
La nouvelle fenêtre ouverte.
-
url
-
L'URL du document à charger dans la nouvelle fenêtre.
-
name
-
Le nom de la fenêtre (optionnel). Voir la description dewindow.open() pour plus de détails.
-
features
-
Voir la description dewindow.open() pour la description.
-
arg1, arg2, ...
-
Les arguments à passer à la nouvelle fenêtre (optionnel).
-
- -

Exemple

- -
var win = openDialog("http://example.tld/zzz.xul", "dlg", "", "pizza", 6.98);
- -

Notes

- -

Nouvelles fonctionnalités

- -
-
all
-
Active ou désactive ("all=no") toutes les fonctionnalités (excepté chrome, dialog etmodal). Peut être utilisé conjointement avec les autres drapeaux (par exemple, "menubar=no, all" active toutes les fonctionnalités excepté menubar). Ce drapeau est ignorée par la méthodewindow.open() mais pas par window.openDialog().
-
- -

Comportement

- -

La méthodewindow.openDialog() traite l'absence du paramètrefeatures de la même manière quewindow.open() (une chaîne vide désactive toutes les fonctionnalités) excepté pourchrome etdialog qui sont activés par défaut et peuvent être explicitement désactivées par "chrome=no".

- -

Passage de paramètres supplémentaires

- -

Pour passer des paramètres supplémentaires à la boîte de dialogue, vous pouvez simplement les ajouter après le paramètre features :

- -
openDialog("http://example.tld/zzz.xul", "dlg", "", "pizza", 6.98);
- -

Ces paramètres seront ensuite regroupés dans une propriété arguments de typeArray, et cette propriété sera ajoutée à la nouvelle boîte de dialogue.

- -

Pour accéder à ces paramètres depuis un script de la boîte de dialogue, utilisez le procédé suivant :

- -
var food = window.arguments[0];
-var price = window.arguments[1];
- -

Notez que vous pouvez accéder à cette propriété depuis n'importe où dans le script. (Autre exemple).

- -

Retourner des arguments depuis la boîte de dialogue

- -

Depuis quewindow.close() efface toutes les propriétés associées à la boîte de dialogue (c'est-à-dire les variables spécifiées depuis le code JavaScript chargé depuis la boîte de dialogue), il n'est pas possible de retourner des valeur après la fermeture de la boîte de dialogue en utilisant des variables globales (ou toute autre méthode).

- -

Pour pouvoir retourner des valeurs à la fenêtre parente, vous devez passer un objet via les paramètres supplémentaires. Vous pouvez ensuite accéder à cet objet depuis la boîte de dialogue et modifier ces propriétés, dont les données que vous souhaiter conserver après l'appel à la méthodewindow.close().

- -
var retVals = { address: null, delivery: null };
-openDialog("http://example.tld/zzz.xul", "dlg", "modal", "pizza", 6.98, retVals);
- -

Si vous modifiez les propriétés de l'objetretVals depuis la boîte de dialogue comme décrit précédemment, vous pouvez y accéder via le tableauretVals après l'appel à openDialog().

- -

Depuis la boîte de dialogue, vous pouvez modifier les propriétés comme suit :

- -
var retVals = window.arguments[2];
-retVals.address = enteredAddress;
-retVals.delivery = "immediate";
- -

Voir aussice message. (Autre exemple).
- Voir aussiwindow.importDialog().

- -

Spécification

- -

{{ DOM0() }}

- -

Compatibilité des navigateurs

- -

{{Compat("api.Window.openDialog")}}

- -

Voir également

- - \ No newline at end of file diff --git a/files/fr/web/api/window/opendialog/index.md b/files/fr/web/api/window/opendialog/index.md new file mode 100644 index 0000000000..7449c15b30 --- /dev/null +++ b/files/fr/web/api/window/opendialog/index.md @@ -0,0 +1,102 @@ +--- +title: window.openDialog +slug: Web/API/Window/openDialog +tags: + - DOM + - Gecko + - Window + - boîte de dialogue +translation_of: Web/API/Window/openDialog +--- +

{{ ApiRef() }}

+ +

window.openDialog est une extension à window.open(). Elle s'utilise de la même manière, excepté qu'elle peut prendre plusieurs paramètres optionnels aprèswindowFeatures, et quewindowFeatures est traîté différemment.

+ +

Les paramètres optionnels, si présents, seront regroupés dans un objet JavaScript Array et seront accessibles depuis la nouvelle fenêtre par la propriété window.arguments. Ils sont accessibles depuis les scripts de la fenêtre à tout moment, notamment lors du traitement d'un évênementload . Ces paramètres peuvent donc être utilisés pour passer des arguments à une boîte de dialogue, et pour les récupérer ensuite.

+ +

Notez que l'appel à la méthodeopenDialog() se termine immédiatement. Si vous souhaitez le bloquer jusqu'à ce que l'utilisateur ferme la boîte de dialogue, utilisez la valeurmodal pour le paramètre features. En conséquence, l'utilisateur ne pourra pas interagir avec la fenêtre parente jusqu'à ce qu'il ferme la boîte de dialogue modale.

+ +

Syntaxe

+ +
newWindow = openDialog(url, name, features, arg1, arg2, ...)
+
+ +
+
newWindow
+
La nouvelle fenêtre ouverte.
+
url
+
L'URL du document à charger dans la nouvelle fenêtre.
+
name
+
Le nom de la fenêtre (optionnel). Voir la description dewindow.open() pour plus de détails.
+
features
+
Voir la description dewindow.open() pour la description.
+
arg1, arg2, ...
+
Les arguments à passer à la nouvelle fenêtre (optionnel).
+
+ +

Exemple

+ +
var win = openDialog("http://example.tld/zzz.xul", "dlg", "", "pizza", 6.98);
+ +

Notes

+ +

Nouvelles fonctionnalités

+ +
+
all
+
Active ou désactive ("all=no") toutes les fonctionnalités (excepté chrome, dialog etmodal). Peut être utilisé conjointement avec les autres drapeaux (par exemple, "menubar=no, all" active toutes les fonctionnalités excepté menubar). Ce drapeau est ignorée par la méthodewindow.open() mais pas par window.openDialog().
+
+ +

Comportement

+ +

La méthodewindow.openDialog() traite l'absence du paramètrefeatures de la même manière quewindow.open() (une chaîne vide désactive toutes les fonctionnalités) excepté pourchrome etdialog qui sont activés par défaut et peuvent être explicitement désactivées par "chrome=no".

+ +

Passage de paramètres supplémentaires

+ +

Pour passer des paramètres supplémentaires à la boîte de dialogue, vous pouvez simplement les ajouter après le paramètre features :

+ +
openDialog("http://example.tld/zzz.xul", "dlg", "", "pizza", 6.98);
+ +

Ces paramètres seront ensuite regroupés dans une propriété arguments de typeArray, et cette propriété sera ajoutée à la nouvelle boîte de dialogue.

+ +

Pour accéder à ces paramètres depuis un script de la boîte de dialogue, utilisez le procédé suivant :

+ +
var food = window.arguments[0];
+var price = window.arguments[1];
+ +

Notez que vous pouvez accéder à cette propriété depuis n'importe où dans le script. (Autre exemple).

+ +

Retourner des arguments depuis la boîte de dialogue

+ +

Depuis quewindow.close() efface toutes les propriétés associées à la boîte de dialogue (c'est-à-dire les variables spécifiées depuis le code JavaScript chargé depuis la boîte de dialogue), il n'est pas possible de retourner des valeur après la fermeture de la boîte de dialogue en utilisant des variables globales (ou toute autre méthode).

+ +

Pour pouvoir retourner des valeurs à la fenêtre parente, vous devez passer un objet via les paramètres supplémentaires. Vous pouvez ensuite accéder à cet objet depuis la boîte de dialogue et modifier ces propriétés, dont les données que vous souhaiter conserver après l'appel à la méthodewindow.close().

+ +
var retVals = { address: null, delivery: null };
+openDialog("http://example.tld/zzz.xul", "dlg", "modal", "pizza", 6.98, retVals);
+ +

Si vous modifiez les propriétés de l'objetretVals depuis la boîte de dialogue comme décrit précédemment, vous pouvez y accéder via le tableauretVals après l'appel à openDialog().

+ +

Depuis la boîte de dialogue, vous pouvez modifier les propriétés comme suit :

+ +
var retVals = window.arguments[2];
+retVals.address = enteredAddress;
+retVals.delivery = "immediate";
+ +

Voir aussice message. (Autre exemple).
+ Voir aussiwindow.importDialog().

+ +

Spécification

+ +

{{ DOM0() }}

+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Window.openDialog")}}

+ +

Voir également

+ + \ No newline at end of file diff --git a/files/fr/web/api/window/opener/index.html b/files/fr/web/api/window/opener/index.html deleted file mode 100644 index d1dd3486ce..0000000000 --- a/files/fr/web/api/window/opener/index.html +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: window.opener -slug: Web/API/Window/opener -tags: - - DOM - - DOM_0 - - Référence_du_DOM_Gecko -translation_of: Web/API/Window/opener ---- -

{{ ApiRef() }}

-

Résumé

-

Renvoie une référence vers la fenêtre qui a ouvert la fenêtre courante.

-

Syntaxe

-
refObj = window.opener
-
-

Exemple

-
 if window.opener != indexWin {
-     referToTop(window.opener);
- }
-
-

Notes

-

Lorsqu'une fenêtre est ouverte depuis une autre fenêtre, elle conserve une référence à cette première fenêtre dans window.opener. Si la fenêtre courante n'a pas été ouverte par une autre fenêtre, la méthode renvoie null.

-

Spécification

-

{{ DOM0() }}

\ No newline at end of file diff --git a/files/fr/web/api/window/opener/index.md b/files/fr/web/api/window/opener/index.md new file mode 100644 index 0000000000..d1dd3486ce --- /dev/null +++ b/files/fr/web/api/window/opener/index.md @@ -0,0 +1,24 @@ +--- +title: window.opener +slug: Web/API/Window/opener +tags: + - DOM + - DOM_0 + - Référence_du_DOM_Gecko +translation_of: Web/API/Window/opener +--- +

{{ ApiRef() }}

+

Résumé

+

Renvoie une référence vers la fenêtre qui a ouvert la fenêtre courante.

+

Syntaxe

+
refObj = window.opener
+
+

Exemple

+
 if window.opener != indexWin {
+     referToTop(window.opener);
+ }
+
+

Notes

+

Lorsqu'une fenêtre est ouverte depuis une autre fenêtre, elle conserve une référence à cette première fenêtre dans window.opener. Si la fenêtre courante n'a pas été ouverte par une autre fenêtre, la méthode renvoie null.

+

Spécification

+

{{ DOM0() }}

\ No newline at end of file diff --git a/files/fr/web/api/window/orientation/index.html b/files/fr/web/api/window/orientation/index.html deleted file mode 100644 index dfe5477598..0000000000 --- a/files/fr/web/api/window/orientation/index.html +++ /dev/null @@ -1,35 +0,0 @@ ---- -title: Window.orientation -slug: Web/API/Window/orientation -translation_of: Web/API/Window/orientation ---- -
{{APIRef}}{{deprecated_header}}
- -

Résumé

- -

Renvoie l'orientation en degrés (par incréments de 90 degrés) de la fenêtre par rapport à l'orientation naturelle de l'appareil.

- -

Les seules valeurs possibles sont -90, 0, 90, et 180. Les valeurs positives sont dans le sens des aiguilles d'une montre; les valeurs négatives sont dans le sens antihoraire.

- -

Spécifications

- - - - - - - - - - - - - - - - -
SpécificationStatutCommentaires
{{SpecName('Compat', '#dom-window-orientation', 'Window.orientation')}}{{Spec2('Compat')}}
- -

Compatibilité des navigateurs

- -

{{Compat("api.Window.orientation")}}

diff --git a/files/fr/web/api/window/orientation/index.md b/files/fr/web/api/window/orientation/index.md new file mode 100644 index 0000000000..dfe5477598 --- /dev/null +++ b/files/fr/web/api/window/orientation/index.md @@ -0,0 +1,35 @@ +--- +title: Window.orientation +slug: Web/API/Window/orientation +translation_of: Web/API/Window/orientation +--- +
{{APIRef}}{{deprecated_header}}
+ +

Résumé

+ +

Renvoie l'orientation en degrés (par incréments de 90 degrés) de la fenêtre par rapport à l'orientation naturelle de l'appareil.

+ +

Les seules valeurs possibles sont -90, 0, 90, et 180. Les valeurs positives sont dans le sens des aiguilles d'une montre; les valeurs négatives sont dans le sens antihoraire.

+ +

Spécifications

+ + + + + + + + + + + + + + + + +
SpécificationStatutCommentaires
{{SpecName('Compat', '#dom-window-orientation', 'Window.orientation')}}{{Spec2('Compat')}}
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Window.orientation")}}

diff --git a/files/fr/web/api/window/outerheight/index.html b/files/fr/web/api/window/outerheight/index.html deleted file mode 100644 index 53b6f0637a..0000000000 --- a/files/fr/web/api/window/outerheight/index.html +++ /dev/null @@ -1,62 +0,0 @@ ---- -title: Window.outerHeight -slug: Web/API/Window/outerHeight -translation_of: Web/API/Window/outerHeight ---- -
{{APIRef}}
- -

Window.outerHeight retourne la hauteur de la fenêtre (du navigateur) en pixels. La hauteur retournée prends en compte la fenêtre du navigateur entier, y compris la barre latérale, window chrome and window resizing borders/handles.

- -

Cette propriété n'a pas de valeur par défaut.

- -

Syntaxe

- -
outWindowHeight = window.outerHeight;
-
- -

La valeur retournée correspond à la hauteur extérieure de la fenêtre.

- -

Notes

- -

Pour changer la taille de la fenêtre, utilisez {{domxref("window.resizeBy()")}} et {{domxref("window.resizeTo()")}}.

- -

Pour obtenir la hauteur intérieure de la fenêtre (la hauteur de la page actuelle), utilisez {{domxref("window.innerHeight")}}.

- -

Exemple illustré

- -

La figure suivante montre la différence entre outerHeight et innerHeight.

- -

innerHeight vs outerHeight illustration

- -

Spécifications

- - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{ SpecName('CSSOM View', '#dom-window-outerheight', 'Window.outerHeight') }}{{ Spec2('CSSOM View') }}
- -

Compatibilité des navigateurs

- -

{{Compat("api.Window.outerHeight")}}

- -

Voir aussi

- - diff --git a/files/fr/web/api/window/outerheight/index.md b/files/fr/web/api/window/outerheight/index.md new file mode 100644 index 0000000000..53b6f0637a --- /dev/null +++ b/files/fr/web/api/window/outerheight/index.md @@ -0,0 +1,62 @@ +--- +title: Window.outerHeight +slug: Web/API/Window/outerHeight +translation_of: Web/API/Window/outerHeight +--- +
{{APIRef}}
+ +

Window.outerHeight retourne la hauteur de la fenêtre (du navigateur) en pixels. La hauteur retournée prends en compte la fenêtre du navigateur entier, y compris la barre latérale, window chrome and window resizing borders/handles.

+ +

Cette propriété n'a pas de valeur par défaut.

+ +

Syntaxe

+ +
outWindowHeight = window.outerHeight;
+
+ +

La valeur retournée correspond à la hauteur extérieure de la fenêtre.

+ +

Notes

+ +

Pour changer la taille de la fenêtre, utilisez {{domxref("window.resizeBy()")}} et {{domxref("window.resizeTo()")}}.

+ +

Pour obtenir la hauteur intérieure de la fenêtre (la hauteur de la page actuelle), utilisez {{domxref("window.innerHeight")}}.

+ +

Exemple illustré

+ +

La figure suivante montre la différence entre outerHeight et innerHeight.

+ +

innerHeight vs outerHeight illustration

+ +

Spécifications

+ + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{ SpecName('CSSOM View', '#dom-window-outerheight', 'Window.outerHeight') }}{{ Spec2('CSSOM View') }}
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Window.outerHeight")}}

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/window/outerwidth/index.html b/files/fr/web/api/window/outerwidth/index.html deleted file mode 100644 index 863a26a3ab..0000000000 --- a/files/fr/web/api/window/outerwidth/index.html +++ /dev/null @@ -1,59 +0,0 @@ ---- -title: Window.outerWidth -slug: Web/API/Window/outerWidth -tags: - - API - - CSSOM View - - NeedsContent - - Property - - Reference -translation_of: Web/API/Window/outerWidth ---- -
{{APIRef}}
- -

Window.outerWidth récupère la largeur de l'extérieur de la fenêtre du navigateur. Elle représente la largeur de toute la fenêtre du navigateur, y compris la barre latérale (si elle est agrandie), la fenêtre chrome et le redimensionnement de la fenêtre.

- -

Cette propriété est en lecture seule ; elle n'a pas de valeur par défaut.

- -

Syntaxe

- -
largeurExterieureFenetre = window.outerWidth;
-
- -

Lors du retour, largeurExterieureFenetre vaut la largeur de l'extérieur de la fenêtre.

- -

Notes

- -

Pour changer la taille d'une fenêtre, voir {{domxref("window.resizeBy()")}} et {{domxref("window.resizeTo ()")}}.

- -

Pour récupérer la largeur interne d'une fenêtre, c'est-à-dire la largeur de la page affichée, voir {{domxref ("window.innerWidth")}}.

- -

Spécifications

- - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{ SpecName('CSSOM View', '#dom-window-outerwidth', 'Window.outerWidth') }}{{ Spec2('CSSOM View') }}Définition initiale.
- -

Compatibilité des navigateurs

- -

{{Compat("api.Window.outerWidth")}}

- -

Voir aussi

- - diff --git a/files/fr/web/api/window/outerwidth/index.md b/files/fr/web/api/window/outerwidth/index.md new file mode 100644 index 0000000000..863a26a3ab --- /dev/null +++ b/files/fr/web/api/window/outerwidth/index.md @@ -0,0 +1,59 @@ +--- +title: Window.outerWidth +slug: Web/API/Window/outerWidth +tags: + - API + - CSSOM View + - NeedsContent + - Property + - Reference +translation_of: Web/API/Window/outerWidth +--- +
{{APIRef}}
+ +

Window.outerWidth récupère la largeur de l'extérieur de la fenêtre du navigateur. Elle représente la largeur de toute la fenêtre du navigateur, y compris la barre latérale (si elle est agrandie), la fenêtre chrome et le redimensionnement de la fenêtre.

+ +

Cette propriété est en lecture seule ; elle n'a pas de valeur par défaut.

+ +

Syntaxe

+ +
largeurExterieureFenetre = window.outerWidth;
+
+ +

Lors du retour, largeurExterieureFenetre vaut la largeur de l'extérieur de la fenêtre.

+ +

Notes

+ +

Pour changer la taille d'une fenêtre, voir {{domxref("window.resizeBy()")}} et {{domxref("window.resizeTo ()")}}.

+ +

Pour récupérer la largeur interne d'une fenêtre, c'est-à-dire la largeur de la page affichée, voir {{domxref ("window.innerWidth")}}.

+ +

Spécifications

+ + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{ SpecName('CSSOM View', '#dom-window-outerwidth', 'Window.outerWidth') }}{{ Spec2('CSSOM View') }}Définition initiale.
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Window.outerWidth")}}

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/window/pagehide_event/index.html b/files/fr/web/api/window/pagehide_event/index.html deleted file mode 100644 index 81e2c695f8..0000000000 --- a/files/fr/web/api/window/pagehide_event/index.html +++ /dev/null @@ -1,70 +0,0 @@ ---- -title: pagehide -slug: Web/API/Window/pagehide_event -translation_of: Web/API/Window/pagehide_event -original_slug: Web/Events/pagehide ---- -

L’évènement pagehide est émis lorsqu’une entrée dans un historique de session est sur le point d’être quittée.

- -

Informations générales

- -
-
Spécification
-
HTML5
-
Interface
-
PageTransitionEvent
-
Bouillonne
-
Non
-
Annulable
-
Non
-
Cible
-
Document (dispatché sur Window)
-
Action par défaut
-
Aucune
-
- -

Propriétés

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
PropriétéTypeDescription
target {{readonlyInline}}{{domxref("EventTarget")}}La cible de l’évènement (la plus haute dans l’arbre DOM).
type {{readonlyInline}}{{domxref("DOMString")}}Le type d’évènement.
bubbles {{readonlyInline}}{{jsxref("Boolean")}}Si l’évènement bouillonne en temps normal ou non.
cancelable {{readonlyInline}}{{jsxref("Boolean")}}Si l’évènement est annulable ou non.
persisted {{readonlyInline}}{{jsxref("boolean")}}Si l’entrée est chargée depuis le cache ou non.
- -

Évènements liés

- - diff --git a/files/fr/web/api/window/pagehide_event/index.md b/files/fr/web/api/window/pagehide_event/index.md new file mode 100644 index 0000000000..81e2c695f8 --- /dev/null +++ b/files/fr/web/api/window/pagehide_event/index.md @@ -0,0 +1,70 @@ +--- +title: pagehide +slug: Web/API/Window/pagehide_event +translation_of: Web/API/Window/pagehide_event +original_slug: Web/Events/pagehide +--- +

L’évènement pagehide est émis lorsqu’une entrée dans un historique de session est sur le point d’être quittée.

+ +

Informations générales

+ +
+
Spécification
+
HTML5
+
Interface
+
PageTransitionEvent
+
Bouillonne
+
Non
+
Annulable
+
Non
+
Cible
+
Document (dispatché sur Window)
+
Action par défaut
+
Aucune
+
+ +

Propriétés

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
PropriétéTypeDescription
target {{readonlyInline}}{{domxref("EventTarget")}}La cible de l’évènement (la plus haute dans l’arbre DOM).
type {{readonlyInline}}{{domxref("DOMString")}}Le type d’évènement.
bubbles {{readonlyInline}}{{jsxref("Boolean")}}Si l’évènement bouillonne en temps normal ou non.
cancelable {{readonlyInline}}{{jsxref("Boolean")}}Si l’évènement est annulable ou non.
persisted {{readonlyInline}}{{jsxref("boolean")}}Si l’entrée est chargée depuis le cache ou non.
+ +

Évènements liés

+ + diff --git a/files/fr/web/api/window/pageshow_event/index.html b/files/fr/web/api/window/pageshow_event/index.html deleted file mode 100644 index 4687409333..0000000000 --- a/files/fr/web/api/window/pageshow_event/index.html +++ /dev/null @@ -1,110 +0,0 @@ ---- -title: pageshow -slug: Web/API/Window/pageshow_event -translation_of: Web/API/Window/pageshow_event -original_slug: Web/Events/pageshow ---- -

L’évènement pageshow est émis lorsqu’une entrée dans un historique de session est atteinte (cela comprend les boutons précédent / suivant ainsi que l’affichage initial de la page après l’évènement onload).

- -

Informations générales

- -
-
Spécification
-
HTML5
-
Interface
-
PageTransitionEvent
-
Bouillonne
-
Non
-
Annulable
-
Non
-
Cible
-
Document (dispatché sur Window)
-
Action par défaut
-
Aucune
-
- -

Propriétés

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
PropriétéTypeDescription
target {{readonlyInline}}{{domxref("EventTarget")}}La cible de l’évènement (la plus haute dans l’arbre DOM).
type {{readonlyInline}}{{domxref("DOMString")}}Le type d’évènement.
bubbles {{readonlyInline}}{{jsxref("Boolean")}}Si l’évènement bouillonne en temps normal ou non.
cancelable {{readonlyInline}}{{jsxref("Boolean")}}Si l’évènement est annulable ou non.
persisted {{readonlyInline}}{{jsxref("boolean")}}Si l’entrée est chargée depuis le cache ou non.
- -

Exemples

- -

L’exemple suivant va afficher dans la console des informations sur l’évènement pageshow, qui est émis à l’utilisation des boutons précédent / suivant, et pas uniquement après onload :

- -
window.addEventListener('pageshow', function(event) {
-    console.log('pageshow:');
-    console.log(event);
-});
- -

Bien que ce ne soit pas la meilleure pratique, vous pouvez également ajouter l’évènement comme un attribut sur la balise <body>, de la même manière que onload :

- -
<body onload="myonload()" onpageshow="mypageshowcode()">
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('HTML WHATWG', 'browsing-the-web.html#event-pageshow', 'pageshow')}}{{Spec2('HTML WHATWG')}}Spécification initiale.
{{SpecName('HTML5 W3C', 'browsers.html#event-pageshow', 'pageshow')}}{{Spec2('HTML5 W3C')}}
- -

Compatibilité des navigateurs

- -

{{Compat("api.Window.pageshow_event")}}

- -

Voir aussi

- - diff --git a/files/fr/web/api/window/pageshow_event/index.md b/files/fr/web/api/window/pageshow_event/index.md new file mode 100644 index 0000000000..4687409333 --- /dev/null +++ b/files/fr/web/api/window/pageshow_event/index.md @@ -0,0 +1,110 @@ +--- +title: pageshow +slug: Web/API/Window/pageshow_event +translation_of: Web/API/Window/pageshow_event +original_slug: Web/Events/pageshow +--- +

L’évènement pageshow est émis lorsqu’une entrée dans un historique de session est atteinte (cela comprend les boutons précédent / suivant ainsi que l’affichage initial de la page après l’évènement onload).

+ +

Informations générales

+ +
+
Spécification
+
HTML5
+
Interface
+
PageTransitionEvent
+
Bouillonne
+
Non
+
Annulable
+
Non
+
Cible
+
Document (dispatché sur Window)
+
Action par défaut
+
Aucune
+
+ +

Propriétés

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
PropriétéTypeDescription
target {{readonlyInline}}{{domxref("EventTarget")}}La cible de l’évènement (la plus haute dans l’arbre DOM).
type {{readonlyInline}}{{domxref("DOMString")}}Le type d’évènement.
bubbles {{readonlyInline}}{{jsxref("Boolean")}}Si l’évènement bouillonne en temps normal ou non.
cancelable {{readonlyInline}}{{jsxref("Boolean")}}Si l’évènement est annulable ou non.
persisted {{readonlyInline}}{{jsxref("boolean")}}Si l’entrée est chargée depuis le cache ou non.
+ +

Exemples

+ +

L’exemple suivant va afficher dans la console des informations sur l’évènement pageshow, qui est émis à l’utilisation des boutons précédent / suivant, et pas uniquement après onload :

+ +
window.addEventListener('pageshow', function(event) {
+    console.log('pageshow:');
+    console.log(event);
+});
+ +

Bien que ce ne soit pas la meilleure pratique, vous pouvez également ajouter l’évènement comme un attribut sur la balise <body>, de la même manière que onload :

+ +
<body onload="myonload()" onpageshow="mypageshowcode()">
+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('HTML WHATWG', 'browsing-the-web.html#event-pageshow', 'pageshow')}}{{Spec2('HTML WHATWG')}}Spécification initiale.
{{SpecName('HTML5 W3C', 'browsers.html#event-pageshow', 'pageshow')}}{{Spec2('HTML5 W3C')}}
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Window.pageshow_event")}}

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/window/parent/index.html b/files/fr/web/api/window/parent/index.html deleted file mode 100644 index 01da0b6b14..0000000000 --- a/files/fr/web/api/window/parent/index.html +++ /dev/null @@ -1,25 +0,0 @@ ---- -title: window.parent -slug: Web/API/Window/parent -tags: - - DOM - - DOM_0 - - Référence_du_DOM_Gecko -translation_of: Web/API/Window/parent ---- -

{{ ApiRef() }}

-

Résumé

-

Renvoie une référence à la fenêtre parente ou cadre parent de la fenêtre courante ou du cadre courant.

-

Syntaxe

-
refObj = window.parent
-
-

Exemple

-
if (window.parent != window.top) {
-     // on se trouve dans une imbrication de cadres
-}
-
-

Notes

-

Si une fenêtre n'a pas de parent, sa propriété parent est une référence vers elle-même.

-

Lorsqu'une fenêtre est chargée dans un ensemble de cadres (frameset), son parent est le cadre parent (c'est-à-dire le document dans lequel se trouve l'élément <frame> qui fait référence à la fenêtre).

-

Spécification

-

{{ DOM0() }}

diff --git a/files/fr/web/api/window/parent/index.md b/files/fr/web/api/window/parent/index.md new file mode 100644 index 0000000000..01da0b6b14 --- /dev/null +++ b/files/fr/web/api/window/parent/index.md @@ -0,0 +1,25 @@ +--- +title: window.parent +slug: Web/API/Window/parent +tags: + - DOM + - DOM_0 + - Référence_du_DOM_Gecko +translation_of: Web/API/Window/parent +--- +

{{ ApiRef() }}

+

Résumé

+

Renvoie une référence à la fenêtre parente ou cadre parent de la fenêtre courante ou du cadre courant.

+

Syntaxe

+
refObj = window.parent
+
+

Exemple

+
if (window.parent != window.top) {
+     // on se trouve dans une imbrication de cadres
+}
+
+

Notes

+

Si une fenêtre n'a pas de parent, sa propriété parent est une référence vers elle-même.

+

Lorsqu'une fenêtre est chargée dans un ensemble de cadres (frameset), son parent est le cadre parent (c'est-à-dire le document dans lequel se trouve l'élément <frame> qui fait référence à la fenêtre).

+

Spécification

+

{{ DOM0() }}

diff --git a/files/fr/web/api/window/paste_event/index.html b/files/fr/web/api/window/paste_event/index.html deleted file mode 100644 index 0f215c946e..0000000000 --- a/files/fr/web/api/window/paste_event/index.html +++ /dev/null @@ -1,71 +0,0 @@ ---- -title: 'Window: paste event' -slug: Web/API/Window/paste_event -tags: - - Evènement - - Reference - - Window - - paste -translation_of: Web/API/Window/paste_event ---- -
{{APIRef}}
- -

L'événement paste est déclenché lorsque l'utilisateur a lancé une action de "paste" via l'interface utilisateur du navigateur.

- - - - - - - - - - - - - - - - - - - - -
BullesYes
AnnulableYes
Interface{{domxref("ClipboardEvent")}}
Propriété du gestionnaire d'événements{{domxref("HTMLElement/onpaste", "onpaste")}}
- -

La cible d'origine de cet événement est le {{domxref ("Element")}} qui était la cible prévue de l'action de collage. Vous pouvez écouter cet événement sur l'interface {{domxref ("Window")}} pour le gérer dans les phases de capture ou de bullage. Pour plus de détails sur cet événement, veuillez consulter la page sur le Element: paste event.

- -

Exemples

- -
window.addEventListener('paste', (event) => {
-    console.log('paste action initiated')
-});
- -

Spécifications

- - - - - - - - - - - - - - -
SpecificationStatut
{{SpecName('Clipboard API', '#clipboard-event-paste')}}{{Spec2('Clipboard API')}}
- -

Compatibilité des navigateurs

- -

{{Compat("api.Window.paste_event")}}

- -

Voir également

- - diff --git a/files/fr/web/api/window/paste_event/index.md b/files/fr/web/api/window/paste_event/index.md new file mode 100644 index 0000000000..0f215c946e --- /dev/null +++ b/files/fr/web/api/window/paste_event/index.md @@ -0,0 +1,71 @@ +--- +title: 'Window: paste event' +slug: Web/API/Window/paste_event +tags: + - Evènement + - Reference + - Window + - paste +translation_of: Web/API/Window/paste_event +--- +
{{APIRef}}
+ +

L'événement paste est déclenché lorsque l'utilisateur a lancé une action de "paste" via l'interface utilisateur du navigateur.

+ + + + + + + + + + + + + + + + + + + + +
BullesYes
AnnulableYes
Interface{{domxref("ClipboardEvent")}}
Propriété du gestionnaire d'événements{{domxref("HTMLElement/onpaste", "onpaste")}}
+ +

La cible d'origine de cet événement est le {{domxref ("Element")}} qui était la cible prévue de l'action de collage. Vous pouvez écouter cet événement sur l'interface {{domxref ("Window")}} pour le gérer dans les phases de capture ou de bullage. Pour plus de détails sur cet événement, veuillez consulter la page sur le Element: paste event.

+ +

Exemples

+ +
window.addEventListener('paste', (event) => {
+    console.log('paste action initiated')
+});
+ +

Spécifications

+ + + + + + + + + + + + + + +
SpecificationStatut
{{SpecName('Clipboard API', '#clipboard-event-paste')}}{{Spec2('Clipboard API')}}
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Window.paste_event")}}

+ +

Voir également

+ + diff --git a/files/fr/web/api/window/popstate_event/index.html b/files/fr/web/api/window/popstate_event/index.html deleted file mode 100644 index 9c821b6ea9..0000000000 --- a/files/fr/web/api/window/popstate_event/index.html +++ /dev/null @@ -1,111 +0,0 @@ ---- -title: popstate -slug: Web/API/Window/popstate_event -translation_of: Web/API/Window/popstate_event ---- -

L'événement popstate est exécuté lorsque l'entrée active de l'historique change. Si l'entrée active de l'historique en cours d'activation a été créé par un appel à history.pushState() ou a été affectée par un appel à history.replaceState(), la propriété state de l'événement popstate contient une copie de l'objet state de l'entrée d'historique.

- -

Notez qu'un appel à history.pushState() ou history.replaceState() n'exécutera pas l'événement popstate. L'événement popstate est uniquement exécuté en réalisant une action dans le navigateur telle que cliquer sur le bouton de retour (ou appeler history.back() en JavaScript).

- -

Les navigateurs ont tendance à gérer l'événement popstate différemment lors du chargement de la page. Chrome (avant la v34) et Safari émettent toujours un événement popstate lors du chargement de la page, contrairement à Firefox.

- -

Informations générales

- -
-
Specification
-
HTML5
-
Interface
-
PopStateEvent
-
Bubbles
-
Yes
-
Cancelable
-
No
-
Target
-
defaultView
-
Action par défaut
-
None
-
- -

Propriétés

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
PropertyTypeDescription
target {{readonlyInline}}{{domxref("EventTarget")}}The browsing context (window).
type {{readonlyInline}}{{domxref("DOMString")}}The type of event.
bubbles {{readonlyInline}}{{jsxref("Boolean")}}Whether the event normally bubbles or not.
cancelable {{readonlyInline}}{{jsxref("Boolean")}}Whether the event is cancellable or not.
state {{readonlyInline}}anyThe current history entry's state object (if any).
- -

Exemple

- -

Une page http://example.com/example.html exécutant le code suivant génèrera un journal comme spécifié :

- -
window.onpopstate = function(event) {
-  console.log("location: " + document.location + ", state: " + JSON.stringify(event.state));
-};
-history.pushState({page: 1}, "title 1", "?page=1");
-history.pushState({page: 2}, "title 2", "?page=2");
-history.replaceState({page: 3}, "title 3", "?page=3");
-history.back(); // Logs "location: http://example.com/example.html?page=1, state: {"page":1}"
-history.back(); // Logs "location: http://example.com/example.html, state: null
-history.go(2);  // Logs "location: http://example.com/example.html?page=3, state: {"page":3}
-
- -

Notez que même si l'entrée d'historique originelle (pour http://example.com/example.html) n'a pas d'objet state associé, un événement popstate est tout de même exécuté lorsque nous activons cette entrée au second appel à history.back().

- -

Spécifications

- - - - - - - - - - - - - - -
SpécificationStatut
{{SpecName('HTML WHATWG', 'indices.html#event-popstate', 'popstate')}}{{Spec2('HTML WHATWG')}}
- -

Compatibilité des navigateurs

- -

{{Compat("api.Window.popstate_event")}}

- -

Voir aussi

- - diff --git a/files/fr/web/api/window/popstate_event/index.md b/files/fr/web/api/window/popstate_event/index.md new file mode 100644 index 0000000000..9c821b6ea9 --- /dev/null +++ b/files/fr/web/api/window/popstate_event/index.md @@ -0,0 +1,111 @@ +--- +title: popstate +slug: Web/API/Window/popstate_event +translation_of: Web/API/Window/popstate_event +--- +

L'événement popstate est exécuté lorsque l'entrée active de l'historique change. Si l'entrée active de l'historique en cours d'activation a été créé par un appel à history.pushState() ou a été affectée par un appel à history.replaceState(), la propriété state de l'événement popstate contient une copie de l'objet state de l'entrée d'historique.

+ +

Notez qu'un appel à history.pushState() ou history.replaceState() n'exécutera pas l'événement popstate. L'événement popstate est uniquement exécuté en réalisant une action dans le navigateur telle que cliquer sur le bouton de retour (ou appeler history.back() en JavaScript).

+ +

Les navigateurs ont tendance à gérer l'événement popstate différemment lors du chargement de la page. Chrome (avant la v34) et Safari émettent toujours un événement popstate lors du chargement de la page, contrairement à Firefox.

+ +

Informations générales

+ +
+
Specification
+
HTML5
+
Interface
+
PopStateEvent
+
Bubbles
+
Yes
+
Cancelable
+
No
+
Target
+
defaultView
+
Action par défaut
+
None
+
+ +

Propriétés

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
PropertyTypeDescription
target {{readonlyInline}}{{domxref("EventTarget")}}The browsing context (window).
type {{readonlyInline}}{{domxref("DOMString")}}The type of event.
bubbles {{readonlyInline}}{{jsxref("Boolean")}}Whether the event normally bubbles or not.
cancelable {{readonlyInline}}{{jsxref("Boolean")}}Whether the event is cancellable or not.
state {{readonlyInline}}anyThe current history entry's state object (if any).
+ +

Exemple

+ +

Une page http://example.com/example.html exécutant le code suivant génèrera un journal comme spécifié :

+ +
window.onpopstate = function(event) {
+  console.log("location: " + document.location + ", state: " + JSON.stringify(event.state));
+};
+history.pushState({page: 1}, "title 1", "?page=1");
+history.pushState({page: 2}, "title 2", "?page=2");
+history.replaceState({page: 3}, "title 3", "?page=3");
+history.back(); // Logs "location: http://example.com/example.html?page=1, state: {"page":1}"
+history.back(); // Logs "location: http://example.com/example.html, state: null
+history.go(2);  // Logs "location: http://example.com/example.html?page=3, state: {"page":3}
+
+ +

Notez que même si l'entrée d'historique originelle (pour http://example.com/example.html) n'a pas d'objet state associé, un événement popstate est tout de même exécuté lorsque nous activons cette entrée au second appel à history.back().

+ +

Spécifications

+ + + + + + + + + + + + + + +
SpécificationStatut
{{SpecName('HTML WHATWG', 'indices.html#event-popstate', 'popstate')}}{{Spec2('HTML WHATWG')}}
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Window.popstate_event")}}

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/window/postmessage/index.html b/files/fr/web/api/window/postmessage/index.html deleted file mode 100644 index e7224757d7..0000000000 --- a/files/fr/web/api/window/postmessage/index.html +++ /dev/null @@ -1,179 +0,0 @@ ---- -title: Window.postMessage -slug: Web/API/Window/postMessage -tags: - - API - - DOM - - Méthode - - Reference - - postMessage -translation_of: Web/API/Window/postMessage ---- -
{{ ApiRef() }}
- -
- -

La méthode window.postMessage permet une communication inter-domaine en toute sécurité. Normalement, les scripts de différentes pages sont autorisés à accéder les uns aux autres si et seulement si les pages depuis lesquelles ils sont exécutés ont des URL de même origine, c'est-à-dire avec le même protocole (généralement http ou https), le même numéro de port (80 étant le port par défaut pour  http), et le même nom d'hôte (à condition que document.domain soit initialisé à la même valeur par les deux pages). window.postMessage fournit un mécanisme contrôlé pour contourner cette restriction d'une manière sécurisée si bien utilisée.

- -

La méthode window.postMessage, quand elle est appelée, provoque l'envoi d'un {{domxref("MessageEvent")}} à la fenêtre ciblée une fois que tout script en attente a terminé son exécution (par exemple, les gestionnaires d'évènements restants si window.postMessage est appelée depuis un gestionnaire d'évènement, des timeouts en attente enregistrées auparavant, etc.) Le {{domxref("MessageEvent")}} est de type message, a une propriété data qui est initialisée à la valeur du premier argument passé à window.postMessage, une propriété origin correspondant à l'origine du document principal de la fenêtre appelant window.postMessage au moment où window.postMessage a été appelée, et une propriété source qui est la fenêtre depuis laquelle window.postMessage est appelée. (les autres propriétés standard d'évènement sont présentes avec leurs valeurs attendues).

- -

Syntaxe

- -
otherWindow.postMessage(message, targetOrigin, [transfer]);
- -
-
otherWindow
-
Une référence à une autre fenêtre ; une telle référence peut être obtenue, par exemple, via la propriété contentWindow d'un élément iframe, l'objet retourné par window.open, ou par index nommé ou numérique de window.frames.
-
message
-
La donnée à envoyer à l'autre fenêtre. Elle est sérialisée en utilisant l'algorithme de clônage structuré. Cela signifie que vous pouvez passer sereinement une large variété d'objets de données à la fenêtre de destination sans avoir à les sérialiser vous-mêmes. [1]
-
targetOrigin
-
Indique quelle doit être l'origine de otherWindow pour l'évènement à envoyer, soit comme la chaîne littérale "*" (signifiant pas de préférence) soit comme une URI. Si, au moment où l'évènement est inscrit pour être envoyé, le protocole, le nom d'hôte ou le port du document de otherWindow ne correspond pas à ceux contenus dans targetOrigin,  l'évènement ne sera pas envoyé ; il ne le sera que si les trois correspondent. Ce mécanisme permet de contrôler où les messages sont envoyés ; par exemple, si postMessage était utilisé pour transmettre un mot de passe, il serait absolument vital que cet argument soit une URI dont l'origine est la même que le récepteur prévu du message contenant le mot de passe, afin de prévenir l'interception du mot de passe par une tierce-partie malicieuse. Fournissez toujours une targetOrigin spécifique, jamais *, si vous savez où le document de l'autre fenêtre est censé se trouver. Ne pas fournir une cible spécifique expose les données que vous envoyez à tout site malicieux à l'écoute.
-
transfer {{optional_Inline}}
-
Séquence d'objets {{domxref("Transferable")}} qui sera transmise avec le message. La possession de ces objets est cédée à la destination et ils ne sont plus utilisables du côté de l'expéditeur.
-
- -

L'évènement envoyé

- -

otherWindow peut surveiller les messages envoyés en exécutant le JavaScript suivant :

- -
window.addEventListener("message", receiveMessage, false);
-
-function receiveMessage(event)
-{
-  if (event.origin !== "http://example.org:8080")
-    return;
-
-  // ...
-}
-
- -

Les propriétés du message envoyé sont :

- -
-
data
-
L'objet passé depuis l'autre fenêtre.
-
origin
-
L'origine de la fenêtre qui a envoyé le message au moment où postMessage a été appelée. Des exemples typiques d'origines sont https://example.org (sous-entendu port 443), http://example.net (sous-entendu port 80), et http://example.com:8080. Notez qu'il n'est pas garanti que cette origine soit l'origine actuelle ou future de cette fenêtre, qui peut avoir été naviguée vers une adresse différente depuis l'appel à postMessage.
-
source
-
Une référence à l'objet window qui a envoyé le message ; vous pouvez utiliser ceci pour établir une communication dans les deux sens entre deux fenêtres ayant différentes origines.
-
- -
-
- -

Précautions de sécurité

- -

Si vous ne prévoyez pas de recevoir de messages depuis d'autres sites, n'ajoutez pas de gestionnaire d'évènement pour les évènements message. C'est un moyen sûr d'éviter les problèmes de sécurité.

- -

Si vous prévoyez de recevoir des messages depuis d'autres sites, vérifiez toujours l'identité de l'expéditeur à l'aide des propriétés origin et si possible source. Toute fenêtre (y compris, par exemple, http://evil.example.com) peut envoyer un message à toute autre fenêtre, et vous n'avez aucune garantie qu'un expéditeur inconnu ne va pas envoyer de message malicieux. Cependant, même si vous vérifiez l'identité, vous devriez toujours vérifier la syntaxe du message reçu. Dans le cas contraire, une faille de sécurité dans le site auquel vous faites confiance peut ouvrir une vulnérabilité XSS dans votre propre site.

- -

Spécifiez toujours explicitement une origine de destination, jamais *, quand vous utilisez postMessage pour envoyer des données à d'autres fenêtres. Un site malicieux peut changer l'adresse de la fenêtre à votre insu, et ainsi intercepter les données envoyées à l'aide de postMessage.

- -

Exemple

- -
/*
- * Dans les scripts de la fenêtre A, avec A sur <http://example.com:8080>:
- */
-
-var popup = window.open(...popup details...);
-
-// Quand la popup est chargée, si pas bloquée par un bloqueur de popups:
-
-// Ceci ne fait rien, en supposant que la fenêtre n'a pas changé d'adresse.
-popup.postMessage("The user is 'bob' and the password is 'secret'",
-                  "https://secure.example.net");
-
-// Ceci va planifier l'envoi d'un message à la popup, en supposant que
-// la fenêtre n'a pas changé d'adresse.
-popup.postMessage("hello there!", "http://example.org");
-
-function receiveMessage(event)
-{
-  // Faisons-nous confiance à l'expéditeur de ce message ?  (il pourrait être
-  // différent de la fenêtre que nous avons ouverte au départ, par exemple).
-  if (event.origin !== "http://example.org")
-    return;
-
-  // event.source est la popup
-  // event.data est "hi there yourself!  the secret response is: rheeeeet!"
-}
-window.addEventListener("message", receiveMessage, false);
-
- -
/*
- * Dans les scripts de la popup, sur <http://example.org>:
- */
-
-// Appelée quelques instants après que postMessage a été appelée
-function receiveMessage(event)
-{
-  // Faisons-nous confiance à l'expéditeur de ce message ?
-  if (event.origin !== "http://example.com:8080")
-    return;
-
-  // event.source est window.opener
-  // event.data est "hello there!"
-
-  // Supposant que vous avez vérifié l'origine du message reçu
-  // (ce que vous devriez faire en toutes circonstances),
-  // un moyen pratique de répondre à un message est d'appeler postMessage
-  // sur event.source et fournir event.origin comme targetOrigin.
-  event.source.postMessage("hi there yourself!  the secret response " +
-                           "is: rheeeeet!",
-                           event.origin);
-}
-
-window.addEventListener("message", receiveMessage, false);
-
- -

Notes

- -

Toute fenêtre peut accéder à cette méthode sur toute autre fenêtre, à tout moment, peu importe l'adresse du document dans la fenêtre, pour y envoyer un message. Par conséquent, tout gestionnaire d'évènement utilisé pour recevoir des messages doit d'abord vérifier l'identité de l'expéditeur du message, en utilisant les propriétés origin et si possible source. Cela ne peut pas être minimisé : ne pas vérifier les propriétés origin et si possible source permet des attaques inter-site.

- -

De même qu'avec les scripts exécutés de manière asynchrone (timeouts, evènements générés par l'utilisateur), il n'est pas possible pour l'appelant à postMessage de détecter quand un gestionnaire d'évènement écoutant des évènements envoyés par postMessage lance une exception.

- -

La valeur de la propriété origin de l'évènement envoyé n'est pas affectée par la valeur actuelle de document.domain dans la fenêtre appelante.

- -

Pour les noms d'hôte IDN uniquement, la valeur de la propriété origin n'est pas systématiquement Unicode ou punycode ; pour la plus grande compatibilité, testez à la fois les valeurs IDN et punycode quand vous utilisez cette propriété si vous attendez des messages de sites IDN. Cette valeur sera systématiquement IDN à l'avenir, mais pour l'instant vous devriez gérer à la fois les formes IDN et punycode.

- -

La valeur de la propriété origin quand la fenêtre expéditrice contient une URL javascript: ou data: est l'origin du script qui a chargé cette URL.

- -

Utiliser window.postMessage dans les extensions {{Non-standard_inline}}

- -

window.postMessage est disponible depuis le JavaScript exécuté en code chrome (par exemple dans les extensions et le code privilégié), mais la propriété source de l'évènement envoyé est toujours null par mesure de sécurité. (Les autres propriétés ont leurs valeurs usuelles.) L'argument targetOrigin pour un message envoyé à une fenêtre située à une URL chrome: est actuellement mal interprété, si bien que la seule valeur qui conduit à l'envoi d'un message est "*". Comme cette valeur n'est pas sûre quand la fenêtre ciblée peut être naviguée n'importe où par un site malicieux, il est recommandé de ne pas utiliser postMessage pour communiquer avec des pages chrome: pour l'instant ; utilisez une méthode différente (comme une query string quand la fenêtre est ouverte) pour communiquer avec des fenêtres chrome. Enfin, poster un message à une page à une URL file: requiert actuellement que l'argument targetOrigin soit "*". file:// ne peut pas être utilisé comme restriction de sécurité ; cette restriction pourrait être modifiée à l'avenir.

- -

Spécifications

- - - - - - - - - - - - - - - - - - - -
SpécificationStatusCommentaire
{{SpecName('HTML WHATWG', "#dom-window-postmessage", "window.postMessage")}}{{Spec2('HTML WHATWG')}}Pas de changement depuis {{SpecName('HTML5 Web Messaging')}}
{{SpecName('HTML5 Web Messaging', '#dom-window-postmessage', 'window.postMessage')}}{{Spec2('HTML5 Web Messaging')}}Définition initiale.
- -

Compatibilité des navigateurs

- - - -

{{Compat("api.Window.postMessage")}}

- -

Voir aussi

- - diff --git a/files/fr/web/api/window/postmessage/index.md b/files/fr/web/api/window/postmessage/index.md new file mode 100644 index 0000000000..e7224757d7 --- /dev/null +++ b/files/fr/web/api/window/postmessage/index.md @@ -0,0 +1,179 @@ +--- +title: Window.postMessage +slug: Web/API/Window/postMessage +tags: + - API + - DOM + - Méthode + - Reference + - postMessage +translation_of: Web/API/Window/postMessage +--- +
{{ ApiRef() }}
+ +
+ +

La méthode window.postMessage permet une communication inter-domaine en toute sécurité. Normalement, les scripts de différentes pages sont autorisés à accéder les uns aux autres si et seulement si les pages depuis lesquelles ils sont exécutés ont des URL de même origine, c'est-à-dire avec le même protocole (généralement http ou https), le même numéro de port (80 étant le port par défaut pour  http), et le même nom d'hôte (à condition que document.domain soit initialisé à la même valeur par les deux pages). window.postMessage fournit un mécanisme contrôlé pour contourner cette restriction d'une manière sécurisée si bien utilisée.

+ +

La méthode window.postMessage, quand elle est appelée, provoque l'envoi d'un {{domxref("MessageEvent")}} à la fenêtre ciblée une fois que tout script en attente a terminé son exécution (par exemple, les gestionnaires d'évènements restants si window.postMessage est appelée depuis un gestionnaire d'évènement, des timeouts en attente enregistrées auparavant, etc.) Le {{domxref("MessageEvent")}} est de type message, a une propriété data qui est initialisée à la valeur du premier argument passé à window.postMessage, une propriété origin correspondant à l'origine du document principal de la fenêtre appelant window.postMessage au moment où window.postMessage a été appelée, et une propriété source qui est la fenêtre depuis laquelle window.postMessage est appelée. (les autres propriétés standard d'évènement sont présentes avec leurs valeurs attendues).

+ +

Syntaxe

+ +
otherWindow.postMessage(message, targetOrigin, [transfer]);
+ +
+
otherWindow
+
Une référence à une autre fenêtre ; une telle référence peut être obtenue, par exemple, via la propriété contentWindow d'un élément iframe, l'objet retourné par window.open, ou par index nommé ou numérique de window.frames.
+
message
+
La donnée à envoyer à l'autre fenêtre. Elle est sérialisée en utilisant l'algorithme de clônage structuré. Cela signifie que vous pouvez passer sereinement une large variété d'objets de données à la fenêtre de destination sans avoir à les sérialiser vous-mêmes. [1]
+
targetOrigin
+
Indique quelle doit être l'origine de otherWindow pour l'évènement à envoyer, soit comme la chaîne littérale "*" (signifiant pas de préférence) soit comme une URI. Si, au moment où l'évènement est inscrit pour être envoyé, le protocole, le nom d'hôte ou le port du document de otherWindow ne correspond pas à ceux contenus dans targetOrigin,  l'évènement ne sera pas envoyé ; il ne le sera que si les trois correspondent. Ce mécanisme permet de contrôler où les messages sont envoyés ; par exemple, si postMessage était utilisé pour transmettre un mot de passe, il serait absolument vital que cet argument soit une URI dont l'origine est la même que le récepteur prévu du message contenant le mot de passe, afin de prévenir l'interception du mot de passe par une tierce-partie malicieuse. Fournissez toujours une targetOrigin spécifique, jamais *, si vous savez où le document de l'autre fenêtre est censé se trouver. Ne pas fournir une cible spécifique expose les données que vous envoyez à tout site malicieux à l'écoute.
+
transfer {{optional_Inline}}
+
Séquence d'objets {{domxref("Transferable")}} qui sera transmise avec le message. La possession de ces objets est cédée à la destination et ils ne sont plus utilisables du côté de l'expéditeur.
+
+ +

L'évènement envoyé

+ +

otherWindow peut surveiller les messages envoyés en exécutant le JavaScript suivant :

+ +
window.addEventListener("message", receiveMessage, false);
+
+function receiveMessage(event)
+{
+  if (event.origin !== "http://example.org:8080")
+    return;
+
+  // ...
+}
+
+ +

Les propriétés du message envoyé sont :

+ +
+
data
+
L'objet passé depuis l'autre fenêtre.
+
origin
+
L'origine de la fenêtre qui a envoyé le message au moment où postMessage a été appelée. Des exemples typiques d'origines sont https://example.org (sous-entendu port 443), http://example.net (sous-entendu port 80), et http://example.com:8080. Notez qu'il n'est pas garanti que cette origine soit l'origine actuelle ou future de cette fenêtre, qui peut avoir été naviguée vers une adresse différente depuis l'appel à postMessage.
+
source
+
Une référence à l'objet window qui a envoyé le message ; vous pouvez utiliser ceci pour établir une communication dans les deux sens entre deux fenêtres ayant différentes origines.
+
+ +
+
+ +

Précautions de sécurité

+ +

Si vous ne prévoyez pas de recevoir de messages depuis d'autres sites, n'ajoutez pas de gestionnaire d'évènement pour les évènements message. C'est un moyen sûr d'éviter les problèmes de sécurité.

+ +

Si vous prévoyez de recevoir des messages depuis d'autres sites, vérifiez toujours l'identité de l'expéditeur à l'aide des propriétés origin et si possible source. Toute fenêtre (y compris, par exemple, http://evil.example.com) peut envoyer un message à toute autre fenêtre, et vous n'avez aucune garantie qu'un expéditeur inconnu ne va pas envoyer de message malicieux. Cependant, même si vous vérifiez l'identité, vous devriez toujours vérifier la syntaxe du message reçu. Dans le cas contraire, une faille de sécurité dans le site auquel vous faites confiance peut ouvrir une vulnérabilité XSS dans votre propre site.

+ +

Spécifiez toujours explicitement une origine de destination, jamais *, quand vous utilisez postMessage pour envoyer des données à d'autres fenêtres. Un site malicieux peut changer l'adresse de la fenêtre à votre insu, et ainsi intercepter les données envoyées à l'aide de postMessage.

+ +

Exemple

+ +
/*
+ * Dans les scripts de la fenêtre A, avec A sur <http://example.com:8080>:
+ */
+
+var popup = window.open(...popup details...);
+
+// Quand la popup est chargée, si pas bloquée par un bloqueur de popups:
+
+// Ceci ne fait rien, en supposant que la fenêtre n'a pas changé d'adresse.
+popup.postMessage("The user is 'bob' and the password is 'secret'",
+                  "https://secure.example.net");
+
+// Ceci va planifier l'envoi d'un message à la popup, en supposant que
+// la fenêtre n'a pas changé d'adresse.
+popup.postMessage("hello there!", "http://example.org");
+
+function receiveMessage(event)
+{
+  // Faisons-nous confiance à l'expéditeur de ce message ?  (il pourrait être
+  // différent de la fenêtre que nous avons ouverte au départ, par exemple).
+  if (event.origin !== "http://example.org")
+    return;
+
+  // event.source est la popup
+  // event.data est "hi there yourself!  the secret response is: rheeeeet!"
+}
+window.addEventListener("message", receiveMessage, false);
+
+ +
/*
+ * Dans les scripts de la popup, sur <http://example.org>:
+ */
+
+// Appelée quelques instants après que postMessage a été appelée
+function receiveMessage(event)
+{
+  // Faisons-nous confiance à l'expéditeur de ce message ?
+  if (event.origin !== "http://example.com:8080")
+    return;
+
+  // event.source est window.opener
+  // event.data est "hello there!"
+
+  // Supposant que vous avez vérifié l'origine du message reçu
+  // (ce que vous devriez faire en toutes circonstances),
+  // un moyen pratique de répondre à un message est d'appeler postMessage
+  // sur event.source et fournir event.origin comme targetOrigin.
+  event.source.postMessage("hi there yourself!  the secret response " +
+                           "is: rheeeeet!",
+                           event.origin);
+}
+
+window.addEventListener("message", receiveMessage, false);
+
+ +

Notes

+ +

Toute fenêtre peut accéder à cette méthode sur toute autre fenêtre, à tout moment, peu importe l'adresse du document dans la fenêtre, pour y envoyer un message. Par conséquent, tout gestionnaire d'évènement utilisé pour recevoir des messages doit d'abord vérifier l'identité de l'expéditeur du message, en utilisant les propriétés origin et si possible source. Cela ne peut pas être minimisé : ne pas vérifier les propriétés origin et si possible source permet des attaques inter-site.

+ +

De même qu'avec les scripts exécutés de manière asynchrone (timeouts, evènements générés par l'utilisateur), il n'est pas possible pour l'appelant à postMessage de détecter quand un gestionnaire d'évènement écoutant des évènements envoyés par postMessage lance une exception.

+ +

La valeur de la propriété origin de l'évènement envoyé n'est pas affectée par la valeur actuelle de document.domain dans la fenêtre appelante.

+ +

Pour les noms d'hôte IDN uniquement, la valeur de la propriété origin n'est pas systématiquement Unicode ou punycode ; pour la plus grande compatibilité, testez à la fois les valeurs IDN et punycode quand vous utilisez cette propriété si vous attendez des messages de sites IDN. Cette valeur sera systématiquement IDN à l'avenir, mais pour l'instant vous devriez gérer à la fois les formes IDN et punycode.

+ +

La valeur de la propriété origin quand la fenêtre expéditrice contient une URL javascript: ou data: est l'origin du script qui a chargé cette URL.

+ +

Utiliser window.postMessage dans les extensions {{Non-standard_inline}}

+ +

window.postMessage est disponible depuis le JavaScript exécuté en code chrome (par exemple dans les extensions et le code privilégié), mais la propriété source de l'évènement envoyé est toujours null par mesure de sécurité. (Les autres propriétés ont leurs valeurs usuelles.) L'argument targetOrigin pour un message envoyé à une fenêtre située à une URL chrome: est actuellement mal interprété, si bien que la seule valeur qui conduit à l'envoi d'un message est "*". Comme cette valeur n'est pas sûre quand la fenêtre ciblée peut être naviguée n'importe où par un site malicieux, il est recommandé de ne pas utiliser postMessage pour communiquer avec des pages chrome: pour l'instant ; utilisez une méthode différente (comme une query string quand la fenêtre est ouverte) pour communiquer avec des fenêtres chrome. Enfin, poster un message à une page à une URL file: requiert actuellement que l'argument targetOrigin soit "*". file:// ne peut pas être utilisé comme restriction de sécurité ; cette restriction pourrait être modifiée à l'avenir.

+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + +
SpécificationStatusCommentaire
{{SpecName('HTML WHATWG', "#dom-window-postmessage", "window.postMessage")}}{{Spec2('HTML WHATWG')}}Pas de changement depuis {{SpecName('HTML5 Web Messaging')}}
{{SpecName('HTML5 Web Messaging', '#dom-window-postmessage', 'window.postMessage')}}{{Spec2('HTML5 Web Messaging')}}Définition initiale.
+ +

Compatibilité des navigateurs

+ + + +

{{Compat("api.Window.postMessage")}}

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/window/print/index.html b/files/fr/web/api/window/print/index.html deleted file mode 100644 index e07fb5d820..0000000000 --- a/files/fr/web/api/window/print/index.html +++ /dev/null @@ -1,50 +0,0 @@ ---- -title: Window.print() -slug: Web/API/Window/print -tags: - - API - - BesoinDeCompatibilitéAvecLeNavigateur - - BesoinDeCompatibilitéAvecLeNavigateurMobile - - DOM - - Méthode - - Reference - - Window -translation_of: Web/API/Window/print ---- -

{{ ApiRef() }}

- -

Ouvre la fenêtre de dialogue d'impression pour imprimer le document courant. 

- -

Syntaxe

- -
window.print()
-
- -

Notes

- -

Disponible à partir de Chrome {{CompatChrome(45.0)}}, cette méthode est bloquée à l'intérieur d'une balise {{htmlelement("iframe")}} sauf si son attribut sandbox a la valeur allow-modal.

- -

Spécification

- - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('HTML5 Web application', '#dom-print', 'print()')}}{{Spec2('HTML5 Web application')}}Définition initiale.
- -

Voir également

- - \ No newline at end of file diff --git a/files/fr/web/api/window/print/index.md b/files/fr/web/api/window/print/index.md new file mode 100644 index 0000000000..e07fb5d820 --- /dev/null +++ b/files/fr/web/api/window/print/index.md @@ -0,0 +1,50 @@ +--- +title: Window.print() +slug: Web/API/Window/print +tags: + - API + - BesoinDeCompatibilitéAvecLeNavigateur + - BesoinDeCompatibilitéAvecLeNavigateurMobile + - DOM + - Méthode + - Reference + - Window +translation_of: Web/API/Window/print +--- +

{{ ApiRef() }}

+ +

Ouvre la fenêtre de dialogue d'impression pour imprimer le document courant. 

+ +

Syntaxe

+ +
window.print()
+
+ +

Notes

+ +

Disponible à partir de Chrome {{CompatChrome(45.0)}}, cette méthode est bloquée à l'intérieur d'une balise {{htmlelement("iframe")}} sauf si son attribut sandbox a la valeur allow-modal.

+ +

Spécification

+ + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('HTML5 Web application', '#dom-print', 'print()')}}{{Spec2('HTML5 Web application')}}Définition initiale.
+ +

Voir également

+ + \ No newline at end of file diff --git a/files/fr/web/api/window/prompt/index.html b/files/fr/web/api/window/prompt/index.html deleted file mode 100644 index a5d0f914f2..0000000000 --- a/files/fr/web/api/window/prompt/index.html +++ /dev/null @@ -1,91 +0,0 @@ ---- -title: window.prompt -slug: Web/API/Window/prompt -tags: - - API - - DOM - - Méthode - - Reference - - Window -translation_of: Web/API/Window/prompt ---- -
{{ApiRef("Window")}}
- -

La méthode Window.prompt() affiche une boîte de dialogue, éventuellement avec un message, qui invite l'utilisateur à saisir un texte.

- -

Syntaxe

- -
résultat = window.prompt(message, défaut);
-
- -

Paramètres

- -
-
message {{optional_inline}}
-
Une chaîne de caractères qui sera affichée pour l'utilisateur. Cet argument peut ne pas être utilisé s'il n'y a rien à afficher dans la fenêtre.
-
default {{optional_inline}}
-
Une chaîne de caractères contenant la valeur par défaut affichée pour la saisie. Pour Internet Explorer 7 et 8, si cet argument n'est pas fourni, ce sera la chaîne de caractères "undefined" qui sera la valeur par défaut.
-
- -

Valeur de retour

- -

La chaîne de caractères qui a été saisie par l'utilisateur ou null.

- -

Exemples

- -
let signe = prompt("Quel est votre signe astrologique ?");
-
-if (signe.toLowerCase() == "verseau") {
-  console.log("Oh ? moi aussi je suis verseau :)");
-}
-
-// Différentes façons d'utiliser prompt
-signe = window.prompt(); // ouvre une fenêtre de saisie sans texte
-signe = prompt();       //  ouvre une fenêtre de saisie sans texte
-
- // ouvre une fenêtre avec le texte "Quelle est la réponse ?"
-signe = window.prompt('Quelle est la réponse ?');
-
-// ouvre une fenêtre avec le texte "Quelle est la réponse ?"
-// avec la valeur "42" comme réponse par défaut
-signe = window.prompt('Quelle est la réponse ?', '42');
- -

Lorsque l'utilisateur clique sur le bouton OK, le texte saisi dans le champ est renvoyé par la fonction. Si l'utilisateur clique sur OK sans avoir saisi de texte, c'est la chaîne vide qui est renvoyée. Si l'utilisateur clique sur le bouton "Annuler", la fonction renvoie null.

- -

Notes

- -

Une boîte de dialogue contient un texte sur une ligne, un bouton "Annuler" ainsi qu'un bouton "OK". Elle permet de renvoyer le texte (éventuellement vide) saisi par l'utilisateur dans le champ de saisie.

- -

The following text is shared between this article, DOM:window.confirm and DOM:window.alert. Les boîtes de dialogue sont des fenêtres modales : elles empêchent l'utilisateur d'accéder au reste de l'interface du programme tant que la fenêtre n'est pas fermée. Pour ces raisons, mieux vaut ne pas abuser des fonctions qui créent de telles boîtes de dialogue et autres fenêtres modales.

- -

On notera que le résultat de la fonction est une chaîne de caractères. Cela signifie qu'il faut parfois convertir la valeur founie par l'utilisateur. Si, par exemple, on souhaite que la réponse soit un nombre, il faudra la convertir (avec le constructeur {{jsxref("Number")}} éventuellement).

- -
const aNumber = Number(window.prompt("Veuillez saisir un nombre.", ""));
- -

Spécifications

- - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{SpecName('HTML WHATWG', 'timers-and-user-prompts.html#dom-prompt', 'prompt()')}}{{Spec2('HTML WHATWG')}}
- -

Compatibilité des navigateurs

- -

{{Compat("api.Window.prompt")}}

- -

Voir aussi

- - diff --git a/files/fr/web/api/window/prompt/index.md b/files/fr/web/api/window/prompt/index.md new file mode 100644 index 0000000000..a5d0f914f2 --- /dev/null +++ b/files/fr/web/api/window/prompt/index.md @@ -0,0 +1,91 @@ +--- +title: window.prompt +slug: Web/API/Window/prompt +tags: + - API + - DOM + - Méthode + - Reference + - Window +translation_of: Web/API/Window/prompt +--- +
{{ApiRef("Window")}}
+ +

La méthode Window.prompt() affiche une boîte de dialogue, éventuellement avec un message, qui invite l'utilisateur à saisir un texte.

+ +

Syntaxe

+ +
résultat = window.prompt(message, défaut);
+
+ +

Paramètres

+ +
+
message {{optional_inline}}
+
Une chaîne de caractères qui sera affichée pour l'utilisateur. Cet argument peut ne pas être utilisé s'il n'y a rien à afficher dans la fenêtre.
+
default {{optional_inline}}
+
Une chaîne de caractères contenant la valeur par défaut affichée pour la saisie. Pour Internet Explorer 7 et 8, si cet argument n'est pas fourni, ce sera la chaîne de caractères "undefined" qui sera la valeur par défaut.
+
+ +

Valeur de retour

+ +

La chaîne de caractères qui a été saisie par l'utilisateur ou null.

+ +

Exemples

+ +
let signe = prompt("Quel est votre signe astrologique ?");
+
+if (signe.toLowerCase() == "verseau") {
+  console.log("Oh ? moi aussi je suis verseau :)");
+}
+
+// Différentes façons d'utiliser prompt
+signe = window.prompt(); // ouvre une fenêtre de saisie sans texte
+signe = prompt();       //  ouvre une fenêtre de saisie sans texte
+
+ // ouvre une fenêtre avec le texte "Quelle est la réponse ?"
+signe = window.prompt('Quelle est la réponse ?');
+
+// ouvre une fenêtre avec le texte "Quelle est la réponse ?"
+// avec la valeur "42" comme réponse par défaut
+signe = window.prompt('Quelle est la réponse ?', '42');
+ +

Lorsque l'utilisateur clique sur le bouton OK, le texte saisi dans le champ est renvoyé par la fonction. Si l'utilisateur clique sur OK sans avoir saisi de texte, c'est la chaîne vide qui est renvoyée. Si l'utilisateur clique sur le bouton "Annuler", la fonction renvoie null.

+ +

Notes

+ +

Une boîte de dialogue contient un texte sur une ligne, un bouton "Annuler" ainsi qu'un bouton "OK". Elle permet de renvoyer le texte (éventuellement vide) saisi par l'utilisateur dans le champ de saisie.

+ +

The following text is shared between this article, DOM:window.confirm and DOM:window.alert. Les boîtes de dialogue sont des fenêtres modales : elles empêchent l'utilisateur d'accéder au reste de l'interface du programme tant que la fenêtre n'est pas fermée. Pour ces raisons, mieux vaut ne pas abuser des fonctions qui créent de telles boîtes de dialogue et autres fenêtres modales.

+ +

On notera que le résultat de la fonction est une chaîne de caractères. Cela signifie qu'il faut parfois convertir la valeur founie par l'utilisateur. Si, par exemple, on souhaite que la réponse soit un nombre, il faudra la convertir (avec le constructeur {{jsxref("Number")}} éventuellement).

+ +
const aNumber = Number(window.prompt("Veuillez saisir un nombre.", ""));
+ +

Spécifications

+ + + + + + + + + + + + + + +
SpécificationÉtatCommentaires
{{SpecName('HTML WHATWG', 'timers-and-user-prompts.html#dom-prompt', 'prompt()')}}{{Spec2('HTML WHATWG')}}
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Window.prompt")}}

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/window/rejectionhandled_event/index.html b/files/fr/web/api/window/rejectionhandled_event/index.html deleted file mode 100644 index ebe167e30f..0000000000 --- a/files/fr/web/api/window/rejectionhandled_event/index.html +++ /dev/null @@ -1,82 +0,0 @@ ---- -title: 'Window: rejectionhandled event' -slug: Web/API/Window/rejectionhandled_event -tags: - - API - - Evènement - - HTML DOM - - JavaScript - - Promesse - - Reference - - Window - - onrejectionhandled - - rejectionhandled -translation_of: Web/API/Window/rejectionhandled_event ---- -
{{APIRef("HTML DOM")}}
- -

L'événement rejectionhandled est envoyé à la portée globale du script (généralement {{domxref("window")}} mais aussi {{domxref("Worker")}}) chaque fois qu'un JavaScript {{jsxref("Promise")}} est rejeté mais après que le rejet de la promesse a été traité.

- -

Cela peut être utilisé dans le débogage et pour la résilience générale des applications, en tandem avec l'événement {{domxref ("Window.unhandledrejection_event", "unhandledrejection")}}, qui est envoyé lorsqu'une promesse est rejetée mais qu'il n'y a pas de responsable du rejet .

- - - - - - - - - - - - - - - - - - - - -
BullesNon
AnnulableNon
Interface{{domxref("PromiseRejectionEvent")}}
Propriété de gestionnaire d'événements{{domxref("WindowEventHandlers.onrejectionhandled", "onrejectionhandled")}}
- -

Exemple

- -

Vous pouvez utiliser l'événement rejectionhandled pour consigner les promesses rejetées sur la console, ainsi que les raisons pour lesquelles elles ont été rejetées :

- -
window.addEventListener("rejectionhandled", event => {
-  console.log("Promise rejected; reason: " + event.reason);
-}, false);
-
- -

Spécifications

- - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('HTML WHATWG', 'webappapis.html#unhandled-promise-rejections', 'rejectionhandled')}}{{Spec2('HTML WHATWG')}}Définition initiale.
- -

Compatibilité des navigateurs

- -

{{Compat("api.Window.rejectionhandled_event")}}

- -

Voir également

- - diff --git a/files/fr/web/api/window/rejectionhandled_event/index.md b/files/fr/web/api/window/rejectionhandled_event/index.md new file mode 100644 index 0000000000..ebe167e30f --- /dev/null +++ b/files/fr/web/api/window/rejectionhandled_event/index.md @@ -0,0 +1,82 @@ +--- +title: 'Window: rejectionhandled event' +slug: Web/API/Window/rejectionhandled_event +tags: + - API + - Evènement + - HTML DOM + - JavaScript + - Promesse + - Reference + - Window + - onrejectionhandled + - rejectionhandled +translation_of: Web/API/Window/rejectionhandled_event +--- +
{{APIRef("HTML DOM")}}
+ +

L'événement rejectionhandled est envoyé à la portée globale du script (généralement {{domxref("window")}} mais aussi {{domxref("Worker")}}) chaque fois qu'un JavaScript {{jsxref("Promise")}} est rejeté mais après que le rejet de la promesse a été traité.

+ +

Cela peut être utilisé dans le débogage et pour la résilience générale des applications, en tandem avec l'événement {{domxref ("Window.unhandledrejection_event", "unhandledrejection")}}, qui est envoyé lorsqu'une promesse est rejetée mais qu'il n'y a pas de responsable du rejet .

+ + + + + + + + + + + + + + + + + + + + +
BullesNon
AnnulableNon
Interface{{domxref("PromiseRejectionEvent")}}
Propriété de gestionnaire d'événements{{domxref("WindowEventHandlers.onrejectionhandled", "onrejectionhandled")}}
+ +

Exemple

+ +

Vous pouvez utiliser l'événement rejectionhandled pour consigner les promesses rejetées sur la console, ainsi que les raisons pour lesquelles elles ont été rejetées :

+ +
window.addEventListener("rejectionhandled", event => {
+  console.log("Promise rejected; reason: " + event.reason);
+}, false);
+
+ +

Spécifications

+ + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('HTML WHATWG', 'webappapis.html#unhandled-promise-rejections', 'rejectionhandled')}}{{Spec2('HTML WHATWG')}}Définition initiale.
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Window.rejectionhandled_event")}}

+ +

Voir également

+ + diff --git a/files/fr/web/api/window/requestanimationframe/index.html b/files/fr/web/api/window/requestanimationframe/index.html deleted file mode 100644 index 210fa93d1a..0000000000 --- a/files/fr/web/api/window/requestanimationframe/index.html +++ /dev/null @@ -1,93 +0,0 @@ ---- -title: Window.requestAnimationFrame() -slug: Web/API/Window/requestAnimationFrame -tags: - - API - - DOM - - JavaScript -translation_of: Web/API/window/requestAnimationFrame ---- -

{{APIRef("Window")}}

- -

La méthode window.requestAnimationFrame() notifie le navigateur que vous souhaitez exécuter une animation et demande que celui-ci exécute une fonction spécifique de mise à jour de l'animation, avant le prochain rafraîchissement du navigateur. Cette méthode prend comme argument un callback qui sera appelé avant le rafraîchissement du navigateur.

- -
-

Note : Si vous souhaitez animer une nouvelle frame durant le prochain repaint, votre callback doit appeler la méthode requestAnimationFrame().

-
- -

Vous devez appeler cette méthode dès que vous êtes prêt à rafraîchir votre animation. La fonction contenant l'animation doit être appelée avant que le navigateur n'effectue un nouveau rafraîchissement . En moyenne, le callback sera appelé 60 fois par seconde, cela dépendra de la fréquence de rafraîchissement de votre écran, conformément aux recommandations de la W3C. Cette fréquence peut être inférieure si plusieurs onglets sont ouverts simultanément.

- -

Le callback possède un seul argument, un {{domxref("DOMHighResTimeStamp")}}, qui est le temps, en millisecondes avec une précision minimum de 10 µs, durant lequel l'exécution du rafraîchissement est prévu.

- -

Syntaxe

- -
requestID = window.requestAnimationFrame(callback);       // Firefox 23 / IE 10 / Chrome / Safari 7 (incl. iOS)
-requestID = window.mozRequestAnimationFrame(callback);    // Firefox < 23
-requestID = window.webkitRequestAnimationFrame(callback); // Anciennes versions de Safari / Chrome
-
- -

Paramètres

- -
-
callback
-
Un paramètre définissant la fonction à appeler lorsque votre animation va être rafraîchie lors du prochain rafraîchissement. Le callback ne prend qu'un seul argument, un {{domxref("DOMHighResTimeStamp")}}, qui est le temps à partir duquel requestAnimationFrame va commencer à appeler les callbacks.
-
- -

Valeur retournée

- -

requestID est un entier long unique identifiant l'élément dans la liste des callbacks. C'est une valeur différente de zéro, mais il est prudent de ne pas faire de suppositions sur cette valeur. En passant cette valeur en paramètre de la méthode {{domxref("window.cancelAnimationFrame()")}},  vous annulez l'appel du callback.

- -

Exemple

- -
window.requestAnimationFrame = window.requestAnimationFrame || window.mozRequestAnimationFrame ||
-                              window.webkitRequestAnimationFrame || window.msRequestAnimationFrame;
-
-
-var start = null;
-
-var d = document.getElementById("SomeElementYouWantToAnimate");
-
-function step(timestamp) {
-  var progress;
-  if (start === null) start = timestamp;
-  progress = timestamp - start;
-  d.style.left = Math.min(progress/10, 200) + "px";
-  if (progress < 2000) {
-    requestAnimationFrame(step);
-  }
-}
-
-requestAnimationFrame(step);
-
- -

Compatibilités

- -
-

{{Compat("api.Window.requestAnimationFrame")}}

-
- -

Notes pour Gecko

- -

[1] Avant Gecko 11.0 {{geckoRelease("11.0")}}, mozRequestAnimationFrame() pouvait être appelée sans paramètres d'entrée. Cela n'est plus supporté et n'est pas susceptible d'être standardisé.

- -

[2] Le callback prend comme paramètre un {{domxref("DOMTimeStamp")}} au lieu d'un {{domxref("DOMHighResTimeStamp")}} si c'est la version préfixée qui est utilisée. DOMTimeStamp n'a qu'une précision de l'ordre de la milliseconde, mais DOMHightResTimeStamp a une précision minimale de l'ordre de 10 microsecondes.

- -

Notes pour Chrome

- -

La syntaxe correcte, dans Chrome, pour annuler l'exécution est window.cancelAnimationFrame(). Dans les anciennes versions, window.webkitCancelAnimationFrame() & window.webkitCancelRequestAnimationFrame() sont obsolètes mais sont toujours supportées pour le moment.

- -

Specification

- -

{{spec("http://www.w3.org/TR/animation-timing/#requestAnimationFrame", "Timing control for script-based animations: requestAnimationFrame", "WD")}}

- -

Voir aussi

- - diff --git a/files/fr/web/api/window/requestanimationframe/index.md b/files/fr/web/api/window/requestanimationframe/index.md new file mode 100644 index 0000000000..210fa93d1a --- /dev/null +++ b/files/fr/web/api/window/requestanimationframe/index.md @@ -0,0 +1,93 @@ +--- +title: Window.requestAnimationFrame() +slug: Web/API/Window/requestAnimationFrame +tags: + - API + - DOM + - JavaScript +translation_of: Web/API/window/requestAnimationFrame +--- +

{{APIRef("Window")}}

+ +

La méthode window.requestAnimationFrame() notifie le navigateur que vous souhaitez exécuter une animation et demande que celui-ci exécute une fonction spécifique de mise à jour de l'animation, avant le prochain rafraîchissement du navigateur. Cette méthode prend comme argument un callback qui sera appelé avant le rafraîchissement du navigateur.

+ +
+

Note : Si vous souhaitez animer une nouvelle frame durant le prochain repaint, votre callback doit appeler la méthode requestAnimationFrame().

+
+ +

Vous devez appeler cette méthode dès que vous êtes prêt à rafraîchir votre animation. La fonction contenant l'animation doit être appelée avant que le navigateur n'effectue un nouveau rafraîchissement . En moyenne, le callback sera appelé 60 fois par seconde, cela dépendra de la fréquence de rafraîchissement de votre écran, conformément aux recommandations de la W3C. Cette fréquence peut être inférieure si plusieurs onglets sont ouverts simultanément.

+ +

Le callback possède un seul argument, un {{domxref("DOMHighResTimeStamp")}}, qui est le temps, en millisecondes avec une précision minimum de 10 µs, durant lequel l'exécution du rafraîchissement est prévu.

+ +

Syntaxe

+ +
requestID = window.requestAnimationFrame(callback);       // Firefox 23 / IE 10 / Chrome / Safari 7 (incl. iOS)
+requestID = window.mozRequestAnimationFrame(callback);    // Firefox < 23
+requestID = window.webkitRequestAnimationFrame(callback); // Anciennes versions de Safari / Chrome
+
+ +

Paramètres

+ +
+
callback
+
Un paramètre définissant la fonction à appeler lorsque votre animation va être rafraîchie lors du prochain rafraîchissement. Le callback ne prend qu'un seul argument, un {{domxref("DOMHighResTimeStamp")}}, qui est le temps à partir duquel requestAnimationFrame va commencer à appeler les callbacks.
+
+ +

Valeur retournée

+ +

requestID est un entier long unique identifiant l'élément dans la liste des callbacks. C'est une valeur différente de zéro, mais il est prudent de ne pas faire de suppositions sur cette valeur. En passant cette valeur en paramètre de la méthode {{domxref("window.cancelAnimationFrame()")}},  vous annulez l'appel du callback.

+ +

Exemple

+ +
window.requestAnimationFrame = window.requestAnimationFrame || window.mozRequestAnimationFrame ||
+                              window.webkitRequestAnimationFrame || window.msRequestAnimationFrame;
+
+
+var start = null;
+
+var d = document.getElementById("SomeElementYouWantToAnimate");
+
+function step(timestamp) {
+  var progress;
+  if (start === null) start = timestamp;
+  progress = timestamp - start;
+  d.style.left = Math.min(progress/10, 200) + "px";
+  if (progress < 2000) {
+    requestAnimationFrame(step);
+  }
+}
+
+requestAnimationFrame(step);
+
+ +

Compatibilités

+ +
+

{{Compat("api.Window.requestAnimationFrame")}}

+
+ +

Notes pour Gecko

+ +

[1] Avant Gecko 11.0 {{geckoRelease("11.0")}}, mozRequestAnimationFrame() pouvait être appelée sans paramètres d'entrée. Cela n'est plus supporté et n'est pas susceptible d'être standardisé.

+ +

[2] Le callback prend comme paramètre un {{domxref("DOMTimeStamp")}} au lieu d'un {{domxref("DOMHighResTimeStamp")}} si c'est la version préfixée qui est utilisée. DOMTimeStamp n'a qu'une précision de l'ordre de la milliseconde, mais DOMHightResTimeStamp a une précision minimale de l'ordre de 10 microsecondes.

+ +

Notes pour Chrome

+ +

La syntaxe correcte, dans Chrome, pour annuler l'exécution est window.cancelAnimationFrame(). Dans les anciennes versions, window.webkitCancelAnimationFrame() & window.webkitCancelRequestAnimationFrame() sont obsolètes mais sont toujours supportées pour le moment.

+ +

Specification

+ +

{{spec("http://www.w3.org/TR/animation-timing/#requestAnimationFrame", "Timing control for script-based animations: requestAnimationFrame", "WD")}}

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/window/requestidlecallback/index.html b/files/fr/web/api/window/requestidlecallback/index.html deleted file mode 100644 index ca33f7ac28..0000000000 --- a/files/fr/web/api/window/requestidlecallback/index.html +++ /dev/null @@ -1,65 +0,0 @@ ---- -title: window.requestIdleCallback() -slug: Web/API/Window/requestIdleCallback -translation_of: Web/API/Window/requestIdleCallback ---- -
{{APIRef}}{{SeeCompatTable}}
- -

La méthode window.requestIdleCallback() mémorise une fonction qui sera appellée lorsque le navigateur n'aura plus aucune autre tâche en cours. Cela offre au développeur la possibilité de réaliser des tâches à basse priorité en arrière-plan sur le thread principal, sans impacter l'expérience utilisateur (ralentissement des animations, etc). L'ordre des appels aux fonctions est généralement premier entré, premier sorti, sauf si le timeout défini au moment de l'enregistrement est atteint avant que le navigateur n'ait eu le temps d'appeler la fonction en question.

- -

Syntaxe

- -
var idleCallbackId = window.requestIdleCallback(fonction[, options])
- -

Retour de l'appel

- -

Un entier long non-signé qui peut être utilisé pour annulé l'appel à la fonction via la méthode {{domxref("window.cancelIdleCallback()")}}.

- -

Paramètres

- -
-
fonction
-
La référence d'une fonction qui devrait être appellée dans un futur proche. La fonction en question recevra en argument un objet de type temps restant avec les propriétés suivantes : -
    -
  • timeRemaining : Fonction qui retourne un {{domxref("DOMHighResTimeStamp")}} repésentant le temps restant estimé par le navigateur pour exécuter la tâche, ayant pour valeur minimale zéro. Les tâches nécessitant un temps d'exécution relativement long sont susceptibles de recourir à plusieurs appels à cette méthode s'il reste du travail à effectuer, rendant la main au navigateur peu avant que le compteur n'atteigne zéro. timeRemaining() retournera toujours zéro si didTimeout est positionné à true (i.e. la fonction n'a pas été appelée durant la période de repos du navigateur). La limite de temps est limitée à 50ms, même si le navigateur reste n'a pas d'autre tâche à exécuter pendant une durée plus longue.
    • -
  • didTimeout : Un booléen positionné à true si la fonction est appelée car le timeout a été atteint, et false si elle a été appelée par le navigateur durant une période de repos.
    • -
-
-
options {{optional_inline}}
-
Objet contenant des paramètres de configuration optionnels. Les propriétés sont les suivantes : -
    -
  • timeout : Si timeout est spécifié et possède une valeur positive, la fonction sera appelée au bout de au moins timeout millisecondes si elle n'a pas été appelée par le navigateur au préalable.
    • -
-
-
- -

Spécifications

- - - - - - - - - - - - - - -
SpécificationStatusComment
{{SpecName('Background Tasks')}}{{Spec2('Background Tasks')}}Définition initiale.
- -

Compatibilité des navigateurs

- -

{{Compat("api.Window.requestIdleCallback")}}

- -

Voir aussi

- - diff --git a/files/fr/web/api/window/requestidlecallback/index.md b/files/fr/web/api/window/requestidlecallback/index.md new file mode 100644 index 0000000000..ca33f7ac28 --- /dev/null +++ b/files/fr/web/api/window/requestidlecallback/index.md @@ -0,0 +1,65 @@ +--- +title: window.requestIdleCallback() +slug: Web/API/Window/requestIdleCallback +translation_of: Web/API/Window/requestIdleCallback +--- +
{{APIRef}}{{SeeCompatTable}}
+ +

La méthode window.requestIdleCallback() mémorise une fonction qui sera appellée lorsque le navigateur n'aura plus aucune autre tâche en cours. Cela offre au développeur la possibilité de réaliser des tâches à basse priorité en arrière-plan sur le thread principal, sans impacter l'expérience utilisateur (ralentissement des animations, etc). L'ordre des appels aux fonctions est généralement premier entré, premier sorti, sauf si le timeout défini au moment de l'enregistrement est atteint avant que le navigateur n'ait eu le temps d'appeler la fonction en question.

+ +

Syntaxe

+ +
var idleCallbackId = window.requestIdleCallback(fonction[, options])
+ +

Retour de l'appel

+ +

Un entier long non-signé qui peut être utilisé pour annulé l'appel à la fonction via la méthode {{domxref("window.cancelIdleCallback()")}}.

+ +

Paramètres

+ +
+
fonction
+
La référence d'une fonction qui devrait être appellée dans un futur proche. La fonction en question recevra en argument un objet de type temps restant avec les propriétés suivantes : +
    +
  • timeRemaining : Fonction qui retourne un {{domxref("DOMHighResTimeStamp")}} repésentant le temps restant estimé par le navigateur pour exécuter la tâche, ayant pour valeur minimale zéro. Les tâches nécessitant un temps d'exécution relativement long sont susceptibles de recourir à plusieurs appels à cette méthode s'il reste du travail à effectuer, rendant la main au navigateur peu avant que le compteur n'atteigne zéro. timeRemaining() retournera toujours zéro si didTimeout est positionné à true (i.e. la fonction n'a pas été appelée durant la période de repos du navigateur). La limite de temps est limitée à 50ms, même si le navigateur reste n'a pas d'autre tâche à exécuter pendant une durée plus longue.
    • +
  • didTimeout : Un booléen positionné à true si la fonction est appelée car le timeout a été atteint, et false si elle a été appelée par le navigateur durant une période de repos.
    • +
+
+
options {{optional_inline}}
+
Objet contenant des paramètres de configuration optionnels. Les propriétés sont les suivantes : +
    +
  • timeout : Si timeout est spécifié et possède une valeur positive, la fonction sera appelée au bout de au moins timeout millisecondes si elle n'a pas été appelée par le navigateur au préalable.
    • +
+
+
+ +

Spécifications

+ + + + + + + + + + + + + + +
SpécificationStatusComment
{{SpecName('Background Tasks')}}{{Spec2('Background Tasks')}}Définition initiale.
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Window.requestIdleCallback")}}

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/window/resizeby/index.html b/files/fr/web/api/window/resizeby/index.html deleted file mode 100644 index 4d3a8873d6..0000000000 --- a/files/fr/web/api/window/resizeby/index.html +++ /dev/null @@ -1,73 +0,0 @@ ---- -title: Window.resizeBy() -slug: Web/API/Window/resizeBy -tags: - - API - - Window -translation_of: Web/API/Window/resizeBy ---- -
{{APIRef}}
- -

La méthode Window.resizeBy() redimensionne la fenêtre actuelle d'une taille spécifié.

- -

Syntaxe

- -
window.resizeBy(xDelta, yDelta)
-
- -

Paramètres

- - - -

Exemple

- -
// Réduit la fenêtre
-window.resizeBy(-200, -200);
-
- -

Notes

- -

Cette méthode redimensionne la fenêtre par rapport à sa taille actuelle. Pour redimensionner la fenêtre en termes absolus, utilisez {{domxref ("window.resizeTo ()")}}.

- -

Créer et redimensionner une fenêtre externe

- -

Pour des raisons de sécurité, il n'est plus possible dans Firefox pour un site Web de modifier la taille par défaut d'une fenêtre dans un navigateur si la fenêtre n'a pas été créée par window.open() ou contient plusieurs onglets. Consultez le tableau de compatibilité pour plus de détails sur le changement.

- -

Même si vous créez une fenêtre avec window.open() elle n'est pas redimensionnable par défaut. Pour rendre la fenêtre redimensionnable, vous devez l'ouvrir avec le paramètre "resizable" .

- -
// Créer une fenêtre redimensionnable
-myExternalWindow = window.open("http://myurl.domain", "myWindowName", "resizable");
-
-// Redimensionner la fenêtre à 500 x 500
-myExternalWindow.resizeTo(500, 500);
-
-// Rendre la fenêtre relativement plus petit à 400 x 400
-myExternalWindow.resizeBy(-100, -100);
- -

La fenêtre que vous créez doit respecter la politique de même origine. Si la fenêtre que vous ouvrez n'est pas dans la même origine que la fenêtre actuelle, vous ne pourrez pas redimensionner ni accéder aux informations sur cette fenêtre / cet onglet.

- -

Spécifications

- - - - - - - - - - - - - - - - -
SpécificationStatutCommentaires
{{ SpecName('CSSOM View', '#dom-window-resizeby', 'window.resizeBy()') }}{{ Spec2('CSSOM View') }}
- -

Compatibilité des navigateurs

- -

{{Compat("api.Window.resizeBy")}}

diff --git a/files/fr/web/api/window/resizeby/index.md b/files/fr/web/api/window/resizeby/index.md new file mode 100644 index 0000000000..4d3a8873d6 --- /dev/null +++ b/files/fr/web/api/window/resizeby/index.md @@ -0,0 +1,73 @@ +--- +title: Window.resizeBy() +slug: Web/API/Window/resizeBy +tags: + - API + - Window +translation_of: Web/API/Window/resizeBy +--- +
{{APIRef}}
+ +

La méthode Window.resizeBy() redimensionne la fenêtre actuelle d'une taille spécifié.

+ +

Syntaxe

+ +
window.resizeBy(xDelta, yDelta)
+
+ +

Paramètres

+ + + +

Exemple

+ +
// Réduit la fenêtre
+window.resizeBy(-200, -200);
+
+ +

Notes

+ +

Cette méthode redimensionne la fenêtre par rapport à sa taille actuelle. Pour redimensionner la fenêtre en termes absolus, utilisez {{domxref ("window.resizeTo ()")}}.

+ +

Créer et redimensionner une fenêtre externe

+ +

Pour des raisons de sécurité, il n'est plus possible dans Firefox pour un site Web de modifier la taille par défaut d'une fenêtre dans un navigateur si la fenêtre n'a pas été créée par window.open() ou contient plusieurs onglets. Consultez le tableau de compatibilité pour plus de détails sur le changement.

+ +

Même si vous créez une fenêtre avec window.open() elle n'est pas redimensionnable par défaut. Pour rendre la fenêtre redimensionnable, vous devez l'ouvrir avec le paramètre "resizable" .

+ +
// Créer une fenêtre redimensionnable
+myExternalWindow = window.open("http://myurl.domain", "myWindowName", "resizable");
+
+// Redimensionner la fenêtre à 500 x 500
+myExternalWindow.resizeTo(500, 500);
+
+// Rendre la fenêtre relativement plus petit à 400 x 400
+myExternalWindow.resizeBy(-100, -100);
+ +

La fenêtre que vous créez doit respecter la politique de même origine. Si la fenêtre que vous ouvrez n'est pas dans la même origine que la fenêtre actuelle, vous ne pourrez pas redimensionner ni accéder aux informations sur cette fenêtre / cet onglet.

+ +

Spécifications

+ + + + + + + + + + + + + + + + +
SpécificationStatutCommentaires
{{ SpecName('CSSOM View', '#dom-window-resizeby', 'window.resizeBy()') }}{{ Spec2('CSSOM View') }}
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Window.resizeBy")}}

diff --git a/files/fr/web/api/window/screen/index.html b/files/fr/web/api/window/screen/index.html deleted file mode 100644 index c86fcb6f61..0000000000 --- a/files/fr/web/api/window/screen/index.html +++ /dev/null @@ -1,55 +0,0 @@ ---- -title: Window.screen -slug: Web/API/Window/screen -tags: - - API - - CSSOM View - - DOM - - Fenêtre - - Propriété - - Vue CSSOM - - Écran -translation_of: Web/API/Window/screen ---- -
{{APIRef("CSSOM View")}}
- -
Retourne une référence à l'objet screen associé à la fenêtre. L'object screen, qui implémente l'interface {{domxref("Screen")}}, est un objet spécial servant à examiner les propriétés de l'écran qui affiche la fenêtre courante.
- -

Syntaxe

- -
objetEcran = window.screen;
-
- -

Examples

- -
if (screen.pixelDepth < 8) {
-  // utiliser la page en colorisation réduite
-} else {
-  // utiliser la page en coolorisation normale
-}
-
- -

Spécifications

- - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{SpecName('CSSOM View', '#dom-window-screen', 'window.screen')}}{{Spec2('CSSOM View')}} 
- -

Compatibilité des navigateurs

- - - -

{{Compat("api.Window.screen")}}

diff --git a/files/fr/web/api/window/screen/index.md b/files/fr/web/api/window/screen/index.md new file mode 100644 index 0000000000..c86fcb6f61 --- /dev/null +++ b/files/fr/web/api/window/screen/index.md @@ -0,0 +1,55 @@ +--- +title: Window.screen +slug: Web/API/Window/screen +tags: + - API + - CSSOM View + - DOM + - Fenêtre + - Propriété + - Vue CSSOM + - Écran +translation_of: Web/API/Window/screen +--- +
{{APIRef("CSSOM View")}}
+ +
Retourne une référence à l'objet screen associé à la fenêtre. L'object screen, qui implémente l'interface {{domxref("Screen")}}, est un objet spécial servant à examiner les propriétés de l'écran qui affiche la fenêtre courante.
+ +

Syntaxe

+ +
objetEcran = window.screen;
+
+ +

Examples

+ +
if (screen.pixelDepth < 8) {
+  // utiliser la page en colorisation réduite
+} else {
+  // utiliser la page en coolorisation normale
+}
+
+ +

Spécifications

+ + + + + + + + + + + + + + + + +
SpécificationÉtatCommentaires
{{SpecName('CSSOM View', '#dom-window-screen', 'window.screen')}}{{Spec2('CSSOM View')}} 
+ +

Compatibilité des navigateurs

+ + + +

{{Compat("api.Window.screen")}}

diff --git a/files/fr/web/api/window/screenx/index.html b/files/fr/web/api/window/screenx/index.html deleted file mode 100644 index 2ff4f0dc7b..0000000000 --- a/files/fr/web/api/window/screenx/index.html +++ /dev/null @@ -1,52 +0,0 @@ ---- -title: Window.screenX -slug: Web/API/Window/screenX -tags: - - API - - Propriété - - Window - - lecture seule -translation_of: Web/API/Window/screenX ---- -
{{APIRef}}
- -

La propriété  Window.screenX retourne la distance honrizontale, in CSS pixels, of the left border of the user's browser from the left side of the screen.

- -

Syntax

- -
lLoc = window.screenX
-
- - - -

Specifications

- - - - - - - - - - - - - - - - -
SpecificationStatusCommentaire
{{ SpecName('CSSOM View', '#dom-window-screenx', 'Window.screenX') }}{{ Spec2('CSSOM View') }}Définition initiale
- -

Compatibilité des navigateurs

- -

{{Compat("api.Window.screenX")}}

- -

Voir aussi

- - diff --git a/files/fr/web/api/window/screenx/index.md b/files/fr/web/api/window/screenx/index.md new file mode 100644 index 0000000000..2ff4f0dc7b --- /dev/null +++ b/files/fr/web/api/window/screenx/index.md @@ -0,0 +1,52 @@ +--- +title: Window.screenX +slug: Web/API/Window/screenX +tags: + - API + - Propriété + - Window + - lecture seule +translation_of: Web/API/Window/screenX +--- +
{{APIRef}}
+ +

La propriété  Window.screenX retourne la distance honrizontale, in CSS pixels, of the left border of the user's browser from the left side of the screen.

+ +

Syntax

+ +
lLoc = window.screenX
+
+ + + +

Specifications

+ + + + + + + + + + + + + + + + +
SpecificationStatusCommentaire
{{ SpecName('CSSOM View', '#dom-window-screenx', 'Window.screenX') }}{{ Spec2('CSSOM View') }}Définition initiale
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Window.screenX")}}

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/window/scroll/index.html b/files/fr/web/api/window/scroll/index.html deleted file mode 100644 index 17ae626928..0000000000 --- a/files/fr/web/api/window/scroll/index.html +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: window.scroll -slug: Web/API/Window/scroll -translation_of: Web/API/Window/scroll ---- -

{{ ApiRef() }}

- -

Fait glisser la fenêtre vers une position particulière du document

-

Syntax

-
window.scroll(x-coord,y-coord)
-
-

Parameters

- -

Example

-
 // Déplace la fenêtre 100px plus bas
- <button onClick="scroll(0, 100);">click to scroll down 100 pixels</button>
-
-

Notes

-

window.scrollTo a un effet identique à cette méthode. Pour se déplacer par pas dans la page, utilisez window.scrollBy. Jetez aussi un œil à window.scrollByLines et window.scrollByPages.

-

Specification

-

DOM Level 0. Hors spécification.

\ No newline at end of file diff --git a/files/fr/web/api/window/scroll/index.md b/files/fr/web/api/window/scroll/index.md new file mode 100644 index 0000000000..17ae626928 --- /dev/null +++ b/files/fr/web/api/window/scroll/index.md @@ -0,0 +1,24 @@ +--- +title: window.scroll +slug: Web/API/Window/scroll +translation_of: Web/API/Window/scroll +--- +

{{ ApiRef() }}

+ +

Fait glisser la fenêtre vers une position particulière du document

+

Syntax

+
window.scroll(x-coord,y-coord)
+
+

Parameters

+ +

Example

+
 // Déplace la fenêtre 100px plus bas
+ <button onClick="scroll(0, 100);">click to scroll down 100 pixels</button>
+
+

Notes

+

window.scrollTo a un effet identique à cette méthode. Pour se déplacer par pas dans la page, utilisez window.scrollBy. Jetez aussi un œil à window.scrollByLines et window.scrollByPages.

+

Specification

+

DOM Level 0. Hors spécification.

\ No newline at end of file diff --git a/files/fr/web/api/window/scrollbars/index.html b/files/fr/web/api/window/scrollbars/index.html deleted file mode 100644 index 1a292aed78..0000000000 --- a/files/fr/web/api/window/scrollbars/index.html +++ /dev/null @@ -1,73 +0,0 @@ ---- -title: Window.scrollbars -slug: Web/API/Window/scrollbars -tags: - - API - - HTML DOM - - Propriété - - Reference - - Window -translation_of: Web/API/Window/scrollbars ---- -
{{APIRef()}}
- -

La propriété Window.scrollbars renvoie l'objet scrollbars, dont la visibilité peut être vérifié.

- -

Syntaxe

- -
objRef = window.scrollbars
-
- -

Exemple

- -

L'exemple HTML complet suivant montre comment la propriété visible de l'objet scrollbars est utilisée.

- -
<!doctype html>
-<html>
-<head>
-  <title>Divers Tests DOM</title>
-  <script>
-    let visibleScrollbars = window.scrollbars.visible;
-  </script>
-</head>
-<body>
-  <p>Divers Tests DOM</p>
-</body>
-</html>
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('HTML WHATWG', 'browsers.html#dom-window-scrollbars', 'Window.scrollbars')}}{{Spec2('HTML WHATWG')}}
{{SpecName('HTML5 W3C', 'browsers.html#dom-window-scrollbars', 'Window.scrollbars')}}{{Spec2('HTML5 W3C')}}
- -

Compatibilité des navigateurs

- -

{{Compat("api.Window.scrollbars")}}

- -

Voir également

- - diff --git a/files/fr/web/api/window/scrollbars/index.md b/files/fr/web/api/window/scrollbars/index.md new file mode 100644 index 0000000000..1a292aed78 --- /dev/null +++ b/files/fr/web/api/window/scrollbars/index.md @@ -0,0 +1,73 @@ +--- +title: Window.scrollbars +slug: Web/API/Window/scrollbars +tags: + - API + - HTML DOM + - Propriété + - Reference + - Window +translation_of: Web/API/Window/scrollbars +--- +
{{APIRef()}}
+ +

La propriété Window.scrollbars renvoie l'objet scrollbars, dont la visibilité peut être vérifié.

+ +

Syntaxe

+ +
objRef = window.scrollbars
+
+ +

Exemple

+ +

L'exemple HTML complet suivant montre comment la propriété visible de l'objet scrollbars est utilisée.

+ +
<!doctype html>
+<html>
+<head>
+  <title>Divers Tests DOM</title>
+  <script>
+    let visibleScrollbars = window.scrollbars.visible;
+  </script>
+</head>
+<body>
+  <p>Divers Tests DOM</p>
+</body>
+</html>
+
+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('HTML WHATWG', 'browsers.html#dom-window-scrollbars', 'Window.scrollbars')}}{{Spec2('HTML WHATWG')}}
{{SpecName('HTML5 W3C', 'browsers.html#dom-window-scrollbars', 'Window.scrollbars')}}{{Spec2('HTML5 W3C')}}
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Window.scrollbars")}}

+ +

Voir également

+ + diff --git a/files/fr/web/api/window/scrollby/index.html b/files/fr/web/api/window/scrollby/index.html deleted file mode 100644 index 8713385ca8..0000000000 --- a/files/fr/web/api/window/scrollby/index.html +++ /dev/null @@ -1,56 +0,0 @@ ---- -title: Window.scrollBy() -slug: Web/API/Window/scrollBy -tags: - - API - - CSSOM View - - Méthode - - Référence(2) -translation_of: Web/API/Window/scrollBy ---- -

{{ APIRef() }}

- -

Fait défiler le document dans la fenêtre du nombre de pixels passé en paramètre.

- -

Syntaxe

- -
window.scrollBy(X, Y);
-
- -

Paramètres

- - - -

Des coordonnées positives feront défiler à droite et vers le bas de la page. Des coordonnées négatives feront défiler à gauche et vers le haut de la page. 

- -

Exemples

- -
// fait défiler d'une page
-window.scrollBy(0, window.innerHeight);
-
- -

Notes

- -

window.scrollBy fait défiler en fonction d'un nombre précis, alors que window.scroll fait défiler vers une position absolue dans le document. Voir aussi window.scrollByLines, window.scrollByPages

- -

Spécification

- - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{ SpecName('CSSOM View', '#dom-window-scrollby', 'window.scrollBy()') }}{{ Spec2('CSSOM View') }}Définition initiale.
diff --git a/files/fr/web/api/window/scrollby/index.md b/files/fr/web/api/window/scrollby/index.md new file mode 100644 index 0000000000..8713385ca8 --- /dev/null +++ b/files/fr/web/api/window/scrollby/index.md @@ -0,0 +1,56 @@ +--- +title: Window.scrollBy() +slug: Web/API/Window/scrollBy +tags: + - API + - CSSOM View + - Méthode + - Référence(2) +translation_of: Web/API/Window/scrollBy +--- +

{{ APIRef() }}

+ +

Fait défiler le document dans la fenêtre du nombre de pixels passé en paramètre.

+ +

Syntaxe

+ +
window.scrollBy(X, Y);
+
+ +

Paramètres

+ + + +

Des coordonnées positives feront défiler à droite et vers le bas de la page. Des coordonnées négatives feront défiler à gauche et vers le haut de la page. 

+ +

Exemples

+ +
// fait défiler d'une page
+window.scrollBy(0, window.innerHeight);
+
+ +

Notes

+ +

window.scrollBy fait défiler en fonction d'un nombre précis, alors que window.scroll fait défiler vers une position absolue dans le document. Voir aussi window.scrollByLines, window.scrollByPages

+ +

Spécification

+ + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{ SpecName('CSSOM View', '#dom-window-scrollby', 'window.scrollBy()') }}{{ Spec2('CSSOM View') }}Définition initiale.
diff --git a/files/fr/web/api/window/scrollbylines/index.html b/files/fr/web/api/window/scrollbylines/index.html deleted file mode 100644 index eac61c0802..0000000000 --- a/files/fr/web/api/window/scrollbylines/index.html +++ /dev/null @@ -1,49 +0,0 @@ ---- -title: Window.scrollByLines() -slug: Web/API/Window/scrollByLines -tags: - - API - - DOM - - DOM_0 - - Méthode - - Non-standard - - Window -translation_of: Web/API/Window/scrollByLines ---- -
{{ ApiRef() }}
- -

{{Non-standard_header}}

- -

Fait défiler le document du nombre de lignes spécifié.

- -

Syntaxe

- -
window.scrollByLines(lignes)
-
- -

Paramètres

- - - -

Exemples

- -
<!-- Faire défiler le document de 5 lignes vers le bas. -->
-<button onclick="scrollByLines(5);">5 lignes vers le bas</button>
-
- -
<!-- Faire défiler le document de 5 lignes vers le haut. -->
-<button onclick="scrollByLines(-5);">5 lignes vers le haut</button>
-
- -

Spécification

- -

Ne fait partie d'aucune spécification.

- -

See also

- - diff --git a/files/fr/web/api/window/scrollbylines/index.md b/files/fr/web/api/window/scrollbylines/index.md new file mode 100644 index 0000000000..eac61c0802 --- /dev/null +++ b/files/fr/web/api/window/scrollbylines/index.md @@ -0,0 +1,49 @@ +--- +title: Window.scrollByLines() +slug: Web/API/Window/scrollByLines +tags: + - API + - DOM + - DOM_0 + - Méthode + - Non-standard + - Window +translation_of: Web/API/Window/scrollByLines +--- +
{{ ApiRef() }}
+ +

{{Non-standard_header}}

+ +

Fait défiler le document du nombre de lignes spécifié.

+ +

Syntaxe

+ +
window.scrollByLines(lignes)
+
+ +

Paramètres

+ + + +

Exemples

+ +
<!-- Faire défiler le document de 5 lignes vers le bas. -->
+<button onclick="scrollByLines(5);">5 lignes vers le bas</button>
+
+ +
<!-- Faire défiler le document de 5 lignes vers le haut. -->
+<button onclick="scrollByLines(-5);">5 lignes vers le haut</button>
+
+ +

Spécification

+ +

Ne fait partie d'aucune spécification.

+ +

See also

+ + diff --git a/files/fr/web/api/window/scrollbypages/index.html b/files/fr/web/api/window/scrollbypages/index.html deleted file mode 100644 index 8419d43545..0000000000 --- a/files/fr/web/api/window/scrollbypages/index.html +++ /dev/null @@ -1,42 +0,0 @@ ---- -title: Window.scrollByPages() -slug: Web/API/Window/scrollByPages -tags: - - API - - DOM - - Gecko - - Méthode -translation_of: Web/API/Window/scrollByPages ---- -

{{ ApiRef() }}{{Non-standard_header}}

- -

Fait défiler le document du nombre de pages spécifié.

- -

Syntaxe

- -
window.scrollByPages(pages)
-
- -

Paramètres

- - - -

Exemples

- -
// fait défiler le document d'une page vers le bas
-window.scrollByPages(1);
-
-// fait défiler le document d'une page vers le haut
-window.scrollByPages(-1);
-
- -

Notes

- -

Voir aussi window.scrollBy, window.scrollByLines, window.scroll, window.scrollTo.

- -

Spécification

- -

DOM Niveau 0. Ne fait pas partie de la spécification.

\ No newline at end of file diff --git a/files/fr/web/api/window/scrollbypages/index.md b/files/fr/web/api/window/scrollbypages/index.md new file mode 100644 index 0000000000..8419d43545 --- /dev/null +++ b/files/fr/web/api/window/scrollbypages/index.md @@ -0,0 +1,42 @@ +--- +title: Window.scrollByPages() +slug: Web/API/Window/scrollByPages +tags: + - API + - DOM + - Gecko + - Méthode +translation_of: Web/API/Window/scrollByPages +--- +

{{ ApiRef() }}{{Non-standard_header}}

+ +

Fait défiler le document du nombre de pages spécifié.

+ +

Syntaxe

+ +
window.scrollByPages(pages)
+
+ +

Paramètres

+ + + +

Exemples

+ +
// fait défiler le document d'une page vers le bas
+window.scrollByPages(1);
+
+// fait défiler le document d'une page vers le haut
+window.scrollByPages(-1);
+
+ +

Notes

+ +

Voir aussi window.scrollBy, window.scrollByLines, window.scroll, window.scrollTo.

+ +

Spécification

+ +

DOM Niveau 0. Ne fait pas partie de la spécification.

\ No newline at end of file diff --git a/files/fr/web/api/window/scrollto/index.html b/files/fr/web/api/window/scrollto/index.html deleted file mode 100644 index 753059d1c9..0000000000 --- a/files/fr/web/api/window/scrollto/index.html +++ /dev/null @@ -1,38 +0,0 @@ ---- -title: window.scrollTo -slug: Web/API/Window/scrollTo -tags: - - DOM - - DOM_0 -translation_of: Web/API/Window/scrollTo ---- -

{{ ApiRef() }}

- -

Résumé

- -

Fait défiler le document jusqu'à un jeu de coordonnées particulier.

- -

Syntaxe

- -
window.scrollTo(coord-x,coord-y);
-
- -

Paramètres

- - - -

Exemple

- -
window.scrollTo(0, 1000);
-
- -

Notes

- -

Cette fonction est fonctionnellement identique à window.scroll. Pour un défilement relatif, consultez window.scrollBy, window.scrollByLines et window.scrollByPages.

- -

Spécification

- -

{{ DOM0() }}

diff --git a/files/fr/web/api/window/scrollto/index.md b/files/fr/web/api/window/scrollto/index.md new file mode 100644 index 0000000000..753059d1c9 --- /dev/null +++ b/files/fr/web/api/window/scrollto/index.md @@ -0,0 +1,38 @@ +--- +title: window.scrollTo +slug: Web/API/Window/scrollTo +tags: + - DOM + - DOM_0 +translation_of: Web/API/Window/scrollTo +--- +

{{ ApiRef() }}

+ +

Résumé

+ +

Fait défiler le document jusqu'à un jeu de coordonnées particulier.

+ +

Syntaxe

+ +
window.scrollTo(coord-x,coord-y);
+
+ +

Paramètres

+ + + +

Exemple

+ +
window.scrollTo(0, 1000);
+
+ +

Notes

+ +

Cette fonction est fonctionnellement identique à window.scroll. Pour un défilement relatif, consultez window.scrollBy, window.scrollByLines et window.scrollByPages.

+ +

Spécification

+ +

{{ DOM0() }}

diff --git a/files/fr/web/api/window/scrolly/index.html b/files/fr/web/api/window/scrolly/index.html deleted file mode 100644 index 6d556c1eae..0000000000 --- a/files/fr/web/api/window/scrolly/index.html +++ /dev/null @@ -1,71 +0,0 @@ ---- -title: Window.scrollY -slug: Web/API/Window/scrollY -translation_of: Web/API/Window/scrollY ---- -
{{APIRef}}
- -

La propriété scrollY de l'objet {{domxref("Window")}} est une propriété en lecture seule. Elle retourne le nombre de pixels la page actuellement défilés verticalement. Dans les navigateurs modernes, cette valeur est précise au sous-pixel près. Ainsi, la valeur retournée n'est pas forcement un entier.

- -

Syntaxe

- -
var y = window.scrollY;
- - - -

Exemple

- -
// make sure and go down to the second page
-if (window.scrollY) {
-  window.scroll(0, 0);  // reset the scroll position to the top left of the document.
-}
-
-window.scrollByPages(1);
- -

Notes

- -

Utilisez cette propriété pour être sûre que le document n'as pas été défilé verticalement si vous utilisez les fonctions de défilement tels que {{domxref("window.scrollBy")}}, {{domxref("window.scrollByLines")}}, ou {{domxref("window.scrollByPages")}}.

- -

La propriété pageYOffset est un alias de la propriété scrollY:

- -
window.pageYOffset == window.scrollY; // toujours vrai
- -

Pour une compatibilité multi-navigateur, utilisez window.pageYOffset à la place de window.scrollY. En outre, les anciennes versions d'Internet Explorer (< 9) ne supportent pas non plus la propriété et doit-être utilisé à l'aide d'autres propriétés qui ne sont pas standards. Un exemple entièrement compatible :

- -
var supportPageOffset = window.pageXOffset !== undefined;
-var isCSS1Compat = ((document.compatMode || "") === "CSS1Compat");
-
-var x = supportPageOffset ? window.pageXOffset : isCSS1Compat ? document.documentElement.scrollLeft : document.body.scrollLeft;
-var y = supportPageOffset ? window.pageYOffset : isCSS1Compat ? document.documentElement.scrollTop : document.body.scrollTop;
-
- -

Spécifications

- - - - - - - - - - - - - - - - -
SpécificationStatusCommentaire(s)
{{ SpecName('CSSOM View', '#dom-window-scrolly', 'window.scrollY') }}{{ Spec2('CSSOM View') }}
- -

Compatibilité des navigateurs

- -

{{Compat("api.Window.scrollY")}}

- -

Voir aussi

- - diff --git a/files/fr/web/api/window/scrolly/index.md b/files/fr/web/api/window/scrolly/index.md new file mode 100644 index 0000000000..6d556c1eae --- /dev/null +++ b/files/fr/web/api/window/scrolly/index.md @@ -0,0 +1,71 @@ +--- +title: Window.scrollY +slug: Web/API/Window/scrollY +translation_of: Web/API/Window/scrollY +--- +
{{APIRef}}
+ +

La propriété scrollY de l'objet {{domxref("Window")}} est une propriété en lecture seule. Elle retourne le nombre de pixels la page actuellement défilés verticalement. Dans les navigateurs modernes, cette valeur est précise au sous-pixel près. Ainsi, la valeur retournée n'est pas forcement un entier.

+ +

Syntaxe

+ +
var y = window.scrollY;
+ + + +

Exemple

+ +
// make sure and go down to the second page
+if (window.scrollY) {
+  window.scroll(0, 0);  // reset the scroll position to the top left of the document.
+}
+
+window.scrollByPages(1);
+ +

Notes

+ +

Utilisez cette propriété pour être sûre que le document n'as pas été défilé verticalement si vous utilisez les fonctions de défilement tels que {{domxref("window.scrollBy")}}, {{domxref("window.scrollByLines")}}, ou {{domxref("window.scrollByPages")}}.

+ +

La propriété pageYOffset est un alias de la propriété scrollY:

+ +
window.pageYOffset == window.scrollY; // toujours vrai
+ +

Pour une compatibilité multi-navigateur, utilisez window.pageYOffset à la place de window.scrollY. En outre, les anciennes versions d'Internet Explorer (< 9) ne supportent pas non plus la propriété et doit-être utilisé à l'aide d'autres propriétés qui ne sont pas standards. Un exemple entièrement compatible :

+ +
var supportPageOffset = window.pageXOffset !== undefined;
+var isCSS1Compat = ((document.compatMode || "") === "CSS1Compat");
+
+var x = supportPageOffset ? window.pageXOffset : isCSS1Compat ? document.documentElement.scrollLeft : document.body.scrollLeft;
+var y = supportPageOffset ? window.pageYOffset : isCSS1Compat ? document.documentElement.scrollTop : document.body.scrollTop;
+
+ +

Spécifications

+ + + + + + + + + + + + + + + + +
SpécificationStatusCommentaire(s)
{{ SpecName('CSSOM View', '#dom-window-scrolly', 'window.scrollY') }}{{ Spec2('CSSOM View') }}
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Window.scrollY")}}

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/window/sessionstorage/index.html b/files/fr/web/api/window/sessionstorage/index.html deleted file mode 100644 index 64a4e4cc27..0000000000 --- a/files/fr/web/api/window/sessionstorage/index.html +++ /dev/null @@ -1,89 +0,0 @@ ---- -title: Window.sessionStorage -slug: Web/API/Window/sessionStorage -tags: - - API -translation_of: Web/API/Window/sessionStorage ---- -

{{APIRef}}

- -

La propriété sessionStorage permet d'utiliser un objet {{domxref("Storage")}} valable pour la session de navigation en cours et pour les pages du même domaine que la page actuelle. L'objet global sessionStorage est similaire à {{domxref("Window.localStorage")}}, à la différence que les données enregistrées dans sessionStorage ont une durée vie limitée et expirent à la fin de la session de navigation actuelle. Une session de navigation dure aussi longtemps que le navigateur est ouvert et s'étend sur plusieurs chargements, rechargements et restaurations de pages. En revanche, une session de navigation n'est valable que pour le contexte de navigation actuel, c'est-à-dire que le fait d'ouvrir une page dans un nouvel onglet ou dans une nouvelle fenêtre provoquera l'initialisation d'une nouvelle session de navigation, ce qui diffère du comportement des sessions utilisant des cookies.

- -

Il est à noter que les données stockées dans sessionStorage ou localStorage sont spécifiques au protocole de la page.

- -

Syntaxe

- -
// Enregistrer des données dans sessionStorage
-sessionStorage.setItem('clé', 'valeur');
-
-// Récupérer des données depuis sessionStorage
-var data = sessionStorage.getItem('clé');
-
-// Supprimer des données de sessionStorage
-sessionStorage.removeItem('clé');
-
-// Supprimer toutes les données de sessionStorage
-sessionStorage.clear();
-
- -

Valeur

- -

Un objet {{domxref("Storage")}}.

- -

Exemple

- -

L'exemple de code suivant accède à l'objet de stockage de session associé au domaine actuel et y ajoute une donnée à l'aide de {{domxref("Storage.setItem()")}}.

- -
sessionStorage.setItem('myCat', 'Tom');
- -

L'exemple suivant sauvegarde automatiquement le contenu d'un champ textuel. Si la page est accidentellement rafraîchie, le contenu du champ est restauré de sorte qu'aucune saisie n'est perdue.

- -
// Récupération du champ à enregistrer
-var champ = document.getElementById("champ");
-
-// Vérification de l'existence d'une donnée enregistrée auparavant
-// (ce ne sera le cas que si la page a été rafraîchie)
-if (sessionStorage.getItem("autosave")) {
-  // Restauration du contenu du champ
-  champ.value = sessionStorage.getItem("autosave");
-}
-
-// Écoute des changements de valeur du champ
-champ.addEventListener("change", function() {
-  // Enregistrement de la saisie utilisateur dans le stockage de session
-  sessionStorage.setItem("autosave", champ.value);
-});
- -
-

Note : Veuillez vous référer à l'article Utilisation de l'API Web Storage pour des exemples plus complets.

-
- -

Spécifications

- - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName("HTML WHATWG", "webstorage.html#dom-sessionstorage", "sessionStorage")}}{{Spec2("HTML WHATWG")}}
- -

Compatilibité des navigateurs

- -

{{Compat("api.Window.sessionStorage")}}

- -

Chaque navigateur attribue des capacités de stockage limitées pour localStorage et sessionStorage. Vous en trouverez certaines dans ce récapitulatif de tests des capacités de stockage attribuées en fonction du navigateur.

- -

Voir aussi

- - diff --git a/files/fr/web/api/window/sessionstorage/index.md b/files/fr/web/api/window/sessionstorage/index.md new file mode 100644 index 0000000000..64a4e4cc27 --- /dev/null +++ b/files/fr/web/api/window/sessionstorage/index.md @@ -0,0 +1,89 @@ +--- +title: Window.sessionStorage +slug: Web/API/Window/sessionStorage +tags: + - API +translation_of: Web/API/Window/sessionStorage +--- +

{{APIRef}}

+ +

La propriété sessionStorage permet d'utiliser un objet {{domxref("Storage")}} valable pour la session de navigation en cours et pour les pages du même domaine que la page actuelle. L'objet global sessionStorage est similaire à {{domxref("Window.localStorage")}}, à la différence que les données enregistrées dans sessionStorage ont une durée vie limitée et expirent à la fin de la session de navigation actuelle. Une session de navigation dure aussi longtemps que le navigateur est ouvert et s'étend sur plusieurs chargements, rechargements et restaurations de pages. En revanche, une session de navigation n'est valable que pour le contexte de navigation actuel, c'est-à-dire que le fait d'ouvrir une page dans un nouvel onglet ou dans une nouvelle fenêtre provoquera l'initialisation d'une nouvelle session de navigation, ce qui diffère du comportement des sessions utilisant des cookies.

+ +

Il est à noter que les données stockées dans sessionStorage ou localStorage sont spécifiques au protocole de la page.

+ +

Syntaxe

+ +
// Enregistrer des données dans sessionStorage
+sessionStorage.setItem('clé', 'valeur');
+
+// Récupérer des données depuis sessionStorage
+var data = sessionStorage.getItem('clé');
+
+// Supprimer des données de sessionStorage
+sessionStorage.removeItem('clé');
+
+// Supprimer toutes les données de sessionStorage
+sessionStorage.clear();
+
+ +

Valeur

+ +

Un objet {{domxref("Storage")}}.

+ +

Exemple

+ +

L'exemple de code suivant accède à l'objet de stockage de session associé au domaine actuel et y ajoute une donnée à l'aide de {{domxref("Storage.setItem()")}}.

+ +
sessionStorage.setItem('myCat', 'Tom');
+ +

L'exemple suivant sauvegarde automatiquement le contenu d'un champ textuel. Si la page est accidentellement rafraîchie, le contenu du champ est restauré de sorte qu'aucune saisie n'est perdue.

+ +
// Récupération du champ à enregistrer
+var champ = document.getElementById("champ");
+
+// Vérification de l'existence d'une donnée enregistrée auparavant
+// (ce ne sera le cas que si la page a été rafraîchie)
+if (sessionStorage.getItem("autosave")) {
+  // Restauration du contenu du champ
+  champ.value = sessionStorage.getItem("autosave");
+}
+
+// Écoute des changements de valeur du champ
+champ.addEventListener("change", function() {
+  // Enregistrement de la saisie utilisateur dans le stockage de session
+  sessionStorage.setItem("autosave", champ.value);
+});
+ +
+

Note : Veuillez vous référer à l'article Utilisation de l'API Web Storage pour des exemples plus complets.

+
+ +

Spécifications

+ + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName("HTML WHATWG", "webstorage.html#dom-sessionstorage", "sessionStorage")}}{{Spec2("HTML WHATWG")}}
+ +

Compatilibité des navigateurs

+ +

{{Compat("api.Window.sessionStorage")}}

+ +

Chaque navigateur attribue des capacités de stockage limitées pour localStorage et sessionStorage. Vous en trouverez certaines dans ce récapitulatif de tests des capacités de stockage attribuées en fonction du navigateur.

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/window/showmodaldialog/index.html b/files/fr/web/api/window/showmodaldialog/index.html deleted file mode 100644 index 3d86815e6a..0000000000 --- a/files/fr/web/api/window/showmodaldialog/index.html +++ /dev/null @@ -1,87 +0,0 @@ ---- -title: window.showModalDialog -slug: Web/API/Window/showModalDialog -tags: - - Obsolete -translation_of: Web/API/Window/showModalDialog ---- -

{{ ApiRef() }}

- -

Résumé

- -

Crée et affiche un dialogue modal contenant un document HTML spécifié.

- -
-

Attention : Cette fonction est obsolète.

- -

Le support a été arrêté avec la sortie de Chrome 37. Il y possibilité de la laisser active juqu'en Mai 2015 en configurant les paramètres de politique d'entreprise, plus de détails : ici.

- -

Mozilla a annoncé que le support de cette méthode sera supprimé ({{bug(981796)}}). Ce changement ne sera pas effectif avant Firefox 39, planifié pour les alentours de mi-juin 2015. Pour les entreprises, il est possible d'utiliser le build ESR 38 qui supportera la méthode jusqu'en milieu d'année 2016.

-
- -

Syntaxe

- -
retour = window.showModalDialog(uri[,arguments][,options]);
-
- -

où

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SyntaxeDescription
center: {on | off | yes | no | 1 | 0 }Si cette valeur est on, yes ou 1, la fenêtre de dialogue est centrée sur le bureau ; autrement elle est cachée. La valeur par défaut est yes.
dialogheight:height Spécifie la hauteur de la boîte de dialogue ; par défaut, la taille est spécifiée en pixels.
dialogleft:left Spécifie la position horizontale de la boîte de dialogue par rapport au coin supérieur gauche du bureau.
dialogwidth:width Spécifie la largeur de la boîte de dialogue ; par défaut, la taille est spécifiée en pixels.
dialogtop:top Spécifie la position verticale de la boîte de dialogue par rapport au coin supérieur gauche du bureau.
resizable: {on | off | yes | no | 1 | 0 }Si cette valeur est on, yes ou 1, la fenêtre de dialogue peut être redimensionnée par l'utilisateur ; autrement sa taille est fixe. La valeur par défaut est no.
scroll: {on | off | yes | no | 1 | 0 }Si cette valeur est on, yes ou 1, la fenêtre de dialogue a des barres de défilement ; autrement elle n'en a pas. La valeur par défaut est no.
- -

{{ Note("Firefox n\'implémente pas les paramètres dialogHide, edge, status ou unadorned.") }}

- -

Compatibilité

- -

Introduit par Microsoft Internet Explorer 4. Support ajouté à Firefox dans Firefox 3.

- -

Exemples

- -

Essayer showModalDialog().

- -

Notes

- -

Spécification

- -

Microsoft MSDN : showModalDialog

diff --git a/files/fr/web/api/window/showmodaldialog/index.md b/files/fr/web/api/window/showmodaldialog/index.md new file mode 100644 index 0000000000..3d86815e6a --- /dev/null +++ b/files/fr/web/api/window/showmodaldialog/index.md @@ -0,0 +1,87 @@ +--- +title: window.showModalDialog +slug: Web/API/Window/showModalDialog +tags: + - Obsolete +translation_of: Web/API/Window/showModalDialog +--- +

{{ ApiRef() }}

+ +

Résumé

+ +

Crée et affiche un dialogue modal contenant un document HTML spécifié.

+ +
+

Attention : Cette fonction est obsolète.

+ +

Le support a été arrêté avec la sortie de Chrome 37. Il y possibilité de la laisser active juqu'en Mai 2015 en configurant les paramètres de politique d'entreprise, plus de détails : ici.

+ +

Mozilla a annoncé que le support de cette méthode sera supprimé ({{bug(981796)}}). Ce changement ne sera pas effectif avant Firefox 39, planifié pour les alentours de mi-juin 2015. Pour les entreprises, il est possible d'utiliser le build ESR 38 qui supportera la méthode jusqu'en milieu d'année 2016.

+
+ +

Syntaxe

+ +
retour = window.showModalDialog(uri[,arguments][,options]);
+
+ +

où

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
SyntaxeDescription
center: {on | off | yes | no | 1 | 0 }Si cette valeur est on, yes ou 1, la fenêtre de dialogue est centrée sur le bureau ; autrement elle est cachée. La valeur par défaut est yes.
dialogheight:height Spécifie la hauteur de la boîte de dialogue ; par défaut, la taille est spécifiée en pixels.
dialogleft:left Spécifie la position horizontale de la boîte de dialogue par rapport au coin supérieur gauche du bureau.
dialogwidth:width Spécifie la largeur de la boîte de dialogue ; par défaut, la taille est spécifiée en pixels.
dialogtop:top Spécifie la position verticale de la boîte de dialogue par rapport au coin supérieur gauche du bureau.
resizable: {on | off | yes | no | 1 | 0 }Si cette valeur est on, yes ou 1, la fenêtre de dialogue peut être redimensionnée par l'utilisateur ; autrement sa taille est fixe. La valeur par défaut est no.
scroll: {on | off | yes | no | 1 | 0 }Si cette valeur est on, yes ou 1, la fenêtre de dialogue a des barres de défilement ; autrement elle n'en a pas. La valeur par défaut est no.
+ +

{{ Note("Firefox n\'implémente pas les paramètres dialogHide, edge, status ou unadorned.") }}

+ +

Compatibilité

+ +

Introduit par Microsoft Internet Explorer 4. Support ajouté à Firefox dans Firefox 3.

+ +

Exemples

+ +

Essayer showModalDialog().

+ +

Notes

+ +

Spécification

+ +

Microsoft MSDN : showModalDialog

diff --git a/files/fr/web/api/window/stop/index.html b/files/fr/web/api/window/stop/index.html deleted file mode 100644 index 491876c7b8..0000000000 --- a/files/fr/web/api/window/stop/index.html +++ /dev/null @@ -1,54 +0,0 @@ ---- -title: Window.stop() -slug: Web/API/Window/stop -tags: - - API - - DOM - - HTML DOM - - Méthode - - Reference - - Window - - stop -translation_of: Web/API/Window/stop ---- -
{{APIRef}}
- -

window.stop() arrête le chargment des ressources supplémentaires dans le contexte de navigation actuel, ce qui équivaut au bouton d'arrêt dans le navigateur.

- -

En raison de la manière dont les scripts sont exécutés, cette méthode ne peut pas interrompre le chargement de son document parent, mais elle arrêtera ses images, nouvelles fenêtres et autres objets en cours de chargement.

- -

Syntaxe

- -
window.stop()
-
- -

Exemple

- -
window.stop();
-
- -

Spécification

- - - - - - - - - - - - - - - - - - - -
SpécificationsStatutCommentaires
{{SpecName('HTML WHATWG','browsers.html#dom-window-stop','Window.stop()')}}{{Spec2('HTML WHATWG')}}
{{SpecName('HTML5 W3C', 'browsers.html#dom-window-stop', 'Window.stop')}}{{Spec2('HTML5 W3C')}}
- -

Compatibilité des navigateurs

- -

{{Compat("api.Window.stop")}}

diff --git a/files/fr/web/api/window/stop/index.md b/files/fr/web/api/window/stop/index.md new file mode 100644 index 0000000000..491876c7b8 --- /dev/null +++ b/files/fr/web/api/window/stop/index.md @@ -0,0 +1,54 @@ +--- +title: Window.stop() +slug: Web/API/Window/stop +tags: + - API + - DOM + - HTML DOM + - Méthode + - Reference + - Window + - stop +translation_of: Web/API/Window/stop +--- +
{{APIRef}}
+ +

window.stop() arrête le chargment des ressources supplémentaires dans le contexte de navigation actuel, ce qui équivaut au bouton d'arrêt dans le navigateur.

+ +

En raison de la manière dont les scripts sont exécutés, cette méthode ne peut pas interrompre le chargement de son document parent, mais elle arrêtera ses images, nouvelles fenêtres et autres objets en cours de chargement.

+ +

Syntaxe

+ +
window.stop()
+
+ +

Exemple

+ +
window.stop();
+
+ +

Spécification

+ + + + + + + + + + + + + + + + + + + +
SpécificationsStatutCommentaires
{{SpecName('HTML WHATWG','browsers.html#dom-window-stop','Window.stop()')}}{{Spec2('HTML WHATWG')}}
{{SpecName('HTML5 W3C', 'browsers.html#dom-window-stop', 'Window.stop')}}{{Spec2('HTML5 W3C')}}
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Window.stop")}}

diff --git a/files/fr/web/api/window/storage_event/index.html b/files/fr/web/api/window/storage_event/index.html deleted file mode 100644 index 8bfbc393b3..0000000000 --- a/files/fr/web/api/window/storage_event/index.html +++ /dev/null @@ -1,83 +0,0 @@ ---- -title: 'Window: storage event' -slug: Web/API/Window/storage_event -tags: - - API - - Evènement - - Reference - - Stockage - - Stockage Web - - Window -translation_of: Web/API/Window/storage_event ---- -
{{APIRef}}
- -

L'événement storage de l'interface {{domxref("Window")}} se déclenche lorsqu'une de stockage (localStorage) a été modifiée dans le contexte d'un autre document.

- - - - - - - - - - - - - - - - - - - - - - -
BullesNon
AnnulableNon
Interface{{domxref("StorageEvent")}}
Propriété de gestionnaire d'événements{{domxref("WindowEventHandlers.onstorage", "onstorage")}}
- -

Exemples

- -

Consignez l'élément sampleList sur la console lorsque l'événement storage se déclenche :

- -
window.addEventListener('storage', () => {
-  // Lorsque le stockage local change, vider la liste sur
-  // la console.
-  console.log(JSON.parse(window.localStorage.getItem('sampleList')));
-});
- -

La même action peut être réalisée ) l'aide de la propriété du gestionnaire d'événements onstorage :

- -
window.onstorage = () => {
-  // Lorsque le stockage local change, vider la liste dans
-  // la console.
-  console.log(JSON.parse(window.localStorage.getItem('sampleList')));
-};
-
- -

Spécifications

- - - - - - - - - - - - -
SpécificationStatut
{{SpecName('HTML WHATWG', 'indices.html#event-storage', 'storage')}}{{Spec2('HTML WHATWG')}}
- -

Compatibilité des navigateurs

- -

{{Compat("api.Window.storage_event")}}

- -

Voir également

- - diff --git a/files/fr/web/api/window/storage_event/index.md b/files/fr/web/api/window/storage_event/index.md new file mode 100644 index 0000000000..8bfbc393b3 --- /dev/null +++ b/files/fr/web/api/window/storage_event/index.md @@ -0,0 +1,83 @@ +--- +title: 'Window: storage event' +slug: Web/API/Window/storage_event +tags: + - API + - Evènement + - Reference + - Stockage + - Stockage Web + - Window +translation_of: Web/API/Window/storage_event +--- +
{{APIRef}}
+ +

L'événement storage de l'interface {{domxref("Window")}} se déclenche lorsqu'une de stockage (localStorage) a été modifiée dans le contexte d'un autre document.

+ + + + + + + + + + + + + + + + + + + + + + +
BullesNon
AnnulableNon
Interface{{domxref("StorageEvent")}}
Propriété de gestionnaire d'événements{{domxref("WindowEventHandlers.onstorage", "onstorage")}}
+ +

Exemples

+ +

Consignez l'élément sampleList sur la console lorsque l'événement storage se déclenche :

+ +
window.addEventListener('storage', () => {
+  // Lorsque le stockage local change, vider la liste sur
+  // la console.
+  console.log(JSON.parse(window.localStorage.getItem('sampleList')));
+});
+ +

La même action peut être réalisée ) l'aide de la propriété du gestionnaire d'événements onstorage :

+ +
window.onstorage = () => {
+  // Lorsque le stockage local change, vider la liste dans
+  // la console.
+  console.log(JSON.parse(window.localStorage.getItem('sampleList')));
+};
+
+ +

Spécifications

+ + + + + + + + + + + + +
SpécificationStatut
{{SpecName('HTML WHATWG', 'indices.html#event-storage', 'storage')}}{{Spec2('HTML WHATWG')}}
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Window.storage_event")}}

+ +

Voir également

+ + diff --git a/files/fr/web/api/window/top/index.html b/files/fr/web/api/window/top/index.html deleted file mode 100644 index 8fa533e6f9..0000000000 --- a/files/fr/web/api/window/top/index.html +++ /dev/null @@ -1,54 +0,0 @@ ---- -title: Window.top -slug: Web/API/Window/top -tags: - - API - - HTML DOM - - NeedsExample - - Propriété - - Reference - - Window -translation_of: Web/API/Window/top ---- -
{{APIRef}}
- -

Renvoie une référence à la fenêtre la plus haute dans la hiérarchie des fenêtres

- -

Syntaxe

- -
var topWindow = window.top;
-
- -

Notes

- -

Là où la propriété {{domxref("window.parent")}} renvoie le parent immédiat de la fenêtre courante, window.top renvoie la fenêtre la plus haute dans la hiérarchie des objets de fenêtre.

- -

Cette propriété est particulièrement utile lorsque vous avez affaire à une fenêtre qui se trouve dans une subframe d'un ou de plusieurs parents, et que vous souhaitez accéder au jeu de frameset de niveau supérieur.

- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('HTML WHATWG', 'browsers.html#dom-top', 'window.top')}}{{Spec2('HTML WHATWG')}}
{{SpecName('HTML5 W3C', 'browsers.html#dom-top', 'window.top')}}{{Spec2('HTML5 W3C')}}Spécification initiale
- -

Compatibilité des navigateurs

- -

{{Compat("api.Window.top")}}

diff --git a/files/fr/web/api/window/top/index.md b/files/fr/web/api/window/top/index.md new file mode 100644 index 0000000000..8fa533e6f9 --- /dev/null +++ b/files/fr/web/api/window/top/index.md @@ -0,0 +1,54 @@ +--- +title: Window.top +slug: Web/API/Window/top +tags: + - API + - HTML DOM + - NeedsExample + - Propriété + - Reference + - Window +translation_of: Web/API/Window/top +--- +
{{APIRef}}
+ +

Renvoie une référence à la fenêtre la plus haute dans la hiérarchie des fenêtres

+ +

Syntaxe

+ +
var topWindow = window.top;
+
+ +

Notes

+ +

Là où la propriété {{domxref("window.parent")}} renvoie le parent immédiat de la fenêtre courante, window.top renvoie la fenêtre la plus haute dans la hiérarchie des objets de fenêtre.

+ +

Cette propriété est particulièrement utile lorsque vous avez affaire à une fenêtre qui se trouve dans une subframe d'un ou de plusieurs parents, et que vous souhaitez accéder au jeu de frameset de niveau supérieur.

+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('HTML WHATWG', 'browsers.html#dom-top', 'window.top')}}{{Spec2('HTML WHATWG')}}
{{SpecName('HTML5 W3C', 'browsers.html#dom-top', 'window.top')}}{{Spec2('HTML5 W3C')}}Spécification initiale
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Window.top")}}

diff --git a/files/fr/web/api/window/unload_event/index.html b/files/fr/web/api/window/unload_event/index.html deleted file mode 100644 index aa14cc47c8..0000000000 --- a/files/fr/web/api/window/unload_event/index.html +++ /dev/null @@ -1,156 +0,0 @@ ---- -title: unload -slug: Web/API/Window/unload_event -tags: - - JavaScript - - events -translation_of: Web/API/Window/unload_event -original_slug: Web/Events/unload ---- -

L'événement unload est appelé lorsque le document ou une ressource enfant est en train d'être déchargé.

- -

Il est lancé après :

- -
    -
  1. beforeunload (événement annulable)
    2. -
  2. pagehide
    3. -
- -

Le document se trouve alors dans un état particulier :

- - - -

Veuiller noter que l'événement unload suit l'ordre du document : le cadre parent est déchargé avant le unload d'un cadre enfant (voir l'exemple ci-dessous).

- - - - - - - - - - - - - - - - - - - - - - - - -
Événement propageableNon
AnnulableNon
Objets ciblesdefaultView, Document, Element
Interface{{domxref("UIEvent")}} si généré depuis un élément de l'interface utilisateur, {{domxref("Event")}}
Action par défautAucune
- -

Propriétés

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
PropriétéTypeDescription
target {{readonlyInline}}EventTargetLa cible de l'événement (la cible de plus haut niveau dans le DOM).
type {{readonlyInline}}DOMStringLe type d'événement.
bubbles {{readonlyInline}}BooleanSi l'événement remonte ou non.
cancelable {{readonlyInline}}BooleanSi l'événement est annulable ou non.
view {{readonlyInline}}WindowProxydocument.defaultView (fenêtre du document)
detail {{readonlyInline}}long (float)0.
- -

Exemple

- -
<!DOCTYPE html>
-<html>
-  <head>
-    <title>Cadre parent</title>
-    <script>
-      window.addEventListener('beforeunload', function(event) {
-        console.log('Je suis le 1er.');
-      });
-      window.addEventListener('unload', function(event) {
-        console.log('Je suis le 3ème.');
-      });
-    </script>
-  </head>
-  <body>
-    <iframe src="child-frame.html"></iframe>
-  </body>
-</html>
- -

Ci-dessous, le contenu de child-frame.html:

- -
<!DOCTYPE html>
-<html>
-  <head>
-    <title>Cadre enfant</title>
-    <script>
-      window.addEventListener('beforeunload', function(event) {
-        console.log('Je suis le 2nd.');
-      });
-      window.addEventListener('unload', function(event) {
-        console.log('Je suis le 4ème et dernier…');
-      });
-    </script>
-  </head>
-  <body>
-      ☻
-  </body>
-</html>
- -

Quand le cadre parent est déchargé, les événements sont lancés dans l'ordre décrit par les messages console.log.

- -

Événements liés

- - - -

Spécifications

- - diff --git a/files/fr/web/api/window/unload_event/index.md b/files/fr/web/api/window/unload_event/index.md new file mode 100644 index 0000000000..aa14cc47c8 --- /dev/null +++ b/files/fr/web/api/window/unload_event/index.md @@ -0,0 +1,156 @@ +--- +title: unload +slug: Web/API/Window/unload_event +tags: + - JavaScript + - events +translation_of: Web/API/Window/unload_event +original_slug: Web/Events/unload +--- +

L'événement unload est appelé lorsque le document ou une ressource enfant est en train d'être déchargé.

+ +

Il est lancé après :

+ +
    +
  1. beforeunload (événement annulable)
    2. +
  2. pagehide
    3. +
+ +

Le document se trouve alors dans un état particulier :

+ + + +

Veuiller noter que l'événement unload suit l'ordre du document : le cadre parent est déchargé avant le unload d'un cadre enfant (voir l'exemple ci-dessous).

+ + + + + + + + + + + + + + + + + + + + + + + + +
Événement propageableNon
AnnulableNon
Objets ciblesdefaultView, Document, Element
Interface{{domxref("UIEvent")}} si généré depuis un élément de l'interface utilisateur, {{domxref("Event")}}
Action par défautAucune
+ +

Propriétés

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
PropriétéTypeDescription
target {{readonlyInline}}EventTargetLa cible de l'événement (la cible de plus haut niveau dans le DOM).
type {{readonlyInline}}DOMStringLe type d'événement.
bubbles {{readonlyInline}}BooleanSi l'événement remonte ou non.
cancelable {{readonlyInline}}BooleanSi l'événement est annulable ou non.
view {{readonlyInline}}WindowProxydocument.defaultView (fenêtre du document)
detail {{readonlyInline}}long (float)0.
+ +

Exemple

+ +
<!DOCTYPE html>
+<html>
+  <head>
+    <title>Cadre parent</title>
+    <script>
+      window.addEventListener('beforeunload', function(event) {
+        console.log('Je suis le 1er.');
+      });
+      window.addEventListener('unload', function(event) {
+        console.log('Je suis le 3ème.');
+      });
+    </script>
+  </head>
+  <body>
+    <iframe src="child-frame.html"></iframe>
+  </body>
+</html>
+ +

Ci-dessous, le contenu de child-frame.html:

+ +
<!DOCTYPE html>
+<html>
+  <head>
+    <title>Cadre enfant</title>
+    <script>
+      window.addEventListener('beforeunload', function(event) {
+        console.log('Je suis le 2nd.');
+      });
+      window.addEventListener('unload', function(event) {
+        console.log('Je suis le 4ème et dernier…');
+      });
+    </script>
+  </head>
+  <body>
+      ☻
+  </body>
+</html>
+ +

Quand le cadre parent est déchargé, les événements sont lancés dans l'ordre décrit par les messages console.log.

+ +

Événements liés

+ + + +

Spécifications

+ + diff --git a/files/fr/web/api/window/vrdisplayconnect_event/index.html b/files/fr/web/api/window/vrdisplayconnect_event/index.html deleted file mode 100644 index 888a500d2f..0000000000 --- a/files/fr/web/api/window/vrdisplayconnect_event/index.html +++ /dev/null @@ -1,81 +0,0 @@ ---- -title: 'Window: vrdisplayconnect event' -slug: Web/API/Window/vrdisplayconnect_event -tags: - - Evènement - - Reference - - WebVR - - onvrdisplayconnect - - vrdisplayconnect -translation_of: Web/API/Window/vrdisplayconnect_event ---- -
{{APIRef("Window")}}
- -
-

L'événement vrdisplayconnect de l'API WebVR est déclenché lorsqu'un écran VR compatible est connecté à l'ordinateur.

-
- - - - - - - - - - - - - - - - - - - - -
BullesNon
AnnulableNon
Interface{{domxref("VRDisplayEvent")}}
Propriété de gestionnaire d'événementsonvrdisplayconnect
- -

Exemples

- -

Vous pouvez utiliser l'événement vrdisplayconnect dans une méthode addEventListener :

- -
window.addEventListener('vrdisplayconnect', function() {
-  info.textContent = 'Affichage connecté.';
-  reportDisplays();
-});
- -

Ou utilisez la propriété du gestionnaire d'événements onvrdisplayconnect :

- -
window.onvrdisplayconnect = function() {
-  info.textContent = 'Affichage connecté.';
-  reportDisplays();
-};
- -

Spécifications

- - - - - - - - - - - - - - -
SpécificationStatutCommentair
{{SpecName('WebVR 1.1', '#dom-window-onvrdisplayconnect', 'vrdisplayconnect')}}{{Spec2('WebVR 1.1')}}Définition initiale
- -

Compatibilité des navigateurs

- -

{{Compat("api.Window.vrdisplayconnect_event")}}

- -

Voir également

- - diff --git a/files/fr/web/api/window/vrdisplayconnect_event/index.md b/files/fr/web/api/window/vrdisplayconnect_event/index.md new file mode 100644 index 0000000000..888a500d2f --- /dev/null +++ b/files/fr/web/api/window/vrdisplayconnect_event/index.md @@ -0,0 +1,81 @@ +--- +title: 'Window: vrdisplayconnect event' +slug: Web/API/Window/vrdisplayconnect_event +tags: + - Evènement + - Reference + - WebVR + - onvrdisplayconnect + - vrdisplayconnect +translation_of: Web/API/Window/vrdisplayconnect_event +--- +
{{APIRef("Window")}}
+ +
+

L'événement vrdisplayconnect de l'API WebVR est déclenché lorsqu'un écran VR compatible est connecté à l'ordinateur.

+
+ + + + + + + + + + + + + + + + + + + + +
BullesNon
AnnulableNon
Interface{{domxref("VRDisplayEvent")}}
Propriété de gestionnaire d'événementsonvrdisplayconnect
+ +

Exemples

+ +

Vous pouvez utiliser l'événement vrdisplayconnect dans une méthode addEventListener :

+ +
window.addEventListener('vrdisplayconnect', function() {
+  info.textContent = 'Affichage connecté.';
+  reportDisplays();
+});
+ +

Ou utilisez la propriété du gestionnaire d'événements onvrdisplayconnect :

+ +
window.onvrdisplayconnect = function() {
+  info.textContent = 'Affichage connecté.';
+  reportDisplays();
+};
+ +

Spécifications

+ + + + + + + + + + + + + + +
SpécificationStatutCommentair
{{SpecName('WebVR 1.1', '#dom-window-onvrdisplayconnect', 'vrdisplayconnect')}}{{Spec2('WebVR 1.1')}}Définition initiale
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Window.vrdisplayconnect_event")}}

+ +

Voir également

+ + diff --git a/files/fr/web/api/window/vrdisplaydisconnect_event/index.html b/files/fr/web/api/window/vrdisplaydisconnect_event/index.html deleted file mode 100644 index 75a6c9924a..0000000000 --- a/files/fr/web/api/window/vrdisplaydisconnect_event/index.html +++ /dev/null @@ -1,81 +0,0 @@ ---- -title: 'Window: vrdisplaydisconnect event' -slug: Web/API/Window/vrdisplaydisconnect_event -tags: - - Evènement - - Reference - - WebVR - - onvrdisplaydisconnect - - vrdisplaydisconnect -translation_of: Web/API/Window/vrdisplaydisconnect_event ---- -
{{APIRef("Window")}}
- -
-

L'événement vrdisplaydisconnect de l'API WebVR est déclenché lorsqu'un écran VR compatible est déconnecté de l'ordinateur.

-
- - - - - - - - - - - - - - - - - - - - -
BullesNon
AnnulableNon
Interface{{domxref("VRDisplayEvent")}}
Propriété de gestionnaire d'événementsonvrdisplaydisconnect
- -

Exemples

- -

Vous pouvez utiliser l'événement vrdisplaydisconnect dans une méthode addEventListener :

- -
window.addEventListener('vrdisplaydisconnect', function() {
-  info.textContent = 'Affichage déconnecté';
-  reportDisplays();
-});
- -

Ou utilisez la propriété du gestionnaire d'événements onvrdisplaydisconnect :

- -
window.onvrdisplaydisconnect = function() {
-  info.textContent = 'Affichage déconnecté';
-  reportDisplays();
-);
- -

Spécifications

- - - - - - - - - - - - - - -
SpécificationStatutCommentair
{{SpecName('WebVR 1.1', '#dom-window-onvrdisplaydisconnect', 'vrdisplaydisconnect')}}{{Spec2('WebVR 1.1')}}Définition initiale
- -

Compatibilité des navigateurs

- -

{{Compat("api.Window.vrdisplaydisconnect_event")}}

- -

Voir également

- - diff --git a/files/fr/web/api/window/vrdisplaydisconnect_event/index.md b/files/fr/web/api/window/vrdisplaydisconnect_event/index.md new file mode 100644 index 0000000000..75a6c9924a --- /dev/null +++ b/files/fr/web/api/window/vrdisplaydisconnect_event/index.md @@ -0,0 +1,81 @@ +--- +title: 'Window: vrdisplaydisconnect event' +slug: Web/API/Window/vrdisplaydisconnect_event +tags: + - Evènement + - Reference + - WebVR + - onvrdisplaydisconnect + - vrdisplaydisconnect +translation_of: Web/API/Window/vrdisplaydisconnect_event +--- +
{{APIRef("Window")}}
+ +
+

L'événement vrdisplaydisconnect de l'API WebVR est déclenché lorsqu'un écran VR compatible est déconnecté de l'ordinateur.

+
+ + + + + + + + + + + + + + + + + + + + +
BullesNon
AnnulableNon
Interface{{domxref("VRDisplayEvent")}}
Propriété de gestionnaire d'événementsonvrdisplaydisconnect
+ +

Exemples

+ +

Vous pouvez utiliser l'événement vrdisplaydisconnect dans une méthode addEventListener :

+ +
window.addEventListener('vrdisplaydisconnect', function() {
+  info.textContent = 'Affichage déconnecté';
+  reportDisplays();
+});
+ +

Ou utilisez la propriété du gestionnaire d'événements onvrdisplaydisconnect :

+ +
window.onvrdisplaydisconnect = function() {
+  info.textContent = 'Affichage déconnecté';
+  reportDisplays();
+);
+ +

Spécifications

+ + + + + + + + + + + + + + +
SpécificationStatutCommentair
{{SpecName('WebVR 1.1', '#dom-window-onvrdisplaydisconnect', 'vrdisplaydisconnect')}}{{Spec2('WebVR 1.1')}}Définition initiale
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Window.vrdisplaydisconnect_event")}}

+ +

Voir également

+ + diff --git a/files/fr/web/api/window/vrdisplaypresentchange_event/index.html b/files/fr/web/api/window/vrdisplaypresentchange_event/index.html deleted file mode 100644 index c2abcb5e12..0000000000 --- a/files/fr/web/api/window/vrdisplaypresentchange_event/index.html +++ /dev/null @@ -1,89 +0,0 @@ ---- -title: 'Window: vrdisplaypresentchange event' -slug: Web/API/Window/vrdisplaypresentchange_event -tags: - - Evènement - - Reference - - WebVR - - onvrdisplaypresentchange - - vrdisplaypresentchange -translation_of: Web/API/Window/vrdisplaypresentchange_event ---- -
{{APIRef("Window")}}
- -
-

L'événement vrdisplaypresentchange de l'API WebVR est déclenché lorsque l'état de présentation d'un affichage VR change — c'est à dire passe de la présentation à la non présentation, ou vice versa.

-
- - - - - - - - - - - - - - - - - - - - -
BullesNon
AnnulableNon
Interface{{domxref("VRDisplayEvent")}}
Propriété de gestionnaire d'événementsonvrdisplaypresentchange
- -

Exemples

- -

Vous pouvez utiliser l'événement vrdisplaypresentchange dans une méthode addEventListener :

- -
window.addEventListener('vrdisplaypresentchange', function() {
-  if(vrDisplay.isPresenting) {
-    info.textContent = "L'affichage a commencé à présenter.";
-  } else {
-    info.textContent = "L'affichage a cessé de se présenter.";
-  }
-  reportDisplays();
-});
- -

Ou utilisez la propriété de gestionnaire d'événements onvrdisplaypresentchange :

- -
window.onvrdisplaypresentchange = function() {
-  if(vrDisplay.isPresenting) {
-    info.textContent = "L'affichage a commencé à présenter.";
-  } else {
-    info.textContent = "L'affichage a cessé de se présenter.";
-  }
-  reportDisplays();
-};
- -

Spécifications

- - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('WebVR 1.1', '#dom-window-onvrdisplaypresentchange', 'vrdisplaypresentchange')}}{{Spec2('WebVR 1.1')}}Définition initiale
- -

Compatibilité des navigateurs

- -

{{Compat("api.Window.vrdisplaypresentchange_event")}}

- -

Voir également

- - diff --git a/files/fr/web/api/window/vrdisplaypresentchange_event/index.md b/files/fr/web/api/window/vrdisplaypresentchange_event/index.md new file mode 100644 index 0000000000..c2abcb5e12 --- /dev/null +++ b/files/fr/web/api/window/vrdisplaypresentchange_event/index.md @@ -0,0 +1,89 @@ +--- +title: 'Window: vrdisplaypresentchange event' +slug: Web/API/Window/vrdisplaypresentchange_event +tags: + - Evènement + - Reference + - WebVR + - onvrdisplaypresentchange + - vrdisplaypresentchange +translation_of: Web/API/Window/vrdisplaypresentchange_event +--- +
{{APIRef("Window")}}
+ +
+

L'événement vrdisplaypresentchange de l'API WebVR est déclenché lorsque l'état de présentation d'un affichage VR change — c'est à dire passe de la présentation à la non présentation, ou vice versa.

+
+ + + + + + + + + + + + + + + + + + + + +
BullesNon
AnnulableNon
Interface{{domxref("VRDisplayEvent")}}
Propriété de gestionnaire d'événementsonvrdisplaypresentchange
+ +

Exemples

+ +

Vous pouvez utiliser l'événement vrdisplaypresentchange dans une méthode addEventListener :

+ +
window.addEventListener('vrdisplaypresentchange', function() {
+  if(vrDisplay.isPresenting) {
+    info.textContent = "L'affichage a commencé à présenter.";
+  } else {
+    info.textContent = "L'affichage a cessé de se présenter.";
+  }
+  reportDisplays();
+});
+ +

Ou utilisez la propriété de gestionnaire d'événements onvrdisplaypresentchange :

+ +
window.onvrdisplaypresentchange = function() {
+  if(vrDisplay.isPresenting) {
+    info.textContent = "L'affichage a commencé à présenter.";
+  } else {
+    info.textContent = "L'affichage a cessé de se présenter.";
+  }
+  reportDisplays();
+};
+ +

Spécifications

+ + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('WebVR 1.1', '#dom-window-onvrdisplaypresentchange', 'vrdisplaypresentchange')}}{{Spec2('WebVR 1.1')}}Définition initiale
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Window.vrdisplaypresentchange_event")}}

+ +

Voir également

+ + -- cgit v1.2.3-54-g00ecf