Skrypty i popup

[ Strona główna ] [ Do góry ] [ Praktyczny przykład ] [ Pierwsze archiwum ] [ Rozszerzanie projektu ] [ Archiwum i źródła ]

 

Strona główna
Do góry

W dokumentach HTML Help stosuje się niekiedy dynamiczne elementy w postaci tzw. okienek popup i rozwijanych fragmentów tekstu. Są one oparte na skryptach JavaScript i kontrolce HTML Help. Elementy takie są wygodne szczególnie wtedy, gdy z jakichś względów nie chcemy przeładować ekranu nadmiarem informacji - użytkownik aktywizuje ją dopiero kliknięciem na odsyłaczu.

Okienko popup

Przykład takiego okienka mogliśmy już zaobserwować na stronie głównej poradnika. Jego przykładowy kod jest następujący:

<A HREF="JavaScript:hhctrl.TextPopup('Treść okienka popup.','Verdana,8',10,10,00000000,0x00ffff)">
Tutaj trzeba kliknąć</A>

<OBJECT
CLASSID="clsid:ADB880A6-D8FF-11CF-9377-00AA003B7A11"
ID="hhctrl"
WIDTH="0"
HEIGHT="0"
BORDER="0"
VSPACE="0"
HSPACE="0" TYPE="application/x-oleobject">
</OBJECT>

I efekt:

Tutaj trzeba kliknąć

<Object> można umieścić także w ramach HEAD.

Oto znaczenie parametrów - proszę zwrócić uwagę na apostrofy i przecinki oraz kolejność wartości.

Verdana to treści skryptu to oczywiście czcionka, za pomocą której będzie wyświetlana treść okienka.

Wartość 8 oznacza wielkość czcionki.

Pierwsza wartość 10 to boczne marginesy okienka, czyli odległość od brzegu do treści. Druga wartość 10 to górny i dolny margines.

Przykład z innymi marginesami

Kolejne wartości oznaczają odpowiednio kolory czcionki i tła:

Zmienione tło i czcionka

Poniższa tabela przyda się zapewne tym wszystkim autorom, którzy nie mają czasu na eksperymentowanie z kolorami. Przedstawia ona 16 podstawowych kolorów.

Black 00000000     
Yellow 0x00ffff     
Red 0x0000ff     
Lime 0x00ff00     
Blue 0xff0000     
Maroon 0x000080     
Green 0x008000     
Navy 0x800000     
Gray 0x808080     
White 0xffffff     
Fuchsia 0xff00ff     
Aqua 0xffff00     
Purple 0x800080     
Olive 0x008080     
Teal 0x808000     
Silver 0xc0c0c0     

I na zakończenie...

WinHelp popup

Kontrolka HTML Help, opisana w jednym z poprzednich rozdziałów, pozwala tworzyć także okienka popup wyświetlające zawartość plików pomocy w starszym formacie WinHelp. Zaletą takich okienek jest możność wykorzystania wcześniej sporządzonych plików pomocy, a także formatowanie bogatsze niż w przypadku zwykłych tekstowych okienek popup.

W części nagłówkowej dokumentu należy umieścić kod kontrolki, np.

 <object id="whpopup1" type="application/x-oleobject"
        classid="clsid:adb880a6-d8ff-11cf-9377-00aa003b7a11">
    <param name="Command" value="WinHelp, Popup">
    <param name="Item1" value="whpopup.hlp">
    <param name="Item2" value="popup1">
</object>

natomiast skrypt wywołujący plik w postaci popup ma postać:

<a href="JavaScript:whpopup1.Click()">Click here</a>

Kliknij tutaj, aby wyświetlić zawartość pliku pomocy (mogą być kłopoty z wyświetleniem online).

Aby włączyć plik WinHelp, trzeba znać jego identyfikator, co nie jest takie proste. W tym przykładzie skorzystaliśmy z gotowego przykładu zawartego w materiale HTML-based Help Tips.

ToolTip popup

Innym typem okienek popup są okienka ToolTip popup, czyli pokazywane po przesunięciu myszki nad odsyłacz:

Przesuń tutaj myszkę, aby zobaczyć okienko z podpowiedzią ToolTip.

<a href="#null" title="Oto przykład okienka ToolTip.&#10;
Okienka takie znikają po kilku sekundach.
Nie możesz zmienić tego czasu ani formatować tekstu.">Przesuń tutaj myszkę</a>,
aby zobaczyć okienko z podpowiedzią ToolTip.

Kod &#10 pozwala łamać wiersz.

Rozwijane obszary

Rozwijane obszary są oparte na dynamicznym HTML. Ich bazą są skrypty JavaScript. Rozmaite firmy stosują własne rozwiązania, a w tym miejscu przedstawimy "oficjalny" skrypt, zalecany przez dokumentację HTML Help Workshop.

W obszarze HEAD należy umieścić skrypt o postaci

<script language="JavaScript">
<!--
function doSection (secNum){
//display the section if it's not displayed; hide it if it is displayed
if (secNum.style.display=="none"){secNum.style.display=""}
else{secNum.style.display="none"}
}
function noSection (secNum){
//remove the section when user clicks in the opened DIV
if (secNum.style.display==""){secNum.style.display="none"}
}
--> 
</script>

Funkcja doSection odpowiada za rozwijanie obszaru, natomiast noSection - za jego zwijanie, co następuje po ponownym kliknięciu na odsyłaczu lub obszarze.

W ciele dokumentu, w miejscu wystąpienia dynamicznego obszaru, umieszczamy skrypt o przykładowej postaci:

<a onclick="doSection(identyfikator)" class="anchorclass"
href="#nowhere">Wita Was zwierz...</a>

<DIV CLASS="ramka" ID="identyfikator" STYLE="display: none" onclick="noSection(identyfikator)"> 

<b>... o imieniu Kitty</b><br>
<img src="IMAGES/KITTY.GIF" width="100" height="150">

Wita Was zwierz...

 

Zwróćmy uwagę na wyraz identyfikator, który powtarza się w skrypcie, w funkcji doSection, noSection i w ID. Gdybyśmy wstawiali więcej takich rozwijanych obszarów, każdemu skryptowi należałoby przypisać odmienny identyfikator.

Zastosowana klasa class=ramka może być opisana za pomocą stylów, zagnieżdżonych np. w części nagłówkowej HEAD, dzięki czemu możemy całkowicie zmienić wygląd rozwijanej sekcji zawartej w DIV.

Wita Was zwierz...

 

Jak więc widać, można swobodnie manipulować postacią zarówno okienek popup, jak i obszarów wyświetlanych za pomocą dynamicznego HTML. W rozmaitych sytuacjach ich stosowanie może się okazać przydatne - można sobie wyobrazić archiwum z materiałami językowymi, gdzie w obszar rozwijany zawiera np. tłumaczenie jakiegoś zwrotu i kontrolkę Windows Media Playera z nagraniem dźwiękowym (sprawdziłem, działa).

[Tutaj można pobrać przykładowy plik z nagraniami językowymi. Ze względu na prawa autorskie, jest to jedynie próbka 15 z 900 zdań kursu English 901 (wyd. Macmillan), mająca wyłącznie demonstracyjny charakter: 901.chm - 67 KB.]