Comparar revisiones

Social API temp

Change Revisions

Revisión 329609:

Revisión 329609 de MiguelFRomeroR el

Revisión 329731:

Revisión 329731 de MiguelFRomeroR el

Título:
Social API temp
Social API temp
Enlace amigable (slug):
User:Sheppy/Social_API_temp
User:Sheppy/Social_API_temp
Contenido:

Revisión 329609
Revisión 329731
n8      <h2 class="title-actions-bar" id="Browser_Social_API_Referen8      <h2 class="title-actions-bar" id="Navegador_de_la_Referenci
>nce">>a_del_Social_API">
9        Navegador de la Referencia del Social API9        Referencia del Social API del navegador
n21                          <a href="https://github.com/mixedpuppy/n21                          <a href="https://github.com/mixedpuppy/
>socialapi-demo" title="https://github.com/mixedpuppy/socialapi-de>socialapi-demo" title="https://github.com/mixedpuppy/socialapi-de
>mo">https://github.com/mixedpuppy/socialapi-demo</a> contiene una>mo">https://github.com/mixedpuppy/socialapi-demo</a> contiene una
> implementación del proveedor de prueba que muestra el uso de muc> implementación del proveedor de prueba que muestra el uso de muc
>has de estas APIs. La lectura de esto le ayudará a ilustrar la do>has de estas APIs. La lectura de esto te ayudará a ilustrar la do
>cumentación proporcionada aquí.>cumentación proporcionada aquí.
22                        </p>
23                        <h3 id="Service_Worker_Reference">
24                          Referencia del trabajador de servicios
25                        </h3>
26                        <p>22                        </p>
27                          Un trabajador de servicios hereda todas23                        <h3 id="Referencia_del_trabajador_de_serv
> las limitaciones y comportamientos que se encuentran en HTML5 Sh>icios">
>ared Workers. Puede crear XMLHttpRequests, usar WebSockets, recib 
>ir mensajes de las ventanas y el navegador, usar IndexedDB, y env 
>iar mensajes a otras ventanas. 
24                          Referencia del service worker
25                        </h3>
28                        </p>26                        <p>
27                          Un Service Worker hereda todas las limi
 >taciones y comportamientos que se encuentran en HTML5 Shared Work
 >ers. Puede crear XMLHttpRequests, usar WebSockets, recibir mensaj
 >es de las ventanas y el navegador, usar IndexedDB, y enviar mensa
 >jes a otras ventanas.
29                        <p>28                        </p>
30                          El trabajador puede utilizar los método
>s <code>ononline</code>, <code>onoffline</code>, y <code>navigato 
>r.online</code> y las propiedades que están disponibles para todo 
>s los trabajadores para obtener la notificación del estado conect 
>ado/desconectado del navegador. 
31                        </p>29                        <p>
30                          El Worker puede utilizar los métodos <c
 >ode>ononline</code>, <code>onoffline</code>, y <code>navigator.on
 >line</code> y las propiedades que están disponibles para todos lo
 >s Workers para obtener la notificación del estado conectado/desco
 >nectado del navegador.
32                        <p>31                        </p>
33                          Además de los métodos estándar, los tra
>bajadores de servicios tienen acceso a funcionalidades adicionale 
>s, todas ellas se implementan utilizando mensajes enviados y reci 
>bidos por los "puertos de los mensajes" del trabajador. Como los  
>puertos de los mensajes son inherentemente asíncronos, cualquier  
>mensaje que requiera una respuesta implicará dos mensajes - uno p 
>ara la solicitud y otro para la respuesta, No todos los mensajes  
>requieren una respuesta - esto hace parte de la especificación de 
>l mensaje. Los mensajes que no requieren respuesta son semejantes 
> a un "evento" no solicitado. Si un mensaje requiere una respuest 
>a, la respuesta siempre debe ser enviada al mismo puerto de la so 
>licitud y, en general, el "asunto" de la respuesta será el asunto 
> de la solicitud con "-respuesta" añadido. 
34                        </p>32                        <p>
33                          Además de los métodos estándar, los Ser
 >vice Workers tienen acceso a funcionalidades adicionales, todas e
 >llas se implementan utilizando mensajes enviados y recibidos por 
 >los "puertos de mensajes" del Worker. Como los puertos de mensaje
 >s son inherentemente asíncronos, cualquier mensaje que requiera u
 >na respuesta implicará dos mensajes - uno para la solicitud y otr
 >o para la respuesta, No todos los mensajes requieren una respuest
 >a - esto hace parte de la especificación del mensaje. Los mensaje
 >s que no requieren respuesta son semejantes a un "evento" no soli
 >citado. Si un mensaje requiere una respuesta, la respuesta siempr
 >e debe ser enviada al mismo puerto de la solicitud y, en general,
 > el "asunto" de la respuesta será el asunto de la solicitud con "
 >-respuesta" añadido.
35                        <p>34                        </p>
36                          Se espera que los trabajadores de servi35                        <p>
>cios proporcionen funciones, en un ámbito global, llamadas <code> 
>onconnect</code> y <code>ondisconnect</code>. El navegador invoca 
>rá <code>onconnect</code> en el momento de inicio, pasando en un  
>evento. El trabajador debe tener acceso a la propiedad de los <co 
>de>puertos</code> de este evento para extraer un puerto de comuni 
>cación estable de vuelta al navegador, y mantenerlo para la vida  
>del worker, así: 
36                          Se espera que los Service Workers propo
 >rcionen funciones, en un ámbito global, llamadas <code>onconnect<
 >/code> y <code>ondisconnect</code>. El navegador invocará <code>o
 >nconnect</code> en el momento de inicio, pasando en un evento. El
 > worker debe tener acceso a la propiedad de los <code>puertos</co
 >de> de este evento para extraer un puerto de comunicación estable
 > de vuelta al navegador, y mantenerlo para la vida del worker, as
 >í:
n73                          Cada mensaje tiene un elemento de datosn73                          Cada mensaje tiene un elemento de datos
> con dos campos, "asunto" y "datos". El asunto identifica qué mét> con dos campos, "asunto" y "datos". El asunto identifica qué mét
>odo o evento se está utilizando, y los datos especifican datos ad>odo o evento se está utilizando, y los datos especifican datos ad
>icionales únicos para el asunto. Todos los métodos y eventos tien>icionales únicos para el asunto. Todos los métodos y eventos tien
>en asuntos que comienzan con "social". - Esto significa que los s>en asuntos que comienzan con "social". - Esto significa que los s
>ervicios son libres de utilizar asuntos sin prefijo como un detal>ervicios son libres de utilizar asuntos sin prefijo como un detal
>le de implementación privada (por ejemplo, para la comunicación e>le de implementación privada (por ejemplo, para la comunicación e
>ntre cierto contenido desde el servicio y el servicio del trabaja>ntre cierto contenido desde el servicio y el servicio del worker)
>dor) 
n75                        <h3 id="Control_Messages_sent_to_Service_n
>Workers"> 
76                          Mensajes de control enviados a los trab75                        <h3 id="Mensajes_de_control_enviados_a_lo
>ajadores de servicios>s_trabajadores_de_servicios">
76                          Mensajes de control enviados a los Serv
 >ice Workers
n85                          Enviado por el navegador durante el arrn85                          Enviado por el navegador durante el arr
>anque. Cuando el JavaScript de un trabajador se ha cargado y eval>anque. Cuando el JavaScript de un Worker se ha cargado y evaluado
>uado correctamente, el navegador enviará un mensaje con este asun> correctamente, el navegador enviará un mensaje con este asunto.
>to. 
n94                          Sent by the browser during worker shutdn94                          Enviado por el navegador durante la des
>own, when a MessagePort to the worker is about to be closed. This>conexión de un Worker, cuando un puerto de mensajes del Worker es
> will be the last message the worker receives on the port.>tá a punto de cerrarse. Este será el último mensaje que el Worker
 > recibe en el puerto.
n96                        <h3 id="Ambient_Notification_Control">n96                        <h3 id="Control_de_las_notificaciones_del
 >_ambiente">
n106                          Enviado por el trabajador, para establen106                          Enviado por el Worker, para establecer 
>cer las propiedades para el icono del proveedor y los datos del p>las propiedades para el icono del proveedor y los datos del perfi
>erfil de usuario utilizadas por el botón de la barra de herramien>l de usuario utilizadas por el botón de la barra de herramientas.
>tas. Si falta el retrato del usuario y el nombre de usuario el bo> Si falta el retrato del usuario y el nombre de usuario el boton 
>ton UI indicará un estado desconectado. Al indicar el estado desc>UI indicará un estado desconectado. Al indicar el estado desconec
>onectado, el icono de estado establecido por&nbsp;<code>social.am>tado, el icono de estado establecido por&nbsp;<code>social.ambien
>bient-notification</code> será eliminado.>t-notification</code> será eliminado.
n166                          Enviado por el trabajador, para actualin166                          Enviado por el worker, para actualizar 
>zar o crear un icono de notificación del ambiente. Se envía uno p>o crear un icono de notificación del ambiente. Se envía uno para 
>ara cada icono. Un usuario debe estar conectado para mostrar los >cada icono. Un usuario debe estar conectado para mostrar los icon
>iconos de estado, y debes llamar al <code>social.user-profile</co>os de estado, y debes llamar al <code>social.user-profile</code> 
>de> antes de llamar al <code>social.ambient-notification</code> p>antes de llamar al <code>social.ambient-notification</code> para 
>ara establecer los iconos de estado.>establecer los iconos de estado.
n211                        <h3 id="Active_Notification_Control">n211                        <h3 id="Control_de_las_notificaciones_act
 >ivas">
n221                          Enviado por el trabajador, para crear yn221                          Enviado por el Worker, para crear y mos
> mostrar un objeto de notificación. Este solicita que el navegado>trar un objeto de notificación. Este solicita que el navegador no
>r notifique inmediatamente al usuario de un cambio relevante en e>tifique inmediatamente al usuario de un cambio relevante en el es
>l estado. Ver <a href="https://developer.mozilla.org/en/DOM/navig>tado. Ver <a href="https://developer.mozilla.org/en/DOM/navigator
>ator.mozNotification">https://developer.mozilla.org/en/DOM/naviga>.mozNotification">https://developer.mozilla.org/en/DOM/navigator.
>tor.mozNotification</a> para más detalles. Cuando el usuario hace>mozNotification</a> para más detalles. Cuando el usuario hace cli
> clic en la notificación, el mensaje <code>social.notification-ac>c en la notificación, el mensaje <code>social.notification-action
>tion</code> se envía al trabajador. El título de la notificación ></code> se envía al Worker. El título de la notificación siempre 
>siempre será el nombre del proveedor.>será el nombre del proveedor.
n250                          <li>social.providername.activity (por en250                          <li>social.providername.activity (por e
>jemplo, alguien publicó en su stream de actividad)>jemplo, alguien publicó en tu activity stream)
n300                          Enviado al trabajador como respuesta a n300                          Enviado al worker como respuesta a una 
>una notificación de "devolución de llamada", después de que el us>notificación de "devolución de llamada", después de que el usuari
>uario ha hecho clic en la notificación.>o ha hecho clic en la notificación.
n332                        <h3 id="Link_Recommendation_Control">n332                        <h3 id="Control_de_los_enlaces_de_recomen
 >daci.C3.B3n">
n342                          Enviado por el navegador para solicitarn342                          Enviado por el navegador para solicitar
> el indicador visual para el elemento de la interfaz "recomendaci> el indicador visual para el elemento de la interfaz "recomendaci
>ón del usuario". El trabajador debe responder con una user-recomm>ón del usuario". El worker debe responder con una user-recommend-
>end-prompt-response.>prompt-response.
n360                          El trabajador construye y publica una un360                          El Worker construye y publica una user-
>ser-recommend-prompt-response en respuesta a un mensaje <code>soc>recommend-prompt-response en respuesta a un mensaje <code>social.
>ial.user-recommend-prompt</code> recibido desde el navegador. Ver>user-recommend-prompt</code> recibido desde el navegador. Ver <co
> <code>social.user-recommend-prompt</code> para más detalles.>de>social.user-recommend-prompt</code> para más detalles.
n370                            Objeto. Debe tener 2 string claves, "n370                            Objeto. Debe tener 2 string claves, "
>compartir" y "dejar de compartir", cuyo valor es la direccion URL>compartir" y "dejar de compartir", cuyo valor es la direccion URL
> de una imagen que se establecerá como la propiedad "src" de una > de una imagen que se establecerá como la propiedad "src" de una 
>imagen contenida en el objetivo del clic hecho por el usuario par>imagen contenida en el objetivo del clic hecho por el usuario par
>a la acción "recomendada". El agente de usuario hará un seguimien>a la acción "recomendada". El agente de usuario hará un seguimien
>to de si la página actual se ha compartido - si es así, se mostra>to de si la página actual se ha compartido - si es así, se mostra
>rá "dejr de compartir" la imagen, de lo contrario, se mostrará "c>rá "dejar de compartir" la imagen, de lo contrario, se mostrará "
>ompartir" imagen. Esto puede contener una imagen direccionable en>compartir" imagen. Esto puede contener una imagen direccionable e
> la web o una URL de datos que contenga datos de imagen generados>n la web o una URL de datos que contenga datos de imagen generado
> dinámicamente. Se recomienda a los desarrolladores utilizar una >s dinámicamente. Se recomienda a los desarrolladores utilizar una
>URL de datos para minimizar la latencia. Se espera que cada image> URL de datos para minimizar la latencia. Se espera que cada imag
>n tenga un alto de 16px y un ancho de 16px.>en tenga un alto de 16px y un ancho de 16px.
n394                          <li>'unshareCancelLabel': Una cadena qun394                          <li>'unshareCancelLabel': Un string que
>e se utiliza como la etiqueta del botón en el "unshare popup" cua> se utiliza como la etiqueta del botón en el "unshare popup" cuan
>ndo el usuario desea seguir compartiendo el elemento. Por ejmplo:>do el usuario desea seguir compartiendo el elemento. Por ejmplo: 
> "Cerrar".>"Cerrar".
n396                          <li>'unshareCancelAccessKey': Una cadenn396                          <li>'unshareCancelAccessKey': Un string
>a que se utiliza como clave de acceso para el boton cancelar de u> que se utiliza como clave de acceso para el boton cancelar de un
>nshare.>share.
n403                          Indicates that the user has clicked then403                          Indica que el usuario ha hecho clic en 
> "user recommendation" interface element. The message includes:>el elemento de la interfaz "recomendación del usuario". El mensaj
 >e incluye:
404                        </p>
405                        <p>404                        </p>
405                        <p>
406                          <em>Arguments:</em>406                          <em>Argumentos:</em>
n413                            String, required. The URL that the usn413                            String, necesario. La URL que el usua
>er is viewing, including query string, but minus any hash text, o>rio está viendo, incluyendo el string de consulta, menos cualquie
>f the root of the current browser viewing context.>r texto hash, de la raiz del contexto actual de visualización del
 > navegador.
414                          </p>
415                        </blockquote>
416                        <p>414                          </p>
417                          No response is necessary; however, the 415                        </blockquote>
>service may respond on the same port with a user-recommend-prompt 
>-response if the click target should change its appearance. 
416                        <p>
417                          Ninguna respuesta es necesaria, sin emb
 >argo, el servicio puede responder en el mismo puerto con un user-
 >recommend-prompt-response, si el objetivo del clic debe cambiar s
 >u apariencia.
n423                          Indicates that the user would like to rn423                          Indica que el usuario desea retractarse
>etract their previous recommendation. The message includes:> de su recomendación anterior. El mensaje incluye:
424                        </p>
425                        <p>424                        </p>
425                        <p>
426                          <em>Arguments:</em>426                          <em>Argumentos:</em>
n433                            String, required. The URL that the usn433                            String, necesario. La URL que el usua
>er is viewing, including query string, but minus any hash text, o>rio está viendo, incluyendo la cadena de consulta, menos cualquie
>f the root of the current browser viewing context.>r&nbsp; texto hash, de la raíz del contexto actual de visualizaci
 >ón del navegador.
n443                          If a service defines a SidebarWidget, tn443                          Si un servicio define un SidebarWidget,
>he browser will instantiate a content region with the SidebarWidg> el navegador instancia una región de contenido con la URL del Si
>et URL as the location on some browser windows. These regions wil>debarWidget como la ubicación de algunas ventanas del navegador. 
>l not be instantiated until the Worker has been fully loaded. The>Estas regiones no se ejecutarán hasta que el Worker se haya carga
> content in these regions has the additional API defined in the S>do completamente. El contenido de estas regiones tiene la API adi
>ervice Content API reference, above.>cional definida en la referencia del Service Content API, arriba.
444                        </p>
445                        <p>444                        </p>
446                          Sidebars can be in a <em>visible</em> o445                        <p>
>r <em>hidden</em> state. 
446                          Las barras laterales pueden encontrarse
 > en el estado <em>visible</em> u <em>oculta</em>.
n449                          <li>When visible, they will receive a vn449                          <li>Cuando están visibles, recibirán un
>ertical rectangle of screen space in which to render; this rectan> rectángulo vertical del espacio de la pantalla en el que se rend
>gle is stable across changes in tab focus and has an independent >erizará, este rectángulo es estable a través de los cambios del f
>scrollbar from the scrollbar of tabbed browsing content.>oco de pestaña y tiene una barra de desplazamiento independiente 
 >de la barra de desplazamiento del contenido de la navegación por 
 >pestañas.
n451                          <li>When hidden, a sidebar is completeln451                          <li>Cuando están ocultas, se elimina co
>y removed from the visual hierarchy. The user agent will continue>mpletamente una barra lateral de la jerarquía visual. El agente d
> to deliver messages to it, and the sidebar may pre-render its DO>e usuario continuará entregando mensajes a ella<span id="result_b
>M for later display.>ox" lang="es"><span class="hps">, y la barra lateral puede pre-re
 >nderizar su DOM para una posterior visualización.</span></span>
n455                          Sidebar windows will only be instantiatn455                          La barra lateral de la ventana sólo ser
>ed on browser windows that have a full tabbed-browsing interface;>á instanciada en las ventanas del navegador que tienen una interf
> windows created with window.open that do not have these interfac>az de navegación por pestañas completa; las ventanas creadas con 
>e elements will not have a sidebar.>window.open que no cuentan con estos elementos de la interfaz, no
 > tendrán una barra lateral.
456                        </p>
457                        <p>456                        </p>
458                          When a tab that is rendered directly by
> the browser without a location bar is selected, the sidebar will 
> automatically be placed into the <em>hidden</em> state. When the 
> user navigates away from that tab, the sidebar will be made <em> 
>visible</em> again. These tabs include the Add-ons management pag 
>e, about:permissions, etc. 
459                        </p>457                        <p>
458                          Cuando se selecciona una pestaña que se
 > renderiza directamente por el navegador sin barra de direcciones
 >, la barra lateral se colocará automáticamente en estado <em>ocul
 >ta</em>. Cuando el usuario sale de esa pestaña, la barra lateral 
 >se hará visible de nuevo. Estas pestañas incluyen la página de ad
 >ministración de complemento, about:permissions, etc.
460                        <p>459                        </p>
461                          The minimized/maximized/hidden state of460                        <p>
> the sidebar widget is will be consistent across all browser wind 
>ows. The most-recently-set state is remembered and used for new w 
>indows, and is persisted across browser restarts. 
461                          El estado minimizado/maximizado/oculto 
 >del widget de la barra lateral será consistente a través de todas
 > las ventanas del navegador. El estado más recientemente configur
 >ado se recuerda y se utiliza en las nuevas ventanas, y se conserv
 >a asi se reinicie el navegador.
n464                          Messages Sent to Widgetsn464                          Mensajes enviados a los Widgets
n473                          DOM Event sent by the browser when the n473                          Evento DOM enviado por el navegador cua
>user hides the sidebar content.>ndo el usuario oculta el contenido de la barra lateral.
n479                          DOM Event sent by the browser when the n479                          Evento DOM enviado por el navegador cua
>user shows the sidebar content.>ndo el usuario muestra el contenido de la barra lateral.
n482                          Browser "Panel" Integrationn482                          Integración del "Panel" del navegador
483                        </h3>
484                        <p>483                        </h3>
485                          <strong>STATUS: DONE Fx17</strong>
486                        </p>484                        <p>
485                          <strong>STATUS: DONE Fx17</strong>
487                        <p>486                        </p>
488                          To allow content to place an ephemeral 487                        <p>
>window in front of normal browser content and chrome, the followi 
>ng API is used: 
488                          Para permitir contenido para colocar un
 >a ventana efímera delante del contenido del navegador normal y ch
 >rome, se usa la siguiente API:
n495                          The callback will receive the window obn495                          En la vuelta del mensaje se recibirá el
>ject from the chat frame.> objeto window del marco del chat.
n498                          Message Serializationn498                          Serialización del mensaje
n501                          For a messagwith topic <code>topic</cn501                          Para un mensajcon asunto <code>topic<
>ode> and arguments (arg1:val1, arg2:val2), construct an object li>/code> y argmumentos (arg1:val1, arg2:val2), se construye un obje
>ke:>to como este:
n508                          Discovery and Service Manifestn508                          Manifiesto Discovery y Service
n514                          <strong>STATUSNOT TARGETED</strong>n514                          <strong>ESTADO: SIN OBJETIVO</strong>
515                        </p>
516                        <p>515                        </p>
517                          As a user browses web sites Firefox can516                        <p>
> discover new social providers and offer installation of those pr 
>oviders. A social providers website would include a LINK tag in t 
>he header pointing to a manifest file to enable this form of disc 
>overy. If the user either has stored authentication credentials i 
>n the Firefox password manager, or if the user frequents the webs 
>ite, Firefox will show a notification bar allowing the user to in 
>stall the service. 
517                          Como un usuario que navega por los siti
 >os web de Firefox puede descubrir nuevos proveedores sociales y s
 >er ofertado para la instalación de esos proveedores. Un sitio web
 > de los proveedores sociales incluiría una etiqueta en la cabecer
 >a apuntando a un archivo manifiesto para habilitar este tipo de d
 >escubrimiento. Si el usuario tiene almacenadas las credenciales d
 >e autenticación en el administrador de contraseñas de Firefox, o 
 >si el usuario frecuenta el sitio web, Firefox mostrará una barra 
 >de notificación que permite al usuario instalar el servicio.
t520                          Activationt520                          Activación
521                        </h4>
522                        <p>521                        </h4>
523                          <strong>STATUS: DONE Fx17</strong>
524                        </p>522                        <p>
523                          <strong>STATUS: DONE Fx17</strong>
525                        <p>524                        </p>
526                          A provider can become activated by disp
>atching a custom event of "ActivateSocialFeature" on the document 
>. The document's location is then checked against a built-in whit 
>elist and if the location is found then the feature is activated  
>for that provider. 
527                        </p>525                        <p>
526                          Un proveedor puede activarse mediante e
 >l envío de un evento personalizado "ActiveSocialFeature" en el do
 >cumento. La ubicación del documento se comprueba en una lista bla
 >nca integrada y si la ubicación se encuentra, entonces se activa 
 >esa función para ese proveedor.
528                        <p>527                        </p>
529                          We recommend that providers require the528                        <p>
>ir users to click a link or button to activate the feature so the 
> user is aware of the new functionality. 
529                          Se recomienda que los proveedores le pi
 >dan a sus usuarios hacer clic en un enlace o botón para activar l
 >a función, para que el usuario sea consciente de la nueva funcion
 >alidad.

Volver al historial