Reference version

This documentation is available as Markdown for AI agents and LLMs. See the full Markdown index or append .md to any documentation URL.

Expo Hinge

提供 Android 折叠设备和 iPhone Duo 设备铰链角度与状态的库。

Android
iOS

expo-hinge 将折叠设备的铰链(例如 Android 折叠设备或 iPhone Duo)暴露给整个应用。它会报告角度(单位为度),以及铰链是闭合、部分打开还是完全打开。在 Android 上,铰链角度传感器提供角度,Jetpack WindowManager 的 FoldingFeature 提供状态。在 iOS 上,应用窗口中的 UIHingeInteraction 提供这些值。如果只需要在一个 SwiftUI 视图中响应铰链变化,请改用 @expo/ui 的 onHingeChange 修饰符。

Android 上的状态

Android 没有用于报告铰链闭合状态的公共 API,因此 Android 上的状态永远不会是 closed。只有当应用窗口跨越折叠处时,Android 才会报告铰链状态。其他情况下(例如设备闭合时的外屏),状态为 unknown,但 Android 仍会报告角度。要在 Android 上检测设备是否闭合,请检查接近 0 的角度。请选择适合应用的阈值,因为设备制造商定义的角度范围各不相同。

安装

Terminal
- npx expo install expo-hinge
- yarn expo install expo-hinge
- pnpm expo install expo-hinge
- bun expo install expo-hinge

If you are installing this in an existing React Native app, make sure to install expo in your project.

用法

import { useHinge } from 'expo-hinge'; import { StyleSheet, Text, View } from 'react-native'; export default function App() { const hinge = useHinge(); return ( <View style={styles.container}> <Text>{hinge ? `${hinge.status} at ${Math.round(hinge.angle)}°` : 'No hinge'}</Text> </View> ); } const styles = StyleSheet.create({ container: { flex: 1, alignItems: 'center', justifyContent: 'center', }, });

API

import * as Hinge from 'expo-hinge';

Hooks

useHinge()

Android
iOS

Returns the live hinge state and re-renders on every change. The first render already has the current value, since the native module caches it.

Returns:
Hinge | null

Example

const hinge = useHinge(); return <Text>{hinge ? `${hinge.status} at ${hinge.angle}°` : 'No hinge'}</Text>;

Methods

getHinge()

Android
iOS

Returns the current hinge state synchronously, or null when the API is unavailable, the device has no hinge, or the app's window provides no hinge updates.

Returns:
Hinge | null

Example

Hinge.getHinge(); // { angle: 120, status: 'partiallyOpen' }

isAvailable()

Android
iOS

Returns whether this build and OS can report the hinge: Android 11 (API level 30) or later, or iOS 27.1 or later, built with the iOS 27.1 SDK. It does not mean the device has a hinge, which getHinge() answers with a non-null value. Always false on web.

Returns:
boolean

Event subscriptions

addHingeListener(listener)

Android
iOS
ParameterTypeDescription
listener(event: HingeChangeEvent) => void

A callback that is invoked with a HingeChangeEvent.


Subscribes to hinge changes. The listener is called on every angle or status change, and with a null hinge when the window stops providing hinge updates. Use hinge state for interactions and effects, not for layout.

Returns:
EventSubscription

An EventSubscription whose remove() unsubscribes the listener.

Types

ExpoHingeModuleEvents

Android
iOS
PropertyTypeDescription
hingeChange(event: HingeChangeEvent) => void
-

Hinge

Android
iOS

State of the device hinge.

PropertyTypeDescription
anglenumber

The current angle of the hinge in degrees, where 0 is closed and 180 is flat. The rate and granularity of angle updates are system policy, so do not depend on a particular update frequency or precision. Prefer status when you only need to know whether the hinge is closed, partially open, or fully open, except on Android, where status is never closed. On Android, the angle comes from the hinge angle sensor.

statusHingeStatus

The current status of the hinge, determined by the system from the angle and device orientation.

HingeChangeEvent

Android
iOS
PropertyTypeDescription
hingeHinge | null

The current hinge, or null when the device has no hinge, the app's window provides no hinge updates, or, on Android, the device has no hinge angle sensor.

HingeStatus

Android
iOS

Literal type: string

Status of the device hinge, as reported by the state of Jetpack WindowManager's FoldingFeature on Android and by UIKit's UIHinge.Status on iOS. Android has no public API for a closed hinge, so it never reports closed. It reports unknown while the app's window does not span the fold, such as on the outer screen of a closed device. To detect a closed device on Android, check for an angle near 0 with a threshold that suits your app.

Acceptable values are: 'closed' | 'partiallyOpen' | 'fullyOpen' | 'unknown'