Struct style::servo::url::CssUrl

source ·
pub struct CssUrl {
    original: Option<Arc<String>>,
    resolved: Option<Arc<Url>>,
}
Expand description

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§

source§

impl CssUrl

source

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.

source

pub fn is_invalid(&self) -> bool

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

source

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.

source

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

Returns the resolved url if it was valid.

source

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?

source

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

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

source

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

Gets a new url from a string for unit tests.

source

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§

source§

impl Clone for CssUrl

source§

fn clone(&self) -> CssUrl

Returns a copy of the value. Read more
1.0.0 · source§

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

Performs copy-assignment from source. Read more
source§

impl Debug for CssUrl

source§

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

Formats the value using the given formatter. Read more
source§

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

source§

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>
where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer. Read more
source§

impl MallocSizeOf for CssUrl

source§

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.
source§

impl Parse for CssUrl

source§

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

Parse a value of this type. Read more
source§

impl PartialEq for CssUrl

source§

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

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

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
source§

impl Serialize for CssUrl

source§

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

Serialize this value into the given Serde serializer. Read more
source§

impl SpecifiedValueInfo for CssUrl

source§

const SUPPORTED_TYPES: u8 = 0u8

Supported CssTypes by the given value type. Read more
source§

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. Read more
source§

impl ToCss for CssUrl

source§

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

Serialize self in CSS syntax, writing to dest.
source§

fn to_css_string(&self) -> String

Serialize self in CSS syntax and return a string. Read more
source§

impl ToShmem for CssUrl

source§

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

Clones this value into a form suitable for writing into a SharedMemoryBuilder. Read more
source§

impl Eq for CssUrl

Auto Trait Implementations§

§

impl Freeze for CssUrl

§

impl RefUnwindSafe for CssUrl

§

impl Send for CssUrl

§

impl Sync for CssUrl

§

impl Unpin for CssUrl

§

impl UnwindSafe for CssUrl

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

source§

fn equivalent(&self, key: &K) -> bool

Checks if this value is equivalent to the given key. Read more
source§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

source§

fn equivalent(&self, key: &K) -> bool

Compare self to key and return true if they are equal.
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T> IntoEither for T

source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
source§

impl<T> MaybeBoxed<Box<T>> for T

source§

fn maybe_boxed(self) -> Box<T>

Convert
source§

impl<T> MaybeBoxed<T> for T

source§

fn maybe_boxed(self) -> T

Convert
source§

impl<T> Pointable for T

source§

const ALIGN: usize = _

The alignment of pointer.
§

type Init = T

The type for initializers.
source§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
source§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
source§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
source§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
source§

impl<T> Same for T

§

type Output = T

Should always be Self
source§

impl<T> ToOwned for T
where T: Clone,

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
source§

impl<T> DeserializeOwned for T
where T: for<'de> Deserialize<'de>,

source§

impl<T> ErasedDestructor for T
where T: 'static,

source§

impl<T> MaybeSendSync for T