mirror of
https://github.com/mozilla/gecko-dev.git
synced 2024-10-19 16:25:38 +00:00
d32457d63c
r=bz from https://bugzilla.mozilla.org/show_bug.cgi?id=1329093 Source-Repo: https://github.com/servo/servo Source-Revision: ee223798cc72bf81a4b2bb6849697de617c5f028 --HG-- extra : subtree_source : https%3A//hg.mozilla.org/projects/converted-servo-linear extra : subtree_revision : d016e30baf708b75bb0d335331faec999df1c738
151 lines
5.5 KiB
Rust
151 lines
5.5 KiB
Rust
/* This Source Code Form is subject to the terms of the Mozilla Public
|
|
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
|
|
|
//! The context within which CSS code is parsed.
|
|
|
|
#![deny(missing_docs)]
|
|
|
|
use cssparser::{Parser, SourcePosition, UnicodeRange};
|
|
use error_reporting::ParseErrorReporter;
|
|
#[cfg(feature = "gecko")]
|
|
use gecko_bindings::sugar::refptr::{GeckoArcPrincipal, GeckoArcURI};
|
|
use servo_url::ServoUrl;
|
|
use style_traits::OneOrMoreCommaSeparated;
|
|
use stylesheets::{MemoryHoleReporter, Origin};
|
|
|
|
/// Extra data that the style backend may need to parse stylesheets.
|
|
#[cfg(not(feature = "gecko"))]
|
|
pub struct ParserContextExtraData;
|
|
|
|
/// Extra data that the style backend may need to parse stylesheets.
|
|
#[cfg(feature = "gecko")]
|
|
pub struct ParserContextExtraData {
|
|
/// The base URI.
|
|
pub base: Option<GeckoArcURI>,
|
|
/// The referrer URI.
|
|
pub referrer: Option<GeckoArcURI>,
|
|
/// The principal that loaded this stylesheet.
|
|
pub principal: Option<GeckoArcPrincipal>,
|
|
}
|
|
|
|
#[cfg(not(feature = "gecko"))]
|
|
impl Default for ParserContextExtraData {
|
|
fn default() -> Self {
|
|
ParserContextExtraData
|
|
}
|
|
}
|
|
|
|
#[cfg(feature = "gecko")]
|
|
impl Default for ParserContextExtraData {
|
|
fn default() -> Self {
|
|
ParserContextExtraData { base: None, referrer: None, principal: None }
|
|
}
|
|
}
|
|
|
|
#[cfg(feature = "gecko")]
|
|
impl ParserContextExtraData {
|
|
/// Construct from a GeckoParserExtraData
|
|
///
|
|
/// GeckoParserExtraData must live longer than this call
|
|
pub unsafe fn new(data: *const ::gecko_bindings::structs::GeckoParserExtraData) -> Self {
|
|
// the to_safe calls are safe since we trust that we have references to
|
|
// real Gecko refptrs. The dereferencing of data is safe because this function
|
|
// is expected to be called with a `data` living longer than this function.
|
|
unsafe { ParserContextExtraData {
|
|
base: Some((*data).mBaseURI.to_safe()),
|
|
referrer: Some((*data).mReferrer.to_safe()),
|
|
principal: Some((*data).mPrincipal.to_safe()),
|
|
}}
|
|
}
|
|
}
|
|
/// The data that the parser needs from outside in order to parse a stylesheet.
|
|
pub struct ParserContext<'a> {
|
|
/// The `Origin` of the stylesheet, whether it's a user, author or
|
|
/// user-agent stylesheet.
|
|
pub stylesheet_origin: Origin,
|
|
/// The base url we're parsing this stylesheet as.
|
|
pub base_url: &'a ServoUrl,
|
|
/// An error reporter to report syntax errors.
|
|
pub error_reporter: Box<ParseErrorReporter + Send>,
|
|
/// Implementation-dependent extra data.
|
|
pub extra_data: ParserContextExtraData,
|
|
}
|
|
|
|
impl<'a> ParserContext<'a> {
|
|
/// Create a `ParserContext` with extra data.
|
|
pub fn new_with_extra_data(stylesheet_origin: Origin,
|
|
base_url: &'a ServoUrl,
|
|
error_reporter: Box<ParseErrorReporter + Send>,
|
|
extra_data: ParserContextExtraData)
|
|
-> ParserContext<'a> {
|
|
ParserContext {
|
|
stylesheet_origin: stylesheet_origin,
|
|
base_url: base_url,
|
|
error_reporter: error_reporter,
|
|
extra_data: extra_data,
|
|
}
|
|
}
|
|
|
|
/// Create a parser context with the default extra data.
|
|
pub fn new(stylesheet_origin: Origin,
|
|
base_url: &'a ServoUrl,
|
|
error_reporter: Box<ParseErrorReporter + Send>)
|
|
-> ParserContext<'a> {
|
|
let extra_data = ParserContextExtraData::default();
|
|
Self::new_with_extra_data(stylesheet_origin, base_url, error_reporter, extra_data)
|
|
}
|
|
|
|
/// Create a parser context for on-the-fly parsing in CSSOM
|
|
pub fn new_for_cssom(base_url: &'a ServoUrl) -> ParserContext<'a> {
|
|
Self::new(Origin::User, base_url, Box::new(MemoryHoleReporter))
|
|
}
|
|
}
|
|
|
|
/// Defaults to a no-op.
|
|
/// Set a `RUST_LOG=style::errors` environment variable
|
|
/// to log CSS parse errors to stderr.
|
|
pub fn log_css_error(input: &mut Parser, position: SourcePosition, message: &str, parsercontext: &ParserContext) {
|
|
let servo_url = parsercontext.base_url;
|
|
parsercontext.error_reporter.report_error(input, position, message, servo_url);
|
|
}
|
|
|
|
// XXXManishearth Replace all specified value parse impls with impls of this
|
|
// trait. This will make it easy to write more generic values in the future.
|
|
/// A trait to abstract parsing of a specified value given a `ParserContext` and
|
|
/// CSS input.
|
|
pub trait Parse : Sized {
|
|
/// Parse a value of this type.
|
|
///
|
|
/// Returns an error on failure.
|
|
fn parse(context: &ParserContext, input: &mut Parser) -> Result<Self, ()>;
|
|
}
|
|
|
|
impl<T> Parse for Vec<T> where T: Parse + OneOrMoreCommaSeparated {
|
|
fn parse(context: &ParserContext, input: &mut Parser) -> Result<Self, ()> {
|
|
input.parse_comma_separated(|input| T::parse(context, input))
|
|
}
|
|
}
|
|
|
|
/// Parse a non-empty space-separated or comma-separated list of objects parsed by parse_one
|
|
pub fn parse_space_or_comma_separated<F, T>(input: &mut Parser, mut parse_one: F)
|
|
-> Result<Vec<T>, ()>
|
|
where F: FnMut(&mut Parser) -> Result<T, ()> {
|
|
let first = parse_one(input)?;
|
|
let mut vec = vec![first];
|
|
loop {
|
|
let _ = input.try(|i| i.expect_comma());
|
|
if let Ok(val) = input.try(|i| parse_one(i)) {
|
|
vec.push(val)
|
|
} else {
|
|
break
|
|
}
|
|
}
|
|
Ok(vec)
|
|
}
|
|
impl Parse for UnicodeRange {
|
|
fn parse(_context: &ParserContext, input: &mut Parser) -> Result<Self, ()> {
|
|
UnicodeRange::parse(input)
|
|
}
|
|
}
|