diff options
| author | Ryan Johnson <rjohnson@mozilla.com> | 2021-04-29 16:16:42 -0700 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2021-04-29 16:16:42 -0700 |
| commit | 95aca4b4d8fa62815d4bd412fff1a364f842814a (patch) | |
| tree | 5e57661720fe9058d5c7db637e764800b50f9060 /files/fi/web/api | |
| parent | ee3b1c87e3c8e72ca130943eed260ad642246581 (diff) | |
| download | translated-content-95aca4b4d8fa62815d4bd412fff1a364f842814a.tar.gz translated-content-95aca4b4d8fa62815d4bd412fff1a364f842814a.tar.bz2 translated-content-95aca4b4d8fa62815d4bd412fff1a364f842814a.zip | |
remove retired locales (#699)
Diffstat (limited to 'files/fi/web/api')
28 files changed, 0 insertions, 2845 deletions
diff --git a/files/fi/web/api/aeskeygenparams/index.html b/files/fi/web/api/aeskeygenparams/index.html deleted file mode 100644 index 8e7efcc5d5..0000000000 --- a/files/fi/web/api/aeskeygenparams/index.html +++ /dev/null @@ -1,48 +0,0 @@ ---- -title: AesKeyGenParams -slug: Web/API/AesKeyGenParams -translation_of: Web/API/AesKeyGenParams ---- -<p>{{ APIRef("Web Crypto API") }}<strong><code>AesKeyGenParams</code></strong> hakemisto <a href="/fi/docs/Web/API/Web_Crypto_API">Web Crypto API</a>:sta edustaa objektia joka tulisi siirtää <code>algorithm</code> parametrina metodiin {{domxref("SubtleCrypto.generateKey()")}}, kun luodaan AES avainta: silloin kun algoritmiksi tunnistetaan joksikin seuraavista: <a href="/fi/docs/Web/API/SubtleCrypto/encrypt#AES-CBC">AES-CBC</a>, <a href="/fi/docs/Web/API/SubtleCrypto/encrypt#AES-CTR">AES-CTR</a>, <a href="/fi/docs/Web/API/SubtleCrypto/encrypt#AES-GCM">AES-GCM</a>, tai <a href="/fi/docs/Web/API/SubtleCrypto/wrapKey#AES-KW">AES-KW</a>.</p> - -<h2 id="Ominaisuudet">Ominaisuudet</h2> - -<dl> - <dt><code>name</code></dt> - <dd>{{domxref("DOMString")}}. Tämän tulisi olla asetettuna joksikin seuraavista: <code>AES-CBC</code>, <code>AES-CTR</code>, <code>AES-GCM</code>, ta <code>AES-KW</code>, riippuen siitä mitä algoritmia haluat käyttää.</dd> - <dt><code>length</code></dt> - <dd> - <p><code>Numero</code> — generoitavan avaimen bittien pituus. Tämän täytyy olla jokin näistä: 128, 192, tai 256.</p> - </dd> -</dl> - -<h2 id="Esimerkkejä">Esimerkkejä</h2> - -<p>Katso {{domxref("SubtleCrypto.generateKey()")}}:n esimerkit.</p> - -<h2 id="Tekniset_tiedot">Tekniset tiedot</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Määritelmä</th> - <th scope="col">Tila</th> - <th scope="col">Kommentti</th> - </tr> - <tr> - <td>{{ SpecName('Web Crypto API', '#dfn-AesKeyGenParams', 'SubtleCrypto.AesKeyGenParams') }}</td> - <td>{{ Spec2('Web Crypto API') }}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Selainyhteensopivuus">Selainyhteensopivuus</h2> - -<p>Selaimet jotka tukevat jotain AES-pohjaista algoritmia jota {{domxref("SubtleCrypto.generateKey()")}} metodi tukee.</p> - -<h2 id="Katso_myös">Katso myös</h2> - -<ul> - <li>{{domxref("SubtleCrypto.generateKey()")}}.</li> -</ul> diff --git a/files/fi/web/api/canvas_api/index.html b/files/fi/web/api/canvas_api/index.html deleted file mode 100644 index 51e68b4840..0000000000 --- a/files/fi/web/api/canvas_api/index.html +++ /dev/null @@ -1,74 +0,0 @@ ---- -title: Canvas -slug: Web/API/Canvas_API -translation_of: Web/API/Canvas_API -original_slug: HTML/Canvas ---- -<p><a href="/en-US/docs/HTML/HTML5" title="/en-US/docs/HTML/HTML5">HTML5</a>:een lisätty <strong>HTML {{HTMLElement("canvas")}}-elementti</strong> on elementti, jota voidaan käyttää grafiikan piirtämiseen skriptaamalla (tavallisesti <a href="/en-US/docs/JavaScript" title="JavaScript">JavaScript</a>-kielellä). Sitä voidaan käyttää esimerkiksi diagrammojen piirtämiseen, valokuvayhdistelmien tekemiseen, animaatioiden luomiseen ja jopa ajantasaiseen video-käsittelyyn.</p> -<p>Mozilla-sovellukset saivat <code><canvas></code>-tuen Gecko 1.8-versiosta alkaen (toisin sanoen <a href="/en-US/docs/Firefox_1.5_for_developers" title="Firefox_1.5_for_developers">Firefox 1.5</a>:stä lähtien). Elementin esitteli alunperin Apple OS X-käyttöjärjestelmä <a class="external" href="http://www.apple.com/macosx/features/dashboard/">Dashboard</a>- ja Safari-sovelluksissa. Internet Explorer tukee <code><canvas></code>:ia versiosta 9 lähtien; IE-selaimen aiemmissa versioissa webbisivulle voidaan tehokkaasti lisätä <code><canvas></code>-tuki Googlen <a class="external" href="http://excanvas.sourceforge.net/">Explorer Canvas</a>-hankkeen skriptillä. Google Chrome ja Opera 9 tukevat myös <code><canvas></code>:ia.</p> -<p><a href="/en-US/docs/WebGL" title="WebGL">WebGL</a> käyttää myös <code><canvas></code>-elementtiä 3D-grafiikan laitteistokiihdytykseen webbisivuilla.</p> -<div class="row topicpage-table"> - <div class="section"> - <h2 class="Documentation" id="Documentation" name="Documentation">Dokumentaatio</h2> - <dl> - <dt> - <a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/the-canvas-element.html#the-canvas-element" title="http://www.whatwg.org/specs/web-apps/current-work/multipage/the-canvas-element.html#the-canvas-element">Spesifikaatio</a></dt> - <dd> - Elementti <code><canvas></code> on osa WhatWG Web applications 1.0 -spesifikaatiota, joka tunnetaan myös nimellä HTML5.</dd> - <dt> - <a href="/en-US/docs/Canvas_tutorial" title="Canvas_tutorial">Canvas-oppikurssi</a></dt> - <dd> - Laaja oppikurssi, joka kattaa sekä <code><canvas></code>-peruskäytön että sen edistyneemmät ominaisuudet.</dd> - <dt> - <a href="/en-US/docs/Code_snippets/Canvas" title="Code_snippets/Canvas">Koodikatkelma:Canvas</a></dt> - <dd> - Joitakin <code><canvas></code>:iin liittyviä koodikatkelmia.</dd> - <dt> - <a href="/en-US/docs/tag/Canvas_examples" title="tag/Canvas_examples">Canvas-esimerkkejä</a></dt> - <dd> - Muutama <code><canvas></code>-esittelyohjelma.</dd> - <dt> - <a href="/en-US/docs/HTML/Canvas/Drawing_DOM_objects_into_a_canvas" title="HTML/Canvas/Drawing DOM objects into a canvas">DOM-objektien piirtäminen canvas-elementtiin</a></dt> - <dd> - Kuinka piirtää canvas-komponenttiin DOM-sisältö, kuten HTML-elementit.</dd> - <dt> - <a href="/en-US/docs/A_Basic_RayCaster" title="A Basic RayCaster">Perussädeheittäjä</a></dt> - <dd> - Canvasia käyttävä sädejäljitysanimaation esittelyohjelma.</dd> - <dt> - <a href="/en-US/docs/Gecko_DOM_Reference#Canvas_interfaces" title="Gecko_DOM_Reference#Canvas_interfaces">Canvas DOM -rajapinnat</a></dt> - <dd> - Canvas DOM -rajapinnat Gecko-alustalla.</dd> - </dl> - <p><span class="alllinks"><a href="/en-US/docs/tag/HTML:Canvas" title="tag/HTML:Canvas">Katso kaikkia...</a></span></p> - </div> - <div class="section"> - <h2 class="Community" id="Yhteisö">Yhteisö</h2> - <ul> - <li>Katso Mozilla-foorumeita... {{DiscussionList("dev-tech-html","mozilla.dev.tech.html")}}</li> - <li><a class="external" href="http://groups.yahoo.com/group/canvas-developers/">Canvas-kehittäjät Yahoo-ryhmä</a></li> - </ul> - <h2 class="Resources" id="Resources" name="Resources">Resurssit</h2> - <ul> - <li><a class="external" href="http://joshondesign.com/p/books/canvasdeepdive/title.html" title="http://projects.joshy.org/presentations/HTML/CanvasDeepDive/presentation.html">Syvä sukellus HTML5 Canvasiin</a></li> - <li><a class="external" href="http://blog.nihilogic.dk/2009/02/html5-canvas-cheat-sheet.html" title="http://blog.nihilogic.dk/2009/02/html5-canvas-cheat-sheet.html">Canvas-muistilappu</a> (<a href="http://www.nihilogic.dk/labs/canvas_sheet/HTML5_Canvas_Cheat_Sheet.png" title="HTML5_Canvas_Cheat_Sheet.png (1388×1027)">PNG</a> / <a href="http://www.nihilogic.dk/labs/canvas_sheet/HTML5_Canvas_Cheat_Sheet.pdf" title="http://www.nihilogic.dk/labs/canvas_sheet/HTML5_Canvas_Cheat_Sheet.pdf">PDF</a>)</li> - </ul> - <h2 class="Libraries" id="Libraries" name="Libraries">Kirjastot</h2> - <ul> - <li><a class="external" href="http://libcanvas.github.com/" title="http://libcanvas.github.com/">libCanvas</a> on tehokas ja kevyt canvas-ympäristö</li> - <li><a class="external" href="http://processingjs.org" title="http://processingjs.org/">Processing.js</a> on toiseen käyttöympäristöön siirretty Prosessin visualisointikieli</li> - <li><a class="external" href="http://easeljs.com/" title="http://easeljs.com/">EaselJS</a> on kirjasto, jossa on Flash-tyyppinen sovellusohjelmointirajapinta (API)</li> - <li><a class="external" href="http://www.liquidx.net/plotkit/" title="http://www.liquidx.net/plotkit/">PlotKit</a> on taulukko- ja grafiikkakirjasto</li> - <li><a class="link-https" href="https://github.com/jeremyckahn/rekapi" title="https://github.com/jeremyckahn/rekapi">Rekapi</a> on avainkehys-animaatioympäristön sovellusohjelmointirajapinta Canvasille</li> - <li><a class="external" href="http://senchalabs.github.com/philogl/" title="http://senchalabs.github.com/philogl/">PhiloGL</a> on WebGL-ympäristö datan visualisointiin, luovaan koodaukseen ja pelikehitykseen.</li> - <li><a class="external" href="http://thejit.org/" title="http://thejit.org/">JavaScript InfoVis Toolkit</a> luo vuorovaikutteisia 2D Canvas -datavisualisointeja webbiin.</li> - <li><a href="http://www.frame-engine.com" title="http://www.frame-engine.com">Frame-Engine</a> on sovellusten ja pelin kehitysympäristö</li> - </ul> - <h2 class="Related_Topics" id="Related_Topics" name="Related_Topics">Asiaan liittyvät aiheet</h2> - <ul> - <li><a href="/en-US/docs/HTML" title="HTML">HTML</a>, <a href="/en-US/docs/JavaScript" title="JavaScript">JavaScript</a>, <a href="/en-US/docs/CSS" title="CSS">CSS</a>, <a href="/en-US/docs/AJAX" title="AJAX">AJAX</a>, <a href="/en-US/docs/DOM" title="DOM">DOM</a>, <a href="/en-US/docs/SVG" title="SVG">SVG</a>, <a href="/en-US/docs/WebGL" title="WebGL">WebGL</a></li> - </ul> - </div> -</div> -<div> - {{HTML5ArticleTOC()}}</div> diff --git a/files/fi/web/api/document_object_model/index.html b/files/fi/web/api/document_object_model/index.html deleted file mode 100644 index 5997dd369e..0000000000 --- a/files/fi/web/api/document_object_model/index.html +++ /dev/null @@ -1,92 +0,0 @@ ---- -title: Document Object Model (DOM) -slug: Web/API/Document_Object_Model -tags: - - DOM - - NeedsTranslation - - References - - TopicStub -translation_of: Web/API/Document_Object_Model -translation_of_original: DOM -original_slug: DOM ---- -<div class="geckoVersionNote"> - <div class="callout-box"> - <strong><a href="/en-US/docs/Using_the_W3C_DOM_Level_1_Core" title="en-US/docs/Using_the_W3C_DOM_Level_1_Core">Using the W3C DOM Level 1 Core</a></strong><br> - Introduction to the W3C DOM.</div> -</div> -<div> - <p><span class="seoSummary">The <strong>Document Object Model</strong> (<strong>DOM</strong>) is an API for <a href="/en-US/docs/HTML" title="en-US/docs/HTML">HTML</a> and <a href="/en-US/docs/XML" title="en-US/docs/XML">XML</a> documents. It provides a structural representation of the document, enabling you to modify its content and visual presentation by using a scripting language such as <a href="/en-US/docs/JavaScript" title="https://developer.mozilla.org/en-US/docs/JavaScript">JavaScript</a>.</span></p> -</div> -<div class="cleared topicpage-table row"> - <div class="section"> - <h2 class="Documentation" id="Documentation" name="Documentation">Documentation about the DOM</h2> - <dl> - <dt> - <a href="/en-US/docs/Gecko_DOM_Reference" title="en-US/docs/Gecko_DOM_Reference">Gecko DOM Reference</a></dt> - <dd> - The Gecko Document Object Model Reference.</dd> - <dt> - <a href="/en-US/docs/DOM/About_the_Document_Object_Model" title="en-US/docs/About_the_Document_Object_Model">About the Document Object Model</a></dt> - <dd> - A short introduction to the DOM.</dd> - <dt> - <a href="/en-US/docs/JavaScript_technologies_overview" title="en-US/docs/The_DOM_and_JavaScript">The DOM and JavaScript</a></dt> - <dd> - What is the DOM? What is JavaScript? How do I use them together on my web page? This document answers these questions and more.</dd> - <dt> - <a href="/en-US/docs/DOM/Using_dynamic_styling_information" title="en-US/docs/DOM/Using_dynamic_styling_information">Using dynamic styling information</a></dt> - <dd> - How to obtain information on and manipulate styling via the DOM.</dd> - <dt> - <a href="/en-US/docs/DOM/DOM_event_reference" title="DOM event reference">DOM event reference</a></dt> - <dd> - Lists all the DOM events and their meanings.</dd> - <dt> - <a href="/en-US/docs/DOM/Manipulating_the_browser_history" title="en-US/docs/DOM/Manipulating_the_browser_history">History API: Manipulating the browser history</a></dt> - <dd> - Demonstrates the HTML5-introduced DOM {{ domxref("window.history") }} object, allowing dynamic changes to the browser history.</dd> - <dt> - <a href="/en-US/docs/Using_files_from_web_applications" title="https://developer.mozilla.org/en-US/docs/Using_files_from_web_applications">File API: Using files from web applications</a></dt> - <dd> - Describes the HTML5-introduced capability to select a local file and read data from it.</dd> - <dt> - <a href="/en-US/docs/DOM/Using_the_Page_Visibility_API" title="en-US/docs/DOM/Using_the_Page_Visibility_API">Using the Page Visibility API</a></dt> - <dd> - Explains how to detect and use information about a web page being in the foreground or in the background.</dd> - <dt> - <a href="/en-US/docs/DOM/Using_full-screen_mode" title="Using full-screen mode">Fullscreen API: Using the fullscreen mode</a></dt> - <dd> - Describes how to set up a page that use the whole screen, without any browser UI around it.</dd> - <dt> - <a href="/en-US/docs/Determining_the_dimensions_of_elements" title="en-US/docs/Determining_the_dimensions_of_elements">Determining the dimensions of elements</a></dt> - <dd> - How to figure out the right way to determine the dimensions of elements, given your needs.</dd> - <dt> - <a href="/en-US/docs/Dynamically_modifying_XUL-based_user_interface" title="en-US/docs/Dynamically_modifying_XUL-based_user_interface">Dynamically modifying XUL-based user interface</a></dt> - <dd> - The basics of manipulating the XUL UI with DOM methods.</dd> - </dl> - <p><span class="alllinks"><a href="/en-US/docs/tag/DOM" title="/en-US/docs/tag/DOM">View All...</a></span></p> - </div> - <div class="section"> - <h2 class="Community" id="Community" name="Community">Getting help from the community</h2> - <p>You need help on a DOM-related problem and can't find the solution in the documentation?</p> - <ul> - <li>Consult the dedicated Mozilla forum: {{ DiscussionList("dev-tech-dom", "mozilla.dev.tech.dom") }}</li> - </ul> - <h2 class="Tools" id="Tools" name="Tools">Tools easing working with the DOM</h2> - <ul> - <li><a class="external" href="http://www.getfirebug.com/">Firebug </a></li> - <li><a href="/en-US/docs/DOM_Inspector" title="en-US/docs/DOM_Inspector">DOM Inspector</a></li> - <li><a class="external" href="http://slayeroffice.com/tools/modi/v2.0/modi_help.html">Mouse-over DOM Inspector</a></li> - <li><a class="external" href="http://www.karmatics.com/aardvark/">Aardvark Firefox extension</a></li> - </ul> - <p><span class="alllinks"><a href="/en-US/docs/tag/DOM:Tools" title="/en-US/docs/tag/DOM:Tools">View All...</a></span></p> - <h2 class="Related_Topics" id="Related_Topics" name="Related_Topics">Related Topics</h2> - <ul> - <li><a href="/en-US/docs/AJAX" title="en-US/docs/AJAX">AJAX</a>, <a href="/en-US/docs/CSS" title="en-US/docs/CSS">CSS</a>, <a href="/en-US/docs/DHTML" title="en-US/docs/DHTML">DHTML</a>, <a href="/en-US/docs/JavaScript" title="en-US/docs/JavaScript">JavaScript</a></li> - </ul> - </div> -</div> -<p> </p> diff --git a/files/fi/web/api/index.html b/files/fi/web/api/index.html deleted file mode 100644 index 98bda55ac9..0000000000 --- a/files/fi/web/api/index.html +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: Web API Interfaces -slug: Web/API -tags: - - Web -translation_of: Web/API ---- -<p>When writing code for the Web using JavaScript, there are a great many APIs available. Below is a list of all the interfaces (that is, types of objects) that you may be able to use while developing your Web app or site.</p> - -<div>{{APIListAlpha}}</div> diff --git a/files/fi/web/api/intersectionobserver/index.html b/files/fi/web/api/intersectionobserver/index.html deleted file mode 100644 index e62bd8b216..0000000000 --- a/files/fi/web/api/intersectionobserver/index.html +++ /dev/null @@ -1,87 +0,0 @@ ---- -title: IntersectionObserver -slug: Web/API/IntersectionObserver -translation_of: Web/API/IntersectionObserver ---- -<div>{{APIRef("Intersection Observer API")}}</div> - -<p><a href="/en-US/docs/Web/API/Intersection_Observer_API">Intersection Observer API:n </a> rajapinta <code><strong>IntersectionObserver</strong></code> tarjoaa asynkronisen keinon tarkkailla muutoksia kohde-elementin ja sen esi-isäelementin tai ylätason dokumentin {{Glossary('viewport')}}:n kanssa. Näihin korkeamman tason DOM -elementteihin viitataan nimellä "root".</p> - -<p>Kun <code>IntersectionObserver</code> luodaan, se konfiguroidaan tarkkailemaan DOM-elementtien näkyvyyttä suhteessa root:tiin. Tätä konfiguraatiota ei voida muuttaa sen jälkeen, kun se on initialisoitu, eli käytännössä yhdellä instanssilla tarkkaillaan elementtien näkyvyyttä yhden root -tason elementin suhteen. Yhdellä <code>IntersectionObserver</code>:lla voidaan kuitenkin tarkkailla monen elementin näkyvyyttä tämän suhteen.</p> - -<h2 id="Constructor">Constructor</h2> - -<dl> - <dt>{{domxref("IntersectionObserver.IntersectionObserver()")}}</dt> - <dd>Luo uuden <code>IntersectionObserver</code> -instanssin, joka suorittaa annetun "callback" -function kun se havaitsee, että kohde-elementin näkyvyys on ylittänyt annetun kynnyksen.</dd> -</dl> - -<h2 id="Properties">Properties</h2> - -<dl> - <dt>{{domxref("IntersectionObserver.root")}} {{readonlyinline}}</dt> - <dd>Tietty elementin esi-isä -elementti, jonka suhteen kohteen {{domxref("element")}} näkyvyyttä tarkkaillaan. Jos tätä ei erityiesti määritellä, käytetään koko dokumentin juuren viewport:ia.</dd> - <dt>{{domxref("IntersectionObserver.rootMargin")}} {{readonlyinline}}</dt> - <dd>An offset rectangle applied to the root's {{Glossary('bounding box')}} when calculating intersections, effectively shrinking or growing the root for calculation purposes. The value returned by this property may not be the same as the one specified when calling the constructor as it may be changed to match internal requirements. Each offset can be expressed in pixels (<code>px</code>) or as a percentage (<code>%</code>). The default is "0px 0px 0px 0px".</dd> - <dt>{{domxref("IntersectionObserver.thresholds")}} {{readonlyinline}}</dt> - <dd>A list of thresholds, sorted in increasing numeric order, where each threshold is a ratio of intersection area to bounding box area of an observed target. Notifications for a target are generated when any of the thresholds are crossed for that target. If no value was passed to the constructor, 0 is used.</dd> -</dl> - -<h2 id="Methods">Methods</h2> - -<dl> - <dt>{{domxref("IntersectionObserver.disconnect()")}}</dt> - <dd>Stops the <code>IntersectionObserver</code> object from observing any target.</dd> - <dt>{{domxref("IntersectionObserver.observe()")}}</dt> - <dd>Tells the <code>IntersectionObserver</code> a target element to observe.</dd> - <dt>{{domxref("IntersectionObserver.takeRecords()")}}</dt> - <dd>Returns an array of {{domxref("IntersectionObserverEntry")}} objects for all observed targets.</dd> - <dt>{{domxref("IntersectionObserver.unobserve()")}}</dt> - <dd>Tells the <code>IntersectionObserver</code> to stop observing a particular target element.</dd> -</dl> - -<h2 id="Examples">Examples</h2> - -<pre class="brush: js">var intersectionObserver = new IntersectionObserver(function(entries) { - // If intersectionRatio is 0, the target is out of view - // and we do not need to do anything. - if (entries[0].intersectionRatio <= 0) return; - - loadItems(10); - console.log('Loaded new items'); -}); -// start observing -intersectionObserver.observe(document.querySelector('.scrollerFooter'));</pre> - -<h2 id="Specifications">Specifications</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Specification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName("IntersectionObserver", "#intersection-observer-interface", "IntersectionObserver")}}</td> - <td>{{Spec2('IntersectionObserver')}}</td> - <td></td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility">Browser compatibility</h2> - -<p class="hidden">The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> and send us a pull request.</p> - -<p>{{Compat("api.IntersectionObserver")}}</p> - -<h2 id="See_also">See also</h2> - -<ul> - <li>{{domxref('MutationObserver')}}</li> - <li>{{domxref('PerformanceObserver')}}</li> - <li>{{domxref('ResizeObserver')}}</li> -</ul> diff --git a/files/fi/web/api/navigator/battery/index.html b/files/fi/web/api/navigator/battery/index.html deleted file mode 100644 index a7c0268ed1..0000000000 --- a/files/fi/web/api/navigator/battery/index.html +++ /dev/null @@ -1,138 +0,0 @@ ---- -title: window.navigator.battery -slug: Web/API/Navigator/battery -translation_of: Web/API/Navigator/battery -original_slug: DOM/window.navigator.battery ---- -<p>{{ ApiRef() }}</p> -<p><strong>Battery Status API</strong>, useimmiten lyhennettynä <em>Battery API</em>, tarjoaa tietoa järjestelmän akun lataustasosta ja sallii sinulle ilmoitettavan muutaman akkutasomuutostapahtuman kautta. Tätä voitaisiin käyttää lataamaan vähemmän suoritinintensiiviset tehtävät sivustollasi, jos akkuvirta on vähissä ja tallentaa muutokset ennen akkuvirran loppumista, jotta estetään tietojen häviäminen.</p> -<p>Battery Status API laajentaa {{domxref("window.navigator")}}-objektin metodilla <code>battery</code>. Se määrittää myös muutamia uusia tapahtumia.</p> -<h2 id="Attribuutit">Attribuutit</h2> -<dl> - <dt> - <code>charging</code></dt> - <dd> - <strong>Kirjoitussuojattu</strong>. Boolean-arvo edustaa järjestelmän akun lataustilaa. Palauttaa arvon <code>true</code>, jos akkua ladataan, jos järjestelmän akun tila ei ole määriteltävissä, tai jos akkua ei ole liitetty järjestelmään. Palauttaa arvon <code>false</code>, jos akkua puretaan.</dd> - <dt> - <code>chargingTime</code></dt> - <dd> - <strong>Kirjoitussuojattu</strong>. Double-arvo edustaa jäljellä olevaa sekuntimäärää siihen kun järjestelmän akku ladattu täyteen. Palauttaa arvon 0, jos akku on ladattu täyteen.<br> - Palauttaa positiivisen äärettämän arvon, jos akkua puretaan tai jos toteutus ei kykene ilmoittamaan jäljellä olevaa latausaikaa.</dd> - <dt> - <code>dischargingTime</code></dt> - <dd> - <strong>Kirjoitussuojattu</strong>. Double-arvo edustaa jäljellä olevaa sekuntimäärää siihen kun järjestelmän akku on täysin purettu ja järjestelmä keskeytetään. Palauttaa positiivisen äärettömän arvon, jos akkua ladataan, jos toteutus ei kykene ilmoittamaan purkamisaikaa, tai jos järjestelmään ei ole liitetty akkua.</dd> - <dt> - <code>level</code></dt> - <dd> - <strong>Kirjoitussuojattu</strong>. Double-arvo edustaa järjestelmän akun lataustasoa skaalalla 0 ... 1.0. Palauttaa arvon 0, jos akku on tyhjä ja järjestelmä on siirtymässä keskeytystilaan. Palauttaa arvon 1.0, jos akku on täynnä, jos toteutus ei kykene ilmoittamaan akun tasoa, tai jos akkua ei ole liitetty järjestelmään.</dd> -</dl> -<h2 id="Tapahtumat">Tapahtumat</h2> -<dl> - <dt> - <code>chargingchange</code></dt> - <dd> - Laukeaa, kun akun lataustilaa päivitetään.</dd> - <dt> - <code>chargingtimechange</code></dt> - <dd> - Laukeaa, kun akun latausaikaa päivitetään.</dd> - <dt> - <code>dischargingtimechange</code></dt> - <dd> - Laukeaa, kun akun purkausaikaa päivitetään.</dd> - <dt> - <code>levelchange</code></dt> - <dd> - Laukeaa, kun akun tasoa päivitetään.</dd> -</dl> -<h2 id="Esimerkki">Esimerkki</h2> -<p>Katso myös <a class="external" href="http://dev.w3.org/2009/dap/system-info/battery-status.html#introduction">esimerkkiä spesifikaatiossa</a>.</p> -<pre class="brush: js">var battery = navigator.battery || navigator.mozBattery || navigator.webkitBattery; - -function updateBatteryStatus() { - alert("Battery status: " + battery.level * 100 + " %"); - - if (battery.charging) { - alert("Battery is charging"); - } -} - -battery.addEventListener("chargingchange", updateBatteryStatus); -battery.addEventListener("levelchange", updateBatteryStatus); -updateBatteryStatus(); -</pre> -<h2 id="Spesifikaatiot">Spesifikaatiot</h2> -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Spesifikaatio</th> - <th scope="col">Tila</th> - <th scope="col">Kommentti</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('Battery API')}}</td> - <td>{{Spec2('Battery API')}}</td> - <td>Alustava spesifikaatio.</td> - </tr> - </tbody> -</table> -<h2 id="Selainyhteensopivuus">Selainyhteensopivuus</h2> -<p>{{ CompatibilityTable() }}</p> -<div id="compat-desktop"> - <table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Perustuki</td> - <td>20 {{ property_prefix("webkit") }}</td> - <td>{{CompatGeckoDesktop("10")}} {{ property_prefix("moz") }} [1]<br> - {{CompatGeckoDesktop("16")}} (without prefix) [2]</td> - <td>{{ CompatNo() }}</td> - <td>{{ CompatNo() }}</td> - <td>{{ CompatNo() }}</td> - </tr> - </tbody> - </table> -</div> -<div id="compat-mobile"> - <table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Perustuki</td> - <td>20 {{ property_prefix("webkit") }}</td> - <td>{{CompatGeckoMobile("10")}} {{ property_prefix("moz") }} [1]<br> - {{CompatGeckoMobile("16")}} (without prefix) [2]</td> - <td>{{ CompatNo() }}</td> - <td>{{ CompatNo() }}</td> - <td>{{ CompatNo() }}</td> - </tr> - </tbody> - </table> -</div> -<h3 id="Gecko-kommentit">Gecko-kommentit</h3> -<p>[1] Disabled by default in Firefox 10.0, but can be enabled setting the preference <code>dom.battery.enabled</code> to <code>true</code>. Starting with Firefox 11.0, <code>mozBattery</code> is enabled by default.</p> -<p class="note">[2] The Battery API is currently supported on Android, Windows, and Linux with UPower installed. Support for MacOS is available starting with Gecko 18.0 {{geckoRelease("18.0")}}.</p> -<h2 id="Katso_myös">Katso myös</h2> -<ul> - <li><a class="external" href="http://hacks.mozilla.org/2012/02/using-the-battery-api-part-of-webapi/">Blog post - Using the Battery API</a></li> - <li><a class="external" href="http://davidwalsh.name/battery-api" title="http://davidwalsh.name/battery-api">David Walsh on the JavaScript Battery Api</a></li> - <li><a href="https://github.com/pstadler/battery.js" title="https://github.com/pstadler/battery.js">battery.js - a tiny cross-browser wrapper</a></li> -</ul> diff --git a/files/fi/web/api/navigator/buildid/index.html b/files/fi/web/api/navigator/buildid/index.html deleted file mode 100644 index 45d96d5d30..0000000000 --- a/files/fi/web/api/navigator/buildid/index.html +++ /dev/null @@ -1,22 +0,0 @@ ---- -title: window.navigator.buildID -slug: Web/API/Navigator/buildID -translation_of: Web/API/Navigator/buildID -original_slug: DOM/window.navigator.buildID ---- -<p>{{ ApiRef() }}</p> -<h3 id="Summary" name="Summary">Yhteenveto</h3> -<p>Palauttaa selaimen rakentamistunnisteen.</p> -<h3 id="Syntax" name="Syntax">Syntaksi</h3> -<pre class="eval"><em>buildID</em> = <em>navigator</em>.buildID; -</pre> -<p><code>buildID</code> on sovelluksen rakentamistunniste merkkijonona. Tämä rakentamistunniste on muotoa <code>YYYYMMDDHH</code>.</p> -<h3 id="Example" name="Example">Esimerkki</h3> -<pre class="eval">dump(window.navigator.buildID); -// prints "2006090803" to the console -</pre> -<h3 id="Note" name="Note">Huomaa</h3> -<p>Käytettävissä selaimessa <a href="/en/Firefox_2_for_developers" title="en/Firefox_2_for_developers">Firefox 2</a> (<a href="/en/Gecko" title="en/Gecko">Gecko</a> 1.8.1) ja uudemmissa. Toteutettu kohteessa {{ Bug(345993) }}.</p> -<h3 id="Specification" name="Specification">Spesifikaatio</h3> -<p>Ei kuulu mihinkään standardiin.</p> -<p>{{ languages( { "ja": "ja/DOM/window.navigator.buildID", "zh-cn": "zh-cn/DOM/window.navigator.buildID", "pl": "pl/DOM/window.navigator.buildID" } ) }}</p> diff --git a/files/fi/web/api/navigator/connection/index.html b/files/fi/web/api/navigator/connection/index.html deleted file mode 100644 index db3485532a..0000000000 --- a/files/fi/web/api/navigator/connection/index.html +++ /dev/null @@ -1,101 +0,0 @@ ---- -title: window.navigator.connection -slug: Web/API/Navigator/connection -translation_of: Web/API/Navigator/connection -original_slug: DOM/window.navigator.connection ---- -<p>{{ Apiref() }}</p> -<p>{{ SeeCompatTable() }}</p> -<p>Network Information API tarjoaa tietoa järjestelmän verkkoyhteydestä, kuten käyttäjän laitteen nykyisestä kaistanleveydestä tai onko yhteys mitattu. Tätä voitaisiin käyttää valitsemaan HD-sisältö tai LD-sisältö käyttäjän yhteyteen perustuen.</p> -<h2 id="Attribuutit">Attribuutit</h2> -<dl> - <dt> - <code>bandwidth</code></dt> - <dd> - <strong>Kirjoitussuojattu</strong>. Double-arvo edustaa arvioitua nykyisen yhteyden latauskaistanleveyttä (arvona MB/s). <code>0</code> jos käyttäjä ei ole parhaillaan verkkoyhteydessä ja <code>infinity</code> jos kaistanleveys on tuntematon.</dd> - <dt> - <code>metered</code></dt> - <dd> - <strong>Kirjoitussuojattu</strong>. <code><a href="/en/JavaScript/Reference/Global_Objects/Boolean" title="en/JavaScript/Reference/Global_Objects/Boolean">Boolean</a></code>-arvo palauttaen <code>true</code>, jos yhteys on mitattu (esim.: pay-per-use).</dd> -</dl> -<h2 id="Tapahtumat">Tapahtumat</h2> -<dl> - <dt> - <code>onchange</code></dt> - <dd> - Laukeaa, kun yhteys muuttuu.</dd> -</dl> -<h2 id="Esimerkki">Esimerkki</h2> -<pre class="brush: js">var connection = navigator.connection || navigator.mozConnection || navigator.webkitConnection; - -function updateConnectionStatus() { - alert("Connection bandwidth: " + connection.bandwidth + " MB/s"); - if (connection.metered) { - alert("The connection is metered!"); - } -} - -connection.addEventListener("change", updateConnectionStatus); -updateConnectionStatus(); -</pre> -<h2 id="Selainyhteensopivuus">Selainyhteensopivuus</h2> -<p>{{ CompatibilityTable() }}</p> -<div id="compat-desktop"> - <table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Perustuki</td> - <td>20? {{ property_prefix("webkit") }}</td> - <td>12.0 {{ property_prefix("moz") }} (katso kommentit)</td> - <td>{{ CompatNo() }}</td> - <td>{{ CompatNo() }}</td> - <td>{{ CompatNo() }}</td> - </tr> - </tbody> - </table> -</div> -<div id="compat-mobile"> - <table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Perustuki</td> - <td>{{ CompatNo() }}</td> - <td>12.0 {{ property_prefix("moz") }} (katso kommentit)</td> - <td>{{ CompatNo() }}</td> - <td>{{ CompatNo() }}</td> - <td>{{ CompatNo() }}</td> - </tr> - </tbody> - </table> -</div> -<h3 id="Gecko-kommentit">Gecko-kommentit</h3> -<ul> - <li>Network API voidaan ottaa pois käytöstä käyttäen <code>dom.network.enabled</code>-asetusta.</li> - <li>Attribuutti <code>metered</code> on oletusarvoisesti <code>false</code> ja voidaan asettaa käyttäen asetusta <code>dom.network.metered</code> (katso {{ bug("716943") }} <span id="summary_alias_container"><span id="short_desc_nonedit_display">yhteyden merkitseminen mitatuksi verkkovierailuilla</span></span>).</li> - <li>Gecko 12.0 -versiosta alkaen Network API toteutettiin vain Android-järjestelmissä. Tuki Linux- ({{ bug("712442") }}) ja Windows- ({{ bug("721306") }}) järjestelmille on kehitteillä.</li> - <li>Ennen Gecko 14.0 -versiota <code>navigator.mozConnection</code> ei ollut EventTarget-ilmentymä ja funktiota <code>addEventListener</code> ei voitu kutsua. Tämä on korjattu ({{ bug("735261") }}).</li> -</ul> -<h2 id="Spesifikaatio">Spesifikaatio</h2> -<ul> - <li>{{ spec("http://dvcs.w3.org/hg/dap/raw-file/tip/network-api/Overview.html", "Network Information API Specification", "ED") }}</li> -</ul> -<h2 id="Katso_myös">Katso myös</h2> -<ul> - <li><a href="/en/Online_and_offline_events" title="en/Online_and_offline_events">Verkko- ja erillissovellustapahtumat</a></li> -</ul> diff --git a/files/fi/web/api/navigator/cookieenabled/index.html b/files/fi/web/api/navigator/cookieenabled/index.html deleted file mode 100644 index 505ac8fa2a..0000000000 --- a/files/fi/web/api/navigator/cookieenabled/index.html +++ /dev/null @@ -1,100 +0,0 @@ ---- -title: Navigator.cookieEnabled -slug: Web/API/Navigator/cookieEnabled -tags: - - API - - DOM - - Ominaisuus -translation_of: Web/API/Navigator/cookieEnabled -original_slug: DOM/window.navigator.cookieEnabled ---- -<p>{{ ApiRef("HTML DOM") }}</p> - -<p>Palauttaa totuusarvon, joka osoittaa, ovatko evästeet käytössä vai eivät.</p> - -<h2 id="Syntaksi">Syntaksi</h2> - -<pre class="eval">var cookieEnabled = navigator.cookieEnabled; -</pre> - -<ul> - <li><code>cookieEnabled</code> on totuusarvo, <code>true</code> tai <code>false</code>.</li> -</ul> - -<h2 id="Esimerkki">Esimerkki</h2> - -<pre class="brush: js">if (!navigator.cookieEnabled) { - // kerrotaan käyttäjälle, että evästeiden käyttöönotto tekee sivusta paljon hyödyllisemmän -} -</pre> - -<h2 id="Määrittelyt">Määrittelyt</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Määrittely</th> - <th scope="col">Tila</th> - <th scope="col">Kommentti</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName("HTML WHATWG", "webappapis.html#dom-navigator-cookieenabled", "Navigator.cookieEnabled")}}</td> - <td>{{Spec2("HTML WHATWG")}}</td> - <td>Alkuperäinen määrittely</td> - </tr> - </tbody> -</table> - -<h2 id="Selainyhteensopivuus">Selainyhteensopivuus</h2> - -<p>{{ CompatibilityTable() }}</p> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Ominaisuus</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Perustuki</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatGeckoDesktop(1.0) }}</td> - <td>{{ CompatVersionUnknown() }}<sup>[1]</sup></td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Ominaisuus</th> - <th>Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Perustuki</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatGeckoMobile(1.0) }}<sup>[1]</sup></td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - </tr> - </tbody> -</table> -</div> - -<p>[1] Ennen Gecko 8.0:aa {{ geckoRelease("8.0") }}, <code>window.navigator.cookieEnabled</code> ilmoittaa väärän tuloksen, jos sivulle, jolle tarkistus suoritetaan, on asetettu sivustopoikkeus. Tämä on korjattu.</p> diff --git a/files/fi/web/api/navigator/donottrack/index.html b/files/fi/web/api/navigator/donottrack/index.html deleted file mode 100644 index a06787c3c9..0000000000 --- a/files/fi/web/api/navigator/donottrack/index.html +++ /dev/null @@ -1,74 +0,0 @@ ---- -title: navigator.doNotTrack -slug: Web/API/Navigator/doNotTrack -translation_of: Web/API/Navigator/doNotTrack -original_slug: DOM/navigator.doNotTrack ---- -<p>{{ ApiRef() }}</p> -<h3 id="Summary" name="Summary">Yhteenveto</h3> -<p>Palauttaa käyttäjän do-not-track -asetuksen. Tämä on "yes", jos käyttäjä on pyytänyt, että hänen vierailemiaan webbisivuja, sisältöä tai mainoksia ei seurata.</p> -<h3 id="Syntax" name="Syntax">Syntaksi</h3> -<pre class="eval"><em>dnt</em> = <em>navigator</em>.doNotTrack; -</pre> -<p>Huomaa, että <strong><code>navigator.doNotTrack</code> ei ole do-not-track -otsakkeessa lähetettävä arvo</strong>. Kun the do-not-track otsake lähettää "1", <code>navigator.doNotTrack</code> on "yes". Kun otsaketta ei ole asetettu, <code>navigator.doNotTrack</code> on "unspecified". Kun otsake lähettää "0" (ei tueta nykyisin Firefoxissa), <code>navigator.doNotTrack</code> on "no".</p> -<h3 id="Example" name="Example">Esimerkki</h3> -<pre class="eval">dump(window.navigator.doNotTrack); -// tulostaa "yes" jos DNT ei ole käytössä; muussa tapauksessa tämä on "unspecified" Firefoxissa -</pre> -<h3 id="Specification" name="Specification">Spesifikaatio</h3> -<p><a class="external" href="http://www.w3.org/TR/tracking-dnt/" title="http://www.w3.org/TR/tracking-dnt/">Tracking Preference Expression</a> (Working Draft) perustuu tämän spesifikaation aikaisempaan versioon josssa <code>navigator.doNotTrack</code> <strong>on</strong> do-not-track -otsakkeessa lähetettävä arvo.</p> -<h3 id="Katso_myös">Katso myös</h3> -<ul> - <li><a href="/en/The_Do_Not_Track_Field_Guide" title="https://developer.mozilla.org/en/The_Do_Not_Track_Field_Guide">The Do Not Track field guide</a></li> -</ul> -<h3 id="Selainyhteensopivuus">Selainyhteensopivuus</h3> -<p>{{CompatibilityTable() }}</p> -<div id="compat-desktop"> - <table class="compat-table"> - <tbody> - <tr> - <th><strong>Feature</strong></th> - <th><strong>Chrome</strong></th> - <th><strong>Firefox (Gecko)</strong></th> - <th><strong>Internet Explorer</strong></th> - <th><strong>Opera</strong></th> - <th><strong>Safari</strong></th> - </tr> - <tr> - <td>Perustuki</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatGeckoDesktop("9.0") }}</td> - <td>9</td> - <td>12</td> - <td>5.1 käyttöjärjestelmässä OS X 10.7</td> - </tr> - </tbody> - </table> -</div> -<div id="compat-mobile"> - <table class="compat-table"> - <tbody> - <tr> - <th><strong>Feature</strong></th> - <th><strong>Android</strong></th> - <th><strong>Firefox Mobile (Gecko)</strong></th> - <th><strong>IE Mobile</strong></th> - <th><strong>Opera Mobile</strong></th> - <th><strong>Safari Mobile</strong></th> - </tr> - <tr> - <td>Perustuki</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatGeckoMobile("9.0") }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - </tr> - </tbody> - </table> -</div> -<ul> - <li>IE9 käyttää toimittajaetuliitettä, toisin sanoen, navigator.msDoNotTrack</li> - <li>IE9, Opera 12, ja Safari 5.1 perustuvat tämän spesifikaation aikaisempaan versioon jossa <code>navigator.doNotTrack</code> <strong>on</strong> do-not-track-otsakkeessa lähetettävä arvo.</li> -</ul> -<p><strong>{{ languages( { "zh-cn": "zh-cn/DOM/navigator.doNotTrack" } ) }}</strong></p> diff --git a/files/fi/web/api/navigator/oscpu/index.html b/files/fi/web/api/navigator/oscpu/index.html deleted file mode 100644 index 5377c0cb69..0000000000 --- a/files/fi/web/api/navigator/oscpu/index.html +++ /dev/null @@ -1,71 +0,0 @@ ---- -title: window.navigator.oscpu -slug: Web/API/Navigator/oscpu -translation_of: Web/API/Navigator/oscpu -original_slug: DOM/window.navigator.oscpu ---- -<p>{{ ApiRef() }}</p> -<h3 id="Summary" name="Summary">Yhteenveto</h3> -<p>Palauttaaa merkkijonon, joka identifioi nykyisen käyttäjärjestelmän.</p> -<h3 id="Syntax" name="Syntax">Syntaksi</h3> -<pre class="eval"><em>oscpuInfo</em> = window.navigator.oscpu -</pre> -<ul> - <li><code>oscpuInfo</code> on merkkijono, joka noudattaa seuraavaa muotoa:</li> -</ul> -<table class="fullwidth-table"> - <tbody> - <tr> - <th>Käyttöjärjestelmä</th> - <th><code>oscpuInfo</code>-merkkijonomuoto</th> - </tr> - <tr> - <td>OS/2</td> - <td>OS/2 Warp x (joko 3, 4 tai 4.5)</td> - </tr> - <tr> - <td>Windows CE</td> - <td>WindowsCE x.y<sup>1</sup></td> - </tr> - <tr> - <td>Windows 64-bit (64-bit build)</td> - <td>Windows NT x.y; Win64; x64</td> - </tr> - <tr> - <td>Windows 64-bit (32-bit build)</td> - <td>Windows NT x.y; WOW64</td> - </tr> - <tr> - <td>Windows 32-bit</td> - <td>Windows NT x.y</td> - </tr> - <tr> - <td>Mac OS X (PPC build)</td> - <td>PPC Mac OS X x.y</td> - </tr> - <tr> - <td>Mac OS X (i386/x64 build)</td> - <td>Intel Mac OS X x.y</td> - </tr> - <tr> - <td>Linux 64-bit (32-bit build)</td> - <td>Output of uname -s plus "i686 on x86_64"</td> - </tr> - <tr> - <td>Linux</td> - <td>Output of uname -sm</td> - </tr> - </tbody> -</table> -<p><sup>1</sup>x.y viittaa käyttöjärjestelmän versioon</p> -<h3 id="Example" name="Example">Esimerkki</h3> -<pre class="brush: js">function osInfo() { - alert(window.navigator.oscpu); -} -// palauttaa esimerkiksi: "Windows NT 6.0" -</pre> -<h3 id="Notes" name="Notes">Kommentit</h3> -<p>Jollei koodi ole etuoikeutettu (chrome tai ainakin on UniversalBrowserRead-etuoikeus), se voi saada <code>general.oscpu.override</code>-asetusarvon eikä todellista alustaa.</p> -<h3 id="Specification" name="Specification">Spesifikaatio</h3> -<p>{{ DOM0() }}</p> -<p>{{ languages( { "ja": "ja/DOM/window.navigator.oscpu", "zh-cn": "zh-cn/DOM/window.navigator.oscpu", "pl": "pl/DOM/window.navigator.oscpu" } ) }}</p> diff --git a/files/fi/web/api/navigator/productsub/index.html b/files/fi/web/api/navigator/productsub/index.html deleted file mode 100644 index eecbb2d1a8..0000000000 --- a/files/fi/web/api/navigator/productsub/index.html +++ /dev/null @@ -1,30 +0,0 @@ ---- -title: window.navigator.productSub -slug: Web/API/Navigator/productSub -translation_of: Web/API/Navigator/productSub -original_slug: DOM/window.navigator.productSub ---- -<div> - {{ApiRef}} {{non-standard_header}}</div> -<h2 id="Summary" name="Summary">Yhteenveto</h2> -<p><b>productSub</b> palauttaa nykyisen selaimen rakentamisnumeron.</p> -<h2 id="Syntax" name="Syntax">Syntaksi</h2> -<pre class="syntaxbox"><i>prodSub</i> = window.navigator.productSub</pre> -<ul> - <li><code>prodSub</code> on merkkijono.</li> -</ul> -<h2 id="Example" name="Example">Esimerkki</h2> -<pre class="brush:js"><script> -function prodsub() { - var dt = document.getElementById("d").childNodes[0]; - dt.data = window.navigator.productSub; -} -</script> - -<button onclick="prodsub();">productSub</button> -// palauttaa: 20010725</pre> -<h2 id="Notes" name="Notes">Kommentit</h2> -<p>IE-selaimessa tämä ominaisuus palauttaa määrittelemättömän.</p> -<p>Apple Safari- ja Google Chrome-selaimissa tämä ominaisuus palauttaa aina <code>20030107</code>.</p> -<h2 id="Specification" name="Specification">Spesifikaatio</h2> -<p>{{dom0}}</p> diff --git a/files/fi/web/api/navigator/vendor/index.html b/files/fi/web/api/navigator/vendor/index.html deleted file mode 100644 index 0a454d0cff..0000000000 --- a/files/fi/web/api/navigator/vendor/index.html +++ /dev/null @@ -1,25 +0,0 @@ ---- -title: window.navigator.vendor -slug: Web/API/Navigator/vendor -translation_of: Web/API/Navigator/vendor -original_slug: DOM/window.navigator.vendor ---- -<p>{{ ApiRef() }}</p> -<h3 id="Summary" name="Summary">Yhteenveto</h3> -<p>Palauttaa nykyisen selaimen selaintoimittajan nimen.</p> -<h3 id="Syntax" name="Syntax">Syntaksi</h3> -<pre class="eval"><em>venString</em> = window.navigator.vendor -</pre> -<h3 id="Parameters" name="Parameters">Parametrit</h3> -<ul> - <li><code>venString</code> on merkkijono.</li> -</ul> -<h3 id="Example" name="Example">Esimerkki</h3> -<pre>window.navigator.vendor -// returns "Netscape6" -</pre> -<h3 id="Notes" name="Notes">Kommentit</h3> -<p>toimittaja on toinen userAgent-merkkijonon osa. Tuote ja toimittaja voivat olla erilaisia--kuten kun Netscape 6.1 käyttää Gecko-tuotetta tehdäkseen oman renderointinsa. Katso myös <a href="/en/DOM/window.navigator.product" title="en/DOM/window.navigator.product">navigator.product</a>, <a href="/en/DOM/window.navigator.userAgent" title="en/DOM/window.navigator.userAgent">navigator.userAgent</a></p> -<h3 id="Specification" name="Specification">Spesifikaatio</h3> -<p>DOM Level 0. Ei ole spesifikaation osa.</p> -<p>{{ languages( { "ja": "ja/DOM/window.navigator.vendor" ,"zh-cn": "zh-cn/DOM/window.navigator.vendor" } ) }}</p> diff --git a/files/fi/web/api/navigatorid/appcodename/index.html b/files/fi/web/api/navigatorid/appcodename/index.html deleted file mode 100644 index 332f211f68..0000000000 --- a/files/fi/web/api/navigatorid/appcodename/index.html +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: window.navigator.appCodeName -slug: Web/API/NavigatorID/appCodeName -translation_of: Web/API/NavigatorID/appCodeName -original_slug: DOM/window.navigator.appCodeName ---- -<p>{{ ApiRef() }}</p> -<h3 id="Summary" name="Summary">Yhteenveto</h3> -<p>Palauttaa nykyisen selaimen sisäisen "code"-nimen.</p> -<h3 id="Syntax" name="Syntax">Syntaksi</h3> -<pre class="eval">codeName = window.navigator.appCodeName -</pre> -<h3 id="Parameters" name="Parameters">Parametrit</h3> -<ul> - <li><code>codeName</code> on selaimen sisäinen nimi merkkijonona.</li> -</ul> -<h3 id="Example" name="Example">Esimerkki</h3> -<pre>dump(window.navigator.appCodeName); -</pre> -<h3 id="Notes" name="Notes">Kommentit</h3> -<p>Mozilla, Netscape 6, jad IE5 kaikki käyttävät sisäistä nimeä "Mozilla."</p> -<h3 id="Specification" name="Specification">Spesifikaatio</h3> -<p>DOM Level 0. Ei ole spesifikaation osa.</p> -<p>{{ languages( { "zh-cn": "zh-cn/DOM/window.navigator.appCodeName","ja": "ja/DOM/window.navigator.appCodeName", "pl": "pl/DOM/window.navigator.appCodeName" } ) }}</p> diff --git a/files/fi/web/api/navigatorid/appname/index.html b/files/fi/web/api/navigatorid/appname/index.html deleted file mode 100644 index b18bc0137a..0000000000 --- a/files/fi/web/api/navigatorid/appname/index.html +++ /dev/null @@ -1,28 +0,0 @@ ---- -title: window.navigator.appName -slug: Web/API/NavigatorID/appName -translation_of: Web/API/NavigatorID/appName -original_slug: DOM/window.navigator.appName ---- -<p>{{ ApiRef() }}</p> -<h3 id="Summary" name="Summary">Yhteenveto</h3> -<p>Palauttaa selaimen nimen. HTML5-spesifikaatio sallii kaikkien selainten myös palauttaa tässä "Netscape" yhteensopivuussyistä.</p> -<div class="note"> - <strong>Huomaa:</strong> Älä nojaa tähän ominaisuuteen oikean selainnimen palauttamiseksi. Gecko-perustaisissa selaimissa (kuten Firefox) ja WebKit-perustaisissa selaimissa (kuten Chrome ja Safari) palautettu arvo on "Netscape".</div> -<h3 id="Syntax" name="Syntax">Syntaksi</h3> -<pre class="eval">appName = window.navigator.appName -</pre> -<h3 id="Parameters" name="Parameters">Palautettu arvo</h3> -<ul> - <li><code>appName</code> on selaimen nimi merkkijonona.</li> -</ul> -<h3 id="Example" name="Example">Esimerkki</h3> -<pre class="brush: js">alert(window.navigator.appName); -// shows the name of the browser -</pre> -<h3 id="Specification" name="Specification">Spesifikaatio</h3> -<ul> - <li><a class="external" href="http://www.w3.org/TR/html5/timers.html#navigator" title="http://www.w3.org/TR/html5/timers.html#navigator">HTML5: Järjestelmätila ja kykeneväisyydet: Navigator-objekti</a></li> -</ul> -<p>Tämä oli alunperin osa DOM-tasoa 0, mutta on sen jälkeen sisällytetty HTML5-spesifikaatioon.</p> -<p>{{ languages( { "ja": "ja/DOM/window.navigator.appName", "pl": "pl/DOM/window.navigator.appName", "zh-cn": "zh-cn/DOM/window.navigator.appName" } ) }}</p> diff --git a/files/fi/web/api/navigatorid/appversion/index.html b/files/fi/web/api/navigatorid/appversion/index.html deleted file mode 100644 index df3b54e42e..0000000000 --- a/files/fi/web/api/navigatorid/appversion/index.html +++ /dev/null @@ -1,33 +0,0 @@ ---- -title: window.navigator.appVersion -slug: Web/API/NavigatorID/appVersion -translation_of: Web/API/NavigatorID/appVersion -original_slug: DOM/window.navigator.appVersion ---- -<div> - {{APIRef}}</div> -<div> - </div> -<div> - <span style="font-size: 2.14285714285714rem; font-weight: 700; letter-spacing: -1px; line-height: 30px;">Yhteenveto</span></div> -<p>Palauttaa selaimen version merkkijonona. Se voi olla joko pelkkä versionumero, kuten "5.0", tai versionumero, jota seuraa yksityiskohtaisempia tietoja. HTML5-spesifikaatio sallii myös kaikkien selainten palauttaa tässä "4.0" yhteensopivuussyistä.</p> -<div class="note"> - <strong>Huomaa:</strong> Älä nojaa tähän ominaisuuteen oikean selainversion palauttamiseksi. Gecko-perustaisissa selaimissa (kuten Firefox) ja WebKit-perustaisissa selaimissa (kuten Chrome ja Safari) palautettu arvo alkaa merkkiyhdistelmällä "5.0", jota seuraa alustatiedot. Opera 10 ja uudemmissa selaimissa palautettu versio ei myöskään täsmää oikeaan selainversioon.</div> -<h2 id="Syntax" name="Syntax">Syntaksi</h2> -<pre class="syntaxbox">window.navigator.appVersion -</pre> -<h3 id="Returned_value" name="Returned_value">Palautettu arvo</h3> -<ul> - <li><code>ver</code> selaimen versionumero merkkijonona.</li> -</ul> -<h2 id="Example" name="Example">Esimerkki</h2> -<pre class="brush: js">alert("Your browser version is reported as " + navigator.appVersion); -</pre> -<h2 id="Notes" name="Notes">Kommentit</h2> -<p>Ominaisuus <code>window.navigator.userAgent</code> voi myös ehkä sisältää versionumeron (esimerkki: "<code>Mozilla/5.0 (Windows; U; Win98; en-US; rv:0.9.2) Gecko/20010725 Netscape 6/6.1</code>"), mutta sinun tulisi olla tietoinen, kuinka helposti user agent -merkkijonoa voi muuttaa ja "huijata" muita selaimia, alustoja tai user agent -ohjelmia ja kuinka kavereita toimittajat itse ovat näiden ominaisuuksien kanssa.</p> -<p>Ominaisuuksia <code>window.navigator.appVersion</code>, <code>window.navigator.appName</code> ja <code>window.navigator.userAgent</code> on käytetty "selainnuuhkimis"-koodissa: skripteissä, jotka yrittävät havaita, minkälaista selainta käytät ja säätävät sivut sen mukaiseksi. Tämä johti nykyiseen tilanteeseen, joissa selainten on palautettava vääriä arvoja näissä ominaisuuksissa, jotta niitä ei voitaisi lukita ulos joiltakin webbisivustoilta.</p> -<h2 id="Specification" name="Specification">Spesifikaatio</h2> -<ul> - <li><a class="external" href="http://www.w3.org/TR/html5/timers.html#navigator" title="http://www.w3.org/TR/html5/timers.html#navigator">HTML5: Järjestelmätila ja kykeneväisyydet: Navigator-objekti</a></li> -</ul> -<p>Tämä oli alunperin osa DOM-taso 0:aa, mutta on sittemmin sisällytettty HTML5-spesifikaatioon.</p> diff --git a/files/fi/web/api/navigatorid/platform/index.html b/files/fi/web/api/navigatorid/platform/index.html deleted file mode 100644 index 2f42a46de9..0000000000 --- a/files/fi/web/api/navigatorid/platform/index.html +++ /dev/null @@ -1,23 +0,0 @@ ---- -title: window.navigator.platform -slug: Web/API/NavigatorID/platform -translation_of: Web/API/NavigatorID/platform -original_slug: DOM/window.navigator.platform ---- -<p>{{ ApiRef() }}</p> -<h3 id="Summary" name="Summary">Yhteenveto</h3> -<p>Palauttaa selaimen alustaa edustavan merkkijonon.</p> -<h3 id="Syntax" name="Syntax">Syntaksi</h3> -<pre class="eval"><em>platform</em> = <em>navigator</em>.platform -</pre> -<p><code>platform</code> on merkkijono, joka on yksi seuraavista arvoista: "Win32", "Linux i686", "MacPPC", "MacIntel", tai jokin muu.</p> -<h3 id="Example" name="Example">Esimerkki</h3> -<pre class="brush: js">alert(navigator.platform);</pre> -<h3 id="Notes" name="Notes">Kommentit</h3> -<p>Jollei koodisi ole etuoikeutettu (chrome tai vähintään UniversalBrowserRead-etuoikeus), se voi ehkä saada <code>general.platform.override</code>-asetusarvon eikä oikean alustan.</p> -<h3 id="Specification" name="Specification">Spesifikaatio</h3> -<ul> - <li><a class="external" href="http://www.w3.org/TR/html5/timers.html#navigator" title="http://www.w3.org/TR/html5/timers.html#navigator">HTML5: System state and capabilities: the Navigator object</a></li> -</ul> -<p>Tämä oli alunperin osa DOM Level 0-määrittelyä, mutta on sittemmin sisällytetty HTML5-spesifikaatioon.</p> -<p>{{ languages( {"ja": "ja/DOM/window.navigator.platform", "zh-cn": "zh-cn/DOM/window.navigator.platform", "pl": "pl/DOM/window.navigator.platform" } ) }}</p> diff --git a/files/fi/web/api/navigatorid/product/index.html b/files/fi/web/api/navigatorid/product/index.html deleted file mode 100644 index b5db62bed0..0000000000 --- a/files/fi/web/api/navigatorid/product/index.html +++ /dev/null @@ -1,37 +0,0 @@ ---- -title: window.navigator.product -slug: Web/API/NavigatorID/product -translation_of: Web/API/NavigatorID/product -original_slug: DOM/window.navigator.product ---- -<p>{{ ApiRef() }}</p> -<h3 id="Summary" name="Summary">Yhteenveto</h3> -<p>Tämä ominaisuus palauttaa nykyisen selaimen tuotenimen.</p> -<div class="note"> - <strong>Huomaa:</strong> Älä nojaa tähän ominaisuuteen oikean tuotenimen palauttamiseksi. Sekä Gecko- että WebKit-selaimet palauttavat "Gecko" tämän ominaisuuden arvona.</div> -<h3 id="Syntax" name="Syntax">Syntaksi</h3> -<pre class="eval"><i>productName</i> = window.navigator.product -</pre> -<h3 id="Parameters" name="Parameters">Palautettu arvo</h3> -<ul> - <li><code>productName</code> on merkkijono.</li> -</ul> -<h3 id="Example" name="Example">Esimerkki</h3> -<pre class="brush: html"><script> -function prod() { - dt = document.getElementById("d"); - dt.innerHTML = window.navigator.product; -} -</script> -<button onclick="prod();">product</button> -<div id="d"> </div> -// palauttaa merkkijonon "Gecko" -</pre> -<h3 id="Notes" name="Notes">Kommentit</h3> -<p>Gecko-perustaisissa selaimissa <code>product</code> täsmää siihen osaan user agent -merkkijonoon, joka tulee heti alustan jälkeen. Esimerkiksi Netscape 6.1-selaimen user agent -merkkijonossa tuote on "<code>Gecko</code>" ja koko agent-merkkijono on seuraava: <code>Mozilla/5.0 (Windows; U; Win98; en-US; rv:0.9.2) Gecko/20010725 Netscape6/6.1</code>.</p> -<p>WebKit-perustaisten selainten <code>product</code>-merkkijono palauttaa arvon "<code>Gecko</code>" vaikka koko user agent -merkkijonon heti alustan jälkeinen merkkijono on itse asiassa seuraava: <code>(KHTML, like Gecko)</code>.</p> -<h3 id="Specification" name="Specification">Spesifikaatio</h3> -<p>DOM Level 0. Ei ole spesifikaation osa.</p> -<div class="noinclude"> - </div> -<p>{{ languages( { "ja": "ja/DOM/window.navigator.product", "pl": "pl/DOM/window.navigator.product" } ) }}</p> diff --git a/files/fi/web/api/navigatorid/useragent/index.html b/files/fi/web/api/navigatorid/useragent/index.html deleted file mode 100644 index 207aa5d82b..0000000000 --- a/files/fi/web/api/navigatorid/useragent/index.html +++ /dev/null @@ -1,43 +0,0 @@ ---- -title: window.navigator.userAgent -slug: Web/API/NavigatorID/userAgent -translation_of: Web/API/NavigatorID/userAgent -original_slug: DOM/window.navigator.userAgent ---- -<div> - {{ApiRef}}</div> -<h2 id="Summary" name="Summary">Yhteenveto</h2> -<p>Palauttaa nykyisen selaimen user agent -merkkijonon.</p> -<h2 id="Syntax" name="Syntax">Syntaksi</h2> -<pre class="syntaxbox">var <var>ua</var> = window.navigator.userAgent; -</pre> -<h3 id="Value" name="Value">Arvo</h3> -<p><code>ua</code> tallentaa nykyisen selaimen user agent -merkkijonarvon.</p> -<p>Ominaisuus <code>window.navigator.userAgent</code> on <em>read-write</em>-arvo; sillä ei ole oletusarvoa.</p> -<p>Merkkijono user agent rakennetaan muotorakenteeseen, joka koostuu useasta tieto-osiosta. Jokainen näistä osista tulee muista navigator-ominaisuuksista, jotka käyttäjä voi myös asettaa. Gecko-perustaiset selaimet noudattavat seuraavaa rakennetta:</p> -<pre>userAgent = appCodeName/appVersion number (Platform; Security; OS-or-CPU; -Localization; rv: revision-version-number) product/productSub -Application-Name Application-Name-version -</pre> -<h2 id="Example" name="Example">Esimerkki</h2> -<pre class="brush:js">alert(window.navigator.userAgent) -// alerts "Mozilla/5.0 (Windows; U; Win98; en-US; rv:0.9.2) Gecko/20010725 Netscape6/6.1" -</pre> -<h2 id="Notes" name="Notes">Kommentit</h2> -<p>Selaintunnistus, joka perustuu user agent -merkkijono havainnointiin <strong>epäluotetttava</strong> ja <strong>sitä ei suositella</strong>, koska käyttäjä voi asettaa user agent -merkkijonon. Esimerkiksi:</p> -<ul> - <li>Firefoxissa voit vaihtaa asetuksen {{pref("general.useragent.override")}} komennolla <code>about:config</code>. Jotkut Firefox-laajennukset tekevät sen; tämä muuttaa kuitenkin vain lähetettävän HTTP-otsakkeen, ja ei vaikuta JavaScript-koodilla suoritettuun selaimen tunnistukseen</li> - <li>Opera 6+ sallii käyttäjien asettaa selaintunnistusmerkkijono valikon kautta</li> - <li>Microsoft Internet Explorer käyttää Windows registryä</li> - <li>Safari ja iCab sallivat käyttäjien vaihtaa selaimen user agent -merkkijonoksi ennalta asetetun Internet Explorer- tai Netscape -merkkijonon valikon kautta.</li> -</ul> -<h2 id="Specification" name="Specification">Spesifikaatio</h2> -<p>{{DOM0}}</p> -<h2 id="See_also" name="See_also">Katso myös</h2> -<ul> - <li><a href="/en-US/docs/Gecko_user_agent_string_reference">Gecko user agent -merkkijonoviite</a></li> - <li><a href="/en-US/docs/Using_Web_Standards_in_your_Web_Pages/Developing_cross-browser_and_cross-platform_pages" title="Using_Web_Standards_in_your_Web_Pages/Developing_cross-browser_and_cross-platform_pages">Browser identification (aka "browser sniffing"): not best, not reliable approach</a></li> - <li><a href="/en-US/docs/Browser_Detection_and_Cross_Browser_Support#Limit_the_use_of_User_Agent_String_based_Detection" title="Browser_Detection_and_Cross_Browser_Support#Limit_the_use_of_User_Agent_String_based_Detection">Limit the use of User Agent String based Detection</a></li> - <li><a href="/en-US/docs/Browser_Detection_and_Cross_Browser_Support#Use_feature_oriented_object_detection" title="Browser_Detection_and_Cross_Browser_Support#Use_feature_oriented_object_detection">Use feature oriented object detection</a></li> - <li><a href="http://www.gtalbot.org/DHTMLSection/ListAllAttributesAndMethodsOfObjects.html">Interactive cross-browser demo on navigator properties</a></li> -</ul> diff --git a/files/fi/web/api/navigatorlanguage/language/index.html b/files/fi/web/api/navigatorlanguage/language/index.html deleted file mode 100644 index 33479e29a4..0000000000 --- a/files/fi/web/api/navigatorlanguage/language/index.html +++ /dev/null @@ -1,83 +0,0 @@ ---- -title: window.navigator.language -slug: Web/API/NavigatorLanguage/language -translation_of: Web/API/NavigatorLanguage/language -original_slug: DOM/window.navigator.language ---- -<p>{{ ApiRef() }}</p> -<h3 id="Summary" name="Summary">Yhteenveto</h3> -<p>Palauttaa selaimen kieliversiota edustavan merkkijonon.</p> -<h3 id="Syntax" name="Syntax">Syntaksi</h3> -<pre class="eval"><em>lang</em> = window.navigator.language -</pre> -<h3 id="Parameters" name="Parameters">Parametrit</h3> -<ul> - <li>kieliversiota edustava <code>lang</code>-merkkijono on määritelty dokumentissa <a class="external" href="http://tools.ietf.org/html/rfc4646" title="http://tools.ietf.org/html/rfc4646">RFC 4646</a>. Kelvollisen kielikoodin esimerkit sisältävät "en", "en-US", "fr", "es-ES", jne.</li> -</ul> -<h3 id="Example" name="Example">Esimerkki</h3> -<pre class="brush: js">if ( window.navigator.language != "en" ) { - doLangSelect(window.navigator.language); -} -</pre> -<h3 id="Selainyhteensopivuus">Selainyhteensopivuus</h3> -<p>{{ CompatibilityTable() }}</p> -<div id="compat-desktop"> - <table class="compat-table"> - <tbody> - <tr> - <th>Ominaisuus</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Perustuki</td> - <td> - <p>{{ CompatVersionUnknown() }}</p> - <p>Selaimesta <a href="https://code.google.com/p/chromium/issues/detail?id=1862" title="https://code.google.com/p/chromium/issues/detail?id=1862">Chrome 0.3.154</a> alkaen tämä ominaisuus perustuu <code>Accept-Language</code> <a href="/en/HTTP/Headers" title="en/HTTP/Headers">HTTP header</a>-otsakkeen arvoon.</p> - </td> - <td> - <p>{{ CompatGeckoDesktop(1.0) }}</p> - <p>Ennen Gecko 2.0 {{ geckoRelease("2.0") }} -selainversiota tämän ominaisuuden arvo oli osa user agent -merkkijonoa, jonka {{ domxref("window.navigator.userAgent", "navigator.userAgent") }} ilmoitti.</p> - <p>Selaimesta Gecko 5.0 {{ geckoRelease("5.0") }} alkaen tämän ominaisuuden arvo perustuu <code>Accept-Language</code> <a href="/en/HTTP/Headers" title="en/HTTP/Headers">HTTP header</a>-otsakkeen arvoon.</p> - </td> - <td> - <p>{{ CompatNo() }}</p> - <p>Lähimmät käytettävissä olevat (ei-standardit) ominaisuudet ovat <a href="http://msdn.microsoft.com/en-us/library/ie/ms534713.aspx" title="http://msdn.microsoft.com/en-us/library/ie/ms534713.aspx">userLanguage</a> ja <a href="http://msdn.microsoft.com/en-us/library/ie/ms533542.aspx" title="http://msdn.microsoft.com/en-us/library/ie/ms533542.aspx">browserLanguage</a>.</p> - </td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - </tr> - </tbody> - </table> -</div> -<div id="compat-mobile"> - <table class="compat-table"> - <tbody> - <tr> - <th>Ominaisuus</th> - <th>Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Perustuki</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatGeckoMobile(1.0) }}</td> - <td> - <p>{{ CompatNo() }}</p> - <p>Lähimmät käytettävissä olevat (ei-standardit) ominaisuudet ovat <a href="http://msdn.microsoft.com/en-us/library/ie/ms534713.aspx" title="http://msdn.microsoft.com/en-us/library/ie/ms534713.aspx">userLanguage</a> ja <a href="http://msdn.microsoft.com/en-us/library/ie/ms533542.aspx" title="http://msdn.microsoft.com/en-us/library/ie/ms533542.aspx">browserLanguage</a>.</p> - </td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - </tr> - </tbody> - </table> -</div> -<h3 id="Specification" name="Specification">Spesifikaatio</h3> -<p>DOM Level 0. Ei ole spesifikaation osa.</p> -<p>{{ languages( { "ja": "ja/DOM/window.navigator.language","zh-cn": "zh-cn/DOM/window.navigator.language", "pl": "pl/DOM/window.navigator.language", "fi": "fi/DOM/window.navigator.language" } ) }}</p> diff --git a/files/fi/web/api/navigatoronline/online/index.html b/files/fi/web/api/navigatoronline/online/index.html deleted file mode 100644 index 04520c17a2..0000000000 --- a/files/fi/web/api/navigatoronline/online/index.html +++ /dev/null @@ -1,102 +0,0 @@ ---- -title: window.navigator.onLine -slug: Web/API/NavigatorOnLine/onLine -translation_of: Web/API/NavigatorOnLine/onLine -original_slug: DOM/window.navigator.onLine ---- -<div> - {{ApiRef}}</div> -<h2 id="Summary" name="Summary">Yhteenveto</h2> -<p>Palauttaa selaimen verkkotilan. Ominaisuus palauttaa boolean-arvon, joka on <code>true</code>, kun verkkoyhteys on päällä ja <code>false</code>, kun selain toimii erillissovelluksena. Ominaisuus lähettää päivityksiä aina kun selaimen kyky yhdistyä verkkoon muuttuu. Päivitys tapahtuu, kun käyttäjä seuraa linkkiä tai kun skripti pyytää etäsivua. Esimerkiksi ominaisuuden pitäisi palauttaa <code>false</code>, kun käyttäjä napsauttaa linkkiä pian internet-yhteyden katkeamisen jälkeen.</p> -<p>Selaimet toteuttavat tätä ominaisuutta eri tavoin.</p> -<p>Chrome- ja Safari-selaimissa, jos selain ei kykene yhdistämään paikallisverkkoon (LAN) tai reitittimeen, se on erillissovellus; kaikki muut tilat palauttavat arvon <code>true</code>. Joten samalla kun voit otaksua, että selain on erillissovelluksena, kun sa palauttaa arvon <code>false</code>, et voi olettaa, että pääset internettiin, kun se palauttaa arvon true. Voisit saada vääriä positiivisia, sellaisissa tapauksissa, kun tietokone käyttää virtuaalisointiohjelmistoa, jolla on virtuaalisia ethernet-adaptereja, jotka ovat aina "yhdistettynä". Jos haluat todella määrittää selaimen verkkotilan, niin sinun olisi sikis kehitettävä muita keinoja tarkistamiseen. Lisäoppia varten katso HTML5 Rocks article, <a class="external" href="http://www.html5rocks.com/en/mobile/workingoffthegrid.html"> Working Off the Grid</a>.</p> -<p>Firefox- ja Internet Explorer-selaimissa selaimen kytkeminen offline-tilaan lähettää arvon <code>false</code>. Kaikki muut tilat palauttavat arvon <code>true</code>.</p> -<p>Voit nähdä verkkotilan muutokset kuuntelemalla tapahtumia kohteissa <code>window.onOnline</code> ja <code>window.onOffline</code>.</p> -<h2 id="Syntax" name="Syntax">Syntaksi</h2> -<pre class="syntaxbox"><em>online</em> = <em>window</em>.navigator.onLine; -</pre> -<p><code>online</code> on boolean-arvo <code>true</code> tai <code>false</code>.</p> -<h2 id="Example" name="Example">Esimerkki</h2> -<p>Katso <a class="external" href="http://html5-demos.appspot.com/static/navigator.onLine.html"> live-esimerkki</a>.</p> -<p>Sen tarkistamiseksi, että oletko verkossa, kysele <code>window.navigator.onLine</code>, kuten seuraavassa esimerkissä:</p> -<pre class="brush: js">if (navigator.onLine) { - alert('online') -} else { - alert('offline'); -}</pre> -<p>Verkkotila-arvojen muutosten näkemiseksi kuuntele (käyttäen <code><a href="/en-US/docs/DOM/element.addEventListener" title="DOM/element.addEventListener">addEventListener</a></code>) tapatumia kohteessa <code>window.onOnline</code> ja <code>window.onOffline</code>, kuten seuraavassa esimerkissä:</p> -<pre class="brush: js">window.addEventListener("offline", function(e) {alert("offline");}) - -window.addEventListener("online", function(e) {alert("online");}) -</pre> -<h2 id="Browser_compatibility" name="Browser_compatibility">Selainyhteensopivuus</h2> -<p>{{CompatibilityTable}}</p> -<div id="compat-desktop"> - <table class="compat-table"> - <tbody> - <tr> - <th>Ominaisuus</th> - <th>Chrome**</th> - <th>Firefox (Gecko)*</th> - <th>Internet Explorer</th> - <th>Opera*</th> - <th>Safari (WebKit)</th> - </tr> - <tr> - <td>Perustuki</td> - <td> - <p>Windows: 11<br> - Mac: 14<br> - Chrome OS: 13<br> - Linux: Palauttaa aina arvon <code>true</code></p> - <p>Historiaa varten katso <a class="external" href="http://crbug.com/7469" title="http://crbug.com/7469">crbug.com/7469</a></p> - </td> - <td> - <p>{{CompatNo}}<br> - {{bug("336359")}}<br> - {{bug("426932")}}<br> - {{bug("620472")}}</p> - <p>{{bug("654579")}}</p> - </td> - <td>8***</td> - <td>{{CompatNo}}</td> - <td>5.0.4</td> - </tr> - </tbody> - </table> -</div> -<div id="compat-mobile"> - <table class="compat-table"> - <tbody> - <tr> - <th>Ominaisuus</th> - <th>Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Phone</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Perustuki</td> - <td>Android 2.2 (Vika WebView-komponentissa, katso julkaisu <a class="external" href="http://code.google.com/p/android/issues/detail?id=16760">16760</a>)</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - </tr> - </tbody> - </table> -</div> -<p>* Firefox 4, ja Opera 11.10 palauttaa arvon <code>true</code>, kun "Work Offline"-tila on pois käytöstä ja <code>false</code>, kun se on käytössä riippumatta todellisesta yhteydestä.</p> -<p>** Chrome-selaimen aiemmat versiot palattavat virheellisesti <code>true</code> kun selain ensin avataa, mutta se alkaa ilmoittaa oiken yhteysarvon ensimmäisen verkkotapahtuman jälkeen.</p> -<p>*** Selaimessa IE 8 "online"- ja "ofline"-tapahtumat nostettiin kohteessa document.body, selaimessa IE 9 - sekä kohteessa document.body että kohteessa window</p> -<h2 id="Notes" name="Notes">Kommentit</h2> -<p>Katso yksityiskohtaisempaa kuvausta tästä ominaisuudesta asiakirjasta <a href="/en-US/docs/Online_and_offline_events" title="Online_and_offline_events">Online/Offline Events</a> samoin kuin uusista offline-kohtaisista ominaisuuksista, jotka esiteltiin selaimessa Firefox 3.</p> -<h2 id="Specification" name="Specification">Spesifikaatio</h2> -<p>Kuvattu asiakirjassa <a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/#navigator.online">HTML 5 Working draft</a></p> -<h2 id="See_also" name="See_also">Katso myös</h2> -<ul> - <li><a class="external" href="http://www.html5rocks.com/en/mobile/workingoffthegrid.html">HTML5 Rocks: Working Off the Grid With HTML5 Offline</a></li> - <li><a class="external" href="http://www.html5rocks.com/en/tutorials/offline/whats-offline/">HTML5 Rocks: "Offline": What does it mean and why should I care?</a></li> - <li><a class="external" href="http://hacks.mozilla.org/2010/01/offline-web-applications/">Mozilla Blog: Offline Web Applications</a></li> -</ul> diff --git a/files/fi/web/api/navigatorplugins/mimetypes/index.html b/files/fi/web/api/navigatorplugins/mimetypes/index.html deleted file mode 100644 index d5db235e4b..0000000000 --- a/files/fi/web/api/navigatorplugins/mimetypes/index.html +++ /dev/null @@ -1,23 +0,0 @@ ---- -title: window.navigator.mimeTypes -slug: Web/API/NavigatorPlugins/mimeTypes -translation_of: Web/API/NavigatorPlugins/mimeTypes -original_slug: DOM/window.navigator.mimeTypes ---- -<p>{{ ApiRef() }}</p> -<h3 id="Summary" name="Summary">Yhteenveto</h3> -<p>Palauttaa <code><a class="external" href="http://www.xulplanet.com/references/objref/MimeTypeArray.html">MimeTypeArray</a></code>-objektin, joka sisältää <code><a class="external" href="http://www.xulplanet.com/references/objref/MimeType.html">MimeType</a></code>-objektien luettelon, joka edustaa selaimen tunnistamia MIME-tyyppejä.</p> -<h3 id="Syntax" name="Syntax">Syntaksi</h3> -<pre class="eval"><i>mimeTypes</i> = navigator.mimeTypes; -</pre> -<p><code>mimeTypes</code> on <code><a class="external" href="http://www.xulplanet.com/references/objref/MimeTypeArray.html">MimeTypeArray</a></code>-objekti, jolla on <code>length</code>-ominaisuus samoin kuin metodit <code>item(index)</code> ja <code>namedItem(name)</code>.</p> -<h3 id="Example" name="Example">Esimerkki</h3> -<pre> alert(window.navigator.mimeTypes.item(0).description); // alerts "Mozilla Default Plug-in" -</pre> -<h3 id="Notes" name="Notes">Kommentit</h3> -<p>Nollanella elementillä mimeTypes-määrittelyssä ("Mozilla Default Plug-in" <code>MimeType</code> object) on <code>*</code>-ominaisuus <code>type</code> eikä tyypilinen MIME-muoto kuten <code>"image/x-macpaint"</code></p> -<h3 id="Specification" name="Specification">Spesifikaatio</h3> -<p>{{ DOM0() }}</p> -<div class="noinclude"> - </div> -<p>{{ languages( { "ja": "ja/DOM/window.navigator.mimeTypes", "pl": "pl/DOM/window.navigator.mimeTypes" } ) }}</p> diff --git a/files/fi/web/api/navigatorplugins/plugins/index.html b/files/fi/web/api/navigatorplugins/plugins/index.html deleted file mode 100644 index 7a9f7bb0cc..0000000000 --- a/files/fi/web/api/navigatorplugins/plugins/index.html +++ /dev/null @@ -1,40 +0,0 @@ ---- -title: window.navigator.plugins -slug: Web/API/NavigatorPlugins/plugins -translation_of: Web/API/NavigatorPlugins/plugins -original_slug: DOM/window.navigator.plugins ---- -<p>{{ ApiRef() }}</p> -<h3 id="Summary" name="Summary">Yhteenveto</h3> -<p>Palauttaa {{ domxref("PluginArray") }} -objektin, joka luettelee sovellukseen asennetut lisäosat.</p> -<h3 id="Syntax" name="Syntax">Syntaksi</h3> -<pre class="eval"><em>plugins</em> = navigator.plugins; -</pre> -<p><code>plugins</code> on <code>PluginArray</code>, sisältäen {{ domxref("Plugin") }} -objektit asennetuille lisäosille.</p> -<p>Palautettu arvo ei ole JavaScript-taulukko, vaan siinä on <code>length</code>-ominaisuus ja se tukee yksittäisten alkoiden lukemista käyttäen hakasulkuesitysmuotoa (<code>plugins{{ mediawiki.external(2) }}</code>), samoin kuin <code>item(<em>index</em>)</code>- ja <code>namedItem(<em>"name"</em>)</code>-metodien kautta.</p> -<h3 id="Example" name="Example">Esimerkki</h3> -<p>Seuraava esimerkki tulostaa tietoa asennetuista lisäosista ylemmän tason asiakirjaan. Huomaa Plugin-objektissa saatavilla olevat ominaisuudet: <code>name</code>, <code>filename</code>, <code>description</code>, ja <code>version</code>.</p> -<p>{{ gecko_minversion_note("1.9.2", "Ominaisuus <code>version</code> lisättiin selaimeen Gecko 1.9.2.") }}</p> -<pre><script type="text/javascript"> - var L = navigator.plugins.length; - document.write(L.toString().bold() + " Plugin(s)".bold()); - document.write("<br>"); - document.write("Name | Filename | description".bold()); - document.write("<br>"); - for(var i=0; i<L; i++) { - document.write(navigator.plugins[i].name); - document.write(" | "); - document.write(navigator.plugins[i].filename); - document.write(" | "); - document.write(navigator.plugins[i].description); - document.write(" | "); - document.write(navigator.plugins[i].version); - document.write("<br>"); - } -</script> -</pre> -<h3 id="Notes" name="Notes">Kommentit</h3> -<p>Objekti {{ domxref("Plugin") }} paljastaa pienen käyttöliittymän, josta saa tietoa selaimeesi asennetuista eri lisäosista. Lisäosien luettelo on saatavissa myös kirjoittamalla <code>about:plugins</code> selaimen sijaintipalkkiin.</p> -<h3 id="Specification" name="Specification">Spesifikaatio</h3> -<p>{{ DOM0() }}</p> -<p>{{ languages( { "ja": "ja/DOM/window.navigator.plugins","zh-cn": "zh-cn/DOM/window.navigator.plugins", "pl": "pl/DOM/window.navigator.plugins" } ) }}</p> diff --git a/files/fi/web/api/webgl_api/index.html b/files/fi/web/api/webgl_api/index.html deleted file mode 100644 index e7153d4db5..0000000000 --- a/files/fi/web/api/webgl_api/index.html +++ /dev/null @@ -1,229 +0,0 @@ ---- -title: WebGL -slug: Web/API/WebGL_API -tags: - - WebGL -translation_of: Web/API/WebGL_API ---- -<div>{{WebGLSidebar}}</div> - -<p class="summary">WebGL tuo 3D-grafiikan Webbin esittelemällä sovellusohjelmointirajapinnan (API), joka on läheisesti yhteensovpiva HTML5 <a href="/en-US/docs/HTML/Canvas" title="en-US/docs/html/canvas"><code>canvas</code></a>-elementissä käytetttävän OpenGL ES 2.0 -määrittelyn kanssa. Tuki WebGL:lle on nykyisin <a href="/en-US/docs/Firefox_4_for_developers" title="en-US/docs/Firefox 4 for developers">Firefox 4</a>+ -selaimissa, <a class="external" href="http://www.google.com/chrome/" title="http://www.google.com/chrome/">Google Chrome</a> 9+ -selaimissa, <a href="http://www.opera.com/" title="http://www.opera.com/">Opera </a>12+ -selaimissa ja <a href="http://www.apple.com/fr/safari/" title="http://www.apple.com/fr/safari/">Safari </a>5.1+ -selaimissa.</p> - -<div class="cleared row topicpage-table"> -<div class="section"> -<h2 class="Documentation" id="Kehitysaiheita">Kehitysaiheita</h2> - -<dl> - <dt><a href="/en-US/docs/WebGL/Getting_started_with_WebGL" title="en-US/docs/WebGL/Getting started with WebGL">Kuinka aloittaa WebGL-asennus</a></dt> - <dd>Kuinka asettaa WebGL-ympäristö.</dd> - <dt><a href="/en-US/docs/WebGL/Adding_2D_content_to_a_WebGL_context" title="en-US/docs/WebGL/Adding 2D content to a WebGL context">Lisätään 2D-sisältöä WebGL-ympäristöön</a></dt> - <dd>Kuinka renderoidaan yksinkertaisia litteitä muotoja WebGL:tä käyttäen.</dd> - <dt><a href="/en-US/docs/WebGL/Using_shaders_to_apply_color_in_WebGL" title="en-US/docs/WebGL/Using shaders to apply color in WebGL">Varjostimien käyttäminen värien toteuttamisessa WebGL:ssä</a></dt> - <dd>Esittelee, kuinka lisätä väri varjoja käyttäviin muotoihin.</dd> - <dt><a href="/en-US/docs/WebGL/Animating_objects_with_WebGL" title="en-US/docs/WebGL/Animating objects with WebGL">Objektien animointi WebGL:ssä</a></dt> - <dd>Näyttää kuin kiertää ja muuntaa objekteja yksinkertaisten animaatioiden luomiseksi.</dd> - <dt><a href="/en-US/docs/WebGL/Creating_3D_objects_using_WebGL" title="en-US/docs/WebGL/Creating 3D objects using WebGL">3D-objektien luominen käyttäen WebGL:ää</a></dt> - <dd>Näyttää, kuinka luoda ja animoida 3D-objekti (tässä tapauskessa kuutio).</dd> - <dt><a href="/en-US/docs/WebGL/Using_textures_in_WebGL" title="en-US/docs/WebGL/Using textures in WebGL">Using textures in WebGL</a></dt> - <dd>Demonstrates how to map textures onto the faces of an object.</dd> - <dt><a href="/en-US/docs/WebGL/Lighting_in_WebGL" title="en-US/docs/WebGL/Lighting in WebGL">Lighting in WebGL</a></dt> - <dd>How to simulate lighting effects in your WebGL context.</dd> - <dt><a href="/en-US/docs/WebGL/Animating_textures_in_WebGL" title="en-US/docs/WebGL/Animating textures in WebGL">Animating textures in WebGL</a></dt> - <dd>Shows how to animate textures; in this case, by mapping an Ogg video onto the faces of a rotating cube.</dd> - <dt><a href="/en-US/docs/WebGL/WebGL_best_practices" title="en-US/docs/WebGL/WebGL best practices">Parhaimmat WebGL-käytännöt</a></dt> - <dd>Vihjeitä ja suosituksia WebGL-sisällön luomiseksi.</dd> - <dt><a href="/en-US/docs/WebGL/Cross-Domain_Textures" title="en-US/docs/WebGL/Cross-Domain Textures">Cross-domain textures</a></dt> - <dd>Information about loading textures from domains other than the one from which your content was loaded.</dd> - <dt><a href="/en-US/docs/WebGL/Using_Extensions" title="en-US/docs/WebGL/Using_Extensions">Using extensions</a></dt> - <dd>How to use extensions that are available in WebGL.</dd> -</dl> -</div> - -<div class="section"> -<h2 class="Related_Topics" id="Resurssit">Resurssit</h2> - -<dl> - <dt><a class="link-https" href="https://www.khronos.org/registry/webgl/specs/1.0/" title="https://www.khronos.org/registry/webgl/specs/1.0/">WebGL-spesifikaatio</a></dt> - <dd>WebGL-spesifikaatio.</dd> - <dt><a class="external" href="http://www.khronos.org/webgl/" title="http://www.khronos.org/webgl/">Khronos WebGL site</a></dt> - <dd>The main web site for WebGL at the Khronos Group.</dd> - <dt><a class="external" href="http://learningwebgl.com/blog/" title="http://learningwebgl.com/blog/">Learning WebGL</a></dt> - <dd>A site with tutorials on how to use WebGL.</dd> - <dt><a class="external" href="http://learningwebgl.com/cookbook/index.php/" title="http://learningwebgl.com/cookbook/index.php/">The WebGL Cookbook</a></dt> - <dd>A web site with handy recipes for writing WebGL code.</dd> - <dt><a class="external" href="http://planet-webgl.org/" title="http://planet-webgl.org/">Planet WebGL</a></dt> - <dd>A feed aggregator for people involved in the WebGL community.</dd> - <dt><a class="external" href="http://code.google.com/p/ewgl-matrices/" title="http://code.google.com/p/ewgl-matrices/">ewgl-matrices</a></dt> - <dd>A blazing fast matrix library for WebGL</dd> - <dt><a class="link-https" href="https://github.com/toji/gl-matrix" title="https://github.com/toji/gl-matrix">glMatrix</a></dt> - <dd>JavaScript Matrix and Vector library for High Performance WebGL apps</dd> - <dt><a class="external" href="http://code.google.com/p/webgl-mjs/" title="http://code.google.com/p/webgl-mjs/">mjs</a></dt> - <dd><span>A JavaScript vector and matrix math library, optimized for WebGL usage.</span></dd> - <dt><a class="external" href="http://sylvester.jcoglan.com/" title="http://sylvester.jcoglan.com/">Sylvester</a></dt> - <dd>An open source library for manipulating vectors and matrices. Not optimized for WebGL but extremely robust.</dd> - <dt><a class="external" href="http://webglplayground.net" title="http://webglplayground.net">WebGL playground</a></dt> - <dd>An online tool for creating and sharing WebGL projects. Good for quick prototyping and experimenting.</dd> -</dl> -</div> -</div> - -<h2 id="Browser_compatibility">Browser compatibility</h2> - -<p>{{CompatibilityTable()}}</p> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Firefox (Gecko)</th> - <th>Chrome</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Basic support</td> - <td>{{CompatGeckoDesktop("2.0")}}</td> - <td>9</td> - <td>{{CompatNo()}}</td> - <td>12</td> - <td>5.1</td> - </tr> - <tr> - <td>Context name</td> - <td><code>experimental-webgl</code></td> - <td><code>experimental-webgl</code></td> - <td>n/a</td> - <td><code>experimental-webgl</code></td> - <td><code>experimental-webgl</code></td> - </tr> - <tr> - <td><a class="external" href="http://www.khronos.org/registry/gles/extensions/OES/OES_texture_float.txt" title="http://www.khronos.org/registry/gles/extensions/OES/OES_texture_float.txt"><code>OES_texture_float</code></a></td> - <td>{{CompatGeckoDesktop("6.0")}}</td> - <td>{{CompatUnknown()}}</td> - <td>{{CompatUnknown()}}</td> - <td>{{CompatUnknown()}}</td> - <td>{{CompatUnknown()}}</td> - </tr> - <tr> - <td><a class="external" href="http://www.khronos.org/registry/webgl/extensions/OES_standard_derivatives/" title="http://www.khronos.org/registry/webgl/extensions/OES_standard_derivatives/"><code>OES_standard_derivatives</code></a></td> - <td>{{CompatGeckoDesktop("10.0")}}</td> - <td>{{CompatUnknown()}}</td> - <td>{{CompatUnknown()}}</td> - <td>{{CompatUnknown()}}</td> - <td>{{CompatUnknown()}}</td> - </tr> - <tr> - <td><a href="/en-US/docs/WebGL/Using_Extensions#EXT_texture_filter_anisotropic" title="en-US/docs/WebGL/Using_Extensions#EXT_texture_filter_anisotropic"><code>EXT_texture_filter_anisotropic</code></a></td> - <td>{{CompatGeckoDesktop("13.0")}}</td> - <td>{{CompatUnknown()}}</td> - <td>{{CompatUnknown()}}</td> - <td>{{CompatUnknown()}}</td> - <td>{{CompatUnknown()}}</td> - </tr> - <tr> - <td><a href="/en-US/docs/WebGL/Using_Extensions#WEBGL_compressed_texture_s3tc" title="en-US/docs/WebGL/Using_Extensions#WEBGL_compressed_texture_s3tc"><code>WEBGL_compressed_texture_s3tc</code></a></td> - <td>{{CompatGeckoDesktop("15.0")}}</td> - <td>{{CompatUnknown()}}</td> - <td>{{CompatUnknown()}}</td> - <td>{{CompatUnknown()}}</td> - <td>{{CompatUnknown()}}</td> - </tr> - <tr> - <td><code>drawingBufferWidth</code> and <code>drawingBufferHeight</code> attributes</td> - <td>{{CompatGeckoDesktop("9.0")}}</td> - <td>{{CompatUnknown()}}</td> - <td>{{CompatUnknown()}}</td> - <td>{{CompatUnknown()}}</td> - <td>{{CompatUnknown()}}</td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Firefox Mobile (Gecko)</th> - <th>Android</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Basic support</td> - <td>{{CompatUnknown()}}</td> - <td>{{CompatUnknown()}}</td> - <td>{{CompatUnknown()}}</td> - <td>{{CompatUnknown()}}</td> - <td>{{CompatUnknown()}}</td> - </tr> - <tr> - <td>Context name</td> - <td>{{CompatUnknown()}}</td> - <td>{{CompatUnknown()}}</td> - <td>{{CompatUnknown()}}</td> - <td>{{CompatUnknown()}}</td> - <td>{{CompatUnknown()}}</td> - </tr> - <tr> - <td><a class="external" href="http://www.khronos.org/registry/gles/extensions/OES/OES_texture_float.txt" title="http://www.khronos.org/registry/gles/extensions/OES/OES_texture_float.txt"><code>OES_texture_float</code></a></td> - <td>{{CompatGeckoMobile("6.0")}}</td> - <td>{{CompatUnknown()}}</td> - <td>{{CompatUnknown()}}</td> - <td>{{CompatUnknown()}}</td> - <td>{{CompatUnknown()}}</td> - </tr> - <tr> - <td><a class="external" href="http://www.khronos.org/registry/webgl/extensions/OES_standard_derivatives/" title="http://www.khronos.org/registry/webgl/extensions/OES_standard_derivatives/"><code>OES_standard_derivatives</code></a></td> - <td>{{CompatGeckoMobile("10.0")}}</td> - <td>{{CompatUnknown()}}</td> - <td>{{CompatUnknown()}}</td> - <td>{{CompatUnknown()}}</td> - <td>{{CompatUnknown()}}</td> - </tr> - <tr> - <td><a href="/en-US/docs/WebGL/Using_Extensions#EXT_texture_filter_anisotropic" title="en-US/docs/WebGL/Using_Extensions#EXT_texture_filter_anisotropic"><code>EXT_texture_filter_anisotropic</code></a></td> - <td>{{CompatGeckoMobile("13.0")}}</td> - <td>{{CompatUnknown()}}</td> - <td>{{CompatUnknown()}}</td> - <td>{{CompatUnknown()}}</td> - <td>{{CompatUnknown()}}</td> - </tr> - <tr> - <td><a href="/en-US/docs/WebGL/Using_Extensions#WEBGL_compressed_texture_s3tc" title="en-US/docs/WebGL/Using_Extensions#WEBGL_compressed_texture_s3tc"><code>WEBGL_compressed_texture_s3tc</code></a></td> - <td>{{CompatGeckoMobile("15.0")}}</td> - <td>{{CompatUnknown()}}</td> - <td>{{CompatUnknown()}}</td> - <td>{{CompatUnknown()}}</td> - <td>{{CompatUnknown()}}</td> - </tr> - <tr> - <td><code>drawingBufferWidth</code> and <code>drawingBufferHeight</code> attributes</td> - <td>{{CompatGeckoMobile("9.0")}}</td> - <td>{{CompatUnknown()}}</td> - <td>{{CompatUnknown()}}</td> - <td>{{CompatUnknown()}}</td> - <td>{{CompatUnknown()}}</td> - </tr> - </tbody> -</table> -</div> - -<h3 id="Gecko_notes">Gecko notes</h3> - -<h4 id="WebGL_debugging_and_testing">WebGL debugging and testing</h4> - -<p>Starting with Gecko 10.0 {{geckoRelease("10.0")}}, there are two preferences available which let you control the capabilities of WebGL for testing purposes:</p> - -<dl> - <dt><code>webgl.min_capability_mode</code></dt> - <dd>A Boolean property that, when <code>true</code>, enables a minimum capability mode. When in this mode, WebGL is configured to only support the bare minimum feature set and capabilities required by the WebGL specification. This lets you ensure that your WebGL code will work on any device or browser, regardless of their capabilities. This is <code>false</code> by default.</dd> - <dt><code>webgl.disable_extensions</code></dt> - <dd>A Boolean property that, when <code>true</code>, disables all WebGL extensions. This is <code>false</code> by default.</dd> -</dl> - -<div>{{HTML5ArticleTOC()}}</div> diff --git a/files/fi/web/api/webvr_api/index.html b/files/fi/web/api/webvr_api/index.html deleted file mode 100644 index e3b73598f2..0000000000 --- a/files/fi/web/api/webvr_api/index.html +++ /dev/null @@ -1,250 +0,0 @@ ---- -title: WebVR API -slug: Web/API/WebVR_API -tags: - - API - - Experimental - - Expérimental(2) - - Landing - - NeedsTranslation - - Reference - - Référence(2) - - TopicStub - - VR - - Virtual Reality - - WebVR -translation_of: Web/API/WebVR_API ---- -<p>{{SeeCompatTable}}{{APIRef("WebVR API")}}</p> - -<p>WebVR -rajapinta tarjoaa tuen VR-laitteiden — kuten Oculus Rift tai HTC Vive -silmikoiden — käyttämiseen webbisovelluksille, jolloin kehittäjät voivat muuttaa silmikolta saadun sijainti- ja liiketiedon 3D-skenessä liikkumistiedoksi. Tämä mahdollistaa useita kiinnostavia sovellusmahdollisuuksia aina virtuaalisista tuote-esittelyistä ja interaktiivisista treenisovelluksista immersiivisiin FPS-räiskintäpeleihin.</p> - -<h2 id="Perusperiaatteet_ja_käyttö">Perusperiaatteet ja käyttö</h2> - -<p>Metodi {{domxref("Navigator.getVRDisplays()")}} hakee kaikki tietokoneeseen liitetyt VR-laitteet; jokaista näistä vastaa {{domxref("VRDisplay")}} -tyyppinen objekti.</p> - -<p><img alt='Sketch of a person in a chair with wearing goggles labelled "Head mounted display (HMD)" facing a monitor with a webcam labelled "Position sensor"' src="https://mdn.mozillademos.org/files/11035/hw-setup.png" style="display: block; height: 78px; margin: 0px auto; width: 60%;"></p> - -<p>{{domxref("VRDisplay")}} on perusrajapinta WebVR API:in — sen ominaisuuksien ja metodien avulla voit esimerkiksi:</p> - -<ul> - <li>Hakea tiedot näyttölaitteen tunnistamiseen, sen ominaisuudet ja siihen liitetyt ohjaimet.</li> - <li>Hakea kunkin näytettäväksi tarkoitetun sisältöruudun {{domxref("VRFrameData", "frame data")}} ja toimittaa ruudut näytölle oikealla taajuudella.</li> - <li>Käynnistää ja pysäyttää näyttämisen.</li> -</ul> - -<p>Tyypillinen (yksinkertainen) WebVR-sovellus toimisi esimerkiksi näin:</p> - -<ol> - <li>{{domxref("Navigator.getVRDisplays()")}} -metodilla haetaan viittaus VR-näyttöön.</li> - <li>{{domxref("VRDisplay.requestPresent()")}} -metodilla käynnistetään näyttäminen.</li> - <li>WebVR:n omalla versiolla {{domxref("VRDisplay.requestAnimationFrame()")}} -methodista suoritetaan sovelluksen renderöintisilmukkaa näytölle sopivalla virkistystaajuudella.</li> - <li>Renderöintisilmukassa haetaan ruudun näyttämiseen tarvittavat tiedot ({{domxref("VRDisplay.getFrameData()")}}) -metodilla, piirretään näytettävä skene kaksi kertaa — siis kerran molemmille silmille, ja sen jälkeen toimitetaan renderöity näkymä näytölle käyttäjälle näytettäväksi metodilla ({{domxref("VRDisplay.submitFrame()")}}).</li> -</ol> - -<p>Tämän lisäksi WebVR 1.1 lisää useita tapahtumia (event) {{domxref("Window")}} -objektiin, jolloin JavaScriptillä voidaan reagoida näytön tilan muutoksiin.</p> - -<p><strong>Huom</strong>: APIn toiminnasta löytyy paljon lisätietoa artikkeleista <a href="/en-US/docs/Web/API/WebVR_API/Using_the_WebVR_API">Using the WebVR API</a> ja <a href="/en-US/docs/Web/API/WebVR_API/Concepts">WebVR Concepts</a>.</p> - -<h3 id="Ohjaimien_käyttö_WebVRn_yhdistäminen_Gamepad_APIin">Ohjaimien käyttö: WebVR:n yhdistäminen Gamepad API:in</h3> - -<p>Useissa WebVR-laitekokoonpanoissa silmikon mukana on käytettävissä erillinen ohjain. Ohjaimia voidaan käyttää WebVR-sovelluksissa <a href="/en-US/docs/Web/API/Gamepad_API">Gamepad API</a>:n kautta, ja erityisesti <a href="/en-US/docs/Web/API/Gamepad_API#Experimental_Gamepad_extensions">Gamepad Extensions API:n</a>, joka lisää mukaan ohjaimen asentotiedon (<a href="/en-US/docs/Web/API/GamepadPose">controller pose</a>), tuntoperusteiset laitteet (<a href="/en-US/docs/Web/API/GamepadHapticActuator">haptic actuators</a>) ja muita vastaavia.</p> - -<p><strong>Huom</strong>: Artikkeli <a href="/en-US/docs/Web/API/WebVR_API/Using_VR_controllers_with_WebVR">Using VR controllers with WebVR</a> selittää perusteet VR-ohjaimien käytöstä WebVR-sovelluksissa.</p> - -<h2 id="WebVR_rajapinnat">WebVR rajapinnat</h2> - -<dl> - <dt>{{domxref("VRDisplay")}}</dt> - <dd>Edustaa mitä tahnsa APIn tukemaa VR-laitetta. Siinä on mukana yleistiedot laittesta, kuten laitteen tunnisteet (ID) ja kuvaukset sekä metodit VR-skenen esittämisen käynnistämiseen, silmäparametrien ja näytön ominaisuuksien hakemiseen ja muut olennaiset toiminnat.</dd> - <dt>{{domxref("VRDisplayCapabilities")}}</dt> - <dd>Esittää {{domxref("VRDisplay")}}:n ominaisuudet — näillä voidaan testata, saako laitteelta esimerkiksi sijaintitietoa.</dd> - <dt>{{domxref("VRDisplayEvent")}}</dt> - <dd>Edustaa WebVR-kohtaisen tapahtuman tapahtumaobjektia (kts. {{anch("Window", "window object extensions")}} alempana).</dd> - <dt>{{domxref("VRFrameData")}}</dt> - <dd>Vastaa kaikkea tietoa, mitä yksittäisen VR-skenen ruudun renderöintiin tarvitaan; metodi {{domxref("VRDisplay.getFrameData()")}} hakee nämä tiedot.</dd> - <dt>{{domxref("VRPose")}}</dt> - <dd>Edustaa tietyllä ajanhetkellä vallitsevaa sijaintitietoa (johon kuuluvat suunta, sijainti, nopeus ja kiihtyvyys.)</dd> - <dt>{{domxref("VREyeParameters")}}</dt> - <dd>Tarjoaa pääsyn kaikkeen tietoon, joka tarvitaan skenen renderöintiin oikein kullekin silmälle, esimerkiksi näkökentän laajuuden.</dd> - <dt>{{domxref("VRFieldOfView")}}</dt> - <dd>Näkökenttätieto, joka on määritelty keskipisteestä katsottuna neljällä asteluvulla.</dd> - <dt>{{domxref("VRLayerInit")}}</dt> - <dd>Tämä on {{domxref("VRDisplay")}}-näytöllä esitettävä kuvan eräs taso (layer).</dd> - <dt>{{domxref("VRStageParameters")}}</dt> - <dd>Huoneskaalaa tukevien laitteiden kanssa käytettävissä sovelluksissa "näyttämöalueen" tiedot löytyvät tästä.</dd> -</dl> - -<h3 id="Laajennukset_muihin_rajapintoihin">Laajennukset muihin rajapintoihin</h3> - -<p>WebVR API laajentaa joitakin API-rajapintoja lisäten seuraavat ominaisuudet.</p> - -<h4 id="Gamepad">Gamepad</h4> - -<dl> - <dt>{{domxref("Gamepad.displayId")}} {{readonlyInline}}</dt> - <dd>Palauttaa liitetyn {{domxref("VRDisplay")}} tunnisteen {{domxref("VRDisplay.displayId")}} — <code>VRDisplay</code> , jonka skeneä gamepad ohjaa.</dd> -</dl> - -<h4 id="Navigator">Navigator</h4> - -<dl> - <dt>{{domxref("Navigator.activeVRDisplays")}} {{readonlyInline}}</dt> - <dd>Palauttaa taulukon, jossa on mukana jokainen {{domxref("VRDisplay")}}, joka esittää parhaillaan ({{domxref("VRDisplay.ispresenting")}} on <code>true</code>).</dd> - <dt>{{domxref("Navigator.getVRDisplays()")}}</dt> - <dd>Palauttaa promise-objektin, joka sisältää taulukon {{domxref("VRDisplay")}} objekteja, jotka vastaavat kaikkia tietokoneeseen liitettyjä VR-näyttöjä.</dd> -</dl> - -<h4 id="Window-tapahtumat">Window-tapahtumat</h4> - -<dl> - <dt>{{domxref("Window.onvrdisplaypresentchange")}}</dt> - <dd>Edustaa tapahtumankäsittelijää (event handler), joka suoritetaan, kun VR_näytön esittämistila muuttuu — esimerkiksi tilasta 'esittää' tilaan 'ei esitä' tai päinvastoin (kun tapahtuma {{event("vrdisplaypresentchange")}} signaloidaan).</dd> - <dt>{{domxref("Window.onvrdisplayconnect")}}</dt> - <dd>Tämä tapahtumankäsittelijä suoritetaan, kun yhteensopiva VR-näyttö on kytketty tietokoneeseen (tapahtuma {{event("vrdisplayconnect")}} ).</dd> - <dt>{{domxref("Window.onvrdisplaydisconnect")}}</dt> - <dd>Tämä tapahtumankäsittelijä suoritetaan, kun yhteensopiva VR-näyttö irrotetaan tietokoneesta (kun tapahtuma {{event("vrdisplaydisconnect")}} signaloidaan).</dd> - <dt>{{domxref("Window.onvrdisplayactivate")}}</dt> - <dd>Edustaa taphtumaa, joka suoritetaan, kun näyttö on valmis esittämään sisältöä (tapahtuma {{event("vrdisplayactivate")}} ),esimerkiksi kun silmikko aktivoituu virransäästötilasta tai puetaan päälle.</dd> - <dt>{{domxref("Window.onvrdisplaydeactivate")}}</dt> - <dd>Tämä tapahtumankäsittelijä suoritetaan, kun näytölle ei voi enää esittää sisältöä (kun tapahtuma {{event("vrdisplaydeactivate")}} signaloidaan), esimerkiksi syystä, että silmikkonäyttö on siirtynyt virransäästötilaan käyttämättömyyden vuoksi.</dd> -</dl> - -<h4 id="Windown_tapahtumat_jotka_eivät_ole_käytettävissä">Window:n tapahtumat, jotka eivät ole käytettävissä</h4> - -<p>Seuraavat tapahtumat löytyvät APIn määrittelystä, mutta niiden toteutusta ei tunnu vielä löytyvän mistään selaimista.</p> - -<dl> - <dt>{{domxref("Window.onvrdisplayblur")}}</dt> - <dd>Edustaa tapahtumankäsittelijää, joka suoritetaan kun selain, käyttöjärjestelmä tai VR-laitteisto on keskeyttänyt esittämisen näytölle jostain syystä (tapahtuman {{event("vrdisplayblur")}} johdosta) — esimerkiksi käytettäessä järjestelmän valikkoa tai selainta. Tarkoitus on estää seurantaa tai VR-kokemuksen menetystä.</dd> - <dt>{{domxref("Window.onvrdisplayfocus")}}</dt> - <dd>Tämä tapahtumankäsittelijä suoritetaan, kun esittäminen näytöllä palautuu edellisen tapahtuman jälkeen (tapahtumasta {{event("vrdisplayfocus")}} ).</dd> -</dl> - -<h2 id="Esimerkkejä">Esimerkkejä</h2> - -<p>Näiltä sivustoilta töydät useita esimerkkejä:</p> - -<ul> - <li><a href="https://github.com/mdn/webvr-tests">webvr-tests</a> — hyvin yksinkertaisia esimerkkejä MDN:n WebVR dokumentaation tueksi.</li> - <li><a href="https://github.com/facebook/Carmel-Starter-Kit">Carmel starter kit</a> — mukavia yksinkertaisia ja hyvin kommentoituja esimerkkejä, jotka tulevat Carmel:in, Facebookin WebVR-selaimen mukana.</li> - <li><a href="https://webvr.info/samples/">WebVR.info samples</a> — hieman syvemmälle meneviä esimerkkejä lähdekoodeineen</li> - <li><a href="https://webvr.rocks/firefox#demos">WebVR.rocks Firefox demos</a> — demottavia esimerkkejä</li> - <li><a href="https://aframe.io/">A-Frame homepage</a> — esimerkkejä A-Frame:n käytöstä</li> -</ul> - -<h2 id="Spesifikaatiot">Spesifikaatiot</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Specification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - <tr> - <td>{{SpecName("GamepadExtensions")}}</td> - <td>{{Spec2("GamepadExtensions")}}</td> - <td>Määrittää <a href="/en-US/docs/Web/API/Gamepad_API#Experimental_Gamepad_extensions">Experimental Gamepad extensions</a>.</td> - </tr> - <tr> - <td>{{SpecName('WebVR 1.1')}}</td> - <td>{{Spec2('WebVR 1.1')}}</td> - <td>Alkuperäinen</td> - </tr> - </tbody> -</table> - -<h2 id="Selainyhteensopivuus">Selainyhteensopivuus</h2> - -<p>{{CompatibilityTable}}</p> - -<table class="compat-table"> - <tbody> - <tr> - <th>Ominaisuus</th> - <th>Chrome</th> - <th>Edge</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari (WebKit)</th> - </tr> - <tr> - <td>Perus</td> - <td>{{CompatNo}}<sup>[1]</sup></td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatGeckoDesktop(55)}}<sup>[2]</sup></td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - </tr> - <tr> - <td>Gamepad -laajennukset</td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}<sup>[4]</sup></td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - </tr> - </tbody> -</table> - -<table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Android</th> - <th>Edge</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Phone</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - <th>Chrome for Android</th> - <th>Samsung Internet for GearVR</th> - </tr> - <tr> - <td>Basic support</td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatVersionUnknown}}<sup>[3]</sup></td> - <td>{{CompatVersionUnknown}}<br> - </td> - </tr> - <tr> - <td>Gamepad extensions</td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}<sup>[4]</sup></td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - </tr> - </tbody> -</table> - -<p>[1] API käytettävissä (Available) kaikilla alustoilla lipulla, mutta tällä hetkellä toimii ainoastaan kokeellisessa työpöytäversiossa (<a href="https://webvr.info/get-chrome/">experimental version of Chrome)</a> (muut versiot eivät palauta yhtään laitetta metodia {{domxref("Navigator.getVRDisplays()")}} kutsuttaessa).</p> - -<p>[2] Tällä hetkellä ainoastaan Windows ja Mac OSX tuki on oletuksena päällä.</p> - -<p>[3] Nyt ainoastaan laitteella Google Daydream.</p> - -<p>[4] Päällä Firefox Nightly ja Beta -versioissa 55 ja uudempi. Käytetään valinnalla <code>dom.gamepad-extensions.enabled</code>.</p> - -<h2 id="Katso_myös">Katso myös</h2> - -<ul> - <li><a href="https://vr.mozilla.org">vr.mozilla.org</a> — Mozillan WebVR:n aloitussivu, jossa on demoja, apuohjelmia ja muuta tietoa.</li> - <li><a href="https://aframe.io/">A-Frame</a> — Open source web-sovelluskehys VR-kokemuksien rakentamiseen.</li> - <li><a href="https://webvr.info">webvr.info</a> — Ajantasaista tietoa WebVR:stä, selaintuesta ja yhteisöstä.</li> - <li><a href="http://mozvr.com/">MozVr.com</a> — Demoja, latauslinkkejä ja muuta Mozillan VR-ryhmän tarjoamia resursseja.</li> - <li><a href="https://github.com/MozVR/vr-web-examples/tree/master/threejs-vr-boilerplate">threejs-vr-boilerplate</a> — Käyttökelpoinen mallipohja, jonka päälle WebVR-sovellus on helppo rakentaa.</li> - <li><a href="https://github.com/googlevr/webvr-polyfill/">Web VR polyfill</a> — JavaScript -toteutus WebVR:n toiminnoista.</li> -</ul> diff --git a/files/fi/web/api/webvr_api/using_the_webvr_api/index.html b/files/fi/web/api/webvr_api/using_the_webvr_api/index.html deleted file mode 100644 index b4cf17e315..0000000000 --- a/files/fi/web/api/webvr_api/using_the_webvr_api/index.html +++ /dev/null @@ -1,438 +0,0 @@ ---- -title: Using the WebVR API -slug: Web/API/WebVR_API/Using_the_WebVR_API -translation_of: Web/API/WebVR_API/Using_the_WebVR_API ---- -<div>{{APIRef("WebVR API")}}</div> - -<p class="summary">WebVR API on hieno lisä webkehittäjän työkaluihin. Sen avulla WebGL- näkymä (scene) voidaan esittää Oculus Riftin and HTC Viven tapaisissa VR-näytöissä. Mutta miten pääset alkuun VR appsien tekemiseen webbiin? Tämä juttu opastaa sinut perusteisiin.</p> - -<div class="note"> -<p><strong>Huom</strong>: WebVR APIn vakain versio — 1.1 — on vasta implementoitu Firefox 55:een (Windowsin release-versio, Mac OS X :ssa vain 'Nightly'), ja sen saa myös Chrome:en käytettäessä Google Daydream -laitteistoa. Speksistä on myös tuoreempi versio — 2.0 — mutta se on kovin keskeneräinen. Lisätietoja viimeisimmästä speksistä löytyy linkistä <a href="https://w3c.github.io/webvr/">WebVR Spec Version List</a>.</p> -</div> - -<h2 id="Aloitus">Aloitus</h2> - -<p>Päästäksesi alkuun tarvitset:</p> - -<ul> - <li>Tuetun VR-laitteiston. - <ul> - <li>halvin vaihtoehto on mobiililaite, tuettu selain, ja silmikkonäyttö, johon mobiililaitteen saa asetettua (esim. Google Cardboard). Tämä ei vastaa käyttökokemukseltaan aivan tarkoitukseen suunniteltua laitteistoa, mutta selviät ostamatta teho-PC:tä tai erityistä VR-näyttöä.</li> - <li>VR-laitteisto saattaa olla hinnakas, mutta sillä saadaan parempi käyttökokemus. Parhaiten WebVR-yhteensopivia laitteita ovat tällä hetkellä HTC VIVE ja The Oculus Rift. <a href="https://webvr.info/">webvr.info</a> :n etusivulla on lisätietoa laitteiden tarjonnasta ja selaintuesta niille.</li> - </ul> - </li> - <li>Mahdollisesti vaaditun riittävän tehokkaan tetokoneen VR-näkymien prosessointiin ja näyttämiseen VR-laitteistollesi. Koneen speksejä varten tutki sen VR-laitteiston vaatimuksia (e.g. <a href="https://www.vive.com/us/ready/">VIVE READY Computers</a>), jonka aiot hankkia.</li> - <li>Tuettu selain tulee olla asennettu — uusin <a href="https://www.mozilla.org/en-US/firefox/channel/desktop/">Firefox Nightly</a> tai <a href="https://www.google.com/chrome/index.html">Chrome</a> ovat parhaat vaihtoehdot tällä hetkellä, PC:lle tai mobiiliin.</li> -</ul> - -<p>Kun laitteisto ja ohjelmistot on asennettu, voit testata, toimiiko kokoonpanosi WebVR:n kanssa tästä linkistä - <a href="https://mdn.github.io/webvr-tests/aframe-demo/">simple A-Frame demo</a>, ja näet, saadaanko näkymä näkyviin ja pääsetkö VR-moodiin oikean alareunan painikkeella.</p> - -<p><a href="https://aframe.io/">A-Frame</a> on paras vaihtoehto päästä tekemään nopeasti WebVR-yhteensopivia 3D-näkymiä, ilman että tarvitsee ymmärtää rivikaupalla uutta JavaScript -koodia. Se ei kuitenkaan opeta, kuinka raaka WebVR API toimii ja siihen paneudummekin seuraavaksi.</p> - -<h2 id="Demon_esittely">Demon esittely</h2> - -<p>WebVR API :n toiminnan esdittelemiseksi tutustumme puhtaasti webgl:ää sisältävään esimerkkiimme, joka näyttää vähän tältä:</p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/15121/Capture1.png" style="display: block; height: 761px; margin: 0px auto; width: 1341px;"></p> - -<div class="note"> -<p><strong>Huom</strong>: Demon lähdekoodi - <a href="https://github.com/mdn/webvr-tests/tree/master/raw-webgl-example">source code</a> - löytyy GitHubista ja livelinkki siihen on tässä: <a href="https://mdn.github.io/webvr-tests/raw-webgl-example/">view it live</a>.</p> -</div> - -<div class="note"> -<p><strong>Huom</strong>: Ellei WebVR ei ala toimia selaimessa, varmista, että sitä ajetaan grafiikkakortin kautta. Esimerkiksi NVIDIA :lla sen omassa ohjauspaneelissa on pikavalikkovalinta <em><strong>Firefox</strong></em>, josta valitaan <em>Run with graphics processor > High-performance NVIDIA processor</em>.</p> -</div> - -<p>Demossa on kaikkien WebGL-demojen äiti — pyörivä 3D-kuutio. Toteutimme sen puhtaasti <a href="/en-US/docs/Web/API/WebGL_API">WebGL API</a> :n koodilla. Tässä ei käsitellä perus JavaScriptiä tai WebGL:ää, vaan pelkästään WebVR osia.</p> - -<p>Demosta löytyy myös:</p> - -<ul> - <li>Painike, jolla näkymä saadaan päälle VR-näyttöön (ja pois).</li> - <li>Painike, joka näyttää (ja piilottaa) VR:n 'pose' -tiedot - eli silmikon sijainnin ja suunnan - reaaliajassa.</li> -</ul> - -<p>Kun tutustut lähdekoodin päätiedostoon -<a href="https://github.com/mdn/webvr-tests/blob/master/raw-webgl-example/webgl-demo.js"> main JavaScript file</a> - löydät WebVR-osat koodista kommenttien "WebVR" tekstien avulla.</p> - -<div class="note"> -<p><strong>Huom</strong>: JavaScriptin ja WebGL:n perusteista lisätietoja löytyy tutoriaaleista <a href="/en-US/docs/Learn/JavaScript">JavaScript learning material</a> ja <a href="/en-US/docs/Web/API/WebGL_API/Tutorial">WebGL Tutorial</a>.</p> -</div> - -<h2 id="Miten_se_toimii">Miten se toimii?</h2> - -<p>Tässä vaiheessa katsotaan koodin WebVR-osien toiminta.</p> - -<p>Tyypillinen (yksinkertainen) WebVR sovellus toimii näin:</p> - -<ol> - <li>{{domxref("Navigator.getVRDisplays()")}} hakee viittauksen VR-näyttöösi.</li> - <li>{{domxref("VRDisplay.requestPresent()")}} :ä käytetään käynnistämään esittäminen VR-näytölle.</li> - <li>WebVR:n omaa {{domxref("VRDisplay.requestAnimationFrame()")}} -metodia käytetään suorittamaan sovelluksen renderöintisilmukkaa näytölle sopivalla virkistystaajuudella.</li> - <li>Renderöintisilmukassa haet ruudun näyttämiseen vaaditun datan ({{domxref("VRDisplay.getFrameData()")}}), piirrät näytettävän skenen kahdesti — molemmille silmille — ja toimitat renderöidyn näkymän näytölle käyttäjälle näytettäväksi metodilla ({{domxref("VRDisplay.submitFrame()")}}).</li> -</ol> - -<p>Alla olevissa kappaleissa tutustutaan webgl-demoihimme yksityiskohtaisemmin ja nähdään tarkemmin, missä edellä mainittuja ominaisuuksia käytetään.</p> - -<h3 id="Aloitetaan_muuttujilla">Aloitetaan muuttujilla</h3> - -<p>Ensimmäinen esimerkki WebVR:n käytöstä näkyy alla olevassa koodissa:</p> - -<pre class="brush: js">// WebVR variables - -var frameData = new VRFrameData(); -var vrDisplay; -var btn = document.querySelector('.stop-start'); -var normalSceneFrame; -var vrSceneFrame; - -var poseStatsBtn = document.querySelector('.pose-stats'); -var poseStatsSection = document.querySelector('section'); -poseStatsSection.style.visibility = 'hidden'; // hide it initially - -var posStats = document.querySelector('.pos'); -var orientStats = document.querySelector('.orient'); -var linVelStats = document.querySelector('.lin-vel'); -var linAccStats = document.querySelector('.lin-acc'); -var angVelStats = document.querySelector('.ang-vel'); -var angAccStats = document.querySelector('.ang-acc'); -var poseStatsDisplayed = false;</pre> - -<p>Lyhyet selitykset ovat siis tarpeen:</p> - -<ul> - <li><code>frameData</code> sisältää {{domxref("VRFrameData")}} olion, joka on tehty {{domxref("VRFrameData.VRFrameData", "VRFrameData()")}} -muodostimella. Tämä on alkuaan tyhjä, mutta sisältää myöhemmin VR-näytölle näytettävien ruutujen renderöintiin tarvittavat tiedot, ja ne päivitetään aina renderöintisilmukassa uudelleen.</li> - <li><code>vrDisplay</code> on alkuun alustamaton, mutta siinä on myöhemmin viittaus VR-silmikkoomme ({{domxref("VRDisplay")}} — joka on API:n keskeinen ohjattava kohde).</li> - <li><code>btn</code> ja <code>poseStatsBtn</code> viittaavat sovelluksen ohjaamiseen käytettyihin painikkeisiin.</li> - <li><code>normalSceneFrame</code> ja <code>vrSceneFrame</code> ovat aluksi alustamattomia, mutta myöhemmin viittaavat {{domxref("Window.requestAnimationFrame()")}} ja {{domxref("VRDisplay.requestAnimationFrame()")}} metodeihin — nämä alustavat normaalin ja WebVR-spesifisen renderöintisilmukan suorittamisen; niiden välisestä erosta selitetään hieman jäljempänä.</li> - <li>Muut muuttujat sisältävät viittauksia käyttöliittymän oikeassa alakulmassa näkyvän VR-sijainnin ja suuntauksen näyttävän tietolaatikon eri osiin.</li> -</ul> - -<h3 id="VR-näytön_hakeminen">VR-näytön hakeminen</h3> - -<p>Koodimme tärkeimpiä metodeja on <code>start()</code> — tämä suoritetaan, kun sivun body-osa on ladattu valmiiksi:</p> - -<pre class="brush: js">// start -// -// Called when the body has loaded is created to get the ball rolling. - -document.body.onload = start;</pre> - -<p>Aluksi<code>start()</code> hakee webbisivumme - <a href="https://github.com/mdn/webvr-tests/blob/master/raw-webgl-example/index.html">our HTML</a> - {{htmlelement("canvas")}} -osaan renderöitävään 3D-grafiikkaan tarvitun WebGL -ympäristön. Sitten tarkistetaan, että <code>gl</code> -ympäristö on käytettävissä — jos on, suoritetaan muutama metodi näytettävän skenen alustamiseksi.</p> - -<pre class="brush: js">function start() { - canvas = document.getElementById("glcanvas"); - - initWebGL(canvas); // Initialize the GL context - - // WebGL setup code here</pre> - -<p>Seuraavaksi aloitetaan varsinainen näyttöprosessi. Siinä asetetaan canvas-elementti näyttämään selaimen koko näytettävä ala ja suorittamalla renderöintisilmukka(<code>drawScene()</code>) ensimmäisen kerran. Tässä siis ei-WebVR osuus— se normaali renderöintisilmukka.</p> - -<pre class="brush: js"> // draw the scene normally, without WebVR - for those who don't have it and want to see the scene in their browser - - canvas.width = window.innerWidth; - canvas.height = window.innerHeight; - drawScene();</pre> - -<p>Seuraavaksi tulee sitten ensimmäinen pala WebVR-koodia. Aluksi tarkistetaan, onko VR-näyttöjä edes käytettävissä {{domxref("Navigator.getVRDisplays")}} — tästä alkaa API:n käyttö ja tämä on hyvä paikka WebVR:n ominaisuuksien tarkistamiseen. Koodilohkon lopussa (<code>else</code> -osassa) näkyy, että ellei sopivia näyttöjä ole, näytetään viesti, ettei selain tue WebVR 1.1 :ää.</p> - -<pre class="brush: js"> // WebVR: Check to see if WebVR is supported - if(navigator.getVRDisplays) { - console.log('WebVR 1.1 supported');</pre> - -<p><code>if() { ... }</code> koodilohkossa suoritetaan {{domxref("Navigator.getVRDisplays()")}} metodi. Tämä palauttaa <a href="/en-US/docs/Web/JavaScript/Guide/Using_promises">promise</a>-olion, jonka sisältönä on lista tietokoneeseen kytketyistä VR-näytöistä. Se on tyhjä, ellei näyttöjä ole..</p> - -<pre class="brush: js"> // Then get the displays attached to the computer - navigator.getVRDisplays().then(function(displays) {</pre> - -<p>Promise-olion <code>then()</code> -lohkossa tarkistetaan, että listan pituus on suurempi kuin 0; näin ollessa asetetaan <code>vrDisplay</code> -muuttujamme arvoksi listan ensimmäisen -indeksistä 0 löytyvän - alkion arvo. <code>vrDisplay</code> sisältää nyt {{domxref("VRDisplay")}} olion, joka vastaa laitteeseen liitettyä näyttöä!</p> - -<pre class="brush: js"> // If a display is available, use it to present the scene - if(displays.length > 0) { - vrDisplay = displays[0]; - console.log('Display found');</pre> - -<div class="note"> -<p><strong>Huom</strong>: On epätavallista, että tietokoneeseen olisi kytketty useita VR-näyttöjä, joten tätä yksinkertaista demoa varten usean näytön vaihtoehtoa ei huomioida.</p> -</div> - -<h3 id="VR-esityksen_käynnistys_ja_pysäytys">VR-esityksen käynnistys ja pysäytys</h3> - -<p>Nyt kun käytössä on {{domxref("VRDisplay")}} olio, sen avulla voidaan tehdä useita juttuja. Seuraavaksi haluamme käynnistää toiminnot WebGL-sisällön näyttämisen aloittamiseksi ja lopettamiseksi.</p> - -<p>Jatkaaksemme edellisestä koodilohkosta, lisäämme käynnistys/pysäytys -painikkeeseemme (<code>btn</code>) tapahtumankuuntelijan (event listener) — ja painiketta klikattaessa halutaan tarkistaa, joko esitys näytölle on käynnissä (toteutus tälle on hieman kökkö ja perustuu painikkeen tekstin, <code><a href="/en-US/docs/Web/API/Node/textContent">textContent</a></code>, tutkimiseen).</p> - -<p>Ellei esitys näyttöön ole vielä käynnissä, käytetään {{domxref("VRDisplay.requestPresent()")}} -metodia pyytämään selainta käynnistämään esitys näytölle. Parametrinä metodille annetaan lista {{domxref("VRLayerInit")}} olioita, jotka vastaavat näytettäväksi haluttuja näyttötasoja.</p> - -<p>Koska tällä hetkellä on mahdollista esittää vain yksi näyttötaso, ja ainoa vaadittu olion jäsen on {{domxref("VRLayerInit.source")}} -ominaisuus (joka viittaa tuossa näyttötasossa näytettäväksi tarkoitettuun {{htmlelement("canvas")}} :iin; annetaan muille parametreille järkevät oletusarvot — kts. {{domxref("VRLayerInit.leftBounds", "leftBounds")}} ja {{domxref("VRLayerInit.rightBounds", "rightBounds")}})), parametri on yksinkertaisesti [{ source: canvas }].</p> - -<p><code>requestPresent()</code> palauttaa promise-olion, joka saa sisällön, kun esittäminen käynnistyy onnistuneesti.</p> - -<pre class="brush: js"> // Starting the presentation when the button is clicked: It can only be called in response to a user gesture - btn.addEventListener('click', function() { - if(btn.textContent === 'Start VR display') { - vrDisplay.requestPresent([{ source: canvas }]).then(function() { - console.log('Presenting to WebVR display');</pre> - -<p>Nyt kun esittämispyyntö oli ok, halutaan seuraavaksi asettaa renderöintisisältö esitettäväksi VR-näytölle. Aivan ensimmäiseksi asetetaan canvas samankokoiseksi VR-näytön näyttöalueen kanssa. Tämä onnistuu hakemalla {{domxref("VREyeParameters")}} molemmille silmille käyttäen metodia {{domxref("VRDisplay.getEyeParameters()")}}.</p> - -<p>Sen jälkeen lasketaan yksinkertaisesti VR-näytön kokonaisala silmän ominaisuuksien {{domxref("VREyeParameters.renderWidth")}} ja {{domxref("VREyeParameters.renderHeight")}} avulla.</p> - -<pre class="brush: js"> // Set the canvas size to the size of the vrDisplay viewport - - var leftEye = vrDisplay.getEyeParameters('left'); - var rightEye = vrDisplay.getEyeParameters('right'); - - canvas.width = Math.max(leftEye.renderWidth, rightEye.renderWidth) * 2; - canvas.height = Math.max(leftEye.renderHeight, rightEye.renderHeight);</pre> - -<p>Seuraavaksi pysäytetään renderöintisilmukka {{domxref("Window.cancelAnimationFrame()", "cancel the animation loop")}}, joka aiemmin käynnistyi {{domxref("Window.requestAnimationFrame()")}} kutsulla <code>drawScene()</code> -metodista ja sen sijaan kutsutaan<code>drawVRScene()</code>:ä. Tämä metodi renderöi saman skenen kuin aiempikin käyttäen nyt VR-kohtaisia temppuja. Tämän renderöintisilmukan hallinta on nyt vastaavalla WebVR-versiolla, {{domxref("VRDisplay.requestAnimationFrame")}} -metodilla.</p> - -<pre class="brush: js"> // stop the normal presentation, and start the vr presentation - window.cancelAnimationFrame(normalSceneFrame); - drawVRScene();</pre> - -<p>Lopuksi päivitetään painikkeen teksti, jolloin seuraavalla klikkauskerralla painike tuleekin pysäyttämään esityksen VR-näytöllä.</p> - -<pre class="brush: js"> btn.textContent = 'Exit VR display'; - });</pre> - -<p><br> - VR-näytöllä esittämisen pysäyttämiseksi painikkeen seuraavalla klikkauksella kutsutaan {{domxref("VRDisplay.exitPresent()")}} -metodia. Painikkeen teksti vaihdetaan taas toiseksi ja <code>requestAnimationFrame</code> -kutsut vaihdetaan taas keskenään. Tästä näkyy, että käytetään metodia {{domxref("VRDisplay.cancelAnimationFrame")}} VR-renderöintisilmukan pysäyttämiseen ja normaalin skenen renderöinti käynnistyy <code>drawScene()</code>-metodilla.</p> - -<pre class="brush: js"> } else { - vrDisplay.exitPresent(); - console.log('Stopped presenting to WebVR display'); - - btn.textContent = 'Start VR display'; - - // Stop the VR presentation, and start the normal presentation - vrDisplay.cancelAnimationFrame(vrSceneFrame); - drawScene(); - } - }); - } - }); - } else { - console.log('WebVR API not supported by this browser.'); - } - } -}</pre> - -<p>Kun esittäminen käynnistyy, selaimessa näkyy stereoskooppinen näkymä:</p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/15123/Capture2.png" style="display: block; margin: 0 auto;"></p> - -<p>Seuraavasta opitaan, miten stereonäkymä varsinaisesti tehdään.</p> - -<h3 id="Miksi_WebVRllä_on_oma_requestAnimationFrame()">Miksi WebVR:llä on oma requestAnimationFrame()?</h3> - -<p>Tämä on hyvä kysymys. Perussyy on sulava renderöinti VR-näytössä, joka saadaan aikaan käyttämällä VR-näytön omaa näytönpäivitysnopeutta eikä tietokoneen. VR-näytön päivitysnopeudet ovat tietokonetta suurempia, yleisesti jopa 90fps. Tämä poikkeaa tietokoneen peruspäivitysnopeudesta.</p> - -<p>Huomaa, että kun VR-näytössä ei esitetä, {{domxref("VRDisplay.requestAnimationFrame")}} toimii identtisesti {{domxref("Window.requestAnimationFrame")}}:n kanssa, joten halutessasi voisit käyttää vain yhtä renderöintisilmukkaa tekemämme sovelluksen kahden silmukan sijaan. Sovelluksessa käytetään kahta, koska VR-esityksen ollessa päällä halutaan tehdä hieman eri asioita kuin ilman sitä, ja nämä halutaan selkeyden vuoksi erottaa.</p> - -<h3 id="Renderöinti_ja_näyttäminen">Renderöinti ja näyttäminen</h3> - -<p>Tässä vaiheessa on nähty kaikki koodi, mikä tarvitaan VR-laitteiston hakemiseen, skenen näyttöpyynnön lähettämiseen ja renderöintisilmukan käynnistämiseen. Seuraavaksi kurkataan renderöintisilmukan sisälle ja selitetään, miten sen WebVR-spesifiset osat toimivat.</p> - -<p>Aluksi tarkastellaan renderöintisilmukkametodin — <code>drawVRScene()</code> määrittelyä. Ensimmäinen tehtävä on kutsua {{domxref("VRDisplay.requestAnimationFrame()")}} -metodia silmukan toiston jatkamiseksi ensimmäisen kutsukerran jälkeen (tämä tehtiin aiemmin koodissa, kun VR-näytölle esittäminen aloitettiin). Tämä metodikutsu asetetaan globaalin <code>vrSceneFrame</code> -muuttujan arvoksi, jotta silmukka saadaan keskeytettyä {{domxref("VRDisplay.cancelAnimationFrame()")}} -metodilla, kun VR-esitys loppuu.</p> - -<pre class="brush: js">function drawVRScene() { - // WebVR: Request the next frame of the animation - vrSceneFrame = vrDisplay.requestAnimationFrame(drawVRScene);</pre> - -<p>Seuraavaksi kutsutaan metodia {{domxref("VRDisplay.getFrameData()")}}, joka saa parametriksi muuttujanimen, johon ruudun tiedot halutaan. Tämähän alustettiin jo aiemmin nimellä <code>frameData</code>. Metodin suorittamisen jälkeen tässä muuttujassa on tarpeelliset tiedot seuraavan ruudun renderöintiin VR -laitteelle pakattuna {{domxref("VRFrameData")}} -olioon. Mukana on tieto projektio- ja näkymämatriiseista, joiden avulla skene saadaan renderöityä oikein vasemmalle ja oikealle silmälle sekä ajantasainen {{domxref("VRPose")}} -olio, jossa on mm. VR-näytön suunta- ja sijaintitiedot.</p> - -<p>Tätä tulee kutsua joka ruudun kohdalla, jotta renderöity näkymä olisi ajantasainen.</p> - -<pre class="brush: js"> // Populate frameData with the data of the next frame to display - vrDisplay.getFrameData(frameData);</pre> - -<p>Seuraavaksi haetaan senhetkinen {{domxref("VRPose")}} ominaisuudesta {{domxref("VRFrameData.pose")}}, tallennetaan sijainti ja suunta myöhempää käyttöä varten ja lähetetään pose-tieto näytettäväksi sivun tilatietoruutuun, siis mikäli <code>poseStatsDisplayed</code> -muuttuja on saanut arvon true.</p> - -<pre class="brush: js"> // You can get the position, orientation, etc. of the display from the current frame's pose - - var curFramePose = frameData.pose; - var curPos = curFramePose.position; - var curOrient = curFramePose.orientation; - if(poseStatsDisplayed) { - displayPoseStats(curFramePose); - }</pre> - -<p> Seuraavaksi canvas:in sisältö tyhjennetään ennen uuden piirron aloittamista, jotta seuraava ruutu piirrettäisiin puhtaalle pohjalle, eikä aiempi ruutu olisi alla sotkemassa:</p> - -<pre class="brush: js"> // Clear the canvas before we start drawing on it. - - gl.clear(gl.COLOR_BUFFER_BIT | gl.DEPTH_BUFFER_BIT);</pre> - -<p>Nyt renderöidään molempien silmien näkymä. Aluksi tarvitaan projektion ja näkymän sijainti renderöintiä varten. Nämä ovat {{domxref("WebGLUniformLocation")}} -olioita, jotka on luotu {{domxref("WebGLRenderingContext.getUniformLocation()")}} -metodilla käyttäen parametreinä shader-ohjelman tunnusta ja nimitunnistetta.</p> - -<pre class="brush: js"> // WebVR: Create the required projection and view matrix locations needed - // for passing into the uniformMatrix4fv methods below - - var projectionMatrixLocation = gl.getUniformLocation(shaderProgram, "projMatrix"); - var viewMatrixLocation = gl.getUniformLocation(shaderProgram, "viewMatrix");</pre> - -<p>Seuraava renderöintivaihe sisältää:</p> - -<ul> - <li>Viewportin koon määrittäminen vasemmalle silmälle {{domxref("WebGLRenderingContext.viewport")}} -metodilla — tämä on tietenkin canvas:in leveyden ensimmäinen puolikas kertaa sen täysi korkeus.</li> - <li>Vasemmalle silmälle renderöintiin käytettävät näkymä- ja projektiomatriisien arvojen määrittäminen — tämä tehdään käyttämällä {{domxref("WebGLRenderingContext.uniformMatrix", "WebGLRenderingContext.uniformMatrix4fv")}} -metodia, joka saa parametrikseen yllä haetut sijaintitiedot ja {{domxref("VRFrameData")}} -oliolta saatavat vasemman puolen matriisit.</li> - <li><code>drawGeometry()</code> funktion suorittaminen, joka suorittaa varsinaisen skenen renderöinnin — ja edellisistä vaiheista johtuen siis vain vasemmalle silmälle.</li> -</ul> - -<pre class="brush: js"> // WebVR: Render the left eye’s view to the left half of the canvas - gl.viewport(0, 0, canvas.width * 0.5, canvas.height); - gl.uniformMatrix4fv(projectionMatrixLocation, false, frameData.leftProjectionMatrix); - gl.uniformMatrix4fv(viewMatrixLocation, false, frameData.leftViewMatrix); - drawGeometry();</pre> - -<p>Ja sama oikealle silmälle:</p> - -<pre class="brush: js"> // WebVR: Render the right eye’s view to the right half of the canvas - gl.viewport(canvas.width * 0.5, 0, canvas.width * 0.5, canvas.height); - gl.uniformMatrix4fv(projectionMatrixLocation, false, frameData.rightProjectionMatrix); - gl.uniformMatrix4fv(viewMatrixLocation, false, frameData.rightViewMatrix); - drawGeometry();</pre> - -<p>Seuraavaksi määritellään<code>drawGeometry()</code> funktio. Suurin osa siitä koostuu tavallisesta WebGL -koodista, jolla saadaan piirrettyä 3D-kuutio. WebVR-spesifisiä osia löytyy <code>mvTranslate()</code> ja<code>mvRotate()</code> funktiokutsuista — ne välittävät matriisit WebGL-ohjelmalle, joka määrittää sen hetkiselle ruudulle kuution sijainnin ja kierron.</p> - -<p>Kuten huomaat, näitä arvoja muokataan {{domxref("VRPose")}} -oliolta saaduilla VR-näytön sijainti- (<code>curPos</code>) ja kiertotiedoilla (<code>curOrient</code>). Sen seurauksena esimerkiksi päätä vasemmalle käännettäessä kuvassa näkyvä kuutio siirtyy aivan odotetustikin oikealle, kun x-sijaintitieto (<code>curPos[0]</code>) ja y-kiertotieto (<code>[curOrient[1]</code>) lisätään x-translaatioarvoon.</p> - -<p>Tämä on 'quick and dirty' -tapa käyttää VR pose-tietoa, mutta se näyttänee kuitenkin perusidean.</p> - -<pre class="brush: js"> function drawGeometry() { - // Establish the perspective with which we want to view the - // scene. Our field of view is 45 degrees, with a width/height - // ratio of 640:480, and we only want to see objects between 0.1 units - // and 100 units away from the camera. - - perspectiveMatrix = makePerspective(45, 640.0/480.0, 0.1, 100.0); - - // Set the drawing position to the "identity" point, which is - // the center of the scene. - - loadIdentity(); - - // Now move the drawing position a bit to where we want to start - // drawing the cube. - - mvTranslate([ - 0.0 - (curPos[0] * 25) + (curOrient[1] * 25), - 5.0 - (curPos[1] * 25) - (curOrient[0] * 25), - -15.0 - (curPos[2] * 25) - ]); - - // Save the current matrix, then rotate before we draw. - - mvPushMatrix(); - mvRotate(cubeRotation, [0.25, 0, 0.25 - curOrient[2] * 0.5]); - - // Draw the cube by binding the array buffer to the cube's vertices - // array, setting attributes, and pushing it to GL. - - gl.bindBuffer(gl.ARRAY_BUFFER, cubeVerticesBuffer); - gl.vertexAttribPointer(vertexPositionAttribute, 3, gl.FLOAT, false, 0, 0); - - // Set the texture coordinates attribute for the vertices. - - gl.bindBuffer(gl.ARRAY_BUFFER, cubeVerticesTextureCoordBuffer); - gl.vertexAttribPointer(textureCoordAttribute, 2, gl.FLOAT, false, 0, 0); - - // Specify the texture to map onto the faces. - - gl.activeTexture(gl.TEXTURE0); - gl.bindTexture(gl.TEXTURE_2D, cubeTexture); - gl.uniform1i(gl.getUniformLocation(shaderProgram, "uSampler"), 0); - - // Draw the cube. - - gl.bindBuffer(gl.ELEMENT_ARRAY_BUFFER, cubeVerticesIndexBuffer); - setMatrixUniforms(); - gl.drawElements(gl.TRIANGLES, 36, gl.UNSIGNED_SHORT, 0); - - // Restore the original matrix - - mvPopMatrix(); - } -</pre> - -<p>Seuraava koodipalanen ei liity mitenkään WebVR:ään — siinä vain kierretään kuutiota joka ruudun osalta:</p> - -<pre class="brush: js"> // Update the rotation for the next draw, if it's time to do so. - - var currentTime = (new Date).getTime(); - if (lastCubeUpdateTime) { - var delta = currentTime - lastCubeUpdateTime; - - cubeRotation += (30 * delta) / 1000.0; - } - - lastCubeUpdateTime = currentTime;</pre> - -<p>Renderöintisilmukan viimeiseen osaan kuuluu {{domxref("VRDisplay.submitFrame()")}} -metodin kutsuminen — kaikki tarpeellinen on nyt tehty ja näyttö on renderöity {{htmlelement("canvas")}} :iin, tämä metodi sitten toimittaa ruudun VR-näytölle, jolloin se ruutu näkyy myös siinä.</p> - -<pre class="brush: js"> // WebVR: Indicate that we are ready to present the rendered frame to the VR display - vrDisplay.submitFrame(); -}</pre> - -<h3 id="Pose_(sijainti_kierto_ym.)_-tiedon_näyttäminen">Pose (sijainti, kierto, ym.) -tiedon näyttäminen</h3> - -<p>Tässä osassa tutustutaan <code>displayPoseStats()</code> -funktioon, joka näyttää kunkin ruudun päivitetyt pose-tiedot. Kyseinen funktio on melko yksinkertainen.</p> - -<p>Aluksi tallennetaan {{domxref("VRPose")}}-oliolta saadut kuusi ominaisuutta omiin muuttujiin — ne ovat tyyppiä {{domxref("Float32Array")}}.</p> - -<pre class="brush: js">function displayPoseStats(pose) { - var pos = pose.position; - var orient = pose.orientation; - var linVel = pose.linearVelocity; - var linAcc = pose.linearAcceleration; - var angVel = pose.angularVelocity; - var angAcc = pose.angularAcceleration;</pre> - -<p>Sitten tiedot kirjoitetaan tietolaatikkoon ja päivitetään ne joka ruudun kohdalla. Arvot on pyöristetty <code><a href="/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number/toFixed">toFixed()</a></code> -metodilla luettavuuden vuoksi.</p> - -<p>Huomaa ehtolause lineaarisen ja kulmakiihtyvyyden vektorien arvojen tarkastamisessa - siinä varmistetaan ennen näyttämistä, että arvot on tosiaan saatu luettua. Useimmilta VR-laitteistolta näitä arvoja ei vielä saada, joten ilman tarkistamista seuraisi virhetoiminta (ellei arvoja saada, vektorien arvoksi tulee <code>null</code>).</p> - -<pre class="brush: js"> posStats.textContent = 'Position: x ' + pos[0].toFixed(3) + ', y ' + pos[1].toFixed(3) + ', z ' + pos[2].toFixed(3); - orientStats.textContent = 'Orientation: x ' + orient[0].toFixed(3) + ', y ' + orient[1].toFixed(3) + ', z ' + orient[2].toFixed(3); - linVelStats.textContent = 'Linear velocity: x ' + linVel[0].toFixed(3) + ', y ' + linVel[1].toFixed(3) + ', z ' + linVel[2].toFixed(3); - angVelStats.textContent = 'Angular velocity: x ' + angVel[0].toFixed(3) + ', y ' + angVel[1].toFixed(3) + ', z ' + angVel[2].toFixed(3); - - if(linAcc) { - linAccStats.textContent = 'Linear acceleration: x ' + linAcc[0].toFixed(3) + ', y ' + linAcc[1].toFixed(3) + ', z ' + linAcc[2].toFixed(3); - } else { - linAccStats.textContent = 'Linear acceleration not reported'; - } - - if(angAcc) { - angAccStats.textContent = 'Angular acceleration: x ' + angAcc[0].toFixed(3) + ', y ' + angAcc[1].toFixed(3) + ', z ' + angAcc[2].toFixed(3); - } else { - angAccStats.textContent = 'Angular acceleration not reported'; - } -}</pre> - -<h2 id="WebVR_-tapahtumat">WebVR -tapahtumat</h2> - -<p>The WebVR spesifikaatiossa on määritetty useita liipaistavia tapahtumia (event), ja näin koodilla voidaan reagoida VR-näytön tilan muutoksiin (vrt. <a href="/en-US/docs/Web/API/WebVR_API#Window_events">Window events</a>). Esimerkiksi:</p> - -<ul> - <li>{{event("vrdisplaypresentchange")}} — Liipaistaan, kun VR-näytön esittämistila muuttuu — esim. esitetään -> ei esitetä, ja päinvastoin.</li> - <li>{{event("vrdisplayconnect")}} — Saadaan, kun yhteensopiva VR-näyttö on liitetty tietokoneeseen.</li> - <li>{{event("vrdisplaydisconnect")}} — Tapahtuma VR-näytön irrotuksesta.</li> -</ul> - -<p>Demossa on seuraava esimerkki tapahtumista:</p> - -<pre class="brush: js">window.addEventListener('vrdisplaypresentchange', function(e) { - console.log('Display ' + e.display.displayId + ' presentation has changed. Reason given: ' + e.reason + '.'); -});</pre> - -<p>Kuten näet {{domxref("VRDisplayEvent", "event object")}} tarjoaa kaksi hyödyllistä ominaisuutta — {{domxref("VRDisplayEvent.display")}}, joka viittaa {{domxref("VRDisplay")}} tapahtuman tuottajaan, ja {{domxref("VRDisplayEvent.reason")}}, jossa on selkokielinen syy tapahtumaan.</p> - -<p>Tämä on hyvin käyttökelpoinen tapahtuma; sitä voidaan käyttää huomaan yllättävä näytön irrotus, joka estäää tarpeettomat virheviestit ja kertoo tilanteen käyttäjälle. Googlen Webvr.info -esitysdemossa tapahtumaa käytetään suorittamaan <a href="https://github.com/toji/webvr.info/blob/master/samples/03-vr-presentation.html#L174"><code>onVRPresentChange()</code> funktio</a>, joka päivittää käyttöliittymän kontrollit tilannetta vastaaviksi ja muuttaa canvasin kokoa.</p> - -<h2 id="Yhteenveto">Yhteenveto</h2> - -<p>Tässä artikkelissa kerrottiin hyvin yksinkertaisen WebVR 1.1 sovelluksen tekemisestä, jonka avulla pääset alkuun sovellusten kehittämisessä.</p> diff --git a/files/fi/web/api/window/index.html b/files/fi/web/api/window/index.html deleted file mode 100644 index c9c96d5672..0000000000 --- a/files/fi/web/api/window/index.html +++ /dev/null @@ -1,509 +0,0 @@ ---- -title: Window -slug: Web/API/Window -tags: - - API - - DOM - - Interface - - JavaScript - - NeedsTranslation - - Reference - - Tab - - TopicStub - - Window -translation_of: Web/API/Window ---- -<div>{{APIRef("DOM")}}</div> - -<p><span class="seoSummary">The <strong><code>Window</code></strong> interface represents a window containing a DOM document; the <code>document</code> property points to the <a href="/en-US/docs/DOM/document">DOM document</a> loaded in that window.</span> A window for a given document can be obtained using the {{domxref("document.defaultView")}} property.</p> - -<p>A global variable, <code>window</code>, representing the window in which the script is running, is exposed to JavaScript code.</p> - -<p>The <code>Window</code> interface is home to a variety of functions, namespaces, objects, and constructors which are not necessarily directly associated with the concept of a user interface window. However, the <code>Window</code> interface is a suitable place to include these items that need to be globally available. Many of these are documented in the <a href="/en-US/docs/Web/JavaScript/Reference">JavaScript Reference</a> and the <a href="/en-US/docs/Web/API/Document_Object_Model" title="/en-US/docs/Web/API/Document_Object_Model">DOM Reference</a>.</p> - -<p>In a tabbed browser, each tab is represented by its own <code>Window</code> object; the global <code>window</code> seen by JavaScript code running within a given tab always represents the tab in which the code is running. That said, even in a tabbed browser, some properties and methods still apply to the overall window that contains the tab, such as {{Domxref("Window.resizeTo", "resizeTo()")}} and {{Domxref("Window.innerHeight", "innerHeight")}}. Generally, anything that can't reasonably pertain to a tab pertains to the window instead.</p> - -<p>{{InheritanceDiagram}}</p> - -<h2 id="Properties">Properties</h2> - -<p><em>This interface inherits properties from the {{domxref("EventTarget")}} interface and implements properties from the {{domxref("WindowOrWorkerGlobalScope")}} and {{domxref("WindowEventHandlers")}} mixins.</em></p> - -<p>Note that properties which are objects (e.g.,. for overriding the prototype of built-in elements) are listed in a separate section below.</p> - -<dl> - <dt>{{domxref("Window.closed")}} {{Non-standard_inline}} {{readOnlyInline}}</dt> - <dd>This property indicates whether the current window is closed or not.</dd> - <dt>{{domxref("Window.console")}} {{ReadOnlyInline}}</dt> - <dd>Returns a reference to the console object which provides access to the browser's debugging console.</dd> - <dt>{{domxref("Window.content")}} and Window._content {{Non-standard_inline}} {{obsolete_inline}} {{ReadOnlyInline}}</dt> - <dd>Returns a reference to the content element in the current window. Since Firefox 57 (initially Nightly-only), both versions are only available from chrome (privileged) code, and not available to the web anymore.</dd> - <dt>{{domxref("Window.controllers")}} {{non-standard_inline}} {{ReadOnlyInline}}</dt> - <dd>Returns the XUL controller objects for the current chrome window.</dd> - <dt>{{domxref("Window.customElements")}} {{ReadOnlyInline}}</dt> - <dd>returns a reference to the {{domxref("CustomElementRegistry")}} object, which can be used to register new <a href="/en-US/docs/Web/Web_Components/Using_custom_elements">custom elements</a> and get information about previously registered custom elements.</dd> - <dt>{{domxref("Window.crypto")}} {{readOnlyInline}}</dt> - <dd>Returns the browser crypto object.</dd> - <dt>{{domxref("Window.defaultStatus")}} {{Obsolete_inline("gecko23")}}</dt> - <dd>Gets/sets the status bar text for the given window.</dd> - <dt>{{domxref("Window.devicePixelRatio")}} {{non-standard_inline}} {{ReadOnlyInline}}</dt> - <dd>Returns the ratio between physical pixels and device independent pixels in the current display.</dd> - <dt>{{domxref("Window.dialogArguments")}} {{ReadOnlyInline}}</dt> - <dd>Gets the arguments passed to the window (if it's a dialog box) at the time {{domxref("window.showModalDialog()")}} was called. This is an {{Interface("nsIArray")}}.</dd> - <dt>{{domxref("Window.directories")}} {{obsolete_inline}}</dt> - <dd>Synonym of {{domxref("window.personalbar")}}</dd> - <dt>{{domxref("Window.document")}} {{ReadOnlyInline}}</dt> - <dd>Returns a reference to the document that the window contains.</dd> - <dt>{{domxref("Window.DOMMatrix")}} {{readOnlyInline}} {{experimental_inline}}</dt> - <dd>Returns a reference to a {{domxref("DOMMatrix")}} object, which represents 4x4 matrices, suitable for 2D and 3D operations.</dd> - <dt>{{domxref("Window.DOMMatrixReadOnly")}} {{readOnlyInline}} {{experimental_inline}}</dt> - <dd>Returns a reference to a {{domxref("DOMMatrixReadOnly")}} object, which represents 4x4 matrices, suitable for 2D and 3D operations.</dd> - <dt>{{domxref("Window.DOMPoint")}} {{readOnlyInline}} {{experimental_inline}}</dt> - <dd>Returns a reference to a {{domxref("DOMPoint")}} object, which represents a 2D or 3D point in a coordinate system.</dd> - <dt>{{domxref("Window.DOMPointReadOnly")}} {{readOnlyInline}} {{experimental_inline}}</dt> - <dd>Returns a reference to a {{domxref("DOMPointReadOnly")}} object, which represents a 2D or 3D point in a coordinate system.</dd> - <dt>{{domxref("Window.DOMQuad")}} {{readOnlyInline}} {{experimental_inline}}</dt> - <dd>Returns a reference to a {{domxref("DOMQuad")}} object, which provides represents a quadrilaterial object, that is one having four corners and four sides.</dd> - <dt>{{domxref("Window.DOMRect")}} {{readOnlyInline}} {{experimental_inline}}</dt> - <dd>Returns a reference to a {{domxref("DOMRect")}} object, which represents a rectangle.</dd> - <dt>{{domxref("Window.DOMRectReadOnly")}} {{readOnlyInline}} {{experimental_inline}}</dt> - <dd>Returns a reference to a {{domxref("DOMRectReadOnly")}} object, which represents a rectangle.</dd> - <dt>{{domxref("Window.event")}} {{ReadOnlyInline}}</dt> - <dd>Returns the <strong>current event</strong>, which is the event currently being handled by the JavaScript code's context, or <code>undefined</code> if no event is currently being handled. The {{domxref("Event")}} object passed directly to event handlers should be used instead whenever possible.</dd> - <dt>{{domxref("Window.frameElement")}} {{readOnlyInline}}</dt> - <dd>Returns the element in which the window is embedded, or null if the window is not embedded.</dd> - <dt>{{domxref("Window.frames")}} {{readOnlyInline}}</dt> - <dd>Returns an array of the subframes in the current window.</dd> - <dt>{{domxref("Window.fullScreen")}} {{gecko_minversion_inline("1.9")}}</dt> - <dd>This property indicates whether the window is displayed in full screen or not.</dd> - <dt>{{domxref("Window.globalStorage")}} {{gecko_minversion_inline("1.8.1")}} {{Non-standard_inline}} {{Obsolete_inline("gecko13")}}</dt> - <dd>Unsupported since Gecko 13 (Firefox 13). Use {{domxref("Window.localStorage")}} instead.<br> - Was: Multiple storage objects that are used for storing data across multiple pages.</dd> - <dt>{{domxref("Window.history")}} {{ReadOnlyInline}}</dt> - <dd>Returns a reference to the history object.</dd> - <dt>{{domxref("Window.innerHeight")}} {{readOnlyInline}}</dt> - <dd>Gets the height of the content area of the browser window including, if rendered, the horizontal scrollbar.</dd> - <dt>{{domxref("Window.innerWidth")}} {{readOnlyInline}}</dt> - <dd>Gets the width of the content area of the browser window including, if rendered, the vertical scrollbar.</dd> - <dt>{{domxref("Window.isSecureContext")}} {{experimental_inline}} {{readOnlyInline}}</dt> - <dd>Indicates whether a context is capable of using features that require secure contexts.</dd> - <dt>{{domxref("Window.length")}} {{readOnlyInline}}</dt> - <dd>Returns the number of frames in the window. See also {{domxref("window.frames")}}.</dd> - <dt>{{domxref("Window.location")}}</dt> - <dd>Gets/sets the location, or current URL, of the window object.</dd> - <dt>{{domxref("Window.locationbar")}} {{ReadOnlyInline}}</dt> - <dd>Returns the locationbar object, whose visibility can be toggled in the window.</dd> - <dt>{{domxref("Window.localStorage")}} {{readOnlyInline}} {{gecko_minversion_inline("1.9.1")}}</dt> - <dd>Returns a reference to the local storage object used to store data that may only be accessed by the origin that created it.</dd> - <dt>{{domxref("Window.menubar")}} {{ReadOnlyInline}}</dt> - <dd>Returns the menubar object, whose visibility can be toggled in the window.</dd> - <dt>{{domxref("Window.messageManager")}} {{gecko_minversion_inline("2.0")}}</dt> - <dd>Returns the <a href="/en-US/docs/The_message_manager">message manager</a> object for this window.</dd> - <dt>{{domxref("Window.mozAnimationStartTime")}} {{ReadOnlyInline}} {{gecko_minversion_inline("2.0")}} {{Deprecated_inline}}</dt> - <dd>The time in milliseconds since epoch at which the current animation cycle began. Use {{domxref("Animation.startTime")}} instead.</dd> - <dt>{{domxref("Window.mozInnerScreenX")}} {{ReadOnlyInline}} {{non-standard_inline}} {{gecko_minversion_inline("1.9.2")}}</dt> - <dd>Returns the horizontal (X) coordinate of the top-left corner of the window's viewport, in screen coordinates. This value is reported in CSS pixels. See <code>mozScreenPixelsPerCSSPixel</code> in {{interface("nsIDOMWindowUtils")}} for a conversion factor to adapt to screen pixels if needed.</dd> - <dt>{{domxref("Window.mozInnerScreenY")}} {{ReadOnlyInline}} {{non-standard_inline}} {{gecko_minversion_inline("1.9.2")}}</dt> - <dd>Returns the vertical (Y) coordinate of the top-left corner of the window's viewport, in screen coordinates. This value is reported in CSS pixels. See <code>mozScreenPixelsPerCSSPixel</code> for a conversion factor to adapt to screen pixels if needed.</dd> - <dt>{{domxref("Window.mozPaintCount")}} {{non-standard_inline}} {{ReadOnlyInline}} {{gecko_minversion_inline("2.0")}}</dt> - <dd>Returns the number of times the current document has been rendered to the screen in this window. This can be used to compute rendering performance.</dd> - <dt>{{domxref("Window.name")}}</dt> - <dd>Gets/sets the name of the window.</dd> - <dt>{{domxref("Window.navigator")}} {{readOnlyInline}}</dt> - <dd>Returns a reference to the navigator object.</dd> - <dt>{{domxref("Window.opener")}}</dt> - <dd>Returns a reference to the window that opened this current window.</dd> - <dt>{{domxref("Window.orientation")}} {{non-standard_inline}} {{deprecated_inline}} {{readOnlyInline}}</dt> - <dd>Returns the orientation in degrees (in 90 degree increments) of the viewport relative to the device's natural orientation.</dd> - <dt>{{domxref("Window.outerHeight")}} {{readOnlyInline}}</dt> - <dd>Gets the height of the outside of the browser window.</dd> - <dt>{{domxref("Window.outerWidth")}} {{readOnlyInline}}</dt> - <dd>Gets the width of the outside of the browser window.</dd> - <dt>{{domxref("Window.scrollX","Window.pageXOffset")}} {{readOnlyInline}}</dt> - <dd>An alias for {{domxref("window.scrollX")}}.</dd> - <dt>{{domxref("Window.scrollY","Window.pageYOffset")}} {{readOnlyInline}}</dt> - <dd>An alias for {{domxref("window.scrollY")}}</dd> - <dt>{{domxref("Window.parent")}} {{readOnlyInline}}</dt> - <dd>Returns a reference to the parent of the current window or subframe.</dd> - <dt>{{domxref("Window.performance")}} {{readOnlyInline}}</dt> - <dd>Returns a {{domxref("Performance")}} object, which includes the {{domxref("Performance.timing", "timing")}} and {{domxref("Performance.navigation", "navigation")}} attributes, each of which is an object providing <a href="/en-US/docs/Navigation_timing">performance-related</a> data. See also <a href="/en-US/docs/Web/API/Navigation_timing_API/Using_Navigation_Timing">Using Navigation Timing</a> for additional information and examples.</dd> - <dt>{{domxref("Window.personalbar")}} {{readOnlyInline}}</dt> - <dd>Returns the personalbar object, whose visibility can be toggled in the window.</dd> - <dt>{{domxref("Window.pkcs11")}} {{obsolete_inline(29)}}</dt> - <dd>Formerly provided access to install and remove PKCS11 modules.</dd> - <dt>{{domxref("Window.returnValue")}}</dt> - <dd>The return value to be returned to the function that called {{domxref("window.showModalDialog()")}} to display the window as a modal dialog.</dd> - <dt>{{domxref("Window.screen")}} {{readOnlyInline}}</dt> - <dd>Returns a reference to the screen object associated with the window.</dd> - - <dt>{{domxref("Window.screenX")}} {{readOnlyInline}}</dt> - <dd>Returns the horizontal distance of the left border of the user's browser from the left side of the screen.</dd> - <dt>{{domxref("Window.screenY")}} {{readOnlyInline}}</dt> - <dd>Returns the vertical distance of the top border of the user's browser from the top side of the screen.</dd> - <dt>{{domxref("Window.scrollbars")}} {{readOnlyInline}}</dt> - <dd>Returns the scrollbars object, whose visibility can be toggled in the window.</dd> - <dt>{{domxref("Window.scrollMaxX")}} {{non-standard_inline}} {{ReadOnlyInline}}</dt> - <dd>The maximum offset that the window can be scrolled to horizontally, that is the document width minus the viewport width.</dd> - <dt>{{domxref("Window.scrollMaxY")}} {{non-standard_inline}} {{ReadOnlyInline}}</dt> - <dd>The maximum offset that the window can be scrolled to vertically (i.e., the document height minus the viewport height).</dd> - <dt>{{domxref("Window.scrollX")}} {{readOnlyInline}}</dt> - <dd>Returns the number of pixels that the document has already been scrolled horizontally.</dd> - <dt>{{domxref("Window.scrollY")}} {{readOnlyInline}}</dt> - <dd>Returns the number of pixels that the document has already been scrolled vertically.</dd> - <dt>{{domxref("Window.self")}} {{ReadOnlyInline}}</dt> - <dd>Returns an object reference to the window object itself.</dd> - <dt>{{domxref("Window.sessionStorage")}}</dt> - <dd>Returns a reference to the session storage object used to store data that may only be accessed by the origin that created it.</dd> - <dt>{{domxref("Window.sidebar")}} {{non-standard_inline}} {{ReadOnlyInline}}</dt> - <dd>Returns a reference to the window object of the sidebar.</dd> - <dt>{{domxref("Window.speechSynthesis")}} {{ReadOnlyInline}}</dt> - <dd>Returns a {{domxref("SpeechSynthesis")}} object, which is the entry point into using <a href="/en-US/docs/Web/API/Web_Speech_API">Web Speech API</a> speech synthesis functionality.</dd> - <dt>{{domxref("Window.status")}}</dt> - <dd>Gets/sets the text in the statusbar at the bottom of the browser.</dd> - <dt>{{domxref("Window.statusbar")}} {{readOnlyInline}}</dt> - <dd>Returns the statusbar object, whose visibility can be toggled in the window.</dd> - <dt>{{domxref("Window.toolbar")}} {{readOnlyInline}}</dt> - <dd>Returns the toolbar object, whose visibility can be toggled in the window.</dd> - <dt>{{domxref("Window.top")}} {{readOnlyInline}}</dt> - <dd>Returns a reference to the topmost window in the window hierarchy. This property is read only.</dd> - <dt>{{domxref("Window.visualViewport")}} {{readOnlyInline}}</dt> - <dd>Returns a {{domxref("VisualViewport")}} object which represents the visual viewport for a given window.</dd> - <dt>{{domxref("Window.window")}} {{ReadOnlyInline}}</dt> - <dd>Returns a reference to the current window.</dd> - <dt><code>window[0]</code>,<code> window[1]</code>, etc.</dt> - <dd>Returns a reference to the <code>window</code> object in the frames. See {{domxref("Window.frames")}} for more details.</dd> -</dl> - -<h3 id="Properties_implemented_from_elsewhere">Properties implemented from elsewhere</h3> - -<dl> - <dt>{{domxref("WindowOrWorkerGlobalScope.caches")}} {{readOnlyinline}}</dt> - <dd>Returns the {{domxref("CacheStorage")}} object associated with the current context. This object enables functionality such as storing assets for offline use, and generating custom responses to requests.</dd> - <dt>{{domxref("WindowOrWorkerGlobalScope.indexedDB")}} {{readonlyInline}}</dt> - <dd>Provides a mechanism for applications to asynchronously access capabilities of indexed databases; returns an {{domxref("IDBFactory")}} object.</dd> - <dt>{{domxref("WindowOrWorkerGlobalScope.isSecureContext")}} {{readOnlyinline}}</dt> - <dd>Returns a boolean indicating whether the current context is secure (<code>true</code>) or not (<code>false</code>).</dd> - <dt>{{domxref("WindowOrWorkerGlobalScope.origin")}} {{readOnlyinline}}</dt> - <dd>Returns the global object's origin, serialized as a string. (This does not yet appear to be implemented in any browser.)</dd> -</dl> - -<h2 id="Methods">Methods</h2> - -<p><em>This interface inherits methods from the {{domxref("EventTarget")}} interface and implements methods from {{domxref("WindowOrWorkerGlobalScope")}} and {{domxref("EventTarget")}}.</em></p> - -<dl> - <dt>{{domxref("Window.alert()")}}</dt> - <dd>Displays an alert dialog.</dd> - - <dt>{{domxref("Window.back()")}} {{Non-standard_inline}} {{obsolete_inline}}</dt> - <dd>Moves back one in the window history. This method is obsolete; you should instead use {{domxref("History.back", "window.history.back()")}}.</dd> - <dt>{{domxref("Window.blur()")}}</dt> - <dd>Sets focus away from the window.</dd> - <dt>{{domxref("Window.cancelAnimationFrame()")}} {{experimental_inline}}</dt> - <dd>Enables you to cancel a callback previously scheduled with {{domxref("Window.requestAnimationFrame")}}.</dd> - <dt>{{domxref("Window.cancelIdleCallback()")}} {{experimental_inline}}</dt> - <dd>Enables you to cancel a callback previously scheduled with {{domxref("Window.requestIdleCallback")}}.</dd> - <dt>{{domxref("Window.captureEvents()")}} {{Deprecated_inline}}</dt> - <dd>Registers the window to capture all events of the specified type.</dd> - <dt>{{domxref("Window.clearImmediate()")}}</dt> - <dd>Cancels the repeated execution set using <code>setImmediate</code>.</dd> - <dt>{{domxref("Window.close()")}}</dt> - <dd>Closes the current window.</dd> - <dt>{{domxref("Window.confirm()")}}</dt> - <dd>Displays a dialog with a message that the user needs to respond to.</dd> - <dt>{{domxref("Window.disableExternalCapture()")}} {{obsolete_inline(24)}}</dt> - <dd>{{todo("NeedsContents")}}</dd> - <dt>{{domxref("Window.dispatchEvent()")}}</dt> - <dd>Used to trigger an event.</dd> - <dt>{{domxref("Window.dump()")}} {{Non-standard_inline}}</dt> - <dd>Writes a message to the console.</dd> - <dt>{{domxref("Window.enableExternalCapture()")}} {{obsolete_inline(24)}}</dt> - <dd>{{todo("NeedsContents")}}</dd> - <dt>{{domxref("Window.find()")}}</dt> - <dd>Searches for a given string in a window.</dd> - <dt>{{domxref("Window.focus()")}}</dt> - <dd>Sets focus on the current window.</dd> - <dt>{{domxref("Window.forward()")}} {{Non-standard_inline}} {{obsolete_inline}}</dt> - <dd>Moves the window one document forward in the history. This method is obsolete; you should instead use {{domxref("History.forward", "window.history.forward()")}}.</dd> - <dt>{{domxref("Window.getAttention()")}} {{Non-standard_inline}} {{obsolete_inline}}</dt> - <dd>Flashes the application icon.</dd> - <dt>{{domxref("Window.getAttentionWithCycleCount()")}}</dt> - <dd>{{todo("NeedsContents")}}</dd> - <dt>{{domxref("Window.getComputedStyle()")}}</dt> - <dd>Gets computed style for the specified element. Computed style indicates the computed values of all CSS properties of the element.</dd> - <dt>{{domxref("Window.getDefaultComputedStyle()")}} {{Non-standard_inline}}</dt> - <dd>Gets default computed style for the specified element, ignoring author stylesheets.</dd> - <dt>{{domxref("Window.getSelection()")}}</dt> - <dd>Returns the selection object representing the selected item(s).</dd> - <dt>{{domxref("Window.home()")}} {{Non-standard_inline}} {{obsolete_inline}}</dt> - <dd>Returns the browser to the home page.</dd> - <dt>{{domxref("Window.matchMedia()")}} {{gecko_minversion_inline("6.0")}}</dt> - <dd>Returns a {{domxref("MediaQueryList")}} object representing the specified media query string.</dd> - <dt>{{domxref("Window.maximize()")}}</dt> - <dd>{{todo("NeedsContents")}}</dd> - <dt>{{domxref("Window.minimize()")}} (top-level XUL windows only)</dt> - <dd>Minimizes the window.</dd> - <dt>{{domxref("Window.moveBy()")}}</dt> - <dd>Moves the current window by a specified amount.</dd> - <dt>{{domxref("Window.moveTo()")}}</dt> - <dd>Moves the window to the specified coordinates.</dd> - <dt>{{domxref("Window.open()")}}</dt> - <dd>Opens a new window.</dd> - <dt>{{domxref("Window.openDialog()")}} {{Non-standard_inline}} {{obsolete_inline}}</dt> - <dd>Opens a new dialog window.</dd> - <dt>{{domxref("Window.postMessage()")}}</dt> - <dd>Provides a secure means for one window to send a string of data to another window, which need not be within the same domain as the first.</dd> - <dt>{{domxref("Window.print()")}}</dt> - <dd>Opens the Print Dialog to print the current document.</dd> - <dt>{{domxref("Window.prompt()")}}</dt> - <dd>Returns the text entered by the user in a prompt dialog.</dd> - <dt>{{domxref("Window.releaseEvents()")}} {{Non-standard_inline}} {{Deprecated_inline}}</dt> - <dd>Releases the window from trapping events of a specific type.</dd> - <dt>{{domxref("Window.requestAnimationFrame()")}} {{gecko_minversion_inline("2.0")}}</dt> - <dd>Tells the browser that an animation is in progress, requesting that the browser schedule a repaint of the window for the next animation frame.</dd> - <dt>{{domxref("Window.requestIdleCallback()")}} {{experimental_inline}}</dt> - <dd>Enables the scheduling of tasks during a browser's idle periods.</dd> - <dt>{{domxref("Window.resizeBy()")}}</dt> - <dd>Resizes the current window by a certain amount.</dd> - <dt>{{domxref("Window.resizeTo()")}}</dt> - <dd>Dynamically resizes window.</dd> - <dt>{{domxref("Window.restore()")}} {{Non-standard_inline}} {{obsolete_inline}}</dt> - <dd>{{todo("NeedsContents")}}</dd> - <dt>{{domxref("Window.routeEvent()")}} {{obsolete_inline(24)}}</dt> - <dd>{{todo("NeedsContents")}}</dd> - <dt>{{domxref("Window.scroll()")}}</dt> - <dd>Scrolls the window to a particular place in the document.</dd> - <dt>{{domxref("Window.scrollBy()")}}</dt> - <dd>Scrolls the document in the window by the given amount.</dd> - <dt>{{domxref("Window.scrollByLines()")}} {{Non-standard_inline}}</dt> - <dd>Scrolls the document by the given number of lines.</dd> - <dt>{{domxref("Window.scrollByPages()")}} {{Non-standard_inline}}</dt> - <dd>Scrolls the current document by the specified number of pages.</dd> - <dt>{{domxref("Window.scrollTo()")}}</dt> - <dd>Scrolls to a particular set of coordinates in the document.</dd> - <dt>{{domxref("Window.setCursor()")}} {{Non-standard_inline}} (top-level XUL windows only)</dt> - <dd>Changes the cursor for the current window</dd> - <dt>{{domxref("Window.setImmediate()")}}</dt> - <dd>Executes a function after the browser has finished other heavy tasks</dd> - <dt>{{domxref("Window.setResizable()")}} {{Non-standard_inline}}</dt> - <dd>Toggles a user's ability to resize a window.</dd> - <dt>{{domxref("Window.sizeToContent()")}} {{Non-standard_inline}}</dt> - <dd>Sizes the window according to its content.</dd> - <dt>{{domxref("Window.stop()")}}</dt> - <dd>This method stops window loading.</dd> - <dt>{{domxref("Window.updateCommands()")}} {{Non-standard_inline}}</dt> - <dd>Updates the state of commands of the current chrome window (UI).</dd> -</dl> - -<h3 id="Methods_implemented_from_elsewhere">Methods implemented from elsewhere</h3> - -<dl> - <dt>{{domxref("EventTarget.addEventListener()")}}</dt> - <dd>Register an event handler to a specific event type on the window.</dd> - <dt>{{domxref("WindowOrWorkerGlobalScope.atob()")}}</dt> - <dd>Decodes a string of data which has been encoded using base-64 encoding.</dd> - <dt>{{domxref("WindowOrWorkerGlobalScope.btoa()")}}</dt> - <dd>Creates a base-64 encoded ASCII string from a string of binary data.</dd> - <dt>{{domxref("WindowOrWorkerGlobalScope.clearInterval()")}}</dt> - <dd>Cancels the repeated execution set using {{domxref("WindowOrWorkerGlobalScope.setInterval()")}}.</dd> - <dt>{{domxref("WindowOrWorkerGlobalScope.clearTimeout()")}}</dt> - <dd>Cancels the delayed execution set using {{domxref("WindowOrWorkerGlobalScope.setTimeout()")}}.</dd> - <dt>{{domxref("WindowOrWorkerGlobalScope.createImageBitmap()")}}</dt> - <dd>Accepts a variety of different image sources, and returns a {{domxref("Promise")}} which resolves to an {{domxref("ImageBitmap")}}. Optionally the source is cropped to the rectangle of pixels originating at <em>(sx, sy)</em> with width sw, and height sh.</dd> - <dt>{{domxref("WindowOrWorkerGlobalScope.fetch()")}}</dt> - <dd>Starts the process of fetching a resource from the network.</dd> - <dt>{{domxref("EventTarget.removeEventListener")}}</dt> - <dd>Removes an event listener from the window.</dd> - <dt>{{domxref("WindowOrWorkerGlobalScope.setInterval()")}}</dt> - <dd>Schedules a function to execute every time a given number of milliseconds elapses.</dd> - <dt>{{domxref("WindowOrWorkerGlobalScope.setTimeout()")}}</dt> - <dd>Schedules a function to execute in a given amount of time.</dd> -</dl> - -<h3 id="Obsolete_methods">Obsolete methods</h3> - -<dl> - <dt>{{domxref("Window.showModalDialog()")}} {{obsolete_inline}}</dt> - <dd>Displays a modal dialog. <strong>This method was removed completely in Chrome 43, and Firefox 55.</strong></dd> -</dl> - -<h2 id="Event_handlers">Event handlers</h2> - -<p>These are properties of the window object that can be set to establish event handlers for the various things that can happen in the window that might be of interest.</p> - -<p><em>This interface inherits event handlers from the {{domxref("EventTarget")}} interface and implements event handlers from {{domxref("WindowEventHandlers")}}.</em></p> - -<div class="note"> -<p><strong>Note:</strong> Starting in {{Gecko("9.0")}}, you can now use the syntax <code>if ("onabort" in window)</code> to determine whether or not a given event handler property exists. This is because event handler interfaces have been updated to be proper web IDL interfaces. See <a href="/en-US/docs/DOM/DOM_event_handlers">DOM event handlers</a> for details.</p> -</div> - -<dl> - <dt>{{domxref("Window.onappinstalled")}}</dt> - <dd>Called when the page is installed as a webapp. See {{event('appinstalled')}} event.</dd> - <dt>{{domxref("Window.onbeforeinstallprompt")}}</dt> - <dd>An event handler property dispatched before a user is prompted to save a web site to a home screen on mobile.</dd> - <dt>{{domxref("Window.ondevicelight")}}</dt> - <dd>An event handler property for any ambient light levels changes</dd> - <dt>{{domxref("Window.ondevicemotion")}} {{gecko_minversion_inline("6.0")}}</dt> - <dd>Called if accelerometer detects a change (For mobile devices)</dd> - <dt>{{domxref("Window.ondeviceorientation")}} {{gecko_minversion_inline("6.0")}}</dt> - <dd>Called when the orientation is changed (For mobile devices)</dd> - <dt>{{domxref("Window.ondeviceorientationabsolute")}} {{non-standard_inline}} Chrome only</dt> - <dd>An event handler property for any device orientation changes.</dd> - <dt>{{domxref("Window.ondeviceproximity")}}</dt> - <dd>An event handler property for device proximity event</dd> - <dt>{{domxref("Window.ongamepadconnected")}}</dt> - <dd>Represents an event handler that will run when a gamepad is connected (when the {{event('gamepadconnected')}} event fires).</dd> - <dt>{{domxref("Window.ongamepaddisconnected")}}</dt> - <dd>Represents an event handler that will run when a gamepad is disconnected (when the {{event('gamepaddisconnected')}} event fires).</dd> - <dt>{{domxref("Window.onmozbeforepaint")}} {{gecko_minversion_inline("2.0")}}</dt> - <dd>An event handler property for the <code>MozBeforePaint</code> event, which is sent before repainting the window if the event has been requested by a call to the {{domxref("Window.mozRequestAnimationFrame()")}} method.</dd> - <dt>{{domxref("Window.onpaint")}}</dt> - <dd>An event handler property for paint events on the window.</dd> - <dt>{{domxref("Window.onrejectionhandled")}} {{experimental_inline}}</dt> - <dd>An event handler for handled {{jsxref("Promise")}} rejection events.</dd> - <dt>{{domxref("Window.onuserproximity")}}</dt> - <dd>An event handler property for user proximity events.</dd> - <dt>{{domxref("Window.onvrdisplayconnect")}}</dt> - <dd>Represents an event handler that will run when a compatible VR device has been connected to the computer (when the {{event("vrdisplayconnected")}} event fires).</dd> - <dt>{{domxref("Window.onvrdisplaydisconnect")}}</dt> - <dd>Represents an event handler that will run when a compatible VR device has been disconnected from the computer (when the {{event("vrdisplaydisconnected")}} event fires).</dd> - <dt>{{domxref("Window.onvrdisplayactivate")}}</dt> - <dd>Represents an event handler that will run when a display is able to be presented to (when the {{event("vrdisplayactivate")}} event fires), for example if an HMD has been moved to bring it out of standby, or woken up by being put on.</dd> - <dt>{{domxref("Window.onvrdisplaydeactivate")}}</dt> - <dd>Represents an event handler that will run when a display can no longer be presented to (when the {{event("vrdisplaydeactivate")}} event fires), for example if an HMD has gone into standby or sleep mode due to a period of inactivity.</dd> - <dt>{{domxref("Window.onvrdisplayblur")}}</dt> - <dd>Represents an event handler that will run when presentation to a display has been paused for some reason by the browser, OS, or VR hardware (when the {{event("vrdisplayblur")}} event fires) — for example, while the user is interacting with a system menu or browser, to prevent tracking or loss of experience.</dd> - <dt>{{domxref("Window.onvrdisplayfocus")}}</dt> - <dd>Represents an event handler that will run when presentation to a display has resumed after being blurred (when the {{event("vrdisplayfocus")}} event fires).</dd> - <dt>{{domxref("Window.onvrdisplaypresentchange")}}</dt> - <dd>represents an event handler that will run when the presenting state of a VR device changes — i.e. goes from presenting to not presenting, or vice versa (when the {{event("vrdisplaypresentchange")}} event fires).</dd> -</dl> - -<h3 id="Event_handlers_implemented_from_elsewhere">Event handlers implemented from elsewhere</h3> - -<dl> - <dt>{{domxref("GlobalEventHandlers.onabort")}}</dt> - <dd>Called when the loading of a resource has been aborted, such as by a user canceling the load while it is still in progress</dd> - <dt>{{domxref("WindowEventHandlers.onafterprint")}}</dt> - <dd>Called when the print dialog box is closed. See {{event("afterprint")}} event.</dd> - <dt>{{domxref("WindowEventHandlers.onbeforeprint")}}</dt> - <dd>Called when the print dialog box is opened. See {{event("beforeprint")}} event.</dd> - <dt>{{domxref("WindowEventHandlers.onbeforeunload")}}</dt> - <dd>An event handler property for before-unload events on the window.</dd> - <dt>{{domxref("GlobalEventHandlers.onblur")}}</dt> - <dd>Called after the window loses focus, such as due to a popup.</dd> - <dt>{{domxref("GlobalEventHandlers.onchange")}}</dt> - <dd>An event handler property for change events on the window.</dd> - <dt>{{domxref("GlobalEventHandlers.onclick")}}</dt> - <dd>Called after the ANY mouse button is pressed & released</dd> - <dt>{{domxref("GlobalEventHandlers.ondblclick")}}</dt> - <dd>Called when a double click is made with ANY mouse button.</dd> - <dt>{{domxref("GlobalEventHandlers.onclose")}}</dt> - <dd>Called after the window is closed</dd> - <dt>{{domxref("GlobalEventHandlers.oncontextmenu")}}</dt> - <dd>Called when the RIGHT mouse button is pressed</dd> - <dt>{{domxref("GlobalEventHandlers.onerror")}}</dt> - <dd>Called when a resource fails to load OR when an error occurs at runtime. See {{event("error")}} event.</dd> - <dt>{{domxref("GlobalEventHandlers.onfocus")}}</dt> - <dd>Called after the window receives or regains focus. See {{event("focus")}} events.</dd> - <dt>{{domxref("WindowEventHandlers.onhashchange")}} {{gecko_minversion_inline("1.9.2")}}</dt> - <dd>An event handler property for {{event('hashchange')}} events on the window; called when the part of the URL after the hash mark ("#") changes.</dd> - <dt>{{domxref("GlobalEventHandlers.oninput")}}</dt> - <dd>Called when the value of an <input> element changes</dd> - <dt>{{domxref("GlobalEventHandlers.onkeydown")}}</dt> - <dd>Called when you begin pressing ANY key. See {{event("keydown")}} event.</dd> - <dt>{{domxref("GlobalEventHandlers.onkeypress")}}</dt> - <dd>Called when a key (except Shift, Fn, and CapsLock) is in pressed position. See {{event("keypress")}} event.</dd> - <dt>{{domxref("GlobalEventHandlers.onkeyup")}}</dt> - <dd>Called when you finish releasing ANY key. See {{event("keyup")}} event.</dd> - <dt>{{domxref("WindowEventHandlers.onlanguagechange")}}</dt> - <dd>An event handler property for {{event("languagechange")}} events on the window.</dd> - <dt>{{domxref("GlobalEventHandlers.onload")}}</dt> - <dd>Called after all resources and the DOM are fully loaded. WILL NOT get called when the page is loaded from cache, such as with back button.</dd> - <dt>{{domxref("WindowEventHandlers.onmessage")}}</dt> - <dd>Is an {{domxref("EventHandler")}} representing the code to be called when the {{event("message")}} event is raised.</dd> - <dt>{{domxref("GlobalEventHandlers.onmousedown")}}</dt> - <dd>Called when ANY mouse button is pressed.</dd> - <dt>{{domxref("GlobalEventHandlers.onmousemove")}}</dt> - <dd>Called continously when the mouse is moved inside the window.</dd> - <dt>{{domxref("GlobalEventHandlers.onmouseout")}}</dt> - <dd>Called when the pointer leaves the window.</dd> - <dt>{{domxref("GlobalEventHandlers.onmouseover")}}</dt> - <dd>Called when the pointer enters the window</dd> - <dt>{{domxref("GlobalEventHandlers.onmouseup")}}</dt> - <dd>Called when ANY mouse button is released</dd> - <dt>{{domxref("WindowEventHandlers.onoffline")}}</dt> - <dd>Called when network connection is lost. See {{event("offline")}} event.</dd> - <dt>{{domxref("WindowEventHandlers.ononline")}}</dt> - <dd>Called when network connection is established. See {{event("online")}} event.</dd> - <dt>{{domxref("WindowEventHandlers.onpagehide")}}</dt> - <dd>Called when the user navigates away from the page, before the onunload event. See {{event("pagehide")}} event.</dd> - <dt>{{domxref("WindowEventHandlers.onpageshow")}}</dt> - <dd>Called after all resources and the DOM are fully loaded. See {{event("pageshow")}} event.</dd> - <dt>{{domxref("WindowEventHandlers.onpopstate")}} {{gecko_minversion_inline("2.0")}}</dt> - <dd>Called when a back button is pressed.</dd> - <dt>{{domxref("GlobalEventHandlers.onreset")}}</dt> - <dd>Called when a form is reset</dd> - <dt>{{domxref("GlobalEventHandlers.onresize")}}</dt> - <dd>Called continuously as you are resizing the window.</dd> - <dt>{{domxref("GlobalEventHandlers.onscroll")}}</dt> - <dd>Called when the scroll bar is moved via ANY means. If the resource fully fits in the window, then this event cannot be invoked</dd> - <dt>{{domxref("GlobalEventHandlers.onwheel")}}</dt> - <dd>Called when the mouse wheel is rotated around any axis</dd> - <dt>{{domxref("GlobalEventHandlers.onselect")}}</dt> - <dd>Called after text in an input field is selected</dd> - <dt>{{domxref("GlobalEventHandlers.onselectionchange")}}</dt> - <dd>Is an {{domxref("EventHandler")}} representing the code to be called when the {{event("selectionchange")}} event is raised.</dd> - <dt>{{domxref("WindowEventHandlers.onstorage")}}</dt> - <dd>Called when there is a change in session storage or local storage. See {{event("storage")}} event</dd> - <dt>{{domxref("GlobalEventHandlers.onsubmit")}}</dt> - <dd>Called when a form is submitted</dd> - <dt>{{domxref("WindowEventHandlers.onunhandledrejection")}} {{experimental_inline}}</dt> - <dd>An event handler for unhandled {{jsxref("Promise")}} rejection events.</dd> - <dt>{{domxref("WindowEventHandlers.onunload")}}</dt> - <dd>Called when the user navigates away from the page.</dd> -</dl> - -<h2 id="Constructors">Constructors</h2> - -<p>See also the <a href="/en-US/docs/DOM/DOM_Reference" title="/en-US/docs/DOM/DOM_Reference">DOM Interfaces</a>.</p> - -<dl> - <dt>{{domxref("DOMParser")}}</dt> - <dd><code>DOMParser</code> can parse XML or HTML source stored in a string into a DOM <a href="https://developer.mozilla.org/en-US/docs/DOM/document" title="document">Document</a>. <code>DOMParser</code> is specified in <a href="https://w3c.github.io/DOM-Parsing/" title="http://html5.org/specs/dom-parsing.html">DOM Parsing and Serialization</a>.</dd> - <dt>{{domxref("Window.GeckoActiveXObject")}}</dt> - <dd>{{todo("NeedsContents")}}</dd> - <dt>{{domxref("Image")}}</dt> - <dd>Used for creating an {{domxref("HTMLImageElement")}}.</dd> - <dt>{{domxref("Option")}}</dt> - <dd>Used for creating an {{domxref("HTMLOptionElement")}}</dd> - <dt>{{domxref("Window.QueryInterface")}}</dt> - <dd>{{todo("NeedsContents")}}</dd> - <dt>{{domxref("Window.StaticRange")}} {{experimental_inline}} {{readonlyinline}}</dt> - <dd>Returns a {{domxref('StaticRange.StaticRange','StaticRange()')}} constructor which creates a {{domxref('StaticRange')}} object.</dd> - <dt>{{domxref("Worker")}}</dt> - <dd>Used for creating a <a href="/en-US/docs/DOM/Using_web_workers">Web worker</a></dd> - <dt>{{domxref("Window.XMLSerializer")}}</dt> - <dd>{{todo("NeedsContents")}}</dd> - <dt>{{domxref("Window.XPCNativeWrapper")}}</dt> - <dd>{{todo("NeedsContents")}}</dd> - <dt>{{domxref("Window.XPCSafeJSObjectWrapper")}}</dt> - <dd>{{todo("NeedsContents")}}</dd> -</dl> - -<h2 id="Interfaces">Interfaces</h2> - -<p>See <a href="/en-US/docs/DOM/DOM_Reference" title="/en-US/docs/DOM/DOM_Reference">DOM Reference</a></p> - -<h2 id="Browser_compatibility">Browser compatibility</h2> - - - -<p>{{Compat("api.Window")}}</p> - -<h2 id="See_also">See also</h2> - -<ul> - <li><a href="/en-US/docs/Working_with_windows_in_chrome_code">Working with windows in chrome code</a></li> -</ul> diff --git a/files/fi/web/api/window/navigator/index.html b/files/fi/web/api/window/navigator/index.html deleted file mode 100644 index e06a2f0ef1..0000000000 --- a/files/fi/web/api/window/navigator/index.html +++ /dev/null @@ -1,111 +0,0 @@ ---- -title: window.navigator -slug: Web/API/Window/navigator -translation_of: Web/API/Window/navigator -original_slug: DOM/window.navigator ---- -<div>{{ApiRef}}</div> - -<h2 id="Summary" name="Summary">Yhteenveto</h2> - -<p>Palauttaa viitteen navigaattori-objektiin, jolta voidaan kysellä tietoja skriptiä suorittavasta sovelluksesta.</p> - -<h2 id="Example" name="Example">Esimerkki</h2> - -<div style="overflow: hidden;"> -<pre class="brush:js">alert("You're using " + navigator.appName); -</pre> -</div> - -<h2 id="Properties" name="Properties">Ominaisuudet</h2> - -<dl> - <dt>{{domxref("window.navigator.appCodeName", "navigator.appCodeName")}} {{non-standard_inline}}</dt> - <dd>Palauttaa nykyisen selaimen sisäisen "code"-nimen. Älä nojaa tähän ominaisuuteen oikean arvon palauttamiseksi.</dd> - <dt>{{domxref("window.navigator.appName", "navigator.appName")}}</dt> - <dd>Palauttaa selaimen virallisen nimen. Älä nojaa tähän ominaisuuteen oikean arvon palauttamiseksi.</dd> - <dt>{{domxref("window.navigator.appVersion", "navigator.appVersion")}}</dt> - <dd>Palauttaa selaimen version merkkijonona. Älä nojaa tähän ominaisuuteen oikean arvon palauttamiseksi.</dd> - <dt>{{domxref("window.navigator.battery", "navigator.battery")}} {{gecko_minversion_inline("10.0")}}</dt> - <dd>Palauttaa {{domxref("window.navigator.battery", "battery")}}-objektin, jota voit käyttää tietojen saamiseksi akun lataustilasta.</dd> - <dt>{{domxref("window.navigator.buildID", "navigator.buildID")}} {{non-standard_inline}}</dt> - <dd>Palauttaa selaimen rakentamistunnisteen (esim.: "2006090803")</dd> - <dt>{{domxref("window.navigator.connection", "navigator.connection")}}</dt> - <dd>Tarjoaa tietoa laitteen verkkoyhteydestä.</dd> - <dt>{{domxref("window.navigator.cookieEnabled", "navigator.cookieEnabled")}}</dt> - <dd>Palauttaa boolean-arvon, joka kertoo, että ovatko evästeet käytössä selaimessa vai eivät.</dd> - <dt>{{domxref("navigator.doNotTrack")}} {{non-standard_inline}}</dt> - <dd>Ilmoittaa käyttäjän do-not-track -asetuksen. Kun tämä arvo on "yes", webbisivustosi tai sovelluksesi ei pitäisi seurata käyttäjää.</dd> - <dt>{{domxref("navigator.id")}} {{non-standard_inline}}</dt> - <dd>Palauttaa {{domxref("window.navigator.id", "id")}}-objektin, jota voit käyttää <a href="/en-US/docs/BrowserID" title="BrowserID">BrowserID</a>-tuen lisäämiseksi webbisivustollesi.</dd> - <dt>{{domxref("window.navigator.language", "navigator.language")}}</dt> - <dd>Palauttaa selaimen kieliversiota edustavan merkkijonon.</dd> - <dt>{{domxref("window.navigator.mimeTypes", "navigator.mimeTypes")}}</dt> - <dd>Palauttaa selaimen tukemien MIME-tyypien luettelon.</dd> - <dt>{{domxref("window.navigator.mozApps", "navigator.mozApps")}} {{non-standard_inline}}</dt> - <dd>Palauttaa {{domxref("window.navigator.mozApps", "Apps")}}-objektin, jota voit käyttää <a href="/Open_Web_Apps" title="Open Web apps">Open Web apps</a>-sovellusten asentamiseen, hallinnointiin ja ohjaamiseen.</dd> - <dt>{{domxref("navigator.mozNotification")}} {{non-standard_inline}}<br> - {{domxref("navigator.webkitNotification")}}</dt> - <dd>Palauttaa {{domxref("navigator.mozNotification", "notification")}}-objektin, jota voit käyttää toimittamaan ilmoituksia käyttäjältä webbisovelluksellesi.</dd> - <dt>{{domxref("window.navigator.mozSms", "navigator.mozSms")}} {{gecko_minversion_inline("12.0")}} {{non-standard_inline}}</dt> - <dd>Palauttaa {{domxref("SmsManager")}}-objektin, jota voit käyttää SMS-viestinnän hallinnointiin webbisovelluksessasi.</dd> - <dt>{{domxref("navigator.mozSocial")}} {{non-standard_inline}}</dt> - <dd>{{todo("NeedsText")}}</dd> - <dt>{{domxref("window.navigator.mozTelephony", "navigator.mozTelephony")}} {{non-standard_inline}}</dt> - <dd>Palauttaa {{domxref("Telephony")}}-objektin, jota voit käyttää luomaan ja hallinnoimaan puheluja.</dd> - <dt>{{domxref("window.navigator.onLine", "navigator.onLine")}}</dt> - <dd>Palauttaa boolean-arvon, joka osoittaa, että onko selaimesi verkkoyhteydessä vai ei.</dd> - <dt>{{domxref("window.navigator.oscpu", "navigator.oscpu")}}</dt> - <dd>Palauttaa nykyistä käyttäjärjestelmää edustavan merkkijonon.</dd> - <dt>{{domxref("window.navigator.platform", "navigator.platform")}}</dt> - <dd>Palauttaa selainalustaa edustavan merkkijonon.</dd> - <dt>{{domxref("window.navigator.plugins", "navigator.plugins")}}</dt> - <dd>Palauttaa selaimeen asennettujen lisäosien taulukon.</dd> - <dt>{{domxref("window.navigator.product", "navigator.product")}} {{non-standard_inline}}</dt> - <dd>Palauttaa nykyisen selaimen tuotenimen. (esim.: "Gecko")</dd> - <dt>{{domxref("window.navigator.productSub", "navigator.productSub")}} {{non-standard_inline}}</dt> - <dd>Palauttaa nykyisen selaimen rakennusnumeron (esim.: "20060909")</dd> - <dt>{{domxref("window.navigator.securitypolicy", "navigator.securitypolicy")}} {{non-standard_inline}}</dt> - <dd>Palauttaa tyhjän merkkijonon. Netscape 4.7x-selaimessa palauttaa merkkijonon "US & CA domestic policy" tai "Export policy".</dd> - <dt>{{domxref("window.navigator.standalone", "navigator.standalone")}} {{non-standard_inline}}</dt> - <dd>Palauttaa boolean-arvon, joka osoittaa, että suoritetaanko selainta erillistilassa. Käytettävissä vain Apple:n iOS Safari -selaimessa.</dd> - <dt>{{domxref("window.navigator.userAgent", "navigator.userAgent")}}</dt> - <dd>Palauttaa nykyisen selaimen user agent -merkkijonon.</dd> - <dt>{{domxref("window.navigator.vendor", "navigator.vendor")}} {{non-standard_inline}}</dt> - <dd>Palauttaa nykyisen selaimen toimittajanimen (esim.: "Netscape6")</dd> - <dt>{{domxref("window.navigator.vendorSub", "navigator.vendorSub")}} {{non-standard_inline}}</dt> - <dd>Palauttaa toimittajaversionumeron (esim.: "6.1")</dd> - <dt><a href="/en-US/docs/API/Pointer_Lock_API" title="Mouse Lock API"><code>navigator.webkitPointer</code></a> {{non-standard_inline}}</dt> - <dd>Palauttaa PointerLock-objektin <a href="/en-US/docs/API/Pointer_Lock_API" title="Mouse Lock API">Mouse Lock API</a>:a varten.</dd> -</dl> - -<h2 id="Methods" name="Methods">Metodit</h2> - -<dl> - <dt>{{domxref("window.navigator.javaEnabled", "navigator.javaEnabled")}}</dt> - <dd>Osoittaa, että onko tietokoneen selaimen Java käytössä vai ei.</dd> - <dt>{{domxref("window.navigator.mozIsLocallyAvailable", "navigator.mozIsLocallyAvailable")}} {{non-standard_inline}}</dt> - <dd>Sallii koodin tarkistaa verkkoa käyttämättä, että onko tietyssä URI-osoitteessa oleva asiakirja olemassa.</dd> - <dt>{{domxref("window.navigator.preference", "navigator.preference")}} {{obsolete_inline("2.0")}} {{non-standard_inline}}</dt> - <dd>Asettaa käyttäjäasetuksen. Tämä methodi on <a class="external" href="http://www.faqts.com/knowledge_base/view.phtml/aid/1608/fid/125/lang/en">käytettävissä vain privileged-koodille</a> ja on vanhentunut; sinun pitäisi käyttää sen sijasta XPCOM <a href="/en-US/docs/Preferences_API" title="Preferences_API">Preferences API</a>:a.</dd> - <dt>{{domxref("window.navigator.registerContentHandler", "navigator.registerContentHandler")}}</dt> - <dd>Sallii webbisivuston rekisteröidä itsensä tietyn MIME-tyypin mahdollisena käsittelijänä.</dd> - <dt>{{domxref("navigator.registerProtocolHandler", "navigator.registerProtocolHandler")}}</dt> - <dd>Sallii webbisivuston rekisteröidä itsensä tietyn yhteyskäytännön mahdollisena käsittelijänä.</dd> - <dt>{{domxref("window.navigator.taintEnabled", "navigator.taintEnabled")}} {{deprecated_inline("1.7.8")}} {{obsolete_inline("9.0")}} {{non-standard_inline}}</dt> - <dd>Palauttaa arvon <code>false</code>. JavaScript taint/untaint -funktiot poistettu JavaScript 1.2:ssa.</dd> - <dt>{{domxref("window.navigator.vibrate", "navigator.vibrate()")}} {{gecko_minversion_inline("11.0")}}</dt> - <dd>Aiheuttaa värähtelyä laitteissa, jotka tukevat sitä. Ei tee mitään, jos värähtelytuki ei ole käytettävissä.</dd> -</dl> - -<h2 id="Specification" name="Specification">Spesifikaatio</h2> - -<ul> - <li>Määritelty osoitteessa <a class="external" href="http://www.whatwg.org/html/#navigator" title="http://www.whatwg.org/html/#navigator">HTML</a>.</li> -</ul> - -<h2 id="See_also" name="See_also">Katso myös</h2> - -<ul> - <li><a href="/en-US/docs/DOM_Client_Object_Cross-Reference/navigator" title="DOM_Client_Object_Cross-Reference/navigator">DOM Client Object Cross-Reference:navigator</a></li> -</ul> |