Skip to content
Desislava Mihaylova edited this page May 2, 2016 · 2 revisions

The Events section shows all events supported by a widget or component.

Document the event arguments. Include at least the sender field.

In the event description, mention the statement below.

The event handler function context (available via the this keyword) will be set to the widget instance.

EXAMPLE

### columnShow

Fired when the user shows a column.

The event handler function context (available via the `this` keyword) will be set to the widget instance.

#### Event Data

##### e.column `Object`

A JavaScript object which represents the [`column`](#configuration-columns) configuration.

##### e.sender `kendo.ui.Grid`

The widget instance which fired the event.

#### Example - subscribe to the `columnShow` event during initialization

    <div id="grid"></div>
    <script>
    $("#grid").kendoGrid({
      columns: [
        { field: "name" },
        { field: "age" }
      ],
      dataSource: [
        { name: "Jane Doe", age: 30 },
        { name: "John Doe", age: 33 }
      ],
      columnMenu: true,
      columnShow: function(e) {
        console.log(e.column.field); // displays the field of the hidden column
      }
    });
    </script>

#### Example - subscribe to the `columnShow` event after initialization

    <div id="grid"></div>
    <script>
    function grid_columnShow(e) {
      console.log(e.column.field); // displays the field of the hidden column
    }
    $("#grid").kendoGrid({
      columns: [
        { field: "name" },
        { field: "age" }
      ],
      dataSource: [
        { name: "Jane Doe", age: 30 },
        { name: "John Doe", age: 33 }
      ],
      columnMenu: true
    });
    var grid = $("#grid").data("kendoGrid");
    grid.bind("columnShow", grid_columnShow);
    </script>

Events are defined in a ### section.

Event arguments are listed as ##### sections similar to the configuration options.

There should be a #### Event Data section if the event has any event arguments. Do not add such a section if there are no event arguments.

The event description must start with Fired. Use fired instead of triggered or raised.