Leverage JSON-RPC to communicate between your Figma plugin and your Figma UI
Leverage JSON-RPC to communicate between your Figma plugin and your Figma UI.
``bash`
npm install figma-jsonrpc
- Define your API in a separate file (in api.ts for example):
`ts
import { createPluginAPI, createUIAPI } from "figma-jsonrpc";
// those methods will be executed in the Figma plugin,
// regardless of where they are called from
export const api = createPluginAPI({
ping() {
return "pong";
},
setToken(token: string) {
return figma.clientStorage.setAsync("token", token);
},
getToken() {
return figma.clientStorage.getAsync("token");
}
});
// those methods will be executed in the Figma UI,
// regardless of where they are called from
export const uiApi = createUIAPI({
selectionChanged(selection) {
return "pong";
}
});
`
- Use the UI API in the plugin:
`ts
import { uiApi } from "./api";
// This shows the HTML page in "ui.html".
figma.showUI(__html__);
figma.on("selectionchange", () => {
uiApi.selectionChange(figma.currentPage.selection);
});
`
- Use the API in the UI:
`ts
import { api } from "./api";
const pong = await api.ping();
const token = await api.getToken();
await api.setToken("new token");
`
The typescript definition of the API is automatically inferred from the methods passed to rpc :sparkles:.
> :warning: You always need to import the API in both the plugin and the UI, even if you aren't using it. It is necessary so that both part can handle calls from each other.
Using React? There are a couple of treats for you.
Two React hooks you can use in your UI which will setup the necessary APIs for you.
- useFigmaSelection: get and set the current Figma selection
`js
import useFigmaSelection from "figma-jsonrpc/hooks/useFigmaSelection";
const Component = () => {
const [selection, setSelection] = useFigmaSelection();
};
`
- useFigmaSetting: get and set any setting
`js
import useFigmaSetting from "figma-jsonrpc/hooks/useFigmaSetting";
const Component = () => {
const [token, error, loading, setToken] = useFigmaSetting("token");
};
`
In both cases, you also need to import figma-jsonrpc/hooks/*` in your plugin to create the APIs.
MIT