Thank you for reporting this bug. We will make it our priority to review this report.
  1. #1
    Ext JS Premium Member
    Join Date
    Mar 2011
    Posts
    33
    Vote Rating
    0
    m4dc4p will become famous soon enough

      0  

    Default [CLOSED]Ext.util.Observable.listeners documentation is confusing

    [CLOSED]Ext.util.Observable.listeners documentation is confusing


    The example given for "listeners" isn't very helpful. First, the listener added refers to the undocumented 'el' property:

    click: {
    element: 'el', //bind to the underlying el property on the panel
    fn: function(){ console.log('click el'); }
    },

    Second, it does not specify that a simple syntax for component events is available. An example such as the following would help:

    listeners: { render: function () { console.log('in render'); } }

    Finally, the documentation does not describe the options shown ("element" and "fn"). It refers to documentation elsewhere which does not directly show the config options, and itself refers to yet another piece of documentation (that's 3 degrees of separation).

    If this documentation just showed the two possible forms and said "the second form can use any config options available when adding an individual listener" it would be clearer.

    Thanks!

  2. #2
    Sencha - Ext JS Dev Team evant's Avatar
    Join Date
    Apr 2007
    Location
    Sydney, Australia
    Posts
    16,655
    Vote Rating
    583
    evant has a reputation beyond repute evant has a reputation beyond repute evant has a reputation beyond repute evant has a reputation beyond repute evant has a reputation beyond repute evant has a reputation beyond repute evant has a reputation beyond repute evant has a reputation beyond repute evant has a reputation beyond repute evant has a reputation beyond repute evant has a reputation beyond repute

      0  

    Default


    The docs say to see the addListener method, which contains all the detailed information about binding events.
    Evan Trimboli
    Sencha Developer
    Twitter - @evantrimboli
    Don't be afraid of the source code!

Similar Threads

  1. [CLOSED] Documentation API Ext.util.Functions
    By deister in forum Ext 3.x: Bugs
    Replies: 2
    Last Post: 13 Oct 2010, 4:13 AM
  2. Ext.util.Observable addListener bug with IE
    By verr in forum Ext 2.x: Help & Discussion
    Replies: 2
    Last Post: 20 Aug 2010, 2:11 AM
  3. Ext.util.Observable();
    By kamakrane in forum Ext 3.x: Help & Discussion
    Replies: 2
    Last Post: 6 Nov 2009, 11:43 AM
  4. Ext.util.Observable.addEvents ???
    By chalu in forum Ext 2.x: Help & Discussion
    Replies: 4
    Last Post: 2 Jun 2008, 5:54 AM

Thread Participants: 1