ウォンテッドリーでモバイルエンジニアをしている乙津です。AI 転職エージェントアプリ「Mendy」の開発に携わっています。
本記事は Mendy の開発を紹介するシリーズの 5 本目です。これまでの記事は次の通りです。
- 新アプリ Mendy のアーキテクチャと技術選定
- Agent LoopとWorkflowを使い分け、不確実性を抑えたAI機能を実現する
- 正解がひとつではないシナリオで、LLMが生成する文章の品質をどのように担保したか
- Expo で何が速くなったのか ― ネイティブアプリと比べて分かった Mendy のモバイル開発
4 本目では、React Native 固有の問題の 1 つとして、ログイン画面の placeholder の文字が欠ける不具合に触れました。本記事では、この不具合の原因と直し方を詳しく書きます。前の記事を読んでいなくても、この記事だけで読めるようになっています。
目次
はじめに
Mendy は、転職エージェントから届くメールを AI で管理するモバイルアプリです。ユーザーは Mendy が発行した専用のメールアドレスを転職エージェントに伝えるだけで、届いた求人の整理やマッチ度の診断、返信の下書きを Mendy に任せられます。
あなた専属の転職AIエージェント Mendy by Wantedly
本記事の内容は、2026/11/17の登壇「React Native で Hiragino Sans を使うな」をもとにしています。扱うのは、入力欄の placeholder の文字が数ピクセル欠けるという小さな不具合です。
Mendy は Expo SDK 56(React Native 0.85.3)で、New Architecture(Fabric)を使っています。
先に結論を書くと、原因はフォントの申告値と View の使い回しという 2 つの仕組みにありました。そしてどちらも、AI に修正を繰り返させるだけでは直りませんでした。
ログイン画面のplaceholderでyとpの下端が欠けた
Mendy の画面は、Figma のデザインを Figma MCP 経由で Claude Code に読ませて実装しました。ログイン画面も、デザインとほぼ同じものが一度で出てきました。画面を組む時間は大きく短くなったと感じています。
困ったのは、そのあとでした。シミュレータで表示を確かめると、入力欄の placeholder「your@example.com」の y と p の下端が欠けていました。
placeholder が欠ける原因はフォントの申告値だった
文字は、フォントが申告した高さの箱に描かれる
文字はベースラインという線の上に並びます。y や p のように、ベースラインより下に伸びる部分をディセンダーと呼びます。
OS は文字を描くとき、その文字を収める箱を用意します。箱の高さは、フォントが自ら申告する値で決まります。ベースラインから上下にどこまで伸びるかという情報は、フォントのファイル自身が持っています。そして、箱からはみ出した部分は描かれません。
Hiragino Sans の申告値と実際の字形には差がある
Hiragino Sans は、ディセンダーの深さを 0.12em と申告していますが、yの字形は0.211emまで下に伸びています。OSは申告通り0.12em分の箱しか用意しないので、その差の分が切り捨てられます。数値は Hiragino Sans W3 を CoreText で読み取ったものです。
これは Hiragino Sansの欠陥ではありません。
フォントの仕様である OpenType は、縦書きにも使う日本語・中国語・韓国語のフォントに対して、漢字を収める正方形の枠の上端と下端をそのまま申告するよう定めています(OpenType 仕様 OS/2 テーブル の sTypoAscender・sTypoDescender)。Hiragino Sans が申告する上下の伸びは 0.88em と 0.12em で、足すとちょうどこの枠の 1em になります。一方、y や p は欧文の字形なので、この枠より下まで伸びます。Apple のフォント仕様も、申告値は作り手の設計意図を表すもので、個々の字形がはみ出すことはあると書いています(TrueType Reference Manual の hhea テーブル)。
欧文の文字だけを1行の小さな箱に描くplaceholderでは、この設計と描画の仕組みがかみ合わなかったと言うことです。
Objective-C で placeholder の箱を広げる
入力欄だけフォントの指定を外してシステムフォントに任せれば、文字は欠けません。ただしその場合、入力欄の日本語が別のフォントで表示され、字がラベルより 7% ほど小さく見えます。Figma の指定どおり Hiragino Sans を使い続けるために、箱のほうを広げることにしました。
フォントの申告値はアプリ側から変えられないので、この修正は Native 側の Objective-C で行っています。
iOS の入力欄(UITextField)には、placeholder を描く箱を返す placeholderRectForBounds: という関数があります。この関数を差し替えて、箱の上端と高さを入力欄そのものに合わせました。
static CGRect MendyPlaceholderRectForBounds(
id self, SEL _cmd, CGRect bounds) {
CGRect rect = MendyOriginalPlaceholderRect(self, _cmd, bounds);
rect.origin.y = bounds.origin.y; // 箱の上端を入力欄の上端に
rect.size.height = bounds.size.height; // 箱の高さを入力欄の高さに
return rect;
}
*注: このコードは説明用のサンプルコードであり、実際に動いているコードとは異なります。
これで箱の高さが 16pt から 24pt になり、y の下端まで描かれるようになりました。この時点では、これで解決したと考えていました。
画面を行き来すると、同じ見た目の別の不具合が出た
修正後に画面を行き来して確かめていると、ログアウトしてログイン画面に戻ったときに、再び y が欠けていました。ただし、アプリを再起動した直後は正しく表示されます。
2 つを見比べると、箱の高さは足りており、文字の位置が下にずれています。見た目は同じでも、1 つ目とは別の原因による不具合でした。
原因は TextInput の View の使い回し
再起動すると直り、画面を行き来すると再発するという挙動から、前の状態がどこかに残っていると考えました。
React Native の New Architecture は iOS で、画面から消えた View をすぐには破棄せず、使い回し待ちとして保持します。次に同じ種類の View が必要になると、新しく作らずにそれを再利用します。
このとき、前の入力欄に設定されていた属性が残ったまま使い回されることがあります。ログアウトで消えた入力欄の View が、属性を残したままログイン画面の入力欄として再利用され、placeholder の位置がずれていました。
確かめるために、ログイン画面に戻る前にシミュレータでメモリ警告(Simulate Memory Warning)を出しました。React Native はメモリ警告を受けると、使い回し待ちの View を捨てます。そのあとログイン画面を開くと正しく表示されたので、原因はこの使い回しだと判断しました。
TextInput だけ使い回しを止める
React Native の View には、「使い回してよいか」を問われたときに答える関数があります。入力欄の View にだけこの関数を足し、NO を返すようにしました。
// 「使い回していい?」と聞かれたときに答える関数を、入力欄の View に足す
static BOOL MendyShouldNotBeRecycled(id self, SEL _cmd) {
return NO; // いいえ → 毎回新しく作る
}
*注: このコードは説明用のサンプルコードであり、実際に動いているコードとは異なります。この関数は、インスタンスではなく RCTTextInputComponentView クラスそのもの(クラスメソッド)に足します。
これで入力欄は毎回新しく作られ、前の属性を引き継がなくなりました。同じ仕組みで起きる不具合の Issue(https://github.com/react/react-native/issues/53050)もまだ解決していないため、この修正は暫定的な対処という位置づけです。
受け入れたトレードオフ
この対処には 2 つのトレードオフがあります。
- 描画が遅くなる:使い回しは描画を速くするための仕組みなので、止めればその分遅くなります。ただ、TextInput は一覧のように 1 画面に大量に並ぶ部品ではありません。ユーザーが体感できる遅延は出ないと判断しました。
- 届くまで時間がかかる:Mendy は JavaScript だけの変更なら OTA ですぐに届けられます。今回は Native 側の修正なので、次のストアバージョンと審査を待つ必要がありました。
学んだこと
画面を作る作業は、Figma MCP と Claude Code ですぐに終わりました。一方で placeholder の不具合は、「欠けているので直して」と AI に修正を繰り返させても直りませんでした。
直せたのは、どの仕組みを疑うかを人が絞り込んで、プロンプトに加えてからです。1 つ目は、余白を足しても直らないことから、文字を描く箱の大きさそのものを疑いました。2 つ目は、再起動直後は正しく、画面を行き来すると再発するという挙動の違いから、前の状態が残っていると考えました。そしてメモリ警告で使い回し待ちの View を捨てると直ることを確かめて、使い回しに行き着きました。
AI は与えられた範囲の中では粘り強く修正を試みます。それでも、挙動の違いから疑うべき仕組みを選ぶところは、文字の描かれ方や View のライフサイクルを知っている人のほうが速いと感じました。
まとめ
placeholder の文字が欠ける不具合には、原因が 2 つありました。
- フォントの申告値と実際の字形の差:Hiragino Sans はディセンダーを 0.12em と申告していますが、y は 0.211em まで伸びます。placeholder の箱を入力欄の高さまで広げて直しました。
- TextInput の View の使い回し:前の入力欄の属性が残ったまま再利用され、文字の位置がずれます。TextInput だけ使い回しを止めて直しました。
2 つ目は暫定的な対処です。また、Native 側の修正は OTA で届けられないので、こうした不具合をリリース前にどれだけ早く見つけられるかが課題として残っています。
表示の不具合で行き詰まったときは、その不具合がどの仕組みの上で起きているのかを一度考えてみると、AI に渡す問いも絞りやすくなります。