render a text field as a skuid icon property field in runtime

I’d like to provide users with the same icon-selection experience that we have in the skuid builder to populate an “Icon” field on the runtime side of a skuid page.


I once wanted the same thing. I recall that at the time it seemed infeasible.

Hmm.  I’m wondering if I can just add the skuid builder js files as static resources to the page, and somehow tap into the existing functions.

Here’s a beginning:

var field = arguments[0], value = arguments[1],<br>$ = skuid.$,<br>component = skuid.$C('new-item-component'),<br>props = {id:"icon", label:"Icon", type:"icon"};<br>field.element.append(skuid.builder.core.propertyRenderers.icon(props,component.element)); 

Does it work? If so, that would pretty cool.

It doesn’t work. It displays a field with the icon button, and if you put the name of an icon in the field the button will show that icon. But clicking the button doesn’t deliver the popup (I think because skuid is trying to get the page’s xml to get the theme to determine which icon sets to use, but I haven’t had time to explore farther).

Yes, the problem is definitely that skuid tries to get the theme from the page XML, but there is no ‘page xml’ on runtime. Skuid is running skuid.builder.core.getPageXML().attr(“theme”), but .attr(“theme”) throws an error because .getPageXML() returns null.

I think the only way around this would be to grab all the code that skuid uses up to that point in the creation of the input field and button and icon picker dialog, and the change the call for the function that returns the available icon sets to something that skuid can use… perhaps inserting the current theme instead of asking for the pageXML to get the theme.

Which seems like more trouble than it’s worth?

It works!!!

One caveat is that this seems to only be working if you use a custom theme. In the settings of the javascript resource you’ll need to replace “Optimize” and “OptimizeThemeZIP” with the name and resource name for your own custom theme. I’m not sure why, but when I try to use any of the standard skuid themes, no icons show up in the popup.

Proof of concept:

<skuidpage unsavedchangeswarning="yes" personalizationmode="server" showsidebar="false" useviewportmeta="true" showheader="false">
        <model id="Account" limit="1" query="true" createrowifnonefound="true" datasource="salesforce" type="" sobject="Account">
                <field id="Name"/>
                <field id="AccountNumber"/>
                <field id="Jigsaw"/>
        <basicfieldeditor showheader="true" showsavecancel="true" showerrorsinline="true" model="Account" buttonposition="" uniqueid="sk-2TCfqG-165" mode="read">
                <column width="50%">
                        <section title="Section A" collapsible="no">
                                <field id="Name"/>
                                <field id="AccountNumber"/>
                <column width="50%">
                        <section title="Section B" collapsible="no">
                                <field id="Jigsaw" valuehalign="" type="CUSTOM" snippet="renderIconSeletor">
            <jsitem location="staticresource" name="BuilderCoreJS" cachelocation="false" url="" namespace="skuid" content_type="text/javascript">var params = arguments[0],
$ = skuid.$;
            <jsitem location="staticresource" name="SkuidBuildersJS" cachelocation="false" url="" namespace="skuid" content_type="text/javascript">var params = arguments[0],
$ = skuid.$;
            <jsitem location="inline" name="customIconPickerJS" cachelocation="false" url="">// Icon Picker Javascript
 * Enter Parameters for your Theme
var themeName = "Optimize",
themeResourceName = "OptimizeThemeZIP";
//Global Shortcuts
var $ = a.$,
i = $.each,
j = a.builder.core, 
k = a.utils,
p = {}, 
q = "sk-icon",
r = j.updateState;
 * Skuid custom field renderer snippet
 * Use "renderIconSelector" as the custom renderer on a Text field
 * to turn that field into a skuid icon selector.
    var props = {id:"icon", label:"Icon", type:"icon"};
var input = field.element.find('input');
if (value) input.val(value);
 * Edited Skuid Code Below
function b(b) {
        var c, d, e, f, g, 
        h = {}, 
        j = themeName, 
        l = a.platform.getEntityFieldNames("theme"), 
        m = {
        Optimize: {
skuid__Resource_Name__c: themeResourceName
        if (m) {
            if (j ? (i(m, function(a, b) {
                if (b[] === j)
                    return g = b, !1;
            g &amp;amp;&amp;amp; (l.resource_namespace &amp;amp;&amp;amp; l.resource_name ? (e = g[l.resource_namespace],
            d = g[l.resource_name]) : (e = null,
            d = g[]))) : (f ="__"),
            2 === f.length ? (e = f[0],
            d = f[1]) : (e = null,
            d = f[0])),
            d &amp;amp;&amp;amp; (c = a.platform.themeBuilder.getThemeResourceUrl({
                name: d,
                namespace: e,
                modstamp: (new Date).getTime()
            c) {
                var o = {
                    Name: d,
                    NamespacePrefix: e
                p = a.$.map(["skuid_theme.json", "resources.json"], function(b) {
                    return a.platform.themeBuilder.getResource(o, b);
                a.$.when.all(p).done(function(a) {
                    var d = {
                        url: c,
                        "skuid_theme.json": k.isString(a[0]) ? JSON.parse(a[0]) : a[0],
                        "resources.json": k.isString(a[1]) ? JSON.parse(a[1]) : a[1]
                    b &amp;amp;&amp;amp; b(d);
            return h;
    function c(a) {
        p &amp;amp;&amp;amp; p[q] &amp;amp;&amp;amp; p[q].icons &amp;amp;&amp;amp; i(p[q].icons, function(b) {
            var c = b.substr(q.length + 1)
              , d = $("&amp;lt;div&amp;gt;").addClass("nx-picker-icon " + q + " " + b).attr("alt", c).attr("title", c)
              , e = $('&amp;lt;div class="nx-picker-icon-label"&amp;gt;').text(c);
            $('&amp;lt;div class="nx-picker-icon-wrapper"&amp;gt;').append(d, e).appendTo(a)
function customBuildIconPicker(a, d, e) {
        function f(a) {
            p = a["skuid_theme.json"].iconsets,
            p &amp;amp;&amp;amp; i(p, function(a, b) {
                var c = $("&amp;lt;div&amp;gt;").addClass("nx-picker-header-category").text(b.label);
      "category", a),
                q === a &amp;amp;&amp;amp; c.addClass("nx-picker-selected"),
      "prefix", a),
        var g = $("&amp;lt;div&amp;gt;").addClass("nx-picker-header").appendTo(a), 
        j = $("&amp;lt;input&amp;gt;").addClass("nx-picker-filter-input").attr("type", "text").appendTo(g),
        l = $("&amp;lt;div&amp;gt;").addClass("nx-picker-cancel inline sk-icon sk-icon-cancel").css({
            cursor: "pointer",
            margin: "0px 5px 4px"
        }).skootip("Clear Filter Text").appendTo(g),
        m = $("&amp;lt;div&amp;gt;").addClass("nx-picker-body").appendTo(a),
        n = $("&amp;lt;div&amp;gt;").addClass("nx-picker-header-category-wrapper").appendTo(g);
        $("&amp;lt;label&amp;gt;").text("Filter Icons: ").appendTo(g),
        n.on("click", ".nx-picker-header-category", function() {
            var a = $(this);
            q ="prefix"),
        k.delayInputCallback(j, function(a) {
            var b = m.parent();
            a = a.toLowerCase(),
            "" === a ? m.find(".nx-picker-icon-wrapper").show() : (m.find("." + q).not('[alt*="' + a + '"]').parent().hide(),
            m.find("." + q + '[alt*="' + a + '"]').filter(":hidden").parent().show()),
        m.skootip(), {
        m.on("click", ".nx-picker-icon-wrapper", function() {
            var b = $(this).children("." + q).first().attr("alt");
            d.val(q + "-" + b).change(),
            e.empty().removeClass().addClass("nx-picker-icon " + q + " inline " + q + "-" + b),
        p.length || b(f)
var renderIconProp = function(a, b) {
        var c, 
        e =, 
        f = !0 === a.isStateless, 
        i = e &amp;amp;&amp;amp; b.attr(e) || a.valueFunction &amp;amp;&amp;amp; a.valueFunction() || a.defaultValue || "", 
        j = $("&amp;lt;div&amp;gt;").addClass("nx-pagebuilder-property-button-area"), 
        l = $("&amp;lt;input&amp;gt;").attr("type", "text").addClass("nx-picker-icon-input").val(i).appendTo(j), 
        m = $("&amp;lt;button&amp;gt;").addClass("nx-picker-icon-btn nx-picker-icon-runtime"), 
        n = $("&amp;lt;div&amp;gt;"), 
        o = $("&amp;lt;div&amp;gt;").addClass("nx-pagebuilder-property-button-wrapper");
        if ("" === i ? n.removeClass().addClass("nx-picker-icon").text("?") : n.addClass("nx-picker-icon sk-icon " + i),
        a.readonly) {
            var p = $("&amp;lt;div&amp;gt;").addClass("nx-pagebuilder-property-button-area").append(g.readonly(i));
            return o.append(n).css("margin-top", "6px"),
            [o, p]
        return m.append(n),
        m.on("click", function() {
            c ? c.dialog("open") : (c = $("&amp;lt;div&amp;gt;"),
            customBuildIconPicker(c, l, n),
                width: 800,
                height: 400,
                title: "Choose an Icon",
                resizable: !0,
                modal: !0
        k.delayInputCallback(l, function(c) {
            "" === c ? n.removeClass().addClass("nx-picker-icon inline").text("?") : n.empty().removeClass().addClass("nx-picker-icon sk-icon inline " + c),
            f || r(b, {
                key: e,
                value: c
            a.onChange &amp;amp;&amp;amp; a.onChange(c)
        [o, j]
            <cssitem location="staticresource" name="SkuidBuildersCSS" cachelocation="false" url="" namespace="skuid" content_type="text/css"/>
            <cssitem location="inline" name="skuidpicker" cachelocation="false" url="" namespace="" content_type="">.nx-pagebuilder-toolbarpanel-body .nx-editor-contents .nx-pagebuilder-property-item {
    margin: 4px;
    background: #f9f9f9;
    border: null,null,1px solid #f0f0f0,null
.nx-pagebuilder-property-button-wrapper {
    float: right;
    margin: 1px
.nx-pagebuilder-property-button-area {
    margin-right: 36px
.nx-pagebuilder-property-button-area-inner {
    margin-top: 6px;
    word-wrap: break-word
.ui-dialog .nx-picker-wrapper.ui-dialog-content {
    padding: 0;
    overflow: hidden
.nx-picker-wrapper {
    display: none;
    padding-bottom: 10px
.nx-picker-body {
    overflow: auto;
    height: 302px;
    margin: 2px
.nx-picker-body .nx-picker-icon-wrapper {
    border: solid 1px #ccc;
    padding: 5px;
    margin: 3px;
    float: left;
    cursor: pointer;
    width: 114px
.nx-picker-body .nx-picker-icon-label {
    margin: 4px 4px 4px 3px;
    display: inline-block;
    vertical-align: middle;
    width: 81px;
    text-overflow: ellipsis;
    white-space: nowrap;
    overflow: hidden
.nx-picker-body .nx-picker-icon {
    margin: 4px;
    display: inline-block;
    vertical-align: middle
.nx-picker-header {
    margin: 5px 0 5px;
    border-bottom: solid 1px #ccc;
    padding: 10px;
    font-weight: bold
.nx-picker-icon-btn {
    cursor: pointer;
    min-height: 26px;
    min-width: 26px;
    background: #F1F1F1;
    border: 1px solid #c0c0c0;
    position: relative;
    top: -2px;
    -webkit-border-radius: 2px;
    -moz-border-radius: 2px;
    border-radius: 2px;
    color: #111;
    border-top-color: transparent;
    border-left-color: transparent;
    border-right-color: #888;
    border-bottom-color: #888
.nx-picker-icon-btn:focus {
    outline: none
.nx-picker-icon-btn:active {
    border: 1px solid #c0c0c0
.nx-picker-icon-btn.nx-disabled {
    opacity: .2;
    cursor: default
.nx-picker-input-wrapper input,.nx-picker-input-wrapper label {
    vertical-align: middle
.nx-picker-text-output {
    display: inline-block
.nx-picker-header-category-wrapper {
    float: right
.nx-picker-header-category {
    display: inline-block;
    margin: 2px;
    text-transform: capitalize;
    cursor: pointer;
    padding: 4px 6px;
    border-radius: 4px;
    font-weight: normal;
    font-size: 8pt
.nx-picker-selected {
    color: white;
    background: #0288d1
        <styleitem type="background" bgtype="none"/>

Got it to work as well! Awesome! Was all the css necessary?

I don’t know how much of the css is required. I just copied everything from skuid that used a class that the icon picker uses.