Czytnik tekstu

Edycja w trybie z połączeniem

Umożliwia wyświetlanie długich fragmentów tekstu w postaci zwijanego panelu, na którym można przełączać opcję wyświetlania większej lub mniejszej ilości danych.

Powiązanie danych

We właściwościach Ogólne można ustawiać i modyfikować powiązanie danych widoku. Element Czytnik tekstu można przypisać do zmiennej typu String (łańcuch).

Właściwości konfiguracyjne

W obszarze Konfiguracja można ustawić lub zmodyfikować właściwości wyglądu i zachowania widoku.

Wielkość ekranu: Właściwość konfiguracyjna, na której znajduje się ikona Rozmiarów ekranu obok nazwy właściwości, może mieć różne wartości dla każdej wielkości ekranu. Jeśli nie zostanie ustawiona wartość, wielkość ekranu dziedziczy wartość następnej większej wielkości ekranu jako swoją wartość domyślną.

Definicje kompozycji: Definicje kompozycji służą do podawania kolorów i stylów widoku oraz do określania jego wyglądu. W edytorze kompozycji można wyświetlić podgląd wyglądu i zachowania widoku. Patrz Kompozycje.

Właściwości konfiguracyjne wyglądu elementu Czytnik tekstu znajdują się w poniższej tabeli:

Tabela 1. Właściwości konfiguracyjne wyglądu elementu Czytnik tekstu
Właściwość konfiguracyjna wyglądu	Opis	Typ danych
Szerokość	Służy do podawania szerokości widoku, która jest wyrażana w pikselach (px), jako wartość procentowa (%) lub w firetach (em). Na przykład: `50px` lub `20%` lub `0.4em`. Jeśli nie jest podany typ jednostki, domyślnie używana jest jednostka `px` (piksele).	`String`
Wysokość	Służy do podawania wysokości widoku, która jest wyrażana w pikselach (`px`) lub w firetach (`em`). Jeśli nie jest podany typ jednostki, domyślnie używana jest jednostka `px` (piksele).	`String`
Wielkość	Służy do podawania wielkości etykiety i tekstu. domyślna Duża Małe	`String`
Rozmieszczanie etykiet	Służy do podawania położenia etykiety względem tekstu. top Strona lewa: Uwaga: Etykiety po lewej stronie zmieniają określoną szerokość widoku.	`String`
Szerokość etykiety	Szerokość etykiety. Szerokość jest wyrażana w następujących jednostkach: px (piksele), % (wartość procentowa) lub em (firety). Na przykład: 50 px, 20% lub 0,4 em. Jeśli nie jest podana żadna jednostka, domyślnie jest używana jednostka px (piksele).	`String`

Właściwości konfiguracyjne zachowania elementu Czytnik tekstu znajdują się w poniższej tabeli:

Tabela 2. Właściwości konfiguracyjne zachowania elementu Czytnik tekstu
Właściwość konfiguracyjna zachowania	Opis	Typ danych
Maksymalna długość tekstu	Służy do podawania maksymalnej liczby wyświetlanych znaków, po przekroczeniu której jest wyświetlana wskazówka dotycząca opcji Więcej. Jeśli nie podano żadnej liczby lub liczba jest mniejsza niż 1, zostanie użyta wartość domyślna `128`.	`Integer`
Wskazówka dotycząca opcji Więcej	Tekst zastępczy wyświetlany w przypadku wskazówki dotyczącej opcji Więcej.	`String`
Wskazówka dotycząca opcji Mniej	Tekst zastępczy wyświetlany w przypadku wskazówki dotyczącej opcji Mniej.	`String`
Początkowo rozwinięte	Służy do wskazywania, czy sekcja ma być rozwinięta po załadowaniu strony.	`Boolean`
Użyj ikon strzałek	Umożliwia korzystanie z ikon strzałek, które rozwijają i zwijają obszar tekstowy.	`Boolean`

Zdarzenia

We właściwościach Zdarzenia można ustawiać i modyfikować procedury obsługi zdarzeń widoku. Zdarzenia mogą być uruchamiane w sposób programowy lub w wyniku interakcji użytkownika z widokiem. Informacje na temat definiowania zdarzeń i kodu zdarzeń zawiera sekcja Zdarzenia zdefiniowane przez użytkownika.

Element Czytnik tekstu ma następujące typy procedur obsługi zdarzeń:

On load: aktywowano podczas ładowania strony. Na przykład:

if (${DeviceSensor}.getDeviceInfo().isIPhone) {me.setExpanded(false);} else {me.setExpanded(true);}

On click: Aktywacja po kliknięciu widoku. Na przykład:
```
me.toggleExpanded()
```
On expand: Aktywacja po rozwinięcia tekstu przez użytkownika. Na przykład:
```
${TextReader2}.setExpanded(false)
```
On collapse: aktywowano, gdy użytkownik zwinie tekst. Na przykład:
```
${TextReader2}.setExpanded(true)
```

metody

Szczegółowe informacje na temat dostępnych metod dla lektora tekstu można znaleźć w sekcji Interfejs API języka JavaScript programu czytającego tekst.

Zasoby dodatkowe

Więcej informacji na temat sposobu tworzenia formatki lub strony zawiera sekcja Budowanie formatek.
Informacje na temat standardowych właściwości (Ogólne, Konfiguracja, Pozycjonowanie, Widocznośći Atrybuty HTML) można znaleźć w sekcji Właściwości widoku.