Hacktoberfest 2026:メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

macOS button text differs from SwiftUI in interaction snapshots

クローズ 初心者向け
#1,140 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

@Kyle-Ye がすでに取り組んでいます。

2026年10月12日 から。

  • #1141 @Kyle-Ye による — オープン

評価

難易度
2/5
見積もり時間
1〜3時間
初心者へのやさしさ
74/100
issue の種類
バグ
明瞭さ
明確に書かれている
活発さ
活発
技術スタック
macos, swift
領域
frontend, testing

調査の方向性

Issueでアルファのみのテキストマスクを白で描画すると説明されている renderKeyedText から始め、解決済みの前景色をどのように使用しているかを比較します。次に、参照の更新を無効にして ButtonInteractionTests を実行し、有効状態と無効状態のスナップショットケースを確認します。6つすべてのキャプチャがSwiftUIの参照と一致すれば完了です。

索引モデルが issue の本文から書いたものです。

説明

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.

主要言語
Swift
スター
2.5k
フォーク
84
平均マージ
2時間 10分
マージ済み PR(30日)
62

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

OpenSwiftUIProject/OpenSwiftUI のほかの issue

OpenSwiftUIProject/OpenSwiftUI の issue をすべて見る

似ている issue

Swift の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。