third_party/polymer/components-chromium/core-signals/core-signals.html

   1 <!--
   2 Copyright (c) 2014 The Polymer Project Authors. All rights reserved.
   3 This code may only be used under the BSD style license found at http://polymer.github.io/LICENSE
   4 The complete set of authors may be found at http://polymer.github.io/AUTHORS
   5 The complete set of contributors may be found at http://polymer.github.io/CONTRIBUTORS
   6 Code distributed by Google as part of the polymer project is also
   7 subject to an additional IP rights grant found at http://polymer.github.io/PATENTS
   8 -->
   9 <link rel="import" href="../polymer/polymer.html">
  10
  11 <!--
  12 `core-signals` provides basic publish-subscribe functionality.
  13
  14 Note: avoid using `core-signals` whenever you can use
  15 a controller (parent element) to mediate communication
  16 instead.
  17
  18 To send a signal, fire a custom event of type `core-signal`, with
  19 a detail object containing `name` and `data` fields.
  20
  21     this.fire('core-signal', {name: 'hello', data: null});
  22
  23 To receive a signal, listen for `core-signal-<name>` event on a
  24 `core-signal` element.
  25
  26   <core-signal on-core-signal-hello="{{helloSignal}}">
  27
  28 You can fire a signal event from anywhere, and all
  29 `core-signal` elements will receive the event, regardless
  30 of where they are in DOM.
  31
  32 @group Polymer Core Elements
  33 @element core-signals
  34 @status stable
  35 @homepage github.io
  36 -->
  37 <polymer-element name="core-signals" assetpath="">
  38
  39 </polymer-element>
  40 <script src="core-signals-extracted.js"></script>