Struct html5ever_ext::QualName

pub struct QualName {
    pub prefix: Option<Atom<PrefixStaticSet>>,
    pub ns: Atom<NamespaceStaticSet>,
    pub local: Atom<LocalNameStaticSet>,
}

A name with a namespace. Fully qualified name. Used to depict names of tags and attributes.

Used to differentiate between similar XML fragments. For example:

// HTML
<table>
  <tr>
    <td>Apples</td>
    <td>Bananas</td>
  </tr>
</table>

// Furniture XML
<table>
  <name>African Coffee Table</name>
  <width>80</width>
  <length>120</length>
</table>

Without XML namespaces, we can't use those two fragments in the same document at the same time. However if we declare a namespace we could instead say:

// Furniture XML
<furn:table>
  <furn:name>African Coffee Table</furn:name>
  <furn:width>80</furn:width>
  <furn:length>120</furn:length>
</furn:table>

and bind it to a different name.

For this reason we parse names that contain a colon in the following way:

<furn:table>
   |    |
   |    +- local name
   |
 prefix (when resolved gives namespace_url)

Fields

prefix: Option<Atom<PrefixStaticSet>>

ns: Atom<NamespaceStaticSet>

local: Atom<LocalNameStaticSet>

Methods

impl QualName

fn new(
    prefix: Option<Atom<PrefixStaticSet>>,
    ns: Atom<NamespaceStaticSet>,
    local: Atom<LocalNameStaticSet>
) -> QualName

fn expanded(&self) -> ExpandedName

Trait Implementations

impl Ord for QualName

fn cmp(&self, __arg_0: &QualName) -> Ordering

impl Hash for QualName

fn hash<__H>(&self, __arg_0: &mut __H) where
    __H: Hasher, 

impl Clone for QualName

fn clone(&self) -> QualName

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Eq for QualName

impl PartialEq<QualName> for QualName

fn eq(&self, __arg_0: &QualName) -> bool

fn ne(&self, __arg_0: &QualName) -> bool

impl Debug for QualName

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

Formats the value using the given formatter.

impl PartialOrd<QualName> for QualName

fn partial_cmp(&self, __arg_0: &QualName) -> Option<Ordering>

fn lt(&self, __arg_0: &QualName) -> bool

fn le(&self, __arg_0: &QualName) -> bool

fn gt(&self, __arg_0: &QualName) -> bool

fn ge(&self, __arg_0: &QualName) -> bool

impl QualNameExt for QualName

fn is_unprefixed_and_html_namespace_or_none(&self) -> bool

Is this name effectively local?

fn is_only_local(&self, local_name: &LocalName) -> bool

Is this qualified name this local-only name (no prefix, no namespace)

fn is_only_local_of(&self, local_names: &[LocalName]) -> bool

Is this qualified name on these local-only names (no prefix, no namespace)

fn can_have_children(&self) -> bool

Can this element have children?

fn text_content_should_be_escaped(&self) -> bool

Should an immediate child text node have <, > and & characters escaped? In modern HTML 5, the only common nodes which don't need this are <script> and <style>. In this case, the immediate child text node's content should not contain, say, </script> as this will cause a parse error.

fn can_collapse_whitespace(&self) -> bool

Can this element's descendant text nodes have leading, trailing and interstitial whitespace collapsed?