Afbeeldingscomponent image-component
De component Core Component Image is een adaptieve afbeeldingscomponent.
Gebruik usage
De component Afbeelding biedt een adaptieve selectie van afbeeldingen en een responsief gedrag bij het lui laden van de pagina voor de bezoeker van de pagina en bij het eenvoudig plaatsen van de afbeelding voor de auteur van de inhoud.
De auteur van de inhoud kan de dialoogvenster bewerken om het afbeeldingselement te bewerken, zoals een uitsnijding toepassen of de afbeelding roteren.
De breedte van de afbeelding en aanvullende instellingen kunnen door de sjabloonauteur worden gedefinieerd in het dialoogvenster ontwerpdialoogvenster. De inhoudeditor kan elementen uploaden of selecteren in het dialoogvenster configureren.
Versie en compatibiliteit version-and-compatibility
De huidige versie van de Image Component is v3, die in februari 2022 is geïntroduceerd met versie 2.18.0 van de Core Components, en die in dit document wordt beschreven.
In de volgende tabel staan alle ondersteunde versies van de component, de AEM versies waarmee de versies van de component compatibel zijn en koppelingen naar documentatie voor vorige versies.
Raadpleeg het document voor meer informatie over versies en releases van de Core Component Versies van kerncomponenten.
Responsieve functies responsive-features
De component Image wordt geleverd met robuuste responsieve functies die direct uit de verpakking kunnen worden geleverd. Op het niveau van het paginasjabloon ontwerpdialoogvenster kan worden gebruikt om de standaardbreedten van het afbeeldingselement te definiëren. De component Afbeelding laadt automatisch de juiste breedte om weer te geven, afhankelijk van de grootte van het browservenster. Wanneer het formaat van het venster wordt gewijzigd, laadt de component Image dynamisch de juiste afbeeldingsgrootte. Componentontwikkelaars hoeven zich geen zorgen te maken over het definiëren van aangepaste mediaquery's, aangezien de component Image al is geoptimaliseerd om uw inhoud te laden.
Bovendien ondersteunt de component Afbeelding lui laden om het laden van het eigenlijke afbeeldingselement uit te stellen totdat het element zichtbaar is in de browser, waardoor de reacties op uw pagina's sneller worden.
Dynamic Media-ondersteuning dynamic-media
De afbeeldingscomponent (vanaf release 2.13.0) ondersteunt Dynamic Media activa. Indien ingeschakeld, Met deze functies kunt u Dynamic Media-afbeeldingselementen toevoegen met een eenvoudige sleepfunctie of via de middelenbrowser, net als met andere afbeeldingen. Daarnaast worden ook afbeeldingsaanpassingen, voorinstellingen voor afbeeldingen en slimme gewassen ondersteund.
Uw webervaringen die zijn gemaakt met Core Components kunnen beschikken over uitgebreide, op Sensei gebaseerde, robuuste, krachtige Dynamic Media Image-mogelijkheden voor meerdere platforms.
Next Generation Dynamic Media Support next-gen-dm
De afbeeldingscomponent (vanaf release 2.23.2) biedt ondersteuning voor externe middelen van de volgende generatie, Dynamic Media.
Eenmaal geconfigureerd, u kunt elementen selecteren uit een externe service van de Next Generation Dynamic Media voor uw afbeeldingscomponent.
SVG-ondersteuning svg-support
Schaalbare vectorafbeeldingen (SVG) worden ondersteund door de afbeeldingscomponent.
- De belemmering-en-daling van een SVG middel van DAM en het uploaden van een SVG dossier dat van een lokaal dossiersysteem wordt geupload worden allebei gesteund.
- Het oorspronkelijke SVG-bestand wordt gestreamd (transformaties worden overgeslagen).
- Voor een SVG-afbeelding worden de "slimme afbeeldingen" en de "slimme formaten" ingesteld op een lege array in het afbeeldingsmodel.
Beveiliging security
Om veiligheidsredenen wordt de originele SVG nooit direct geroepen door de Redacteur van het Beeld. Het wordt doorgeroepen <img src="path-to-component">
. Hierdoor wordt voorkomen dat de browser scripts uitvoert die in het SVG-bestand zijn ingesloten.
Uitvoer van voorbeeldcomponent sample-component-output
Ga voor meer informatie over de component Image en voorbeelden van de configuratieopties en de HTML- en JSON-uitvoer naar de Componentbibliotheek.
Technische details technical-details
De meest recente technische documentatie over de Image Component kan op GitHub worden gevonden.
Meer informatie over het ontwikkelen van kerncomponenten vindt u in de Documentatie voor ontwikkelaars van kerncomponenten.
De component Image ondersteunt schema.org.
Dialoogvenster Bewerken edit-dialog
In het dialoogvenster Bewerken kan de auteur van de inhoud de afbeelding uitsnijden en zoomen.
Afhankelijk van of u de Dynamic Media ingeschakeld of Next Generation Dynamic Media zijn ingeschakeld, zijn er verschillende opties beschikbaar voor het bewerken van afbeeldingen.
Standaard bewerken van bedrijfsmiddelen standard-assets
Als u standaard AEM elementen bewerkt, kunt u op de knop Bewerken in het contextmenu van de afbeeldingscomponent.
-
Uitsnijden starten
Als u deze optie selecteert, wordt een vervolgkeuzelijst geopend voor vooraf gedefinieerde verhoudingen voor uitsnijden.
- Kies de optie Uitsnijden verwijderen om het oorspronkelijke element weer te geven.
Als een uitsnijdoptie is geselecteerd, gebruikt u de blauwe handgrepen om het uitsnijden op de afbeelding te vergroten of te verkleinen.
-
Rechtsom roteren
Gebruik deze optie als u de afbeelding 90° rechtsom wilt roteren.
-
Zoomen herstellen
Als al op de afbeelding is ingezoomd, gebruikt u deze optie om het zoomniveau opnieuw in te stellen.
-
Zoomregelaar openen
Met deze optie geeft u een schuifregelaar weer om het zoomniveau van de afbeelding te bepalen.
U kunt de interne editor ook gebruiken om de afbeelding te wijzigen. Vanwege ruimtebeperkingen zijn alleen de basisopties online beschikbaar. Voor volledige bewerkingsopties gebruikt u de modus Volledig scherm.
Dynamic Media Asset Editing dynamic-media-assets
Als u Dynamic Media-functies ingeschakeld, het bewerken van de afbeelding zelf moet worden uitgevoerd in de middelenconsole.
Dynamic Media Asset Editing van de volgende generatie next-gen-dm-assets
Als u Next Generation Dynamic Media configured, de Slim uitsnijden Deze optie is beschikbaar in de contextmenu's van de component.
In het dialoogvenster kunt u de slimme uitsnijding aanpassen.
Dialoogvenster configureren configure-dialog
De component image biedt een dialoogvenster voor configureren waarin de afbeelding zelf wordt gedefinieerd, samen met de beschrijving en basiseigenschappen.
Tabblad Element asset-tab
-
Weergegeven afbeelding overnemen van pagina - Voor deze optie wordt de optie weergegeven afbeelding van de gekoppelde pagina of de weergegeven afbeelding van de huidige pagina als de afbeelding niet is gekoppeld.
-
Afbeeldingselement - Deze wordt automatisch gevuld als Weergegeven afbeelding overnemen van pagina is geselecteerd. Schakel deze optie uit als u de afbeelding handmatig wilt definiëren door de volgende opties in te stellen.
-
Middelen uit het deelvenster middelenbrowser of tik op doorbladeren zodat u kunt uploaden vanaf een lokaal bestandssysteem.
-
Tik of klik op Wissen om de selectie van de geselecteerde afbeelding op te heffen.
-
Tik of klik op Selecteren om de middelenbrowser zodat u een afbeelding kunt selecteren.
-
Indien Dynamic Media-functies van de volgende generatie zijn ingeschakeld, hebt u meerdere opties voor het kiezen van een element:
- Lokaal selecteert uit de lokale AEM elementenbibliotheek.
- Extern selecteert uit een Dynamic Media-bibliotheek buiten uw AEM-instantie.
-
-
Tik of klik op Bewerken tot de uitvoeringen van het actief beheren in de Asset Editor.
-
-
Alternatieve tekst voor toegankelijkheid - In dit veld kunt u een beschrijving van de afbeelding definiëren voor visueel gehandicapte gebruikers.
- Alternatieve tekst van pagina overnemen - Bij deze optie wordt de alternatieve beschrijving van de waarde van het gekoppelde element van de optie
dc:description
metagegevens in DAM of van de huidige pagina als er geen element is gekoppeld.
- Alternatieve tekst van pagina overnemen - Bij deze optie wordt de alternatieve beschrijving van de waarde van het gekoppelde element van de optie
-
Geen alternatieve tekst bieden - Hiermee markeert u de afbeelding die moet worden genegeerd door ondersteunende hulpmiddelen, zoals schermlezers, wanneer de afbeelding zuiver decoratief is of anderszins geen aanvullende informatie naar de pagina overbrengt.
Tabblad Metagegevens metadata-tab
-
Type voorinstelling - Hiermee worden de typen voorinstellingen voor afbeeldingen gedefinieerd die beschikbaar zijn. Voorinstelling afbeelding of Slim uitsnijden en is alleen beschikbaar wanneer Dynamic Media-functies zijn ingeschakeld.
- Voorinstelling afbeelding - Wanneer Type voorinstelling van Voorinstelling afbeelding is geselecteerd, de vervolgkeuzelijst Voorinstelling afbeelding is beschikbaar, zodat u kunt kiezen uit de beschikbare Dynamic Media-voorinstellingen. Dit is alleen beschikbaar als er voorinstellingen zijn gedefinieerd voor het geselecteerde element.
- Slim uitsnijden - Wanneer Type voorinstelling van Slim uitsnijden is geselecteerd, de vervolgkeuzelijst Vertoning is beschikbaar, zodat u kunt kiezen uit de beschikbare uitvoeringen van het geselecteerde element. Dit is alleen beschikbaar als uitvoeringen zijn gedefinieerd voor het geselecteerde element.
- Afbeeldingsmodificatoren - U kunt hier aanvullende opdrachten voor Dynamic Media-beeldserving definiëren door
&
, ongeacht welke Type voorinstelling is geselecteerd.
-
Bijschrift - Aanvullende informatie over de afbeelding, die standaard onder de afbeelding wordt weergegeven.
- Bijschrift ophalen van DAM - Bij controle wordt de bijschrifttekst van de afbeelding gevuld met de waarde van de optie
dc:title
metagegevens in DAM. - Bijschrift weergeven als pop-up - Als deze optie is ingeschakeld, wordt het bijschrift niet weergegeven onder de afbeelding, maar als een pop-up die door sommige browsers wordt weergegeven wanneer de muisaanwijzer op de afbeelding wordt geplaatst.
- Bijschrift ophalen van DAM - Bij controle wordt de bijschrifttekst van de afbeelding gevuld met de waarde van de optie
-
Koppeling - Koppel de afbeelding aan een andere bron.
- In het dialoogvenster Selecteren kunt u een koppeling maken naar een andere AEM.
- Als u geen koppeling naar een AEM maakt, voert u de absolute URL in. Niet-absolute URL's worden geïnterpreteerd als relatief ten opzichte van AEM.
- Koppeling openen op nieuw tabblad - Met deze optie opent u de koppeling in een nieuw browservenster.
-
ID - Met deze optie kunt u de unieke id van de component bepalen in de HTML en in de Gegevenslaag.
- Als deze leeg blijft, wordt automatisch een unieke id voor u gegenereerd. U kunt deze vinden door de resulterende pagina te inspecteren.
- Als een id is opgegeven, is het de verantwoordelijkheid van de auteur om ervoor te zorgen dat deze uniek is.
- Het wijzigen van de id kan gevolgen hebben voor het bijhouden van CSS-, JS- en gegevenslagen.
Tabblad Stijlen styles-tab-edit
De component Image ondersteunt de AEM Stijlsysteem.
Gebruik de vervolgkeuzelijst om de stijlen te selecteren die u op de component wilt toepassen. Selecties in het dialoogvenster Bewerken hebben hetzelfde effect als de selecties op de werkbalk van de component.
De stijlen moeten voor deze component in worden gevormd ontwerpdialoogvenster voor het keuzemenu beschikbaar te zijn.
Ontwerpdialoogvenster design-dialog
Hoofdtabblad main-tab
-
DM-functies inschakelen - Indien ingeschakeld, Dynamic Media-functies zijn beschikbaar.
- Deze optie wordt alleen weergegeven als Dynamic Media is ingeschakeld in de omgeving.
-
Geoptimaliseerde webafbeeldingen inschakelen - Indien ingeschakeld, de webgeoptimaliseerde service voor het leveren van afbeeldingen biedt afbeeldingen in de WebP-indeling, waardoor de afbeeldingsgrootte gemiddeld met 25% afneemt.
- Deze optie is alleen beschikbaar in AEMaaCS.
- Als deze optie is uitgeschakeld of als de service voor het leveren van afbeeldingen voor het web niet beschikbaar is, wordt de Adaptieve afbeeldingsserver wordt gebruikt.
-
Lazy load uitschakelen - Als deze optie is ingeschakeld, worden alle afbeeldingen vooraf geladen zonder dat dit wordt uitgelijnd.
-
Afbeelding is decoratief - Definieer of de optie Decoratieve afbeelding automatisch wordt ingeschakeld wanneer u de afbeeldingscomponent aan een pagina toevoegt.
-
Alternatieve tekst ophalen van DAM- Definieer of de optie voor het ophalen van de alternatieve tekst van de DAM automatisch is ingeschakeld wanneer u de afbeeldingscomponent aan een pagina toevoegt.
-
Bijschrift ophalen van DAM - Bepaal als de optie om de titel van DAM terug te winnen automatisch wordt toegelaten wanneer het toevoegen van de beeldcomponent aan een pagina.
-
Bijschrift weergeven als pop-up - Definieer of de optie om het bijschrift van de afbeelding als pop-up weer te geven automatisch is ingeschakeld wanneer u de afbeeldingscomponent aan een pagina toevoegt.
-
Breedte wijzigen - Deze waarde wordt gebruikt voor het vergroten of verkleinen van de breedte van de basisafbeeldingen die DAM-elementen zijn.
- De hoogte-breedteverhouding van de afbeeldingen blijft behouden.
- Als de waarde groter is dan de werkelijke breedte van de afbeelding, heeft deze waarde geen effect.
- Deze waarde heeft geen effect op SVG-afbeeldingen.
U kunt een lijst van breedten in pixel voor het beeld bepalen, en de component laadt automatisch de meest aangewezen breedte gebaseerd op browser grootte. Dit is een belangrijk onderdeel van het responsieve functies van de afbeeldingscomponent.
-
Breedten - Definieert een lijst met breedten in pixels voor de afbeelding en de component laadt automatisch de meest geschikte breedte op basis van de browsergrootte.
-
Tik of klik op de knop Toevoegen om een andere grootte toe te voegen.
- Gebruik de handgrepen om de grootte te wijzigen.
- Gebruik de Verwijderen pictogram om een breedte te verwijderen.
-
Het laden van afbeeldingen wordt standaard uitgesteld totdat ze zichtbaar worden.
- Selecteer de optie Lazy load uitschakelen zodat u de afbeeldingen kunt laden wanneer de pagina wordt geladen.
-
-
JPEG-kwaliteit - De kwaliteitsfactor (als percentage van 0 en 100) voor getransformeerde (bijvoorbeeld geschaalde of bijgesneden) JPEG-afbeeldingen.
Tabblad Stijlen styles-tab
De component Image ondersteunt de AEM Stijlsysteem.
Gegevenslaag client-Adobe data-layer
De component Image ondersteunt de Gegevenslaag client Adobe.