Spans Factory

Starting with 3.0.0 MarkwonSpansFactory controls what spans are displayed for markdown nodes.

Markwon.builder(context)
        .usePlugin(new AbstractMarkwonPlugin() {
            @Override
            public void configureSpansFactory(@NonNull MarkwonSpansFactory.Builder builder) {
                // passing null as second argument will remove previously added 
                // factory for the Link node
                builder.setFactory(Link.class, null);
            }
        });

SpanFactory

In order to create a generic interface for all possible Nodes, a SpanFactory was added:

builder.setFactory(Link.class, new SpanFactory() {
    @Nullable
    @Override
    public Object getSpans(@NonNull MarkwonConfiguration configuration, @NonNull RenderProps props) {
        return null;
    }
});

All possible arguments are passed via RenderProps:

builder.setFactory(Link.class, new SpanFactory() {
    @Override
    public Object getSpans(@NonNull MarkwonConfiguration configuration, @NonNull RenderProps props) {
        final String href = CoreProps.LINK_DESTINATION.require(props);
        return new LinkSpan(configuration.theme(), href, configuration.linkResolver());
    }
});

SpanFactory allows returning null for a certain span (no span will be applied). Or an array of spans (you can go deeper):

builder.setFactory(Link.class, new SpanFactory() {
    @Override
    public Object getSpans(@NonNull MarkwonConfiguration configuration, @NonNull RenderProps props) {
        return new Object[]{
                new LinkSpan(
                        configuration.theme(),
                        CoreProps.LINK_DESTINATION.require(props),
                        configuration.linkResolver()),
                new ForegroundColorSpan(Color.RED)
        };
    }
});

WARNING

Deprecated in 4.2.2. Use appendFactory or prependFactory for more explicit factories ordering. addFactories behaves like new prependFactory method.

Since 3.0.14.2.2 you can add multiple SpanFactory for a single node:

final Markwon markwon = Markwon.builder(context)
        .usePlugin(new AbstractMarkwonPlugin() {
            @Override
            public void configureSpansFactory(@NonNull MarkwonSpansFactory.Builder builder) {
                // this factory will be used _along_ with all other factories for specified node
                builder.addFactory(Code.class, new SpanFactory() {
                    @Override
                    public Object getSpans(@NonNull MarkwonConfiguration configuration, @NonNull RenderProps props) {
                        return new ForegroundColorSpan(Color.GREEN);
                    }
                });
            }
        })
        .build();

appendFactory/prependFactory 4.2.2

use appendFactory if you wish to add a factory after original (can be used to post-process original factory)
use prependFactory if you wish to add a factory before original (original factory will be applied after this one)

@Override
public void configureSpansFactory(@NonNull MarkwonSpansFactory.Builder builder) {
    // `RemoveUnderlineSpan` will be added AFTER original, thus it will remove underline applied by original
    builder.appendFactory(Link.class, (configuration, props) -> new RemoveUnderlineSpan());

    // will be added BEFORE origin (origin can override this)
    builder.prependFactory(Link.class, (configuration, props) -> new AbsoluteSizeSpan(48, true));
}

If you wish to inspect existing factory you can use:

builder#getFactory() -> returns registered factory or null
builder#requireFactory() -> returns registered factory or throws 3.0.1

final Markwon markwon = Markwon.builder(context)
        .usePlugin(new AbstractMarkwonPlugin() {
            @Override
            public void configureSpansFactory(@NonNull MarkwonSpansFactory.Builder builder) {
                final SpanFactory codeFactory = builder.requireFactory(Code.class);
                final SpanFactory linkFactory = builder.getFactory(Link.class);
                if (linkFactory != null) {
                    {...}
                }
            }
        })
        .build();

# Spans Factory

# SpanFactory

# appendFactory/prependFactory 4.2.2

Spans Factory

SpanFactory

appendFactory/prependFactory 4.2.2