use crate::prelude::*; use crate::text::{Hyphenate, TextNode}; /// Link to a URL or another location in the document. /// /// The link function makes its positional `body` argument clickable and links /// it to the destination specified by the `dest` argument. By default, links /// are not styled any different from normal text. However, you can easily apply /// a style of your choice with a show rule. /// /// ## Example /// ```example /// #show link: underline /// /// https://example.com \ /// #link("https://example.com") \ /// #link("https://example.com")[ /// See example.com /// ] /// ``` /// /// ## Syntax /// This function also has dedicated syntax: Text that starts with `http://` or /// `https://` is automatically turned into a link. /// /// Display: Link /// Category: meta #[node(Show, Finalize)] pub struct LinkNode { /// The destination the link points to. /// /// - To link to web pages, `dest` should be a valid URL string. If the URL is /// in the `mailto:` or `tel:` scheme and the `body` parameter is omitted, /// the email address or phone number will be the link's body, without the /// scheme. /// /// - To link to another part of the document, `dest` must contain a /// dictionary with a `page` key of type `integer` and `x` and `y` /// coordinates of type `length`. Pages are counted from one, and the /// coordinates are relative to the page's top left corner. /// /// ```example /// #link("mailto:hello@typst.app") \ /// #link((page: 1, x: 0pt, y: 0pt))[ /// Go to top /// ] /// ``` /// #[positional] #[required] #[parse( let dest = args.expect::("destination")?; dest.clone() )] pub dest: Destination, /// How the link is represented. /// /// The content that should become a link. If `dest` is an URL string, the /// parameter can be omitted. In this case, the URL will be shown as the /// link. #[positional] #[required] #[parse(match &dest { Destination::Url(url) => match args.eat()? { Some(body) => body, None => body_from_url(url), }, Destination::Internal(_) => args.expect("body")?, })] pub body: Content, } impl LinkNode { /// Create a link node from a URL with its bare text. pub fn from_url(url: EcoString) -> Self { let body = body_from_url(&url); Self::new(Destination::Url(url), body) } } impl Show for LinkNode { fn show(&self, _: &mut Vt, _: &Content, _: StyleChain) -> SourceResult { Ok(self.body()) } } impl Finalize for LinkNode { fn finalize(&self, realized: Content, _: StyleChain) -> Content { realized .styled(MetaNode::set_data(vec![Meta::Link(self.dest())])) .styled(TextNode::set_hyphenate(Hyphenate(Smart::Custom(false)))) } } fn body_from_url(url: &EcoString) -> Content { let mut text = url.as_str(); for prefix in ["mailto:", "tel:"] { text = text.trim_start_matches(prefix); } let shorter = text.len() < url.len(); TextNode::packed(if shorter { text.into() } else { url.clone() }) }