Spis treści (pasek boczny) książki pomocy aplikacji Cocoa

Question

Jestem w trakcie budowania książki pomocy dla mojej aplikacji, głównie z wykorzystaniem dokumentacji Apple here, jednak wydaje się być trochę przestarzały. W Yosemite OS X 10.10, własne aplikacje apple posiada składanego pasek boczny, który wyświetla spis treści za pomoc wiązki

Mimo, przycisk Pasek boczny jest obecny na moim app nie mam pojęcia, jak aby uzyskać do niego dostęp. Czy ktoś wie, jak uzyskać dostęp do tego paska bocznego? i udostępniać treści dla naszych własnych aplikacji?

Answer 1

Właśnie natknąłem się na ten sam problem i musiałem przeglądać pliki pomocy Apple Mail, aby dowiedzieć się, z czego korzystają. Zasadniczo skonstruowali swój pasek boczny w HTML/CSS, a nie są częścią przeglądarki pomocy.

Aby włączyć „Spis treści” przycisku w przeglądarce pomocy, należy użyć funkcji javascript:

window.HelpViewer.showTOCButton(bool, function, function); 

Dla bardziej wyraźnej przykład następujący fragment kodu umożliwi „Spis treści "przycisk w przeglądarce pomocy Apple i połączyć go z funkcją" toggleNavigation ".

if ("HelpViewer" in window && "showTOCButton" in window.HelpViewer) { 

    window.setTimeout(function() { 
     window.HelpViewer.showTOCButton(true, toggleNavigation, toggleNavigation); 
     window.HelpViewer.setTOCButton(true); 
    }, 100); 
} 

Funkcja przełączaniaNavigation będzie zawierała kod otwierający pasek boczny.

function toggleNavigation() { 
    // YOUR CODE HERE 
} 

Okazało się, że za pomocą window.onload nie wydaje się działać, ale ustawienie timeout dla 100ms zrobił. W programie Mail firma Apple użyła ich odpowiednika funkcji "toggleNavigation" dla obu parametrów funkcji, zgodnie z przykładem. Trzeci parametr jest wywoływany po naciśnięciu przycisku "Spis treści", ale nie wiem, do czego służy ten drugi.