Sommario (barra laterale) per la Guida di App Cocoa

Question

Sto preparando un libro di aiuto per la mia applicazione, utilizzando principalmente la documentazione di Apple here, tuttavia sembra un po 'datato. In Yosemite OS X 10.10, proprie applicazioni di Apple hanno una barra laterale pieghevole che consente di visualizzare la tabella dei contenuti per l'aiuto fascio

Anche se, il tasto barra laterale è presente sul mio app non ho idea di come per accedervi. Qualcuno sa come accedere a questa barra laterale? e fornire contenuti per le nostre app?

Answer 1

Ho appena affrontato lo stesso problema e ho dovuto scavare nei file della guida di Apple Mail per scoprire cosa stavano usando. Fondamentalmente hanno costruito la loro barra laterale in HTML/CSS, e non è una parte del visualizzatore di aiuto.

Per abilitare il "Sommario" pulsante nel visualizzatore della guida, è necessario utilizzare la funzione javascript:

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

Per un esempio più esplicito, il seguente frammento di codice consentirà la "Table of Contents "nel visualizzatore di guida di Apple e collegalo alla funzione" toggleNavigation ".

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

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

La funzione di toggleNavigation conterrà il codice per aprire la barra laterale.

function toggleNavigation() { 
    // YOUR CODE HERE 
} 

ho trovato che l'uso di window.onload non sembra funzionare, ma l'impostazione di un timeout per 100ms ha fatto. In Mail, Apple ha utilizzato l'equivalente della funzione "toggleNavigation", per entrambi i parametri di funzione, come nell'esempio. Il terzo parametro viene chiamato quando si preme il pulsante "Sommario", ma non ho capito a cosa serva il secondo.