Installation
Nos produits SDK sont servis à partir d'une source unique.
- React
- React Native
- Vanilla JavaScript
Les SDK sont conçus pour fonctionner avec React et d'autres cadriciels déclaratifs.
D'abord, installez le script d'entrée avec npm, yarn ou pnpm :
npm i --save @local-logic/sdks-js
yarn add @local-logic/sdks-js
pnpm add @local-logic/sdks-js
Exemple
import { useRef, useEffect } from "react";
import LLSDKsJS from "@local-logic/sdks-js";
const globalOptions = {
locale: "en", // Si disponible, changer pour anglais ou français
appearance: {
// Ajoutez ici toute autre modification d'apparence
// Consultez la section "Appearance" ci-dessous pour la liste des options disponibles.
variables: {
"--ll-color-primary": "#fd3958",
"--ll-color-primary-variant1": "#d5405b",
"--ll-font-family": "Avenir, sans-serif"
}
}
};
const localLogicClient = LLSDKsJS("your-api-key-here", globalOptions);
function MySDKComponent() {
const containerRef = useRef(null);
useEffect(() => {
if (!containerRef.current) {
return;
}
const sdkOptions = {
lat: 45.5282164, lng: -73.5978527
// ...Autres options propres au SDK
}
const sdkInstance = localLogicClient.create(
"<SDK-NAME>",
containerRef.current,
sdkOptions,
);
// Il est important de détruire l'instance du SDK lorsque le composant est démonté.
return () => {
sdkInstance.destroy();
}
}, []);
return (
<div
ref={containerRef}
style={{
// La hauteur dépend du SDK que vous implémentez
height: "100% || 100vh",
width: "100%",
}}
/>
);
}
export default MySDKComponent;
Le composant SDK React Native de Local Logic vous permet d'ajouter facilement l'un de nos SDK à vos applications natives Android et iOS à l'aide de React Native.
D'abord, installez le script d'entrée avec npm, yarn ou pnpm :
npm i --save @local-logic/sdks-js
yarn add @local-logic/sdks-js
pnpm add @local-logic/sdks-js
Installer la dépendance React Native Webview
React Native Webview est utilisé pour porter les SDK Local Logic vers React Native.
Expo CLI
Installez la version prise en charge de react-native-webview pour les applications Expo à l'aide d'Expo CLI.
npx expo install react-native-webview
React Native CLI
Installez react-native-webview à l'aide du gestionnaire de paquets de votre projet :
npm i --save react-native-webview
yarn add react-native-webview
pnpm add react-native-webview
Si vous utilisez CocoaPods, dans le répertoire ios/ ou macos/, exécutez :
pod install
Utilisation
Le composant React Native accepte les mêmes options que nos SDK Web par l'intermédiaire de ses propriétés options, appearanceOptions et renderOptions.
import LLSDKs from "@local-logic/sdks-react-native";
const globalOptions = {
locale: "en", // Changer pour anglais ou français
appearance: {
// Ajoutez ici toute autre modification d'apparence
// Consultez la section "Appearance" ci-dessous pour la liste des options disponibles
variables: {
"--ll-color-primary": "#fd3958",
"--ll-color-primary-variant1": "#d5405b",
"--ll-font-family": "Avenir, sans-serif"
}
}
};
const sdkOptions = {
lat: 45.5282164, lng: -73.5978527
// ...Autres options propres au SDK
};
<LLSDKs
apiKey="your-api-key-here"
sdkType="<SDK-NAME>"
options={sdkOptions}
appearanceOptions={globalOptions}
renderOptions={{ lazy: false }}
/>
Le script est disponible aux formats umd et es à partir du CDN de Local Logic : https://sdk.locallogic.co/sdks-js/<VERSION>/index.<FORMAT>.js
<VERSION> est le dernier numéro de version du script (que vous pouvez trouver sur npm), et <FORMAT> est soit umd, soit es.
Exemple
<!DOCTYPE html>
<html>
<head>
<title>SDK Javascript Example</title>
<meta charset="UTF-8" />
</head>
<body>
<script
async
src="https://sdk.locallogic.co/sdks-js/<version>/index.umd.js"
onload="loadSDKComponent()"
></script>
<style>
#<SDK-NAME>-widget {
height: recommended height for the widget;
width: 100%;
}
</style>
<!--REMARQUE : Si vous implémentez plusieurs SDK, assurez-vous de créer des ID uniques pour chacun-->
<div id="<SDK-NAME>-widget"></div>
<script>
const globalOptions = {
locale: "en", // Changer pour anglais ou français
appearance: {
// Ajoutez ici toute autre modification d'apparence
// Consultez la section "Appearance" ci-dessous pour la liste des options disponibles
variables: {
"--ll-color-primary": "#fd3958",
"--ll-color-primary-variant1": "#d5405b",
"--ll-font-family": "Avenir, sans-serif"
}
}
};
function loadSDKComponent() {
// Votre clé API ou jeton
const ll = LLSDKsJS("your-api-key-here", globalOptions);
// Il s'agit du div qui contiendra le widget
const sdkContainer = document.getElementById("<SDK-NAME>-widget");
const sdkOptions = {
lat: 45.5282164, lng: -73.5978527
// ...Autres options propres au SDK
}
const sdkInstance = ll.create("<SDK-NAME>", sdkContainer, sdkOptions);
}
</script>
</body>
</html>