adr-examples - Revision history

Brian: Reverted edits by CboelBotro (Talk) to last version by Csarven

2009-01-03T19:19:01Z

Reverted edits by CboelBotro (Talk) to last version by Csarven

← Older revision		Revision as of 19:19, 3 January 2009
Line 1:		Line 1:
	~~bocolor~~
	<h1>More ADR examples</h1>		<h1>More ADR examples</h1>

Line 94:		Line 93:
	<dl class="adr">		<dl class="adr">
	<dt>Street Address</dt>		<dt>Street Address</dt>
	<dd class="street-address">1100 Boulevard ~~RenÃ©~~-~~LÃ©vesque~~ Ouest</dd>		<dd class="street-address">1100 Boulevard René-Lévesque Ouest</dd>
	<dt>Extended Address</dt>		<dt>Extended Address</dt>
	<dd class="extended-address">24th Floor</dd>		<dd class="extended-address">24th Floor</dd>

CboelBotro: alallivi

2009-01-03T12:00:22Z

alallivi

← Older revision		Revision as of 12:00, 3 January 2009
Line 1:		Line 1:
			bocolor
	<h1>More ADR examples</h1>		<h1>More ADR examples</h1>

Line 93:		Line 94:
	<dl class="adr">		<dl class="adr">
	<dt>Street Address</dt>		<dt>Street Address</dt>
	<dd class="street-address">1100 Boulevard ~~René~~-~~Lévesque~~ Ouest</dd>		<dd class="street-address">1100 Boulevard RenÃ©-LÃ©vesque Ouest</dd>
	<dt>Extended Address</dt>		<dt>Extended Address</dt>
	<dd class="extended-address">24th Floor</dd>		<dd class="extended-address">24th Floor</dd>

Csarven: removed geo note

2007-10-24T03:08:47Z

removed geo note

← Older revision		Revision as of 03:08, 24 October 2007
Line 109:		Line 109:
	Notes:		Notes:
	* The human readable labels in <strong><code>dt</code></strong> elements can be removed (<code>display:none</code>) from visual presentation.		* The human readable labels in <strong><code>dt</code></strong> elements can be removed (<code>display:none</code>) from visual presentation.
	* See also [[geo-brainstorming]]

Csarven: geo doesn't belong in adr

2007-10-24T03:03:33Z

geo doesn't belong in adr

← Older revision		Revision as of 03:03, 24 October 2007
Line 104:		Line 104:
	<dt>Country</dt>		<dt>Country</dt>
	<dd><abbr class="country-name" title="Canada">CA</abbr></dd>		<dd><abbr class="country-name" title="Canada">CA</abbr></dd>
	~~<dt>Geo</dt>~~
	~~<dd class="geo">~~
	~~<dl>~~
	~~<dt>Latitude</dt>~~
	~~<dd><abbr class="latitude" title="45.498677">45°34' 13" N</abbr></dd>~~
	~~<dt>Longitude</dt>~~
	~~<dd><abbr class="longitude" title="-73.570260">73°29' 55" W</abbr></dd>~~
	~~</dl>~~
	~~</dd>~~
	</dl>		</dl>
	</pre>		</pre>

Tantek: old typo and grammar

2007-10-20T22:12:53Z

old typo and grammar

← Older revision		Revision as of 22:12, 20 October 2007
Line 3:		Line 3:
	== Use hCard instead where possible ==		== Use hCard instead where possible ==

	'''Note: you should always use [[hcard\|hCard]] instead of [[adr]] where possible. If you are marking up ~~and~~ address that is associated with a named person or place, then mark up that named person or place ''with'' that address as an [[hcard\|hCard]] with "adr" property and subproperties. See [[hcard-authoring\|hCard authoring]], and [[hcard-examples\|hCard examples]] for more on this.		'''Note: you should always use [[hcard\|hCard]] instead of [[adr]] where possible. If you are marking up an address that is associated with a named person or place, then mark up that named person or place ''with'' that address as an [[hcard\|hCard]] with "adr" property and subproperties. See [[hcard-authoring\|hCard authoring]], and [[hcard-examples\|hCard examples]] for more on this.

	== LOCALITY and other ADR fragments ==		== LOCALITY and other ADR fragments ==
Line 29:		Line 29:

	<pre><nowiki>		<pre><nowiki>
			<span class="adr">
	<abbr class="region" title="California">CA</abbr>,		<abbr class="region" title="California">CA</abbr>,
	<abbr class="country-name" title="United States">US</abbr>		<abbr class="country-name" title="United States">US</abbr>
			</span>
	</nowiki></pre>		</nowiki></pre>

	~~For~~ the full country names in the <code>title</code> attribute of the <code><abbr></code> element when using the <em>country-name</em> property,		Use [http://www.iso.org/iso/en/prods-services/iso3166ma/02iso-3166-code-lists/list-en1.html ISO 3166-1] for the full country names in the <code>title</code> attribute of the <code><abbr></code> element when using the <em>country-name</em> property.
	~~use [http://www.iso.org/iso/en/prods-services/iso3166ma/02iso-3166-code-lists/list-en1.html ISO 3166-1]~~.

	== Use of the address element ==		== Use of the address element ==

Csarven: note for geo-brainstorming

2007-10-20T22:07:22Z

note for geo-brainstorming

← Older revision		Revision as of 22:07, 20 October 2007
Line 115:		Line 115:
	</pre>		</pre>

	The human readable labels in <strong><code>dt</code></strong> elements can be removed (<code>display:none</code>) from visual presentation.		Notes:
			* The human readable labels in <strong><code>dt</code></strong> elements can be removed (<code>display:none</code>) from visual presentation.
			* See also [[geo-brainstorming]]

Csarven: dl element example

2007-10-20T21:41:07Z

dl element example

← Older revision		Revision as of 21:41, 20 October 2007
Line 86:		Line 86:
	address span.adr { display:block; }		address span.adr { display:block; }
	</nowiki></pre>		</nowiki></pre>

			== Use of dl element ==
			The information can be paired using the <strong><code>dl</code></strong> element, where <strong><code>dt</code></strong> would contain the human readable label and <strong><code>dd</code></strong> would contain the key and data (except where <strong><code>abbr</code></strong> is appropriate for the key). Example:
			<pre>
			<dl class="adr">
			<dt>Street Address</dt>
			<dd class="street-address">1100 Boulevard René-Lévesque Ouest</dd>
			<dt>Extended Address</dt>
			<dd class="extended-address">24th Floor</dd>
			<dt>Postal Code</dt>
			<dd class="postal-code">H3B 4X9</dd>
			<dt>Locality</dt>
			<dd class="locality">Montréal</dd>
			<dt>Region</dt>
			<dd><abbr class="region" title="Québec">QC</abbr></dd>
			<dt>Country</dt>
			<dd><abbr class="country-name" title="Canada">CA</abbr></dd>
			<dt>Geo</dt>
			<dd class="geo">
			<dl>
			<dt>Latitude</dt>
			<dd><abbr class="latitude" title="45.498677">45°34' 13" N</abbr></dd>
			<dt>Longitude</dt>
			<dd><abbr class="longitude" title="-73.570260">73°29' 55" W</abbr></dd>
			</dl>
			</dd>
			</dl>
			</pre>

			The human readable labels in <strong><code>dt</code></strong> elements can be removed (<code>display:none</code>) from visual presentation.

JamesCraig: removed non-neutral "using address is awkward" comment and added css example to replace the awkward code

2007-03-02T00:24:14Z

removed non-neutral "using address is awkward" comment and added css example to replace the awkward code

← Older revision		Revision as of 00:24, 2 March 2007
Line 81:		Line 81:
	</nowiki></pre>		</nowiki></pre>

	Note: <code><address></code> MUST only contain inline elements which ~~leads to~~ the awkwardness of using ~~code like~~ <nowiki><span class="display:block"></nowiki>. ~~This makes the~~ <code><address></code> ~~element awkward~~ to ~~use for many real content situations~~.		Note: <code><address></code> MUST only contain inline elements which explains the awkwardness of this example's using <nowiki><span class="display:block"></nowiki>. If using <code><address></code> for an hCard, consider moving the CSS to an external style sheet such as:

			<pre><nowiki>
			address span.adr { display:block; }
			</nowiki></pre>

Tantek: use wiki markup for headings, add numerous warnings and references about use of
element

2007-02-27T16:08:42Z

use wiki markup for headings, add numerous warnings and references about use of <address> element

← Older revision		Revision as of 16:08, 27 February 2007
Line 1:		Line 1:
	<h1>More ADR examples</h1>		<h1>More ADR examples</h1>

	~~<h2>~~LOCALITY and other ADR fragments~~</h2>~~		== Use hCard instead where possible ==

			'''Note: you should always use [[hcard\|hCard]] instead of [[adr]] where possible. If you are marking up and address that is associated with a named person or place, then mark up that named person or place ''with'' that address as an [[hcard\|hCard]] with "adr" property and subproperties. See [[hcard-authoring\|hCard authoring]], and [[hcard-examples\|hCard examples]] for more on this.

			== LOCALITY and other ADR fragments ==

	Using the <strong>adr</strong> microformat should not just be limited to full datasets of information.		Using the <strong>adr</strong> microformat should not just be limited to full datasets of information.
Line 11:		Line 15:
	Because I marked up the city name with the <em>locality</em> property, I added the <em>adr</em>		Because I marked up the city name with the <em>locality</em> property, I added the <em>adr</em>
	property to the block-level parent element that contains the relevant <em>locality</em> property.		property to the block-level parent element that contains the relevant <em>locality</em> property.

	~~<h3>Example:</h3>~~

	<pre><nowiki>		<pre><nowiki>
Line 19:		Line 21:
	</nowiki></pre>		</nowiki></pre>

	~~<h2>~~Use of the <code><abbr></code> element~~</h2>~~		== Use of abbr ==

			Use of the <code><abbr></code> element.

	Semantically-correct <strong>adr</strong> markup would use the <code><abbr></code> element while		Semantically-correct <strong>adr</strong> markup would use the <code><abbr></code> element while
	using the <em>region</em>, <em>country-name</em> and perhaps other <strong>adr</strong> properties.		using the <em>region</em>, <em>country-name</em> and perhaps other <strong>adr</strong> properties. E.g.:

	~~<h3>Example~~:~~</h3>~~

	<pre><nowiki>		<pre><nowiki>
Line 34:		Line 36:
	use [http://www.iso.org/iso/en/prods-services/iso3166ma/02iso-3166-code-lists/list-en1.html ISO 3166-1].		use [http://www.iso.org/iso/en/prods-services/iso3166ma/02iso-3166-code-lists/list-en1.html ISO 3166-1].

	<h2>~~Use~~ of the <code><address></code> element</h2>		== Use of the address element ==

			'''Warning: The <code><address></code> element is typically very confusing for web authors and is best avoided.'''

			The <code><address></code> element does NOT mean what you might think it means (unless you are one of the few folks who has thoroughly read the [http://w3.org/tr/html401 HTML 4.01 recommendation]).

			The <code><address></code> element '''does NOT mean "address"'''.

			Please read the [[hcard-faq\|hCard FAQ]] ''first'' before even considering this, especially the [[hcard-faq#Should_I_use_ADDRESS_for_hCards\|\|section on the <code><address></code> element]].

			If you have read all that first, note that it is possible in some rare situations to use the HTML <code>[http://www.w3.org/MarkUp/html3/address.html <address>]</code> element with <strong>adr</strong>, '''IF''' the information specifies a contact address for the current document, such as site contact or business address, though even in most of those cases, you should be using [[hcard\|hCard]] instead, as illustrated in [[hcard-examples#Authors_of_Pages_and_Posts\|\|hCard Examples: Authors of Pages and Posts]].

	~~It is possible to use the HTML~~ <code>~~[http://www.w3.org/MarkUp/html3/address.html~~ <address>]</code> element ~~with <strong>adr</strong>, given the information specifies an address for the current document, such as site contact or business address. <code><address></code>~~ should <strong>not</strong> be used for every instance of <strong>adr</strong>~~. Note: <code><address></code> should only contain inline elements~~.		The <code><address></code> element in general should <strong>not</strong> be used for every instance of <strong>adr</strong>.

	~~<h3>~~Example using ADDRESS:~~</h3>~~		Example using ADDRESS:

	<pre><nowiki>		<pre><nowiki>
Line 50:		Line 62:
	</address>		</address>
	</nowiki></pre>		</nowiki></pre>

			But even this example is better marked up as an [[hcard\|hCard]], since that is the address of a specific organization:

			<pre><nowiki>
			<address class="vcard">
			<a class="url fn org" href="http://technorati.com/">Technorati</a>
			<span class="adr" style="display:block">
			<span class="street-address">665 3rd St.</span>
			<span class="extended-address">Suite 207</span>
			<span style="display:block">
			<span class="locality">San Francisco</span>,
			<span class="region">CA</span>
			<span class="postal-code">94107</span>
			</span>
			<span class="country-name">United States</span>
			</span>
			</address>
			</nowiki></pre>

			Note: <code><address></code> MUST only contain inline elements which leads to the awkwardness of using code like <nowiki><span class="display:block"></nowiki>. This makes the <code><address></code> element awkward to use for many real content situations.

JamesCraig: adding ADDRESS example with appropriate disclaimers

2007-02-26T19:26:52Z

adding ADDRESS example with appropriate disclaimers

← Older revision		Revision as of 19:26, 26 February 2007
Line 33:		Line 33:
	For the full country names in the <code>title</code> attribute of the <code><abbr></code> element when using the <em>country-name</em> property,		For the full country names in the <code>title</code> attribute of the <code><abbr></code> element when using the <em>country-name</em> property,
	use [http://www.iso.org/iso/en/prods-services/iso3166ma/02iso-3166-code-lists/list-en1.html ISO 3166-1].		use [http://www.iso.org/iso/en/prods-services/iso3166ma/02iso-3166-code-lists/list-en1.html ISO 3166-1].

			<h2>Use of the <code><address></code> element</h2>

			It is possible to use the HTML <code>[http://www.w3.org/MarkUp/html3/address.html <address>]</code> element with <strong>adr</strong>, given the information specifies an address for the current document, such as site contact or business address. <code><address></code> should <strong>not</strong> be used for every instance of <strong>adr</strong>. Note: <code><address></code> should only contain inline elements.

			<h3>Example using ADDRESS:</h3>

			<pre><nowiki>
			<address class="adr">
			<span class="street-address">665 3rd St.</span>
			<span class="extended-address">Suite 207</span>
			<span class="locality">San Francisco</span>,
			<span class="region">CA</span>
			<span class="postal-code">94107</span>
			<span class="country-name">United States</span>
			</address>
			</nowiki></pre>