From 1109132f09d75da9a28b649c7677bb6ce07c40c0 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:41:45 -0500 Subject: initial commit --- files/es/web/api/navigator/donottrack/index.html | 111 +++++++++++++ files/es/web/api/navigator/getusermedia/index.html | 184 +++++++++++++++++++++ files/es/web/api/navigator/id/index.html | 16 ++ files/es/web/api/navigator/index.html | 141 ++++++++++++++++ files/es/web/api/navigator/mozsocial/index.html | 48 ++++++ .../navigator/registerprotocolhandler/index.html | 33 ++++ .../web-based_protocol_handlers/index.html | 132 +++++++++++++++ files/es/web/api/navigator/vibrate/index.html | 82 +++++++++ 8 files changed, 747 insertions(+) create mode 100644 files/es/web/api/navigator/donottrack/index.html create mode 100644 files/es/web/api/navigator/getusermedia/index.html create mode 100644 files/es/web/api/navigator/id/index.html create mode 100644 files/es/web/api/navigator/index.html create mode 100644 files/es/web/api/navigator/mozsocial/index.html create mode 100644 files/es/web/api/navigator/registerprotocolhandler/index.html create mode 100644 files/es/web/api/navigator/registerprotocolhandler/web-based_protocol_handlers/index.html create mode 100644 files/es/web/api/navigator/vibrate/index.html (limited to 'files/es/web/api/navigator') diff --git a/files/es/web/api/navigator/donottrack/index.html b/files/es/web/api/navigator/donottrack/index.html new file mode 100644 index 0000000000..fbc7c54b32 --- /dev/null +++ b/files/es/web/api/navigator/donottrack/index.html @@ -0,0 +1,111 @@ +--- +title: Navigator.doNotTrack +slug: Web/API/Navigator/doNotTrack +tags: + - API + - DOM + - Experimental + - Propiedad + - Referencia +translation_of: Web/API/Navigator/doNotTrack +--- +
{{ApiRef("HTML DOM")}}{{SeeCompatTable}}
+ +

Devuelve los ajustes de do-not-track del usuario. Esto es "1" si el usuario ha solicitado no ser rastreado por sitios web, contenidos, o anuncios.

+ +

Sintaxis

+ +
dnt = navigator.doNotTrack;
+
+ +

El valor refleja el de la cabecera do-not-track, ej. valores de {"1", "0", "unspecified" }. Nota: Antes de Gecko 32, Gecko empleaba los valores { "yes", "no", "unspecified"} (bug 887703).

+ +

Ejemplo

+ +
console.log(navigator.doNotTrack);
+// imprime "1" si DNT está habilitado; "0" si el usuario ha aceptado el rastreo; en caso contrario es "unspecified"
+
+ +

Especificaciones

+ + + + + + + + + + + + + + + + +
EspecificaciónEstadoComentario
{{SpecName("Tracking", "#widl-Navigator-doNotTrack", "Navigator.doNotTrack")}}{{Spec2("Tracking")}}Definición inicial
+ +

Compatibilidad con navegadores

+ +

{{CompatibilityTable}}

+ +
+ + + + + + + + + + + + + + + + + + + +
CaracterísticaChromeFirefox (Gecko)Internet ExplorerOperaSafari
Soporte básico23{{CompatGeckoDesktop("9.0")}}[1]9[2]
+ 11[3]		125.1[4]
+
+ +
+ + + + + + + + + + + + + + + + + + + +
CaracterísticaAndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Soporte básico{{CompatUnknown}}{{CompatGeckoMobile("9.0")}}[1]{{CompatUnknown}}[2]{{CompatUnknown}}{{CompatUnknown}}
+
+ +

[1] Antes de Gecko 32 Firefox reporta navigator.doNotTrack con valores de yes y no en lugar de 1 y 0.

+ +

[2] Internet Explorer 9 y 10 utilizan un prefijo, ej. navigator.msDoNotTrack.

+ +

[3] Internet Explorer 11 y Edge utilizan window.doNotTrack en lugar de navigator.doNotTrack.

+ +

[4] Safari 7.1.3+ utiliza window.doNotTrack en lugar de navigator.doNotTrack.

+ +

Vea también

+ + diff --git a/files/es/web/api/navigator/getusermedia/index.html b/files/es/web/api/navigator/getusermedia/index.html new file mode 100644 index 0000000000..e3fd046743 --- /dev/null +++ b/files/es/web/api/navigator/getusermedia/index.html @@ -0,0 +1,184 @@ +--- +title: Navigator.getUserMedia +slug: Web/API/Navigator/getUserMedia +translation_of: Web/API/Navigator/getUserMedia +--- +

Pide al usuario permiso para usar un dispositivo multimedia como una cámara o micrófono. Si el usuario concede este permiso, el successCallback es invocado en la aplicación llamada con un objeto LocalMediaStream como argumento.

+ +

Sintaxis

+ +
navigator.getUserMedia ( constraints, successCallback, errorCallback );
+ +

Ejemplo

+ +

Aquí  hay un ejemplo usando getUserMedia() con los prefijos del navegador.

+ +
navigator.getMedia = ( navigator.getUserMedia ||
+                       navigator.webkitGetUserMedia ||
+                       navigator.mozGetUserMedia);
+
+navigator.getMedia (
+
+   // Restricciones (contraints) *Requerido
+   {
+      video: true,
+      audio: true
+   },
+
+   // Funcion de finalizacion (Succes-Callback) *Requerido
+   function(localMediaStream) {
+      var video = document.querySelector('video');
+      video.src = window.URL.createObjectURL(localMediaStream);
+      video.onloadedmetadata = function(e) {
+         // Haz algo con el video aquí.
+      };
+   },
+
+   // errorCallback *Opcional
+   function(err) {
+    console.log("Ocurrió el siguiente error: " + err);
+   }
+
+);
+ +

Parámetros

+ + + + + + + + + + + + + + + + + + + + + + + + + + +
Parámetro +

Requerido/Opcional

+ 		Descripción
constraintsRequeridoEl tipo de multimedia que soporta el objeto LocalMediaStream devuelto en el successCallback.
successCallback RequeridoLa función a invocar cuando se pasa el objeto LocalMediaStream.
errorCallbackOpcionalLa función que se invoca en la aplicación si falla la llamada.
+ +

constraints

+ +

El parámetro constraints es un objeto MediaStreamConstraints con dos miembros booleanos: video y audio. Estos describen el los tipos de multimedia soportados por el objeto LocalMediaStream. Uno o ambos deben ser especificados para validar el argumento del parametro constraint. Si un constraint especificado no es soportado por el navegador, getUserMedia llama a la función errorCallback con el error NOT_SUPPORTED_ERROR. Si el navegador no puede encontrar ninguna fuente multimedia con el tipo especificado, getUserMedia llama a la función errorCallback con el error MANDATORY_UNSATISFIED_ERR.

+ +

Si el valor o el miembro no es especificado en el objeto, el valor del miembro por defecto será falso. El siguiente ejemplo muestra como definir el constraints para audio y video:

+ +
{ video: true, audio: true }
+ +

successCallback

+ +

La función getUserMedia llamará a la función especificada en el successCallback con el objeto LocalMediaStream que contenga la secuencia multimedia. Puedes asignar el objeto al elemento apropiado y trabajar con él, como se muestra en el siguiente ejemplo:

+ +
function(localMediaStream) {
+   var video = document.querySelector('video');
+   video.src = window.URL.createObjectURL(localMediaStream);
+   video.onloadedmetadata = function(e) {
+      // Haz algo aquí con el video.
+   };
+},
+ +

errorCallback

+ +

La función getUserMedia llama a la función indicada en el errorCallback con un código como argumento. Los códigos de error se describen a continuación:

+ + + + + + + + + + + + + + + + + + + + + + + + + + +
Error Descripción 
PERMISSION_DENIED El usuario denegó el permiso para usar el dispositivo multimadia requerido para esta operación. 
NOT_SUPPORTED_ERROR Un constraint especificado no es soportado por el navegador.
MANDATORY_UNSATISFIED_ERROR No se encontraron fuentes multimedia del tipo especificado en el constraints.
NO_DEVICES_FOUNDNo se encontró ninguna webcam instalada.
+ +

Compatibilidad con los navegadores

+ +
{{CompatibilityTable}}
+ +
+ + + + + + + + + + + + + + + + + + + +
CaracterísticaChromeFirefox (Gecko)Internet ExplorerOperaSafari (WebKit)
Stream API 21{{property_prefix("webkit")}} 20{{property_prefix("moz")}} {{CompatNo}} 12{{CompatUnknown}} 
+
+ +
+ + + + + + + + + + + + + + + + + + + +
CaracterísticaAndroidFirefox Mobile (Gecko)IE PhoneOpera MobileSafari Mobile
Stream API {{CompatNo}} {{CompatNo}}{{CompatUnknown}} 12{{CompatNo}} 
+
+ +

Actualmente el uso de WebRTC para acceder a la cámara esta soportado en Chrome, Opera y Firefox 20.

+ +

Vease también

+ + diff --git a/files/es/web/api/navigator/id/index.html b/files/es/web/api/navigator/id/index.html new file mode 100644 index 0000000000..707d9a6255 --- /dev/null +++ b/files/es/web/api/navigator/id/index.html @@ -0,0 +1,16 @@ +--- +title: navigator.id +slug: Web/API/Navigator/id +translation_of: Archive/Navigator-id +--- +
{{ ApiRef("Persona") }}
+ +

Summary

+ +

The BrowserID protocol defines a new id property on the {{ domxref ("window.navigator")}} object, through which it exposes the BrowserID API, that is the {{domxref("IdentityManager")}} intreface. This API has gone through several significant revisions. Each generation is listed separately below.

+ +

Syntax

+ +
var id = navigator.id
+ +

 

diff --git a/files/es/web/api/navigator/index.html b/files/es/web/api/navigator/index.html new file mode 100644 index 0000000000..6c38d2ca6b --- /dev/null +++ b/files/es/web/api/navigator/index.html @@ -0,0 +1,141 @@ +--- +title: Navigator +slug: Web/API/Navigator +tags: + - API + - HTML-DOM +translation_of: Web/API/Navigator +--- +

{{Apiref}}

+ +

La interfaz Navigator representa el estado y la identidad del user agent. Es completamente consultable y es posible registrar scripts para que ejecuten diversas actividades.

+ +

Un objeto Navigator puede ser obtenido usando la propiedad de sólo lectura {{domxref("Window.navigator")}}.

+ +

Propiedades

+ +

No hereda ninguna propiedad, pero implementa las definidas en {{domxref("NavigatorID")}}, {{domxref("NavigatorLanguage")}}, {{domxref("NavigatorOnLine")}}, {{domxref("NavigatorContentUtils")}}, {{domxref("NavigatorStorageUtils")}}, {{domxref("NavigatorCookies")}}, {{domxref("NavigatorConcurrentHardware")}}, {{domxref("NavigatorPlugins")}}, y {{domxref("NavigatorUserMedia")}}.

+ +

Estándar

+ +
+
{{domxref("Navigator.activeVRDisplays")}} {{readonlyInline}}{{experimental_inline}}
+
Devuelve un arreglo que contiene cada objeto {{domxref("VRDisplay")}} que está siendo presentado en el momento ({{domxref("VRDisplay.ispresenting")}} es true).
+
{{domxref("NavigatorID.appCodeName")}} {{readonlyInline}}{{experimental_inline}}
+
Devuelve el nombre código interno del navegador actual. No confie en que esta propiedad devuelva siempre el valor correcto.
+
{{domxref("NavigatorID.appName")}} {{readonlyInline}}{{experimental_inline}}
+
Devuelve un {{domxref("DOMString")}} con el nombre oficial del navegador. No confie en que esta propiedad devuelva siempre el valor correcto. 
+
{{domxref("NavigatorID.appVersion")}} {{readonlyInline}}{{experimental_inline}}
+
Devuelve la versión del navegador como un {{domxref("DOMString")}}. No confie en que esta propiedad devuelva siempre el valor correcto.
+
{{domxref("Navigator.battery")}} {{readonlyInline}}
+
Devuelve un objeto de tipo {{domxref("BatteryManager")}} que puede utilizar para obtener la información del estado de carga de la batería.
+
{{domxref("NetworkInformation.connection")}} {{readonlyInline}}{{experimental_inline}}
+
Provee un objeto {{domxref("NetworkInformation")}} con la información sobre la conexión a la red de un dispositivo.
+
{{domxref("NavigatorGeolocation.geolocation")}} {{readonlyInline}}
+
Devuelve un objeto {{domxref("Geolocation")}} que permite el acceso a la ubicación del dispositivo.
+
{{domxref("NavigatorConcurrentHardware.hardwareConcurrency")}} {{readOnlyInline}}
+
Devuelve el número de núcleos de procesador lógicos disponibles.
+
{{domxref("NavigatorPlugins.javaEnabled")}} {{readonlyInline}}{{experimental_inline}}
+
Devuelve un valor {{domxref("Boolean")}} que indica si el navegador tiene o no habilitado Java.
+
{{domxref("NavigatorLanguage.language")}} {{readonlyInline}}
+
Devuelve un valor {{domxref("DOMString")}} que representa el idioma elegido por el usuario, generalmente el idioma de la interfaz del navegador. Si no se puede identificar el idioma, devuelve un valor null.
+
{{domxref("NavigatorLanguage.languages")}} {{readonlyInline}}
+
Devuelve un arreglo de {{domxref("DOMString")}} que representan los idiomas conocidos por el usuario, en orden de preferencia.
+
{{domxref("NavigatorPlugins.mimeTypes")}} {{readonlyInline}}{{experimental_inline}}
+
Devieñve im {{domxref("MimeTypeArray")}} que enlista los tipos MIME soportados por el navegador.
+
{{domxref("NavigatorOnLine.onLine")}} {{readonlyInline}}
+
Devuelve un valor {{domxref("Boolean")}} que indica si el navegador está trabajando en línea.
+
{{domxref("Navigator.oscpu")}}
+
Devuelve una cadena de texto que representa al sistema operativo actual.
+
{{domxref("Navigator.permissions")}} {{readonlyinline}}{{experimental_inline}}
+
;
+
Devuelve un objeto {{domxref("Permissions")}} que puede ser usado para consultar y actualizar estatus de permisos de las APIs, acorde a la API Permissions.
+
{{domxref("NavigatorID.platform")}} {{readonlyInline}}{{experimental_inline}}
+
Devuelve una cadena de texto que representa la plataforma del navegador. No confíe en que esta función devuelva un valor significativo.
+
{{domxref("NavigatorPlugins.plugins")}} {{readonlyInline}}{{experimental_inline}}
+
Devuelve un {{domxref("PluginArray")}} que enlista los plugins instalados en el navegador.
+
{{domxref("NavigatorID.product")}} {{readonlyInline}} {{experimental_inline}}
+
Siempre devuelve 'Gecko', en cualquier navegador. Esta propiedad es mantenido únicamente por razones de compatibilidad.
+
{{domxref("NavigatorID.userAgent")}} {{readonlyInline}}
+
Devuelve la cadena de agente usuario del navegador actual.
+
{{domxref("Navigator.serviceWorker")}} {{readonlyInline}}
+
Devuelve un objeto {{domxref("ServiceWorkerContainer")}}, el cual provee acceso a registro, eliminación, actualización y comunicación con los objetos {{domxref("ServiceWorker")}} para documentos asociados.
+
+ +

No Estándar

+ +
+

Dispositivos con Firefox OS añaden más propiedades no estándares. Puede consultarlas en el artículo de extensiones de Navigator de Firefox OS.

+
+ +
+
{{domxref("Navigator.buildID")}} {{non-standard_inline}}
+
Devuelve el identificador de la compilación del navegador(p.ej., "2006090803").
+
{{domxref("Navigator.cookieEnabled")}} {{non-standard_inline}}
+
Devuelve un booleano que indica si el navegador tiene activadas las cookies.
+
{{domxref("Navigator.credentials")}} {{non-standard_inline}}
+
Devuelve la interfaz {{domxref("CredentialsContainer")}}, la cual expone métodos para solicitar credenciales y notificar al agente usuario cuando ocurran eventos de interés, como inicios o cierres de sesión.
+
{{domxref("Navigator.doNotTrack")}} {{non-standard_inline}}
+
Reporta el valor de la preferencia do-not-track. Cuando su valor es positivo ("yes", "1"), el sitio o aplicación web no debe rastrear al usuario.
+
{{domxref("Navigator.id")}} {{non-standard_inline}}
+
Devuelve el objeto {{domxref("window.navigator.id", "id")}}, el cual se puede usar para añadir soporte a BrowserID en el sitio web.
+
{{domxref("Navigator.mediaDevices")}} {{non-standard_inline}}
+
Devuelve una referencia a la interfaz {{domxref("MediaDevices")}}.
+
{{domxref("Navigator.mozNotification")}} {{deprecated_inline("22")}} {{non-standard_inline}}
+ {{domxref("Navigator.webkitNotification")}}
+
Devuelve un objeto {{domxref("navigator.mozNotification", "notification")}} que puede ser usado para enviar notificaciones al usuario desde la aplicación web.
+
{{domxref("Navigator.mozSocial")}} {{non-standard_inline}}
+
El objeto devuelto por la propiedad navigator.mozSocial, está disponible en el panel de proveedor de medios sociales para proporcionar funcionalidad la que se necesite.
+
{{domxref("Navigator.presentation")}} {{non-standard_inline}}
+
Devuelve una referencia a la API {{domxref("Presentation")}}.
+
{{domxref("Navigator.productSub")}} {{non-standard_inline}}
+
Devuelve el número de compilación del navegador actual (p.ej., "20060909").
+
{{domxref("Navigator.securitypolicy")}} {{non-standard_inline}}
+
Devuelve una cadena de texto vacía. En Netscape 4.7x, devuelve "US & CA domestic policy" o "Export policy".
+
{{domxref("Navigator.standalone")}} {{non-standard_inline}}
+
Devuelve un booleano que indica si el navegador está ejecutándose en modo standalone. Disponible sólo para Safari de iOS de Apple.
+
{{domxref("Navigator.vendor")}} {{non-standard_inline}}
+
Devuelve el nombre del fabricante del navegador actual (p.ej., "Netscape6").
+
{{domxref("Navigator.vendorSub")}} {{non-standard_inline}}
+
Devuelve la versión de fabricante (p.ej. "6.1").
+
{{domxref("Navigator.webkitPointer")}} {{non-standard_inline}}
+
Devuelve un objeto PointerLock para la API Mouse Lock.
+
+ +

Métodos

+ +

No hereda ninguna propiedad, pero implementa las definidas en {{domxref("NavigatorID")}}, {{domxref("NavigatorContentUtils")}}, {{domxref("NavigatorUserMedia")}}, y {{domxref("NavigatorStorageUtils")}}.

+ +

Estándar

+ +
+
{{domxref("Navigator.getVRDisplays()")}} {{experimental_inline}}
+
Devuelve una promesa que se resuelve en un arreglo de objetos {{domxref("VRDisplay")}} que representan cualquier dispositivo VR conectado a la computadora que esté disponible.
+
{{domxref("Navigator.getUserMedia", "NavigatorUserMedia.getUserMedia()")}}
+
Después de solicitar permiso al usuario, devuelve el stream de audio o video asociado a la cámara o micrófono de la computadora local.
+
{{domxref("Navigator.registerContentHandler()")}}
+
Permite a los web sites registrarse como posibles controladores de un tipo MIME determinado.
+
{{domxref("Navigator.registerProtocolHandler()")}}
+
Permite a los sitios webs registrarse como posibles controladores de un protocolo determinado.
+
{{domxref("Navigator.requestMediaKeySystemAccess()")}} {{experimental_inline}}
+
Devuelve un objeto {{jsxref("Promise")}} para un objeto MediaKeySystemAccess.
+
{{domxref("Navigator.sendBeacon()")}}{{experimental_inline}}
+
Usado para transferir, de forma asíncrona, conjuntos pequeños de datos HTTP del agente usuario al servidor.
+
{{domxref("NavigatorID.taintEnabled()")}} {{deprecated_inline("1.7.8")}} {{obsolete_inline("9.0")}} {{experimental_inline}}
+
Devuelve false. Las funciones taint/untaint de JavaScript fueron desaprobadas en JavaScript 1.2.
+
{{domxref("Navigator.vibrate()")}} {{gecko_minversion_inline("11.0")}}
+
Causa vibración en el dispositivo que la soporta. No hace nada si el soporte para vibración no está disponible.
+
+ +

No Estándar

+ +
+

Dispositivos con Firefox OS añaden más métodos no estándares. Puede consultarlas en el artículo de extensiones de Navigator de Firefox OS.

+
+ +
+
{{domxref("Navigator.mozIsLocallyAvailable()")}} {{non-standard_inline}}
+
Permite al código verificar si el documento en una URI determinada está disponible sin usar la red.
+
{{domxref("Navigator.mozPay()")}} {{non-standard_inline}}
+
Permite pagos dentro de la aplicación.
+
diff --git a/files/es/web/api/navigator/mozsocial/index.html b/files/es/web/api/navigator/mozsocial/index.html new file mode 100644 index 0000000000..cf5dd808f8 --- /dev/null +++ b/files/es/web/api/navigator/mozsocial/index.html @@ -0,0 +1,48 @@ +--- +title: navigator.mozSocial +slug: Web/API/Navigator/mozSocial +translation_of: Archive/mozSocial +--- +

{{non-standard_header()}}

+

{{fx_minversion_header("17.0")}}

+

{{ ApiRef() }}

+

El objeto MozSocial , regresado por la propiedad navigator.mozSocial , esta disponible dentro del tablero del proveedor de medios de comunicación para proporcionar la funcionalidad que pueda necesitar.

+
+

Nota: Aunque mozilla espera enviar eventualmente este API para su  estandarización, aun no se ha hecho.

+
+

Atributos

+
+
+ {{domxref("MozSocial.isVisible")}}
+
+ Regresa un valor Booleano; el resultado es true si el contenido es visible, de otra manera es false.
+
+

Métodos

+
+
+ {{domxref("MozSocial.closePanel()")}}
+
+ Cierra el tablero flotante abierto actualmente.
+
+ {{domxref("MozSocial.getAttention()")}}
+
+ Realiza algunas acciones diseñadas para obtener la atención del usuario; el mismo comportamiento puede variar de plataforma a plataforma. Esto puede mostrar un efecto visual, reproducir una notificación audible, parpadear la pantalla, o utilizar alguna otra técnica.
+
+ {{ domxref("MozSocial.getWorker()") }}
+
+ Regresa una referencia al trabajador de servicios; una vez el  contenido tiene esta referencia, puede llamar a su método postMessage() para comunicarse con el servicio.
+
+ {{domxref("MozSocial.openChatWindow()")}}
+
+ Abre una ventana de chat que es anclada al pie de la ventana del navegador. Se espera que cada ventana de chat sea un chat singular, pero su funcionalidad va a variar dependiento del proveedor.
+
+ {{domxref("MozSocial.openPanel()")}}
+
+ Abre un tablero flotante adjunto a la barra lateral en una vertical dada para compensar. Esto puede ser, por ejemplo, utilizado para mostrar la conversación actual correspondiente a una notificación en la barra lateral.
+
+  
+
+ Vease Tambien
+
+ Social API
+
diff --git a/files/es/web/api/navigator/registerprotocolhandler/index.html b/files/es/web/api/navigator/registerprotocolhandler/index.html new file mode 100644 index 0000000000..a2a57f7ae3 --- /dev/null +++ b/files/es/web/api/navigator/registerprotocolhandler/index.html @@ -0,0 +1,33 @@ +--- +title: window.navigator.registerProtocolHandler +slug: Web/API/Navigator/registerProtocolHandler +tags: + - Firefox 3 + - Referencia_DOM_de_Gecko +translation_of: Web/API/Navigator/registerProtocolHandler +--- +

 

+

{{ ApiRef() }} {{ Fx_minversion_header(3) }}

+

Resumen

+

Permite que las páginas web se registren por si mismas como posibles manejadores para protocolos concretos.

+

Sintaxis

+
window.navigator.registerProtocolHandler(protocol,uri,title);
+
+ +

Ejemplo

+
navigator.registerProtocolHandler("mailto",
+                                 "https://mail.google.com/mail?view=cm&tf=0&to=%s",
+                                 "Google Mail");
+
+

Esto crea un nuevo manejador que permite a los enlaces de tipo "mailto:" dirigir al usuario a Google Mail, insertando la dirección de correo especificada en el enlace, en la URL.

+

Especificación

+

Especificado en el documento del WHATWG: Web Applications 1.0 working draft.

+

 

+

 

+
+  
+

{{ languages( { "en": "en/DOM/window.navigator.registerProtocolHandler", "fr": "fr/DOM/window.navigator.registerProtocolHandler", "ja": "ja/DOM/window.navigator.registerProtocolHandler", "ko": "ko/DOM/window.navigator.registerProtocolHandler", "pl": "pl/DOM/window.navigator.registerProtocolHandler" } ) }}

diff --git a/files/es/web/api/navigator/registerprotocolhandler/web-based_protocol_handlers/index.html b/files/es/web/api/navigator/registerprotocolhandler/web-based_protocol_handlers/index.html new file mode 100644 index 0000000000..2f72c52dc9 --- /dev/null +++ b/files/es/web/api/navigator/registerprotocolhandler/web-based_protocol_handlers/index.html @@ -0,0 +1,132 @@ +--- +title: Controladores de protocolos basados en web +slug: Web/API/Navigator/registerProtocolHandler/Web-based_protocol_handlers +tags: + - Avanzado + - Controladores de Protocolos Basados en Web + - HTML5 +translation_of: Web/API/Navigator/registerProtocolHandler/Web-based_protocol_handlers +--- +
{{Fx_minversion_header(3)}}
+ +

Antecedentes

+ +

Es bastante común encontrar enlaces de páginas web a recursos que no usan protocolos http. Un ejemplo es el protocolo mailto::

+ +
+
<a href="mailto:webmaster@example.com">Web Master</a>
+
+ +

Los autores de la Web pueden usar un enlace mailto: cuando quieren proporcionar una forma conveniente para que los usuarios envién un correo electrónico, directamente desde la página web. Cuando el enlace está activo, el navegador debería lanzar la aplicación de escritorio predeterminada para gestionar correos electrónicos. Se puede pensar en esto como un controlador de protocolos basados en escritorio.

+ +

Los controladores de protocolos basados en web permiten a las aplicaciones basadas en web participar en el proceso también. Esto es cada vez más importante a medida que más tipos de aplicaciones migren a la web. De hecho, hay muchas aplicaciones basadas en web que gestionan correo electrónicos podrían procesar un enlace mailto.

+ +

Registro

+ +

Configurar una aplicación web como un controlador de protocolo no es un proceso difícil. Básicamente la aplicación web usa registerProtocolHandler() para registrarse a sí mismo con el navegador como un controlador potencial para un protocolo dado. Por ejemplo:

+ +
navigator.registerProtocolHandler("burger",
+                                  "http://www.google.co.uk/?uri=%s",
+                                  "Burger handler");
+ +

En donde los parámetros son:

+ + + +

Cuando un navegador ejecuta este código, se le mostrará un mensaje al usuario, pidiendo permiso para permitir a la aplicación web registrase como controlador para el protocolo. Firefox muestra un mensaje en el área de la barra de notificaciones:

+ +

+ +
Nota: La plantila de la URL proporcionada al registrar debe ser del mismo dominio que el de la página que intenta realizar el registro o el registro fallará. Por ejemplo, http://example.com/homepage.html puede registrar un controlador de protocolo para http://example.com/handle_mailto/%s, pero no para http://example.org/handle_mailto/%s.
+ +

Al registrar el mismo controlador de protocolo más de una vez aparecerá una notifiación diferente, indicando que el controlador del protocolo ya ha está registrado. Por lo tanto, es una buena idea cuidar el registro del controlador de protocolo con una verificación para saber si ya está registrado, como con el siguiente ejemplo.

+ +

Ejemplo

+ +
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
+<html lang="en">
+<head>
+  <title>Ejemplo de Controlador de Protocolo Web - Registro</title>
+  <script type="text/javascript">
+    navigator.registerProtocolHandler("burger",
+                                  "http://www.google.co.uk/?uri=%s",
+                                  "Burger handler");
+  </script>
+</head>
+<body>
+  <h1>Ejemplo de Controlador de Protocolo Web</h1>
+  <p>Esta página web instalará un controlador de protocolo web para el protocolo <code>burger:</code>.</p>
+</body>
+</html>
+
+ +

Activando

+ +

Ahora, cada vez que el usuario active un enlace que usa el protocolo registrado, el navegador enrutará la acción a la URL suministrada cuando la aplicación web se haya registrado. Firefox, de manera predeterminada, alertará al usaurio antes de controlar la acción.

+ +

Ejemplo

+ +
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
+<html lang="en">
+<head>
+  <title>Ejemplo de Controlador de Protocolo Web - Prueba</title>
+</head>
+<body>
+  <p>Oye ¿Has visto <a href="burger:cheeseburger">esto</a> antes?</p>
+</body>
+</html>
+
+ +

Controlando

+ +

La siguiente fase es controlar la acción. El navgador extrae el href desde el enlace activado, lo combina con la plantilla de la URL suministrada durante el registro del controlador y realzia una petición HTTP GET sobre la URL. Luego, usando los ejemplos anteriores, el navegador realizará una petición GET sobre esta URL:

+ +
http://www.google.co.uk/?uri=burger:cheeseburger
+
+ +

El código del lado del servidor puede extraer los parámetros de la cadena de petición y realizar la acción deseada.

+ +
Nota: Al código del lado del servidor se le pasa todo el contenido del href.  Esto significa que el código del lado del servidor tendrá que analizar el protocolo desde los datos.
+ +

Example

+ +
<?php
+$value = "";
+if ( isset ( $_GET["value"] ) ) {
+  $value = $_GET["value"];
+}
+?>
+
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <title>Ejemplo de Controlador de Protocolo Web</title>
+</head>
+<body>
+  <h1>Ejemplo de Controlador de Protocolo Web - Controlador</h1>
+  <p>Esta página es llamada al controlar una acción del protocolo <code>burger:</code>. Datos enviados:</p>
+  <textarea>
+<?php echo(htmlspecialchars($value, ENT_QUOTES, 'UTF-8')); ?>
+  </textarea>
+</body>
+</html>
+
+ +

Referencias

+ + + +

Véase también

+ + diff --git a/files/es/web/api/navigator/vibrate/index.html b/files/es/web/api/navigator/vibrate/index.html new file mode 100644 index 0000000000..39969f4cfc --- /dev/null +++ b/files/es/web/api/navigator/vibrate/index.html @@ -0,0 +1,82 @@ +--- +title: window.navigator.vibrate +slug: Web/API/Navigator/vibrate +translation_of: Web/API/Navigator/vibrate +--- +
+ {{ApiRef}}{{SeeCompatTable}}
+

Resumen

+

Ejecuta la vibración por hardware en el dispositivo, si existe dicho hardware. Si el dispositivo no soporta vibración, este método no tendrá efecto. Si un patrón de vibración ya estaba en progreso cuando este método es ejecutado, el patrón anterior se detiene y en su lugar se iniciará el último patrón ejecutado.

+

Sintaxis

+
window.navigator.vibrate(pattern);
+
+ +
+
+ pattern
+
+ Proporciona un patrón de intervalos de vibraciones y pausas. Cada valor indica el número de milisegundos que durará la vibración y la pausa, respectivamente. Se puede porporcionar un valor único (en cuyo caso la vibración se ejecutará una vez, con la duración especificada en milisegundos) o un arreglo de valores (array) para alternar vibraciones y pausas. Ver Vibration API para más detalles.
+
+

Si se especifica el valor 0, un array vacío o un array que contenga todos los valores en 0, se cancelarán todos los patrones de vibración que se estén ejecutando.

+

Excepciones

+

Podrá producirse una excepción si el patrón de vibración especificado es demasiado largo o si cualquiera de sus elementos son demasiado grandes.

+

Compatibilidad con navegadores

+
+ {{CompatibilityTable}}
+
+ + + + + + + + + + + + + + + + + + + +
CaracterísticaChromeFirefox (Gecko)Internet ExplorerOperaSafari
Soporte básico{{CompatVersionUnknown}} {{property_prefix("webkit")}} +

11.0 {{property_prefix("moz")}}

+

16 (no prefix)

+ 		{{CompatNo}}{{CompatNo}}{{CompatNo}}
+
+
+ + + + + + + + + + + + + + + + + + + +
CaracterísticaAndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Soporte básico{{CompatVersionUnknown}} {{property_prefix("webkit")}}11.0 {{property_prefix("moz")}}{{CompatNo}}{{CompatNo}}{{CompatNo}}
+
+

Especificación

+ +

Véase también

+ -- cgit v1.2.3-54-g00ecf