Cocoa Apps帮助手册的目录（边栏）

Question

我正在为我的应用程序构建帮助手册，主要使用Apple的文档here，但它似乎有点过时了。在Yosemite OS X 10.10中，苹果公司自己的应用程序有一个可折叠的侧栏，显示帮助包的目录

虽然侧边栏按钮出现在我自己的应用程序上，但我不知道如何访问它。有谁知道如何访问这个侧边栏？并为我们自己的应用程序提供内容？

Answer 1

我刚刚遇到同样的问题，我不得不在Apple Mail的帮助文件中挖掘它们以找出它们正在使用的内容。基本上他们已经在HTML / CSS中构建了侧边栏，并且它不是帮助查看器的一部分。

要启用帮助查看器中的“目录”按钮，您需要使用javascript函数：

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

有关更明确的示例，以下代码段将启用Apple帮助查看器中的“目录”按钮，并将其链接到“toggleNavigation”函数。

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

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

toggleNavigation函数将包含打开侧边栏的代码。

function toggleNavigation() {
    // YOUR CODE HERE
}

我发现使用window.onload似乎不起作用，但设置超时100毫秒。在Mail中，Apple根据示例使用等效的“toggleNavigation”函数作为两个函数参数。按下“目录”按钮时会调用第三个参数，但我没有弄清楚第二个参数是什么。