Function Fetching
Function Declarations
Intlayer allows you to declare content functions in your content modules, which can be either synchronous or asynchronous. When the application builds, Intlayer executes these functions to obtain the function's result. The return value must be a JSON object or a simple value like a string or number.
Here's an example of a simple synchronous function fetching content:
import type { DeclarationContent } from "intlayer";
const functionContent: DeclarationContent = {
id: "function_content",
text: () => "This is the content rendered by a function",
};
export default functionContent;
In this example, the text key contains a function that returns a string. This content can be rendered in your React components using Intlayer's interpreter packages like react-intlayer.
Asynchronous Function Fetching
In addition to synchronous functions, Intlayer supports asynchronous functions, allowing you to fetch data from external sources or simulate data retrieval with mock data.
Below is an example of an asynchronous function that simulates a server fetch:
import { setTimeout } from "node:timers/promises";
import type { DeclarationContent } from "intlayer";
const fakeFetch = async (): Promise<string> => {
// Wait for 200ms to simulate a fetch from the server
return await setTimeout(200).then(
() => "This is the content fetched from the server"
);
};
const asyncFunctionContent: DeclarationContent = {
id: "async_function",
text: fakeFetch,
};
export default asyncFunctionContent;
In this case, the fakeFetch function mimics a delay to simulate server response time. Intlayer executes the asynchronous function and uses the result as the content for the text key.
Using Function-Based Content in React Components
To use function-based content in a React component, you need to import useIntlayer from react-intlayer and call it with the content ID to retrieve the content. Here's an example:
import { useIntlayer } from "react-intlayer";
const MyComponent = () => {
const functionContent = useIntlayer("function_content");
const asyncFunctionContent = useIntlayer("async_function_content");
return (
<div>
<p>{functionContent.text}</p>
{/* Output: This is the content rendered by a function */}
<p>{asyncFunctionContent.text}</p>
{/* Output: This is the content fetched from the server */}
</div>
);
};
export default MyComponent;