接口参考

known_issues.md · 已知限制 · 2/5

按同一接口文件归组浏览，展开条目查看声明、使用说明和版本边界。

阅读相关开发指南 →

这里保留接口声明及来源。逐项运行验证范围以条目记录为准；源文件中的内部实现候选不代表免费 SDK 的交付承诺。

docs/known_issues.md
T-BUG-LOCAL-IMAGE-FILE-MAPPED-WHILE-CACHED
已知问题3.61.7C++

Windows 上本地位图进了图片缓存后，应用原地覆盖写同一个文件会失败（例如把新头像 / 编辑结果存回正在显示的文件）

验证范围

docs/known_issues.md:292

反馈此接口问题 →
T-BUG-LUA-CANVAS-FONT-SIZE-AS-WEIGHT
已知问题3.61.7C++

Lua Canvas 把 100～900px 的无字重字号误当数值字重并抛异常

验证范围

docs/known_issues.md:259

反馈此接口问题 →
T-BUG-LUA-MUTATIONOBSERVER-OBSERVE-REJECTS-ELEMENT
已知问题3.61.7C++

Lua 的 MutationObserver:observe(element, …) 收不进元素，报类型不符

验证范围

docs/known_issues.md:400

反馈此接口问题 →
T-BUG-MARKER-CONTENT-NONE-SHOWS-MARKER
已知问题3.61.7C++

::marker{content:none} 仍画默认标记并占位

验证范围

docs/known_issues.md:345

反馈此接口问题 →
T-BUG-MEASURE-SUBSTRING-UTF8-MID-CHAR-CRASH
已知问题3.61.7C++

measureSubstring 的 byteEnd 落在 UTF-8 多字节字符中间时进程崩溃（0xC0000005）

验证范围

docs/known_issues.md:267

反馈此接口问题 →
T-BUG-MULTILINE-INLINE-SCALAR-RECT-OTHER-READERS
已知问题3.61.7C++

跨行行内元素的标量矩形（首片段 x + 外接宽）还被 scrollIntoView、outline 并集、sticky 等当成真实占位

验证范围

docs/known_issues.md:130

反馈此接口问题 →
T-BUG-NEGATIVE-LEADING-ATOMIC-LINE-DROPS-STRUT-DESCENT
已知问题3.61.7C++

负半行距 / 回退字体等走 CSS 行盒重建的行里，基线对齐的原子盒把基线压低时仍丢掉根 strut 的下伸部

验证范围

docs/known_issues.md:155

反馈此接口问题 →
T-BUG-NO-BACKEND-ATOMIC-GEOMETRY-ACCUMULATES-BOX-MODEL
已知问题3.61.7C++

无后端嵌套百分比原子行内盒在暖帧重复叠加盒边沿

验证范围

docs/known_issues.md:173

反馈此接口问题 →
T-BUG-OOF-FLEX-GRID-STATIC-POSITION-CHROME-MATRIX
已知问题3.61.7C++

flex 中 fixed、grid 中 absolute/fixed 的 auto 静态位置与 Chrome 不同

验证范围

docs/known_issues.md:132

反馈此接口问题 →
T-BUG-OUTSIDE-MARKER-BESIDE-FLOAT-BOX-OFFSET
已知问题3.61.7C++

浮动旁的列表项有 padding / margin 或是 BFC 时，outside 圆点的位置与 Chrome 不同

验证范围

docs/known_issues.md:215

反馈此接口问题 →
T-BUG-OVERFLOW-WORD-RESCUE-ALIGNMENT
已知问题3.61.7C++

多行段落里只有部分行溢出时，center/right/RTL 的对齐区被整词救援加宽

验证范围

docs/known_issues.md:182

反馈此接口问题 →
T-BUG-PERCENT-SIZE-RESOLVES-AGAINST-INLINE-PARENT
已知问题3.61.7C++

行内元素里的原子盒改成百分比宽度时，选择性下降按行内父盒上一帧的宽度解析

验证范围

docs/known_issues.md:122

反馈此接口问题 →
T-BUG-POSITIVE-LINE-CLAMP-SELECTIVE-STALE-TEXT-BASELINE
已知问题3.61.7C++

正数 line-clamp 改长文字后，复用的零宽尾文字盒保留旧基线

验证范围

docs/known_issues.md:218

反馈此接口问题 →
T-BUG-PSEUDO-STYLE-STALE-IN-STYLE-ONLY-ANIM-FRAMES
已知问题3.61.7C++

style-only 动画帧不刷新 ::before / ::after 的样式：宿主的 color 等在过渡 / 动画中变化时，伪元素停在旧值

验证范围

docs/known_issues.md:253

反馈此接口问题 →
T-BUG-RATIO-ONLY-IMAGE-SIZING-CONTRIBUTION
已知问题3.61.7C++

只有比例、没有自然宽高的图片（viewBox-only SVG，或不写宽高的 SVG 配作者 aspect-ratio）在收缩适应 / flex / 绝对定位里按栅格尺寸排

验证范围

docs/known_issues.md:135

反馈此接口问题 →
T-BUG-REFPTR-NEW-CREATE-LEAKS-NODES
已知问题3.61.7C++

<img>、<audio>、<video>、<lottie-player> 与 DocumentFragment 的 create() 多持一个引用，这些节点永远不会析构

验证范围

docs/known_issues.md:284

反馈此接口问题 →
T-BUG-RELATIVE-INSET-PERCENT-NESTED-INLINE-BASIS
已知问题3.61.7C++

嵌套在行内元素里的相对定位行内元素，百分比 left / right 按父行内盒的宽解析，而不是按包含块（最近的块容器）的宽

验证范围

docs/known_issues.md:164

反馈此接口问题 →
T-BUG-RETAINED-PARTIAL-LAYER-PROMOTION-STALE-AFTER-RELAYOUT
已知问题3.61.7C++

retained surface + partial damage + 层提升三者同开时，改 dir 让整行重排后有一块像素停在上一帧

验证范围

docs/known_issues.md:250

反馈此接口问题 →
T-BUG-RETAINED-SURFACE-FRACTIONAL-DAMAGE-SHADOW-SEAM
已知问题3.61.7C++

retained surface（默认关）下，小数坐标的显式脏区沿盒阴影镂空边局部重放，与整页栅格化差 30 像素

验证范围

docs/known_issues.md:370

反馈此接口问题 →
T-BUG-RTL-ATOMIC-BEFORE-HARD-BREAK-RUN-OFFSET
已知问题3.61.7C++

RTL 段落里原子行内盒后面的文字 run 跨过硬换行时，原子盒右移、压在希伯来文上

验证范围

docs/known_issues.md:169

反馈此接口问题 →
T-BUG-RTL-INLINE-EDGE-DETACHED-IN-LATIN-RUN
已知问题3.61.7C++

RTL 段落里与拉丁片段相连的行内盒：边沿占位符按自己的双向层级落位，与盒内容隔开或排到错侧

验证范围

docs/known_issues.md:153

反馈此接口问题 →
T-BUG-RTL-OVERFLOWING-ATOMIC-INLINE-START-EDGE
已知问题3.61.7C++

RTL 行里比行宽还宽的原子行内盒贴在左缘，没有从结束边（左）溢出

验证范围

docs/known_issues.md:162

反馈此接口问题 →
T-BUG-SEGMENT-INLINE-ROOT-BOX-IS-PARAGRAPH-BOX
已知问题3.61.7C++

逐段排版里单独排版的行内根，自己的盒是段落盒（行高、跨行时一整块），不是行内盒

验证范围

docs/known_issues.md:158

反馈此接口问题 →
T-BUG-SEGMENT-INLINE-ROOT-RTL-ALIGNMENT
已知问题3.61.7C++

RTL 段落走逐段排版时，单独排版的行内根整段字形右移出盒、压住后面的文字

验证范围

docs/known_issues.md:156

反馈此接口问题 →
T-BUG-SMALLER-INLINE-LOWERS-NUMERIC-LINE-HEIGHT-BASELINE
已知问题3.61.7C++

数值行高的段落里有更小字号的行内元素时，整行正文与盒子比 Chrome 低约 2px

验证范围

docs/known_issues.md:163

反馈此接口问题 →
T-BUG-STEPS-JUMP-NONE-BOTH
已知问题3.61.7C++

steps(n, jump-none) / steps(n, jump-both) 被当成 jump-end / jump-start

验证范围

docs/known_issues.md:279

反馈此接口问题 →
T-BUG-STRETCHED-WRAPPED-COLUMN-FLEX-ITEM-IGNORES-BLOCK-SIZE
已知问题3.61.7C++

定高单行行向 flex 里被 stretch 的多行列向 flex item，自己排版时不按 stretch 后的高度折列

验证范围

docs/known_issues.md:63

反馈此接口问题 →
T-BUG-STYLE-CURRENTCOLOR-INHERIT-RESOLVED-EARLY
已知问题3.61.7C++

border-*-color / text-decoration-color / column-rule-color / row-rule-color 的 currentColor 在计算值阶段就解析成颜色，子元素 inherit 拿到父元素的颜色

验证范围

docs/known_issues.md:276

反馈此接口问题 →
T-BUG-SVG-RENDERER-CONCURRENT-FIRST-CREATE
已知问题3.61.7C++

首张 SVG 解码时 4 个 loader 线程无锁地并发创建同一个 SVG 渲染器，存在数据竞争

验证范围

docs/known_issues.md:255

反馈此接口问题 →
T-BUG-TABLE-ABSPOS-CHILD-STATIC-POSITION-AFTER-CELL
已知问题3.61.7C++

display:table 里排在单元格后面的绝对定位子元素，静态位置的横坐标没有落在单元格之后

验证范围

docs/known_issues.md:309

反馈此接口问题 →
T-BUG-TABLE-ALL-ROWS-COLLAPSED-DROPS-SPACING
已知问题3.61.7C++

表格的行全部 visibility:collapse 时，KUI 连首尾两个纵向 border-spacing 也去掉，表格比 Chrome 矮

验证范围

docs/known_issues.md:312

反馈此接口问题 →
T-BUG-TABLE-ANONYMOUS-CELL-FAST-PATH-PERCENT-PADDING-SQUEEZE
已知问题3.61.7C++

只有行内内容的 display:table 带百分比内边距时，收缩到内容宽不算内边距，内容被挤窄、文字折成多行

验证范围

docs/known_issues.md:315

反馈此接口问题 →
T-BUG-TABLE-AS-FLEX-ITEM-GEOMETRY
已知问题3.61.7C++

表格作为行向 flex 项时宽高与 Chrome 不同：合并边框表格少算外沿、分离边框表格多出边框高度

验证范围

docs/known_issues.md:65

反馈此接口问题 →
T-BUG-TABLE-AUTO-LAYOUT-INLINE-BLOCK-COLUMN-WIDER-THAN-CHROME
已知问题3.61.7C++

自动表格布局里装着几个 inline-block 标签的列，KUI 分到的列宽比 Chrome 宽很多

验证范围

docs/known_issues.md:85

反馈此接口问题 →
T-BUG-TABLE-CAPTION-INSIDE-TABLE-BORDER
已知问题3.61.7C++

有边框 / 内边距的表格把标题（caption）放进自己的边框和内边距里，表格边框画到标题上方

验证范围

docs/known_issues.md:98

反馈此接口问题 →
T-BUG-TABLE-CAPTION-WIDER-THAN-GRID-NO-STRETCH
已知问题3.61.7C++

标题（caption）比列网格宽时列不拉宽，网格只占表格盒一侧（ltr 贴左、rtl 贴右）

验证范围

docs/known_issues.md:84

反馈此接口问题 →
T-BUG-TABLE-CELL-IB-SPLIT-ABSPOS-STATIC-X
已知问题3.61.7C++

表格（匿名单元格）里被块级子元素拆开的定位行内元素中，left:auto 的绝对定位后代静态 x 取在拆分前的文字之后

验证范围

docs/known_issues.md:314

反馈此接口问题 →
T-BUG-TABLE-COL-PERCENT-WIDTH-IGNORES-SPACING
已知问题3.61.7C++

<col> / <colgroup> 的百分比宽按整个表格宽解析、没扣 border-spacing，列比 Chrome 宽

验证范围

docs/known_issues.md:99

反馈此接口问题 →
T-BUG-TABLE-COLLAPSED-COLUMN-DEFINITE-WIDTH-KEPT
已知问题3.61.7C++

定宽表格里有 visibility:collapse 的列时，KUI 表格保持定宽、收起的列宽变成空白；Chrome 把表格缩窄

验证范围

docs/known_issues.md:313

反馈此接口问题 →
T-BUG-TABLE-COLLAPSED-COLUMN-KEEPS-SPACING
已知问题3.61.7C++

visibility:collapse 的列去掉了轨道却留下它的 border-spacing，表格宽一个间距

验证范围

docs/known_issues.md:310

反馈此接口问题 →
T-BUG-TABLE-COLLAPSED-COLUMN-TIE-ORDER
已知问题3.61.7C++

合并边框下相邻 <col> / <colgroup> 的竖边同宽同样式时取了逻辑在后的那一个

验证范围

docs/known_issues.md:311

反馈此接口问题 →
T-BUG-TABLE-FRACTIONAL-BORDER-SPACING-NOT-TRUNCATED
已知问题3.61.7C++

小数的 border-spacing KUI 保留小数，Chrome 截成整数像素，多列表格越排越宽

验证范围

docs/known_issues.md:100

反馈此接口问题 →
T-BUG-TABLE-INLINE-CHILD-CHROME-GEOMETRY-L6
已知问题3.61.7C++

定宽 display:table 中的 inline-block 子项被拉宽，后续静态块入流时表格高度与 Chrome 不同

验证范围

docs/known_issues.md:101

反馈此接口问题 →
T-BUG-TABLE-ROWSPAN-EXCESS-IGNORES-SPACING
已知问题3.61.7C++

跨行单元格比所跨各行之和高时，分配多出的高度漏算跨过的纵向 border-spacing，表格多出一截

验证范围

docs/known_issues.md:97

反馈此接口问题 →
T-BUG-TEXT-OVERFLOW-DECORATION-UNDER-ELLIPSIS
已知问题3.61.7C++

text-overflow 截断的文字的装饰线一直画到省略号底下

验证范围

docs/known_issues.md:191

反馈此接口问题 →
T-BUG-TEXT-OVERFLOW-NO-ELLIPSIS-WITH-MARKER-OR-ABSPOS
已知问题3.61.7C++

行里有 inside 列表标记或脱流子元素时，nowrap 的 text-overflow 没有省略号

验证范围

docs/known_issues.md:195

反馈此接口问题 →
T-BUG-TEXT-OVERFLOW-RESCUE-REPACKS-LINES
已知问题3.61.7C++

有放不下的长词时，声明 text-overflow 的软换行段落比不声明少一行

验证范围

docs/known_issues.md:188

反馈此接口问题 →
T-BUG-TRANSLUCENT-ROUNDED-OVERFLOW-EDGE-CONFLATION
已知问题3.61.7C++

半透明圆角背景 + overflow:hidden 的盒（磨砂玻璃风格的弹窗）落在小数位置时（入场缩放 / 位移、居中），子元素边缘有一条较弱的浅色线

验证范围

docs/known_issues.md:257

反馈此接口问题 →
T-BUG-VERTICAL-TEXT-SHADOW-NOT-ROTATED
已知问题3.61.7C++

竖排文字（writing-mode:vertical-rl 等）的 text-shadow 按横排画、不随正文旋转

验证范围

docs/known_issues.md:251

反馈此接口问题 →
T-BUG-VISIBILITY-COLLAPSE-NON-TABLE-PRUNES-VISIBLE-DESCENDANTS
已知问题3.61.7C++

非表格元素上的 visibility:collapse 把整棵子树剪掉：显式 visibility:visible 的后代既不画也命不中，Chrome 按 hidden 处理

验证范围

docs/known_issues.md:372

反馈此接口问题 →
T-BUG-WEBKIT-LINE-CLAMP-BLOCK-CHILDREN-NOT-CLAMPED
已知问题3.61.7C++

-webkit-box 的 -webkit-line-clamp 不跨块级子元素计行

验证范围

docs/known_issues.md:193

反馈此接口问题 →
T-DEBT-ABSPOS-INLINE-CB-MULTILINE-PREV-TEXTBOX-APPROXIMATE
已知问题3.61.7C++

行内包含块的“前一个兄弟”回退：逐行片段开关关闭且前一个文字盒跨多行时，包含块起点仍不精确

验证范围

docs/known_issues.md:175

反馈此接口问题 →
T-DEBT-ADVEX-TOOLING-WINDOWS-HARDCODED-PATHS
已知问题3.61.7C++

高级示例工具链移除 Windows 硬编码路径

验证范围

docs/known_issues.md:383

反馈此接口问题 →
T-DEBT-BLOCKIFY-INLINE-BLOCK
已知问题3.61.7C++

浮动 / 绝对定位的 display:inline-block 没有被块化，computed display 仍是 inline-block

验证范围

docs/known_issues.md:322

反馈此接口问题 →
T-DEBT-BROWSERCOMPAT-CONTROL-BASELINE-CALIBRATION
已知问题3.61.7C++

BrowserCompat 表单控件基线与 listbox 临时补偿

验证范围

docs/known_issues.md:141

反馈此接口问题 →
T-DEBT-CLIPPED-REPLAY-DEGENERATE-INK-BOUNDS
已知问题3.61.7C++

复核预剔除共享墨迹口径在退化边框、粗波浪线与变换字形下的边界

验证范围

docs/known_issues.md:245

反馈此接口问题 →
T-DEBT-CLIPPED-REPLAY-WINDOW-UNMODELED-LISTS
已知问题3.61.7C++

裁剪重放的列表含 clip-path / mask / backdrop-filter / 3D 矩阵 / 非 blur 滤镜时栅格窗口建不成，纯动画帧的块切到曲线图元仍与整幅差几级

验证范围

docs/known_issues.md:256

反馈此接口问题 →
T-DEBT-CROSSPLATFORM-FONT-GENERIC-MAPPING-DUPLICATED
已知问题3.61.7C++

合并跨平台通用字体映射

验证范围

docs/known_issues.md:373

反馈此接口问题 →
T-DEBT-CSS-COUNTER-STYLES-WPT-CATALOG
已知问题3.61.7C++

分阶段实现 WPT 实际使用的 CSS Counter Styles 能力

验证范围

docs/known_issues.md:271

反馈此接口问题 →
T-DEBT-CSS-VAR-BORDER-WIDTH-PERCENT-VALIDATION
已知问题3.61.7C++

border-width 的 var 代入含百分比表达式后未按属性语法回退

验证范围

docs/known_issues.md:275

反馈此接口问题 →
T-DEBT-CSS-ZOOM-END-TO-END
已知问题3.61.7C++

CSS zoom 的 computed style、布局占用、绘制坐标、滚动溢出与命中测试端到端语义

验证范围

docs/known_issues.md:117

反馈此接口问题 →
T-DEBT-CSSOM-BORDER-IMAGE-OUTSET-AND-GRADIENT-SERIALIZATION
已知问题3.61.7C++

border-image-* 的 getComputedStyle：非零 outset 与渐变 / filter() 源仍返回空串

验证范围

docs/known_issues.md:282

反馈此接口问题 →
T-DEBT-CSSOM-RESOLVED-VALUE-PARITY
已知问题3.61.7C++

CSSOM 读取层的元素使用值与计算形态仍有未完成类别

验证范围

docs/known_issues.md:273

反馈此接口问题 →
T-DEBT-CSSOM-RESOLVED-VALUE-RUNTIME-FOLD-BOXES
已知问题3.61.7C++

P2：runtime fold 盒尚缺独立CSS用值数据，读取暂回退计算值

验证范围

docs/known_issues.md:274

反馈此接口问题 →
T-DEBT-DECORATING-BOX-BASELINE-RESIDUAL
已知问题3.61.7C++

装饰盒基线的两处近似

验证范围

docs/known_issues.md:327

反馈此接口问题 →
T-DEBT-DECORATION-SKIP-INK-CHROME-PARITY
已知问题3.61.7C++

text-decoration-skip-ink:auto 的断开方式与 Chrome 不同

验证范围

docs/known_issues.md:365

反馈此接口问题 →
T-DEBT-DECORATION-STYLE-SHAPE-CHROME-PARITY
已知问题3.61.7C++

波浪线的波形、虚线端点的抗锯齿与 Chrome 不同

验证范围

docs/known_issues.md:366

反馈此接口问题 →
T-DEBT-DETAILS-INLINE-CONTENT-SLOT-IB-SPLIT
已知问题3.61.7C++

inline details、summary 与匿名 ::details-content block/contents slot 的 IB split、固有宽度和换行

验证范围

docs/known_issues.md:212

反馈此接口问题 →
T-DEBT-DETAILS-SUMMARY-MARKER-INLINE-LAYOUT
已知问题3.61.7C++

details/summary 的 marker、匿名盒、inline display 与列表/装饰继承

验证范围

docs/known_issues.md:211

反馈此接口问题 →
T-DEBT-DEVTOOLS-COUNTER-FIELD-CONTRACT
已知问题3.61.7C++

Performance.renderStats / repaintRects 的字段名与语义没有权威清单

验证范围

docs/known_issues.md:289

反馈此接口问题 →
T-DEBT-DEVTOOLS-MOUSE-INJECTION-FORCES-FULL-FRAME
已知问题3.61.7C++

DevTools 注入的鼠标事件每次都强制一整帧，与真实鼠标不同：动画进行中经它测出的帧数与样式工作偏多

验证范围

docs/known_issues.md:362

反馈此接口问题 →
T-DEBT-DEVTOOLS-PERF-CHART-Y-AXIS
已知问题3.61.7C++

Frame Time History 纵轴在全窗口低于 20ms 时无法下探

验证范围

docs/known_issues.md:389

反馈此接口问题 →
T-DEBT-DEVTOOLS-UI-INL-MANUAL-REGEN
已知问题3.61.7C++

devtools_ui.inl 仍是手工生成步骤

验证范围

docs/known_issues.md:390

反馈此接口问题 →
T-DEBT-EQUIVALENCE-CHECK-CONSUMER-ACCESS
已知问题3.61.7C++

增量布局等价性自检（KUI_DEBUG_LAYOUT_EQUIVALENCE_CHECK）无法被 consumer 使用

验证范围

docs/known_issues.md:290

反馈此接口问题 →
T-DEBT-EXT3D-LINUX-REQUIRES-LIBCXX-TOOLCHAIN
已知问题3.61.7C++

降低 ext3d Linux 对 libc++ 工具链的硬依赖

验证范围

docs/known_issues.md:386

反馈此接口问题 →
T-DEBT-FIELDSET-LEGEND-MINIMUM-OCCUPANCY
已知问题3.61.7C++

折入量可被压缩到 0，Chromium 则不把 legend 压到 block-start border 以下

验证范围

docs/known_issues.md:140

反馈此接口问题 →
T-DEBT-FIELDSET-LEGEND-SHRINK-TO-FIT
已知问题3.61.7C++

已渲染 legend 被拉伸到 fieldset 内容宽，而非收缩到内容宽度

验证范围

docs/known_issues.md:139

反馈此接口问题 →
T-DEBT-FIRST-LINE-FRACTIONAL-OPACITY-COMPOSITING
已知问题3.61.7C++

::first-line 的 0<opacity<1 片段级合成

验证范围

docs/known_issues.md:248

反馈此接口问题 →
T-DEBT-FIXED-TABLE-INTRINSIC-KEYWORD-PERCENT-ROWS
已知问题3.61.7C++

fixed 表格 min-content / fit-content 的百分比与后续跨列固有贡献口径不同

验证范围

docs/known_issues.md:92

反馈此接口问题 →
T-DEBT-FIXED-TABLE-ZERO-TRACK-CELL-FRAMING
已知问题3.61.7C++

fixed 百分比填满预算后的零宽单元格取框多出 padding

验证范围

docs/known_issues.md:91

反馈此接口问题 →
浏览同类接口 →