@callstack/liquid-glass

中文文档
0.8.2发布于 2026/09/16MITTypeScriptCommonJS零依赖近 30 天下载 67.5万

反应中的液态玻璃

中文使用文档
文档目录8 节
  1. 特征
  2. 文档
  3. 安装
  4. 使用量
  5. API 密码
  6. 液态GlassView - 道具
  7. 液晶容器维尤 - 道具
  8. 由 Calltack 制作

反应原生液体玻璃 QQ

mit licence npm version npm downloads npm downloads

@callstack/liquid-glass 带来iOS 26 液相玻璃效果,在iOS上反应原生应用程序.

https://github.com/user-attachments/assets/44c18136-8760-49f2-ae16-62557c3ae2e1 互联网档案馆的存檔,存档日期2014-12-02

特征

  • iOS 26 液态玻璃视觉效果
  • QQ 可自定义的颜色
  • QQ 两种效果模式: clear 财务报告和审定财务报表 regular

文档

安装

npm install @callstack/liquid-glass
# or
yarn add @callstack/liquid-glass

[尖叫声] 请务必使用 Xcode QQ 26. 重新编译您的应用程序 .

[尖叫声] 此库不支持于 博览去。 。 。 .

使用量

import {
  LiquidGlassView,
  LiquidGlassContainerView,
  isLiquidGlassSupported,
} from '@callstack/liquid-glass';

function MyComponent() {
  return (
    <LiquidGlassView
      style={[
        { width: 200, height: 100, borderRadius: 20 },
        !isLiquidGlassSupported && { backgroundColor: 'rgba(255,255,255,0.5)' },
      ]}
      interactive
      effect="clear"
    >
      <Text>Hello World</Text>
    </LiquidGlassView>
  );
}

// For combining multiple glass elements
function MergingGlassElements() {
  return (
    <LiquidGlassContainerView spacing={20}>
      <LiquidGlassView style={{ width: 100, height: 100, borderRadius: 50 }} />
      <LiquidGlassView style={{ width: 100, height: 100, borderRadius: 50 }} />
    </LiquidGlassContainerView>
  );
}

为了实现基于玻璃视图后方背景的自动文本色彩调整,使用 PlatformColor 从 react-native数字 :

[注] 玻璃似乎有大小限制来自动调整文字颜色. 如果玻璃取景高度为->=65,则不会自动适应其背后的材料.

https://github.com/user-attachments/assets/199bce70-dab4-43bc-9de1-605f561760e5 互联网档案馆的存檔,存档日期2013-12-2

import { PlatformColor } from 'react-native';
import { LiquidGlassView } from '@callstack/liquid-glass';

function MyComponent() {
  return (
    <LiquidGlassView style={{ padding: 20, borderRadius: 20 }}>
      <Text style={{ color: PlatformColor('labelColor') }}>Hello World</Text>
    </LiquidGlassView>
  );
}

[注] 在不支持的iOS版本(低于iOS 26)上,它将使一个正常 View 没有任何效果.

API 密码

isLiquidGlassSupported

一个布尔常数,表示当前设备是否支持液体玻璃效应.

import { isLiquidGlassSupported } from '@callstack/liquid-glass';

if (isLiquidGlassSupported) {
  // Device supports liquid glass effect
} else {
  // Provide fallback UI
}

液态GlassView - 道具

Prop类型默认说明
interactivebooleanfalse按下视图时启用触摸交互效果
effect'clear' | 'regular' | 'none''regular'视觉效果模式 :
二. 支助 clear - 更透明的玻璃效果
二. 支助 regular - 标准玻璃模糊效果
二. 支助 none - 无玻璃效果(透明视图)
说明: 改变这个属性动画将玻璃效果的物质化/去物质化
animatedbooleantrue是否对玻璃效果进行动画修改
animationDurationnumberundefined玻璃效果动画持续时间以毫秒计. 如果省略,则使用默认的 UIKit 动画持续时间
tintColorColorValueundefined叠加色线适用于玻璃效果. 接受任何反应的土著颜色格式(hex、rgba、已命名的颜色)
colorScheme'light' | 'dark' | 'system''system'色彩方案调整 :
二. 支助 light - 轻而易举
二. 支助 dark - 黑暗的外观
二. 支助 system - 遵循系统外观

液晶容器维尤 - 道具

Prop类型默认说明
spacingnumber0儿童元素之间的距离,他们开始将其玻璃效应合并成综合效应

由 Calltack 制作

liquid-glass 是一个开源项目,将永远自由使用。 如果你觉得这很酷,请 显示它.

调用 一群反动和反动的本地怪人 联系我们 你好@ callstack.com 如果你需要帮忙的话 或者只是想打个招呼!

喜欢这个项目吗 加入队伍吧 谁为客户做惊人的事情 驱动 React Independent Open Source

版本与发布记录

@callstack/liquid-glass 共发布 15 个版本,首次发布于 2025/09/02;过去 12 个月发布了 7 个版本。

版本发布日期距今
0.8.2latest2026/09/161 个月前
0.8.12026/08/182 个月前
0.8.02026/06/015 个月前
0.7.12026/03/277 个月前
0.7.02025/12/1710 个月前
0.6.12025/12/0411 个月前

关于 @callstack/liquid-glass 的常见问题

@callstack/liquid-glass 是什么?

反应中的液态玻璃

如何安装 @callstack/liquid-glass?

在项目目录运行 npm install @callstack/liquid-glass,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(*)、react-native(*)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@callstack/liquid-glass 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@callstack/liquid-glass 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@callstack/liquid-glass 可以商用吗?

@callstack/liquid-glass 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@callstack/liquid-glass 的下载量有多少?

根据 npm 官方下载统计,@callstack/liquid-glass 在 2026/10/09 – 2026/11/07 这 30 天内被下载 674,704 次,日均约 22,490 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@callstack/liquid-glass 还在维护吗?

最新版本 0.8.2 发布于 2026/09/16(1 个月前);至今共发布 15 个版本,其中过去 12 个月发布了 7 个;首次发布于 2025/09/02。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。