uslm:uscNote
A <uscNote> is a note below sections and big-level headings in the U.S. Code.
Element information
Namespace: http://schemas.gpo.gov/xml/uslm
Schema document: uslm-components-2.1.0.xsd
Type: uslm:NoteType
Properties: Global, Qualified
Content
- Any text (mixed) content, intermingled with:
- Choice [0..*]
- Any element [0..*] Namespace: ##targetNamespace, Process Contents: strict
- xhtml:img
- xhtml:table The HTML table element.
- mathml:math
from type uslm:ContentType
Attributes
Name | Occ | Type | Description | Notes |
---|---|---|---|---|
xml:base | [0..1] | xsd:anyURI | denotes an attribute whose value provides a URI to be used as the base for interpreting any relative URIs in the scope of the element on which it appears; its value is inherited. This name is reserved by virtue of its definition in the XML Base specification. | from group uslm:XmlSpecialAttrs |
xml:lang | [0..1] | Anonymous | denotes an attribute whose value is a language code for the natural language of the content of any element; its value is inherited. | from group uslm:XmlSpecialAttrs |
xml:space | [0..1] | Anonymous | denotes an attribute whose value is a keyword indicating what whitespace processing discipline is intended for the content of the element; its value is inherited. | from group uslm:XmlSpecialAttrs |
id | [0..1] | xsd:ID | The @id attribute should always be assigned an immutable (non-changing) value. If the item is subject to renaming or renumbering, then the @id attribute should not reflect any part of the changeable part. This is to allow the @id to be long lasting without causing confusion should the item be renamed or renumbered. The @id should be prefixed with "id" and followed by a GUID that is guaranteed to be globally unique across both time and space. As an "xsd:ID", the identity must be ensured to be unique in the document - and it is a good idea that it be guaranteed globally unique. As the @id is immutable, it is a good identity with which to associate external information to the item. If an item is deleted and later a similarly named item is created, then the new item should be assigned a newly generated identity as it is not the same item as the earlier item. The @id attribute is optional, but recommended for all elements which will contain any other identity attributes. | from group uslm:IdentificationGroup |
temporalId | [0..1] | uslm:MediumStringSimpleType | The @temporalId attribute is a name, scoped to the document, that is intended to reflect the current identify of the element in a human-readable way. This means that the @temporalId may need to be recomputed based on the temporal state of a document or according to the temporal specification in a requesting URL. A @temporalId is intended to be scoped to the document as a whole while the @name is scoped to its immediate parent. The @temporalId is built as an "_" separated hierarchy of @name or, in the absence of an @name, element names. However, in a couple cases, the levels of the hierarchy are suppressed. First of all, the <main> level is suppressed when calculating any @temporalId contained within. Secondly, when dealing with sections which are numbered as a sequence without regard to the upper levels, then the upper levels are suppressed from the computation of the @temporalId. Some examples: * "s2" - section 2 in the main part of the document * "schedule_s2" - section 2 in the schedule * "pt2_d1" - division 1 of part 2 in the main part of the document The @temporalId attribute is optional. | from group uslm:IdentificationGroup |
identifier | [0..1] | uslm:LongStringSimpleType | Use the @identifier attribute to specify the URL context of the element. Typically, the @identifier will be established on the root element or on any element, such as a <quotedContent> element, that changes the context. The @identifier attribute is optional. | from group uslm:IdentificationGroup |
scope | [0..1] | uslm:LongStringSimpleType | Use the @scope attribute to specify the scope within which the @identifier attribute is valid. Typically, @scope is formatted as a URL, referring to a specific context. @scope is used for terms within in definitions to specify the scope of the definition. The @scope attribute is optional. | from group uslm:IdentificationGroup |
role | [0..1] | uslm:ShortStringSimpleType | Use the @role attribute to provide further refinement to an element's type. This is particularly useful when defining a refinement of an element from the abstract set. Another possible use is to use the customary local name for an element whenever the element name is not a complete match. For example, if the customary name for an "explanation" is "summary", then the element can be expressed as <explanation role="summary">. There is a rough equivalence between an element of a base class with a @role attribute and a derived class in the schema, although this equivalence is not explicit. For example <level role="division"> is roughly equal to <division>. When transforming XML to HTML, the @role attribute should be appended to the element name using an "_" underscore and used as the first value in the HTML @class attribute. If desired, the proposed XHTML @role attribute can be computed as either the XML @role attribute or, in the absence of the XML @role attribute, the XML element name. For example: <level role="division"> => <div role="division" class="level_division"> <division> => <div role="division" class="division"> This approach is easily reversible. In a similar way to the @class attribute, multiple role values can be specified in a space separated list. | from group uslm:ClassificationGroup |
class | [0..1] | uslm:MediumStringSimpleType | The @class attribute corresponds to the @class attribute in HTML. It can be used to specify presentation characteristics of an element that are not specified by the element name and the @role attribute. For example, the @class attribute can be used to specify the presence or absence of the ending separator. Like the HTML @class attribute, multiple class values can be specified in a space separated list. | from group uslm:ClassificationGroup |
style | [0..1] | uslm:LongStringSimpleType | The @style attribute is used to specify CSS attributes that override the default styles defined for an element or an element class. The current loose-leaf publication standards should be specified using an external style sheet and the use of the @style attribute should be reserved for exception cases where the default presentation must be overridden. | from group uslm:ClassificationGroup |
styleType | [0..1] | uslm:StyleTypeEnum | The @styleType attribute is used to set the overall semantic type of the block. This has rendering implications. Only a small set of values is allowed. | Default value is "OLC". from group uslm:ClassificationGroup |
note | [0..1] | uslm:LongStringSimpleType | The @note attribute should be the primary mechanism for recording simple text notes to be associated with elements. | from group uslm:AnnotationGroup |
alt | [0..1] | uslm:LongStringSimpleType | The @alt attribute should be used to provide an alternative description of the element. For use with WCAG 2.0 and other accessibility initiatives. | from group uslm:AnnotationGroup |
meta | [0..1] | uslm:LongStringSimpleType | The @meta attribute should be used to associate metadata information with the element for search and other uses. How this attribute is used is not prescribed by the schema. | from group uslm:AnnotationGroup |
misc | [0..1] | uslm:LongStringSimpleType | The @misc attribute is provided for future use. | from group uslm:AnnotationGroup |
draftingTip | [0..1] | uslm:LongStringSimpleType | The @draftingTip is for internal use. | from group uslm:AnnotationGroup |
codificationTip | [0..1] | uslm:LongStringSimpleType | The @codificationTip is for internal use by the OLRC. | from group uslm:AnnotationGroup |
title | [0..1] | uslm:MediumStringSimpleType | The @title attribute is used to specify the text describing the element in a table of contents or index. It must be a simple text string and should consist of fewer than 40 or so characters - although this is not enforced. | from group uslm:DescriptionGroup |
brief | [0..1] | uslm:LongStringSimpleType | The @brief attribute is an alternate method for providing a longer description of an element, limited to 1024 characters. | from group uslm:DescriptionGroup |
sortOrder | [0..1] | xsd:integer | The @sortOrder attribute is used to specify a sorting order for a list of items, when that sort order is not the document sequence. The @sortOrder value must be specified as a positive integer. This attribute should rarely be used. | from group uslm:DescriptionGroup |
startPeriod | [0..1] | uslm:DateSimpleType | The @startPeriod attribute is the earliest date that a particular version applies to. The @startPeriod is not necessarily the effective date. It's merely the earliest date that the particular version of the text should be returned in point-in-time calculations. The @startPeriod works with the @endPeriod which defines that last date that a specific version applies to. Together, the @startPeriod and the @endPeriod define a period of time that the version applies to. This version may be in states such as pending, operational, partially commenced, suspended, or even repealed. If the @startPeriod is not specified, then all past time is assumed. | from group uslm:VersioningGroup |
endPeriod | [0..1] | uslm:DateSimpleType | The @endPeriod attribute is the last date that a specific version of the text should be returned in point-in-time calculations. If the @endPeriod is not specified, then all future time is assumed. | from group uslm:VersioningGroup |
status | [0..1] | uslm:StatusEnum | The @status attribute is used to show the status of a version of provision. This attribute works with the @startPeriod and the @endPeriod and applies to the period of time defined by these attributes. | from group uslm:VersioningGroup |
partial | [0..1] | xsd:boolean | The @partial attribute is used, in conjunction with the @status attribute to indicate that the status is not fully applied. | from group uslm:VersioningGroup |
inEffect | [0..1] | xsd:boolean | The @inEffect attribute is used to indicate whether the level or provision is currently in effect. The default value is 'true'. Note that the @status attribute also contains information about the state of a provision. If the value of the @status attribute is anything other than 'inEffect' the value of the @inEffect attribute should be 'false'. The net effect of contradictory values of these two attributes is not defined. | from group uslm:VersioningGroup |
Any attribute | [0..*] | Namespace: ##other, Process Contents: lax | from type uslm:BaseContentType | |
orientation | [0..1] | uslm:OrientationEnum | The @orientation attribute is used to specify a "landscape" orientation for the published form. This is primarily used for schedules or for tables. | Default value is "portrait". from type uslm:ContentType |
type | [0..1] | uslm:NoteTypeEnum | Set the @type attribute to "footnote" to indicate that the notes contained should be shown in the footnotes at the end of the page, to "endnote" to indicate the notes contained should be shown at the end of the document, or to "sidenote" if the notes should be shown on the side in the margin. If not specified, "footnote" is assumed. | Default value is "footnote". from group uslm:NoteGroup |
topic | [0..1] | uslm:MediumStringSimpleType | Set the @topic attribute to a string value in order to categorize the note or group of notes. An open, but enumerated, list of string values should be used. Using a fixed list of values will better aid in categorization of notes. | from group uslm:NoteGroup |
date | [0..1] | uslm:DateSimpleType | The @date attribute is used for a single date value. | from group uslm:DateGroup |
legisDate | [0..1] | uslm:DateSimpleType | The @legisDate attribute is used for a logical legislative date, which may be different from the calendar date. | from group uslm:DateGroup |
startDate | [0..1] | uslm:DateSimpleType | The @startDate attribute is used for the starting date of a date range. | from group uslm:DateGroup |
endDate | [0..1] | uslm:DateSimpleType | The @endDate attribute is used for the ending date of a date range. | from group uslm:DateGroup |
href | [0..1] | xsd:anyURI | The @href attribute is used to specify references to external documents or items in documents. The value must always be specified as a relative URL conforming to the reference specification. | from group uslm:ReferenceGroup |
idref | [0..1] | xsd:IDREF | The @idref attribute is used to specify references to internal elements within the same document. The @idref is specified as the value of the @id attribute of the element being referenced. As in HTML, there is an equivalence between an @href specified as href="#{id}" and idref="{id}". However, the @idref attribute is preferred for internal references. If the @idref points to a <ref> element, then the referencing element builds on top of that reference, acquiring its attributes as default values (which may be overridden by local values). This is a recursive structure; an element may, through the @idref attribute, point to an <ref> element which itself builds on another <ref> element, and so on. This is to support the complex referencing sometimes found in legislation. | from group uslm:ReferenceGroup |
portion | [0..1] | uslm:MediumStringSimpleType | The @portion attribute is used, in conjunction with the @idref attribute, when only a portion of the referenced item is being affected. The value of @portion is an additional part to append to the URL, with a "/" separator to identify the item affected. Do not include a leading "/" in the @portion value. | from group uslm:ReferenceGroup |
display | [0..1] | uslm:YesOrNoEnum | The @display attribute specifies whether the element is rendered, either on screen or in print. The values are @display="yes" to render the element; this is the default. @display="no" is used when the information is to be retained in the document but not rendered. There are no exceptions; if display="yes" then the item will be rendered, regardless of stage, status, or other rules. | Default value is "yes". from group uslm:DisplayGroup |
Used in
- Anonymous type of element uslm:recital
- Group uslm:NoteStructure
- Group xhtml:uslm.Inline.mix
- Type uslm:AmendPrefaceType (Element uslm:amendPreface)
- Type uslm:PrefaceType (Element uslm:preface)
- Type uslm:CoverTextType (Element uslm:coverText)
- Type uslm:InlinePropertyType (Elements uslm:inlinePropertyElement, uslm:organization)
- Type uslm:StarPrintType (Elements uslm:starPrint, uslm:starPrint)
- Type uslm:FirstPageHeadingType (Elements uslm:firstPageHeading, uslm:firstPageSubheading)
- Type uslm:NotesType (Elements uslm:notes, uslm:legislativeHistory)
- Type uslm:SponsorType (Elements uslm:sponsor, uslm:cosponsor, uslm:nonsponsor)
- Type uslm:HeadingType (Elements uslm:heading, uslm:subheading, uslm:crossHeading, uslm:listHeading)
- Type uslm:StatementType (Elements uslm:statement, uslm:resolvingClause, uslm:enactingFormula, uslm:wordsOfIssuance, uslm:docTitle, uslm:officialTitle)
- Type uslm:InlineType (Elements uslm:inline, uslm:figCaption, uslm:center, uslm:fillIn, uslm:checkBox, uslm:b, uslm:i ...more)
- Type uslm:ToCIndexType (Elements uslm:toc, uslm:index, uslm:tableOfTitlesAndChapters, uslm:listOfAgencies, uslm:listOfSectionsAffected, uslm:listOfBillsEnacted, uslm:listOfPublicLaws ...more)
- Type uslm:PropertyType (Elements uslm:property, uslm:coverTitle, uslm:actionInstruction, uslm:approvedDate, uslm:congress, uslm:createdDate, uslm:currentChamber ...more)
- Type uslm:CollectionType (Elements uslm:collection, uslm:notices, uslm:rules, uslm:proposedRules, uslm:presidentialDocs, uslm:agencyGroup, uslm:publicLaws ...more)
- Anonymous type of element uslm:designator via extension of uslm:InlineType
- Anonymous type of element uslm:label via extension of uslm:InlineType
- Anonymous type of element uslm:target via extension of uslm:InlineType
- Anonymous type of element uslm:committee via extension of uslm:InlinePropertyType
- Anonymous type of element uslm:longTitle via extension of uslm:StatementType
- Group uslm:NumStructure via reference to uslm:NoteStructure
- Group uslm:HeadingStructure via reference to uslm:NoteStructure
- Group uslm:TocStructure via reference to uslm:NoteStructure
- Group uslm:StatementStructure via reference to uslm:NoteStructure
- Group uslm:RecitalStructure via reference to uslm:NoteStructure
- Group uslm:PreambleStructure via reference to uslm:NoteStructure
- Group uslm:LevelStructure via reference to uslm:NoteStructure
- Group xhtml:xhtml.Flow.mix via reference to xhtml:uslm.Inline.mix
- Group xhtml:xhtml.td.content via reference to xhtml:uslm.Inline.mix
- Group xhtml:xhtml.th.content via reference to xhtml:uslm.Inline.mix
- Group xhtml:xhtml.caption.content via reference to xhtml:uslm.Inline.mix
- Type uslm:AmendingActionType via extension of uslm:InlineType (Element uslm:amendingAction)
- Type uslm:RefType via extension of uslm:InlineType (Element uslm:ref)
- Type uslm:DateType via extension of uslm:InlineType (Element uslm:date)
- Type uslm:NumType via extension of uslm:InlineType (Elements uslm:num, uslm:referenceMarker)
- Type uslm:QuotedTextType via extension of uslm:InlineType (Elements uslm:quotedText, uslm:addedText, uslm:deletedText, uslm:del, uslm:ins)
- Type uslm:MainType via reference to uslm:NoteStructure (Element uslm:main)
- Type uslm:PreambleType via reference to uslm:NoteStructure (Element uslm:preamble)
- Type uslm:RulePreambleType via reference to uslm:NoteStructure (Element uslm:rulePreamble)
- Type uslm:AppropriationsType via reference to uslm:NoteStructure (Element uslm:appropriations)
- Type uslm:AmendmentInstructionType via reference to uslm:NoteStructure (Element uslm:amendmentInstruction)
- Type uslm:ProvisoType via reference to uslm:NoteStructure (Element uslm:proviso)
- Type uslm:BackMatterType via reference to uslm:NoteStructure (Element uslm:backMatter)
- Type uslm:LayoutType via reference to uslm:NoteStructure (Element uslm:layout)
- Type uslm:ColumnType via reference to uslm:NoteStructure (Element uslm:column)
- Type uslm:PType via reference to uslm:NoteStructure (Element uslm:p)
- Type xhtml:xhtml.td.type via reference to xhtml:uslm.Inline.mix (Element xhtml:td)
- Type xhtml:xhtml.th.type via reference to xhtml:uslm.Inline.mix (Element xhtml:th)
- Type xhtml:xhtml.caption.type via reference to xhtml:uslm.Inline.mix (Element xhtml:caption)
- Type uslm:AppendixType via reference to uslm:NoteStructure (Elements uslm:appendix, uslm:schedule)
- Type uslm:PositionedNoteType via reference to uslm:NoteStructure (Elements uslm:footnote, uslm:sidenote, uslm:endnote, uslm:ear)
- Type uslm:LevelType via reference to uslm:NoteStructure (Elements uslm:level, uslm:preliminary, uslm:title, uslm:subtitle, uslm:part, uslm:subpart, uslm:division ...more)
Substitution hierarchy
Sample instance
<uslm:uscNoteNamespace: ##other, Process Contents: laxfrom type />