css_ast/rules/
charset.rs

1use super::prelude::*;
2
3// https://drafts.csswg.org/css-syntax-3/#charset-rule
4#[derive(ToSpan, ToCursors, SemanticEq, Debug, Default, Copy, Clone, PartialEq, Eq, PartialOrd, Ord, Hash)]
5#[cfg_attr(feature = "serde", derive(serde::Serialize), serde())]
6#[cfg_attr(feature = "visitable", derive(csskit_derives::Visitable), visit(self))]
7#[cfg_attr(feature = "css_feature_data", derive(::csskit_derives::ToCSSFeature), css_feature("css.at-rules.charset"))]
8#[derive(csskit_derives::NodeWithMetadata)]
9#[metadata(node_kinds = AtRule, used_at_rules = Charset)]
10pub struct CharsetRule {
11	at_keyword: T![AtKeyword],
12	space: T![' '],
13	string: T![String],
14	semicolon: Option<T![;]>,
15}
16
17// CharsetRule is a special rule which means it cannot use standard AtRule parsing... comments below
18// https://drafts.csswg.org/css-syntax-3/#determine-the-fallback-encoding
19impl<'a> Parse<'a> for CharsetRule {
20	fn parse<I>(p: &mut Parser<'a, I>) -> ParserResult<Self>
21	where
22		I: Iterator<Item = Cursor> + Clone,
23	{
24		let at_keyword = p.parse::<T![AtKeyword]>()?;
25		let c: Cursor = at_keyword.into();
26		// CharsetRule MUST be all lowercase, alt cases such as CHARSET or charSet aren't
27		// valid here, compares to other at-rules which are case insensitive.
28		if !p.equals_atom(c, &CssAtomSet::Charset) {
29			Err(Diagnostic::new(c, Diagnostic::unexpected))?;
30		}
31		// Charsets MUST have a space between the at keyword and the string. This
32		// isn't necessary in other at rules where an at keyword can align with other
33		// delims (e.g. `(`) or unambinguous tokens like strings.
34		let space = p.parse::<T![' ']>()?;
35		let string = p.parse::<T![String]>()?;
36		// TODO: check quote style as it should be "
37		let semicolon = p.parse::<T![;]>().ok();
38		Ok(Self { at_keyword, space, string, semicolon })
39	}
40}
41
42#[cfg(test)]
43mod tests {
44	use super::*;
45	use crate::CssAtomSet;
46	use css_parse::assert_parse;
47
48	#[test]
49	fn size_test() {
50		assert_eq!(std::mem::size_of::<CharsetRule>(), 52);
51	}
52
53	#[test]
54	fn test_writes() {
55		assert_parse!(CssAtomSet::ATOMS, CharsetRule, "@charset \"utf-8\";");
56		assert_parse!(CssAtomSet::ATOMS, CharsetRule, "@charset \"UTF-8\";");
57	}
58}
css_ast/rules/charset.rs

css_ast/rules/
charset.rs
