Imagini

Dialog de alertă

Dacă o imagine este mai lată decât coloana principală de conținut - așa cum se întâmplă adesea pe ecranele mai mici - DevSite o constrânge automat la lățimea coloanei. Cu toate acestea, dacă imaginea are setate atât atributele width cât și height , numai lățimea este redimensionată, determinând distorsionarea imaginii. În consecință, nu setați height imaginii . Aceasta înseamnă că pagina se poate redesena dacă imaginea se încarcă lent (care provoacă un salt), dar este mai bine decât o imagine care nu se potrivește pe ecran.

Puteți aplica class="screenshot" unei imagini pentru a-i oferi un chenar care să o depășească față de textul din apropiere. Acesta este de obicei folosit pentru capturi de ecran care au fundal alb și se pierd altfel pe pagină. Nu-l utilizați pentru imagini care nu au nevoie de el.

Plutitoare lângă text

Imaginea din dreapta are, de asemenea, class="attempt-right" , care plutește imaginea chiar pe ecrane mai mari, dar forțează imaginea în aspect vertical pe ecrane mai mici, tablete și mai mici, unde plutirea în dreapta ar cauza probleme. De asemenea, este disponibil class="attempt-left" . Pentru a utiliza împreună attempt-left și attempt-right , asigurați-vă că elementul attempt-left este primul.

Când imaginile plutesc, acestea nu pot depăși 50% din lățimea coloanei. Dacă ar fi, acestea sunt redimensionate.

<img src="/path/to/image.png" alt="Alert dialog"
     class="screenshot attempt-right">

Puteți folosi aceleași clase pentru a pluti alte elemente, cum ar fi o <figure> care conține atât o imagine, cât și o legendă:

<figure class="attempt-right">
  <img src="/path/to/image.png" alt="Alert dialog" class="screenshot">
  <figcaption><b>Figure 1</b>: Alert dialog</figcaption>
</figure>

Stergerea textului flotant

Pentru a preveni încadrarea textului în jurul unui element flotant și afișarea la lățimea sa nativă, puteți adăuga o clasă clear elementelor afectate care urmează elementului flotant.

<p class="clear">Hello world.</p>

Exemplu cu clasa clară

În acest exemplu, al doilea paragraf include o clasă clear .

Dialog de alertă

Acest paragraf se înfășoară în jurul imaginii plutitoare . Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.

Acest paragraf are o clasă clară și nu se înfășoară în jurul imaginii plutitoare . Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed quia consequuntur magni dolores eos qui ratione voluptatem sequi nesciunt. Neque porro quisquam est, qui dolorem ipsum quia dolor sit amet, consectetur, adipisci velit, sed quia non numquam eius modi tempora incidunt ut labore et dolore magnam aliquam quaerat voluptatem.

Exemplu fără clasa clară

În acest exemplu, ambele paragrafe se înfășoară în jurul imaginii plutitoare.

Dialog de alertă

Acest paragraf se înfășoară în jurul imaginii plutitoare . Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.

Acest paragraf se înfășoară în jurul imaginii plutitoare . Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed quia consequuntur magni dolores eos qui ratione voluptatem sequi nesciunt. Neque porro quisquam est, qui dolorem ipsum quia dolor sit amet, consectetur, adipisci velit, sed quia non numquam eius modi tempora incidunt ut labore et dolore magnam aliquam quaerat voluptatem.

Imagini cu tema întunecată

DevSite oferă un set mic de nume de clasă care pot fi aplicate imaginilor pentru a le modifica aspectul atunci când tema întunecată este activată.

Întunecarea imaginii

În mod implicit, toate imaginile, cu excepția fișierelor SVG, sunt ușor întunecate în tema întunecată.

Pentru a elimina întunecarea implicită dintr-o imagine când tema întunecată este activată, adăugați o clasă fără filtru la imagine:

<img src="/path/to/image.jpg" class="no-filter" alt="">

Inversarea unei imagini

Pentru imagini cu o paletă de culori neagră sau monocromă închisă, adăugați o clasă invert imaginii pentru ca aceasta să afișeze o temă alb/luminoasă în întuneric:

<img src="/site-assets/logo-github.png" class="invert" alt="">

Pentru o pagină _index.yaml , adăugați invert la câmpul classname pentru un element rând:

- items:
  - classname: invert
    icon:
      path: /site-assets/logo-github.png

Separați imaginea variantă a temei întunecate

Dacă doriți să furnizați o imagine separată care se afișează numai când este activată tema întunecată, înfășurați elementul <img> existent într-un element <picture> și adăugați un element <source> pentru varianta temei întunecate.

În exemplul de mai jos, există două fișiere SVG pentru marca de cuvânt Google într-un element <picture> . Când tema întunecată este dezactivată, este afișat fișierul imagine din elementul <img> , arătând marca de cuvânt cu cele patru culori ale mărcii Google. Când tema întunecată este activată, este afișat fișierul imagine din elementul <source> , unde marca de cuvânt este în întregime albă și nu are culori de marcă.

Exemplu

Cod

<picture>
  <source
    srcset="/devsite/images/google-dark-theme.svg"
    media="(prefers-color-scheme: dark)"
    class="devsite-dark-theme"
    alt="">
  <img src="/devsite/images/google.svg" alt="">
</picture>

Note

Deoarece tema întunecată este activată în spatele unui semnalizator de caracteristică, rețineți următoarele despre atributele elementului <source> :

Elementul <source> trebuie să includă o clasă devsite-dark-theme , care oferă un cârlig pentru interfața DevSite pentru a actualiza atributul media și valoarea acestuia în funcție de opțiunea de temă întunecată selectată de utilizator: light , dark sau device . Atributul media trebuie să includă o interogare media (prefers-color-scheme: dark) în valoarea sa. Dacă aveți deja elemente <source> cu interogări media în atributul media, fie adăugați interogările media existente cu și (prefers-color-scheme: dark) sau adăugați un nou element <source> a cărui valoare a atributului media este (prefers-color-scheme: dark) . Interogarea media și valoarea acesteia vor fi eliminate sau înlocuite în funcție de opțiunea de temă întunecată selectată de utilizator. În timp ce numele de fișier al imaginii variantei temei întunecate din atributul srcset poate fi orice, din punct de vedere tehnic, se recomandă adăugarea -dark-theme la numele fișierului imaginii existente.