Package com.smartgwt.client.docs

# Interface StockIcons

public interface StockIcons

### StockIcons Overview

The StockIcons system allows known graphics to be re-used throughout your projects by using their names in src-strings, instead of their URLs or sprite-strings - this avoids the need for hard-coded paths in source-code, and allows the actual image applied by the StockIcon name to be easily modified at runtime without trawling through code doing find-and-replace operations.

StockIcons can also map from a known file-path, meaning that legacy paths in existing code don't need to be modified - if your code requests a file-path which is assigned to the fromSrc of a known StockIcon, it will first be mapped to that StockIcon, and then it will render whatever image is currently assigned to it.

The framework ships with many such StockIcon-definitions that represent the numerous images available in the "images/" directory of a skin. You can use these builtin definitions in your code directly, by setting a widget's icon or src property to the name of a StockIcon. For example, to re-use the current skin's default "Edit" icon, you could set the image-source for a button's `icon` to "[SKINIMG]actions/edit.png" in your code. With StockIcons, you can use just the associated icon's name, "Edit" - for example:

      isc.Button.create({ icon: "Edit" });
      isc.Img.create({ src: "Edit" });

You can also provide additional customization along with the StockIcon-name. For example, if your StockIcons are mapped to `stylable SVG Symbols` via `sprite-strings` (our Shiva skin does this), you can add a colon (":") right after the StockIcon-name and then include any additional properties that are supported by SVG sprite-strings, to modify this instance of the base StockIcon definition.

      // make it red and semi-transparent
      isc.Button.create({ icon: "Edit:color:red;opacity:0.5;" });
      // set a size and show it upside-down
      isc.Img.create({ src: "Edit:size:24,24;rotate:180;" });