class Nokogiri::XML::Attr

Attr represents a Attr node in an xml document.

Public Class Methods

new(document, name) click to toggle source

Create a new Attr element on the document with name

static VALUE
new (int argc, VALUE *argv, VALUE klass)
  xmlDocPtr xml_doc;
  VALUE document;
  VALUE name;
  VALUE rest;
  xmlAttrPtr node;
  VALUE rb_node;

  rb_scan_args(argc, argv, "2*", &document, &name, &rest);

  if (! rb_obj_is_kind_of(document, cNokogiriXmlDocument)) {
    rb_raise(rb_eArgError, "parameter must be a Nokogiri::XML::Document");

  Noko_Node_Get_Struct(document, xmlDoc, xml_doc);

  node = xmlNewDocProp(
           (const xmlChar *)StringValueCStr(name),


  rb_node = noko_xml_node_wrap(klass, (xmlNodePtr)node);
  rb_obj_call_init(rb_node, argc, argv);

  if (rb_block_given_p()) {

  return rb_node;

Public Instance Methods

Alias for: value=
value=(content) click to toggle source

Set the value for this Attr to content. Use ‘nil` to remove the value (e.g., a HTML boolean attribute).

static VALUE
set_value(VALUE self, VALUE content)
  xmlAttrPtr attr;
  xmlChar *value;
  xmlNode *cur;

  Noko_Node_Get_Struct(self, xmlAttr, attr);

  if (attr->children) {
  attr->children = attr->last = NULL;

  if (content == Qnil) {
    return content;

  value = xmlEncodeEntitiesReentrant(attr->doc, (unsigned char *)StringValueCStr(content));
  if (xmlStrlen(value) == 0) {
    attr->children = xmlNewDocText(attr->doc, value);
  } else {
    attr->children = xmlStringGetNodeList(attr->doc, value);

  for (cur = attr->children; cur; cur = cur->next) {
    cur->parent = (xmlNode *)attr;
    cur->doc = attr->doc;
    if (cur->next == NULL) {
      attr->last = cur;

  return content;
Also aliased as: content=