mirror of
https://github.com/typst/typst
synced 2025-05-14 17:15:28 +08:00
68 lines
1.7 KiB
Rust
68 lines
1.7 KiB
Rust
use crate::prelude::*;
|
|
|
|
/// Align content horizontally and vertically.
|
|
///
|
|
/// ## Example
|
|
/// ```example
|
|
/// #set align(center)
|
|
///
|
|
/// Centered text, a sight to see \
|
|
/// In perfect balance, visually \
|
|
/// Not left nor right, it stands alone \
|
|
/// A work of art, a visual throne
|
|
/// ```
|
|
///
|
|
/// Display: Align
|
|
/// Category: layout
|
|
#[element(Show)]
|
|
pub struct AlignElem {
|
|
/// The alignment along both axes.
|
|
///
|
|
/// Possible values for horizontal alignments are:
|
|
/// - `start`
|
|
/// - `end`
|
|
/// - `left`
|
|
/// - `center`
|
|
/// - `right`
|
|
///
|
|
/// The `start` and `end` alignments are relative to the current [text
|
|
/// direction]($func/text.dir).
|
|
///
|
|
/// Possible values for vertical alignments are:
|
|
/// - `top`
|
|
/// - `horizon`
|
|
/// - `bottom`
|
|
///
|
|
/// To align along both axes at the same time, add the two alignments using
|
|
/// the `+` operator to get a `2d alignment`. For example, `top + right`
|
|
/// aligns the content to the top right corner.
|
|
///
|
|
/// ```example
|
|
/// #set page(height: 6cm)
|
|
/// #set text(lang: "ar")
|
|
///
|
|
/// مثال
|
|
/// #align(
|
|
/// end + horizon,
|
|
/// rect(inset: 12pt)[ركن]
|
|
/// )
|
|
/// ```
|
|
#[positional]
|
|
#[fold]
|
|
#[default(Axes::new(GenAlign::Start, GenAlign::Specific(Align::Top)))]
|
|
pub alignment: Axes<Option<GenAlign>>,
|
|
|
|
/// The content to align.
|
|
#[required]
|
|
pub body: Content,
|
|
}
|
|
|
|
impl Show for AlignElem {
|
|
#[tracing::instrument(name = "AlignElem::show", skip_all)]
|
|
fn show(&self, _: &mut Vt, styles: StyleChain) -> SourceResult<Content> {
|
|
Ok(self
|
|
.body()
|
|
.styled(Self::set_alignment(self.alignment(styles).map(Some))))
|
|
}
|
|
}
|