Skip to content

Commit

Permalink
Merge pull request #377 from sencha/REAC-395-APIDocsUpdate
Browse files Browse the repository at this point in the history
REAC-395-Updated docs.
  • Loading branch information
mgusmano authored Jul 29, 2019
2 parents db12698 + 51d0f91 commit b764c0f
Show file tree
Hide file tree
Showing 14 changed files with 841 additions and 95 deletions.
10 changes: 10 additions & 0 deletions api-docs/core/src/data/summary/None.js
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
/**
* Produces no value for a summary. This would be used for fields like `id` or other
* value that does not aggregate.
* @since 7.0
*/

/**
* @cfg {Mixed} value
* The value to report for the summary.
*/
6 changes: 0 additions & 6 deletions api-docs/modern/modern/src/Component.js
Original file line number Diff line number Diff line change
Expand Up @@ -103,12 +103,6 @@
* noticeable improvement in performance.
*/

/**
* @cfg {Number/String} [margin=null] The margin to use on this Component. Can be specified as a number (in which case
* all edges get the same margin) or a CSS string like '5 10 10 10'
* @accessor
*/

/**
* @cfg {Number/String} [padding=null]
* The padding to use on this Component. Can be specified as a number (in which
Expand Down
6 changes: 6 additions & 0 deletions api-docs/modern/modern/src/Container.js
Original file line number Diff line number Diff line change
Expand Up @@ -110,6 +110,12 @@
* @since 6.5.0
*/

/**
* @cfg {String/String[]} bodyCls
* The CSS class to add to this container's body element.
* @since 7.0
*/

/**
* @cfg {Number} [minButtonWidth=null]
* Minimum width of all footer toolbar buttons in pixels. If set, this will be used as the default
Expand Down
7 changes: 7 additions & 0 deletions api-docs/modern/modern/src/Editor.js
Original file line number Diff line number Diff line change
Expand Up @@ -173,3 +173,10 @@
* Sets the data value of the editor
* @param {Object} value Any valid value supported by the underlying field
*/

/**
* @method getLocation
* @protected
* @returns {Ext.grid.Location} The location where editing is active *if* editing is
* active, else `null`.
*/
111 changes: 53 additions & 58 deletions api-docs/modern/modern/src/Panel.js
Original file line number Diff line number Diff line change
Expand Up @@ -20,64 +20,59 @@
* component, there will be an anchor arrow pointing to the reference component.
*
* @example packages=[ext-react]
* import React, { Component } from 'react';
* import { ExtReact, Container, Panel, Button } from '@sencha/ext-react';
*
* Ext.require('Ext.Toast');
*
* function toolHandler(owner, tool) {
* Ext.toast(`You clicked ${tool.config.type}`);
* }
*
* export default class PanelExample extends Component {
*
* render() {
* return (
* <ExtReact>
* <Container>
* <Panel
* shadow
* title="Panel"
* height={300}
* width={500}
* tools={[
* { type: 'minimize', handler: toolHandler },
* { type: 'refresh', handler: toolHandler },
* { type: 'save', handler: toolHandler },
* { type: 'search', handler: toolHandler },
* { type: 'close', handler: toolHandler }
* ]}
* >
* <p>Panel Body</p>
* </Panel>
* <Button ui="action" handler={() => this.refs.modal.show()} margin="20 0 0 0" text="Show Modal"/>
* <Panel
* ref="modal"
* title="Floated Panel"
* modal
* floated
* centered
* hideOnMaskTap
* width={Ext.filterPlatform('ie10') ? '100%' : (Ext.os.deviceType == 'Phone') ? 260 : 400}
* maxHeight={Ext.filterPlatform('ie10') ? '30%' : (Ext.os.deviceType == 'Phone') ? 220 : 400}
* showAnimation={{
* type: 'popIn',
* duration: 250,
* easing: 'ease-out'
* }}
* hideAnimation={{
* type: 'popOut',
* duration: 250,
* easing: 'ease-out'
* }}
* >
* <p>This is a modal, centered and floated panel. hideOnMaskTap is true by default so we can tap anywhere outside the overlay to hide it.</p>
* </Panel>
* </Container>
* </ExtReact>
* )
* }
* }
* import React, { Component } from 'react';
* import { Container, Panel, Button } from '@sencha/ext-modern';
* Ext.require('Ext.Toast');
*
* export default class MyExample extends Component {
* render() {
* function toolHandler(owner, tool) {
* Ext.toast(`You clicked ${tool.config.type}`);
* }
* return (
* <Container>
* <Panel
* shadow
* title="Panel"
* height={300}
* width={500}
* tools={[
* { type: 'minimize', handler: toolHandler },
* { type: 'refresh', handler: toolHandler },
* { type: 'save', handler: toolHandler },
* { type: 'search', handler: toolHandler },
* { type: 'close', handler: toolHandler }
* ]}
* >
* <p>Panel Body</p>
* </Panel>
* <Button ui="action" handler={() => this.modal.cmp.show()} margin="20 0 0 0" text="Show Modal"/>
* <Panel
* ref={modal => this.modal = modal}
* title="Floated Panel"
* modal
* floated
* centered
* hideOnMaskTap
* width={Ext.filterPlatform('ie10') ? '100%' : (Ext.os.deviceType == 'Phone') ? 260 : 400}
* maxHeight={Ext.filterPlatform('ie10') ? '30%' : (Ext.os.deviceType == 'Phone') ? 220 : 400}
* showAnimation={{
* type: 'popIn',
* duration: 250,
* easing: 'ease-out'
* }}
* hideAnimation={{
* type: 'popOut',
* duration: 250,
* easing: 'ease-out'
* }}
* >
* <p>This is a modal, centered and floated panel. hideOnMaskTap is true by default so we can tap anywhere outside the overlay to hide it.</p>
* </Panel>
* </Container>
* )
* }
* }
*
*/

Expand Down
35 changes: 35 additions & 0 deletions api-docs/modern/modern/src/dataview/List.js
Original file line number Diff line number Diff line change
Expand Up @@ -373,6 +373,41 @@
* @accessor
*/

/**
* @cfg {Ext.dataview.ListCollapser/Object} collapseDefaults
* This config object supplies default for the `collapsible` config. When that
* config is simply `true`, this is the complete config object for the group
* collapser.
*
* NOTE: This config cannot be changed after instantiation. Instead, change the
* `collapsible` config.
* @since 7.0
*/

/**
* @cfg {Object/Ext.dataview.ListItemPlaceholder} groupPlaceholder
* This config provides defaults for the placeholder items rendered for collapsed
* groups.
* @since 7.0
* @private
*/

/**
* @cfg {Object} grouping
* @private
* @since 7.0
*/

/**
* @cfg {Ext.dataview.ListCollapser/Object/Boolean} collapsible
* This object configures group collapse. It is only applicable when `grouped`.
* Set to `false` to disable group collapsibility. The default value of `true`
* uses the `collapseDefaults` config for the final collapser configuration
* object. If this config is an object, it is merged with `collapseDefaults`
* giving this object's properties priority over the defaults.
* @since 7.0
*/

/**
* @cfg {Object[]} [data=null]
* An array of records to display. Use in place of {@link #store} when fetching data directly
Expand Down
155 changes: 155 additions & 0 deletions api-docs/modern/modern/src/grid/locked/Grid.js
Original file line number Diff line number Diff line change
@@ -0,0 +1,155 @@
/**
* @class Ext.grid.locked.Grid
* @extend Ext.Panel
* @xtype lockedgrid
* @alternateClassName Ext.grid.LockedGrid
* @isLockedGrid true
* The `lockedgrid` component manages one or more child `grid`s that independently scroll
* in the horizontal axis but are vertically synchronized. The end-user can, using column
* menus or drag-drop, control which of these {@link #cfg!regions regions} contain which
* columns.
*
* ## Locked Regions
*
* The `lockedgrid` always has a `center` {@link Ext.grid.locked.Region region} and by
* default a `left` and `right` region. These regions are derivatives of `Ext.panel.Panel`
* (to allow them to be resized and collapsed) and contain normal `grid` with a subset of
* the overall set of `columns`. All keys in the `regions` config object are valid values
* for a {@link Ext.grid.column.Column column}'s `locked` config. The values of each of
* the properties of the `regions` config are configurations for the locked region itself.
*
* The layout of the locked regions is a simple `hbox` with the `center` assigned `flex:1`
* and the non-center regions assigned a width based on the columns contained in that
* region. The order of items in the container is determined by the `weight` assigned to
* each region. Regions to the left of center have negative `weight` values, while regions
* to the right of center have positive `weight` values. This distinction is important
* primarily to determine the side of the region on which to display the resizer as well
* as setting the direction of collapse for the region.
*
* ## Config and Event Delegation
*
* The `lockedgrid` mimics the config properties and events fired by a normal `grid`. It
* does this in some cases by delegating configs to each child grid. The `regions` config
* should be used to listen to events or configure a child grid independently when this
* isn't desired.
*/

/**
* @cfg {Object} columnMenu
* This is a config object which is used by columns in this grid to create their
* header menus.
*
* The following column menu contains the following items.
*
* - Default column menu items {@link Ext.grid.Grid grid}
* - "Region" menu item to provide locking sub-menu options
*
* This can be configured as `null` to prevent columns from showing a column menu.
*/

/**
* @cfg {Ext.grid.column.Column[]} columns (required)
* An array of column definition objects which define all columns that appear in this grid.
* Each column definition provides the header text for the column, and a definition of where
* the data for that column comes from.
* Column definition can also define the locked property
*
* This can also be a configuration object for a {Ext.grid.header.Container HeaderContainer}
* which may override certain default configurations if necessary. For example, the special
* layout may be overridden to use a simpler layout, or one can set default values shared
* by all columns:
*
* columns: {
* items: [
* {
* text: "Column A"
* dataIndex: "field_A",
* locked: true,
* width: 200
* },{
* text: "Column B",
* dataIndex: "field_B",
* width: 150
* },
* ...
* ]
* }
*
*/

/**
* @cfg {String} defaultLockedRegion
* This config determines which region corresponds to `locked: true` on a column.
*/

/**
* @cfg {Object} gridDefaults
* This config is applied to the child `grid` in all regions.
*/

/**
* @cfg {Boolean} hideHeaders
* @inheritdoc Ext.grid.Grid#cfg!hideHeaders
*/

/**
* @cfg {Object} itemConfig
* @inheritdoc Ext.grid.Grid#cfg!itemConfig
*/

/**
* @cfg {Object} leftGridDefaults
* This config is applied to the child `grid` in all left-side regions (those of
* negative `weight`)
*/

/**
* @cfg {Object} regions
* This config determines the set of possible locked regions. Each key name in this
* object denotes a named region (for example, "left", "right" and "center"). While
* the set of names is not fixed, meaning a `lockedgrid` can have more than these
* three regions, there must always be a "center" region. The center regions cannot
* be hidden or collapsed or emptied of all columns.
*
* The values of each property in this object are configuration objects for the
* {@link Ext.grid.locked.Region region}. The ordering of grids is determined by
* the `weight` config. Negative values are "left" regions, while positive values
* are "right" regions. The `menuLabel` is used in the column menu to allow the user
* to place columns into the region.
*
* To add an additional left region:
*
* xtype: 'lockedgrid',
* regions: {
* left2: {
* menuLabel: 'Locked (leftmost)',
* weight: -20 // to the left of the standard "left" region
* }
* }
*/

/**
* @cfg {Object} rightGridDefaults
* This config is applied to the child `grid` in all right-side regions (those of
* positive `weight`)
*/

/**
* @cfg {Ext.data.Store/Object/String} store
* @inheritdoc Ext.grid.Grid#cfg!store
*/

/**
* @cfg {Boolean} variableHeights
* @inheritdoc Ext.grid.Grid#cfg!variableHeights
*/

/**
* @cfg {Boolean} enableColumnMove
* Set to `false` to disable header reorder within this grid.
*/

/**
* @cfg {Boolean} grouped
* @inheritdoc Ext.dataview.List#cfg!grouped
*/
Loading

0 comments on commit b764c0f

Please sign in to comment.