Inline-video: Regels en voorbeelden

Een inline-video is een gehoste of extern ingebedde opname die in de leesstroom van het artikel is geplaatst om één afgebakend idee te demonstreren, uit te leggen of te documenteren. Het bevat een zichtbaar label, een doordachte posterframe, afspeelknoppen, ondertiteling, duur en een volledig transcript. Zonder die omringende woorden is een ongelabelde speler onzichtbaar voor elke lezer die niet kan of kiest om niet te kijken—en bijna leeg voor systemen die tekst extraheren in plaats van de opname decoderen.

De opmerking over de aankomende poster is een specificatie voor een vast te leggen afbeelding, geen verwijzing naar een asset. De omringende HTML toont de vereiste leesvolgorde voordat de mediaproductie is voltooid.

Waarom dit element belangrijk is

Video verlaagt de uitlegkosten wanneer beweging, timing, stem of verandering in de tijd betekenis draagt. Een lezer kan zien hoe een menu opent, hoe een fysiek product beweegt, of hoe een spreker een conclusie kwalificeert. Kijken vereist aandacht, geluid of ondertiteling, tijd en vaak meer data dan lezen, dus een duidelijk label en duur stellen de lezer in staat die kosten in te schatten.

Posterframes beïnvloeden die beslissing vóór het afspelen. Een representatieve stilstaande afbeelding fungeert als een visuele belofte van wat de opname bevat. Een willekeurig frame met gesloten ogen, een laadspinner of een niet-gerelateerde titelkaart doet de inhoud onzorgvuldig lijken en dwingt de lezer op play te drukken om het onderwerp te ontdekken. De poster moet de staat, persoon, het object of de uitkomst onthullen die de video daadwerkelijk uitlegt.

Machine-extracteerbaarheid is het vermogen van software om de betekenis van een inhoudseenheid te herstellen zonder de presentatie ervan te reproduceren. Een kale iframe geeft meestal weinig meer dan een provider-URL. Een gelabeld element toont een titel, samenvatting, duur, datum, poster, ondertiteling, transcript en een stabiele identificatie. Zoek-, vertaal-, toegankelijkheids- en ophaalsystemen kunnen vervolgens de afgebakende uitleg begrijpen.

Het transcript is daarom onderdeel van het element, geen optionele download. Het bewaart gesproken beweringen, sprekerswisselingen, betekenisvolle geluiden en visuele handelingen in documentvolgorde. Ondertiteling ondersteunt de kijkervaring; het transcript ondersteunt de pagina. Volg de gedeelde schrijfregels voor elementen voor semantische voorrang, directieve syntax en body-mapping. Deze pagina heeft voorrang waar deze een transcript, poster, duur en videospecifieke toegankelijkheidsvelden vereist.

Wanneer te gebruiken

Gebruik inline-video wanneer tijdgebaseerd bewijs een afgebakend punt duidelijker maakt dan stilstaande beelden en proza. Geschikte gevallen zijn onder meer een interfacehandeling, fysieke techniek, zichtbare overgang, deskundige uitleg, bewegingsafhankelijk productgedrag of een vastgelegd resultaat waarvan de weergave bewijs is.

Pas een vervangingstest toe voordat u de opname laat maken. Als één screenshot en twee zinnen het punt even goed uitleggen, gebruik die dan: ze laden sneller, zijn sneller te scannen en kosten minder om bij te werken. Video verdient zijn plaats wanneer volgorde, tempo, beweging, stem of waargenomen gedrag het begrip verandert.

Grensvallende gevallen zijn onder meer:

• Een lange webinar in een niet-gerelateerde alinea: link naar een speciale videopagina of gebruik een volledige video-embedsectie. Een inline-element moet het lokale argument dienen, niet een uur aan aangrenzende onderwerpen importeren.
• Een stille, herhalende decoratie: dat is bewegingsontwerp, geen redactionele video. Verwijder het of behandel het als decoratieve media met gedrag bij verminderde beweging.
• Een schermopname gebruikt in plaats van instructies: schrijf de stappen en de succestoestand in tekst. De video mag ze demonstreren, maar kan niet de enige manier zijn om de taak te voltooien.
• Een klantcitaat zonder context geknipt: een kort fragment kan alleen een casestudy ondersteunen wanneer de spreker, relatie, opnamedatum, goedkeuring en omringende bewering worden vermeld.
• Een video waarvan de enige waarde persoonlijkheid is: gebruik het alleen wanneer stem, presentatie of het gezag van de spreker relevant is. Laat lezers niet naar een presentator kijken die al bestaande tekst op de pagina voorleest.
• Meerdere vergelijkbare clips: gebruik een galerij of een speciale mediasectie wanneer selectie uit opnamen de taak is. Stapel geen inline-spelers.

Waar te plaatsen

Plaats de video direct na de alinea die benoemt wat de lezer zal leren of observeren. Zet de titel, duur en samenvatting vóór de speler. Plaats het transcript er direct onder, alleen samengevouwen wanneer de volledige tekst in HTML blijft zonder afspeelcode.

In een procedure plaatst u de speler na de geschreven handelingsvolgorde en vóór probleemoplossing. De lezer moet kunnen handelen zonder te kijken en vervolgens de opname gebruiken om beweging of interfacestatus te bevestigen. In een argument of casestudy vermeldt u de bewering vóór de opname en interpreteert u de beperkingen erna.

Plaats het niet naast een andere speler, automatisch afspelende animatie, grote call-to-action, formulier of rekenmachine. Concurrerende bedieningselementen creëren onduidelijke focus. Plaats het niet in een tabelcel, lijstitem, callout, tab, carrousel, accordeonpaneel of klikbare kaart. Het transcript mag een openbaarmakingsbediening gebruiken; de volledige video mag dat niet.

Houd de titel, samenvatting, poster, speler, duur, transcriptbediening en vermelding binnen één figuurgrens. Een bronvermelding mag direct volgen. Scheid de speler nooit van het transcript met een advertentie, promotie of niet-gerelateerde sectie.

Anatomie

1. Zichtbare titel: Benoemt de taak, demonstratie, gebeurtenis of bewering in specifieke HTML-tekst.
2. Samenvatting: Legt in één zin uit wat de lezer zal zien en waarom het belangrijk is.
3. Duur: Vermeldt de kijkkosten vóór het afspelen in minuten en seconden.
4. Posterframe: Toont een representatief, goedgekeurd frame zonder te doen alsof het zelf een knop is.
5. Afspeelknoppen: Bieden afspelen, pauzeren, zoeken, volume, volledig scherm, afspeelsnelheid en toegang tot ondertiteling.
6. Ondertiteling: Synchroniseert dialoog, sprekerswisselingen en betekenisvolle niet-spraakaudio met het afspelen.
7. Transcript: Geeft de volledige betekenisvolle volgorde weer als selecteerbare, doorzoekbare HTML-tekst.
8. Visuele beschrijvingen: Legt betekenisvolle handelingen of veranderingen op het scherm vast die de voice-over niet vermeldt.
9. Vermelding en bron: Identificeert de spreker, maker, opnamedatum of herkomst van het bewijs wanneer relevant.

De titel is niet de bestandsnaam en de samenvatting is niet ‘Bekijk de video hieronder’. Elk moet bruikbaar blijven wanneer het zonder de speler wordt gekopieerd.

Ontwerpvoorbeelden

Alle varianten delen hetzelfde inhoudscontract. De levering verandert; labeling, ondertiteling, transcriptkwaliteit, toestemming voor afspelen en leesvolgorde niet.

Gehoste demonstratie

Gebruik een first-party HTML5-speler voor een korte product- of procesopname wanneer de organisatie de codering, ondertiteling, posterselectie en beschikbaarheid beheert.

Privacybewuste externe embed

Gebruik een extern platform wanneer de levering, analyse of gevestigde kanaal ervan vereist is. Laad de provider alleen na toestemming waar het beleid dit vereist, identificeer de provider vóór activering en behoud het lokale transcript, zelfs als de provider de opname verwijdert.

Korte interfaceclip

Gebruik een beknopte clip voor één statuswijziging die moeilijk te communiceren is met stilstaande beelden. Het heeft nog steeds bedieningselementen, een pauzemechanisme, een betekenisvolle tekstbeschrijving en een transcript nodig; maak er geen automatisch herhalende GIF van.

Interview- of bewijsclip

Gebruik een door een spreker geleide clip wanneer auteurschap, bewoording of waargenomen getuigenis belangrijk is. Toon de naam en rol van de persoon in HTML, vermeld bewerkingen en transcribeer zowel spraak als materieel visueel bewijs.

Parameters

Deze velden vormen het draagbare inhoudscontract. Breedte, rand, schaduw, stijl van de afspeelknop en breekpuntgedrag behoren tot de renderer.

De eerste body-kop wordt toegewezen aan title; de eerste alinea aan summary; de rest van de body aan transcript. Transcript-tijdsbereiken zijn optioneel voor een doorlopende uitleg van één spreker en worden aanbevolen voor procedures, sprekerswisselingen en opnamen langer dan twee minuten. autoplay, loop en achtergrond-audiovelden zijn bewust afwezig.

Syntax en codevoorbeelden

Elke notatie behoudt dezelfde titel, samenvatting, mediametagegevens, ondertiteling en transcript. De voorbeelddomeinen beschrijven het contract en zijn geen verwijzingen naar productie-assets.

Draagbare Markdown-richtlijn

:::inline-video{src="https://media.example.com/freshness-filter.mp4" provider=hosted poster="https://media.example.com/freshness-filter-poster.webp" duration="PT1M30S" captions="https://media.example.com/freshness-filter.en.vtt" language=en uploadDate="2026-08-27"}

## Filter pages that need review

See how to apply the Needs review filter and verify the resulting work queue.

**00:00–00:18 — Open the report.** From Audit, open Freshness.

**00:19–00:54 — Apply the filter.** Open Status and choose Needs review.

**00:55–01:30 — Verify the queue.** Confirm that every visible row has the expected status.
:::

Hugo shortcode

{{< inline-video src="https://media.example.com/freshness-filter.mp4" provider="hosted" poster="https://media.example.com/freshness-filter-poster.webp" duration="PT1M30S" captions="https://media.example.com/freshness-filter.en.vtt" language="en" uploadDate="2026-08-27" >}}
## Filter pages that need review

See how to apply the Needs review filter and verify the resulting work queue.

**00:00–00:18 — Open the report.** From Audit, open Freshness.

**00:19–00:54 — Apply the filter.** Open Status and choose Needs review.

**00:55–01:30 — Verify the queue.** Confirm that every visible row has the expected status.
{{< /inline-video >}}

Dit is het beoogde adaptercontract, geen bewering dat er een lokale shortcode bestaat. Het gebruikt alleen benoemde parameters. Totdat een renderer is geregistreerd, gebruikt u semantische figure-, video-, track- en transcript-HTML die dezelfde velden behoudt.

WordPress-blok

<!-- wp:amicited/inline-video {"src":"https://media.example.com/freshness-filter.mp4","provider":"hosted","poster":"https://media.example.com/freshness-filter-poster.webp","duration":"PT1M30S","captions":"https://media.example.com/freshness-filter.en.vtt","language":"en","uploadDate":"2026-08-27"} -->
<h2>Filter pages that need review</h2>
<p>See how to apply the Needs review filter and verify the resulting work queue.</p>
<video controls preload="metadata" poster="https://media.example.com/freshness-filter-poster.webp">
  <source src="https://media.example.com/freshness-filter.mp4" type="video/mp4">
  <track kind="captions" srclang="en" src="https://media.example.com/freshness-filter.en.vtt" label="English" default>
</video>
<details><summary>Read the transcript</summary><p><strong>00:00–00:18 — Open the report.</strong> From Audit, open Freshness.</p><p><strong>00:19–00:54 — Apply the filter.</strong> Open Status and choose Needs review.</p><p><strong>00:55–01:30 — Verify the queue.</strong> Confirm that every visible row has the expected status.</p></details>
<!-- /wp:amicited/inline-video -->

Als het geregistreerde WordPress-blok niet beschikbaar is, gebruik dan native Video-, Heading-, Paragraph- en Details-blokken. Plak geen iframe en laat het lokale transcript niet weg.

Voorbeelden

Goed: een afgebakende demonstratie met een leesalternatief

Filter pagina’s die beoordeling nodig hebben · 1:30

De video toont één taak: het openen van een versheidsrapport, het toepassen van een statusfilter en het controleren van het resultaataantal. De poster toont het open filter, de ondertiteling identificeert interfacelabels exact en het driedelige transcript registreert elke handeling en succescontrole. Het afspelen begint pas na activering.

Dit werkt omdat een lezer de waarde en tijdsinvestering kan voorspellen, kan kijken met geluid, kan kijken met ondertiteling, of dezelfde taak kan voltooien via het transcript. De opname voegt bewijs van beweging en statuswijziging toe zonder de enige instructie te worden.

Slecht: een ongelabelde speler

Bekijk dit
Een externe iframe wordt automatisch geladen onder de kop. De poster is een zwart frame, er verschijnt geen duur, ondertiteling is door de provider gegenereerd en niet gecontroleerd, en de pagina bevat geen transcript of samenvatting.

De slechte versie laat elke niet-kijkende lezer raden. Het geeft extractors geen onderwerp, vraagt privacybewuste lezers om contact op te nemen met een provider voordat ze afspelen kiezen, biedt geen duurzame tekst wanneer de opname verdwijnt, en kan onjuiste ondertiteling als feit presenteren. Herstel het met een specifieke titel en samenvatting, een doordachte poster, duur, toestemmingsbewust laden, gecontroleerde ondertiteling, een volledig lokaal transcript en een geschreven taak of bewering buiten de speler.

Schema-markup en toegankelijkheid

Inline-video creëert niet automatisch een schema-recht. Gebruik VideoObject alleen wanneer de pagina zichtbaar nauwkeurige name, description, thumbnailUrl, uploadDate, duration en contentUrl- of embedUrl-waarden levert voor de toegankelijke opname. Verzin nooit velden om een validator tevreden te stellen of markeer een decoratieve clip als primaire video.

Een relevante video kan een in aanmerking komend Article, HowTo of Product ondersteunen wanneer de pagina onafhankelijk kwalificeert. Het transcript kan geen beweringen of stappen rechtvaardigen die afwezig zijn op de zichtbare pagina.

Toegankelijkheid begint vóór het afspelen. Label de figuur, toon titel en duur in tekst en geef bedieningselementen toetsenbordbediening en zichtbare focus. Nooit automatisch afspelen. Zorg voor pauze, zoeken, volume, snelheid, ondertiteling en volledig scherm. Zet focus niet vast in een externe speler; keer na het sluiten van volledig scherm terug naar het initiërende bedieningselement.

Ondertiteling moet gesynchroniseerd, van interpunctie voorzien en gecontroleerd zijn tegen de opname. Identificeer sprekers wanneer de stem niet duidelijk is en neem betekenisvolle geluiden op zoals ‘[meldingsgeluid]’ wanneer ze het begrip beïnvloeden. Audiodescriptie is vereist wanneer betekenisvolle visuele informatie niet in de hoofdaudio wordt vermeld; een beschrijvend transcript alleen maakt de getimede kijkervaring niet gelijkwaardig.

Het transcript moet echte HTML in logische volgorde zijn—geen canvas, alleen-afspeelinhoud, verborgen tekst of een alleen-PDF-download. Openbaarmakingsbedieningen hebben een toegankelijke naam en uitgevouwen status nodig. Speler en transcript moeten werken bij 200% zoom en smalle breedtes zonder horizontaal scrollen op paginaniveau.

Schrijfregels

De woorden rond de speler bepalen of de video een inhoudselement is of een onverklaard object:

• Schrijf een specifieke titel van 4–12 woorden. Benoem de taak, demonstratie, spreker, gebeurtenis of bevinding; gebruik nooit alleen ‘Video’, ‘Bekijk dit’ of ‘Meer informatie’.
• Schrijf één samenvattende zin van 15–35 woorden die de lezer vertelt wat er gebeurt en waarom het belangrijk is. Herhaal de titel niet.
• Houd inline-opnamen gefocust en normaal gesproken onder de vijf minuten. Het harde maximum is 20 minuten; langere opnamen horen op een speciale pagina of hebben redactionele segmentatie nodig.
• Toon de duur vóór het afspelen. Gebruik M:SS voor zichtbare tekst en ISO 8601, zoals PT1M30S, in gestructureerde velden.
• Kies een poster die het onderwerp weergeeft op normaal weergaveformaat. Vermijd lege frames, spinners, toevallige gezichtsuitdrukkingen, misleidende afspeelknoppen, kleine interfacetekst en niet-goedgekeurde persoonlijke of klantgegevens.
• Controleer ondertiteling tegen de definitieve montage. Corrigeer namen, productlabels, getallen, domeinterminologie, interpunctie, sprekerswisselingen en betekenisvolle geluiden.
• Transcribeer alle betekenisvolle spraak en beelden. Samenvattingen, hoofdstuktitels en automatisch gegenereerde ondertitelingsbestanden vervangen het transcript niet.
• Gebruik korte transcriptalinea’s, sprekerlabels waar nodig en tijdsbereiken rond procedurele fasen of onderwerpwisselingen. Verzin geen citaten uit geparafraseerde spraak.
• Vermeld bewerkingen die de interpretatie kunnen veranderen. Splits een getuigenis, experiment of demonstratie niet zo dat de volgorde een niet-ondersteund resultaat impliceert.
• Houd essentiële instructies, prijzen, waarschuwingen, voorwaarden voor geschiktheid, bewijs en calls-to-action buiten de opname. Een lezer mag niet door een tijdlijn moeten scrollen om een belangrijk feit te vinden.
• Plaats nooit automatisch afspelen, flitsende inhoud, achtergrondaudio, conversie-overlays, afgeschermde transcriptvelden of een tweede speler in het element.
• Registreer de media-eigenaar en de aanleiding voor controle. Controleer de video opnieuw wanneer de interface, het beleid, het productgedrag, de toeschrijving van de spreker of de omringende bewering verandert.

Posttypes die het gebruiken

De postTypes-frontmatter-array drijft deze matrix aan. Opname staat inline-video toe wanneer tijdgebaseerd bewijs betekenis toevoegt; het vereist geen speler op elke pagina.

QA-checklist

• De video voegt tijdgebaseerde betekenis toe die een stilstaand beeld en beknopt proza niet zo goed kunnen overbrengen.
• De zichtbare titel benoemt de opname specifiek, en de samenvatting legt de waarde ervan uit vóór het afspelen.
• Duur verschijnt voordat de lezer de speler activeert.
• De poster is representatief, leesbaar, goedgekeurd en vrij van privé- of misleidende inhoud.
• Het afspelen start nooit automatisch, herhaalt niet onverwacht en produceert geen geluid zonder actie van de lezer.
• Afspelen, pauzeren, zoeken, volume, snelheid, ondertiteling en volledig scherm werken met toetsenbord en aanraking.
• Ondertiteling komt overeen met de definitieve montage en behoudt correct namen, getallen, sprekerswisselingen en betekenisvolle geluiden.
• Betekenisvolle beelden die niet in spraak worden overgebracht, krijgen audiodescriptie of een gelijkwaardige alternatieve versie.
• Het volledige transcript is selecteerbare HTML, volgt de volgorde van de opname en beschrijft noodzakelijke visuele handelingen.
• Geschreven instructies, waarschuwingen, voorwaarden, bewijs en calls-to-action blijven beschikbaar buiten de video.
• Het laden van externe providers volgt de toepasselijke toestemmingsregels en de provider wordt geïdentificeerd vóór activering.
• De speler, het label en het transcript blijven één semantische figuur en worden niet onderbroken door niet-gerelateerde inhoud.
• Het element is niet genest in een tabel, lijst, callout, tab, carrousel, accordeonpaneel of klikbare container.
• De opname en het transcript werken bij 200% zoom, smalle breedtes, verminderde beweging en zonder alleen-JavaScript-betekenis.
• Eventuele VideoObject-velden komen overeen met zichtbare, verifieerbare mediametagegevens en de toegankelijke opname.
• Het geselecteerde posttype verschijnt in postTypes en de plaatsing komt overeen met de bovenstaande matrix.
• De media-eigenaar, rechten, opnamedatum en voorwaarden voor controle of vervanging zijn geregistreerd.

FAQ

Heeft elke inline-video een transcript nodig?

Ja. Ondertiteling dient voor gesynchroniseerd afspelen; het transcript dient voor lezen, scannen, zoeken, vertalen, citeren, toegankelijkheid en extractie. Het moet de volledige betekenisvolle inhoud bevatten, inclusief visuele handelingen die spraak niet uitlegt.

Mag de posterframe de videotitel bevatten?

Ja, maar dezelfde identificerende informatie moet ook in HTML-tekst verschijnen. Posterstekst kan onleesbaar zijn op een klein scherm, niet beschikbaar wanneer afbeeldingen falen en ontoegankelijk voor software die geen pixels interpreteert.

Moet een inline-video automatisch afspelen?

Nee. Automatisch afspelen verbruikt data, onderbreekt het lezen, introduceert ongevraagde beweging of geluid en ontneemt de lezer de keuze over wanneer te beginnen. Start alleen na een expliciete activering.

Zijn ondertiteling en een transcript hetzelfde?

Nee. Ondertiteling is getimed op het afspelen en bevat relevante geluidssignalen. Een transcript is een duurzaam leesalternatief, georganiseerd in de volgorde van de opname en verrijkt met noodzakelijke beschrijvingen van betekenisvolle beelden.

Heeft een inline-video VideoObject-schema nodig?

Nee. Voeg VideoObject alleen toe wanneer nauwkeurige zichtbare metagegevens en een stabiele opname dit ondersteunen. Een speler zonder betrouwbare naam, beschrijving, poster, uploaddatum, duur en media-URL mag geen onvolledige of verzonnen markup genereren.