`. - prefix = '' - - # Property: suffix - # (string) The trailing tag at the end. - suffix = '' - -# ============================================================================= - -class Element: - """An element. - """ - - def __init__(self, token=None, parent=None, count=None, local_count=None, - parser=None, opening_tag=None, closing_tag=None, - attributes=None, name=None, text=None): - """Constructor. - - This is called by ???. - - Description: - All parameters are optional. - - token - (Token) The token (required) - parent - (Element) Parent element; `None` if root - count - (Int) The number to substitute for `&` (e.g., in `li.item-&`) - local_count - (Int) The number to substitute for `$` (e.g., in `li.item-$`) - parser - (Parser) The parser - - attributes - ... - name - ... - text - ... - """ - - self.children = [] - self.attributes = {} - self.parser = parser - - if token is not None: - # Assumption is that token is of type [[Token]] and is - # a [[Token.ELEMENT]]. - self.name = token.name - self.attributes = token.attributes.copy() - self.text = token.text - self.populate = token.populate - self.expand = token.expand - self.opening_tag = token.opening_tag - self.closing_tag = token.closing_tag - - # `count` can be given. This will substitude & in classname and ID - if count is not None: - for key in self.attributes: - attrib = self.attributes[key] - attrib = attrib.replace('&', ("%i" % count)) - if local_count is not None: - attrib = attrib.replace('$', ("%i" % local_count)) - self.attributes[key] = attrib - - # Copy over from parameters - if attributes: self.attributes = attributes - if name: self.name = name - if text: self.text = text - - self._fill_attributes() - - self.parent = parent - if parent is not None: - self.depth = parent.depth + 1 - - if self.populate: self._populate() - - def render(self): - """Renders the element, along with it's subelements, into HTML code. - - [Grouped under "Rendering methods"] - """ - - options = self.parser.options - output = "" - spaces_count = options.indent_spaces - spaces = ' ' * spaces_count - indent = self.depth * spaces - - prefix, suffix = ('', '') - if self.prefix: prefix = self.prefix + "\n" - if self.suffix: suffix = self.suffix - - # Make the guide from the ID (/#header), or the class if there's no - # ID (/.item) - # This is for the start-guide, end-guide and post_tag_guides - guide_string = '' - if 'id' in self.attributes: - guide_string += "#%s" % self.attributes['id'] - elif 'class' in self.attributes: - guide_string += ".%s" % self.attributes['class'].replace(' ', '.') - - # Build the post-tag guide (e.g.,