Lynx 配置参考

该文档由 AI 翻译生成

导览

Lynx 配置概述

配置项描述
absoluteInContentBound当设置为 true 时,绝对定位/固定定位元素的包含块是内容区域;否则,它是内边距区域。
asyncRedirect启用 Android Lynx 图片 URL 异步重定向
autoExpose如果此标志为 true,则 onShow/onHide 将由 attachToView/detachFromWindow 调用自动触发。
CSSAlignWithLegacyW3C当设置为 true 时,为了兼容,一些布局行为会与之前的错误行为保持一致。
customCSSInheritanceList自定义可继承的 CSS 属性
dataStrictModeReactLynx 无法选择在 lepus 中使用的顶级变量。因此,当变量不在顶级变量中时,我们无法禁止 updateData。用户可以使用此配置来关闭该检查。
debugInfoOutsideNA
defaultDisplayLinearNA
defaultOverflowVisibleNA
disableLongpressAfterScroll防止在惯性滚动期间触发长按事件。
disableMultipleCascadeCSSNA
disableQuickTracingGC在快速上下文环境中禁用跟踪垃圾回收(GC)模式。
enableA11y启用安卓无障碍功能(注:A11y 是 Accessibility 的缩写,在安卓开发语境中常代表无障碍功能)
enableAccessibilityElement指示是否所有用户界面(UI)都启用了无障碍访问功能(a11y)。
enableAsyncInitVideoEngine是否启用 videoEngine 的异步初始化
enableAsyncRequestImage如果为真,则支持在异步线程中发起图像请求。
enableAsyncResolveSubtree前端(FE)框架使用此配置来通知引擎,在渲染 DOM 时将触发解析子树绑定(不向普通用户公开)。
enableCheckExposureOptimize启用曝光检测优化,以便在页面静止时不执行曝光检测。
enableCheckLocalImage确定本地图片资源是否需要重定向。
enableCircularDataCheck如果此标志为 true,则在将 JavaScript 值转换为其他值时将启用循环数据检查。
enableComponentAsyncDecode在异步加载时,允许动态组件在被传递到 TASM 之前,先在子线程中进行解码处理。
enableComponentConfigNA
enableComponentNullProp支持组件可以传入空属性,目前仅在 LepusNG 中支持空属性。打开此开关以支持 Lepus 使用空属性。
enableCreateViewAsync在 Lynx 内置线程池中创建安卓平台的用户界面(UI),以优化 UI 操作执行。
enableCSSAsyncDecodeNA
enableCSSClassMergeNA
enableCSSEngineNA
enableCSSExternalClassNA
enableCSSInheritance启用 CSS 继承
enableCSSInlineVariables启用 CSS 内联变量。
enableCSSInvalidation如果启用 CSS 失效机制,我们会使用 RuleInvalidationSet 来收集选择器失效信息。
enableCSSLazyDecodeNA
enableCSSLazyImport在作用域 CSS 下,通过 import 规则导入的 CSS 声明会在该作用域首次生效时进行惰性解码。
enableCSSSelector此开关将在 Blink 标准模式下启用 CSS 模块。
enableCSSStrictModeCSS 长度值应由一个 <number> 后跟一个单位组成。在严格模式下,无效的 <length> 值将被丢弃。
enableCSSVariableNA
enableDisexposureWhenLynxHidden当 LynxView 处于隐藏状态时,启用曝光消失事件触发功能。
enableEndGestureAtLastFingerUp在多指场景下,确保最后一根手指抬起后,Lynx触摸事件能正常触发。
enableEventHandleRefactor启用新的事件处理逻辑,以支持事件监听器的动态注册、事件拦截等功能。
enableEventRefactorNA
enableEventThrough在触摸 Lynx 页面的根节点区域时,允许客户端滑动触摸事件穿透 Lynx。
enableExposureUIMargin启用 exposure-ui-margin-* 属性以使其生效。
enableExposureWhenLayout当 LynxView 进行布局请求时,启用暴露检查。
enableExposureWhenReload启用在重新加载 Lynx 页面时触发曝光和取消曝光事件的功能。
enableFiberArchNA
enableFixedNew更出色且稳定的固定定位处理。
enableFlexibleTemplate如果启用此值,模板将被编码为灵活模板。
enableHarmonyNewOverlay启用基于 Harmony 新覆盖层的 OverlayManager 来处理事件穿透。
enableHarmonyVisibleAreaChangeForExposure使 Harmony 能够通过可见区域更改事件检测曝光情况。
enableICU启用绑定 PRIMJS-ICU
enableImageDownsampling如果为 true,则会为此 LynxView 上的所有图像启用下采样。
enableJsBindingApiThrowException启用 JavaScript 绑定 API 抛出异常
enableJSDataProcessor在 JavaScript 线程上启用数据处理器
enableKeepPageDataNA
enableListMoveOperationdiffResult 是否有移动操作(moveAction)
enableListNewArchitecture指示是否为平台列表使用新架构。
enableListPlug指示是否使用列表插件
enableLynxScrollFluency强制上报 Lynx 滚动流畅度事件。当将 pageConfig.enableLynxScrollFluency 设置为一个范围在 [0, 1] 的双精度值时,我们将基于此概率来监控这个基于 LynxUI 的流畅度指标。该概率表示启用流畅度监控的可能性,并且这些指标将通过 applogService 无条件上报。
enableMicrotaskPromisePolyfill这个配置项 enableMicrotaskPromisePolyfill 用于确定是否启用微任务 Promise 垫片。其值的类型为 TernaryBool,默认值为 TernaryBool::UNDEFINE_VALUE
enableMTSPreExecute启用 MTS 虚拟机预执行代码。
enableMultiTouch启用对多指事件的支持,以便事件参数可以包含多个手指的信息。
enableMultiTouchParamsCompatible启用与单指事件兼容的多指事件参数
enableNativeList指示是否使用 C++ 列表。
enableNewAnimator如果此标志为 false,则将使用平台动画能力。
enableNewClipMode是否启用新的裁剪模式。
enableNewGesture如果想使用手势处理程序 API,你需要将其设置为 true。
enableNewImage启用从图像服务加载图像的功能
enableNewIntersectionObserver启用新的 IntersectionObserver 检测逻辑,以便在不绑定滚动事件的情况下,observe 能够正常触发。
enableNewListContainer在 iOS 平台上基于 ScrollView 实现平台级列表。
enableNewTransformOrigin如果此标志为 true,将应用新的变换原点算法。
enablePlatformGesture启用影子平台手势以处理手势冲突。
enablePropertyBasedSimpleStyle如果此配置设置为 TRUE,SimpleStyle 模式将根据属性逐步更新样式。否则,它将根据 StyleObject 逐步更新。基于 StyleObject 的更新性能更好,但不允许绑定到同一元素的 StyleObject 具有相交属性。
enableQueryComponentSync在后台运行时启用查询组件同步
enableReactOnlyPropsId如果我们有了 propsId,我们就可以只将 propsId 和一个标志传递给 JS 线程。JS 线程将使用一个 propsMap 来获取正确的属性。
enableReduceInitDataCopy如果此标志为 true,则不复制初始化数据,而是为了提高效率复制初始化数据的 Object.keys
enableReloadLifecycle启用 LynxUI 的 onNodeReload 生命周期。
enableRemoveComponentExtraData如果此标志为 true,则为了提高效率,从组件数据中移除 globalPropssystemInfo
enableRemoveCSSScopeNA
enableReuseLoadScriptExports启用复用 loadScript 的结果。
enableSignalAPI启用 Signal API
enableSimpleStyling使用简化样式模块。
enableSimultaneousTap启用客户端的点击手势,使其能与 Lynx 的点击手势同时触发。
enableTextBoringLayout启用在 Android 上使用 BoringLayout。
enableTextGradientOpt为 iOS 启用文本渐变优化。
enableTextLanguageAlignment启用更精确的文本对齐判断方法,但这会增加文本布局所需的时间。
enableTextLayerRender启用在 iOS 上使用文本层渲染。
enableTextLayoutCache是否启用文本布局缓存。
enableTextNonContiguousLayout是否启用文本非连续布局
enableTextOverflow如果为 true,则将文本溢出设置为可见。
enableTextRefactor启用文本重构功能,使其行为更符合网页规范。
enableTouchRefactor使 Lynx 的 touchend 事件能够正常触发。
enableUIOperationOptimize在安卓系统上启用关于 UI 操作批量处理和异步创建视图(CreateViewAsync)的优化。
enableUnifiedPipeline为 Lynx 引擎启用统一像素管道。
enableUnifyFixedBehavior统一旧固定模式和新固定模式之间的行为
enableUseContextPool启用在LepusNG虚拟机创建时使用上下文池。
enableUseMapBuffer为 LynxProps 启用 mapbuffer 结构。
enableViewReceiveTouch启用 touchesBegan 及其他方法,使其在触摸客户端滑动自定义组件时被触发。
enableVsyncAlignedFlush根据垂直同步(VSync)信号驱动流水线中的 UI 任务执行,带来一定的渐进式渲染效果。适用于 JavaScript(JS)驱动的更新频繁的场景。可根据需要开启。
enableXTextLayoutReused是否启用 x-text 布局复用。
experimental_encodeQuickjsBytecode允许在模板中对 QuickJS 字节码而不是源代码进行编码。
extendedLayoutOnlyOpt一个用于强制使某些特殊属性仅可用于布局的配置(例如 direction 和 text-align 等)。
extraInfo用户定义的额外信息。
flatten控制该节点是否需要创建对应的 Android 视图。默认值为 true。
fontScaleEffectiveOnlyOnSp仅让字体缩放应用于 sp 单位。
forceCalcNewStyleNA
implicit控制是否允许在 iOS 平台上使用隐式动画。
implicitAnimationNA
includeFontPadding控制 Android 上文本的顶部和底部内边距,这会影响文本的高度和垂直居中效果。
keyboardCallbackPassRelativeHeight包裹 Lynx 视图的外部装饰视图可能会因虚拟导航栏被屏蔽或绘制而发生变化。修改键盘事件的返回值,以返回绝对键盘高度以及键盘到 Lynx 视图底部的偏移量。
longPressDuration指定触发长按事件的间隔。
observerFrameRate指定暴露检测的频率。
pipelineSchedulerConfig管道的调度器配置,包括启用并行元素/列表框架批量渲染以及其他调度器配置。
preferredFps控制 CSS 动画的帧率
quirksMode支持字符串值。默认情况下,它等于 TargetSDKVersion。该模式用于兼容不符合所产生的 CSS 布局规范的旧页面。
removeCSSParserLogNA
removeDescendantSelectorScope如果为 false,后代选择器仅在组件作用域内生效。
strictPropType如果此标志为 true,当组件的属性类型不匹配时,将使用默认值。
tapSlop指定滑动距离阈值,达到该阈值时不触发点击事件。
targetSdkVersionNA
templateDebugUrlNA
trailNewImage启用 iOS 图像重构
unifyVWVHBehavior控制诸如 font-size 等属性中的 vwvh 单位是否随视口动态调整;对于 targetSdkVersion >= 2.3 的情况,默认启用此功能。
useImagePostProcessor是否使用图像后处理器
useNewSwiper指示是否使用新的滑动器。
autoResumeAnimation Deprecated过时的配置,将在未来版本中移除。
cli DeprecatedCLI 版本
compileRender DeprecatedNone
customData DeprecatedNone
enableA11yIDMutationObserver Deprecated为无障碍功能启用 MutationObserver。
enableAsyncDisplay Deprecated在 iOS 上全局启用软件渲染内容的异步渲染,这可以大幅优化帧率并减少卡顿。
enableBackgroundShapeLayer Deprecated启用 iOS 后台管理器以应用形状图层优化。此功能已弃用并将被移除,因为该优化已成为固定设置。
enableCascadePseudo Deprecated已弃用,这用于旧版 CSS 选择器以启用级联。
enableCheckDataWhenUpdatePage DeprecatedNone
enableComponentLayoutOnly DeprecatedNone
enableGlobalComponentMap DeprecatedNone
enableNativeScheduleCreateViewAsync Deprecated在 C++ 绘画上下文(PaintingContext)中启用异步创建用户界面(UI)
enableNewAccessibility DeprecatedNone
enableNewLayoutOnly DeprecatedNone
enableOptPushStyleToBundle Deprecated启用使用 PropBundleStyleWriter 将样式写入 PropBundle
enableOverlapForAccessibilityElement DeprecatedNone
fixCSSImportRuleOrder DeprecatedNone
forceCalcNewStyle DeprecatedNone
reactVersion DeprecatedNone
redBoxImageSizeWarningThreshold DeprecatedNone
removeComponentElement Deprecated过时的配置,将在未来版本中移除。
syncImageAttach Deprecated如果条件为真且处于主线程,图像请求将立即发起;否则,图像请求将在主线程的下一帧之后发出,以延迟请求。
useNewImage DeprecatedNone
version DeprecatedNone

Lynx 配置参考


absoluteInContentBound

Android
Harmony
iOS
3.2

当设置为 true 时,绝对定位/固定定位元素的包含块是内容区域;否则,它是内边距区域。

absoluteInContentBound?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


asyncRedirect

Android
3.2

启用 Android Lynx 图片 URL 异步重定向

asyncRedirect?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: undefined


autoExpose

Android
Harmony
iOS
3.2

如果此标志为 true,则 onShow/onHide 将由 attachToView/detachFromWindow 调用自动触发。

autoExpose?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: true


CSSAlignWithLegacyW3C

Android
Harmony
iOS
3.2

当设置为 true 时,为了兼容,一些布局行为会与之前的错误行为保持一致。

CSSAlignWithLegacyW3C?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


customCSSInheritanceList

Android
Harmony
iOS
3.2

自定义可继承的 CSS 属性

customCSSInheritanceList?: string[] | undefined;
  • valueType: string[] | undefined

  • defaultValue: undefined


dataStrictMode

Android
Harmony
iOS
3.2

ReactLynx 无法选择在 lepus 中使用的顶级变量。因此,当变量不在顶级变量中时,我们无法禁止 updateData。用户可以使用此配置来关闭该检查。

dataStrictMode?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: true


debugInfoOutside

Android
iOS
Harmony
3.2

NA

debugInfoOutside?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


defaultDisplayLinear

Android
iOS
Harmony
3.2

NA

defaultDisplayLinear?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: true


defaultOverflowVisible

Android
iOS
Harmony
3.2

NA

defaultOverflowVisible?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: true


disableLongpressAfterScroll

iOS
3.2

防止在惯性滚动期间触发长按事件。

disableLongpressAfterScroll?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


disableMultipleCascadeCSS

Android
iOS
Harmony
3.2

NA

disableMultipleCascadeCSS?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


disableQuickTracingGC

Android
Harmony
iOS
3.2

在快速上下文环境中禁用跟踪垃圾回收(GC)模式。

disableQuickTracingGC?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableA11y

Android
3.2

启用安卓无障碍功能(注:A11y 是 Accessibility 的缩写,在安卓开发语境中常代表无障碍功能)

enableA11y?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableAccessibilityElement

Android
3.2

指示是否所有用户界面(UI)都启用了无障碍访问功能(a11y)。

enableAccessibilityElement?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: true


enableAsyncInitVideoEngine

Android
3.2

是否启用 videoEngine 的异步初始化

enableAsyncInitVideoEngine?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableAsyncRequestImage

Android
3.2

如果为真,则支持在异步线程中发起图像请求。

enableAsyncRequestImage?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableAsyncResolveSubtree

Android
iOS
3.4

前端(FE)框架使用此配置来通知引擎,在渲染 DOM 时将触发解析子树绑定(不向普通用户公开)。

enableAsyncResolveSubtree?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: undefined


enableCheckExposureOptimize

iOS
3.2

启用曝光检测优化,以便在页面静止时不执行曝光检测。

enableCheckExposureOptimize?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableCheckLocalImage

Android
3.2

确定本地图片资源是否需要重定向。

enableCheckLocalImage?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: true


enableCircularDataCheck

Android
Harmony
iOS
3.2

如果此标志为 true,则在将 JavaScript 值转换为其他值时将启用循环数据检查。

enableCircularDataCheck?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: true


enableComponentAsyncDecode

Android
Harmony
iOS
3.2

在异步加载时,允许动态组件在被传递到 TASM 之前,先在子线程中进行解码处理。

enableComponentAsyncDecode?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: undefined


enableComponentConfig

Android
iOS
Harmony
3.2

NA

enableComponentConfig?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableComponentNullProp

Android
Harmony
iOS
3.2

支持组件可以传入空属性,目前仅在 LepusNG 中支持空属性。打开此开关以支持 Lepus 使用空属性。

enableComponentNullProp?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableCreateViewAsync

Android
3.2

在 Lynx 内置线程池中创建安卓平台的用户界面(UI),以优化 UI 操作执行。

enableCreateViewAsync?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: true


enableCSSAsyncDecode

Android
iOS
Harmony
3.2

NA

enableCSSAsyncDecode?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: undefined


enableCSSClassMerge

Android
iOS
Harmony
3.2

NA

enableCSSClassMerge?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableCSSEngine

Android
iOS
Harmony
3.2

NA

enableCSSEngine?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: true


enableCSSExternalClass

Android
iOS
Harmony
3.2

NA

enableCSSExternalClass?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: true


enableCSSInheritance

Android
Harmony
iOS
3.2

启用 CSS 继承

enableCSSInheritance?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableCSSInlineVariables

Android
iOS
Harmony
3.6

启用 CSS 内联变量。

enableCSSInlineVariables?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableCSSInvalidation

Android
iOS
Harmony
3.2

如果启用 CSS 失效机制,我们会使用 RuleInvalidationSet 来收集选择器失效信息。

enableCSSInvalidation?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableCSSLazyDecode

Android
iOS
Harmony
3.2

NA

enableCSSLazyDecode?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: undefined


enableCSSLazyImport

Android
Harmony
iOS
3.2

在作用域 CSS 下,通过 import 规则导入的 CSS 声明会在该作用域首次生效时进行惰性解码。

enableCSSLazyImport?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: undefined


enableCSSSelector

Android
iOS
Harmony
3.2

此开关将在 Blink 标准模式下启用 CSS 模块。

enableCSSSelector?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableCSSStrictMode

Android
Harmony
iOS
3.2

CSS 长度值应由一个 <number> 后跟一个单位组成。在严格模式下,无效的 <length> 值将被丢弃。

enableCSSStrictMode?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableCSSVariable

Android
iOS
Harmony
3.2

NA

enableCSSVariable?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: true


enableDisexposureWhenLynxHidden

Android
3.2

当 LynxView 处于隐藏状态时,启用曝光消失事件触发功能。

enableDisexposureWhenLynxHidden?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: true


enableEndGestureAtLastFingerUp

iOS
3.2

在多指场景下,确保最后一根手指抬起后,Lynx触摸事件能正常触发。

enableEndGestureAtLastFingerUp?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableEventHandleRefactor

Android
Harmony
iOS
3.5

启用新的事件处理逻辑,以支持事件监听器的动态注册、事件拦截等功能。

enableEventHandleRefactor?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableEventRefactor

Android
iOS
Harmony
3.2

NA

enableEventRefactor?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: undefined


enableEventThrough

Android
Harmony
iOS
3.2

在触摸 Lynx 页面的根节点区域时,允许客户端滑动触摸事件穿透 Lynx。

enableEventThrough?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableExposureUIMargin

Android
iOS
3.2

启用 exposure-ui-margin-* 属性以使其生效。

enableExposureUIMargin?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableExposureWhenLayout

Android
3.2

当 LynxView 进行布局请求时,启用暴露检查。

enableExposureWhenLayout?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableExposureWhenReload

Android
Harmony
iOS
3.5

启用在重新加载 Lynx 页面时触发曝光和取消曝光事件的功能。

enableExposureWhenReload?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableFiberArch

Android
iOS
Harmony
3.2

NA

enableFiberArch?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableFixedNew

Android
Harmony
iOS
3.2

更出色且稳定的固定定位处理。

enableFixedNew?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableFlexibleTemplate

Android
iOS
Harmony
3.2

如果启用此值,模板将被编码为灵活模板。

enableFlexibleTemplate?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableHarmonyNewOverlay

Harmony
3.6

启用基于 Harmony 新覆盖层的 OverlayManager 来处理事件穿透。

enableHarmonyNewOverlay?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableHarmonyVisibleAreaChangeForExposure

Harmony
3.4

使 Harmony 能够通过可见区域更改事件检测曝光情况。

enableHarmonyVisibleAreaChangeForExposure?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableICU

Android
iOS
3.2

启用绑定 PRIMJS-ICU

enableICU?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableImageDownsampling

iOS
3.2

如果为 true,则会为此 LynxView 上的所有图像启用下采样。

enableImageDownsampling?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableJsBindingApiThrowException

Android
Harmony
iOS
3.2

启用 JavaScript 绑定 API 抛出异常

enableJsBindingApiThrowException?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableJSDataProcessor

Android
Harmony
iOS
3.2

在 JavaScript 线程上启用数据处理器

enableJSDataProcessor?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableKeepPageData

Android
iOS
Harmony
3.2

NA

enableKeepPageData?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableListMoveOperation

Android
Harmony
iOS
3.2

diffResult 是否有移动操作(moveAction)

enableListMoveOperation?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableListNewArchitecture

Android
iOS
3.2

指示是否为平台列表使用新架构。

enableListNewArchitecture?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableListPlug

Android
iOS
3.2

指示是否使用列表插件

enableListPlug?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableLynxScrollFluency

Android
Harmony
iOS
3.2

强制上报 Lynx 滚动流畅度事件。当将 pageConfig.enableLynxScrollFluency 设置为一个范围在 [0, 1] 的双精度值时,我们将基于此概率来监控这个基于 LynxUI 的流畅度指标。该概率表示启用流畅度监控的可能性,并且这些指标将通过 applogService 无条件上报。

enableLynxScrollFluency?: boolean | number | undefined;
  • valueType: boolean | number | undefined

  • defaultValue: undefined


enableMicrotaskPromisePolyfill

Android
Harmony
iOS
3.2

这个配置项 enableMicrotaskPromisePolyfill 用于确定是否启用微任务 Promise 垫片。其值的类型为 TernaryBool,默认值为 TernaryBool::UNDEFINE_VALUE

enableMicrotaskPromisePolyfill?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: undefined


enableMTSPreExecute

Android
iOS
Harmony
3.7

启用 MTS 虚拟机预执行代码。

enableMTSPreExecute?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableMultiTouch

Android
Harmony
iOS
3.2

启用对多指事件的支持,以便事件参数可以包含多个手指的信息。

enableMultiTouch?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableMultiTouchParamsCompatible

Android
Harmony
iOS
3.2

启用与单指事件兼容的多指事件参数

enableMultiTouchParamsCompatible?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableNativeList

Android
Harmony
iOS
3.2

指示是否使用 C++ 列表。

enableNativeList?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: undefined


enableNewAnimator

Android
Harmony
iOS
3.2

如果此标志为 false,则将使用平台动画能力。

enableNewAnimator?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: undefined


enableNewClipMode

Android
iOS
3.2

是否启用新的裁剪模式。

enableNewClipMode?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: true


enableNewGesture

Android
Harmony
iOS
3.2

如果想使用手势处理程序 API,你需要将其设置为 true。

enableNewGesture?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableNewImage

Android
iOS
3.2

启用从图像服务加载图像的功能

enableNewImage?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: true


enableNewIntersectionObserver

Android
iOS
3.2

启用新的 IntersectionObserver 检测逻辑,以便在不绑定滚动事件的情况下,observe 能够正常触发。

enableNewIntersectionObserver?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableNewListContainer

iOS
3.2

在 iOS 平台上基于 ScrollView 实现平台级列表。

enableNewListContainer?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableNewTransformOrigin

Android
Harmony
iOS
3.2

如果此标志为 true,将应用新的变换原点算法。

enableNewTransformOrigin?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: true


enablePlatformGesture

Android
iOS
3.6

启用影子平台手势以处理手势冲突。

enablePlatformGesture?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enablePropertyBasedSimpleStyle

Android
iOS
Harmony
3.5

如果此配置设置为 TRUE,SimpleStyle 模式将根据属性逐步更新样式。否则,它将根据 StyleObject 逐步更新。基于 StyleObject 的更新性能更好,但不允许绑定到同一元素的 StyleObject 具有相交属性。

enablePropertyBasedSimpleStyle?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableQueryComponentSync

Android
Harmony
iOS
3.2

在后台运行时启用查询组件同步

enableQueryComponentSync?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableReactOnlyPropsId

Android
Harmony
iOS
3.2

如果我们有了 propsId,我们就可以只将 propsId 和一个标志传递给 JS 线程。JS 线程将使用一个 propsMap 来获取正确的属性。

enableReactOnlyPropsId?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableReduceInitDataCopy

Android
Harmony
iOS
3.2

如果此标志为 true,则不复制初始化数据,而是为了提高效率复制初始化数据的 Object.keys

enableReduceInitDataCopy?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableReloadLifecycle

Android
Harmony
iOS
3.2

启用 LynxUI 的 onNodeReload 生命周期。

enableReloadLifecycle?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableRemoveComponentExtraData

Android
Harmony
iOS
3.2

如果此标志为 true,则为了提高效率,从组件数据中移除 globalPropssystemInfo

enableRemoveComponentExtraData?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableRemoveCSSScope

Android
iOS
Harmony
3.2

NA

enableRemoveCSSScope?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableReuseLoadScriptExports

Android
Harmony
iOS
3.5

启用复用 loadScript 的结果。

enableReuseLoadScriptExports?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableSignalAPI

Android
Harmony
iOS
3.2

启用 Signal API

enableSignalAPI?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: undefined


enableSimpleStyling

Android
iOS
Harmony
3.3

使用简化样式模块。

enableSimpleStyling?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableSimultaneousTap

iOS
3.2

启用客户端的点击手势,使其能与 Lynx 的点击手势同时触发。

enableSimultaneousTap?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableTextBoringLayout

Android
3.2

启用在 Android 上使用 BoringLayout。

enableTextBoringLayout?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: undefined


enableTextGradientOpt

iOS
3.5

为 iOS 启用文本渐变优化。

enableTextGradientOpt?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: undefined


enableTextLanguageAlignment

iOS
3.2

启用更精确的文本对齐判断方法,但这会增加文本布局所需的时间。

enableTextLanguageAlignment?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableTextLayerRender

iOS
3.2

启用在 iOS 上使用文本层渲染。

enableTextLayerRender?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: undefined


enableTextLayoutCache

Android
iOS
3.3

是否启用文本布局缓存。

enableTextLayoutCache?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: undefined


enableTextNonContiguousLayout

iOS
3.2

是否启用文本非连续布局

enableTextNonContiguousLayout?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: true


enableTextOverflow

Android
iOS
3.2

如果为 true,则将文本溢出设置为可见。

enableTextOverflow?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableTextRefactor

Android
iOS
3.2

启用文本重构功能,使其行为更符合网页规范。

enableTextRefactor?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableTouchRefactor

iOS
3.2

使 Lynx 的 touchend 事件能够正常触发。

enableTouchRefactor?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: true


enableUIOperationOptimize

Android
Harmony
iOS
3.2

在安卓系统上启用关于 UI 操作批量处理和异步创建视图(CreateViewAsync)的优化。

enableUIOperationOptimize?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: undefined


enableUnifiedPipeline

Android
Harmony
iOS
3.4

为 Lynx 引擎启用统一像素管道。

enableUnifiedPipeline?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: undefined


enableUnifyFixedBehavior

Android
Harmony
iOS
3.7

统一旧固定模式和新固定模式之间的行为

enableUnifyFixedBehavior?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableUseContextPool

Android
Harmony
iOS
3.2

启用在LepusNG虚拟机创建时使用上下文池。

enableUseContextPool?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: undefined


enableUseMapBuffer

Android
Harmony
iOS
3.2

为 LynxProps 启用 mapbuffer 结构。

enableUseMapBuffer?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: undefined


enableViewReceiveTouch

iOS
3.2

启用 touchesBegan 及其他方法,使其在触摸客户端滑动自定义组件时被触发。

enableViewReceiveTouch?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableVsyncAlignedFlush

Android
iOS
Android 3.2+
iOS 3.2+

根据垂直同步(VSync)信号驱动流水线中的 UI 任务执行,带来一定的渐进式渲染效果。适用于 JavaScript(JS)驱动的更新频繁的场景。可根据需要开启。

enableVsyncAlignedFlush?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableXTextLayoutReused

iOS
3.2

是否启用 x-text 布局复用。

enableXTextLayoutReused?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


experimental_encodeQuickjsBytecode

Android
iOS
Harmony
3.2

允许在模板中对 QuickJS 字节码而不是源代码进行编码。

experimental_encodeQuickjsBytecode?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


extendedLayoutOnlyOpt

Android
Harmony
iOS
3.2

一个用于强制使某些特殊属性仅可用于布局的配置(例如 direction 和 text-align 等)。

extendedLayoutOnlyOpt?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


extraInfo

Android
Harmony
iOS
3.2

用户定义的额外信息。

extraInfo?: Record<string, unknown> | undefined;
  • valueType: Record<string, unknown> | undefined

  • defaultValue: undefined


flatten

Android
3.2

控制该节点是否需要创建对应的 Android 视图。默认值为 true。

flatten?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: true


fontScaleEffectiveOnlyOnSp

Android
Harmony
iOS
3.2

仅让字体缩放应用于 sp 单位。

fontScaleEffectiveOnlyOnSp?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


forceCalcNewStyle

Android
iOS
Harmony
3.2

NA

forceCalcNewStyle?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: undefined


implicit

iOS
3.2

控制是否允许在 iOS 平台上使用隐式动画。

implicit?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: true


implicitAnimation

Android
iOS
Harmony
3.2

NA

implicitAnimation?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


includeFontPadding

Android
3.2

控制 Android 上文本的顶部和底部内边距,这会影响文本的高度和垂直居中效果。

includeFontPadding?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


keyboardCallbackPassRelativeHeight

Android
3.2

包裹 Lynx 视图的外部装饰视图可能会因虚拟导航栏被屏蔽或绘制而发生变化。修改键盘事件的返回值,以返回绝对键盘高度以及键盘到 Lynx 视图底部的偏移量。

keyboardCallbackPassRelativeHeight?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


longPressDuration

Android
Harmony
iOS
3.2

指定触发长按事件的间隔。

longPressDuration?: number | undefined;
  • valueType: number | undefined

  • defaultValue: undefined


observerFrameRate

Android
Harmony
iOS
3.2

指定暴露检测的频率。

observerFrameRate?: number | undefined;
  • valueType: number | undefined

  • defaultValue: undefined


pipelineSchedulerConfig

Android
iOS
3.2

管道的调度器配置,包括启用并行元素/列表框架批量渲染以及其他调度器配置。

pipelineSchedulerConfig?: number | undefined;
  • valueType: number | undefined

  • defaultValue: undefined


preferredFps

Android
Harmony
iOS
3.2

控制 CSS 动画的帧率

preferredFps?: string | undefined;
  • valueType: string | undefined

  • defaultValue: "auto"


quirksMode

Android
Harmony
iOS
3.2

支持字符串值。默认情况下,它等于 TargetSDKVersion。该模式用于兼容不符合所产生的 CSS 布局规范的旧页面。

quirksMode?: boolean | string | undefined;
  • valueType: boolean | string | undefined

  • defaultValue: undefined


removeCSSParserLog

Android
iOS
Harmony
3.2

NA

removeCSSParserLog?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


removeDescendantSelectorScope

Android
Harmony
iOS
3.2

如果为 false,后代选择器仅在组件作用域内生效。

removeDescendantSelectorScope?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: true


strictPropType

Android
Harmony
iOS
3.2

如果此标志为 true,当组件的属性类型不匹配时,将使用默认值。

strictPropType?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


tapSlop

Android
Harmony
3.2

指定滑动距离阈值,达到该阈值时不触发点击事件。

tapSlop?: string | undefined;
  • valueType: string | undefined

  • defaultValue: "50px"


targetSdkVersion

Android
iOS
Harmony
3.2

NA

targetSdkVersion?: string | undefined;
  • valueType: string | undefined

  • defaultValue: ""


templateDebugUrl

Android
iOS
Harmony
3.2

NA

templateDebugUrl?: string | undefined;
  • valueType: string | undefined

  • defaultValue: ""


trailNewImage

iOS
3.2

启用 iOS 图像重构

trailNewImage?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: undefined


unifyVWVHBehavior

Android
Harmony
iOS
3.2

控制诸如 font-size 等属性中的 vwvh 单位是否随视口动态调整;对于 targetSdkVersion >= 2.3 的情况,默认启用此功能。

unifyVWVHBehavior?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


useImagePostProcessor

Android
3.2

是否使用图像后处理器

useImagePostProcessor?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


useNewSwiper

Android
3.2

指示是否使用新的滑动器。

useNewSwiper?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: true

已废弃的 Lynx 配置


autoResumeAnimation Deprecated
3.5

Android
iOS
Harmony
3.2

过时的配置,将在未来版本中移除。

autoResumeAnimation?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: true


cli Deprecated
3.5

Android
Harmony
iOS
3.2

CLI 版本

cli?: string | undefined;
  • valueType: string | undefined

  • defaultValue: ""


compileRender Deprecated
3.5

Android
iOS
Harmony
3.2
compileRender?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


customData Deprecated
3.5

Android
iOS
Harmony
3.2
customData?: string | undefined;
  • valueType: string | undefined

  • defaultValue: ""


enableA11yIDMutationObserver Deprecated
3.5

Android
iOS
Harmony
3.2

为无障碍功能启用 MutationObserver。

enableA11yIDMutationObserver?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableAsyncDisplay Deprecated
3.5

iOS
3.2

在 iOS 上全局启用软件渲染内容的异步渲染,这可以大幅优化帧率并减少卡顿。

enableAsyncDisplay?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: true


enableBackgroundShapeLayer Deprecated
3.5

iOS
3.2

启用 iOS 后台管理器以应用形状图层优化。此功能已弃用并将被移除,因为该优化已成为固定设置。

enableBackgroundShapeLayer?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: true


enableCascadePseudo Deprecated
3.5

Android
Harmony
iOS
3.2

已弃用,这用于旧版 CSS 选择器以启用级联。

enableCascadePseudo?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableCheckDataWhenUpdatePage Deprecated
3.5

Android
Harmony
iOS
3.2
enableCheckDataWhenUpdatePage?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: true


enableComponentLayoutOnly Deprecated
3.5

Android
Harmony
iOS
3.2
enableComponentLayoutOnly?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableGlobalComponentMap Deprecated
3.5

Android
iOS
Harmony
3.2
enableGlobalComponentMap?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableNativeScheduleCreateViewAsync Deprecated
3.5

Android
3.2

在 C++ 绘画上下文(PaintingContext)中启用异步创建用户界面(UI)

enableNativeScheduleCreateViewAsync?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: undefined


enableNewAccessibility Deprecated
3.5

Android
3.2
enableNewAccessibility?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


enableNewLayoutOnly Deprecated
3.5

Android
Harmony
iOS
3.2
enableNewLayoutOnly?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: true


enableOptPushStyleToBundle Deprecated
3.5

Android
Harmony
iOS
3.2

启用使用 PropBundleStyleWriter 将样式写入 PropBundle

enableOptPushStyleToBundle?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: undefined


enableOverlapForAccessibilityElement Deprecated
3.5

Android
3.2
enableOverlapForAccessibilityElement?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: true


fixCSSImportRuleOrder Deprecated
3.5

Android
Harmony
iOS
3.2
fixCSSImportRuleOrder?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: true


forceCalcNewStyle Deprecated
3.5

Android
iOS
Harmony
3.2
forceCalcNewStyle?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: true


reactVersion Deprecated
3.5

Android
Harmony
iOS
3.2
reactVersion?: string | undefined;
  • valueType: string | undefined

  • defaultValue: ""


redBoxImageSizeWarningThreshold Deprecated
3.5

Android
iOS
Harmony
3.2
redBoxImageSizeWarningThreshold?: number | undefined;
  • valueType: number | undefined

  • defaultValue: undefined


removeComponentElement Deprecated
3.5

Android
Harmony
iOS
3.2

过时的配置,将在未来版本中移除。

removeComponentElement?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: false


syncImageAttach Deprecated
3.5

Android
3.2

如果条件为真且处于主线程,图像请求将立即发起;否则,图像请求将在主线程的下一帧之后发出,以延迟请求。

syncImageAttach?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: true


useNewImage Deprecated
3.5

Android
iOS
3.2
useNewImage?: boolean | undefined;
  • valueType: boolean | undefined

  • defaultValue: undefined


version Deprecated
3.5

Android
Harmony
iOS
3.2
version?: string | undefined;
  • valueType: string | undefined

  • defaultValue: ""

除非另有说明,本项目采用知识共享署名 4.0 国际许可协议进行许可,代码示例采用 Apache License 2.0 许可协议进行许可。