Overflow set

common/changes/overflow-set_2017-04-17-21-47.json

@@ -0,0 +1,10 @@
+{
+  "changes": [
+    {
+      "packageName": "office-ui-fabric-react",
+      "comment": "OverflowSet: New Overflow Set componet to create sets of elements with overflow showing in callout",
+      "type": "patch"
+    }
+  ],
+  "email": "micahgodbolt@gmail.com"
+}

packages/office-ui-fabric-react/src/OverflowSet.ts

@@ -0,0 +1 @@
+export * from './components/OverflowSet/index';

packages/office-ui-fabric-react/src/components/Button/BaseButton.tsx

@@ -263,7 +263,7 @@ export class BaseButton extends BaseComponent<IBaseButtonProps, IBaseButtonState
     }
 
     return (
-      menuIconProps ?
+      menuIconProps && menuIconProps.iconName ?
         <Icon
           { ...menuIconProps }
           className={ css(`${classNames.base}-icon`, classNames.menuIcon, menuIconProps.className) }

packages/office-ui-fabric-react/src/components/OverflowSet/OverflowSet.Props.ts

@@ -0,0 +1,29 @@
+import * as React from 'react';
+import { OverflowSet } from './OverflowSet';
+import { IContextualMenuItem } from '../../ContextualMenu';
+import { IIconProps } from '../../Icon';
+import { IRenderFunction } from '../../Utilities';
+
+export interface IOverflowSetProps extends React.Props<OverflowSet> {
+
+  /**
+   * An array of items to be rendered by your onRenderItem function in the primary content area
+  */
+  items?: any[];
+
+  /**
+   * An array of items to be passed to overflow contextual menu
+  */
+  overflowItems?: IContextualMenuItem[];
+
+  /**
+   * Icon props used to override overflow icon.
+  */
+  iconProps?: IIconProps;
+
+  /**
+   * Method to call when trying to render an item.
+   * If item contains an onRender, that function will be used instead.
+  */
+  onRenderItem?: IRenderFunction<any>;
+}

packages/office-ui-fabric-react/src/components/OverflowSet/OverflowSet.scss

@@ -0,0 +1,17 @@
+@import '../../common/common';
+
+.root {
+  position: relative;
+  display: flex;
+  flex-wrap: nowrap;
+}
+
+
+.item {
+  flex-shrink: 0;
+}
+
+.overflowIcon {
+  align-self: stretch;
+  height: auto;
+}

packages/office-ui-fabric-react/src/components/OverflowSet/OverflowSet.tsx

@@ -0,0 +1,55 @@
+import * as React from 'react';
+import {
+  css,
+  autobind,
+  BaseComponent
+} from '../../Utilities';
+import { IOverflowSetProps } from './OverflowSet.Props';
+import { IconButton } from '../../Button';
+import { FocusZone, FocusZoneDirection } from '../../FocusZone';
+
+const styles: any = require('./OverflowSet.scss');
+
+export class OverflowSet extends BaseComponent<IOverflowSetProps, null> {
+
+  public render() {
+    let { items, overflowItems } = this.props;
+    return (
+      <FocusZone className={ css('ms-OverflowSet', styles.root) } direction={ FocusZoneDirection.horizontal } role='menubar' >
+        { items && this._onRenderItems(items) }
+        { overflowItems.length && this._onRenderOverflowButton(overflowItems) }
+      </FocusZone>
+    );
+  }
+
+  @autobind
+  private _onRenderOverflowButton(items) {
+    let { iconProps = {} } = this.props;
+    iconProps.iconName = iconProps.iconName ? iconProps.iconName : 'More';
+    return (
+      <IconButton
+        className={ css(styles.overflowIcon) }
+        iconProps={ iconProps }
+        menuIconProps={ { iconName: null } }
+        menuProps={ {
+          items: items
+        } }
+      />
+    );
+  }
+
+  @autobind
+  private _onRenderItems(items) {
+    return items.map((item, i) => {
+      let key = item.key ? item.key : i;
+      let onRender = item.onRender ? item.onRender : this.props.onRenderItem;
+      return (
+        <div
+          className={ css('ms-OverflowSet-item', styles.item) }
+          key={ key } >
+          { onRender ? onRender(item, i) : item }
+        </div>
+      );
+    });
+  }
+}

packages/office-ui-fabric-react/src/components/OverflowSet/OverflowSetPage.tsx

@@ -0,0 +1,43 @@
+import * as React from 'react';
+import { Link } from 'office-ui-fabric-react/lib/Link';
+import { LayerHost } from 'office-ui-fabric-react/lib/Layer';
+import {
+  ExampleCard,
+  ComponentPage,
+  PropertiesTableSet
+} from '@uifabric/example-app-base';
+import { OverflowSetBasicExample } from './examples/OverflowSet.Basic.Example';
+
+const OverflowSetBasicExampleCode = require('!raw-loader!office-ui-fabric-react/src/components/OverflowSet/examples/OverflowSet.Basic.Example.tsx') as string;
+
+export class OverflowSetPage extends React.Component<any, any> {
+  public render() {
+    return (
+      <ComponentPage
+        title='OverflowSet'
+        componentName='OverflowSetExample'
+        overview={
+          <div>
+            <p>
+              The Overflow Set component is a flexible container component that is usefull for displaying a primary set of content with additional content in an overflow callout.
+            </p>
+          </div>
+        }
+        exampleCards={
+          <LayerHost>
+            <ExampleCard title='OverflowSet' code={ OverflowSetBasicExampleCode }>
+              <OverflowSetBasicExample />
+            </ExampleCard>
+          </LayerHost>
+        }
+        propertiesTables={
+          <PropertiesTableSet
+            sources={ [
+              require<string>('!raw-loader!office-ui-fabric-react/src/components/OverflowSet/OverflowSet.Props.ts')
+            ] }
+          />
+        }
+      />
+    );
+  }
+}

packages/office-ui-fabric-react/src/components/OverflowSet/examples/OverflowSet.Basic.Example.tsx

@@ -0,0 +1,123 @@
+/* tslint:disable:no-unused-variable */
+import * as React from 'react';
+/* tslint:enable:no-unused-variable */
+import { BaseComponent } from 'office-ui-fabric-react/lib/Utilities';
+import { PrimaryButton } from 'office-ui-fabric-react/lib/Button';
+import { DefaultButton } from 'office-ui-fabric-react/lib/Button';
+import {
+  OverflowSet
+} from '../index';
+
+export class OverflowSetBasicExample extends BaseComponent<any, any> {
+
+  public render() {
+    return (
+      <OverflowSet
+        items={ [
+          {
+            key: 'search',
+            'onRender': () => {
+              return (
+                <PrimaryButton
+                  iconProps={ { iconName: 'Add' } }
+                  text='Add'
+                />
+              );
+            }
+          },
+          {
+            key: 'newItem',
+            name: 'New',
+            icon: 'Add',
+            ariaLabel: 'New. Use left and right arrow keys to navigate',
+            onClick: () => { return; },
+            subMenuProps: {
+              items: [
+                {
+                  key: 'emailMessage',
+                  name: 'Email message',
+                  icon: 'Mail',
+                },
+                {
+                  key: 'calendarEvent',
+                  name: 'Calendar event',
+                  icon: 'Calendar'
+                }
+              ],
+            },
+          },
+          {
+            key: 'upload',
+            name: 'Upload',
+            icon: 'Upload',
+            onClick: () => { return; },
+          },
+          {
+            key: 'share',
+            name: 'Share',
+            icon: 'Share',
+            onClick: () => { return; }
+          }
+        ] }
+        overflowItems={ [
+          {
+            key: 'newItem',
+            name: 'Add',
+            icon: 'Add',
+            ariaLabel: 'New. Use left and right arrow keys to navigate',
+            onClick: () => { return; },
+            subMenuProps: {
+              items: [
+                {
+                  key: 'emailMessage',
+                  name: 'Email message',
+                  icon: 'Mail',
+                },
+                {
+                  key: 'calendarEvent',
+                  name: 'Calendar event',
+                  icon: 'Calendar'
+                }
+              ],
+            },
+          },
+          {
+            key: 'move',
+            name: 'Move to...',
+            icon: 'MoveToFolder',
+            onClick: () => { return; }
+          },
+          {
+            key: 'copy',
+            name: 'Copy to...',
+            icon: 'Copy',
+            onClick: () => { return; }
+          },
+          {
+            key: 'rename',
+            name: 'Rename...',
+            icon: 'Edit',
+            onClick: () => { return; }
+          },
+          {
+            key: 'disabled',
+            name: 'Disabled...',
+            icon: 'Cancel',
+            disabled: true,
+            onClick: () => { return; }
+          }
+        ]
+        }
+        onRenderItem={ (item) => {
+          return (
+            <DefaultButton
+              iconProps={ { iconName: item.icon } }
+              menuProps={ item.subMenuProps }
+              text={ item.name }
+            >  </DefaultButton>
+          );
+        } }
+      />
+    );
+  }
+}

packages/office-ui-fabric-react/src/components/OverflowSet/index.ts

@@ -0,0 +1,2 @@
+export * from './OverflowSet';
+export * from './OverflowSet.Props';

packages/office-ui-fabric-react/src/demo/AppDefinition.tsx

@@ -142,6 +142,12 @@ export const AppDefinition: IAppDefinition = {
           name: 'Overlay',
           url: '#/examples/overlay'
         },
+        {
+          getComponent: cb => cb(require<any>('../components/OverflowSet/OverflowSetPage').OverflowSetPage),
+          key: 'OverflowSet',
+          name: 'OverflowSet',
+          url: '#/examples/overflowset'
+        },
         {
           getComponent: cb => cb(require<any>('../components/Panel/PanelPage').PanelPage),
           key: 'Panel',