Mailspring/examples/N1-Message-View-on-Github/lib/main.cjsx

58 lines
2 KiB
Text
Raw Normal View History

###
This package displays a "Vew on Github Button" whenever the message you're
looking at contains a "view it on Github" link.
This is the entry point of an N1 package. All packages must have a file
called `main` in their `/lib` folder.
The `activate` method of the package gets called when it is activated.
This happens during N1's bootup. It can also happen when a user manually
enables your package.
Nearly all N1 packages have similar `activate` methods. The most common
action is to register a {React} component with the {ComponentRegistry}
See more details about how this works in the {ComponentRegistry}
documentation.
In this case the `ViewOnGithubButton` React Component will get rendered
whenever the `"message:Toolbar"` region gets rendered.
Since the `ViewOnGithubButton` doesn't know who owns the
`"message:Toolbar"` region, or even when or where it will be rendered, it
has to load its internal `state` from the `GithubStore`.
The `GithubStore` is responsible for figuring out what message you're
looking at, if it has a relevant Github link, and what that link is. Once
it figures that out, it makes that data available for the
`ViewOnGithubButton` to display.
###
{ComponentRegistry} = require 'nylas-exports'
ViewOnGithubButton = require "./view-on-github-button"
###
All packages must export a basic object that has at least the following 3
methods:
1. `activate` - Actions to take once the package gets turned on.
Pre-enabled packages get activated on N1 bootup. They can also be
activated manually by a user.
1. `deactivate` - Actions to take when a package gets turned off. This can
happen when a user manually disables a package.
1. `serialize` - A simple serializable object that gets saved to disk
before N1 quits. This gets passed back into `activate` next time N1 boots
up or your package is manually activated.
###
module.exports =
activate: (@state={}) ->
ComponentRegistry.register ViewOnGithubButton,
roles: ['message:Toolbar']
deactivate: ->
ComponentRegistry.unregister(ViewOnGithubButton)
serialize: -> @state