Przejdź do treści

Wzorce

Obrazy i lightbox

Obraz z treści każdej strony Skribly otwiera się duży w oknie. Czytelnik może przybliżyć zrzut ekranu, przejść po grupie takich obrazów i wrócić na stronę dokładnie tam, gdzie był. Ten sam wygląd daje jeden komponent Reacta i jeden mały skrypt.

Co wybraćLink do sekcji Co wybrać

  • Zwykła strona albo strona w Astro. Nic nie rób: skrypt zestawu witryn sam obejmuje każdy obraz z treści w main.
  • Aplikacja w Reakcie. Użyj Lightbox i sam trzymaj stan otwarcia oraz numer obrazu.

Na stronie: nic do napisaniaLink do sekcji Na stronie: nic do napisania

PageLayout dołącza skrypt. Zamienia on obraz w main w przycisk otwierający okno, z tekstem alternatywnym w nazwie.

  • Figury o wspólnym rodzicu otwierają się jako grupa.
  • data-sk-lightbox-group na dowolnym elemencie grupuje obrazy w środku.
  • data-sk-full na obrazie wskazuje większy plik niż pokazany.

Skrypt pomija te obrazy, tak samo jak atrybut poniżej:

  • obrazy w linku lub przycisku, bo już coś robią;
  • obrazy ozdobne z pustym alt oraz nagłówek, stopkę i nawigację;
  • wszystko w data-sk-lightbox="off" lub z tym atrybutem.
Znacznik

Pierwszy obraz otwiera się w lightboxie, drugi nie.

html
<figure>
  <img src="/shots/editor.webp" alt="Edytor z otwartym szkicem" />
  <figcaption>Edytor</figcaption>
</figure>

<img src="/logo-wall.webp" alt="Logotypy" data-sk-lightbox="off" />

W ReakcieLink do sekcji W Reakcie

Lightbox
tsx
<Lightbox images={images} index={index} onIndexChange={setIndex} isOpen={open} onOpenChange={setOpen} labels={labels} />

Każdy tekst jest etykietą, także pozycja i nazwy miniatur, więc aplikacja zachowuje własne pliki językowe.

SterowanieLink do sekcji Sterowanie

Co robi czytelnik, jak i co z tego wynika
CzynnośćJakUwaga
ZamknięciePrzycisk zamknięcia, Escape, kliknięcie tłaFokus wraca na obraz, który otworzono
PowiększeniePrzyciski plus i minus, klawisze + i -, kółko myszy, szczypnięcie, dwukrotne kliknięcie lub dotknięcieZero albo przycisk zerowania wraca do całego obrazu
PrzesuwaniePrzeciąganie albo klawisze strzałek przy powiększeniuObraz nie opuści ekranu
Poprzedni i następnyPrzyciski ze strzałkami, klawisze strzałek w lewo i w prawo, machnięcie na telefonieHome i End przechodzą do pierwszego i ostatniego obrazu
SkokRząd miniatur na doleBieżąca miniatura ma aria-current

Pisanie tekstu alternatywnegoLink do sekcji Pisanie tekstu alternatywnego

Obraz jest tym, co widzi czytelnik

alt="Edytor z otwartym szkicem i spisem treści po lewej"
Rób tak. Napisz, co pokazuje obraz. Okno powtarza to jako nazwę obrazu.
alt="zrzut ekranu"
Nie rób tak. Słowo nazywające typ pliku nic nie mówi, a podpis go nie zastąpi.

DostępnośćLink do sekcji Dostępność

  • Okno modalne z nazwą; fokus zaczyna na przycisku zamknięcia, zostaje w środku i wraca na obraz.
  • Każde sterowanie to przycisk z nazwą, a powiększanie i strzałki działają z klawiatury.
  • Pozycja jest odczytywana uprzejmie, gdy się zmienia.
  • Okno używa tokenów motywu, więc jest poprawne w trzech motywach i w wymuszonych kolorach.
  • Przy ograniczonym ruchu zanikają rozjaśnienie i animacja powiększenia.

Budowane z celem WCAG 2.2 AA.

Szukaj na stronie

Strzałki przenoszą między wynikami, Enter otwiera, Esc zamyka. Ctrl K /