macOS button text differs from SwiftUI in interaction snapshots

Fechada Para iniciantes
  • Algo errado?
#1,140 0 comentários 0 reações 0 responsáveis Ver no GitHub

Mantenedores costumam responder em até 1 dia

@Kyle-Ye já está trabalhando nisso.

Desde 12/10/2026.

  • #1141 de @Kyle-Ye — aberto

Avaliação

Dificuldade
2/5
Tempo estimado
1-3 horas
Facilidade para iniciantes
74/100
Tipo de issue
Bug
Clareza
Claramente especificada
Status de atividade
Ativa
Stack de tecnologia
macos, swift
Domínio
frontend, testing

Direção de pesquisa

Comece por renderKeyedText, identificado no issue como usando branco para desenhar a máscara de texto somente alfa; compare como ele usa a cor de primeiro plano resolvida. Em seguida, execute ButtonInteractionTests com as atualizações de referência desativadas e inspecione os casos de snapshot habilitado e desabilitado. O trabalho estará concluído quando as seis capturas corresponderem às referências do SwiftUI.

Escrita pelo modelo de indexação a partir do texto da issue.

Descrição

area: rendering area: text impact: visual-diff platform: macOS type: bug

Description

Default button labels rendered by OpenSwiftUI differ from SwiftUI at the glyph
edges on macOS. Both enabled and disabled buttons are affected. The differences
remain when the reference and actual images use the same macOS version.

Button actions work: repeated presses update the count, and disabled buttons do
not run their actions. The failures are snapshot mismatches, with no crash.

Reproduction

  • Platform: macOS 15.7.3 (24G419), arm64.
  • Configuration: OpenSwiftUI renderer with IAG.
  • References: SwiftUI snapshots recorded on macOS 15.7.3.
  • Source: The Button implementation merged in #1138.

Run the existing
ButtonInteractionTests
with reference updates disabled. The two cases capture the initial appearance
and the appearance after each of two presses:

  1. actionUpdatesCount: The enabled button displays counts 0, 1, and 2.
  2. disabledButtonDoesNotRunAction: The disabled button keeps count 0.

Expected and actual results

All six captures should match the SwiftUI references. Instead, each capture has
differences confined to the text. The button backgrounds and borders match.

Case Initial After first press After second press
Enabled 604 543 556
Disabled 583 583 583

Values are the number of changed RGBA pixels in each reference/actual pair from
the focused CI run.

The reference, actual, and difference images are available in the snapshot
artifact of the CI run linked above.

Enabled and disabled button snapshots, with enlarged text differences

Findings

A local comparison on macOS 15.7.3 reproduced the CI images. View and layer
geometry, glyph positions, fonts, transforms, and text color matched between the
two renderers.

The difference comes from the fill color used to draw the alpha-only text mask
in renderKeyedText. OpenSwiftUI uses white. On macOS, font smoothing depends on
the fill color even in an alpha-only context, so this changes glyph coverage.
Using the resolved foreground RGB for a solid fill removes the differences in
these button snapshots.

A standalone text probe confirmed that black and white fills produce different
alpha masks on macOS 15.7.3 with font smoothing enabled. The masks match with
smoothing disabled. The same probe on iOS 18.5 produced identical masks for both
colors.

Linguagem predominante
Swift
Estrelas
2.5k
Forks
84
Merge médio
5h 45min
PRs com merge (30d)
70

Preparar o ambiente

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Mais de OpenSwiftUIProject/OpenSwiftUI

Todas as issues de OpenSwiftUIProject/OpenSwiftUI

Issues semelhantes

Mais issues de Swift

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.