Definition

Assembly: Mintlify.Core.dll Namespace: Mintlify.Core.Converters Inheritance: System.Text.Json.Serialization.JsonConverter<object>

Syntax

Mintlify.Core.Converters.BackgroundImageConverter

Summary

Handles JSON conversion for background image properties that can be either strings or objects.

Remarks

Background image configurations in Mintlify can be specified as:
  • String: Single image URL (e.g., “https://example.com/image.png”)
  • Object: Light/dark mode specific images with “light” and “dark” properties

Constructors

.ctor

Syntax

public BackgroundImageConverter()

Methods

CanConvert

Determines whether the specified type can be converted by this converter.

Syntax

public override bool CanConvert(System.Type typeToConvert)

Parameters

NameTypeDescription
typeToConvertSystem.TypeThe type to convert.

Returns

Type: bool True if the type is object; otherwise, false.

Read

Reads and converts the JSON to a background image object.

Syntax

public override object Read(ref System.Text.Json.Utf8JsonReader reader, System.Type typeToConvert, System.Text.Json.JsonSerializerOptions options)

Parameters

NameTypeDescription
readerSystem.Text.Json.Utf8JsonReaderThe JSON reader.
typeToConvertSystem.TypeThe type to convert to.
optionsSystem.Text.Json.JsonSerializerOptionsThe serializer options.

Returns

Type: object? A string for single image URLs or a Dictionary for theme-specific image objects.

Exceptions

ExceptionDescription
JsonExceptionThrown when the JSON token type is not supported.

Write

Writes the background image object to JSON.

Syntax

public override void Write(System.Text.Json.Utf8JsonWriter writer, object value, System.Text.Json.JsonSerializerOptions options)

Parameters

NameTypeDescription
writerSystem.Text.Json.Utf8JsonWriterThe JSON writer.
valueobjectThe value to write.
optionsSystem.Text.Json.JsonSerializerOptionsThe serializer options.

Exceptions

ExceptionDescription
JsonExceptionThrown when the value type is not supported.