Telegram 小程序 | TypeScript @telegram-apps/sdk-solid @1.x

riyad

用于 客户端 SDK 的Solid JS 绑定。 包括钩子、组件和 实用程序，以便在 Telegram Mini Apps 平台上轻松使用 Solid JS。

) ]) ^3 V, N3 O& N( N' M$ h2 W$ y

安装​

在此之前，我们假定您已经安装了 solid-js 软件包，因为 是该软件包的同级依赖关系。

pnpm :

1. pnpm i @telegram-apps/sdk-solid

复制代码

npm :

1. npm i @telegram-apps/sdk-solid

复制代码

yarn :

1. yarn add @telegram-apps/sdk-solid

复制代码

SDKProvider​

SDKProvider 是负责提供 SDK 功能的组件。 它接受 acceptCustomStyles: boolean 和 debug: boolean 等属性。 两者都是可选的。

acceptCustomStyles 属性负责接受来自 Telegram 网页版的自定义样式。

debug 属性负责启用调试模式。

1. import { SDKProvider } from '@telegram-apps/sdk-solid';
   
2. 
   ( Z# I7 y; U: A
3. /**
   0 ~' ~. u. d2 J; ^+ o
4. * Root component for the whole project.
   
5. */
   ! @7 Y; Z, W* v' W) u+ O/ q
6. export function Root() {
   8 t# a: l# {7 J/ ^1 ~. v. d
7.   return (
   
8.     <SDKProvider acceptCustomStyles debug>
   
9.       <div>My application!</div>
   9 M8 @0 B/ i  Y3 o2 r
10.     </SDKProvider>
    ; @, @- \5 c/ o4 G& [2 u
11.   );
    9 ^' O$ t1 }4 E' L, G& ]0 U% h
12. }

复制代码

Hooks​

该软件包中的每个组件钩子都会返回一个自定义信号。 返回的信号包含一个 属性 error?: unknown，如果在组件 初始化过程中出现问题，该属性将被设置。 调用包含该属性的信号将导致产生相应的 错误。 如果没有错误发生，信号将返回一个组件实例。

为了更好地理解，每个组件钩子都使用各自与组件相关的 init 函数。 如果 init 函数返回的是非承诺值，钩子将立即检索该值。 如果 init 函数 是异步的，那么当组件 仍在初始化时，钩子将返回一个带有 undefined 值的信号。 然后，它将更新为初始化值。

下面就是一个例子：

1. import { useBackButton, useViewport } from '@telegram-apps/sdk-solid';
     g% h6 [: x/ k) W
2. 
   ; a% u3 e% }* j. }
3. // BackButton initializes synchronously. So, bb will be a signal
   4 v+ u1 ^' ?7 f, P/ }) p6 }% L2 T
4. // returning an instance of BackButton.
   $ Z4 x$ n6 [1 ?' \) y$ Y6 A
5. const bb = useBackButton();
   6 B( _* X) p" a' R* N2 q- s+ P  W9 @
6. const bbV = bb(); // will be BackButton
   9 A" h6 ?2 }: ]9 l+ g* J
7. 
   
8. // Viewport is being initialized asynchronously, so signal may return undefined.
   
9. // After some time it will receive a valid value.
   
10. const vp = useViewport();
    1 i5 b* U; `& u$ W) O3 r
11. const vpV = vp(); // will be undefined
    , i; F1 R/ d) U
12. 
    / M: y' n! e, t, ]0 t! L
13. // ...after some time
    1 W4 s* b8 H3 M1 q% C: v+ Q8 P
14. const vpV2 = vp(); // will be Viewport

复制代码

需要注意的是，所有成分的属性都是反应性的。 因此，如果钩子信号返回的值发生变化 ，信号本身不会收到通知。 这是因为 组件本身没有变化，但其属性发生了变化。

让我们来看看这个例子：

1. import { useViewport } from '@telegram-apps/sdk-solid';
   2 |- ?& g" l, D9 W# R
2. import { createEffect } from 'solid-js';
   0 r0 f' ~7 m3 {7 b: h" [
3. 
   
4. // Let's assume that viewport is already initialized.
   
5. const vp = useViewport();
   
6. 
   . U2 x& j  c% i
7. createEffect(() => {
   " J: h6 s+ N7 x  L8 A  j
8.   // This line of code will not be called if the viewport height
   ; N( A4 U; _1 d
9.   // or expansion state changes.
   % s; t% a' V" S7 x% B8 `% d
10.   console.log('Viewport changed', vp());
    
11. });
    % z& |# m4 H( J3 ?) s& C
12. 
    
13. createEffect(() => {
    1 P1 N$ _* R) U5 k2 W: L6 C
14.   // But this line of code will be called every time the viewport
    ; C$ r1 X1 I( V/ @  d  P
15.   // height changes.
    " ]$ W8 V( Q& y! G4 j# g
16.   console.log('Viewport height changed', vp().height);
    & x& r; P6 [( ~% B
17. });

复制代码

我们拥有这种细粒度的反应能力，以提供最佳性能，就像 Solid 本身一样。

HOCs​

所有软件包的高阶组件都使用了前面所述的钩子。 使用方法相当 简单：

1. import { withBackButton } from '@telegram-apps/sdk-solid';
   
2. 
   
3. const MyComponent = withBackButton('bb', (props) => {
   ! R; X( H5 z* ^3 h
4.   createEffect(() => {
   4 W* `" R8 M1 C. f
5.     props.bb().show();
   
6.   });
   
7.   return null;
   
8. });

复制代码

作为第一个参数，您必须传递一个负责接收 钩子结果的组件属性名称的值。 请注意，接收到的值将是一个信号，而不是后面的值。
) q( e- s0 {9 u# ZHooks 和 HOCs 列表​[td]

Hook	HOC	Signal value
useBackButton	withBackButton	BackButton
useBiometryManager	withBiometryManager	BiometryManager 或 undefined
useClosingBehavior	withClosingBehavior	ClosingBehavior
useCloudStorage	withCloudStorage	CloudStorage
useHapticFeedback	withHapticFeedback	HapticFeedback
useInitData	withInitData	InitData
useInvoice	withInvoice	Invoice
useMainButton	withMainButton	MainButton
useMiniApp	withMiniApp	MiniApp
usePopup	withPopup	Popup
useQRScanner	withQRScanner	QRScanner
useSettingsButton	withSettingsButton	SettingsButton
useSwipeBehavior	withSwipeBehavior	SwipeBehavior
useThemeParams	withThemeParams	ThemeParams
useUtils	withUtils	Utils
useViewport	withViewport	Viewport 或 undefined

模板​

我们已经为 Solid JS 创建了一个使用当前软件包的 模板，您可以使用它。