Calligraphy高级应用：SpannableString实现富文本字体

原创 于 2025-10-27 03:02:10 发布 · 390 阅读 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。

Calligraphy高级应用：SpannableString实现富文本字体

【免费下载链接】Calligraphy Custom fonts in Android the easy way... 【免费下载链接】Calligraphy 项目地址: https://gitcode.com/gh_mirrors/ca/Calligraphy

在Android应用开发中，实现多样化的文本展示效果往往需要复杂的布局或自定义控件。你是否还在为如何优雅地在同一文本中使用多种字体而烦恼？本文将详细介绍如何利用Calligraphy库的SpannableString功能，轻松实现富文本字体效果，让你的应用界面更具视觉吸引力。读完本文，你将掌握加载自定义字体、创建字体跨度以及在实际项目中应用富文本字体的完整流程。

Calligraphy富文本实现原理

Calligraphy库通过CalligraphyTypefaceSpan类实现富文本字体功能，该类继承自Android的MetricAffectingSpan，能够影响文本的度量和绘制状态。其核心原理是将自定义字体应用于SpannableString的指定区间，从而实现同一文本中的字体多样化。

CalligraphyTypefaceSpan核心实现

CalligraphyTypefaceSpan类位于calligraphy/src/main/java/uk/co/chrisjenx/calligraphy/CalligraphyTypefaceSpan.java，主要通过以下方式工作：

  • 存储自定义Typeface实例
  • 重写updateDrawState和updateMeasureState方法，将字体应用于文本绘制
  • 处理字体样式的兼容性，如粗体和斜体的模拟

关键代码如下：

public class CalligraphyTypefaceSpan extends MetricAffectingSpan {
    private final Typeface typeface;

    public CalligraphyTypefaceSpan(final Typeface typeface) {
        if (typeface == null) {
            throw new IllegalArgumentException("typeface is null");
        }
        this.typeface = typeface;
    }

    @Override
    public void updateDrawState(final TextPaint drawState) {
        apply(drawState);
    }

    @Override
    public void updateMeasureState(final TextPaint paint) {
        apply(paint);
    }

    private void apply(final Paint paint) {
        final Typeface oldTypeface = paint.getTypeface();
        final int oldStyle = oldTypeface != null ? oldTypeface.getStyle() : 0;
        final int fakeStyle = oldStyle & ~typeface.getStyle();

        if ((fakeStyle & Typeface.BOLD) != 0) {
            paint.setFakeBoldText(true);
        }

        if ((fakeStyle & Typeface.ITALIC) != 0) {
            paint.setTextSkewX(-0.25f);
        }

        paint.setTypeface(typeface);
    }
}

TypefaceUtils字体缓存机制

为提高性能，Calligraphy通过TypefaceUtils类实现字体和跨度的缓存管理。该类位于calligraphy/src/main/java/uk/co/chrisjenx/calligraphy/TypefaceUtils.java，使用HashMap存储已加载的字体和对应的跨度实例，避免重复创建导致的性能损耗。

public final class TypefaceUtils {
    private static final Map<String, Typeface> sCachedFonts = new HashMap<String, Typeface>();
    private static final Map<Typeface, CalligraphyTypefaceSpan> sCachedSpans = new HashMap<Typeface, CalligraphyTypefaceSpan>();

    public static Typeface load(final AssetManager assetManager, final String filePath) {
        synchronized (sCachedFonts) {
            try {
                if (!sCachedFonts.containsKey(filePath)) {
                    final Typeface typeface = Typeface.createFromAsset(assetManager, filePath);
                    sCachedFonts.put(filePath, typeface);
                    return typeface;
                }
            } catch (Exception e) {
                Log.w("Calligraphy", "Can't create asset from " + filePath, e);
                sCachedFonts.put(filePath, null);
                return null;
            }
            return sCachedFonts.get(filePath);
        }
    }

    public static CalligraphyTypefaceSpan getSpan(final Typeface typeface) {
        if (typeface == null) return null;
        synchronized (sCachedSpans) {
            if (!sCachedSpans.containsKey(typeface)) {
                final CalligraphyTypefaceSpan span = new CalligraphyTypefaceSpan(typeface);
                sCachedSpans.put(typeface, span);
                return span;
            }
            return sCachedSpans.get(typeface);
        }
    }
}

富文本字体实现步骤

1. 准备字体文件

CalligraphySample项目中已包含多种字体文件，存储在CalligraphySample/src/main/assets/fonts/目录下，包括：

  • Oswald-Stencbab.ttf
  • Roboto-Bold.ttf
  • Roboto-ThinItalic.ttf
  • RobotoCondensed-Regular.ttf
  • gtw.ttf

你可以根据项目需求添加更多字体文件，只需将字体文件放置在assets/fonts/目录下即可。

2. 初始化Calligraphy

在Application类中初始化Calligraphy，设置默认字体。示例项目的CalligraphySample/src/main/java/uk/co/chrisjenx/calligraphy/sample/CalligraphyApplication.java实现如下：

public class CalligraphyApplication extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        CalligraphyConfig.initDefault(new CalligraphyConfig.Builder()
                .setDefaultFontPath("fonts/Roboto-Regular.ttf")
                .setFontAttrId(R.attr.fontPath)
                .build()
        );
    }
}

3. 创建富文本字体工具类

为方便在项目中使用富文本字体功能，建议创建一个工具类封装相关操作：

public class RichTextUtils {
    /**
     * 创建带有多种字体的富文本
     * @param context 上下文
     * @param text 完整文本
     * @param fontPaths 字体路径数组
     * @param startIndices 起始索引数组
     * @param endIndices 结束索引数组
     * @return 富文本对象
     */
    public static SpannableString createRichText(Context context, String text, 
                                                String[] fontPaths, int[] startIndices, int[] endIndices) {
        SpannableString spannable = new SpannableString(text);
        
        for (int i = 0; i < fontPaths.length; i++) {
            // 加载字体
            Typeface typeface = TypefaceUtils.load(context.getAssets(), fontPaths[i]);
            // 获取字体跨度
            CalligraphyTypefaceSpan span = TypefaceUtils.getSpan(typeface);
            // 应用跨度到指定区间
            spannable.setSpan(span, startIndices[i], endIndices[i], 
                             Spanned.SPAN_EXCLUSIVE_EXCLUSIVE);
        }
        
        return spannable;
    }
}

4. 在Activity中应用富文本

在Activity中使用上述工具类创建富文本，并应用到TextView：

public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        
        TextView richTextView = findViewById(R.id.rich_text_view);
        
        // 创建富文本
        String text = "Hello Calligraphy Rich Text";
        String[] fonts = {
            "fonts/Roboto-Bold.ttf", 
            "fonts/Roboto-ThinItalic.ttf",
            "fonts/Oswald-Stencbab.ttf"
        };
        int[] starts = {0, 6, 12};
        int[] ends = {5, 11, 24};
        
        SpannableString richText = RichTextUtils.createRichText(this, text, fonts, starts, ends);
        richTextView.setText(richText);
    }
    
    @Override
    protected void attachBaseContext(Context newBase) {
        super.attachBaseContext(CalligraphyContextWrapper.wrap(newBase));
    }
}

实际应用场景示例

对话框中的富文本

在对话框中使用富文本可以提升用户体验，示例代码如下：

@OnClick(R.id.button_default)
public void onClickDefaultButton() {
    AlertDialog.Builder builder = new AlertDialog.Builder(getActivity());
    
    // 创建富文本标题
    SpannableString title = RichTextUtils.createRichText(getActivity(), 
        "Sample Dialog", 
        new String[]{"fonts/Oswald-Stencbab.ttf"}, 
        new int[]{0}, 
        new int[]{12});
    
    builder.setTitle(title);
    builder.setMessage("Custom Typeface Dialog");
    builder.setPositiveButton("OK", new DialogInterface.OnClickListener() {
        @Override
        public void onClick(DialogInterface dialog, int which) {
            dialog.dismiss();
        }
    });
    builder.create().show();
}

列表项中的富文本

在RecyclerView的列表项中使用富文本，可以使列表内容更加丰富多样：

public class RichTextAdapter extends RecyclerView.Adapter<RichTextAdapter.ViewHolder> {
    private List<String> mData;
    private Context mContext;
    
    // 构造函数、ViewHolder等省略...
    
    @Override
    public void onBindViewHolder(ViewHolder holder, int position) {
        String text = mData.get(position);
        // 根据位置应用不同的字体样式
        String fontPath = position % 2 == 0 ? 
            "fonts/Roboto-Bold.ttf" : "fonts/RobotoCondensed-Regular.ttf";
        
        SpannableString richText = RichTextUtils.createRichText(mContext, text,
            new String[]{fontPath}, new int[]{0}, new int[]{text.length()});
        
        holder.textView.setText(richText);
    }
    
    public static class ViewHolder extends RecyclerView.ViewHolder {
        TextView textView;
        
        public ViewHolder(View itemView) {
            super(itemView);
            textView = itemView.findViewById(R.id.item_text);
        }
    }
}

注意事项与优化建议

字体缓存管理

Calligraphy已实现字体缓存机制，但在使用过程中仍需注意：

  • 避免频繁创建相同的CalligraphyTypefaceSpan实例，尽量使用TypefaceUtils.getSpan()方法获取缓存实例
  • 对于不再使用的大型字体，可考虑从缓存中移除，以释放内存

性能优化

  • 避免在onDraw或onMeasure等频繁调用的方法中创建富文本
  • 对于静态富文本内容，建议在onCreate或onViewCreated中创建并缓存
  • 复杂的富文本布局可考虑使用AsyncTask或其他异步方式加载

兼容性处理

  • 在AndroidManifest.xml中声明Application类，确保Calligraphy正常工作
  • 对于API level低于16的设备，某些字体特性可能无法正常显示，建议进行兼容性测试
  • 使用CalligraphyContextWrapper包装Activity的上下文，确保字体在所有视图中生效

总结与展望

通过Calligraphy的SpannableString功能，我们可以轻松实现富文本字体效果，极大提升应用的视觉表现力。本文介绍的实现方法不仅适用于普通文本视图，还可应用于对话框、列表项等多种场景。

未来，随着Android系统的不断更新，Calligraphy库也将持续优化，为开发者提供更便捷的字体管理方案。建议关注项目的CHANGELOG.md文件，及时了解最新特性和改进。

希望本文能帮助你在项目中更好地应用富文本字体功能。如有任何问题或建议，欢迎在评论区留言讨论。如果你觉得本文对你有帮助，请点赞、收藏并关注，以便获取更多Android开发技巧和最佳实践。

【免费下载链接】Calligraphy Custom fonts in Android the easy way... 【免费下载链接】Calligraphy 项目地址: https://gitcode.com/gh_mirrors/ca/Calligraphy

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值