diff options
Diffstat (limited to 'files/es/social_api')
| -rw-r--r-- | files/es/social_api/glossary/index.html | 53 | ||||
| -rw-r--r-- | files/es/social_api/guide/index.html | 32 | ||||
| -rw-r--r-- | files/es/social_api/index.html | 65 | ||||
| -rw-r--r-- | files/es/social_api/manifiesto/index.html | 38 | ||||
| -rw-r--r-- | files/es/social_api/service_worker_api_reference/index.html | 377 | ||||
| -rw-r--r-- | files/es/social_api/widgets/index.html | 16 |
6 files changed, 0 insertions, 581 deletions
diff --git a/files/es/social_api/glossary/index.html b/files/es/social_api/glossary/index.html deleted file mode 100644 index a92cdda06a..0000000000 --- a/files/es/social_api/glossary/index.html +++ /dev/null @@ -1,53 +0,0 @@ ---- -title: Glosario de Social API -slug: Social_API/Glossary -tags: - - Social -translation_of: Archive/Social_API/Glossary ---- -<div class="note"> - <p><strong>Note:</strong> Hay algunos puntos destacados donde los enlaces hacia otros documentos necesitan ser añadidos cuando estos sean escritos.</p> -</div> -<p>Para hacer uso de Social API (si estás escribiendo un nuevo proveedor de servicios sociales o trabajando con un proveedor ya existente), hay un número de términos que necesitas saber. ¡Este glosario te ayudará!</p> -<dl> - <dt> - Notificación Cliente-a-usuario (Client-to-user notification)</dt> - <dd> - La notificación Cliente-a-usuario es la API (interfaz de programación de aplicaciones) que se pone a disposición a un worker del servicio (service worker) para indicar que los datos y las interacciones están pendientes para el usuario en el dispositivo en particular, y que el servicio está listo para proporcionarlas. Sujeto a la configuración del navegador, estas notificaciones pueden ser utilizadas para lanzar una variedad de elementos de interfaz para llamar la atención, incluyendo ventanas temporales de estilo "toast" o "Growl", notificaciones ambientales (por ejemplo brillos, saltos, pulsaciones), o colecciones (por ejemplo paneles desplegables de notificación, listas de eventos pendientes). Estas notificaciones son construidas para permitir al service worker recibir notificaciones cuando el usuario indica interés en una de ellas, permitiendo la presentación de datos o interacción para proceder inmediatamente.</dd> - <dt> - Panel (Panel)</dt> - <dd> - Una región del interfaz de usuario (generalmente rectangular) que se muestra temporalmente por encima del contenido y de la interfaz del navegador; estos son usados para interacciones breves que son iniciadas por el usuario o que son muy importantes</dd> - <dt> - Recomendar (Recommend)</dt> - <dd> - El acto iniciado por el usuario de indicar que una pieza de contenido web (generalmente una URL) debe marcarse de interés para el usuario. No se espera una entrada distinta a una URL. Una recomendación puede ser completada sin widget; no tiene más interfaz de usuario que el botón, barra de menú o comando que indica "recomienda esto".</dd> - <dt> - Notificación servidor-a-cliente (Server-to-client notification)</dt> - <dd> - La notificación de servidor a cliente es un sistema por el cual un servicio Server-to-client notification dispone de notificaciones para ser enviadas de manera rápida y eficaz a un cliente. No es una característica de esta propuesta, aunque las técnicas web existentes incluyendo <a href="/en-US/docs/WebSockets" title="/en-US/docs/WebSockets">WebSockets</a>, <a href="/en-US/docs/Server-sent_events" title="/en-US/docs/Server-sent_events">Server-sent events</a>, <code><a href="/en-US/docs/DOM/XMLHttpRequest" title="/en-US/docs/DOM/XMLHttpRequest">XMLHttpRequest</a></code> con sondeo largo, long polling (o infrequently quick polling) pueden ser todas usadas para workers de servicio (service workers). Se espera que un worker de servicio que recibe una notificación servidor-a-cliente retransmitirá a menudo estos datos en una notificación cliente-a-usuario.</dd> - <dt> - Mensaje de servicio (Service message)</dt> - <dd> - Un mensaje es una cadena de texto codificada en <a href="/en-US/docs/JSON" title="/en-US/docs/JSON">JSON</a> que es enviada por el navegador por el worker de servicio, o es enviada por el worker del servicio al navegador. Estos mensajes son usados para coordinar la visualización de elementos de usuario manejados por el navegador y responder a las interacciones de usuario y contenido. Véase <span style="color: #ffff00;"><span style="background-color: rgb(255, 0, 0);">Serialización de mensajes</span></span> para detalles de codificación.</dd> - <dt> - Worker de servicio (Service worker)</dt> - <dd> - Un ambiente de cálculo ejecutando durante mucho tiempo un JavaScript, manejado por el navegador y servido por una dirección web específica de usuario, que actúa como un eje o hub de coordinación y comunicación entre el navegador y un servicio web.</dd> - <dt> - Compartir (Share)</dt> - <dd> - El acto, iniciado por el usuario, de enviar una parte de contenido web (normalmente una URL) con un comentario opcional, explicación u otros datos a la dirección del usuario, lista de direcciones de usuario, red social u otro destino. Los detalles de la iteración son específicos para cada servicio y se requiere un <span style="color: #ffff00;"><code><span style="background-color: rgb(255, 0, 0);">ShareWidget</span></code></span> para representar la interfaz de usuario que complete el intercambio.</dd> - <dt> - Barra lateral (Sidebar)</dt> - <dd> - Un rectángulo vertical de espacio de pantalla, posicionado al lado del contenido normal del navegador en una ventana de navegación con pestañas, que es estable a lo largo de la navegación y a cambios de foco entre pestañas. Una barra lateral puede ser minimizada, lo que causa que sea mostrada enteramente en el espacio "por encima del contenido / no superpuesto sobre el contenido".</dd> - <dt> - Proveedor de servicio social (Social service provider)</dt> - <dd> - Un servicio web que proporciona una o más APIs al navegador para habilitar características sociales. Es definida en el navegador por un archivo estructurado de texto, que le dice al navegador cómo cargar recursos de JavaScript y HTML que trae sus funciones al navegador.</dd> - <dt> - Widget (Widget)</dt> - <dd> - Un elemento de interfaz de usuario, creado por el navegador, que proporciona una región visual para el contenido producido por el proveedor de servicio.</dd> -</dl> diff --git a/files/es/social_api/guide/index.html b/files/es/social_api/guide/index.html deleted file mode 100644 index 72655a87c5..0000000000 --- a/files/es/social_api/guide/index.html +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: Guía social API -slug: Social_API/Guide -translation_of: Archive/Social_API/Guide ---- -<p> </p> -<p></p><div class="overheadIndicator draft"> - <p><strong>Borrador</strong><br> - Esta página no está completa.</p> - -</div><p></p> -<p>Este artículo describe el ciclo de vida de un social service worker, como el servicio social permite al navegador interactuar con un sitio de redes sociales y asi sucesivamente.</p> -<h2 id="Ciclo_de_vida_de_un_social_service_worker">Ciclo de vida de un social service worker</h2> -<p>Un proveedor de servicios sociales esta definido por un archivo de texto estructurado (JSON) incluyendo un número de URLs con llave, un nombre y un icono. Los URLs poseen el mismo orígen que el archivo JSON si es cargado remotamente.</p> -<p>Un social service worker es instanciado del URL de dicho service worker provisto por el proveedor de servicios; este URL debe resolver a un archivo JavaScript que es evaluado por el trabajador de servicios. El worker es un worker compartido, renderizado "no comprable" en un estilo muy similar a la especificación de los Trabajadores Web ( aunque debe tomarse en cuenta que la implementación actual no es, de hecho, un <a href="/es/docs/Web/API/Worker" title="The Worker interface of the Web Workers API represents a background task that can be easily created and can send messages back to its creator. Creating a worker is as simple as calling the Worker() constructor and specifying a script to be run in the worker thread."><code>Worker</code></a>).</p> -<p>El service worker permanece con vida hasta finalizar, ya sea por cierre de navegador o por un comando de control explícito del usuario.</p> -<p>Si el navegador determina que la finalización del service worker es necesaria, todos los contenidos del servicio-nivel asociados con el service worker es descargado ( esto significa, que todos los <span style="color: rgb(255, 255, 0);"><code style="font-size: 14px;"><span style="background-color: rgb(255, 0, 0);">ServiceWindow</span></code></span>s y barras laterales seran cerrados) como parte de la finalización.</p> -<p>Si el navegador se inicia ( o se reinicia) el servicio durante una sesión de usuario normal, el service worker es primero completamente cargado, y las barras laterales son instanciadas en ventanas existentes. Los <span style="color: rgb(255, 255, 0);"><code style="font-size: 14px;"><span style="background-color: rgb(255, 0, 0);">ServiceWindow</span></code></span>s (como los chats) no son reiniciados automáticamente.</p> -<h2 id="Flujo_de_implementación">Flujo de implementación</h2> -<p>Esta sección ilustra como el social service comenzó, como se comunica con el sitio de redes sociales, y se finaliza.</p> -<p><<<añada un diagrama actual>>></p> -<ol> - <li>El servicio es registrado con un servicio, widget de barra lateral y widget para compartir.</li> - <li>En el momento de inicio del navegador, el trabajador de servicio es instanciado.</li> - <li>El servicio abre un conexión a su servicio, si una sesión de usuario esta disponible, y empieza a recibir eventos de inserción.</li> - <li>Cuando una ventana del navegador es creada, el contenido del widget de la barra lateral es instanciado.</li> - <li>La barra lateral se registra con el servicio usando <code style="font-size: 14px;">mozSocial.getWorker().postMessage("hello")</code>.</li> - <li>El trabajador de servicios captura el mensaje "hello" y añade la <code style="font-size: 14px;">sidebarContentWindow</code> a una lista de recepción de eventos.</li> - <li>El contenido de la barra lateral podrá entonces realizar una conformidad de conexiónes publicar-suscribir más elaboradas, para limitar que eventos este recibe.</li> - <li>Cuando el servicio recibe eventos del servidor (o de otro contenido), invoca <a href="/es/docs/Web/API/Window/postMessage" title="La documentación acerca de este tema no ha sido escrita todavía . ¡Por favor considera contribuir !"><code>window.postMessage()</code></a> en cada referencia de ventana que fue previamente guardada. La barra lateral se regenera segun sea necesario.</li> - <li>Si el usuario hace click en la barra lateral para, por ejemplo, abrir una ventana de chat, <a href="/es/docs/Web/API/Window/open" title="Carga un recurso en el contexto de un nuevo navegador (como una ventana) o uno que ya existe, dependiendo de los parametros."><code>window.open()</code></a> se hace la llamada y una nueva ventana es creada. La ventana de chat se registra con el servicio utilizaando <code style="font-size: 14px;">mozSocial.getWorker().postMessage("hello")</code> y recibe un mensaje de vuelta indicandole con quien abrir un chat. El servicio puede entregar eventos servidor-inserción a la ventana de chat, tal vez a través de un sistema publicar-suscribir.</li> -</ol> diff --git a/files/es/social_api/index.html b/files/es/social_api/index.html deleted file mode 100644 index 087ca43479..0000000000 --- a/files/es/social_api/index.html +++ /dev/null @@ -1,65 +0,0 @@ ---- -title: Social API -slug: Social_API -tags: - - Social -translation_of: Archive/Social_API ---- -<p>Social API es una nueva API para facilitar a los navegadores web integrarse con los servicios de redes sociales. Una vez que una red social es implementada por Firefox, permite que el navegador incorpore controles e información del usuario en ese servicio. Los siguientes artículos explican cómo implementar un proveedor de servicios sociales.</p> -<div class="note"> - <p><strong>Nota:</strong> Mucho del contenido de las subpáginas que se encuentra aquí ha sido escrito pero aún no se ha migrado a este directorio: temporalmente puedes <a href="/en-US/docs/User:Sheppy/Social_API_temp" title="https://developer.mozilla.org/es/docs/User:Sheppy/Social_API_temp">encontrarlos aquí</a>.</p> -</div> -<div class="row topic-page"> - <div class="section"> - <h2 class="Documentation" id="Documentación_de_Social_API">Documentación de Social API</h2> - <dl> - <dt> - <a href="/es/docs/Social_API/Glossary" title="/es/docs/Social_API/Glossary">Glosario de Social API</a></dt> - <dd> - Provee definiciones de los términos principales que necesitaras entender cuando estés usando Social API.</dd> - <dt> - <a href="/es/docs/Social_API/Guide" title="/es/docs/Social_API/Guide">Social API y guía del servicio social.</a></dt> - <dd> - Una introducción y guía a Social API y los servicios asociados.</dd> - <dt> - <a href="/es/docs/Social_API/Manifest" title="/es/docs/Social_API/Manifest">Archivo manifest del servicio social</a></dt> - <dd> - Una descripción de—y una guía para construir— el archivo Manifest requerido.</dd> - <dt> - <a href="/es/docs/Social_API/Service_worker_API_reference" title="/es/docs/Social_API/Service_worker_reference">Referencia de la API del social service worker</a></dt> - <dd> - Una referencia a la API del social service worker.</dd> - <dt> - <a href="/es/docs/DOM/navigator.mozSocial" title="/es/docs/DOM/navigator.mozSocial">Contenido de la API del servicio social: MozSocial</a></dt> - <dd> - Una referencia al contenido de la API del servicio social que es proporcionada por el objeto <a href="/es/docs/Web/API/Navigator/MozSocial" title="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."><code>navigator.MozSocial</code></a>.</dd> - <dt> - <a href="/es/docs/Social_API/Widgets" title="/es/docs/Social_API/Widgets">Widgets del servicio social</a></dt> - <dd> - Una guía de los widgets proporcionados por el servicio social.</dd> - <dt> - <a href="/es/docs/Social_API/Implementing_chat_functionality" title="/es/docs/Social_API/Implementing_chat_functionality">Implementación de la funcionalidad de chat</a></dt> - <dd> - Una guía para implementar las características de chat usando Social API.</dd> - </dl> - <p><span class="alllinks"><a href="/es/docs/tag/Social" title="/es/docs/tag/CSS">Ver todos...</a></span></p> - </div> - <div class="section"> - <h2 class="Community" id="Community" name="Community">Obtener ayuda de la comunidad</h2> - <p>Necesitas ayuda con un problema relacionado con Social API y no puedes encontrar la solución en la documentación?</p> - <ul> - <li>Haz tu pregunta en el canal IRC de Mozilla: <a href="irc://irc.mozilla.org/socialdev" title="irc://irc.mozilla.org/socialdev">#socialdev</a></li> - </ul> - <p><span class="alllinks"><a class="external" href="http://www.catb.org/~esr/faqs/smart-questions.html" title="http://www.catb.org/~esr/faqs/smart-questions.html">No te olvides de la <em>netiquette</em>...</a></span></p> - <h2 class="Tools" id="Tools" name="Tools">Herramientas y demostraciones</h2> - <ul> - <li><a href="https://github.com/mixedpuppy/socialapi-demo" title="https://github.com/mixedpuppy/socialapi-demo">Un ejemplo de un proveedor de servicio social en github</a>.</li> - </ul> - <p><span class="alllinks"><a href="/es/docs/tag/Social" title="/es/docs/tag/CSS:Tools">Ver todos...</a></span></p> - <h2 class="Related_Topics" id="Related_Topics" name="Related_Topics">Temas relacionados</h2> - <ul> - <li><a href="/es/docs/Aplicaciones" title="/es/docs/Apps">Aplicaciones para la web abierta</a></li> - </ul> - </div> -</div> -<p> </p> diff --git a/files/es/social_api/manifiesto/index.html b/files/es/social_api/manifiesto/index.html deleted file mode 100644 index 5602e901e6..0000000000 --- a/files/es/social_api/manifiesto/index.html +++ /dev/null @@ -1,38 +0,0 @@ ---- -title: Manifiesto del servicio social -slug: Social_API/Manifiesto -translation_of: Archive/Social_API/Manifest ---- -<p><span class="short_text" id="result_box" lang="es"><span class="hps">Un</span> <span class="hps">manifiesto del servicio</span> <span class="hps">social es un</span></span> archivo <a href="/en-US/docs/JSON" title="/en-US/docs/JSON">JSON</a> <span id="result_box" lang="es"><span class="hps">que describe</span> <span class="hps">al navegador</span> <span class="hps">cómo</span> <span class="hps">crear instancias de un </span></span><a href="/en-US/docs/Social_API/Glossary#Service_worker" title="/en-US/docs//Social_API/Glossary#Service_worker">service worker</a> para un <a href="/en-US/docs/Social_API/Glossary#Social_service_provider" title="/en-US/docs//Social_API/Glossary#Social_service_provider">service provider</a>.</p> -<h2 id="Contenido">Contenido</h2> -<p><span id="result_box" lang="es"><span class="hps">Como mínimo,</span> <span class="hps">un</span> <span class="hps alt-edited">manifiesto del servicio</span> <span class="hps">social debe</span> <span class="hps">contener</span> <span class="hps">una</span> <span class="hps">propiedad </span><code><span class="hps">services</span></code></span>, de tipo objeto, <span lang="es"><span class="hps">que contiene a su vez una</span> <span class="hps">propiedad </span><span class="hps"><code>social</code></span></span>, también de tipo objeto<span lang="es"><span class="hps">.</span> <span class="hps">El objeto</span> <span class="hps"><code>social</code> debe</span> <span class="hps">contener</span> <span class="hps">las siguientes propiedades:</span></span></p> -<dl> - <dt id="name_property"> - name</dt> - <dd> - El nombre del servicio</dd> - <dt id="iconURL"> - iconURL</dt> - <dd> - <span id="result_box" lang="es"><span class="hps">La dirección URL</span> <span class="hps">de</span>l ícono que usará el<span class="hps"> servicio</span> <span class="hps">en</span> <span class="hps">la interfaz de usuario</span><span>.</span></span></dd> - <dt id="workerURL"> - workerURL</dt> - <dd> - <span id="result_box" lang="es"><span class="hps">La dirección URL</span> <span class="hps">de un archivo</span> <span class="hps">JavaScript que</span> <span class="hps">define el</span> </span><em>social service worker</em><span id="result_box" lang="es"> <span class="hps">para el servicio.</span></span></dd> - <dt id="sidebarURL"> - sidebarURL</dt> - <dd> - <span id="result_box" lang="es"><span class="hps">La dirección URL</span> <span class="hps">de un</span></span> <span id="result_box" lang="es"><span class="hps">archivo </span></span>HTML que define la <span class="short_text" id="result_box" lang="es"><a href="https://developer.mozilla.org/en-US/docs/Social_API/Glossary#Sidebar" title="https://developer.mozilla.org/en-US/docs/Social_API/Glossary#Sidebar"><span class="hps">barra lateral</span></a> <span class="hps">que utiliza el servicio</span>.</span></dd> -</dl> -<h2 id="Ejemplo">Ejemplo</h2> -<pre class="brush:js;">{ - "services": { - "social": { - "name": "<span class="short_text" id="result_box" lang="es"><span class="hps">Ejemplo</span> <span class="hps">de Servicio Social</span></span>", - "iconURL": "/icon.png", - "workerURL": "/worker.js", - "sidebarURL": "/sidebar.htm", - } - } -}</pre> -<p> </p> diff --git a/files/es/social_api/service_worker_api_reference/index.html b/files/es/social_api/service_worker_api_reference/index.html deleted file mode 100644 index 9ce93f64b8..0000000000 --- a/files/es/social_api/service_worker_api_reference/index.html +++ /dev/null @@ -1,377 +0,0 @@ ---- -title: Service worker API reference -slug: Social_API/Service_worker_API_reference -translation_of: Archive/Social_API/Service_worker_API_reference ---- -<p></p><div class="overheadIndicator nonStandard nonStandardHeader"> - <p><strong><span title="This API has not been standardized."><i class="icon-warning-sign"> </i></span> No estándar</strong><br> - This feature is non-standard and is not on a standards track. Do not use it on production sites facing the Web: it will not work for every user. There may also be large incompatibilities between implementations and the behavior may change in the future.</p> - </div><p></p> - -<p></p> - -<h3 id="service_Worker_de_Servicio_de_Referencia">service Worker de Servicio de Referencia</h3> - -<p><span id="result_box" lang="es"><span class="hps">Un</span> <span class="hps">service Worker</span> <span class="hps">hereda todas las</span> <span class="hps">limitaciones</span> <span class="hps">y los comportamientos</span> <span class="hps">disponibles para</span> service Workeres Compartidos de <span class="hps">HTML5.</span></span> Puede crear XMLHttpRequests, usar WebSockets, recibir mensajes de ventanas y del navegador, usar IndexedDB, y publicar mensajes a otras ventanas.</p> - -<p>El service Worker puede usar los métodos <code>ononline</code>, <code>onoffline</code>, y <code>navigator.online</code> y las propiedades que están disponibles para todos los service Workeres para obtener una notificación del estado online/offline de los navegadores.</p> - -<p>Además de los métodos estándar, los Service Wokers tienen acceso a funciones adicionales, todas las cuales están implementadas usando mensajes enviados y recibidos por un service Worker "puertos de mensaje". Así como los puertos de mensaje <span class="short_text" id="result_box" lang="es"><span class="hps">son</span> <span class="hps">inherentemente</span> <span class="hps">asíncronos</span></span>, cualquier mensaje que necesite una respuesta involucrará dos mensajes - uno para la pregunta y otro para la respuesta. No todos los mensajes requieren respuesta - esto es parte de la especificación del mensaje. Los mensajes que no requieran una respuesta son análogos a un 'evento' no solicitado. Si un mensaje sí requiere una respuesta, entonces la respuesta siempre deberá ser enviada en el mismo puerto de la petición y en general, el 'asunto' de la respuesta será el asunto de la petición con "-respuesta" concatenado.</p> - -<p>Se espera que los service Workeres de Servicio provean una función en un ámbito global, nombrado <code>onconnect</code>. El navegador invocará <code>onconnect</code> durante la fase de arranque,pasando un evento. El service Worker debería acceder a la propiedad <code>ports</code> de este evento para extraer una comunicación estable hacia el puerto del navegador, y persiste por el ciclo de vida del service Worker, como esto:</p> - -<pre><code>var apiPort; -var ports = []; -onconnect = function(e) { - var port = e.ports[0]; - ports.push(port); - port.onmessage = function (msgEvent) - { - var msg = msgEvent.data; - if (msg.topic == "social.port-closing") { - if (port == apiPort) { - apiPort.close(); - apiPort = null; - } - return; - } - if (msg.topic == "social.initialize") { - apiPort = port; - initializeAmbientNotifications(); - } - } -} - -// send a message to all provider content -function broadcast(topic, data) { - for (var i = 0; i < ports.length; i++) { - ports[i].postMessage({topic: topic, data: data}); - } -} -</code></pre> - -<p>Cada mensaje tiene un elemento con 2 campos: 'topic' y 'data'. El <em>topic</em> identifica el método o evento que es utilizado, y el <em>data</em> especifica datos adicionales únicos al topic. Todos los métodos estandarizados y eventos tienen topics que comienzan con "social." - esto significa que los servicios son libres de usar topics sin este prefijo como un detalle de implementación privada (por ejemplo, para comunicar algún contenido de un servicio a un service Worker de servicio).</p> - -<h3 id="Serialización_de_mensajes">Serialización de mensajes</h3> - -<p>Para un mensaje con el asunto <code>topic</code> y los argumentos (arg1:val1, arg2:val2), construye un objeto como:</p> - -<pre><code>{ topic: topic, data: { arg1: val1, arg2: val2 } } -</code></pre> - -<h3 id="Mensajes_de_Control_enviados_a_service_Workeres_de_servicios">Mensajes de Control enviados a service Workeres de servicios</h3> - -<h4 id="social.initialize"><code>social.initialize</code></h4> - -<p>Enviados por el navegador durante el arranque. Cuando el JavaScript de un service Worker ha sido cargado con éxito y evaluado, el navegador enviará un mensaje con este asunto. Cuando el service Worker recibe el <code>social.initalize event</code>, debería enviar ambos, el <code>social.user-profile</code> y, si los Mrcadores de Página son soportados [como en Fx23], el <code>mensaje desocial.page-mark-config</code>.</p> - -<h4 id="social.port-closing"><code>social.port-closing</code></h4> - -<p>Enviado por el navegador durante el apagado del service Worker, cuando un PuertodeMensaje para el service Worker está a punto de ser cerrado. Este será el último mensaje que el service Worker recibirá en el puerto.</p> - -<h3 id="Mensajes_de_Control_enviados_desde_el_service_Worker_de_Servicio_al_navegador">Mensajes de Control enviados desde el service Worker de Servicio al navegador</h3> - -<h4 id="social.reload-worker"><code>social.reload-worker</code></h4> - -<p>Enviado por el service Worker para solicitar al navegador que re-cargue al service Worker.</p> - -<h4 id="social.cookies-get"><code>social.cookies-get</code></h4> - -<p>Enviado por el service Worker para solicitar al navagador que responda con una lista del mismo origen de las <em>cookies</em> para el proveedor. El navegador responderá con un mensaje <code>social.cookies-get-response</code>.</p> - -<h4 id="social.request-chat"><code>social.request-chat</code></h4> - -<p>Enviado por el service Worker para solicitar al navagador que abra un nuevo panel de chat flotante con la URL especificada. La ventana de chat abierta por el service Worker será abierta en un modo minimizado.</p> - -<p><em>Argumentos:</em></p> - -<p><strong>URL</strong></p> - -<blockquote> -<p>Cadena, requerida. La URL de la página de chat para abrir en la ventana.</p> -</blockquote> - -<h3 id="Control_de_Notificación_de_Ambiente">Control de Notificación de Ambiente</h3> - -<h4 id="social.user-profile"><code>social.user-profile</code></h4> - -<p>Enviada por el service Worker, para establecer las propiedades para el proveedor de icónico de perfil de usuario de datos usado para el botón de la barra. Si el retrato de usuario y userName no se encuentran, el botón de IU indicará el estado de no-logueado. Cuando esté indicando un estado de no-logueado, los íconos de estado establecidos vía <code>social.ambient-notification</code> serán removidos. Un servicio que no maneja el <em>loguéo</em> de usuarios deberá enviar este mensaje con los alores apropiados para el sitio, como lo son el ícono del sitio, URL principal y el nombre de la marca.</p> - -<p><em>Argumentos:</em></p> - -<p><strong>iconURL</strong></p> - -<blockquote> -<p>Cadena, requerida. Si es sumistrada, especifíca la URL hacia una imagen 16x16 pixeles usada por el ícono de estado. El iconURL puede ser una URL de datos con una imagen codificada para evitar solicitudes a los http (ejemplo: "data:image/png;base64,...data...").</p> -</blockquote> - -<p><strong>portrait</strong></p> - -<blockquote> -<p>Cadena, opcional. Si es suministrada, especifíca la URL hacia una imagen de 48x48 pixeles del usuario. El retrato puede ser una URL de datos con una imagen codificada para evitar solicitudes a los http.</p> -</blockquote> - -<p><strong>userName</strong></p> - -<blockquote> -<p>Cadena, opcional. El nombre de la cuenta mostrado con el retrato en el menú de proveedor.</p> -</blockquote> - -<p><strong>dispayName</strong></p> - -<blockquote> -<p>Cadena, requerido. Nombre real del usuario usado para propósitos de visualización en varios elementos de IU.</p> -</blockquote> - -<p><strong>profileURL</strong></p> - -<blockquote> -<p>Cadena, requerido. URL a la página de perfil de un usuario logueado. Este será abierto en una pestaña normal del navegador cuando el nombre de usuario es cliqueado.</p> -</blockquote> - -<h4 id="social.ambient-notification"><code>social.ambient-notification</code></h4> - -<p>Enviado por el service Worker, para actualizar o crear un ambiente de íconos de notificaciones. Es enviado uno por cada ícono. Un usuario debe estar logueado para mostrar los íconos de estado, y deberás llamar a <code>social.user-profile</code> antes de llamar <code>social.ambient-notification</code> para establecer los íconos de estado.</p> - -<p><em>Argumentos:</em></p> - -<p><strong>name</strong></p> - -<blockquote> -<p>Cadena. Un identificador para el ícono. La primera vez que un nombre dado es mostrado, eficazmente crea un nuevo ícono. Si el mismo nombre es usado en llamadas sub-secuentes, el ícono existente es actualizado.</p> -</blockquote> - -<p><strong>iconURL</strong></p> - -<blockquote> -<p>Cadena, opcional. Si es suministrada, especifíca la URL hacia una imagen de 16x16 pixeles usada para el ícono de estado. El iconURL puede ser una URL con una imagen codificada para evitar solicitudes a los http (ejemplo: "data:image/png;base64,...data...")</p> -</blockquote> - -<p><strong>counter</strong></p> - -<blockquote> -<p>Número, opcional. Especifíca un númeroque será sobre-puesto sobre el ícono, típicamente usado para transmitir un concepto <code>unread</code>.</p> -</blockquote> - -<p><strong>contentPanel</strong></p> - -<blockquote> -<p>Cadena, opcional. Especifíca la URL de un contenido que será mostrado en el panel popup para el ícono.</p> -</blockquote> - -<h3 id="Control_de_Notificaciones_Activo">Control de Notificaciones Activo</h3> - -<h4 id="social.notification-create"><code>social.notification-create</code></h4> - -<p>Enviado por el service Worker, para crear y mostrar un objeto de notificación. Esto solicita que el navegador notifique al usuario de un relevante e inmediato cambio de estado. Ver <a href="https://developer.mozilla.org/en/DOM/navigator.mozNotification">https://developer.mozilla.org/en/DOM/navigator.mozNotification</a> para más detalles. Cuando el usuario cliquea en la notificación, el mensaje <code>social.notification-action</code> es enviado al service Worker. El título de la notificación siempre será el nombre del proveedor.</p> - -<p>NOTA: Queremos aumentar el objeto mozNotification definido en los documentos con un "tipo" de campo adicional. Detalles TBD. NOTA: No hay manera de almacenar la duración y tampoco de "cancelar" una notificación (<span class="short_text" id="result_box" lang="es"><span class="hps">la hipótesis</span> <span class="hps">es de que son</span> <span class="hps">de muy corta duración</span></span>). ¿Está bien?</p> - -<p><em>Argumentos:</em></p> - -<p><strong>id</strong></p> - -<blockquote> -<p>Cadena: Un ID para la notificación. Este ID no será mostrado pero será pasado atrás vía el evento <code>social.notification-action</code> si el usuario cliquea en la notificación.</p> -</blockquote> - -<p><strong>type</strong></p> - -<blockquote> -<p>Cadena: La cadena Tipo deberá ser consistente para cada <strong>tipo</strong> de notificación. Este será usado por algun sistema de notificación para proveer filtraciones de notificaciones al nivel del usuario. Un proveedor deberá elegir cualquier cadena para el tipo, pero deberá mantener los tipos de cadena consistentes y descriptivos para cada tipo de acción. Por ejemplo, las notificaciones de chat deberían siempre de tener la cadena del mismo tipo. Sugerencia/ejemplo que incluye la notificación:</p> -</blockquote> - -<ul> - <li>social.providername.chat-request</li> - <li>social.providername.friend-request</li> - <li>social.providername.activity (e.g. someone posted to your activity stream)</li> -</ul> - -<p><strong>icon</strong></p> - -<blockquote> -<p>Cadena/nulo. La URL de una imagen a ser colocada en una notificación. Mientras que esta puede ser cualquier RL válida, los implementadores están muy recomendados que usen una URL de datos para minimizar la latencia.</p> -</blockquote> - -<p><strong>body</strong></p> - -<blockquote> -<p>Cadena: El cuerpo del mensaje de notificación. este cuerpo será tomado como un super-enlace y podrá ser cliqueado. El marcado de HTML no es soportado.</p> -</blockquote> - -<p><strong>action</strong></p> - -<blockquote> -<p>Cadena: Una acción para ejecutar cuando el usuario hace clic en la notificación. Si ninguna acción es prevista, la notificación no es cliqueable. Acualmente las únicas acciones soportadas son <strong><em>link</em></strong>, <strong><em>callback</em></strong> y <strong><em>openServiceWindow</em></strong>. Si la acción está difinida, actionArgs también deberá ser definida.</p> -</blockquote> - -<p><strong>actionArgs</strong></p> - -<blockquote> -<p>Objeto: Una objeto con argumentos (abajo). Acciones soportadas y sus actionArgs son:</p> -</blockquote> - -<ul> - <li>link - <ul> - <li>toURL: Cadena: URL para abrirse en una nueva pestaña de navegador.</li> - </ul> - </li> -</ul> - -<h4 id="social.notification-action"><code>social.notification-action</code></h4> - -<p>Enviada al service Worker como una respuesta a la notificación "callback", después de que el usuario ha cliqueado en la notificación.</p> - -<p><em>Argumentos:</em></p> - -<p><strong>id</strong></p> - -<blockquote> -<p>Cadena: el ID de la notificación que fue cliqueada.</p> -</blockquote> - -<p><strong>action</strong></p> - -<blockquote> -<p>Cadena: La <strong>acción</strong> enviada en <code>social.notification-create</code>.</p> -</blockquote> - -<p><strong>actionArgs</strong></p> - -<blockquote> -<p>Objeto: Las <strong>actionArgs</strong> enviados en <code>social.notification-create</code>.</p> -</blockquote> - -<h3 id="Marcadores_de_página">Marcadores de página</h3> - -<p><strong>ESTADO: CON MIRA EN Fx23 (reemplazando Link Recommendation below)</strong></p> - -<p>Las Marcas de Página son un simple mecanismo de compartir una URL con un proveedor social. Las Marcas de Página difieren para compartir en que la URL solo es enviada al proveedor. Esta funcionalidad puede manejar casos de uso como el <em>Me Gusta</em> de Facebook, Google +1, Pocket, u otras características como ver-más-tarde. Cuando estan habilitados, y el botón adicional de Marca aparecerá al final de la botonera Social en Firefox. No hay una IU asociada con otro botón que no sea el cambiar la imagen de botón para reflejar el estado de marcado o no-marcado.</p> - -<h4 id="social.page-mark-config"><code>social.page-mark-config</code></h4> - -<p>Enviado por el service Worker para notificar a Firefox de soporte para las Marcas de Página. Este mensaje puede ser enviado en cualquier momento. Te recomendamos mandarlo cuando se esté manejando el mensaje <code>social.initialize</code>.</p> - -<p><em>Argumentos:</em></p> - -<p><strong>images</strong></p> - -<blockquote> -<p>Objeto. Debe tener dos llaves de tipo String, 'marked' y 'unmarked', los cuales serán usados como ícono del botón de Marcador de Página. El agente de usuario buscará si la actual página ha sido marcada - si sí, mostrará la imagen 'marked', de otra manera motrará la imagen 'unmarked'. Puede contener una imagen direccionable - web o una URL de datos conteniendo una imagen de datos generada dinamicamente. Implementadores están fuertemente recomendados de usar una URL de datos para minimizar la latencia. Cada imagen se espera que sea de de 16x16 píxeles.</p> -</blockquote> - -<p><strong>messages</strong></p> - -<blockquote> -<p>Objeto. Debe tener las siguientes llaves de cadena:</p> -</blockquote> - -<ul> - <li>'markedTooltip', 'unmarkedTooltip': Las cadenas usadas como la barra de herramientasen el objetivo de clic cuando las imagenes 'marked' y 'unmarked', respectivamente, son mostradas.</li> - <li>'markedLabel', 'unmarkedLabel': Cadenas que serán utilizadas para actualizar una etiqueta después de la acción 'marked' o 'unmarked' es hecha, para reflejar la transición desde marked-to-unmarked o vice-versa.</li> -</ul> - -<h4 id="social.page-mark"><code>social.page-mark</code></h4> - -<p>Enviado por el navegador hacia el service Worker cuando el usuario 'marca' o 'desmarca' una página. No hay respuesta esperada. El navegador rastreará el estado de la marca de la página separadamente del proveedor. Si el usuario limpia su historial, todas las marcas de página serán removidas.</p> - -<p><em>Arguments:</em></p> - -<p><strong>url</strong></p> - -<blockquote> -<p>Cadena. La URL de la página es marcada.</p> -</blockquote> - -<p><strong>marked</strong></p> - -<blockquote> -<p>Boolean.</p> -</blockquote> - -<p> </p> - -<h3 id="Enlace_de_Control_de_Recomendación">Enlace de Control de Recomendación</h3> - -<p> </p> - -<p>NOTA: El siguiente mensaje usuario-recomendación fue RECHAZADO y REMOVIDO de Fx23. Fue reemplazado por Page Marks.</p> - -<h4 id="social.user-recommend-prompt"><code>social.user-recommend-prompt</code></h4> - -<p><strong>ESTADO: RECHAZADO, REMOVIDO de Fx23</strong><strong>, REEMPLAZADO CON social.page-mark-config</strong></p> - -<p>Enviado por el navegador para solicitar una vista de la interfaz para la "recomendación de usuario". El service Worker debe responder con una user-recommend-prompt-response</p> - -<p>Nota que tipicamente este mensaje solo será enviado cuando un proveedor está activado y la respuesta será usada para todas las URL's. En otras palabras, el proveedor no espera que este mensaje sea enviado cada vez que el agente de usuario navega o muestra una nueva UTL.</p> - -<p><em>Arguments:</em></p> - -<p>None</p> - -<h4 id="social.user-recommend-prompt-response"><code>social.user-recommend-prompt-response</code></h4> - -<p><strong>STATUS: </strong><strong>DEPRECATED, REMOVED Fx23</strong></p> - -<p>The Worker constructs and posts a user-recommend-prompt-response in response to a <code>social.user-recommend-prompt</code> message received from the browser. See <code>social.user-recommend-prompt</code> for more details.</p> - -<p><em>Arguments:</em></p> - -<p><strong>images</strong></p> - -<blockquote> -<p>Object. Must have 2 string keys, 'share' and 'unshare', which each value being the URL to an image which will be set as the "src" property of an image contained in the user-facing click target for the "recommend" action. The user agent will track if the current page has been shared - if so, it will show the 'unshare' image, otherwise will show the 'share' image. It can contain a web-addressible image or a data URL containing dynamically-generated image data. Implementors are strongly encouraged to use a data URL to minimize latency. Each image is expected to be 16px wide and 16px high.</p> -</blockquote> - -<p><strong>messages</strong></p> - -<blockquote> -<p>Objeto. Debe tener las siguientes llaves de cadena:</p> -</blockquote> - -<ul> - <li>'shareTooltip', 'unshareTooltip': Las cadenas usadas como el <em>tooltip</em> en el objetivo de clic cuando las imagenes de 'share' y 'unshare', respectivamente, son mostradas.</li> - <li>'sharedLabel', 'unsharedLabel': Cadenas que serán usadas para actualziar una etiqueta de <em>widget</em> después de que la acción de 'share' o 'unshare' es tomada para reflejar la transición desde shared-to-unshared o vice-versa. Notese que en Fx17, las etiquetas no son visibles pero son usadas como una ayuda de accesibilidad así que un screen-reader o similar puede hacer notar la transición.</li> - <li>'unshareLabel': Una cadena a sermostrda en el 'unshare popup' para reflejar que el item ha sido compartido. Ejemplo: "Ya has compartido esto".</li> - <li>'portraitLabel': Una cadena usada como la aria-label para la imagen de perfil de usuario sea mostrada como 'unshare popup'. Ejemplo: "Tu imagen de perfil".</li> - <li>'unshareConfirmLabel': Una cadena usada como la etiqueta en el botón en la 'unshare popup' usada para modificar el 'unshare'. Ejemplo: "No compartir esto".</li> - <li>'unshareConfirmAccessKey': Una cadena usada como la llave de acceso para el boton de No comprtir. Tipicamente esta debería ser una etiqueta en la cadena 'unshareConfirmLabel'.</li> - <li>'unshareCancelLabel': Una cadena usada como la etiqueta en el botón en la 'unshare popup' cuando el usuario decide seguir continuando el elemento. Ejemplo: "Cerrar".</li> - <li>'unshareCancelAccessKey': Una cadena usada como la llave de acceso para el botón de No compartir.</li> -</ul> - -<h4 id="social.user-recommend"><code>social.user-recommend</code></h4> - -<p><strong>ESTADO: RECHAZADA, </strong><strong>REMOVIDO DE Fx23</strong><strong>, REEMPLAZADO CON social.page-mark</strong></p> - -<p>Indica que el usuario ha hecho clic en el elemento de interfaz "user recommendation". El mensaje incluye:</p> - -<p><em>Argumentos:</em></p> - -<p><strong>url</strong></p> - -<blockquote> -<p>Cadena, requerida. La URL que el usuario está viendo, incluída la cadena de busqueda, pero menos cualquier texto de hash, de la raíz de la actual vista del navegador.</p> -</blockquote> - -<p>No es necesaria una respuesta; como fuere, el servicio debe responder en el mismo puerto con una usuario-recomendación-prompt-respuesta si el objetivo de clic debe cambiar su apariencia.</p> - -<h4 id="social.user-unrecommend"><code>social.user-unrecommend</code></h4> - -<p><strong>ESTADO: RECHAZADO, REMOVIDO DE Fx23</strong></p> - -<p>Indíca que al usuario le gustaría volver a su previa recomendación. El mensaje incluye:</p> - -<p><em>Argumentos:</em></p> - -<p><strong>url</strong></p> - -<blockquote> -<p>Cadena, requerido. La URL que el usuario está viendo, incluyendo la cadena de consulta, pero no los textos de hash, de la raíz del contexto actual de vista del navegador.</p> - -<dl> -</dl> -</blockquote> - -<p> </p> diff --git a/files/es/social_api/widgets/index.html b/files/es/social_api/widgets/index.html deleted file mode 100644 index 85ae2e03a5..0000000000 --- a/files/es/social_api/widgets/index.html +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: Widgets -slug: Social_API/Widgets -translation_of: Archive/Social_API/Widgets ---- -<h1 id="Widgets">Widgets</h1> -<h2 id="SidebarWidget">SidebarWidget</h2> -<p>Si un servicio define un SidebarWidget, <span class="short_text" id="result_box" lang="es"><span class="hps">el</span> <span class="hps">navegador</span> <span class="hps">crea instancias, </span></span><span class="short_text" id="result_box" lang="es"><span class="hps">en</span> <span class="hps">determinadas</span> <span class="hps">ventanas del navegador, </span></span><span id="result_box" lang="es"><span class="hps">un área de contenido</span> <span class="hps">cuyo contenido</span> <span class="hps">se encuentra en</span> <span class="hps">el</span> <a href="https://developer.mozilla.org/es/docs/Social_API/Manifest#sidebarURL" title="https://developer.mozilla.org/en-US/docs/Social_API/Manifest#sidebarURL"><span class="hps">sidebarURL</span></a> <span class="hps">definido en el manifiesto</span><span>.</span></span> <span id="result_box" lang="es"><span class="hps">Estas regiones</span> <span class="hps">no se crean instancias</span> <span class="hps">hasta que el</span> </span><em>Worker</em><span id="result_box" lang="es"> <span class="hps">ha sido completamente</span> <span class="hps">cargado</span></span>.<span id="result_box" lang="es"><span class="hps">El contenido de</span> <span class="hps">estas regiones tiene</span> <span class="hps">la API</span> <span class="hps">adicional definida</span></span><span id="result_box" lang="es"><span class="hps"> en la</span> <span class="hps">referencia</span> de </span><em>Service Content API</em><span id="result_box" lang="es"><span class="hps">.</span></span></p> -<p><span id="result_box" lang="es"><span class="hps">Las Sidebars</span></span> pueden estar en estado <em>visibles</em> u <em>ocultos</em>.</p> -<ul> - <li><span id="result_box" lang="es"><span class="hps">Cuando son visibles</span><span>, reciben un</span> <span class="hps">rectángulo</span> <span class="hps">vertical del</span> <span class="hps">espacio de la pantalla</span> <span class="hps">en</span> <span class="hps">el que se representará</span>, <span class="hps">este rectángulo es</span> <span class="hps">estable a través de</span> <span class="hps">los cambios</span> <span class="hps">en el </span></span><span class="short_text" id="result_box" lang="es"><span class="hps">pestaña</span></span><span id="result_box" lang="es"><span class="hps"> de </span></span><span id="result_box" lang="es"><span class="hps">enfoque</span> <span class="hps">y tiene una</span> <span class="hps">barra de desplazamiento</span> <span class="hps">independiente de</span> <span class="hps">la barra de desplazamiento</span> <span class="hps">del contenido de</span> <span class="hps">la navegación por pestañas</span><span>.</span></span></li> - <li>Cuando esta oculta, <span id="result_box" lang="es"><span class="hps">la barra lateral</span> <span class="hps">se elimina completamente de</span> <span class="hps">la jerarquía</span> <span class="hps">visual.</span></span> <span id="result_box" lang="es"><span class="hps">El agente de usuario</span> <span class="hps">continúa entregando</span> <span class="hps">mensajes a</span> <span class="hps">estos, </span></span>Y la barra lateral puede pre procesar su DOM para mostrar posteriormente.</li> -</ul> -<p><span id="result_box" lang="es"><span class="hps">Windows Sidebar</span> <span class="hps">se crea una instancia</span> <span class="hps">única</span> <span class="hps">en</span> <span class="hps">las ventanas del navegador</span> <span class="hps">que tienen una</span> <span class="hps">completa</span> <span class="hps">interfaz</span> <span class="hps">de navegación</span> <span class="hps">por pestañas</span><span>, ventanas creadas con </span></span><a href="https://developer.mozilla.org/en-US/docs/DOM/window.open" title="/en-US/docs/DOM/window.open">window.open</a> <span id="result_box" lang="es"><span class="hps">que</span> <span class="hps">no cuentan con estos</span> <span class="hps">elementos de la interfaz</span> <span class="hps">no recibe una</span> <span class="hps">barra lateral.</span></span></p> -<p><span id="result_box" lang="es"><span class="hps">Cuando una</span> </span><span class="short_text" id="result_box" lang="es"><span class="hps">pestaña</span></span><span id="result_box" lang="es"><span class="hps"> que</span> <span class="hps">se representa directamente</span> <span class="hps">en el navegador</span> <span class="hps">sin</span> <span class="hps">barra de direcciones</span> <span class="hps">se selecciona, </span></span><span id="result_box" lang="es"><span class="hps">la barra lateral</span> <span class="hps">se coloca automáticamente</span> <span class="hps">en</span> <span class="hps">el</span> <span class="hps">estado <em>oculto</em>.</span></span> <span class="short_text" id="result_box" lang="es"><span class="hps">Cuando el</span> <span class="hps">usuario sale de</span> <span class="hps">esa pestaña</span></span>, <span class="short_text" id="result_box" lang="es"><span class="hps">la barra lateral</span> <span class="hps">se hace</span> <span class="hps"><em>visible</em> de nuevo</span></span>. <span id="result_box" lang="es"><span class="hps">Estas pestañas</span> <span class="hps">incluyen</span> <span class="hps">la página de administración</span> <span class="hps">de complementos</span></span>, about:permissions, etc.</p> -<p><span id="result_box" lang="es"><span class="hps">Los estados</span> <span class="hps">minimizada /</span> <span class="hps">maximizada</span> <span class="hps">/</span> <span class="hps">oculta</span> de <span class="hps">la barra lateral</span> <span class="hps">del widget</span> <span class="hps">son consistentes</span> <span class="hps">a través de todas</span> <span class="hps">las ventanas del navegador. </span></span><span id="result_box" lang="es"><span class="hps">El estado más</span> <span class="hps">reciente </span><span class="hps">es recordado y</span> <span class="hps">usado</span> <span class="hps">para las nuevas ventanas, </span></span><span id="result_box" lang="es"><span class="hps">y</span> <span class="hps">se conserva</span> <span class="hps">en todos los reinicios</span> <span class="hps">del navegador.</span></span></p> |