How to read React.Children.map api notation?









up vote
0
down vote

favorite












Looking at the code for React.Children.map, it looks like the function takes up to 3 args.



The api doc for React.Children.map shows



React.Children.map(children, function[(thisArg)])



If it can take 3 args I expected to see 2 commas in there somewhere.



My question is



How do you read React.Children.map(children, function[(thisArg)]) in plain english?



So far I have "React.Children.map is a function that..."










share|improve this question



























    up vote
    0
    down vote

    favorite












    Looking at the code for React.Children.map, it looks like the function takes up to 3 args.



    The api doc for React.Children.map shows



    React.Children.map(children, function[(thisArg)])



    If it can take 3 args I expected to see 2 commas in there somewhere.



    My question is



    How do you read React.Children.map(children, function[(thisArg)]) in plain english?



    So far I have "React.Children.map is a function that..."










    share|improve this question

























      up vote
      0
      down vote

      favorite









      up vote
      0
      down vote

      favorite











      Looking at the code for React.Children.map, it looks like the function takes up to 3 args.



      The api doc for React.Children.map shows



      React.Children.map(children, function[(thisArg)])



      If it can take 3 args I expected to see 2 commas in there somewhere.



      My question is



      How do you read React.Children.map(children, function[(thisArg)]) in plain english?



      So far I have "React.Children.map is a function that..."










      share|improve this question















      Looking at the code for React.Children.map, it looks like the function takes up to 3 args.



      The api doc for React.Children.map shows



      React.Children.map(children, function[(thisArg)])



      If it can take 3 args I expected to see 2 commas in there somewhere.



      My question is



      How do you read React.Children.map(children, function[(thisArg)]) in plain english?



      So far I have "React.Children.map is a function that..."







      reactjs






      share|improve this question















      share|improve this question













      share|improve this question




      share|improve this question








      edited Nov 17 at 16:59

























      asked Nov 10 at 19:00









      psalaets

      57025




      57025






















          1 Answer
          1






          active

          oldest

          votes

















          up vote
          0
          down vote













          function[(thisArg)] isn't a standard denotation. As the documentation states, map




          Invokes a function on every immediate child contained within children with this set to thisArg.




          Children.map signature is similar to JavaScript Array.prototype.map. There are 3 arguments, 3rd argument is optional this context for callback function if needed.



          Children.map is documented better in source code:



          /**
          * Maps children that are typically specified as `props.children`.
          *
          * See https://reactjs.org/docs/react-api.html#reactchildrenmap
          *
          * The provided mapFunction(child, key, index) will be called for each
          * leaf child.
          *
          * @param ?* children Children tree container.
          * @param function(*, int) func The map function.
          * @param * context Context for mapFunction.
          * @return object Object containing the ordered map of results.
          */
          function mapChildren(children, func, context) ...





          share|improve this answer




















          • Thanks for taking the time to respond but this doesn't answer my question. Your answer restates things that I already know from reading the docs and looking at the code. I'm not asking how to use React.Children.map but rather, I want to know how the api notation tells me how to use React.Children.map. Thanks
            – psalaets
            Nov 17 at 17:02










          • As I mentioned, that this isn't standard notation. The answer explains what it really stands for. You can read it as React.Children.map is a function that accepts children argument, callback function argument and optional thisArg argument that will be used as this context in callback function. Can anyone read it like that without knowing what it stands for? I doubt that.
            – estus
            Nov 17 at 17:14










          Your Answer






          StackExchange.ifUsing("editor", function ()
          StackExchange.using("externalEditor", function ()
          StackExchange.using("snippets", function ()
          StackExchange.snippets.init();
          );
          );
          , "code-snippets");

          StackExchange.ready(function()
          var channelOptions =
          tags: "".split(" "),
          id: "1"
          ;
          initTagRenderer("".split(" "), "".split(" "), channelOptions);

          StackExchange.using("externalEditor", function()
          // Have to fire editor after snippets, if snippets enabled
          if (StackExchange.settings.snippets.snippetsEnabled)
          StackExchange.using("snippets", function()
          createEditor();
          );

          else
          createEditor();

          );

          function createEditor()
          StackExchange.prepareEditor(
          heartbeatType: 'answer',
          convertImagesToLinks: true,
          noModals: true,
          showLowRepImageUploadWarning: true,
          reputationToPostImages: 10,
          bindNavPrevention: true,
          postfix: "",
          imageUploader:
          brandingHtml: "Powered by u003ca class="icon-imgur-white" href="https://imgur.com/"u003eu003c/au003e",
          contentPolicyHtml: "User contributions licensed under u003ca href="https://creativecommons.org/licenses/by-sa/3.0/"u003ecc by-sa 3.0 with attribution requiredu003c/au003e u003ca href="https://stackoverflow.com/legal/content-policy"u003e(content policy)u003c/au003e",
          allowUrls: true
          ,
          onDemand: true,
          discardSelector: ".discard-answer"
          ,immediatelyShowMarkdownHelp:true
          );



          );













           

          draft saved


          draft discarded


















          StackExchange.ready(
          function ()
          StackExchange.openid.initPostLogin('.new-post-login', 'https%3a%2f%2fstackoverflow.com%2fquestions%2f53242398%2fhow-to-read-react-children-map-api-notation%23new-answer', 'question_page');

          );

          Post as a guest















          Required, but never shown

























          1 Answer
          1






          active

          oldest

          votes








          1 Answer
          1






          active

          oldest

          votes









          active

          oldest

          votes






          active

          oldest

          votes








          up vote
          0
          down vote













          function[(thisArg)] isn't a standard denotation. As the documentation states, map




          Invokes a function on every immediate child contained within children with this set to thisArg.




          Children.map signature is similar to JavaScript Array.prototype.map. There are 3 arguments, 3rd argument is optional this context for callback function if needed.



          Children.map is documented better in source code:



          /**
          * Maps children that are typically specified as `props.children`.
          *
          * See https://reactjs.org/docs/react-api.html#reactchildrenmap
          *
          * The provided mapFunction(child, key, index) will be called for each
          * leaf child.
          *
          * @param ?* children Children tree container.
          * @param function(*, int) func The map function.
          * @param * context Context for mapFunction.
          * @return object Object containing the ordered map of results.
          */
          function mapChildren(children, func, context) ...





          share|improve this answer




















          • Thanks for taking the time to respond but this doesn't answer my question. Your answer restates things that I already know from reading the docs and looking at the code. I'm not asking how to use React.Children.map but rather, I want to know how the api notation tells me how to use React.Children.map. Thanks
            – psalaets
            Nov 17 at 17:02










          • As I mentioned, that this isn't standard notation. The answer explains what it really stands for. You can read it as React.Children.map is a function that accepts children argument, callback function argument and optional thisArg argument that will be used as this context in callback function. Can anyone read it like that without knowing what it stands for? I doubt that.
            – estus
            Nov 17 at 17:14














          up vote
          0
          down vote













          function[(thisArg)] isn't a standard denotation. As the documentation states, map




          Invokes a function on every immediate child contained within children with this set to thisArg.




          Children.map signature is similar to JavaScript Array.prototype.map. There are 3 arguments, 3rd argument is optional this context for callback function if needed.



          Children.map is documented better in source code:



          /**
          * Maps children that are typically specified as `props.children`.
          *
          * See https://reactjs.org/docs/react-api.html#reactchildrenmap
          *
          * The provided mapFunction(child, key, index) will be called for each
          * leaf child.
          *
          * @param ?* children Children tree container.
          * @param function(*, int) func The map function.
          * @param * context Context for mapFunction.
          * @return object Object containing the ordered map of results.
          */
          function mapChildren(children, func, context) ...





          share|improve this answer




















          • Thanks for taking the time to respond but this doesn't answer my question. Your answer restates things that I already know from reading the docs and looking at the code. I'm not asking how to use React.Children.map but rather, I want to know how the api notation tells me how to use React.Children.map. Thanks
            – psalaets
            Nov 17 at 17:02










          • As I mentioned, that this isn't standard notation. The answer explains what it really stands for. You can read it as React.Children.map is a function that accepts children argument, callback function argument and optional thisArg argument that will be used as this context in callback function. Can anyone read it like that without knowing what it stands for? I doubt that.
            – estus
            Nov 17 at 17:14












          up vote
          0
          down vote










          up vote
          0
          down vote









          function[(thisArg)] isn't a standard denotation. As the documentation states, map




          Invokes a function on every immediate child contained within children with this set to thisArg.




          Children.map signature is similar to JavaScript Array.prototype.map. There are 3 arguments, 3rd argument is optional this context for callback function if needed.



          Children.map is documented better in source code:



          /**
          * Maps children that are typically specified as `props.children`.
          *
          * See https://reactjs.org/docs/react-api.html#reactchildrenmap
          *
          * The provided mapFunction(child, key, index) will be called for each
          * leaf child.
          *
          * @param ?* children Children tree container.
          * @param function(*, int) func The map function.
          * @param * context Context for mapFunction.
          * @return object Object containing the ordered map of results.
          */
          function mapChildren(children, func, context) ...





          share|improve this answer












          function[(thisArg)] isn't a standard denotation. As the documentation states, map




          Invokes a function on every immediate child contained within children with this set to thisArg.




          Children.map signature is similar to JavaScript Array.prototype.map. There are 3 arguments, 3rd argument is optional this context for callback function if needed.



          Children.map is documented better in source code:



          /**
          * Maps children that are typically specified as `props.children`.
          *
          * See https://reactjs.org/docs/react-api.html#reactchildrenmap
          *
          * The provided mapFunction(child, key, index) will be called for each
          * leaf child.
          *
          * @param ?* children Children tree container.
          * @param function(*, int) func The map function.
          * @param * context Context for mapFunction.
          * @return object Object containing the ordered map of results.
          */
          function mapChildren(children, func, context) ...






          share|improve this answer












          share|improve this answer



          share|improve this answer










          answered Nov 10 at 19:45









          estus

          63.2k2193200




          63.2k2193200











          • Thanks for taking the time to respond but this doesn't answer my question. Your answer restates things that I already know from reading the docs and looking at the code. I'm not asking how to use React.Children.map but rather, I want to know how the api notation tells me how to use React.Children.map. Thanks
            – psalaets
            Nov 17 at 17:02










          • As I mentioned, that this isn't standard notation. The answer explains what it really stands for. You can read it as React.Children.map is a function that accepts children argument, callback function argument and optional thisArg argument that will be used as this context in callback function. Can anyone read it like that without knowing what it stands for? I doubt that.
            – estus
            Nov 17 at 17:14
















          • Thanks for taking the time to respond but this doesn't answer my question. Your answer restates things that I already know from reading the docs and looking at the code. I'm not asking how to use React.Children.map but rather, I want to know how the api notation tells me how to use React.Children.map. Thanks
            – psalaets
            Nov 17 at 17:02










          • As I mentioned, that this isn't standard notation. The answer explains what it really stands for. You can read it as React.Children.map is a function that accepts children argument, callback function argument and optional thisArg argument that will be used as this context in callback function. Can anyone read it like that without knowing what it stands for? I doubt that.
            – estus
            Nov 17 at 17:14















          Thanks for taking the time to respond but this doesn't answer my question. Your answer restates things that I already know from reading the docs and looking at the code. I'm not asking how to use React.Children.map but rather, I want to know how the api notation tells me how to use React.Children.map. Thanks
          – psalaets
          Nov 17 at 17:02




          Thanks for taking the time to respond but this doesn't answer my question. Your answer restates things that I already know from reading the docs and looking at the code. I'm not asking how to use React.Children.map but rather, I want to know how the api notation tells me how to use React.Children.map. Thanks
          – psalaets
          Nov 17 at 17:02












          As I mentioned, that this isn't standard notation. The answer explains what it really stands for. You can read it as React.Children.map is a function that accepts children argument, callback function argument and optional thisArg argument that will be used as this context in callback function. Can anyone read it like that without knowing what it stands for? I doubt that.
          – estus
          Nov 17 at 17:14




          As I mentioned, that this isn't standard notation. The answer explains what it really stands for. You can read it as React.Children.map is a function that accepts children argument, callback function argument and optional thisArg argument that will be used as this context in callback function. Can anyone read it like that without knowing what it stands for? I doubt that.
          – estus
          Nov 17 at 17:14

















           

          draft saved


          draft discarded















































           


          draft saved


          draft discarded














          StackExchange.ready(
          function ()
          StackExchange.openid.initPostLogin('.new-post-login', 'https%3a%2f%2fstackoverflow.com%2fquestions%2f53242398%2fhow-to-read-react-children-map-api-notation%23new-answer', 'question_page');

          );

          Post as a guest















          Required, but never shown





















































          Required, but never shown














          Required, but never shown












          Required, but never shown







          Required, but never shown

































          Required, but never shown














          Required, but never shown












          Required, but never shown







          Required, but never shown







          這個網誌中的熱門文章

          How to read a connectionString WITH PROVIDER in .NET Core?

          Node.js Script on GitHub Pages or Amazon S3

          Museum of Modern and Contemporary Art of Trento and Rovereto