@angular/material 2.0.0-beta.0 → 2.0.0-beta.12

package/icon/README.md

@@ -1,129 +0,0 @@
-# md-icon
-
-`md-icon` is a component that displays an icon, which can be a font glyph or an SVG image.
-
-## MdIconRegistry
-
-`MdIconRegistry` is an injectable service that allows you to associate icon names with SVG URLs and define aliases for CSS font classes. Its methods are discussed below and listed in the API summary.
-
-## Font icons
-
-### Ligatures
-
-Some fonts are designed to show icons by using [ligatures](https://en.wikipedia.org/wiki/Typographic_ligature), for example by rendering the text "home" as a home image. To use a ligature icon, put its text in the content of the `md-icon` component, for example:
-```html
-<md-icon>home</md-icon>
-```
-
-By default the [Material icons font](http://google.github.io/material-design-icons/#icon-font-for-the-web) is used. (You will still need to include the HTML to load the font and its CSS, as described in the link). You can specify a different font by setting the `fontSet` input to either the CSS class to apply to use the desired font, or to an alias previously registered with `MdIconRegistry.registerFontClassAlias`, for example:
-```javascript
-mdIconRegistry.registerFontClassAlias('myfont', 'my-icon-font-class');
-```
-
-```html
-<md-icon fontSet="myfont">help</md-icon>
-```
-
-### Font icons via CSS
-
-Fonts can also display icons by defining a CSS class for each icon glyph, which typically uses a :before selector to cause the icon to appear. [FontAwesome](https://fortawesome.github.io/Font-Awesome/examples/) uses this approach to display its icons. To use such a font, set the `fontSet` input to the font's CSS class (either the class itself or an alias registered with `MdIconRegistry.registerFontClassAlias`), and set the `fontIcon` input to the class for the specific icon to show. Example:
-
-```html
-<md-icon fontSet="fa" fontIcon="fa-square"></md-icon>
-```
-
-For both types of font icons, you can specify the default font class to use when `fontSet` is not explicitly set by calling `MdIconRegistry.setDefaultFontSetClass`.
-
-## SVG icons
-
-When an `md-icon` component displays an SVG icon, it does so by directly inlining the SVG content into the page as a child of the component. (Rather than using an <img> tag or a div background image). This makes it easier to apply CSS styles to SVG icons. For example, the default color of the SVG content is the CSS [currentColor](http://www.quirksmode.org/css/color/currentcolor.html) value. This makes SVG icons by default have the same color as surrounding text, and allows you to change the color by setting the "color" style on the `md-icon` element.
-
-### Icons from URLs
-
-SVG icons can be used either by directly specifying the icon's URL, or by associating an icon name with a URL and then referring to the name. To use a URL directly, set the `svgSrc` input:
-```html
-<md-icon svgSrc="/assets/sun.svg"></md-icon>
-```
-
-### Named icons
-
-To associate a name with an icon URL, use the `addSvgIcon` or `addSvgIconInNamespace` methods of `MdIconRegistry`. After registering an icon, it can be displayed by setting the `svgIcon` input. For an icon in the default namespace, use the name directly. For a non-default namespace, use the format `[namespace]:[name]`. Examples:
-```javascript
-mdIconRegistry.addSvgIcon('moon', '/assets/moon.svg');
-mdIconRegistry.addSvgIconInNamespace('animals', 'cat', '/assets/cat.svg');
-```
-
-```html
-<md-icon svgIcon="moon"></md-icon>
-<md-icon svgIcon="animals:cat"></md-icon>
-```
-
-### Icon sets
-
-Icon sets allow grouping multiple icons into a single SVG file. The content of an icon set file looks like this, where each nested `<svg>` tag defines an individual icon, and is identified with a unique "id" attribute.
-```
-<svg>
-  <defs>
-    <svg id="mercury">...</svg>
-    <svg id="venus">...</svg>
-    <svg id="earth">...</svg>
-    <svg id="mars">...</svg>
-  </defs>
-</svg>
-```
-
-Icon sets are registered using the `addSvgIconSet` or `addSvgIconSetInNamespace` methods of `MdIconRegistry`. After an icon set is registered, each of its embedded icons can be accessed by their "id" attributes. To display an icon from an icon set, use the `svgIcon` input in the same way as for individually registered icons. Example:
-```javascript
-mdIconRegistry.addSvgIconSetInNamespace('planets', '/assets/planets.svg');
-```
-
-```html
-<md-icon svgIcon="planets:venus"></md-icon>
-```
-
-Multiple icon sets can be registered in the same namespace. If you request an icon whose id appears in more than one icon set, the icon from the most recently registered set will be used.
-
-Note that all SVG icons are fetched via XmlHttpRequest, and due to the same-origin policy their URLs must be on the same domain as the containing page, or their servers must be configured to allow cross-domain access.
-
-### Theming
-
-Icons can be themed to match your "primary" palette, your "accent" palette, or your "warn" palette using the `color` attribute.
-Simply pass in the palette name.
-
-Example:
-
- ```html
-<md-icon color="primary">home</md-icon>
-<md-icon color="accent">home</md-icon>
-<md-icon color="warn">home</md-icon>
-```
-
-### Accessibility
-
-If you set an "aria-label" attribute on the md-icon element, its value will be used as-is. If you do not, the md-icon component will attempt to set the aria-label value from one of these sources:
-* The `alt` attribute
-* The `fontIcon` input
-* The name of the icon from the `svgIcon` input (not including any namespace)
-* The text content of the component (for ligature icons)
-
-### API Summary
-
-md-icon Properties:
-
-| Name         | Type     | Description |
-| ---          | ---      | --- |
-| `svgSrc`     | string   | The URL of the SVG icon to display |
-| `svgIcon`    | string   | The name (and possibly namespace) of an icon previously registered with `MdIconRegistry.addSvgIcon` or `MdIconRegistry.addSvgIconInNamespace` |
-| `fontSet`    | string   | The font to use to display an icon glyph. The value can be either a CSS class name, or an alias previously defined with `MdIconRegistry.registerFontClassAlias` |
-| `fontIcon`   | string   | The CSS class that identifies the specific icon to use from an icon font |
-
-MdIconRegistry methods (all methods return `this` for chaining):
-
-| Signature   | Description |
-| ---         | --- |
-| addSvgIcon(name: string, url: string): MdIconProvider | Associates an icon name with a URL in the default namespace. When an `md-icon` component has its `svgIcon` input set to this name, the icon will be loaded from this URL. |
-| addSvgIconInNamespace(namespace: string, iconName: string, url: string): MdIconProvider | Associates an icon name with a URL in the specified namespace. |
-| addSvgIconSet(url: string): MdIconProvider | Makes the icons contained in the icon set from a URL available in the default namespace. |
-| addSvgIconSetInNamespace(namespace: string, url: string): MdIconProvider | Makes the icons contained in the icon set from a URL available in the specified namespace. |
-| registerFontClassAlias(alias: string, className: string): MdIconProvider | Associates a font alias with a CSS class. When an `md-icon` component has its `fontSet` input set to the alias, the CSS class will be added to the component's element. It is assumed that the user has defined a corresponding CSS rule to set the desired font. |
-| setDefaultFontSetClass(className: string): MdIconProvider | Sets the default CSS class to apply to font icons when mdFontSet is not set. |

package/icon/_icon-theme.scss

@@ -1,25 +0,0 @@
-@import '../core/theming/theming';
-
-
-// Include this empty mixin for consistency with the other components.
-@mixin md-icon-theme($theme) {
-  $primary: map-get($theme, primary);
-  $accent: map-get($theme, accent);
-  $warn: map-get($theme, warn);
-  $background: map-get($theme, background);
-  $foreground: map-get($theme, foreground);
-
-  md-icon {
-    &.md-primary {
-      color: md-color($primary);
-    }
-
-    &.md-accent {
-      color: md-color($accent);
-    }
-
-    &.md-warn {
-      color: md-color($warn);
-    }
-  }
-}

package/icon/fake-svgs.d.ts

@@ -1,6 +0,0 @@
-import { Response } from '@angular/http';
-/**
- * Returns an HTTP response for a fake SVG URL.
- * @docs-private
- */
-export declare function getFakeSvgHttpResponse(url: string): Response;

package/icon/fake-svgs.js

@@ -1,31 +0,0 @@
-import { Response, ResponseOptions } from '@angular/http';
-/**
- * Fake URLs and associated SVG documents used by tests.
- * @docs-private
- */
-var FAKE_SVGS = (function () {
-    var svgs = new Map();
-    svgs.set('cat.svg', '<svg><path id="meow"></path></svg>');
-    svgs.set('dog.svg', '<svg><path id="woof"></path></svg>');
-    svgs.set('farm-set-1.svg', "\n      <svg>\n        <defs>\n          <g id=\"pig\"><path id=\"oink\"></path></g>\n          <g id=\"cow\"><path id=\"moo\"></path></g>\n        </defs>\n      </svg>\n  ");
-    svgs.set('farm-set-2.svg', "\n      <svg>\n        <defs>\n          <g id=\"cow\"><path id=\"moo moo\"></path></g>\n          <g id=\"sheep\"><path id=\"baa\"></path></g>\n        </defs>\n      </svg>\n  ");
-    svgs.set('arrow-set.svg', "\n      <svg>\n        <defs>\n          <svg id=\"left-arrow\"><path id=\"left\"></path></svg>\n          <svg id=\"right-arrow\"><path id=\"right\"></path></svg>\n        </defs>\n      </svg>\n  ");
-    return svgs;
-})();
-/**
- * Returns an HTTP response for a fake SVG URL.
- * @docs-private
- */
-export function getFakeSvgHttpResponse(url) {
-    if (FAKE_SVGS.has(url)) {
-        return new Response(new ResponseOptions({
-            status: 200,
-            body: FAKE_SVGS.get(url),
-        }));
-    }
-    else {
-        return new Response(new ResponseOptions({ status: 404 }));
-    }
-}
-
-//# sourceMappingURL=fake-svgs.js.map

package/icon/fake-svgs.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["icon/fake-svgs.ts"],"names":[],"mappings":"OAAO,EACL,QAAQ,EACR,eAAe,EAAC,MAAM,eAAe;AAEvC;;;GAGG;AACH,IAAM,SAAS,GAAG,CAAC;IACjB,IAAM,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC;IACvC,IAAI,CAAC,GAAG,CAAC,SAAS,EACd,oCAAoC,CAAC,CAAC;IAE1C,IAAI,CAAC,GAAG,CAAC,SAAS,EACd,oCAAoC,CAAC,CAAC;IAE1C,IAAI,CAAC,GAAG,CAAC,gBAAgB,EAAE,+KAO1B,CAAC,CAAC;IAEH,IAAI,CAAC,GAAG,CAAC,gBAAgB,EAAE,oLAO1B,CAAC,CAAC;IAEH,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,wMAOzB,CAAC,CAAC;IAEH,MAAM,CAAC,IAAI,CAAC;AACd,CAAC,CAAC,EAAE,CAAC;AAEL;;;GAGG;AACH,uCAAuC,GAAW;IAChD,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACvB,MAAM,CAAC,IAAI,QAAQ,CAAC,IAAI,eAAe,CAAC;YACtC,MAAM,EAAE,GAAG;YACX,IAAI,EAAE,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC;SACzB,CAAC,CAAC,CAAC;IACN,CAAC;IAAC,IAAI,CAAC,CAAC;QACN,MAAM,CAAC,IAAI,QAAQ,CAAC,IAAI,eAAe,CAAC,EAAC,MAAM,EAAE,GAAG,EAAC,CAAC,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC","file":"fake-svgs.js","sourcesContent":["import {\n  Response,\n  ResponseOptions} from '@angular/http';\n\n/**\n * Fake URLs and associated SVG documents used by tests.\n * @docs-private\n */\nconst FAKE_SVGS = (() => {\n  const svgs = new Map<string, string>();\n  svgs.set('cat.svg',\n      '<svg><path id=\"meow\"></path></svg>');\n\n  svgs.set('dog.svg',\n      '<svg><path id=\"woof\"></path></svg>');\n\n  svgs.set('farm-set-1.svg', `\n      <svg>\n        <defs>\n          <g id=\"pig\"><path id=\"oink\"></path></g>\n          <g id=\"cow\"><path id=\"moo\"></path></g>\n        </defs>\n      </svg>\n  `);\n\n  svgs.set('farm-set-2.svg', `\n      <svg>\n        <defs>\n          <g id=\"cow\"><path id=\"moo moo\"></path></g>\n          <g id=\"sheep\"><path id=\"baa\"></path></g>\n        </defs>\n      </svg>\n  `);\n\n  svgs.set('arrow-set.svg', `\n      <svg>\n        <defs>\n          <svg id=\"left-arrow\"><path id=\"left\"></path></svg>\n          <svg id=\"right-arrow\"><path id=\"right\"></path></svg>\n        </defs>\n      </svg>\n  `);\n\n  return svgs;\n})();\n\n/**\n * Returns an HTTP response for a fake SVG URL.\n * @docs-private\n */\nexport function getFakeSvgHttpResponse(url: string) {\n  if (FAKE_SVGS.has(url)) {\n    return new Response(new ResponseOptions({\n      status: 200,\n      body: FAKE_SVGS.get(url),\n    }));\n  } else {\n    return new Response(new ResponseOptions({status: 404}));\n  }\n}\n"]}

package/icon/fake-svgs.metadata.json

@@ -1 +0,0 @@
-[{"__symbolic":"module","version":2,"metadata":{"getFakeSvgHttpResponse":{"__symbolic":"function"}}},{"__symbolic":"module","metadata":{"getFakeSvgHttpResponse":{"__symbolic":"function"}},"version":1}]

package/icon/icon-registry.d.ts

@@ -1,180 +0,0 @@
-import { SafeResourceUrl, DomSanitizer } from '@angular/platform-browser';
-import { Http } from '@angular/http';
-import { MdError } from '../core';
-import { Observable } from 'rxjs/Observable';
-import 'rxjs/add/observable/forkJoin';
-import 'rxjs/add/observable/of';
-import 'rxjs/add/operator/map';
-import 'rxjs/add/operator/filter';
-import 'rxjs/add/operator/do';
-import 'rxjs/add/operator/share';
-import 'rxjs/add/operator/finally';
-import 'rxjs/add/operator/catch';
-/**
- * Exception thrown when attempting to load an icon with a name that cannot be found.
- * @docs-private
- */
-export declare class MdIconNameNotFoundError extends MdError {
-    constructor(iconName: string);
-}
-/**
- * Exception thrown when attempting to load SVG content that does not contain the expected
- * <svg> tag.
- * @docs-private
- */
-export declare class MdIconSvgTagNotFoundError extends MdError {
-    constructor();
-}
-/**
- * Service to register and display icons used by the <md-icon> component.
- * - Registers icon URLs by namespace and name.
- * - Registers icon set URLs by namespace.
- * - Registers aliases for CSS classes, for use with icon fonts.
- * - Loads icons from URLs and extracts individual icons from icon sets.
- */
-export declare class MdIconRegistry {
-    private _http;
-    private _sanitizer;
-    /**
-     * URLs and cached SVG elements for individual icons. Keys are of the format "[namespace]:[icon]".
-     */
-    private _svgIconConfigs;
-    /**
-     * SvgIconConfig objects and cached SVG elements for icon sets, keyed by namespace.
-     * Multiple icon sets can be registered under the same namespace.
-     */
-    private _iconSetConfigs;
-    /** Cache for icons loaded by direct URLs. */
-    private _cachedIconsByUrl;
-    /** In-progress icon fetches. Used to coalesce multiple requests to the same URL. */
-    private _inProgressUrlFetches;
-    /** Map from font identifiers to their CSS class names. Used for icon fonts. */
-    private _fontCssClassesByAlias;
-    /**
-     * The CSS class to apply when an <md-icon> component has no icon name, url, or font specified.
-     * The default 'material-icons' value assumes that the material icon font has been loaded as
-     * described at http://google.github.io/material-design-icons/#icon-font-for-the-web
-     */
-    private _defaultFontSetClass;
-    constructor(_http: Http, _sanitizer: DomSanitizer);
-    /**
-     * Registers an icon by URL in the default namespace.
-     * @param iconName Name under which the icon should be registered.
-     * @param url
-     */
-    addSvgIcon(iconName: string, url: SafeResourceUrl): this;
-    /**
-     * Registers an icon by URL in the specified namespace.
-     * @param namespace Namespace in which the icon should be registered.
-     * @param iconName Name under which the icon should be registered.
-     * @param url
-     */
-    addSvgIconInNamespace(namespace: string, iconName: string, url: SafeResourceUrl): this;
-    /**
-     * Registers an icon set by URL in the default namespace.
-     * @param url
-     */
-    addSvgIconSet(url: SafeResourceUrl): this;
-    /**
-     * Registers an icon set by URL in the specified namespace.
-     * @param namespace Namespace in which to register the icon set.
-     * @param url
-     */
-    addSvgIconSetInNamespace(namespace: string, url: SafeResourceUrl): this;
-    /**
-     * Defines an alias for a CSS class name to be used for icon fonts. Creating an mdIcon
-     * component with the alias as the fontSet input will cause the class name to be applied
-     * to the <md-icon> element.
-     *
-     * @param alias Alias for the font.
-     * @param className Class name override to be used instead of the alias.
-     */
-    registerFontClassAlias(alias: string, className?: string): this;
-    /**
-     * Returns the CSS class name associated with the alias by a previous call to
-     * registerFontClassAlias. If no CSS class has been associated, returns the alias unmodified.
-     */
-    classNameForFontAlias(alias: string): string;
-    /**
-     * Sets the CSS class name to be used for icon fonts when an <md-icon> component does not
-     * have a fontSet input value, and is not loading an icon by name or URL.
-     *
-     * @param className
-     */
-    setDefaultFontSetClass(className: string): this;
-    /**
-     * Returns the CSS class name to be used for icon fonts when an <md-icon> component does not
-     * have a fontSet input value, and is not loading an icon by name or URL.
-     */
-    getDefaultFontSetClass(): string;
-    /**
-     * Returns an Observable that produces the icon (as an <svg> DOM element) from the given URL.
-     * The response from the URL may be cached so this will not always cause an HTTP request, but
-     * the produced element will always be a new copy of the originally fetched icon. (That is,
-     * it will not contain any modifications made to elements previously returned).
-     *
-     * @param safeUrl URL from which to fetch the SVG icon.
-     */
-    getSvgIconFromUrl(safeUrl: SafeResourceUrl): Observable<SVGElement>;
-    /**
-     * Returns an Observable that produces the icon (as an <svg> DOM element) with the given name
-     * and namespace. The icon must have been previously registered with addIcon or addIconSet;
-     * if not, the Observable will throw an MdIconNameNotFoundError.
-     *
-     * @param name Name of the icon to be retrieved.
-     * @param namespace Namespace in which to look for the icon.
-     */
-    getNamedSvgIcon(name: string, namespace?: string): Observable<SVGElement>;
-    /**
-     * Returns the cached icon for a SvgIconConfig if available, or fetches it from its URL if not.
-     */
-    private _getSvgFromConfig(config);
-    /**
-     * Attempts to find an icon with the specified name in any of the SVG icon sets.
-     * First searches the available cached icons for a nested element with a matching name, and
-     * if found copies the element to a new <svg> element. If not found, fetches all icon sets
-     * that have not been cached, and searches again after all fetches are completed.
-     * The returned Observable produces the SVG element if possible, and throws
-     * MdIconNameNotFoundError if no icon with the specified name can be found.
-     */
-    private _getSvgFromIconSetConfigs(name, iconSetConfigs);
-    /**
-     * Searches the cached SVG elements for the given icon sets for a nested icon element whose "id"
-     * tag matches the specified name. If found, copies the nested element to a new SVG element and
-     * returns it. Returns null if no matching element is found.
-     */
-    private _extractIconWithNameFromAnySet(iconName, iconSetConfigs);
-    /**
-     * Loads the content of the icon URL specified in the SvgIconConfig and creates an SVG element
-     * from it.
-     */
-    private _loadSvgIconFromConfig(config);
-    /**
-     * Loads the content of the icon set URL specified in the SvgIconConfig and creates an SVG element
-     * from it.
-     */
-    private _loadSvgIconSetFromConfig(config);
-    /**
-     * Creates a DOM element from the given SVG string, and adds default attributes.
-     */
-    private _createSvgElementForSingleIcon(responseText, config);
-    /**
-     * Searches the cached element of the given SvgIconConfig for a nested icon element whose "id"
-     * tag matches the specified name. If found, copies the nested element to a new SVG element and
-     * returns it. Returns null if no matching element is found.
-     */
-    private _extractSvgIconFromSet(iconSet, iconName, config);
-    /**
-     * Creates a DOM element from the given SVG string.
-     */
-    private _svgElementFromString(str);
-    /**
-     * Sets the default attributes for an SVG element to be used as an icon.
-     */
-    private _setSvgAttributes(svg, config);
-    /**
-     * Returns an Observable which produces the string contents of the given URL. Results may be
-     * cached, so future calls with the same URL may not cause another HTTP request.
-     */
-    private _fetchUrl(safeUrl);
-}