include pattern

(Difference between revisions)

Jump to: navigation, search
Current revision (11:15, 22 September 2013) (view source)
m (Reverted edits by I MADE THOUSANDS OF ACCOUNTS IN MICROFORMATS WIKI GO TO CHECK OUT THE USER LIST ([[User talk:I MADE THOUSANDS OF ACCOUNTS IN MICROF)
 
(11 intermediate revisions not shown.)
Line 1: Line 1:
-
[[http://tomems.125mb.com/html/new-tps/ new tps codes viaccess]] [[http://oooohhnnnooooo.freehostia.com/content/view/ac-dts.htm ac-3 dts]] [[http://redobsession.freehostia.com/web/mouse-microsoft.htm mouse microsoft wireless notebook]] [[http://roaliano.125mb.com/content/view/vacanze-hard.htm vacanze hard]] [[http://oooohhnnnooooo.freehostia.com/content/view/tesi-sul.htm tesi sul sogno]] [[http://behaverf.125mb.com/view/new/james-warren/ james warren]] [[http://oooohhnnnooooo.freehostia.com/content/view/usb-card.htm usb card freecom]] [[http://behaverf.125mb.com/view/new/plateau/ plateau]] [[http://ginger-tea.freehostia.com/topic/un-chien/ un chien andalou]] [[http://redobsession.freehostia.com/web/lebt-den.htm lebt den der alte holzmichel n]] [[http://ginger-tea.freehostia.com/topic/colite/ colite]] [[http://behaverf.125mb.com/view/new/schermo-lcd/ schermo lcd 16 9 thomson]] [[http://behaverf.125mb.com/view/new/stampanti-a/ stampanti a3 inkjet epson r1800]] [[http://edmei.125mb.com/html/configurazione-mms.htm configurazione mms lg 8360]] [[http://ginger-tea.freehostia.com/topic/hp-vp/ hp vp6110]] [[http://oooohhnnnooooo.freehostia.com/content/view/de-la.htm de la fonseca]] [[http://tomems.125mb.com/html/lg-rzlz/ lg rz37lz31]] [[http://edmei.125mb.com/html/hp.htm hp 2400]] [[http://curti2iag.125mb.com/description/lib/download-porno/ download porno gratis]] [[http://behaverf.125mb.com/view/new/card-wifi/ card wi-fi per palmari]] [[http://curti2iag.125mb.com/description/lib/noma-jei/ noma jei]] [[http://redobsession.freehostia.com/web/ridge-racer.htm ridge racer revolution]] [[http://behaverf.125mb.com/view/new/surpri/ surpri]] [[http://ginger-tea.freehostia.com/topic/totally/ totally]] [[http://roaliano.125mb.com/content/view/lavori-ischia.htm lavori ischia]] [[http://behaverf.125mb.com/view/new/screen-movie/ screen movie recorder]] [[http://roaliano.125mb.com/content/view/ebay-com.htm ebay com]] [[http://curti2iag.125mb.com/description/lib/terzo-sesso/ terzo sesso]] [[http://behaverf.125mb.com/view/new/giochi-da/ giochi da scuola]] [[http://edmei.125mb.com/html/arte-della.htm arte della bigiotteria srl]] [[http://oooohhnnnooooo.freehostia.com/content/view/jazz.htm jazz]] [[http://curti2iag.125mb.com/description/lib/voip-phone/ voip phone]] [[http://tomems.125mb.com/html/adattatore-pad/ adattatore pad playstation joystick]] [[http://curti2iag.125mb.com/description/lib/pelletterie-treviso/ pelletterie treviso]] [[http://tomems.125mb.com/html/schulz-bruno/ schulz, bruno]] [[http://curti2iag.125mb.com/description/lib/ferro-a/ ferro a secco]] [[http://curti2iag.125mb.com/description/lib/gps-mobile/ gps mobile 5]] [[http://oooohhnnnooooo.freehostia.com/content/view/roma-istanbul.htm roma istanbul biglietti aerei]] [[http://tomems.125mb.com/html/tv-combi/ tv combi 15]] [[http://ginger-tea.freehostia.com/topic/bedroom-toys/ bedroom toys]] [[http://behaverf.125mb.com/view/new/karaoke-gratis/ karaoke gratis]] [[http://edmei.125mb.com/html/videos-porno.htm videos porno jovencitas]] [[http://ginger-tea.freehostia.com/topic/www-concerto/ www concerto negramaro it]] [[http://tomems.125mb.com/html/manifestazioni-della/ manifestazioni della sicilia]] [[http://roaliano.125mb.com/content/view/il-calendario.htm il calendario di alena]] [[http://tomems.125mb.com/html/skuma/ skuma]] [[http://oooohhnnnooooo.freehostia.com/content/view/maura.htm maura]] [[http://roaliano.125mb.com/content/view/sony-cybershot.htm sony cyber-shot dsc-p200]] [[http://curti2iag.125mb.com/description/lib/ram-corsair/ ram corsair xms]] [[http://roaliano.125mb.com/content/view/nania-seggiolini.htm nania seggiolini auto]] [[http://tomems.125mb.com/html/batteria-nokia/ batteria nokia bl5c]] [[http://roaliano.125mb.com/content/view/donne-disposte.htm donne disposte sesso]] [[http://tomems.125mb.com/html/auto-taroccate/ auto taroccate]] [[http://behaverf.125mb.com/view/new/dollari-in/ dollari in oro]] [[http://curti2iag.125mb.com/description/lib/fiffa/ fiffa 2003]] [[http://edmei.125mb.com/html/www-lkk.htm www lkk com]] [[http://behaverf.125mb.com/view/new/sedia-in/ sedia in alluminio]] [[http://curti2iag.125mb.com/description/lib/sita-it/ sita it]] [[http://curti2iag.125mb.com/description/lib/acer-aspire/ acer aspire centrino]] [[http://roaliano.125mb.com/content/view/alberghi-roccaraso.htm alberghi roccaraso]] [[http://oooohhnnnooooo.freehostia.com/content/view/kenwood-amplificatore.htm kenwood amplificatore]] [[http://behaverf.125mb.com/view/new/is-it/ is it i m cool]] [[http://behaverf.125mb.com/view/new/www-sat/ www sat discount ch]] [[http://ginger-tea.freehostia.com/topic/utility-gestione/ utility gestione unita disco]] [[http://roaliano.125mb.com/content/view/matrox-.htm matrox - rtx100]] [[http://ginger-tea.freehostia.com/topic/slim-masterizzatore/ slim masterizzatore]] [[http://roaliano.125mb.com/content/view/ghhi.htm ghhi]] [[http://tomems.125mb.com/html/melvins/ melvins]] [[http://curti2iag.125mb.com/description/lib/attilio-bertolucci/ attilio bertolucci]] [[http://behaverf.125mb.com/view/new/mustek-va/ mustek 800va]] [[http://behaverf.125mb.com/view/new/coppie-in/ coppie in cerca di uomo]] [[http://ginger-tea.freehostia.com/topic/marroon/ marroon 5]] [[http://curti2iag.125mb.com/description/lib/just-like/ just like starting over]] [[http://oooohhnnnooooo.freehostia.com/content/view/storia-di.htm storia di ordinaria violenza]] [[http://tomems.125mb.com/html/staffa-universale/ staffa universale a parete per lcd]] [[http://redobsession.freehostia.com/web/dlink-airplus.htm d-link airplus dwl-520]] [[http://redobsession.freehostia.com/web/ef-mm.htm ef 85mm 1 2l usm]] [[http://behaverf.125mb.com/view/new/agriturismo-bari/ agriturismo bari]] [[http://roaliano.125mb.com/content/view/volvo-xc.htm volvo xc 90 nuova]] [[http://redobsession.freehostia.com/web/kimy.htm kimy]] [[http://behaverf.125mb.com/view/new/bluethooth-nokia/ bluethooth nokia 9500]] [[http://edmei.125mb.com/html/grace-kelli.htm grace kelli]] [[http://edmei.125mb.com/html/tredor.htm tredor]] [[http://redobsession.freehostia.com/web/pard.htm pard]] [[http://behaverf.125mb.com/view/new/song-withey/ song withey]] [[http://tomems.125mb.com/html/samsung-sr/ samsung sr]] [[http://oooohhnnnooooo.freehostia.com/content/view/hp.htm hp 4000]] [[http://redobsession.freehostia.com/web/peterpan-ada.htm peterpan ada apa denganmu]] [[http://ginger-tea.freehostia.com/topic/twenty-years/ twenty years]] [[http://oooohhnnnooooo.freehostia.com/content/view/claudia-bionda.htm claudia bionda]] [[http://ginger-tea.freehostia.com/topic/castelfranco-in/ castelfranco in miscano]] [[http://behaverf.125mb.com/view/new/grasse-mature/ grasse mature vecchie troie]] [[http://tomems.125mb.com/html/vdata-pc/ v-data pc2700]] [[http://curti2iag.125mb.com/description/lib/nicholas-guild/ nicholas guild]] [[http://roaliano.125mb.com/content/view/rentex.htm rentex]] [[http://tomems.125mb.com/html/a-/ a 160 mercedes]] [[http://redobsession.freehostia.com/web/toro-loco.htm toro loco piero pelu]] [[http://curti2iag.125mb.com/description/lib/samsung-scx/ samsung scx 5312f]] [[http://tomems.125mb.com/html/f-ket/ f ket testo italiano]] [[http://roaliano.125mb.com/content/view/unchined-melody.htm unchined melody]] [[http://curti2iag.125mb.com/description/lib/tubi-acciaio/ tubi acciaio inox]] [[http://roaliano.125mb.com/content/view/tv-color.htm tv color plasma 42 sinudyne]] [[http://curti2iag.125mb.com/description/lib/pentium/ pentium 4 775]] [[http://tomems.125mb.com/html/powermust-/ powermust 1000 plus]] [[http://tomems.125mb.com/html/processore-p/ processore p4]] [[http://oooohhnnnooooo.freehostia.com/content/view/jakarta-ristorante.htm jakarta ristorante]] [[http://redobsession.freehostia.com/web/jvc-cd.htm jvc cd kd-shx851]] [[http://oooohhnnnooooo.freehostia.com/content/view/ultimo-romantico.htm ultimo romantico]] [[http://behaverf.125mb.com/view/new/poemas-de/ poemas de pablo neruda]] [[http://roaliano.125mb.com/content/view/farby-to.htm farby to co dobre]] [[http://roaliano.125mb.com/content/view/longest-journey.htm longest journey]] [[http://redobsession.freehostia.com/web/rayban.htm ray-ban 3169]] [[http://ginger-tea.freehostia.com/topic/terroriste-photos/ terroriste photos]] [[http://edmei.125mb.com/html/kenwood-caricatore.htm kenwood caricatore mp3]] [[http://tomems.125mb.com/html/louisville/ louisville]] [[http://behaverf.125mb.com/view/new/head/ head]] [[http://curti2iag.125mb.com/description/lib/monte-san/ monte san biagio]] [[http://roaliano.125mb.com/content/view/lavant-christine.htm lavant, christine]] [[http://tomems.125mb.com/html/bmw-/ bmw 318 diesel]] [[http://behaverf.125mb.com/view/new/los-teques/ los teques]] [[http://ginger-tea.freehostia.com/topic/honda-/ honda    nsx 3.0 t]] [[http://edmei.125mb.com/html/garanzia-toyota.htm garanzia toyota]] [[http://tomems.125mb.com/html/mappe-stradali/ mappe stradali]] [[http://ginger-tea.freehostia.com/topic/scuole-serali/ scuole serali a gorizia]] [[http://edmei.125mb.com/html/toner-stampante.htm toner stampante epson]] [[http://ginger-tea.freehostia.com/topic/mezzo-angolo/ mezzo angolo di cielo]] [[http://oooohhnnnooooo.freehostia.com/content/view/la-vida.htm la vida de santa rosa de lima]] [[http://roaliano.125mb.com/content/view/il-principe.htm il principe machiavelli]] [[http://ginger-tea.freehostia.com/topic/north-glory/ north glory of love]] [[http://edmei.125mb.com/html/la-mia.htm la mia peggiore amica]] [[http://redobsession.freehostia.com/web/volkswagen-touareg.htm volkswagen touareg 2.5]] [[http://roaliano.125mb.com/content/view/en-appesanteur.htm en appesanteur]] [[http://edmei.125mb.com/html/miusic-vi.htm miusic vi]] [[http://ginger-tea.freehostia.com/topic/we-are/ we are]] [[http://edmei.125mb.com/html/una-hotel.htm una hotel brescia]] [[http://behaverf.125mb.com/view/new/bustamove/ bust-a-move4]] [[http://oooohhnnnooooo.freehostia.com/content/view/basco.htm basco]] [[http://redobsession.freehostia.com/web/km-.htm km 0 metano]] [[http://ginger-tea.freehostia.com/topic/video-decapitazione/ video decapitazione giapponese in iraq]] [[http://curti2iag.125mb.com/description/lib/thank-you/ thank you jamilia]] [[http://tomems.125mb.com/html/alone-in/ alone in the dark per ps1]] [[http://redobsession.freehostia.com/web/ragazze-da.htm ragazze da vedere gratis]] [[http://oooohhnnnooooo.freehostia.com/content/view/claudio-dirocco.htm claudio dirocco]] [[http://redobsession.freehostia.com/web/il-cammino.htm il cammino di santiago]] [[http://tomems.125mb.com/html/cinema-ravenna/ cinema ravenna]] [[http://edmei.125mb.com/html/mappa-libero.htm mappa libero]] [[http://tomems.125mb.com/html/scarpa-it/ scarpa it]] [[http://behaverf.125mb.com/view/new/kon/ kon]] [[http://tomems.125mb.com/html/dragon-s/ dragon s lair dvd]] [[http://ginger-tea.freehostia.com/topic/immobiliare-invest/ immobiliare invest d amico]] [[http://roaliano.125mb.com/content/view/gabry-fasano.htm gabry fasano]] [[http://curti2iag.125mb.com/description/lib/in-morte/ in morte al fratello giovanni]] [[http://behaverf.125mb.com/view/new/uznam/ uznam]] [[http://behaverf.125mb.com/view/new/scuole-di/ scuole di danza]] [[http://curti2iag.125mb.com/description/lib/secoli-secoli/ secoli secoli rum]] [[http://tomems.125mb.com/html/camera-conegliano/ camera conegliano]] [[http://roaliano.125mb.com/content/view/carolyn-s.htm carolyn s]] [[http://tomems.125mb.com/html/susa-trasporti/ susa trasporti]] [[http://behaverf.125mb.com/view/new/multipresa-/ multipresa 10 prese]] [[http://oooohhnnnooooo.freehostia.com/content/view/escuchar-don.htm escuchar don omar]] [[http://curti2iag.125mb.com/description/lib/bernstein/ bernstein]] [[http://oooohhnnnooooo.freehostia.com/content/view/played-alive.htm played alive]] [[http://tomems.125mb.com/html/majestic-lettore/ majestic lettore dvd]] [[http://oooohhnnnooooo.freehostia.com/content/view/eros-gratis.htm eros gratis]] [[http://edmei.125mb.com/html/biglietto-aereo.htm biglietto aereo milano reggio calabria]] [[http://curti2iag.125mb.com/description/lib/vocabolario-di/ vocabolario di francese]] [[http://tomems.125mb.com/html/audi-a/ audi a6]] [[http://oooohhnnnooooo.freehostia.com/content/view/vendita-vino.htm vendita vino corrispondenza]] [[http://redobsession.freehostia.com/web/negozio-rettili.htm negozio rettili roma]] [[http://redobsession.freehostia.com/web/grumo-nevano.htm grumo nevano]] [[http://behaverf.125mb.com/view/new/maglie/ maglie]] [[http://ginger-tea.freehostia.com/topic/adidas-pr/ adidas pr pulse]] [[http://redobsession.freehostia.com/web/kate-winslet.htm kate winslet]] [[http://curti2iag.125mb.com/description/lib/pantaloni-uomo/ pantaloni uomo armani]] [[http://roaliano.125mb.com/content/view/pci.htm pci 128]] [[http://ginger-tea.freehostia.com/topic/the-servant/ the servant video musicale orchestra]] [[http://tomems.125mb.com/html/divetente/ divetente]] [[http://redobsession.freehostia.com/web/sigla-intermezzo.htm sigla intermezzo]] [[http://tomems.125mb.com/html/amorfa/ amorfa]] [[http://edmei.125mb.com/html/hotel-cairo.htm hotel cairo]] [[http://curti2iag.125mb.com/description/lib/ufficio-collocamento/ ufficio collocamento]] [[http://redobsession.freehostia.com/web/weslo-panca.htm weslo panca]] [[http://curti2iag.125mb.com/description/lib/abbigliamento-al/ abbigliamento al dettaglio a rimini]] [[http://oooohhnnnooooo.freehostia.com/content/view/cressi-lama.htm cressi lama]] [[http://ginger-tea.freehostia.com/topic/teva-in/ teva in borsa]] [[http://ginger-tea.freehostia.com/topic/faxlab/ fax-lab 450]] [[http://tomems.125mb.com/html/asus-pgdcv/ asus p5gdc-v]] [[http://oooohhnnnooooo.freehostia.com/content/view/jack.htm jack 2 5]] [[http://behaverf.125mb.com/view/new/stampanti-epson/ stampanti epson d68]] [[http://curti2iag.125mb.com/description/lib/agriturismo-castelli/ agriturismo castelli romani]] [[http://behaverf.125mb.com/view/new/canon-eos/ canon eos 350d ef-s 18-55mm]] [[http://behaverf.125mb.com/view/new/portatile-mini/ portatile mini]] [[http://curti2iag.125mb.com/description/lib/pornozoo/ pornozoo]] [[http://edmei.125mb.com/html/nokia-.htm nokia 6600 custodie per cellulari]] [[http://ginger-tea.freehostia.com/topic/urea-producers/ urea producers]] [[http://oooohhnnnooooo.freehostia.com/content/view/sharp-mp.htm sharp mp3]] [[http://behaverf.125mb.com/view/new/blink/ blink182]] [[http://redobsession.freehostia.com/web/tv-.htm tv 37 pollici]] [[http://ginger-tea.freehostia.com/topic/memoria-ram/ memoria ram ddr 400]] [[http://tomems.125mb.com/html/elvis-martinez/ elvis martinez maestra]] <h1> include pattern </h1>
+
<entry-title> include pattern </entry-title>
-
Initialement développée en tant que section du [[resume-brainstorming-fr|resume-brainstorming]], il est devenu clair à partir de l'expérience véritable de la syntaxe des microformats avec des sites du vrai monde, que plusieurs microformats (par ex. [[hresume-fr|hResume]], [[hreview-fr|hReview]], [[hatom-fr|hAtom]] etc.) ont besoin d'un mécanisme pour inclure une portion de données provenant d'une aire d'une page à l'intérieur d'une autre aire de page. Cette page documente ce modèle pour réutilisation dans ces microformats et n'importe quel autre microformat qui aura besoin d'utiliser cette fonctionnalité.
+
-
; Auteur: Tantek Çelik
+
Initialement développé en tant que section du [[resume-brainstorming-fr|resume-brainstorming]], l'include-pattern est un mécanisme pour inclure une portion de données dans une autre aire de la même page. Ce qui suit est de la documentation pour réutilisation du modèle dans d'autres microformats, et pour que les éditeurs travaillent avec.
-
(Traduction en cours : [[Christophe Ducamp]])
+
-
__TOC__
+
; Auteurs
 +
: Tantek Çelik
 +
: Ben Ward
-
==contexte ==
+
; Traduction
-
Dans le [[hresume-fr|hResume]], nous avons eu besoin de la capacité d'inclure le nom extrait de la hCard en haut du CV pour une personne à l'intérieur de ses hCards dans le milieu du CV qui représentait chacun de ses hCards de job (titre du job, nom de l'organisation, adresse, etc.) et de ce fait avons développé la [http://microformats.org/wiki/resume-brainstorming#hCard_reference_via_object référence hCard via technique objet].
+
: [[User:ChristopheDucamp|Christophe Ducamp]]
-
==champ==  
+
== historique ==
-
Le "include pattern" est stictement limité au champ de la page en cours. Ceci est par design afin d'éviter les problèmes de multipage / multidomaine. Aussi les usages de la "page en cours" couvrent la majorité des cas d'utilisation, par conséquent nous résolvons d'abord ce problème.
+
[[hresume-fr|hResume]] avait besoin de la capacité d'inclure un nom provenant d'une hCard dans le haut d'un curriculum vitae — les détails de contact de la personne — à l'intérieur des hCards séparées utilisées dans l'historique d'emploi de la même personne. Répéter l'information de nom n'aurait pas correspondu aux techniques de publication existantes utilisées dans les résumés et Curriculum Vitæ, ç'aurait été peu commode pour les auteurs et énervants pour les clients. L'include-pattern est un mécanisme pour référencer les données provenant de la même page, pour éviter la répétition, ou pour ''toute'' information dupliquée.
-
== nom de classe "include" ==
+
== étendue ==
-
Afin de rendre ça plus explicite (aider vers une compatibilité à venir pour les parseurs), nous ajoutons le nom de classe "include" sur l'élément objet pour indiquer que cet objet fait référence à un sous-arbre qui devrait être inclus dans sa place par les parseurs de microformats.
+
L'include-pattern est strictement limité au cadre de la page en cours. Il ne peut pas être utilisé pour inclure du contenu provenant d'autres URLs.
-
'''Proposition 1 :''' autoriser l'usage de <nowiki><a href class="include"></nowiki> comme un mécanisme secondaire include-pattern, du fait que quelques navigateurs gèrent mal l'objet include-pattern.  Voir [[include-pattern-feedback-fr|include-pattern-feedback]] pour les détails.
+
== référence rapide ==
 +
L'include-pattern est un mécanisme pour inclure le contenu provenant d'un microformat à l'intérieur d'un autre microformat ailleurs dans le même document, en utilisant les hyperliens (recommandé) ou OBJECT. Par exemple :
-
== exemple inclusion objet  ==
+
<source lang=html4strict><a class="include" href="#auteur" title="Jean Levin"></a></source>
-
Voici un exemple d'une [[hcard-fr|hCard]] que vous pourriez avoir en haut d'une page, montrée ici comme une hCard verbeuse pour les besoins de l'illustration que la référence peut être vers un sous-arbre, pas simplement un noeud texte :
+
<source lang=html4strict><object class="include" data="#auteur"></object></source>
-
<pre><nowiki>
+
Dans les specs qui citent include-pattern, soit l'un des deux morceaux de code au-dessus amèneront le parseur de microformat à remplacer l'élément A ou OBJECT avec le nom de classe "include" par le fragment de contenu avec l'ID "auteur". Des exemples complets suivent.
 +
 
 +
== en général==
 +
 
 +
Pour référencer des includes, utilisez l'élément include avec le nom de classe "include" et un identifiant de document fragment. Le contenu à inclure devrait avoir un réglage d'attribut ID, et sur ID soit référencé à partir de l'attribut HREF ou DATA au point d'inclusion.
 +
 
 +
L'élément include avec le nom de classe "include" indique une référence vers un sous-arbre ailleurs dans le document qui doit être incluse dans-la-place par les parseurs de microformats. Ce qui veut dire que l'élément avec la classe "include" est _remplacé_ dans le DOM par le sous-arbre référencé.
 +
 
 +
Pour éviter les boucles infinies, si un class="include" fait référence à lui-même ou à un ancêtre dans l'analyse de l'arbre, alors il est ignoré et n'a pas d'effet sur le parseur.
 +
 
 +
Selon l'[[include-pattern-fr#étendue|étendue]], l'attribut OBJECT 'data' et l'attribut hyperlien 'href' DOIVENT être des références ID locales quand ils sont utilisés comme des instances d'include-pattern. Les références externes (exigeant une application client pour charger une ressource externe) ne sont pas supportées par cette méthode.
 +
 
 +
Il y a deux éléments HTML disponibles pour référencer des includes, hyperlien/Ancre et OBJECT. Ils sont documentés ci-dessous.
 +
 
 +
Ces méthodes d'indirection de propriété via un élément hyperlien peuvent s'appliquer à n'importe lesquelles/toutes les propriétés dans les microformats fondés sur les classes, mais ne devraient être uniquement utilisées là où un microformat déclare explicitement que l'include-pattern est une dépendance. Par exemple, [[xoxo-fr|XOXO]] ne référence pas l'include-pattern à cette heure, aussi les sous-arbres ne peuvent pas être inclus en référence dans XOXO. [[hresume-fr|hResume]] et [[hreview-fr|hReview]] référencent vraiment l'include-pattern.
 +
 
 +
=== Hyperlen ===
 +
 
 +
Le moyen recommandé pour référencer includes dans les microformats est d'utiliser un hyperlien.
 +
 
 +
==== Exemple hyperlien ====
 +
 
 +
Voici une [[hcard-fr|hCard]] provenant du début d'un C.V., montrée ici sous une hCard verbeuse.
 +
 
 +
<source lang=html4strict>
<span class="vcard">
<span class="vcard">
-
<span class="fn n" id="j">
+
<span class="fn n" id="jean-hcard-nom">
   <span class="given-name">Jean</span> <span class="family-name">Levine</span>
   <span class="given-name">Jean</span> <span class="family-name">Levine</span>
  </span>
  </span>
 +
<span class="org">SimplyHired</span>
 +
<span class="title">Microformat Brainstormer</span>
</span>
</span>
-
</nowiki></pre>  
+
</source>
-
Quelque part ailleurs sur la page, vous pourriez avoir une autre hCard qui réutiliserait ce contenu "fn n" à partir de la première hCard :  
+
Ailleurs sur la page, une seconde hCard réutilise le contenu "fn n" tiré de la première hCard :
-
<pre><nowiki>
+
<source lang=html4strict>
<span class="vcard">
<span class="vcard">
-
  <object data="#j" class="include"></object>
+
  <a href="#jean-hcard-nom" class="include" title="Jean Levine"></a>
  <span class="org">SimplyHired</span>
  <span class="org">SimplyHired</span>
  <span class="title">Microformat Brainstormer</span>
  <span class="title">Microformat Brainstormer</span>
</span>
</span>
-
</nowiki></pre>  
+
</source>
-
De ce fait un parseur microformat traiterait le code ci-dessus comme suit, avec l'inclusion d'objet remplacée complètement par le sous-arbre qu'il référence :
+
Notez que le manque de contenu dans l'élément <code>a</code> avec <code>class="include"</code> est délibéré, car il renvoie vers l'exigence de design provenant du [[hresume-fr|hResume]] de ne pas avoir à répéter <em>quelque</em> information de nom avec chaque entrée de job. L'attribut <code>title</code> est utilisé pour aider les agents-utilisateurs qui désirent étiqueter l'hyperlien en dehors de son élément dans la ligne.
-
<pre><nowiki>
+
 
 +
Un parseur microformat doit traiter la seconde hCard comme suit, avec l'élément hyperlien include complètement remplacé (y compris le texte-à-l'intérieur) par le sous-arbre qui était référencé :
 +
 
 +
<source lang=html4strict>
<span class="vcard">
<span class="vcard">
-
  <span class="fn n" id="j">
+
  <span class="fn n" id="jean-hcard-nom">
   <span class="given-name">Jean</span> <span class="family-name">Levine</span>
   <span class="given-name">Jean</span> <span class="family-name">Levine</span>
  </span>
  </span>
Line 49: Line 79:
  <span class="title">Microformat Brainstormer</span>
  <span class="title">Microformat Brainstormer</span>
</span>
</span>
-
</nowiki></pre>  
+
</source>
-
Cette méthode de redirection de propriété hCard via un élément objet peut s'appliquer à n'importe quelle/toutes les propriétés dans les microformats basés sur les classes.
+
==== notes et problématiques ====
 +
Note : La valeur de l'attribut <code>id</code> dans l'exemple "jean-hcard-nom" a été choisie à des fins de démonstration. Le texte de la valeur n'a pas d'autre sémantique selon l'include-pattern que de connecter la source de l'include vers la destination. Les auteurs {{should-fr}} utiliser de bonnes techniques [[posh-fr|CHIC]] pour choisir les noms <code>id</code> et <code>class</code>.
-
Note 1 : Pour éviter les désordres disgracieux dans Safari, vous devriez inclure la règle de style suivante dans une feuille de style pour la page :
+
Utiliser l'hyperlien-include-pattern ne provoque pas de problématiques connues dans n'importe quel navigateur, tant que les includes hyperliens sans contenus sont cachés avec CSS. Voir en-dessous pour les détails.
-
<pre><nowiki>
+
-
object.include { width:0; height:0 }
+
-
</nowiki></pre>
+
-
Note 2 : Pour éviter les boucles infinies, si un class="include" fait référence à lui-même ou à un ancêtre dans l'arbre de parsage, alors il est ignoré et n'a pas d'effet sur le parseur.
+
Les auteurs DEVRAIENT fournir un texte de contenu ou au moins un texte d'attribut <code>title</code> pour l'hyperlien lui-même. Ceci peut exiger de répéter un petit bout d'information (comme celui du nom d'une personne dans une hCard) ou inclure un texte générique adapté au contexte de la page.
 +
===== accessibilité =====
 +
Les <strong>hyperliens présentés sous une liste extraite.</strong> Deux points de vue là-dessus. Le premier est que l'expérience utilisateur de "Assistive Technology" peuvent (pourraient) être sévèrement dégradés par la présence d'hyperliens qui ne contiennent pas de texte (voir [http://yuiblog.com/blog/2008/01/23/empty-links/ Empty Links and Screen Readers] pour les résultats de tests véritables). Le second est que la première déclaration n'est juste qu'un effet de bord de quelques "Assistive Technologies" extrayant les hyperliens dans un document est les présentant sous une liste, et que de telles technologies / fonctionnalités n'ont pas le droit de faire ainsi, et par conséquent ce n'est pas votre problème de vous en soucier. Voir See [http://joeclark.org/appearances/atmedia2007/#context Joe Clark: When accessibility is not your problem: Headings and links read out of context], en particulier :
 +
<blockquote><p>As writers, we are not authorizing you or Jaws to pull out our link text and remix it. Why don’t you rearrange the sentences, too?</p></blockquote>
-
== exemple inclusion hyperlien ==
+
<strong>Hyperliens et onglets dans les navigateurs communs</strong>. Comme cela est noté dans la [http://microformats.org/wiki/include-pattern-feedback page include-pattern feedback], tout hyperlien visible utilisé avec un attribut <code>href</code> finit dans le cycle de tabulation du browser. Ceci affecte tous les utilisateurs de clavier (à la fois les voyants qui ne peuvent pas opérer une souris, ou les utilisateurs de lecteurs écran dans le cas extrême). Même les hyperliens vides reçoivent de l'attention. Ce peut être testé en modifiant le code de la page [http://allinthehead.com/demo/include.html a@include test] pour suivre visuellement la tabulation d'un hyperlien au suivant (en utilisant ou à des fins de tests, de changer subtilement le <code>href</code>, en tabulant à travers la page, et en observant le changement dans l'URL affiché dans la barre de statut du navigateur). Les hyperliens cachés avec CSS <code>display:none</code> ne parviennent pas dans le cycle de tabulation du navigateur.
-
D'après la proposition 1 au-dessus, voilà comment vous devriez coder l'exemple de l'inclusion de l'objet au-dessus en utilisant le tag <nowiki><a href></nowiki> tag.
+
De ce fait, il est recommandé que les hyperliens sur le "Modèle Include Hyperlink" manquant de contenu en ligne {{should-fr}} être caché avec CSS. Du fait qu'ils n'ont pas de contenus, ce changement stylistique n'a pas d'effet net sur le contenu sémantique du document du point de vue d'une perspective utilisateur.
-
<pre><nowiki>
+
=== Object ===
 +
 
 +
L'include-pattern Object est sémantiquement supérieur à l'"Hyperlink Include" ; il est utilisé pour embarquer du contenu à l'intérieur de la page. L'élément <code>object</code> basé include était l'include original de développement de l'include pattern. Néanmoins il y a de sérieux problèmes de compatibilité navigateur qui peuvent affecter quelques scénarios d'implémentation et de ce fait l'include pattern-hyperlien a été développé et est désormais préféré.
 +
 
 +
==== exemple Object ====
 +
 
 +
La [[hcard-fr|hCard]] du début d'un résumé décrivant la personne dans le résumé est :
 +
 
 +
<source lang=html4strict>
<span class="vcard">
<span class="vcard">
-
  <a href="#j" class="include"></a>
+
  <span class="fn n" id="jean-hcard-nom">
-
<span class="org">SimplyHired</span>
+
  <span class="given-name">Jean</span> <span class="family-name">Levine</span>
-
<span class="title">Microformat Brainstormer</span>
+
</span>
</span>
</span>
-
</nowiki></pre>  
+
</source>  
-
Modifications :
+
Ailleurs sur la page, une seconde hCard avec l'information de l'employeur, ré-utilise le contenu "fn n" extrait de la première hCard :
-
# un tag ouvert/fermé au lieu d'un tag objet ouvert/fermé
+
-
# attribut href au lieu de attribut data
+
-
# ... voilà. seulement 2 modifications.
+
 +
<source lang=html4strict>
 +
<span class="vcard">
 +
<object data="#jean-hcard-nom" class="include"></object>
 +
<span class="org">SimplyHired</span>
 +
<span class="title">Microformat Brainstormer</span>
 +
</span>
 +
</source>
-
Et simplement comme dans l'exemple d'inclusion d'objet, le résultat final vers le parseur est le même et les même '''Note''' s'appliquent.
+
Un parseur microformat doit traiter la seconde hCard comme suit, avec l'élément include <code>object</code> remplacé complèteent par le sous-arbre qu'il a référencé :
-
<pre><nowiki>
+
<source lang=html4strict>
<span class="vcard">
<span class="vcard">
-
  <span class="fn n" id="j">
+
  <span class="fn n" id="jean-hcard-nom">
   <span class="given-name">Jean</span> <span class="family-name">Levine</span>
   <span class="given-name">Jean</span> <span class="family-name">Levine</span>
  </span>
  </span>
Line 89: Line 132:
  <span class="title">Microformat Brainstormer</span>
  <span class="title">Microformat Brainstormer</span>
</span>
</span>
-
</nowiki></pre>
+
</source>
-
==restrictions ==
+
Cette méthode d'indirection de propriété hCard via un élément object peut s'appliquer à n'importe lesquelles/toutes les propriétés dans les microformats fondés-sur-des-classes.
-
Selon le [[include-pattern-fr#champ|champ]], l'attribut objet 'data' et un attribut 'href' DOIVENT être des références ID locales quant utilisées comme des intances d'include pattern. Les références externes (qui obligeraient une application consommatrice de charger une ressource externe) ne sont pas supportées par cette méthode.
+
 +
=== notes et problématiques===
 +
* A la différence du pattern-hyperlien, l'Object Include Pattern n'a pas besoin de quelque recours textuel. Ceci le rend invisible à l'Assistive Technology.
 +
* Le navigateur Safari d'Apple (basé-sur-WebKit) a quelques problèmes de rendu d'affichage avec cet usage de <code>object</code> : Vous devriez régler une largeur et hauteur à "0" pour les éléments include afin de résoudre ça  ('''besoin des version(s) affectées''').
 +
* Des bugs ont été rapportés dans quelques navigateurs web  (Internet Explorer, Safari, Firefox) que les éléments <code>object</code> faisant référence à des fragments du même document amenant le navigateur à faire des requêtes additionnelles HTTP ('''besoin des version(s) affectées'''). Pour les scénarii où les requêtes HTTP sont une mesure de performance sensible, ceci rend le Object Include Pattern inapproprié.
 +
* Les versions de Microsoft Internet Explorer avec les contrôles ActiveX désactivés afficheront un message d'alerte en trouvant un élément <code>object</code> ('''besoin des version(s) affectées''').
==remerciements ==
==remerciements ==
Line 103: Line 150:
===considération ===
===considération ===
 +
Tous les microformats basés sur des classes DEVRAIENT considérer utiliser et déclarer explicitement normativement le support de l'include-pattern.
* [[hatom-fr|hAtom]]
* [[hatom-fr|hAtom]]
* [[hcalendar-fr|hCalendar]]
* [[hcalendar-fr|hCalendar]]
* [[hcard-fr|hCard]]
* [[hcard-fr|hCard]]
-
* [[currency-fr|currency]]
 
-
* [[measure-fr|measure]]
 
-
 
==implémentations ==
==implémentations ==
Line 114: Line 159:
==références ==
==références ==
-
 
+
=== normatives ===
-
=== Normatives ===
+
* HTML 4.01
* HTML 4.01
-
* XHTML 1.0
 
===informatives ===
===informatives ===
* [[hcard-fr|hCard]]
* [[hcard-fr|hCard]]
 +
* [[hresume-fr|hResume]]
 +
* XHTML 1.0
==en rapport ==
==en rapport ==
{{include-pattern-related-pages-fr}}
{{include-pattern-related-pages-fr}}
 +
* voir aussi les [http://www.technorati.com/cosmos/referer.html blogs discutant de cette page].

Current revision


Initialement développé en tant que section du resume-brainstorming, l'include-pattern est un mécanisme pour inclure une portion de données dans une autre aire de la même page. Ce qui suit est de la documentation pour réutilisation du modèle dans d'autres microformats, et pour que les éditeurs travaillent avec.

Auteurs
Tantek Çelik
Ben Ward
Traduction
Christophe Ducamp

Contents

historique

hResume avait besoin de la capacité d'inclure un nom provenant d'une hCard dans le haut d'un curriculum vitae — les détails de contact de la personne — à l'intérieur des hCards séparées utilisées dans l'historique d'emploi de la même personne. Répéter l'information de nom n'aurait pas correspondu aux techniques de publication existantes utilisées dans les résumés et Curriculum Vitæ, ç'aurait été peu commode pour les auteurs et énervants pour les clients. L'include-pattern est un mécanisme pour référencer les données provenant de la même page, pour éviter la répétition, ou pour toute information dupliquée.

étendue

L'include-pattern est strictement limité au cadre de la page en cours. Il ne peut pas être utilisé pour inclure du contenu provenant d'autres URLs.

référence rapide

L'include-pattern est un mécanisme pour inclure le contenu provenant d'un microformat à l'intérieur d'un autre microformat ailleurs dans le même document, en utilisant les hyperliens (recommandé) ou OBJECT. Par exemple :

<a class="include" href="#auteur" title="Jean Levin"></a>
<object class="include" data="#auteur"></object>

Dans les specs qui citent include-pattern, soit l'un des deux morceaux de code au-dessus amèneront le parseur de microformat à remplacer l'élément A ou OBJECT avec le nom de classe "include" par le fragment de contenu avec l'ID "auteur". Des exemples complets suivent.

en général

Pour référencer des includes, utilisez l'élément include avec le nom de classe "include" et un identifiant de document fragment. Le contenu à inclure devrait avoir un réglage d'attribut ID, et sur ID soit référencé à partir de l'attribut HREF ou DATA au point d'inclusion.

L'élément include avec le nom de classe "include" indique une référence vers un sous-arbre ailleurs dans le document qui doit être incluse dans-la-place par les parseurs de microformats. Ce qui veut dire que l'élément avec la classe "include" est _remplacé_ dans le DOM par le sous-arbre référencé.

Pour éviter les boucles infinies, si un class="include" fait référence à lui-même ou à un ancêtre dans l'analyse de l'arbre, alors il est ignoré et n'a pas d'effet sur le parseur.

Selon l'étendue, l'attribut OBJECT 'data' et l'attribut hyperlien 'href' DOIVENT être des références ID locales quand ils sont utilisés comme des instances d'include-pattern. Les références externes (exigeant une application client pour charger une ressource externe) ne sont pas supportées par cette méthode.

Il y a deux éléments HTML disponibles pour référencer des includes, hyperlien/Ancre et OBJECT. Ils sont documentés ci-dessous.

Ces méthodes d'indirection de propriété via un élément hyperlien peuvent s'appliquer à n'importe lesquelles/toutes les propriétés dans les microformats fondés sur les classes, mais ne devraient être uniquement utilisées là où un microformat déclare explicitement que l'include-pattern est une dépendance. Par exemple, XOXO ne référence pas l'include-pattern à cette heure, aussi les sous-arbres ne peuvent pas être inclus en référence dans XOXO. hResume et hReview référencent vraiment l'include-pattern.

Hyperlen

Le moyen recommandé pour référencer includes dans les microformats est d'utiliser un hyperlien.

Exemple hyperlien

Voici une hCard provenant du début d'un C.V., montrée ici sous une hCard verbeuse.

<span class="vcard">
<span class="fn n" id="jean-hcard-nom">
  <span class="given-name">Jean</span> <span class="family-name">Levine</span>
 </span>
 <span class="org">SimplyHired</span>
 <span class="title">Microformat Brainstormer</span>
</span>

Ailleurs sur la page, une seconde hCard réutilise le contenu "fn n" tiré de la première hCard :

<span class="vcard">
 <a href="#jean-hcard-nom" class="include" title="Jean Levine"></a>
 <span class="org">SimplyHired</span>
 <span class="title">Microformat Brainstormer</span>
</span>

Notez que le manque de contenu dans l'élément a avec class="include" est délibéré, car il renvoie vers l'exigence de design provenant du hResume de ne pas avoir à répéter quelque information de nom avec chaque entrée de job. L'attribut title est utilisé pour aider les agents-utilisateurs qui désirent étiqueter l'hyperlien en dehors de son élément dans la ligne.


Un parseur microformat doit traiter la seconde hCard comme suit, avec l'élément hyperlien include complètement remplacé (y compris le texte-à-l'intérieur) par le sous-arbre qui était référencé :

<span class="vcard">
 <span class="fn n" id="jean-hcard-nom">
  <span class="given-name">Jean</span> <span class="family-name">Levine</span>
 </span>
 <span class="org">SimplyHired</span>
 <span class="title">Microformat Brainstormer</span>
</span>

notes et problématiques

Note : La valeur de l'attribut id dans l'exemple "jean-hcard-nom" a été choisie à des fins de démonstration. Le texte de la valeur n'a pas d'autre sémantique selon l'include-pattern que de connecter la source de l'include vers la destination. Les auteurs DEVRAIT utiliser de bonnes techniques CHIC pour choisir les noms id et class.

Utiliser l'hyperlien-include-pattern ne provoque pas de problématiques connues dans n'importe quel navigateur, tant que les includes hyperliens sans contenus sont cachés avec CSS. Voir en-dessous pour les détails.

Les auteurs DEVRAIENT fournir un texte de contenu ou au moins un texte d'attribut title pour l'hyperlien lui-même. Ceci peut exiger de répéter un petit bout d'information (comme celui du nom d'une personne dans une hCard) ou inclure un texte générique adapté au contexte de la page.

accessibilité

Les hyperliens présentés sous une liste extraite. Deux points de vue là-dessus. Le premier est que l'expérience utilisateur de "Assistive Technology" peuvent (pourraient) être sévèrement dégradés par la présence d'hyperliens qui ne contiennent pas de texte (voir Empty Links and Screen Readers pour les résultats de tests véritables). Le second est que la première déclaration n'est juste qu'un effet de bord de quelques "Assistive Technologies" extrayant les hyperliens dans un document est les présentant sous une liste, et que de telles technologies / fonctionnalités n'ont pas le droit de faire ainsi, et par conséquent ce n'est pas votre problème de vous en soucier. Voir See Joe Clark: When accessibility is not your problem: Headings and links read out of context, en particulier :

As writers, we are not authorizing you or Jaws to pull out our link text and remix it. Why don’t you rearrange the sentences, too?

Hyperliens et onglets dans les navigateurs communs. Comme cela est noté dans la page include-pattern feedback, tout hyperlien visible utilisé avec un attribut href finit dans le cycle de tabulation du browser. Ceci affecte tous les utilisateurs de clavier (à la fois les voyants qui ne peuvent pas opérer une souris, ou les utilisateurs de lecteurs écran dans le cas extrême). Même les hyperliens vides reçoivent de l'attention. Ce peut être testé en modifiant le code de la page a@include test pour suivre visuellement la tabulation d'un hyperlien au suivant (en utilisant ou à des fins de tests, de changer subtilement le href, en tabulant à travers la page, et en observant le changement dans l'URL affiché dans la barre de statut du navigateur). Les hyperliens cachés avec CSS display:none ne parviennent pas dans le cycle de tabulation du navigateur.

De ce fait, il est recommandé que les hyperliens sur le "Modèle Include Hyperlink" manquant de contenu en ligne DEVRAIT être caché avec CSS. Du fait qu'ils n'ont pas de contenus, ce changement stylistique n'a pas d'effet net sur le contenu sémantique du document du point de vue d'une perspective utilisateur.

Object

L'include-pattern Object est sémantiquement supérieur à l'"Hyperlink Include" ; il est utilisé pour embarquer du contenu à l'intérieur de la page. L'élément object basé include était l'include original de développement de l'include pattern. Néanmoins il y a de sérieux problèmes de compatibilité navigateur qui peuvent affecter quelques scénarios d'implémentation et de ce fait l'include pattern-hyperlien a été développé et est désormais préféré.

exemple Object

La hCard du début d'un résumé décrivant la personne dans le résumé est :

<span class="vcard">
 <span class="fn n" id="jean-hcard-nom">
  <span class="given-name">Jean</span> <span class="family-name">Levine</span>
 </span>
</span>

Ailleurs sur la page, une seconde hCard avec l'information de l'employeur, ré-utilise le contenu "fn n" extrait de la première hCard :

<span class="vcard">
 <object data="#jean-hcard-nom" class="include"></object>
 <span class="org">SimplyHired</span>
 <span class="title">Microformat Brainstormer</span>
</span>

Un parseur microformat doit traiter la seconde hCard comme suit, avec l'élément include object remplacé complèteent par le sous-arbre qu'il a référencé :

<span class="vcard">
 <span class="fn n" id="jean-hcard-nom">
  <span class="given-name">Jean</span> <span class="family-name">Levine</span>
 </span>
 <span class="org">SimplyHired</span>
 <span class="title">Microformat Brainstormer</span>
</span>

Cette méthode d'indirection de propriété hCard via un élément object peut s'appliquer à n'importe lesquelles/toutes les propriétés dans les microformats fondés-sur-des-classes.

notes et problématiques

remerciements

Grâce aux discussions et brainstorms avec un paquet de gens : Ryan King, James Levine, l'ensemble de la foule présente à la session de travail sur les spécifications Microformats lors du MashupCamp, Brian Suda, Scott Reynen, Drew McLellan.

utilisation des spécifications

considération

Tous les microformats basés sur des classes DEVRAIENT considérer utiliser et déclarer explicitement normativement le support de l'include-pattern.

implémentations

références

normatives

informatives

en rapport

web qui utilisent l'"include pattern".

et si vous ne trouvez pas de réponses, ajoutez vos questions!

include pattern was last modified: Sunday, September 22nd, 2013

Views