Struct style::servo::url::SpecifiedUrl

pub struct SpecifiedUrl { /* fields omitted */ }

A specified 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

Methods

impl SpecifiedUrl

pub fn parse_from_string<'a>(
    url: String,
    context: &ParserContext
) -> Result<Self, ParseError<'a>>

Try to parse a URL from a string value that is a valid CSS token for a URL. Never fails - the API is only fallible to be compatible with the gecko version.

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<&ServoUrl>

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: ServoUrl) -> 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.

Trait Implementations

impl Clone for SpecifiedUrl

fn clone(&self) -> SpecifiedUrl

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for SpecifiedUrl

fn fmt(&self, __arg_0: &mut Formatter) -> Result

Formats the value using the given formatter.

impl MallocSizeOf for SpecifiedUrl

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 PartialEq for SpecifiedUrl

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl ToCss for SpecifiedUrl

fn to_css<W>(&self, dest: &mut 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 ToComputedValue for SpecifiedUrl

type ComputedValue = ComputedUrl

The computed value type we're going to be converted to.

fn to_computed_value(&self, _: &Context) -> Self::ComputedValue

Convert a specified value to a computed value, using itself and the data inside the Context.

fn from_computed_value(computed: &ComputedUrl) -> Self

Convert a computed value to specified value form.

impl AnimatedValueAsComputed for SpecifiedUrl

impl Parse for SpecifiedUrl

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

Parse a value of this type.

impl Eq for SpecifiedUrl