为什么 Dojo API 不包含特定类型的所有相关命令？（我将在下面更好地描述。）

Question

举个例子，"dijit/layout/ContentPane"。在我在网上找到并一直在操作的示例代码中，它出现在 new ContentPane():

的正文中

new ContentPane({
     region: "top",
     "class": "edgePanel",
     content: "Header content (top)"
 })

我的问题是关于为什么在 Dojo API 中从未提及 ContentPane 的术语 "region"。还有其他这样的例子。

这是另一个例子：

new ContentPane({
    region: "left",
    id: "leftCol", "class": "edgePanel",
    content: "Sidebar content (left)",
    splitter: true
})

"splitter" 从未在 Dojo 的 ContentPane API 中提及。据我所知，从 API，我什至不知道我可以为新的 ContentPane 指定 "splitter: true"。

所以我的最后一个问题是：有没有什么地方可以找到所有类型，例如 "region"，它属于给定函数？如果我没有在网上找到这段代码，我怎么知道我需要使用 "region: "top"" 来指定？

谢谢大家。

Answer 1

BorderContainer 区域可以容纳各种小部件，而不仅仅是 ContentPanes，因此在特定 class 上记录它们并不理想。同时，这些属性仅对 BorderContainers 的子项有意义（例如，不是 BorderContainers 的子项的 ContentPanes）。

BorderContainer API docs 专门为子控件属性的文档调出了这个单独的位置：

See BorderContainer.ChildWidgetProperties for details on the properties that can be set on children of a BorderContainer.

请注意，StackContainer 子控件属性有一个 similar dedicated page（这也适用于 TabContainer 和 AccordionContainer，因为它们扩展了 StackContainer）。

reference guide 中的 BorderContainer 示例还包括 region 和 splitter 属性（尽管他们没有特别解释它们）。

小部件布局教程在 section on BorderContainer 中对区域进行了相当详尽的解释。

Why does the Dojo API not include all related commands for specific types? (I'll describe better below.)