Cocoa App帮助手册的目录(侧栏)

Question

我正在为我的应用程序构建一本帮助手册,主要是在这里使用苹果的文档,但它看起来有点过时了.在Yosemite OS X 10.10中,apple自己的应用程序有一个可折叠的侧栏,显示帮助包的目录

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

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 毫秒。在邮件中，Apple 对两个函数参数都使用了等效的“toggleNavigation”函数，如示例所示。当您按下“目录”按钮时会调用第三个参数，但我还没有弄清楚第二个参数的用途。