Skip to main content
Version: v8

ダイナミックフォントスケーリング

ダイナミックフォントスケーリングは、ユーザーが画面上に表示されるテキストのサイズを選択できる機能です。これは、読みやすさのために大きなテキストが必要なユーザーを支援し、小さなテキストを読むことができるユーザーにも対応します。

試してみる​

tip

Android、iOS、または iPadOS デバイスで試してください。

Android の Chrome でテストしている場合は、"Accessibility Page Zoom"が有効になっていることを確認してください。

デバイスでのフォントサイズの変更ガイドに従って、好みのフォントサイズを設定し、以下のデモのテキストが設定に応じて拡大または縮小するのを確認してください。

Ionic でダイナミックフォントスケーリングを有効にする​

info

この機能は現在、iOS ではオプトインです。ただし、Ionic 8 からデフォルトで有効になり、以下の CSS は不要になります。

ダイナミックフォントスケーリングは、Android ではデフォルトで既に有効になっています。開発者は、iOS で以下の手順を使用して有効にできます：

  1. typography.cssファイルがインポートされていることを確認します。
  2. グローバルスタイルシートに以下の CSS を追加します：
html {
  --ion-dynamic-font: var(--ion-default-dynamic-font);
}
note

内部では、Ionic は iOS デバイスでダイナミックフォントスケーリングを有効にするために以下の CSS を設定します：

html {
  font: var(--ion-dynamic-font);
}

ダイナミックフォントスケーリングの使用​

アプリケーションで有効にする​

typography.cssファイルがインポートされている限り、ダイナミックフォントスケーリングはデフォルトで有効になっています。このファイルをインポートすると、--ion-dynamic-font変数が定義され、ダイナミックフォントスケーリングがアクティブになります。推奨されませんが、開発者はアプリケーションコードでこの変数をinitialに設定することで、ダイナミックフォントスケーリングをオプトアウトできます。

カスタムコンポーネントの統合​

開発者は、カスタムコンポーネントを設定して、px単位を使用するfont-size宣言をrem 単位を使用するように変換することで、ダイナミックフォントスケーリングを活用できます。pxからremに変換する簡単な方法は、ピクセルフォントサイズをデフォルトのブラウザフォントサイズ（通常は16px）で割ることです。たとえば、コンポーネントのフォントサイズが14pxの場合、14px / 16px = 0.875remとしてremに変換できます。また、フォントサイズがオーバーライドされた Ionic コンポーネントも、rem単位を使用するように更新する必要があることに注意してください。

考慮すべき点の 1 つは、コンポーネントの寸法が大きなフォントサイズに対応するために変更する必要がある場合があることです。たとえば、widthとheightプロパティをそれぞれmin-widthとmin-heightに変更する必要がある場合があります。開発者は、length 値を使用する CSS プロパティについてアプリケーションを監査し、pxからremへの適切な変換を行う必要があります。また、大きなテキストを読みやすく保つために、長いテキストを切り詰めるのではなく、次の行に折り返すことをお勧めします。

カスタムフォントファミリー​

Ionic のデフォルトフォントは、あらゆるサイズで見栄えが良く、他のモバイルアプリとの一貫性を確保するように設計されているため、使用することをお勧めします。ただし、開発者は CSS を使用してダイナミックフォントスケーリングでカスタムフォントファミリーを使用できます：

html {
  --ion-dynamic-font: var(--ion-default-dynamic-font);
  --ion-font-family: 'Comic Sans MS';
}

em単位とrem単位​

開発者は、相対フォントサイズに 2 つのオプションがあります：emとrem。

em単位は、要素のフォントサイズを親のフォントサイズを基準に設定します。

次の例では、.childの計算されたフォントサイズは40pxです。これは.parentの子であるためです（2em * 20px = 40px）。

.parent {
  font-size: 20px;
}

.child {
  font-size: 2em;
}

ただし、em単位には複合効果があり、問題を引き起こす可能性があります。次の例では、2 番目の.child要素の計算されたフォントサイズは80pxです。フォントサイズが複合されるためです。

<div class="parent">
  Parent element with 20px
  <div class="child">
    Child element with 40px
    <div class="child">Child element with 80px</div>
  </div>
</div>

Parent element with 20px

Child element with 40px

Child element with 80px

この複合効果により、ダイナミックフォントスケーリングで作業する際は、em単位の代わりにrem単位を使用することを強くお勧めします。rem単位は、要素のフォントサイズをルート要素（通常は<html>）のフォントサイズを基準に設定します。ルート要素のデフォルトフォントサイズは通常16pxです。

次の例では、.childの計算されたフォントサイズは32pxです。フォントサイズが.parentではなくhtmlを基準に計算されるためです。

.parent {
  font-size: 20px;
}

.child {
  font-size: 2rem;
}

Ionic でのダイナミックフォントスケーリングの仕組み​

フォントサイズを定義し、ダイナミックフォントスケーリングに参加する Ionic コンポーネントは、通常rem 単位を使用します。これにより、各コンポーネント内のテキストがルート要素（通常はhtml要素）のフォントサイズを基準にサイズ設定されます。これは、ルート要素のフォントサイズが変更されると、すべての Ionic コンポーネント内のテキストが一貫した方法でスケールすることを意味します。これにより、各コンポーネントのフォントサイズを手動でオーバーライドする必要がなくなります。これらのコンポーネント内の一部の要素（アイコンなど）は、要素をテキストを基準にサイズ設定するためにem単位を使用しますが、テキスト自体はrem単位を使用してサイズ設定されます。

iOS​

Ionic のダイナミックフォントスケーリングは、Dynamic Typeと呼ばれる iOS 機能の上に構築されています。これを行うために、Ionic はルート要素のfontを Apple 定義のテキストスタイルに設定します。一貫性のために、Ionic はbodyテキストスタイルを使用します。

Apple 定義のテキストスタイルを使用すると、Dynamic Type が有効になり、Ionic コンポーネント内のすべてのテキストがシステムレベルの設定に従ってスケールします。これらの Apple 定義フォントは Apple デバイスでのみ機能することに注意してください。その結果、アプリがiosモードを使用している場合でも、これらのフォントは Android デバイスでは機能しません。

Ionic は、アプリがiosモードの場合、Apple の Human Interface Guidelines for Typographyに従います。その結果、テキストサイズが変更されると、重要なコンテンツが優先されます。これは、いくつかのことを意味します：

  1. ion-headerまたはion-footer内のコンテンツには最大フォントサイズが設定され、ion-headerとion-footer内のコンテンツよりも重要と見なされるion-content内のコンテンツが優先されます。
  2. ion-badgeやion-back-buttonなどのコンポーネントには最小フォントサイズが設定され、読みやすさが保たれます。
  3. ion-tab-barやion-pickerなどのコンポーネント内のテキストは、Apple の Human Interface Guidelines に従ってダイナミックフォントスケーリングに参加しません。

Android Web View​

Android Web View のフォントスケーリングメカニズムは、Web コンテンツで常に有効になっており、px単位で定義されたフォントサイズを自動的にスケールします。これは、pxを使用して指定された最大または最小フォントサイズは、最終的なフォントサイズが指定された最大または最小フォントサイズと一致しない場合でも、スケールされることを意味します。

次の例では、min()関数を使用して、.fooのフォントサイズが14pxを超えないように指定しています。

.foo {
  font-size: min(1rem, 14px);
}

ルート要素のデフォルトフォントサイズが16pxで、システムレベルのフォントスケールが1.5（つまり、テキストサイズを 50%増やす）の場合、1remは16 * 1.5 = 24であるため、24pxと評価されます。

これは定義された最大値14pxより大きいため、.fooの評価されたフォントサイズは14pxであると想定されるかもしれません。ただし、Android Web View はpx単位で定義されたフォントサイズをスケールするため、min()関数で使用される14pxも 1.5 倍にスケールされます。

その結果、最大計算フォントサイズは実際には14 * 1.5 = 21であるため21pxとなり、したがって.fooの全体的な計算フォントサイズは21pxです。

Chrome for Android​

Android の Chrome Web Browser は、Android Web View とは異なる動作をします。デフォルトでは、Chrome for Android はシステムレベルのフォントスケール設定を尊重しません。ただし、Chromium チームはこれを可能にする新機能に取り組んでいます。有効にすると、この機能はhtml要素のzoomレベルを変更し、テキストに加えてレイアウトのサイズも増加させます。

開発者は、chrome://flagsで実験的な「Accessibility Page Zoom」機能を有効にすることで、この動作をテストできます。

詳細については、https://bugs.chromium.org/p/chromium/issues/detail?id=645717を参照してください。

異なるプラットフォームでのモードの使用​

各プラットフォームには、わずかに異なるフォントスケーリング動作があり、iosとmdモードは、それぞれのプラットフォームでのスケーリング動作を活用するように実装されています。

たとえば、iosモードは、Apple の Human Interface Guidelines for Typographyに従うために最大および最小フォントサイズを利用します。mdモードは、Material Design には同じガイダンスがないため、この同じ動作を実装していません。これは、iOS デバイスでmdモードを使用すると、ヘッダーとフッターで非常に大きなフォントサイズが許可される可能性があることを意味します。

その結果、ダイナミックフォントスケーリングを使用する場合は、iOS デバイスでiosモードを使用し、Android デバイスでmdモードを使用することを強くお勧めします。

デバイスでのフォントサイズの変更​

フォントスケーリングの設定は、ユーザーがデバイスごとに設定します。これにより、ユーザーはこの動作をサポートするすべてのアプリケーションでフォントをスケールできます。このガイドでは、各プラットフォームでフォントスケーリングを有効にする方法を示します。

iOS​

iOS でのフォントスケーリングは、設定アプリで設定できます。

詳細については、Apple Supportを参照してください。

Android​

ユーザーがフォントスケーリング設定にアクセスする場所はデバイスによって異なりますが、通常は設定アプリの「アクセシビリティ」ページにあります。

info

Android の Chrome Web Browser には、システムレベルのフォントスケールを尊重する際にいくつかの制限があります。詳細については、Chrome for Androidを参照してください。

トラブルシューティング​

ダイナミックフォントスケーリングが機能しない​

ダイナミックフォントスケーリングがアプリに影響を与えない理由はいくつかあります。以下のリストは網羅的ではありませんが、ダイナミックフォントスケーリングが機能しない理由をデバッグするために確認すべきいくつかのことを提供します。

  1. Ionic のバージョンがダイナミックフォントスケーリングをサポートしていることを確認してください。ダイナミックフォントスケーリングは、Ionic v7.5 から追加されました。
  2. typography.cssファイルがインポートされていることを確認してください。このファイルは、ダイナミックフォントスケーリングが機能するために必要です。
  3. コードがルート要素のデフォルトフォントサイズをオーバーライドしていないことを確認してください。ルート要素にフォントサイズを手動で設定すると、ダイナミックフォントスケーリングが意図したとおりに機能しなくなります。
  4. コードが Ionic コンポーネントのフォントサイズをオーバーライドしていないことを確認してください。font-sizeルールを設定する Ionic コンポーネントはrem単位を使用します。ただし、アプリがそれをpxを使用するようにオーバーライドしている場合、そのカスタムルールをremを使用するように変換する必要があります。詳細については、カスタムコンポーネントの統合を参照してください。
  5. Chrome for Android を使用している場合は、「Accessibility Page Zoom」が有効になっていることを確認してください。詳細については、Chrome for Androidを参照してください。

Android で最大および最小フォントサイズが尊重されない​

Android Web View は、システムレベルのフォントスケール設定によってpx単位で定義されたフォントサイズをスケールします。これは、実際のフォントサイズがmin()、max()、またはclamp()で定義されたフォントサイズより大きいか小さい可能性があることを意味します。

詳細については、Android でのフォントスケーリングの仕組みを参照してください。

ダイナミックフォントスケーリングが無効でもフォントサイズが大きい/小さい​

Ionic コンポーネントは、ダイナミックフォントスケーリングが無効になっている場合でも、rem 単位を使用してフォントサイズを定義します。これにより、各コンポーネント内のテキストがルート要素（通常はhtml要素）のフォントサイズを基準にサイズ設定されます。その結果、htmlのフォントサイズが変更されると、すべての Ionic コンポーネントの計算されたフォントサイズも変更されます。

スケールされた Ionic iOS コンポーネントのフォントサイズがネイティブ iOS の同等物と完全に一致しない​

Action Sheet などの特定のネイティブ iOS コンポーネントは、Ionic がアクセスできないプライベートフォントスケールを使用します。ネイティブの動作にできるだけ近づけようとしていますが、一部のコンポーネントのテキストは、ネイティブの対応物よりわずかに大きくまたは小さくレンダリングされる場合があります。

iOS で Ionic アプリのテキストサイズがダイナミックフォントスケーリングを有効にしたときに変更された​

ルート要素のデフォルトフォントサイズは通常16pxです。ただし、iOS デバイスでのダイナミックフォントスケーリングは、デフォルトフォントサイズが17pxの"Body"テキストスタイルを利用します。Ionic コンポーネント内のテキストはルート要素のフォントサイズを基準にスケールされるため、システムレベルのテキストスケールが変更されていなくても、ダイナミックフォントスケーリングを有効にすると一部のテキストが大きくなったり小さくなったりする場合があります。

info

iOS は、デフォルトフォントサイズが16pxの"Callout"テキストスタイルを提供します。ただし、このフォントスタイルは現在、Web コンテンツに公開されていません。詳細については、WebKit でサポートされているテキストスタイルを参照してください。

Dynamic Font Scaling

Dynamic Font Scaling is a feature that allows users to choose the size of the text displayed on the screen. This helps users who need larger text for better readability, and it also accommodates users who can read smaller text.

Try It Out​

tip

Be sure to try this on an Android, iOS, or iPadOS device.

If you are testing on Chrome for Android, make sure "Accessibility Page Zoom" is enabled.

Follow the Changing the Font Size on a Device guide to set your preferred font size, and watch the text in the demo below grow or shrink according to your preferences.

Using Dynamic Font Scaling​

Enabling in an Application​

Dynamic Font Scaling is enabled by default as long as the typography.css file is imported. Importing this file will define the --ion-dynamic-font variable which will activate Dynamic Font Scaling. While not recommended, developers can opt-out of Dynamic Font Scaling by setting this variable to initial in their application code.

Integrating Custom Components​

Developers can configure their custom components to take advantage of Dynamic Font Scaling by converting any font-size declarations that use px units to use rem units instead. An easy way to convert from px to rem is to divide the pixel font size by the default browser font size, which is typically 16px. For example, if a component has a font size of 14px, then this could be converted to rem by doing 14px / 16px = 0.875rem. Also note that any Ionic components that have had their font sizes overridden should also be updated to use rem units.

One thing to keep in mind is that the dimensions of your components may need to change to accommodate the larger font sizes. For example, width and height properties may need to change to min-width and min-height, respectively. Developers should audit their applications for any CSS properties that use length values and make any applicable conversions from px to rem. We also recommend having long text wrap to the next line instead of truncating to keep large text readable.

Custom Font Family​

We recommend using the default fonts in Ionic as they are designed to look good at any size and ensure consistency with other mobile apps. However, developers can use a custom font family with Dynamic Font Scaling via CSS:

html {
  --ion-dynamic-font: var(--ion-default-dynamic-font);
  --ion-font-family: 'Comic Sans MS';
}

em units versus rem units​

Developers have two options for relative font sizes: em and rem.

em units set the font size of an element relative to the font size of its parent.

In the following example, the computed font size of .child is 40px because it is a child of .parent (2em * 20px = 40px).

.parent {
  font-size: 20px;
}

.child {
  font-size: 2em;
}

However, the em unit has a compounding effect which can cause issues. In the following example, the second .child element has a computed font size of 80px since the font sizes compound.

<div class="parent">
  Parent element with 20px
  <div class="child">
    Child element with 40px
    <div class="child">Child element with 80px</div>
  </div>
</div>

Parent element with 20px

Child element with 40px

Child element with 80px

Due to this compounding effect, we strongly recommend using rem units instead of em units when working with Dynamic Font Scaling. rem units set the font size of an element relative to the font size of the root element, which is typically <html>. The default font size of the root element is typically 16px.

In the following example, the computed font size of .child is 32px because the font size is being computed relative to html, not .parent.

.parent {
  font-size: 20px;
}

.child {
  font-size: 2rem;
}

How Dynamic Font Scaling works in Ionic​

Ionic components that define font sizes and participate in Dynamic Font Scaling typically use rem units. This sizes the text in each component relative to the font size of the root element, which is usually the html element. This means that as the root element's font size changes, the text in all Ionic components scale in a consistent manner. This avoids the need to manually override each component's font size. Some elements inside of these components, such as icons, use em units instead so the elements are sized relative to the text, though the text itself is sized using rem units.

iOS​

Dynamic Font Scaling in Ionic builds on top of an iOS feature called Dynamic Type. To do this, Ionic sets the font of the root element to an Apple-defined text style. For consistency, Ionic uses the body text style.

Using the Apple-defined text style enables Dynamic Type, allowing all text in Ionic components to scale according to the system-level preference. Note that these Apple-defined fonts only work on Apple devices. As a result, these fonts will not work on Android devices even if your app is using ios mode.

Ionic follows Apple's Human Interface Guidelines for Typography when an app is in ios mode. As a result, important content is prioritized when the text size changes. This means a few things:

  1. Content in an ion-header or an ion-footer will have maximum font sizes to prioritize content in ion-content which is deemed more important than content in the ion-header and ion-footer.
  2. Components such as ion-badge and ion-back-button will have minimum font sizes so they remain readable.
  3. Text in components such as ion-tab-bar and ion-picker do not participate in Dynamic Font Scaling according to Apple's Human Interface Guidelines.

Android Web View​

The Android Web View's font scaling mechanism is always enabled in web content and will automatically scale font sizes defined using the px unit. This means that any maximum or minimum font sizes specified using px will still be scaled even if the final font size does not align with the maximum or minimum font sizes specified.

In the following example we are using the min() function to indicate that the font size of .foo should be no larger than 14px.

.foo {
  font-size: min(1rem, 14px);
}

If the root element's default font size is 16px, and the system-level font scale is 1.5 (i.e text sizes should be increased by 50%), then 1rem will evaluate to 24px because 16 * 1.5 = 24.

This is larger than our defined maximum of 14px, so one might assume that the evaluated font size of .foo is 14px. However, since the Android Web View scales any font sizes defined using the px unit, this means the 14px used in our min() function will also be scaled by 1.5.

As a result, this means that the maximum computed font size is actually 21px since 14 * 1.5 = 21 and therefore the overall computed font size of .foo is 21px.

Chrome for Android​

The Chrome Web Browser on Android behaves differently than the Android Web View. By default, Chrome for Android does not respect the system-level font scale setting. However, the Chromium team is working on a new feature to allow for this. When enabled, this feature will change the zoom level of the html element which will cause the layout to increase in size in addition to the text.

Developers can test this behavior by enabling the experimental "Accessibility Page Zoom" feature in chrome://flags.

See https://bugs.chromium.org/p/chromium/issues/detail?id=645717 for more information.

Using Modes on Different Platforms​

Each platform has slightly different font scaling behaviors, and the ios and md modes have been implemented to take advantage of the scaling behaviors on their respective platforms.

For example, ios mode makes use of maximum and minimum font sizes to follow Apple's Human Interface Guidelines for Typography. md mode does not implement this same behavior because Material Design does not have that same guidance. This means that using md mode on an iOS device may allow for very large font sizes in headers and footers.

As a result, we strongly recommend using ios mode on iOS devices and md mode on Android devices when using Dynamic Font Scaling.

Changing the Font Size on a Device​

Font scaling preferences are configured on a per-device basis by the user. This allows the user to scale the font for all applications that support this behavior. This guide shows how to enable font scaling for each platform.

iOS​

Font scaling on iOS can be configured in the Settings app.

See Apple Support for more information.

Android​

Where users access the font scaling configuration varies across devices, but it is typically found in the "Accessibility" page in the Settings app.

info

The Chrome Web Browser on Android has some limitations with respecting system-level font scales. See Chrome for Android for more information.

Troubleshooting​

Dynamic Font Scaling is not working​

There are a number of reasons why Dynamic Font Scaling may not have any effect on an app. The following list, while not exhaustive, provides some things to check to debug why Dynamic Font Scaling is not working.

  1. Verify that your version of Ionic supports Dynamic Font Scaling. Dynamic Font Scaling was added starting in Ionic v7.5.
  2. Verify that the typography.css file has been imported. This file is required for Dynamic Font Scaling to work.
  3. Verify that your code does not override the root element's default font size. Manually setting a font size on the root element will prevent Dynamic Font Scaling from working as intended.
  4. Verify that your code does not override font sizes on Ionic components. Ionic components that set font-size rules will use rem units. However, if your app overrides that to use px, then that custom rule will need to be converted to use rem. See Integrating Custom Components for more information.
  5. Verify "Accessibility Page Zoom" is enabled if using Chrome for Android. See Chrome for Android for more information.

Maximum and minimum font sizes are not being respected on Android​

The Android Web View scales any font sizes defined using the px unit by the system-level font scale preference. This means that actual font sizes may be larger or smaller than the font sizes defined in min(), max(), or clamp().

See how font scaling works on Android for more information.

Font sizes are larger/smaller even with Dynamic Font Scaling disabled​

Ionic components define font sizes using rem units even when Dynamic Font Scaling is disabled. This sizes the text in each component relative to the font size of the root element, which is usually the html element. As a result, if the font size of html changes, the computed font size of all Ionic components will change too.

Scaled Ionic iOS component font sizes do not exactly match native iOS equivalents​

Certain native iOS components such as the Action Sheet make use of private font scales that Ionic does not have access to. While we try to stay as close as possible to the native behavior, text in some components may render slightly larger or smaller than their native counterparts.

The text size in my Ionic app on iOS changed when enabling Dynamic Font Scaling​

The root element's default font size is typically 16px. However, Dynamic Font Scaling on iOS devices make use of the "Body" text style which has a default font size of 17px. Since the text in Ionic components is scaled relative to the root element's font size, some text may get larger or smaller when Dynamic Font Scaling is enabled, even if the system-level text scale did not change.

info

iOS provides a "Callout" text style which has a default font size of 16px. However, this font style is currently not exposed to web content. See the supported text styles in WebKit for more information.

Contents

Edit this page