Kotlinを使ってAndroidアプリで文字列に下付き文字・上付き文字を適用する方法

このチュートリアルでは、Kotlinを使用してAndroidアプリ内の文字列に下付き文字（Subscript）と上付き文字（Superscript）を適用する方法を解説します。化学式や数式などを表示する際に便利なテクニックです。

実装のポイント

Androidでは、SpannableStringBuilderとSubscriptSpan、SuperscriptSpan、RelativeSizeSpanを組み合わせることで、文字列の一部だけを下付き・上付き表示できます。下付き・上付き文字はそのままだと元のサイズのままなので、RelativeSizeSpanでサイズを縮小するとより自然な見た目になります。

ステップ1：新規プロジェクトを作成する

Android Studioを開き、「File」→「New Project」を選択して、必要な情報を入力し新しいプロジェクトを作成します。

ステップ2：レイアウトファイル（activity_main.xml）を編集する

res/layout/activity_main.xml に以下のコードを追加します。

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="https://schemas.android.com/apk/res/android"
    xmlns:tools="https://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:padding="8dp"
    tools:context=".MainActivity">
    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_centerHorizontal="true"
        android:layout_marginTop="50dp"
        android:text="Tutorials Point"
        android:textAlignment="center"
        android:textColor="@android:color/holo_green_dark"
        android:textSize="32sp"
        android:textStyle="bold" />
    <TextView
        android:id="@+id/textView"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_centerInParent="true"
        android:fontFamily="sans-serif-condensed"
        android:textAlignment="center"
        android:textColor="@android:color/background_dark"
        android:textSize="36sp"
        android:textStyle="bold" />
</RelativeLayout>

ステップ3：MainActivity.ktを実装する

src/MainActivity.kt に以下のコードを記述します。

import android.os.Bundle
import android.text.SpannableStringBuilder
import android.text.Spanned
import android.text.style.RelativeSizeSpan
import android.text.style.SubscriptSpan
import android.text.style.SuperscriptSpan
import android.widget.TextView
import androidx.appcompat.app.AppCompatActivity
class MainActivity : AppCompatActivity() {
    lateinit var textView: TextView
    private lateinit var strText: String
    lateinit var spannableStringBuilder: SpannableStringBuilder
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        title = "KotlinApp"
        textView = findViewById(R.id.textView)
        strText = "Test text to show SubscriptSpan X2 and SuperscriptSpan Y5 example."
        spannableStringBuilder = SpannableStringBuilder(strText)
        val subscriptSpan = SubscriptSpan()
        val superscriptSpan = SuperscriptSpan()
        spannableStringBuilder.setSpan(subscriptSpan, strText.indexOf("2"),
        strText.indexOf("2") + "2".length,
        Spanned.SPAN_EXCLUSIVE_EXCLUSIVE)
        spannableStringBuilder.setSpan(superscriptSpan, strText.indexOf("5"), strText.indexOf("5") +
        "5".length,
        Spanned.SPAN_EXCLUSIVE_EXCLUSIVE)
        showSmallSizeText("2")
        showSmallSizeText("5")
        textView.text = spannableStringBuilder
    }
    private fun showSmallSizeText(string: String) {
        val relativeSizeSpan = RelativeSizeSpan(.5f)
        spannableStringBuilder.setSpan(relativeSizeSpan, strText.indexOf(string),
        strText.indexOf(string) + string.length, Spanned.SPAN_EXCLUSIVE_EXCLUSIVE)
    }
}

コードの解説

• SubscriptSpan：指定した範囲の文字を下付き（ベースラインより下）に表示します。
• SuperscriptSpan：指定した範囲の文字を上付き（ベースラインより上）に表示します。
• RelativeSizeSpan(0.5f)：対象の文字を元のサイズの50%に縮小し、下付き・上付き文字らしい見た目にします。
• SPAN_EXCLUSIVE_EXCLUSIVE：スパンの範囲が拡張されないよう設定するフラグです。

ステップ4：AndroidManifest.xmlを確認する

androidManifest.xml に以下のコードを追加します。特別な権限は不要ですが、ランチャーアクティビティの設定を確認しておきましょう。

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android" package="app.com.q11">
    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>
</manifest>

アプリを実行して確認する

それでは、実際にアプリを実行してみましょう。Android端末をパソコンに接続していることを前提としています。Android Studioからアプリを実行するには、プロジェクト内のアクティビティファイルを開き、ツールバーの「Run」アイコンをクリックします。表示された選択肢から接続したモバイルデバイスを選択すると、実機の画面に結果が表示されます。

実行すると、「X2」の「2」が下付き文字に、「Y5」の「5」が上付き文字に小さく表示され、Spanの効果を視覚的に確認できます。この手法を応用すれば、H₂Oやm²のような表記も簡単に実現できます。