Javascript AngularJS语法——John Papa的可绑定顶层语法不明确

我正在阅读这个优秀的造型指南。在列表的下方，他谈到了“可绑定成员在顶部”

引用他的例子，他说要避免这种情况：

用这个来代替：

虽然这是非常干净的，但它带来了一个问题。如果你的函数有参数呢？假设在上面的示例中，函数搜索得到一个查询：function searchstr。为了能够以一行的形式完成这项工作，他推荐的是：

function Sessions() {
    var vm = this;

    vm.search = search;

    //////////

    function search(str) {

    }

问题是，当您查看顶部的vm.search=search时，您不确定传递给函数的是什么，您需要向下滚动到函数searchstr才能找到答案

有人能为我详细介绍一下吗

编辑

---

我要求约翰自己对此作出回应

您的IDE应该能够处理这个问题，或者您可以使用接口在类本身中保持一个最高级和干净的实现

---

如果你也使用c/asp.net，我建议你使用VisualStudio，否则我建议你使用WebStorm。WebStorm非常便宜，是Web工作的优秀编辑器。Sublime可能也有一些插件。

这是一个好问题，但我不确定堆栈溢出是否是获得答案的最佳地方。在过去，我们曾遇到过类似于您的关于样式指南的问题，发现如果您对他的样式指南回购提出异议，他会回答。@user1545858，好的，谢谢。我会提出一个问题，看看他怎么说。没问题。我对答案很感兴趣，所以如果您可以在这里重新发布或放置该问题的链接，我们将不胜感激。@user1545858，给您。我用链接更新了问题！所以基本上你是说我应该使用像jsDoc这样的文档来定义传递给搜索的内容？我没有使用jsDoc，但是如果它允许你提示参数，那么是的，应该可以。理想情况下，您的IDE能够推断什么是搜索以及它需要什么参数。因此，如果您使用特定的编辑器查看代码，编写一个可以理解的代码通常不是一个好主意。一个好的代码应该有很好的文档记录和编写，这样即使是一个简单的记事本也可以用来阅读it@Kousha当然可以，但是不需要编辑器，您可以很容易地一目了然地看到该文件有哪些可用的方法。使用IDE对该方法进行新调用并了解其参数会有很大帮助。或者用Typescript接口或其他方式记录它。Typescript将帮助您完成的不仅仅是文档

/* recommended */
function Sessions() {
    var vm = this;

    vm.gotoSession = gotoSession;
    vm.refresh = refresh;
    vm.search = search;
    vm.sessions = [];
    vm.title = 'Sessions';

    ////////////

    function gotoSession() {
      /* */
    }

    function refresh() {
      /* */
    }

    function search() {
      /* */
    }

function Sessions() {
    var vm = this;

    vm.search = search;

    //////////

    function search(str) {

    }