//! Label start (image) is a construct that occurs in the [text][] content //! type. //! //! It forms with the following BNF: //! //! ```bnf //! label_start_image ::= '!' '[' //! ``` //! //! Label start (image) does not, on its own, relate to anything in HTML. //! When matched with a [label end][label_end], they together relate to the //! `` element in HTML. //! See [*§ 4.8.3 The `img` element*][html-img] in the HTML spec for more info. //! Without an end, the characters (`![`) are output. //! //! ## Tokens //! //! * [`LabelImage`][Token::LabelImage] //! * [`LabelImageMarker`][Token::LabelImageMarker] //! * [`LabelMarker`][Token::LabelMarker] //! //! ## References //! //! * [`label-start-image.js` in `micromark`](https://github.com/micromark/micromark/blob/main/packages/micromark-core-commonmark/dev/lib/label-start-image.js) //! * [*§ 6.4 Images* in `CommonMark`](https://spec.commonmark.org/0.30/#images) //! //! [text]: crate::content::text //! [label_end]: crate::construct::label_end //! [html-img]: https://html.spec.whatwg.org/multipage/embedded-content.html#the-img-element use super::label_end::resolve_media; use crate::token::Token; use crate::tokenizer::{Code, LabelStart, State, StateFnResult, Tokenizer}; /// Start of label (image) start. /// /// ```markdown /// a |![ b /// ``` pub fn start(tokenizer: &mut Tokenizer, code: Code) -> StateFnResult { match code { Code::Char('!') => { tokenizer.enter(Token::LabelImage); tokenizer.enter(Token::LabelImageMarker); tokenizer.consume(code); tokenizer.exit(Token::LabelImageMarker); (State::Fn(Box::new(open)), None) } _ => (State::Nok, None), } } /// After `!`, before a `[`. /// /// ```markdown /// a !|[ b /// ``` pub fn open(tokenizer: &mut Tokenizer, code: Code) -> StateFnResult { match code { Code::Char('[') => { tokenizer.enter(Token::LabelMarker); tokenizer.consume(code); tokenizer.exit(Token::LabelMarker); tokenizer.exit(Token::LabelImage); let end = tokenizer.events.len() - 1; tokenizer.label_start_stack.push(LabelStart { start: (end - 5, end), balanced: false, inactive: false, }); tokenizer.register_resolver_before("media".to_string(), Box::new(resolve_media)); (State::Ok, None) } _ => (State::Nok, None), } }