Struct style::servo::url::CssUrl

pub struct CssUrl {
    original: Option<Arc<String>>,
    resolved: Option<Arc<Url>>,
}

A CSS url() value for servo.

Servo eagerly resolves SpecifiedUrls, which it can then take advantage of when computing values. In contrast, Gecko uses a different URL backend, so eagerly resolving with rust-url would be duplicated work.

However, this approach is still not necessarily optimal: See https://bugzilla.mozilla.org/show_bug.cgi?id=1347435#c6

TODO(emilio): This should be shrunk by making CssUrl a wrapper type of an arc, and keep the serialization in that Arc. See gecko/url.rs for example.

Fields

original: Option<Arc<String>>

The original URI. This might be optional since we may insert computed values of images into the cascade directly, and we don’t bother to convert their serialization.

Refcounted since cloning this should be cheap and data: uris can be really large.

resolved: Option<Arc<Url>>

The resolved value for the url, if valid.

Implementations

impl CssUrl

pub fn parse_from_string( url: String, context: &ParserContext<'_>, _: CorsMode, ) -> Self

Try to parse a URL from a string value that is a valid CSS token for a URL.

FIXME(emilio): Should honor CorsMode.

pub fn is_invalid(&self) -> bool

Returns true if the URL is definitely invalid. For Servo URLs, we can use its |resolved| status.

pub fn is_fragment(&self) -> bool

Returns true if this URL looks like a fragment. See https://drafts.csswg.org/css-values/#local-urls

Since Servo currently stores resolved URLs, this is hard to implement. We either need to change servo to lazily resolve (like Gecko), or note this information in the tokenizer.

pub fn url(&self) -> Option<&Arc<Url>>

Returns the resolved url if it was valid.

pub fn as_str(&self) -> &str

Return the resolved url as string, or the empty string if it’s invalid.

TODO(emilio): Should we return the original one if needed?

pub fn for_cascade(url: Arc<Url>) -> Self

Creates an already specified url value from an already resolved URL for insertion in the cascade.

pub fn new_for_testing(url: &str) -> Self

Gets a new url from a string for unit tests.

pub fn parse_with_cors_mode<'i, 't>( context: &ParserContext<'_>, input: &mut Parser<'i, 't>, cors_mode: CorsMode, ) -> Result<Self, ParseError<'i>>

Parses a URL request and records that the corresponding request needs to be CORS-enabled.

This is only for shape images and masks in Gecko, thus unimplemented for now so somebody notices when trying to do so.

Trait Implementations

impl Clone for CssUrl

fn clone(&self) -> CssUrl

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for CssUrl

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CssUrl

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl MallocSizeOf for CssUrl

fn size_of(&self, ops: &mut MallocSizeOfOps) -> usize

Measure the heap usage of all descendant heap-allocated structures, but not the space taken up by the value itself.

impl Parse for CssUrl

fn parse<'i, 't>( context: &ParserContext<'_>, input: &mut Parser<'i, 't>, ) -> Result<Self, ParseError<'i>>

Parse a value of this type.

impl PartialEq for CssUrl

fn eq(&self, other: &Self) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for CssUrl

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl SpecifiedValueInfo for CssUrl

const SUPPORTED_TYPES: u8 = 0u8

Supported CssTypes by the given value type.

fn collect_completion_keywords(_f: &mut dyn FnMut(&[&'static str]))

Collect value starting words for the given specified value type. This includes keyword and function names which can appear at the beginning of a value of this type.

impl ToCss for CssUrl

fn to_css<W>(&self, dest: &mut CssWriter<'_, W>) -> Result

where W: Write,

Serialize self in CSS syntax, writing to dest.

fn to_css_string(&self) -> String

Serialize self in CSS syntax and return a string.

impl ToShmem for CssUrl

fn to_shmem(&self, _builder: &mut SharedMemoryBuilder) -> Result<Self>

Clones this value into a form suitable for writing into a SharedMemoryBuilder.

impl Eq for CssUrl