mirror of
https://github.com/rails/rails.git
synced 2022-11-09 12:12:34 -05:00
eb8c713c98
It was initially required, but support for the shorthand has been supported since sprockets 2.1. Eventually 4.x will only support the shorthand version. Just want to get new people using the prefer stuff ASAP.
68 lines
2.3 KiB
CoffeeScript
68 lines
2.3 KiB
CoffeeScript
# A new subscription is created through the Cable.Subscriptions instance available on the consumer.
|
|
# It provides a number of callbacks and a method for calling remote procedure calls on the corresponding
|
|
# Channel instance on the server side.
|
|
#
|
|
# An example demonstrates the basic functionality:
|
|
#
|
|
# App.appearance = App.cable.subscriptions.create "AppearanceChannel",
|
|
# connected: ->
|
|
# # Called once the subscription has been successfully completed
|
|
#
|
|
# appear: ->
|
|
# @perform 'appear', appearing_on: @appearingOn()
|
|
#
|
|
# away: ->
|
|
# @perform 'away'
|
|
#
|
|
# appearingOn: ->
|
|
# $('main').data 'appearing-on'
|
|
#
|
|
# The methods #appear and #away forward their intent to the remote AppearanceChannel instance on the server
|
|
# by calling the `@perform` method with the first parameter being the action (which maps to AppearanceChannel#appear/away).
|
|
# The second parameter is a hash that'll get JSON encoded and made available on the server in the data parameter.
|
|
#
|
|
# This is how the server component would look:
|
|
#
|
|
# class AppearanceChannel < ApplicationCable::Channel
|
|
# def subscribed
|
|
# current_user.appear
|
|
# end
|
|
#
|
|
# def unsubscribed
|
|
# current_user.disappear
|
|
# end
|
|
#
|
|
# def appear(data)
|
|
# current_user.appear on: data['appearing_on']
|
|
# end
|
|
#
|
|
# def away
|
|
# current_user.away
|
|
# end
|
|
# end
|
|
#
|
|
# The "AppearanceChannel" name is automatically mapped between the client-side subscription creation and the server-side Ruby class name.
|
|
# The AppearanceChannel#appear/away public methods are exposed automatically to client-side invocation through the @perform method.
|
|
class Cable.Subscription
|
|
constructor: (@subscriptions, params = {}, mixin) ->
|
|
@identifier = JSON.stringify(params)
|
|
extend(this, mixin)
|
|
@subscriptions.add(this)
|
|
@consumer = @subscriptions.consumer
|
|
|
|
# Perform a channel action with the optional data passed as an attribute
|
|
perform: (action, data = {}) ->
|
|
data.action = action
|
|
@send(data)
|
|
|
|
send: (data) ->
|
|
@consumer.send(command: "message", identifier: @identifier, data: JSON.stringify(data))
|
|
|
|
unsubscribe: ->
|
|
@subscriptions.remove(this)
|
|
|
|
extend = (object, properties) ->
|
|
if properties?
|
|
for key, value of properties
|
|
object[key] = value
|
|
object
|