Builder of a List of InputRichBlocks - the root of the rich message input DSL. Text-bearing and container blocks have their own DSL functions; media blocks (photo, video, animation, audio, voice note, collage, slideshow, table, map) can be appended with the matching convenience function or with add / unary plus.

InputRichBlockSectionHeading

@Serializable

data class InputRichBlockSectionHeading(val text: RichText, val level: Int) : InputRichBlock

A section heading.

InputRichBlockSerializer

object InputRichBlockSerializer : JsonContentPolymorphicSerializer<InputRichBlock>

InputRichBlockSlideshow

@Serializable

data class InputRichBlockSlideshow(val blocks: List<InputRichBlock>, val caption: RichBlockCaption? = null) : InputRichBlock

A slideshow.

InputRichBlockTable

@Serializable

data class InputRichBlockTable(val cells: List<List<RichBlockTableCell>>, val isBordered: Boolean? = null, val isStriped: Boolean? = null, val caption: RichText? = null) : InputRichBlock

A table.

InputRichBlockTableBuilder

class InputRichBlockTableBuilder

Builder of table rows used inside InputRichBlocksBuilder.table.

InputRichBlockTableRowBuilder

class InputRichBlockTableRowBuilder

Builder of RichBlockTableCells used inside InputRichBlockTableBuilder.row.

InputRichBlockThinking

@Serializable

data class InputRichBlockThinking(val text: RichText) : InputRichBlock

A block with a "Thinking…" placeholder. May be used only in dev.inmo.tgbotapi.requests.send.SendRichMessageDraft.

InputRichBlockUnorderedListBuilder

class InputRichBlockUnorderedListBuilder

Builder of InputRichBlockListItem.Unordered items used inside InputRichBlocksBuilder.unorderedList.

InputRichBlockVideo

@Serializable

data class InputRichBlockVideo(val video: TelegramMediaVideo, val caption: RichBlockCaption? = null) : InputRichBlockMedia

A block with a video.

InputRichBlockVoiceNote

@Serializable

data class InputRichBlockVoiceNote(val voiceNote: TelegramMediaVoiceNote, val caption: RichBlockCaption? = null) : InputRichBlockMedia

A block with a voice note.

InputRichMessage

@Serializable

data class InputRichMessage

Describes a rich message to be sent. Exactly one of the fields html, markdown or blocks must be used. Use the InputRichMessageHTML, InputRichMessageMarkdown and InputRichMessageBlocks factories to build an instance.

InputRichMessageMedia

@Serializable

data class InputRichMessageMedia(val id: String, val media: RichMessageMemberTelegramMedia)

Describes a media referenced from InputRichMessage.html/InputRichMessage.markdown via tg://photo?id=, tg://video?id= and tg://audio?id= links.

LabelType

@Serializable(with = LabelType.Serializer::class)

sealed interface LabelType

Type of an ordered InputRichBlockListItem label.

RichBlock

@Serializable(with = RichBlockSerializer::class)

sealed interface RichBlock

Represents a block in a rich formatted message.

RichBlockAnchor

@Serializable

data class RichBlockAnchor(val name: String) : RichBlock

A block with an anchor.

RichBlockAnimation

@Serializable

data class RichBlockAnimation(val animation: AnimationFile, val hasSpoiler: Boolean? = null, val caption: RichBlockCaption? = null) : RichBlockMedia

A block with an animation.

RichBlockAudio

@Serializable

data class RichBlockAudio(val audio: AudioFile, val caption: RichBlockCaption? = null) : RichBlockMedia

A block with a music file.

RichBlockBlockQuotation

@Serializable

data class RichBlockBlockQuotation(val blocks: List<RichBlock>, val credit: RichText? = null) : RichBlock

A block quotation.

RichBlockCaption

@Serializable

data class RichBlockCaption(val text: RichText, val credit: RichText? = null)

Caption of a rich formatted block.

RichBlockCollage

@Serializable

data class RichBlockCollage(val blocks: List<RichBlock>, val caption: RichBlockCaption? = null) : RichBlock

A collage.

RichBlockDetails

@Serializable

data class RichBlockDetails(val summary: RichText, val blocks: List<RichBlock>, val isOpen: Boolean? = null) : RichBlock

An expandable block for details disclosure.

RichBlockDivider

@Serializable

class RichBlockDivider : RichBlock

A divider.

RichBlockFooter

@Serializable

data class RichBlockFooter(val text: RichText) : RichBlock

A footer.

RichBlockList

@Serializable

data class RichBlockList(val items: List<RichBlockListItem>) : RichBlock

A list of blocks.

RichBlockListBuilder

class RichBlockListBuilder

Builder of RichBlockListItems used inside RichBlocksBuilder.list.

RichBlockListItem

@Serializable

data class RichBlockListItem(val label: String, val blocks: List<RichBlock>, val hasCheckbox: Boolean? = null, val isChecked: Boolean? = null, val value: Int? = null, val labelType: String? = null)

An item of a RichBlockList.

RichBlockMap

@Serializable

data class RichBlockMap(val location: StaticLocation, val zoom: Int, val width: Int, val height: Int, val caption: RichBlockCaption? = null) : RichBlock

A block with a map.

RichBlockMathematicalExpression

@Serializable

data class RichBlockMathematicalExpression(val expression: String) : RichBlock

A block with a mathematical expression in LaTeX format.

RichBlockMedia

@Serializable(with = RichBlockSerializer::class)

sealed interface RichBlockMedia : RichBlock

RichBlockParagraph

@Serializable

data class RichBlockParagraph(val text: RichText) : RichBlock

A text paragraph.

RichBlockPhoto

@Serializable

data class RichBlockPhoto(val photo: PhotoFile, val hasSpoiler: Boolean? = null, val caption: RichBlockCaption? = null) : RichBlockMedia

A block with a photo.

RichBlockPreformatted

@Serializable

data class RichBlockPreformatted(val text: RichText, val language: String? = null) : RichBlock

A preformatted text block.

RichBlockPullQuotation

@Serializable

data class RichBlockPullQuotation(val text: RichText, val credit: RichText? = null) : RichBlock

A quotation with centered text.

RichBlocksBuilder

class RichBlocksBuilder

Builder of a List of RichBlocks - the root of the rich message DSL. Text-bearing and container blocks have their own DSL functions; file/cell-heavy blocks (media, collage, slideshow, table, map) can be appended with add / unary plus.

RichBlockSectionHeading

@Serializable

data class RichBlockSectionHeading(val text: RichText, val level: Int) : RichBlock

A section heading.

RichBlockSerializer

object RichBlockSerializer : JsonContentPolymorphicSerializer<RichBlock>

RichBlockSlideshow

@Serializable

data class RichBlockSlideshow(val blocks: List<RichBlock>, val caption: RichBlockCaption? = null) : RichBlock

A slideshow.

RichBlockTable

@Serializable

data class RichBlockTable(val cells: List<List<RichBlockTableCell>>, val isBordered: Boolean? = null, val isStriped: Boolean? = null, val caption: RichText? = null) : RichBlock

A table.

RichBlockTableCell

@Serializable(with = RichBlockTableCell.Serializer::class)

sealed interface RichBlockTableCell

A cell in a RichBlockTable.

RichBlockTableCellAlign

@Serializable(with = RichBlockTableCellAlign.Serializer::class)

sealed interface RichBlockTableCellAlign

Horizontal alignment of a RichBlockTableCell.

RichBlockTableCellVAlign

@Serializable(with = RichBlockTableCellVAlign.Serializer::class)

sealed interface RichBlockTableCellVAlign

Vertical alignment of a RichBlockTableCell.

RichBlockThinking

@Serializable

data class RichBlockThinking(val text: RichText) : RichBlock

A block with a "Thinking…" placeholder. May be used only in sendRichMessageDraft.

RichBlockVideo

@Serializable

data class RichBlockVideo(val video: VideoFile, val hasSpoiler: Boolean? = null, val caption: RichBlockCaption? = null) : RichBlockMedia

A block with a video.

RichBlockVoiceNote

@Serializable

data class RichBlockVoiceNote(val voiceNote: VoiceFile, val caption: RichBlockCaption? = null) : RichBlockMedia

A block with a voice note.

RichText

@Serializable(with = RichTextSerializer::class)

sealed interface RichText

Represents a rich formatted text. It can be either a plain text (RichTextPlain), a group of rich texts (RichTextGroup) or any of RichTextEntity subtypes.

RichTextAnchor

@Serializable

data class RichTextAnchor(val name: String) : RichTextEntity

An anchor.

RichTextAnchorLink

@Serializable

data class RichTextAnchorLink(val text: RichText, val anchorName: String) : RichTextEntity

A link to an anchor.

RichTextBankCardNumber

@Serializable

data class RichTextBankCardNumber(val text: RichText, val bankCardNumber: String) : RichTextEntity

A RichTextEntity with a bank card number.

RichTextBold

@Serializable

data class RichTextBold(val text: RichText) : RichTextEntity

A bold RichTextEntity.

RichTextBotCommand

@Serializable

data class RichTextBotCommand(val text: RichText, val botCommand: String) : RichTextEntity

A bot command.

RichTextBuilder

class RichTextBuilder

Builder of a single RichText. Each call appends a part; build returns a RichTextPlain/RichTextEntity when there is exactly one part, a RichTextGroup otherwise.

RichTextCashtag

@Serializable

data class RichTextCashtag(val text: RichText, val cashtag: String) : RichTextEntity

A cashtag.

RichTextCode

@Serializable

data class RichTextCode(val text: RichText) : RichTextEntity

A monowidth RichTextEntity.

RichTextCustomEmoji

@Serializable

data class RichTextCustomEmoji(val customEmojiId: CustomEmojiId, val alternativeText: String) : RichTextEntity

A custom emoji RichTextEntity.

RichTextDateTime

@Serializable

data class RichTextDateTime(val text: RichText, val unixTime: TelegramDate, val dateTimeFormat: String) : RichTextEntity

A formatted date and time RichTextEntity.

RichTextDsl

@DslMarker

annotation class RichTextDsl

DslMarker for the rich message builders, so the inner RichTextBuilder, RichBlocksBuilder and RichBlockListBuilder scopes do not leak their receivers into each other.

RichTextEmailAddress

@Serializable

data class RichTextEmailAddress(val text: RichText, val emailAddress: String) : RichTextEntity

A RichTextEntity with an email address.

RichTextEntity

@Serializable(with = RichTextEntitySerializer::class)

sealed interface RichTextEntity : RichText

Any typed (formatted) part of a RichText. Serialized as a JSON object with the type discriminator.

RichTextEntitySerializer

object RichTextEntitySerializer : JsonContentPolymorphicSerializer<RichTextEntity>

RichTextGroup

@Serializable

data class RichTextGroup(val parts: List<RichText>) : RichText

A group of RichTexts. Serialized as a JSON array.

RichTextHashtag

@Serializable

data class RichTextHashtag(val text: RichText, val hashtag: String) : RichTextEntity

A hashtag.

RichTextInfo

@Serializable

data class RichTextInfo(val blocks: List<RichBlock>, val isRtl: Boolean? = null)

Rich formatted message.

RichTextItalic

@Serializable

data class RichTextItalic(val text: RichText) : RichTextEntity

An italicized RichTextEntity.

RichTextMarked

@Serializable

data class RichTextMarked(val text: RichText) : RichTextEntity

A marked RichTextEntity.

RichTextMathematicalExpression

@Serializable

data class RichTextMathematicalExpression(val expression: String) : RichTextEntity

A mathematical expression in LaTeX format.

RichTextMention

@Serializable

data class RichTextMention(val text: RichText, val username: String) : RichTextEntity

A mention by a username.

RichTextPhoneNumber

@Serializable

data class RichTextPhoneNumber(val text: RichText, val phoneNumber: String) : RichTextEntity

A RichTextEntity with a phone number.

RichTextPlain

@Serializable

data class RichTextPlain(val text: String) : RichText

A plain (non-formatted) part of a RichText. Serialized as a bare JSON string.

RichTextReference

@Serializable

data class RichTextReference(val text: RichText, val name: String) : RichTextEntity

A reference.

RichTextReferenceLink

@Serializable

data class RichTextReferenceLink(val text: RichText, val referenceName: String) : RichTextEntity

A link to a reference.

RichTextSerializer

object RichTextSerializer : KSerializer<RichText>

RichTextSpoiler

@Serializable

data class RichTextSpoiler(val text: RichText) : RichTextEntity

A RichTextEntity covered by a spoiler.

RichTextStrikethrough

@Serializable

data class RichTextStrikethrough(val text: RichText) : RichTextEntity

A strikethrough RichTextEntity.

RichTextSubscript

@Serializable

data class RichTextSubscript(val text: RichText) : RichTextEntity

A subscript RichTextEntity.

RichTextSuperscript

@Serializable

data class RichTextSuperscript(val text: RichText) : RichTextEntity

A superscript RichTextEntity.

RichTextTextMention

@Serializable

data class RichTextTextMention(val text: RichText, val user: User) : RichTextEntity

A mention of a Telegram user by their identifier.

RichTextUnderline

@Serializable

data class RichTextUnderline(val text: RichText) : RichTextEntity

An underlined RichTextEntity.

RichTextUrl

@Serializable

data class RichTextUrl(val text: RichText, val url: String) : RichTextEntity

A RichTextEntity with a link.

Properties

html

val RichTextInfo.html: String

Rich HTML style source of all the RichTextInfo.blocks.

markdown

val RichTextInfo.markdown: String

Rich Markdown style source of all the RichTextInfo.blocks.

subBlocks

val InputRichBlock.subBlocks: List<InputRichBlock>

The nested InputRichBlocks directly contained by this block, or an empty list for leaf blocks. Container blocks (InputRichBlockList via its InputRichBlockListItem.blocks, InputRichBlockBlockQuotation, InputRichBlockCollage, InputRichBlockSlideshow and InputRichBlockDetails) expose their children here.

val RichBlock.subBlocks: List<RichBlock>

The nested RichBlocks directly contained by this block, or an empty list for leaf blocks. Container blocks (RichBlockList via its RichBlockListItem.blocks, RichBlockBlockQuotation, RichBlockCollage, RichBlockSlideshow and RichBlockDetails) expose their children here.

Functions

buildInputRichBlocks

fun buildInputRichBlocks(block: InputRichBlocksBuilder.() -> Unit): List<InputRichBlock>

Builds a List of InputRichBlocks using the InputRichBlocksBuilder DSL.

buildRichBlocks

fun buildRichBlocks(block: RichBlocksBuilder.() -> Unit): List<RichBlock>

Builds a List of RichBlocks using the RichBlocksBuilder DSL.

buildRichText

fun buildRichText(block: RichTextBuilder.() -> Unit): RichText

Builds a RichText using the RichTextBuilder DSL.

buildRichTextInfo

fun buildRichTextInfo(isRtl: Boolean? = null, block: RichBlocksBuilder.() -> Unit): RichTextInfo

Builds a RichTextInfo using the RichBlocksBuilder DSL.

escapeRichMarkdown

fun String.escapeRichMarkdown(): String

Escapes all the richMarkdownSpecialCharacters of the receiver with a backslash so that the resulting string is represented literally in the Rich Markdown style.

InputRichMessageBlocks

fun InputRichMessageBlocks(isRtl: Boolean? = null, skipEntityDetection: Boolean? = null, block: InputRichBlocksBuilder.() -> Unit): InputRichMessage

Builds an InputRichMessage with blocks built using the InputRichBlocksBuilder DSL.

fun InputRichMessageBlocks(blocks: List<InputRichBlock>, isRtl: Boolean? = null, skipEntityDetection: Boolean? = null): InputRichMessage

Creates an InputRichMessage with the content described using a list of InputRichBlocks.

InputRichMessageHTML

fun InputRichMessageHTML(html: String, isRtl: Boolean? = null, skipEntityDetection: Boolean? = null, media: List<InputRichMessageMedia>? = null): InputRichMessage

Creates an InputRichMessage with the content described using HTML formatting.

InputRichMessageMarkdown

fun InputRichMessageMarkdown(markdown: String, isRtl: Boolean? = null, skipEntityDetection: Boolean? = null, media: List<InputRichMessageMedia>? = null): InputRichMessage

Creates an InputRichMessage with the content described using Markdown formatting.

fun RichBlock.search(block: RichBlock.() -> Boolean): RichBlock?

Walks this RichBlock and all of its subBlocks recursively (depth-first, this block first) and returns the first block for which block returns true, or null if none matches.

toRichHtml

fun List<RichBlock>.toRichHtml(): String

Builds the Rich HTML style source string for this list of RichBlocks. The resulting string may be passed to InputRichMessageHTML. See toRichMarkdown for the media note.

toRichMarkdown

fun List<RichBlock>.toRichMarkdown(): String

Builds the Rich Markdown style source string for this list of RichBlocks. The resulting string may be passed to InputRichMessageMarkdown.