@logimaxx/kgrid 0.3.1 → 0.5.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +4 -2
- package/dist/kgrid.js +1559 -124
- package/dist/kgrid.min.js +2 -2
- package/docs/ai-guide.md +24 -10
- package/docs/api.md +22 -4
- package/docs/configuration.md +62 -12
- package/docs/field-types.md +52 -1
- package/docs/table-shell.md +1 -0
- package/integrations/maxxops.example.js +0 -1
- package/package.json +1 -1
- package/src/cells.js +19 -1
- package/src/column-chooser.js +155 -0
- package/src/configure.js +66 -15
- package/src/constants.js +24 -1
- package/src/data-body.js +31 -53
- package/src/dom.js +24 -17
- package/src/events.js +37 -4
- package/src/field-types-builtins.js +296 -5
- package/src/filters.js +50 -6
- package/src/init.js +64 -4
- package/src/insert-row.js +19 -8
- package/src/preferences.js +408 -0
- package/src/row-actions.js +347 -0
- package/styles/table.css +156 -8
package/dist/kgrid.min.js
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
/*! @logimaxx/kgrid | (c) Logimaxx System SRL — proprietary | https://logimaxx.ro | built 2026-
|
|
2
|
-
!function(t){const e={log:function(){},onError:function(t){console.error(t)},confirm:function(t,e,n){"undefined"!=typeof window&&window.confirm(t)?e():n&&n()},deleteConfirm:null,serializeForm:function(t,e){const n=new FormData(t),r={};for(const[t,e]of n.entries())Object.prototype.hasOwnProperty.call(r,t)?(Array.isArray(r[t])||(r[t]=[r[t]]),r[t].push(e)):r[t]=e;return r},customInputTypes:null,fieldTypes:null,kviews:null,filterDebounceMs:300};t._config=Object.assign({},e),t.configure=function(e){return e&&"object"==typeof e&&Object.assign(t._config,e),"function"==typeof t._syncCustomInputTypes&&t._syncCustomInputTypes(),t},t.log=function(){t._config.log.apply(null,arguments)},t.onError=function(e){return t._config.onError(e)},t.confirm=function(e,n,r){return t._config.confirm(e,n,r)},t.DEFAULT_DELETE_CONFIRM_MESSAGE="Delete this record?",t._defaultDeleteConfirm=function(e,n,r){t.confirm(t.DEFAULT_DELETE_CONFIRM_MESSAGE,n,r)},t.runDeleteConfirm=function(e,n,r){const o=e.options&&"function"==typeof e.options.deleteConfirm?e.options.deleteConfirm:null,a="function"==typeof t._config.deleteConfirm?t._config.deleteConfirm:null;return(o||a||t._defaultDeleteConfirm)(e,n,r)},t.serializeForm=function(e,n){return t._config.serializeForm(e,n)},t.getKViews=function(e){const n=[e,t._config.kviews];for(let t=0;t<n.length;t++){const e=n[t];if(e&&"function"==typeof e.createCollectionInstance)return e}const r=("undefined"!=typeof window?window:"undefined"!=typeof globalThis?globalThis:{}).KViews;return r&&"function"==typeof r.createCollectionInstance?r:null},t.KVIEWS_MISSING_MSG="KGrid requires KViews: install peer @logimaxx/kviews, load it before kgrid.js (window.KViews), or call KGrid.configure({ kviews: KViews }). You can also pass kviews in table options: KGrid.init(host, { kviews, ... })."}(window.KGrid=window.KGrid||{}),function(t){t.protoOptions={url:null,type:null,filter:null,features:{filtering:!1,sorting:!1,paging:!1,create:!1,update:!1,delete:!1,clone:!1},defaultInteraction:"view",insertFormRow:{position:"top"},tableAttrs:{class:""},labelsRowAttrs:{},dataRowAttrs:{},filtersRowAttrs:null,pagingPageSizes:[10,25,50,75],pagingDefaultSize:10,emptyRowMessage:null,pagingFooterLabel:"records per page. Total"},t.protoColumnConfig={label:null,name:null,hidden:!1,class:null,columnClass:null,attrs:{},features:{create:!1,update:!1,filter:!1,sort:!1},display:{template:null,events:[]},input:null,insert:{type:"text",default:null,value:null,placeholder:null,disabled:!1,required:!1,options:null,events:[]},update:{type:"text",default:null,value:null,placeholder:null,disabled:!1,required:!1,options:null,template:null,events:[]},filter:{type:"text",operator:"~=~",default:null,placeholder:"",options:null,persist:!1,debounceMs:null}},t.VALID_NATIVE_INPUT_TYPES=["displayonly","text","textarea","number","date","datetime","time","checkbox","radio","file","password","email","url","search","tel","select","hidden"],t.VALID_INPUT_TYPES=t.VALID_NATIVE_INPUT_TYPES.slice(),t.VALID_NATIVE_FILTER_TYPES=t.VALID_NATIVE_INPUT_TYPES.filter(t=>"displayonly"!==t),t.VALID_FILTER_TYPES=t.VALID_NATIVE_FILTER_TYPES.concat(["multi_select","date_range"]),t.isValidInputType=function(e){return t.VALID_NATIVE_INPUT_TYPES.includes(e)||t.isPluggableFieldType(e)},t.isValidFilterType=function(e){return"displayonly"!==e&&(t.VALID_NATIVE_FILTER_TYPES.includes(e)||t.isPluggableFieldType(e))}}(window.KGrid=window.KGrid||{}),function(t){t.isPlainObject=function(t){return null!=t&&"object"==typeof t&&!Array.isArray(t)},t.setDefaultValues=function(e,n){const r={...e||{}};return Object.keys(n||{}).forEach(e=>{t.isPlainObject(n[e])&&t.isPlainObject(r[e])?r[e]=t.setDefaultValues(r[e],n[e]):t.isPlainObject(n[e])&&null==r[e]?r[e]=t.setDefaultValues({},n[e]):r[e]=n[e]}),r},t.normalizeColumnConfig=function(e){let n=e&&"object"==typeof e?{...e}:{};if(t.isPlainObject(n.input)){const e={...n.input};delete n.input,n.insert=t.setDefaultValues(e,n.insert||{}),n.update=t.setDefaultValues(e,n.update||{})}const r=t.setDefaultValues(t.protoColumnConfig,n);return null==r.class&&r.columnClass&&(r.class=r.columnClass),r.update&&"displayonly"===r.update.type&&!r.update.template&&r.display&&r.display.template&&(r.update.template=r.display.template),["display","insert","update"].forEach(t=>{r[t]&&"object"==typeof r[t]&&(Array.isArray(r[t].events)||(r[t].events=[]))}),r}}(window.KGrid),function(t){t.resolveHostElement=function(t){if(null==t)throw new TypeError("KGrid.init(host, opts): host is required");if("object"==typeof t&&t.jquery){if(!t.length)throw new Error("KGrid.init(host, opts): empty jQuery selection");return t}if("object"==typeof t&&1===t.nodeType&&"string"==typeof t.nodeName)return $(t);throw new TypeError("KGrid.init(host, opts): host must be a DOM Element or jQuery object")},t.uuid=function(){return Math.random().toString(36).substring(2,15)+Math.random().toString(36).substring(2,15)},t.hasActionColumn=function(t){const e=t&&t.features;return!!e&&!!(e.delete||e.update||e.create||e.clone)},t.syncActionColumnColgroup=function(t,e,n){let r=t.children("colgroup.kgrid-colgroup");r.length||(r=$("<colgroup>").addClass("kgrid-colgroup").prependTo(t)),r.empty();for(let t=0;t<e;t++)r.append($("<col>"));n&&r.append($("<col>").addClass("kgrid-row-actions-col"))},t.anchorRowForm=function(t,e){if(!(t&&t.length&&e&&e.length))return t;t.attr("hidden","hidden").attr("aria-hidden","true");const n=e.children("td").first();return n.length&&t.prependTo(n),t},t.filterFormField=function(t,e){if(!t||!e)return $();const n=t.elements&&t.elements.namedItem(e);if(n)return $(n);if(t.id){const n=document.querySelector(`[form="${t.id}"][name="${e}"]`);if(n)return $(n)}return $()},t.columnClassName=function(t){if(!t)return null;const e=null!=t.class&&""!==t.class?t.class:t.columnClass;return null!=e&&""!==e?String(e):null},t.applyColumnCellMeta=function(e,n){if(!e||!e.length||!n)return e;n.name&&e.attr("data-name",n.name);const r=t.columnClassName(n);return r&&e.addClass(r),e}}(window.KGrid),function(t){t.DEFAULT_EMPTY_ROW_MESSAGE="No records match your search.",t.TABLE_SHELL_TEMPLATE='\n<table class="custom-table" style="table-layout: fixed;">\n <thead class="thead-labels">\n <tr>\n <th class="align-top">\n <a class="sort" data-sortfld="" style="cursor: pointer;">\n <span class="column-label"></span>\n <i class="fas fa-sort-up sort-up" style="display: none"></i>\n <i class="fas fa-sort-down sort-down" style="display: none"></i>\n <i class="fas fa-sort sort-default"></i>\n </a>\n </th>\n </tr>\n </thead>\n <thead class="thead-filters"></thead>\n <tbody class="before-main-tbody"></tbody>\n <tbody class="main-tbody"></tbody>\n <tbody class="after-main-tbody"></tbody>\n <tbody class="no-data-tbody">\n <tr><td>{{EMPTY_ROW_MESSAGE}}</td></tr>\n </tbody>\n <tfoot class="paging-footer">\n <tr>\n <td>\n <div class="btn-group pages" data-pagesize="{{PAGES_DATA_PAGESIZE}}">\n <button type="button" name="first" class="btn btn-sm btn-outline-secondary"><<</button>\n <button type="button" name="prev" class="btn btn-sm btn-outline-secondary"><</button>\n <button type="button" name="page" class="btn btn-sm btn-outline-secondary">1</button>\n <button type="button" name="next" class="btn btn-sm btn-outline-secondary">></button>\n <button type="button" name="last" class="btn btn-sm btn-outline-secondary">>></button>\n </div>\n <select class="pagesize">\n{{PAGE_SIZE_OPTIONS}}\n </select>\n {{PAGING_FOOTER_LABEL}} <span class="totalrecscount"></span>\n </td>\n </tr>\n </tfoot>\n</table>'.trim(),t._escapeTableShellText=function(t){return String(t).replace(/&/g,"&").replace(/</g,"<").replace(/>/g,">").replace(/"/g,""")},t._renderPageSizeOptions=function(t,e){return t.map(t=>{const n=String(t);return` <option value="${n}"${n===String(e)?" selected":""}>${n}</option>`}).join("\n")},t.renderTableShellHtml=function(e,n){const r=Array.isArray(e.pagingPageSizes)?e.pagingPageSizes:[10,25,50,75],o=null!=e.pagingDefaultSize?e.pagingDefaultSize:r[0],a=t._escapeTableShellText(e.emptyRowMessage||t.DEFAULT_EMPTY_ROW_MESSAGE),l=t._escapeTableShellText(e.pagingFooterLabel||"records per page. Total");return(n||t.TABLE_SHELL_TEMPLATE).replace(/\{\{EMPTY_ROW_MESSAGE\}\}/g,a).replace(/\{\{PAGES_DATA_PAGESIZE\}\}/g,String(o)).replace(/\{\{PAGE_SIZE_OPTIONS\}\}/g,t._renderPageSizeOptions(r,o)).replace(/\{\{PAGING_FOOTER_LABEL\}\}/g,l)},t.createTableShell=function(e){const n=t.renderTableShellHtml(e),r=$.parseHTML(n,document,!0),o=$(r).filter("table").first();if(!o.length)throw new Error("KGrid TABLE_SHELL_TEMPLATE must contain a root <table> element");return e.tableAttrs&&t.isPlainObject(e.tableAttrs)&&(Object.keys(e.tableAttrs).forEach(t=>{"class"!==t&&o.attr(t,e.tableAttrs[t])}),"string"==typeof e.tableAttrs.class&&e.tableAttrs.class&&o.addClass(e.tableAttrs.class)),o},t.mountTableShell=function(e,n){const r=e.find("table.custom-table, table").first();if(r.length)return r;const o=t.getTableInteractionHost(e);o.hasClass("custom-table-shell")||o.addClass("custom-table-shell");const a=t.createTableShell(n);return o.append(a),a}}(window.KGrid),function(t){t._fieldTypes=Object.create(null),t._configuredCustomInputTypeNames=[],t.registerFieldType=function(e,n,r){if(!e||"string"!=typeof e)throw new TypeError("registerFieldType(name, plugin): name must be a string");if(!n||"function"!=typeof n.create)throw new TypeError("registerFieldType("+e+"): plugin.create is required");if(t._fieldTypes[e]&&(!r||!r.overwrite))throw new Error("Field type already registered: "+e);return t._fieldTypes[e]=Object.assign({name:e},n),t},t.unregisterFieldType=function(e){return e&&t._fieldTypes[e]&&delete t._fieldTypes[e],t},t.getFieldType=function(e){return e&&t._fieldTypes[e]||null},t.listFieldTypes=function(){return Object.keys(t._fieldTypes)},t.createFieldInput=function({mode:e,col:n,config:r}){const o=r.type??"text",a=t.getFieldType(o);if(!a)return null;"function"==typeof a.validate&&a.validate(r,e,n);const l=a.create({mode:e,col:n,config:r});if(!l||!l.$input||!l.$input.length)throw new Error('Field type "'+o+'" create() must return { $input: jQuery }');return l.$input.attr("data-type",o),l},t.mountField=function(e){const n=e.config?.type??e.type,r=t.getFieldType(n);r&&"function"==typeof r.mount&&r.mount(e)},t.resolveFilterEvents=function({plugin:t,$input:e,createResult:n}){let r;return n&&Object.prototype.hasOwnProperty.call(n,"filterEvents")?r=n.filterEvents:t&&Object.prototype.hasOwnProperty.call(t,"filterEvents")&&(r=t.filterEvents),!1===r||null===r?null:"string"==typeof r&&r.trim()?r.trim():e.is("select")?"change":"input"},t.normalizeFilterDebounceMs=function(t,e){if(!1===t)return 0;if(void 0===t)return e;if(null===t)return e;const n=Number(t);return!Number.isFinite(n)||n<0?0:n},t.resolveFilterDebounceMs=function({filterConfig:e,plugin:n}){return e&&Object.prototype.hasOwnProperty.call(e,"debounceMs")&&null!==e.debounceMs?t.normalizeFilterDebounceMs(e.debounceMs,0):n&&Object.prototype.hasOwnProperty.call(n,"filterDebounceMs")&&null!==n.filterDebounceMs?t.normalizeFilterDebounceMs(n.filterDebounceMs,0):t.normalizeFilterDebounceMs(t._config.filterDebounceMs,0)},t.shouldDebounceFilterSubmit=function(t,e){return!(!e||e<=0)&&!!t},t.bindFieldFilterSubmit=function(e,n,r){const o=t.getFieldType(e);o&&"function"==typeof o.bindFilterSubmit&&o.bindFilterSubmit(n,r)},t.bindFilterInputEvents=function({type:e,$input:n,onSubmit:r,createResult:o,filterConfig:a}){const l=e?t.getFieldType(e):null,i=t.resolveFilterEvents({plugin:l,$input:n,createResult:o}),s=t.resolveFilterDebounceMs({filterConfig:a,plugin:l}),u=t.wrapFilterSubmitHandler(n,r,i,s);i&&n.on(i,u),t.bindFieldFilterSubmit(e,n,u)},t.isPluggableFieldType=function(e){return!!t.getFieldType(e)},t.inputType=function(t,e){if("function"!=typeof t)throw new TypeError("inputType(mount, opts): mount must be a function");if(!e||"string"!=typeof e.element)throw new TypeError("inputType(mount, opts): opts.element is required (HTML string)");return{filterEvents:e.filterEvents,filterDebounceMs:e.filterDebounceMs,validate:e.validate,create({mode:t}){const n=$(e.element);return!e.formInputClass||"insert"!==t&&"update"!==t||n.addClass(e.formInputClass),{$input:n,skipValueAttr:!!e.skipValueAttr}},mount(e){t(e.$input,e.config?.options??e.config,e)},bindFilterSubmit:e.bindFilterSubmit}},t._getCustomInputTypesConfig=function(){return t._config.customInputTypes??t._config.fieldTypes??null},t._syncCustomInputTypes=function(){const e=t._getCustomInputTypesConfig(),n=e&&"object"==typeof e?Object.keys(e).filter(t=>null!=e[t]):[];t._configuredCustomInputTypeNames.forEach(e=>{n.includes(e)||t.unregisterFieldType(e)}),n.forEach(n=>{const r=e[n];if(!r||"object"!=typeof r||"function"!=typeof r.create){if("function"==typeof r)throw new Error("customInputTypes."+n+' is a function — use a plugin, e.g. KGrid.select2(fn) or KGrid.inputType(fn, { element: "..." })');throw new TypeError("customInputTypes."+n+" must be a plugin with create()")}t.registerFieldType(n,r,{overwrite:!0})}),t._configuredCustomInputTypeNames=n.slice()}}(window.KGrid),function(t){t.registerFieldType("multi_select",{create({config:t}){const e=$("<select class='form-select form-select-sm' multiple>");return Array.isArray(t.options)&&t.options.forEach(t=>{$("<option>").text(t.label).attr("value",t.value).appendTo(e)}),{$input:e,skipValueAttr:!0}}}),t.registerFieldType("date_range",{create:()=>({$input:$("<input autocomplete='off' type='date' class='form-control form-control-sm'/>")})})}(window.KGrid),function(t){t.resolveDefaultInteraction=function(t){return"edit"===t.defaultInteraction||"view"===t.defaultInteraction?t.defaultInteraction:!0===t.editmode?"edit":(t.editmode,"view")},t.getTableInteractionHost=function(t){if(t.hasClass("custom-table-shell"))return t;const e=t.find(".custom-table-shell").first();return e.length?e:t},t.applyInteraction=function(e,n,r){const o=t.getTableInteractionHost(e),a="edit"===n?"edit":"view";o.attr("data-interaction",a),r&&"object"==typeof r?(void 0!==r.create&&o.attr("data-allow-insert",r.create?"true":"false"),void 0!==r.update&&o.attr("data-allow-update",r.update?"true":"false"),void 0!==r.delete&&o.attr("data-allow-delete",r.delete?"true":"false"),void 0!==r.clone&&o.attr("data-allow-clone",r.clone?"true":"false")):"edit"===a&&o.removeAttr("data-allow-insert data-allow-update data-allow-delete data-allow-clone")}}(window.KGrid),function(t){t.setupLabelsHeader=function(e,n){const r=e.children("tr"),o=r.children(),a=o.first().clone(!0);o.remove();return[...n.columns].forEach(e=>{if(e.hidden)return;let n=a.clone(!0);if(e.attrs&&"object"==typeof e.attrs&&Object.keys(e.attrs).forEach(t=>n.attr(t,e.attrs[t])),t.applyColumnCellMeta(n,e),!e.features?.sort){const o=n.empty().html(e.label??"");return t.applyColumnCellMeta(o,e),void r.append(o)}if(!e.name)throw new Error("Column must have a name when column.sortable is true: \n"+JSON.stringify(e,null,2));n.find("span.column-label").text(e.label??""),n.children("a").attr("data-sortfld",e.name),n.appendTo(r)}),t.hasActionColumn(n)&&$("<th>").addClass("kgrid-row-actions").attr("aria-label","Actions").appendTo(r),r}}(window.KGrid),function(t){const e="kgridFilterDebounceTimer";t.cancelFilterSubmit=function(t){const n=t.data(e);n&&(clearTimeout(n),t.removeData(e))},t.cancelFilterDebounces=function(e){const n=$(e).attr("id");n&&$(document).find("[form='"+n+"']").each(function(){t.cancelFilterSubmit($(this))})},t.flushFilterSubmit=function(t){const n=t.data(e);if(!n)return;clearTimeout(n),t.removeData(e);const r=t[0]&&t[0].form;r&&$(r).trigger("submit")},t.wrapFilterSubmitHandler=function(n,r,o,a){if(!t.shouldDebounceFilterSubmit(o,a))return r;const l=a;return function(){t.cancelFilterSubmit(n);const o=setTimeout(function(){n.removeData(e),r.call(this)}.bind(this),l);n.data(e,o)}},t.filterDefaultValue=function(t){return null!=t&&"object"==typeof t&&null!=t.value?t.value:t},t.columnFilterPersisted=function(t){const e=t&&t.filter?t.filter:{};return!(!t||!t.hidden&&"hidden"!==e.type&&!e.persist)},t.ensureFilterField=function(t,e,n,r){if(!t||!e||null==n||""===n)return null;let o=t.elements&&t.elements.namedItem(e);return o&&null!=o.length&&!o.tagName&&(o=o[0]),o&&o.tagName||(o=document.createElement("input"),o.type="hidden",o.name=e,t.appendChild(o)),o.setAttribute("data-operator",r||"="),o.value=String(n),o.defaultValue=String(n),o},t.applyColumnDefaultFilters=function(e,n){e&&n&&n.forEach(function(n){if(!n.name||n.features&&!1===n.features.filter)return;const r=n.filter;if(!r||null==r.default||""===r.default)return;const o=t.filterDefaultValue(r.default);if(null==o||""===o)return;const a=r.operator||(t.columnFilterPersisted(n)?"=":"~=~"),l=t.filterFormField(e,n.name);!n.hidden&&"hidden"!==r.type&&l.length?l.val()||(l.val(String(o)),l.attr("data-operator",a)):t.ensureFilterField(e,n.name,o,a)})},t.setupDefaultFilters=function(e,n,r){const o=$(e)[0];if(!(o&&n&&n.features&&n.features.filtering))return;const a=n.columns||[];if(t.applyColumnDefaultFilters(o,a),a.some(t.columnFilterPersisted)){let e=!1;$(o).off("reset.kgridDefaultFilters").on("reset.kgridDefaultFilters",function(n){if(!e){n.preventDefault(),t.cancelFilterDebounces(o),e=!0;try{o.reset(),t.applyColumnDefaultFilters(o,a),r&&r.filtering&&"function"==typeof r.filtering.handleSubmit?r.filtering.handleSubmit(o):$(o).trigger("submit")}finally{e=!1}}})}if(!r||!r.filtering)return;const l=a.filter(function(e){return e.name&&e.filter&&null!=e.filter.default&&""!==e.filter.default&&t.columnFilterPersisted(e)});if(!l.length)return;const i=String(r.url&&r.url.parameters&&r.url.parameters.filter||"");l.some(function(t){return-1===i.indexOf(t.name+"=")})&&r.filtering.handleSubmit(o)},t.setupFilterHeader=function(e,n){if(!n.features||!n.features.filtering)return null;const r=e.find(".thead-filters");r.empty();const o=[...n.columns],a=$("<tr>");a.appendTo(r);const l="filter_form_"+t.uuid(),i=$("<form>").attr("id",l).attr("hidden","hidden").attr("aria-hidden","true").addClass("table-filter-form").insertBefore(e);return o.forEach(e=>{const n=e.filter||{};if(e.hidden||"hidden"===n.type){if(e.features&&!1===e.features.filter)return;if(!e.name)return;const r=t.filterDefaultValue(n.default);return void(null!=r&&""!==r?t.ensureFilterField(i[0],e.name,r,n.operator||"="):t.columnFilterPersisted(e)&&t.ensureFilterField(i[0],e.name,"",n.operator||"="))}let r,o=$("<th>").appendTo(a).attr("data-label",e.label);if(t.applyColumnCellMeta(o,e),!1===e.features.filter)return;if(!e.name)throw new Error("Column must have a name when column.features.filter is true: \n"+JSON.stringify(e,null,2));let s=null;const u=t.createFieldInput({mode:"filter",col:e,config:n});if(u)s=u,r=u.$input,r.appendTo(o),t.mountField({mode:"filter",$input:r,col:e,config:n});else if("select"===n.type){if(!n.options)throw new Error("Column must have a filter.options array when column.filter.type is select: \n"+JSON.stringify(e,null,2));if(r=$("<select>").addClass("form-select form-select-sm"),!Array.isArray(n.options))throw new Error("Column must have a filter.options array when column.filter.type is select: \n"+JSON.stringify(e,null,2));n.options.forEach(t=>{if(!t.label||"string"!=typeof t.value)throw new Error("Column must have an filter.options object with label and value when column.filter.type is select: \n"+JSON.stringify(e,null,2));$("<option>").text(t.label).attr("value",t.value).appendTo(r)}),r.appendTo(o)}else{if(!t.isValidFilterType(n.type))throw new Error("Unknown filter type: "+n.type);r=$(`<input autocomplete='off' type='${n.type}' class='form-control form-control-sm'/>`),r.appendTo(o)}r.attr("data-operator",n.operator),r.attr("form",l),r.attr("name",e.name);const c=t.filterDefaultValue(n.default);null==c||""===c||r.val()||(r.val(String(c)),r.attr("data-default",String(c)),r[0]&&(r[0].defaultValue=String(c)));t.bindFilterInputEvents({type:n.type,$input:r,onSubmit:function(){const t=this.form;t&&$(t).trigger("submit")},createResult:s,filterConfig:n})}),t.hasActionColumn(n)&&$("<th>").addClass("kgrid-row-actions").attr("data-label","Actions").appendTo(a),i},t.FilterForm=function(e){this.form=$(e)[0],this.filter=(e,n,r="~=~")=>{if(!this.form)return this;let o=t.filterFormField(this.form,e);if(o.length||(t.ensureFilterField(this.form,e,n,r),o=t.filterFormField(this.form,e)),!o.length)return this;t.flushFilterSubmit(o),o.val(n);const a=o.attr("data-operator");return o.attr("data-operator",r),$(this.form).trigger("submit"),o.attr("data-operator",a),this},this.ensure=(e,n,r="=")=>(t.ensureFilterField(this.form,e,n,r),this),this.reset=()=>(this.form&&(t.cancelFilterDebounces(this.form),this.form.reset()),this)}}(window.KGrid),function(t){t.setupCell=function(e,n){const r=n?n.attr("id"):null,o={...e},a=$("<td>").attr("data-label",e.label);t.applyColumnCellMeta(a,e);const l=o.attrs&&"object"==typeof o.attrs?o.attrs:{};Object.keys(l).forEach(t=>a.attr(t,l[t]));let i=$("<div>").addClass("cell-content");if(i.html(o.display.template??`{{${o.name}}}`),i.appendTo(a),null==n||!e.features.update)return i.clone(!0).removeClass("cell-content").addClass("cell-input").appendTo(a),a;if(!o.name)throw new Error("Column must have a name when column.features.update is true: \n"+JSON.stringify(e,null,2));const s=o.update,u=s.type??"text";let c,f=!1;const d=t.createFieldInput({mode:"update",col:e,config:s});if(d)c=d.$input,f=!!d.skipValueAttr;else{switch(u){case"textarea":c=$(`<textarea class='form-input form-control form-control-sm'>{{${s.value??o.name}}}</textarea>`),f=!0;break;case"select":if(c=$("<select class='form-input form-control form-control-sm'/>"),!Array.isArray(s.options))throw new Error("Select column must have an update.options array when column.features.update is true: \n"+JSON.stringify(e,null,2));s.options.forEach(t=>{if("string"!=typeof t.label||void 0===t.value)throw new Error("Select update.options entries need label and value: \n"+JSON.stringify(e,null,2));$("<option>").text(t.label).attr("value",t.value).appendTo(c)}),f=!0;break;case"hidden":c=$("<input type='hidden' class='form-input form-control form-control-sm'/>");break;case"displayonly":{const t=s.template||o.display.template||`{{${o.name}}}`;return $("<div>").addClass("cell-input").append(t).appendTo(a),a}default:if(!t.isValidInputType(u))throw new Error("Invalid update updateConfig type: "+JSON.stringify(s,null,2));c=$(`<input autocomplete='off' type='${u}' class='form-input form-control form-control-sm'/>`)}c.attr("data-type",u)}if(s.attrs&&"object"==typeof s.attrs&&Object.keys(s.attrs).forEach(t=>c.attr(t,s.attrs[t])),c.attr("form",r),c.attr("name",o.name),!f&&"textarea"!==u){const t=s.value??`{{${o.name}}}`;null!=t&&"object"!=typeof t&&c.attr("value",t)}return o.hidden?(c.attr("type","hidden").appendTo(n),a):(s.disabled&&c.attr("disabled",!0),s.readonly&&c.attr("readonly",!0),s.required&&c.attr("required",!0),s.attrs&&"object"==typeof s.attrs&&Object.keys(s.attrs).forEach(t=>c.attr(t,s.attrs[t])),s.disabled||s.readonly||c.attr("onchange","$(this).parents('tr').addClass('editing')"),$("<div>").addClass("cell-input").append(c).appendTo(a),a)}}(window.KGrid),function(t){t.setupNoDataTbody=function(t,e,n){const r=t.find("td").attr("colspan",n);return e.noDataTemplate&&r.html(e.noDataTemplate),r},t.setupDataBody=function(e,n,r,o,a,l){const i=[...n.columns],s=$("<tr>").appendTo(e);if(n.dataRowAttrs&&"object"!=typeof n.dataRowAttrs)throw new Error("options.dataRowAttrs must be an object");const u={...n.dataRowAttrs??{}};Object.keys(u).forEach(t=>s.attr(t,u[t])),e.data("emptyview",l),n?.features?.sorting&&e.data("sort",r),a&&e.data("paging",a.find(".pages")).data("pagesizeinp",a.find(".pagesize")).data("totalrecscount",a.find(".totalrecscount")),o&&e.data("filter",o),n.type&&e.data("type",n.type);const c="data_row_form_"+t.uuid()+"_{{this.id}}",f=n.features.update?$("<form class='edit-form table-row-form'>").attr("id",c):null;if(i.forEach(e=>{const n=t.setupCell(e,f);e.hidden||n.appendTo(s)}),t.hasActionColumn(n)){const t=$("<td>").addClass("kgrid-row-actions").appendTo(s);if(n.features.clone&&$("<div>").addClass("btn-group clone-item-grp").appendTo(t).append($("<button>").addClass("btn btn-sm btn-outline-secondary clone-item").attr("type","button").attr("title","Clone item").append("<i class='fa-regular fa-copy'></i>")),n.features.delete&&$("<div>").addClass("btn-group delete-item-grp").appendTo(t).append($("<button>").addClass("btn btn-sm btn-danger delete-item").attr("type","button").attr("title","Delete item").append("<i class='fas fa-trash'></i>")),n.features.update){const e=$("<div>").addClass("btn-group edit-item-grp").appendTo(t);$("<button>").addClass("btn btn-sm btn-success save-item").attr("type","submit").attr("name","save").attr("title","Save item").attr("form",c).html("<i class='fas fa-save'></i>").appendTo(e),$("<button>").addClass("btn btn-sm btn-secondary cancel-edit").attr("type","button").attr("name","cancel").attr("title","Cancel edit").attr("form",c).attr("onclick","$(this).parents('[data-type=item]').data().instance.loadFromRemote()").html("<i class='fas fa-undo'></i>").appendTo(e)}}return f&&t.anchorRowForm(f,s),e},t.setupPagingFooter=function(e,n,r){return t.log("setupPagingFooter",e,n,r),n.pagingFooterAttrs&&t.isPlainObject(n.pagingFooterAttrs)&&Object.keys(n.pagingFooterAttrs).forEach(t=>e.attr(t,n.pagingFooterAttrs[t])),t.log("noVisibleCols",r),e.find("td").attr("colspan",r),e}}(window.KGrid),function(t){t.setupNewRecordForm=function(e,n,r){if(!n.insertFormRow||!t.isPlainObject(n.insertFormRow))return e.find(".before-main-tbody").remove(),void e.find(".after-main-tbody").remove();const o=[...n.columns],a=$("<tr>").addClass("new-record-row");"top"===(n.insertFormRow?.position??"top")?(e.find(".after-main-tbody").remove(),a.appendTo(e.find(".before-main-tbody"))):(e.find(".before-main-tbody").remove(),a.appendTo(e.find(".after-main-tbody")));const l="new_record_row_form_"+t.uuid(),i=$("<form class='table-row-form'>").attr("id",l).off("submit").on("submit",e=>{e.preventDefault();const a=t.serializeForm(e.target,o);Object.keys(a).forEach(t=>{o.find(e=>e.name===t)?.insert?.dontsave&&delete a[t]}),r.instance.newItem(a).then(()=>{e.target.reset(),"function"==typeof n.onNewItemCreated&&n.onNewItemCreated(a)}).catch(t.onError)});o.forEach(e=>{if(e.hidden){if(n.features?.create&&e.features?.create){const t=$("<input type='hidden'>").attr("name",e.name).attr("form",l).appendTo(i);e.insert.default&&t.val(e.insert.default)}return}if(!e.features.create){const n=$("<td>").appendTo(a).attr("data-label",e.label);return void t.applyColumnCellMeta(n,e)}const r=e.insert;if(!r||!t.isPlainObject(r))throw new Error("Column must have an insert config object when column.features.create is true: \n"+JSON.stringify(e,null,2));if(!r.type)throw new Error("Column must have an insert.type when column.features.insert is true: \n"+JSON.stringify(e,null,2));let o;const s=r.type??"text",u=t.createFieldInput({mode:"insert",col:e,config:r});if(u)o=u.$input;else switch(s){case"textarea":o=$("<textarea class='form-input form-control form-control-sm'>");break;case"select":if(o=$("<select class='form-input form-control form-control-sm'/>"),!r.options||!Array.isArray(r.options))throw new Error("Column must have an insert.options array when column.features.insert is true: \n"+JSON.stringify(e,null,2));r.options.forEach(t=>{if("string"!=typeof t.label||void 0===t.value)throw new Error("Column must have an insert.options object with label and value when column.features.insert is true: \n"+JSON.stringify(e,null,2));$("<option>").text(t.label).attr("value",t.value).appendTo(o)});break;case"hidden":o=$("<input type='hidden' class='form-input form-control form-control-sm'/>");break;default:if(!t.isValidInputType(s))throw new Error("Invalid type: "+JSON.stringify(r,null,2));o=$(`<input autocomplete='off' type='${s}' class='form-input form-control form-control-sm'/>`),o.attr("data-type",s)}if(null!=r.default&&""!==r.default&&!o.val()){const t="object"==typeof r.default&&null!=r.default.value?r.default.value:r.default;String(t).trim()&&o.val(t).trigger("change")}if(r.attrs&&"object"==typeof r.attrs&&Object.keys(r.attrs).forEach(t=>o.attr(t,r.attrs[t])),o.attr("form",l).attr("name",e.name),r.disabled&&o.attr("disabled",!0),r.readonly&&o.attr("readonly",!0),r.required&&o.attr("required",!0),r.attrs&&"object"==typeof r.attrs&&Object.keys(r.attrs).forEach(t=>o.attr(t,r.attrs[t])),"hidden"!==r.type){const n=$("<td>").append(o).appendTo(a).attr("data-label",e.label);t.applyColumnCellMeta(n,e)}t.mountField({mode:"insert",$input:o,col:e,config:r,formEl:i[0],rowEl:a[0]}),r.events&&Array.isArray(r.events)&&r.events.forEach(t=>{o.off(t.event).on(t.event,function(e,...n){"function"==typeof t.callback&&t.callback(e,i[0],a[0],...n)})})}),t.anchorRowForm(i,a);const s=$("<td>").addClass("kgrid-row-actions").appendTo(a).attr("data-label","action"),u=$("<div>").addClass("btn-group").appendTo(s);return $("<button>").addClass("btn btn-sm btn-primary new-item-btn").html("<i class='fas fa-plus-square'></i>").attr("form",l).attr("type","submit").appendTo(u),"function"==typeof n.onInsertRowReady&&n.onInsertRowReady(i[0],a[0]),a}}(window.KGrid),function(t){t.setupEvents=function(e,n,r,o){const a=e.views[0];r.columns.forEach(n=>{n.display.events.forEach(t=>{if(!t.selector||!t.event||!t.callback)throw new Error("Invalid event: "+JSON.stringify(t,null,2));a.el.find(t.selector).off(t.event).on(t.event,n=>{if("function"!=typeof t.callback)throw new Error("Event callback must be a function: "+JSON.stringify(t,null,2));t.callback(n,e,a)})}),r.features.update&&n.update.events.forEach(r=>{if(!r.event||!r.callback)throw new Error("Invalid event: "+JSON.stringify(r,null,2));a.el.find("[name='"+n.name+"']").off(r.event).on(r.event,function(n,...o){if(t.log("event",r,n,this,o),"function"!=typeof r.callback)throw new Error("Event callback must be a function: "+JSON.stringify(r,null,2));r.callback(n,e,a,...o)})})}),r.features.update&&(a.el.find("[data-type]").each((n,r)=>{const l=r.getAttribute("data-type");if(!t.isPluggableFieldType(l))return;const i=o.get(r.name);i?.update&&t.mountField({mode:"update",$input:$(r),col:i,config:i.update,item:e,view:a})}),a.el.find("select[data-type='select']").each((t,n)=>{const r=o.get(n.name);if(!r)return;const a=e.attributes[r.name];null!=a&&""!==a&&$(n).val("boolean"==typeof a?String(a):a)}),a.el.find("form.edit-form").off("submit").on("submit",e=>{const n=e.target;e.preventDefault();const o=$(n).parents("[data-type=item]").data().instance,a=t.serializeForm(n);Object.keys(a).forEach(t=>{r.columns.find(e=>e.name===t)?.update?.dontsave&&delete a[t]}),o.update(a).catch(t.onError)})),r.features.clone&&a.el.find("button.clone-item").off("click").on("click",t=>{t.preventDefault(),"function"==typeof r.onClone&&r.onClone(e,a,t)}),r.features.delete&&a.el.find("button.delete-item").off("click").on("click",n=>{n.preventDefault(),a.el.addClass("confirm-delete");const o=()=>a.el.removeClass("confirm-delete");t.runDeleteConfirm({item:e,view:a,options:r},()=>{e.delete().catch(t.onError).finally(o)},o)}),"function"==typeof r.onRowFields&&r.onRowFields(e,a,n)}}(window.KGrid),function(t){t.init=async function(e,n){const r=t.resolveHostElement(e),o={...t.protoOptions,...n},a=t.mountTableShell(r,o);t.log("table config options",o);const l=t.resolveDefaultInteraction(o);t.applyInteraction(r,l);const i={$host:r,instance:null,filterForm:null,find:t=>r.find(t),setInteraction:(e,n)=>(t.applyInteraction(r,e,n),i),getInteraction:()=>"edit"===t.getTableInteractionHost(r).attr("data-interaction")?"edit":"view",setEditMode(t){if("boolean"!=typeof t)throw new TypeError("setEditMode(editMode) expects a boolean (true = edit, false = view)");return i.setInteraction(t?"edit":"view")},toggleEditMode:t=>(null!=t&&"object"==typeof t&&"function"==typeof t.preventDefault&&(t=void 0),"boolean"==typeof t?i.setInteraction(t?"edit":"view"):i.setInteraction("edit"===i.getInteraction()?"view":"edit"))};o.columns=o.columns.map(e=>t.normalizeColumnConfig(e));const s=o.handlers??{};if(delete o.handlers,"string"==typeof o.onClone){const t=s[o.onClone]||o.functions&&o.functions[o.onClone];if(!t||"function"!=typeof t)throw new Error("onClone handler "+o.onClone+" not found or is not a function");o.onClone=t}o.columns.forEach(t=>{["insert","update","display"].forEach(e=>{const n=t[e].events;if(!n||!Array.isArray(n))throw new Error("Column "+t.name+" events are not an array");n.forEach(e=>{if("string"==typeof e.callback){const n=s[e.callback]||o.functions&&o.functions[e.callback];if(!n||"function"!=typeof n)throw new Error("Event callback function "+e.callback+" not found for column "+t.name+" or is not a function");e.callback=n}else if("function"!=typeof e.callback)throw new Error("Event callback must be a function for column "+t.name)})});const e=t.display;e&&e.events&&Array.isArray(e.events)&&e.events.forEach(t=>{if("string"==typeof t.callback){const e=s[t.callback]||o.functions&&o.functions[t.callback];e&&"function"==typeof e&&(t.callback=e)}})});const u=new Map;o.columns.forEach(t=>{u.set(t.name,t)});const c=t.setupLabelsHeader(a.find(".thead-labels"),o),f=t.hasActionColumn(o),d=c.find("th").length,p=d-(f?1:0);t.syncActionColumnColgroup(a,p,f);const m=o.filterForm??t.setupFilterHeader(a,o);let y;o.features&&o.features.paging?y=t.setupPagingFooter(a.find(".paging-footer"),o,d):(y=null,a.find(".paging-footer").remove());const b=t.setupNoDataTbody(a.find(".no-data-tbody"),o,d);o.features&&o.features.create&&t.setupNewRecordForm(a,o,i),i.filterForm=new t.FilterForm(m);const g=t.setupDataBody(a.find(".main-tbody"),o,c,m,y,b),h={dontload:!0,setAttrAsId:o.setAttrAsId??!1,itemListeners:{afterrender:e=>t.setupEvents(e,i.find("table"),o,u)}},w=t.getKViews(o.kviews);if(!w)throw new Error(t.KVIEWS_MISSING_MSG);if(i.instance=await w.createCollectionInstance(g,h),o.url){i.instance.setUrl(o.url),o.deleteUrl&&(t.log("set deleteUrl",o.deleteUrl),i.instance.setUrl(o.deleteUrl,"delete")),o.updateUrl&&(t.log("set updateUrl",o.updateUrl),i.instance.setUrl(o.updateUrl,"update")),o.insertUrl&&i.instance.setUrl(o.insertUrl,"insert");try{await i.instance.loadFromRemote()}catch(e){t.onError(e)}}else{if(!o.data||o.data.constructor!==Array)throw new Error("Invalid data: missing datasource url or data for table");{const t=o.data.map(t=>({attributes:t}));i.instance.loadFromData(t)}}return t.setupDefaultFilters(m,o,i.instance),i}}(window.KGrid);
|
|
1
|
+
/*! @logimaxx/kgrid | (c) Logimaxx System SRL — proprietary | https://logimaxx.ro | built 2026-09-16T18:38:48.778Z */
|
|
2
|
+
!function(e){function t(e){const t={},n=e&&e.elements;if(!n)return t;for(let e=0;e<n.length;e++){const o=n[e],r=o.name;if(!r||o.disabled)continue;const a=o.type;if("submit"===a||"button"===a||"reset"===a||"file"===a)continue;if("checkbox"===a){t[r]=o.checked?"1":"0";continue}if("radio"===a){if(!o.checked)continue;t[r]=o.value;continue}if("SELECT"===o.tagName&&o.multiple){t[r]=Array.from(o.selectedOptions).map(function(e){return e.value});continue}const i=o.value;Object.prototype.hasOwnProperty.call(t,r)?(Array.isArray(t[r])||(t[r]=[t[r]]),t[r].push(i)):t[r]=i}return t}e.isFlagOn=function(e){return!0===e||1===e||"1"===e},e.serializeFormDefault=t;const n={log:function(){},onError:function(e){console.error(e)},confirm:function(e,t,n){"undefined"!=typeof window&&window.confirm(e)?t():n&&n()},deleteConfirm:null,serializeForm:t,customInputTypes:null,fieldTypes:null,kviews:null,filterDebounceMs:300,preferencesStorage:null};e._config=Object.assign({},n),e.configure=function(t){return t&&"object"==typeof t&&Object.assign(e._config,t),"function"==typeof e._syncCustomInputTypes&&e._syncCustomInputTypes(),e},e.log=function(){e._config.log.apply(null,arguments)},e.onError=function(t){return e._config.onError(t)},e.confirm=function(t,n,o){return e._config.confirm(t,n,o)},e.DEFAULT_DELETE_CONFIRM_MESSAGE="Delete this record?",e._defaultDeleteConfirm=function(t,n,o){e.confirm(e.DEFAULT_DELETE_CONFIRM_MESSAGE,n,o)},e.runDeleteConfirm=function(t,n,o){const r=t.options&&"function"==typeof t.options.deleteConfirm?t.options.deleteConfirm:null,a="function"==typeof e._config.deleteConfirm?e._config.deleteConfirm:null;return(r||a||e._defaultDeleteConfirm)(t,n,o)},e.serializeForm=function(t,n){return e._config.serializeForm(t,n)},e.getKViews=function(t){const n=[t,e._config.kviews];for(let e=0;e<n.length;e++){const t=n[e];if(t&&"function"==typeof t.createCollectionInstance)return t}const o=("undefined"!=typeof window?window:"undefined"!=typeof globalThis?globalThis:{}).KViews;return o&&"function"==typeof o.createCollectionInstance?o:null},e.KVIEWS_MISSING_MSG="KGrid requires KViews: install peer @logimaxx/kviews, load it before kgrid.js (window.KViews), or call KGrid.configure({ kviews: KViews }). You can also pass kviews in table options: KGrid.init(host, { kviews, ... })."}(window.KGrid=window.KGrid||{}),function(e){e.protoOptions={url:null,type:null,filter:null,features:{filtering:!1,sorting:!1,paging:!1,create:!1,update:!1,delete:!1,clone:!1,columnChooser:!1},rowActions:null,storageKey:null,filterStorageScope:null,columnChooserLabel:"Columns",columnChooserResetLabel:"Reset columns",defaultInteraction:"view",insertFormRow:{position:"top"},tableAttrs:{class:""},labelsRowAttrs:{},dataRowAttrs:{},filtersRowAttrs:null,pagingPageSizes:[10,25,50,75],pagingDefaultSize:10,emptyRowMessage:null,pagingFooterLabel:"records per page. Total"},e.protoColumnConfig={label:null,name:null,hidden:!1,locked:!1,defaultHidden:!1,userHidden:!1,class:null,columnClass:null,attrs:{},features:{create:!1,update:!1,filter:!1,sort:!1},display:{template:null,events:[]},input:null,insert:{type:"text",default:null,value:null,placeholder:null,disabled:!1,required:!1,options:null,events:[]},update:{type:"text",default:null,value:null,placeholder:null,disabled:!1,required:!1,options:null,template:null,events:[]},filter:{type:"text",operator:"~=~",default:null,placeholder:"",options:null,persist:!1,debounceMs:null}},e.VALID_NATIVE_INPUT_TYPES=["displayonly","text","textarea","number","date","datetime","time","checkbox","radio","file","password","email","url","search","tel","select","hidden"],e.VALID_INPUT_TYPES=e.VALID_NATIVE_INPUT_TYPES.slice(),e.VALID_NATIVE_FILTER_TYPES=e.VALID_NATIVE_INPUT_TYPES.filter(e=>"displayonly"!==e),e.VALID_FILTER_TYPES=e.VALID_NATIVE_FILTER_TYPES.concat(["multi_select","date_range"]),e.isValidInputType=function(t){return e.VALID_NATIVE_INPUT_TYPES.includes(t)||e.isPluggableFieldType(t)},e.isValidFilterType=function(t){return"displayonly"!==t&&(e.VALID_NATIVE_FILTER_TYPES.includes(t)||e.isPluggableFieldType(t))}}(window.KGrid=window.KGrid||{}),function(e){e.isPlainObject=function(e){return null!=e&&"object"==typeof e&&!Array.isArray(e)},e.setDefaultValues=function(t,n){const o={...t||{}};return Object.keys(n||{}).forEach(t=>{e.isPlainObject(n[t])&&e.isPlainObject(o[t])?o[t]=e.setDefaultValues(o[t],n[t]):e.isPlainObject(n[t])&&null==o[t]?o[t]=e.setDefaultValues({},n[t]):o[t]=n[t]}),o},e.normalizeColumnConfig=function(t){let n=t&&"object"==typeof t?{...t}:{};if(e.isPlainObject(n.input)){const t={...n.input};delete n.input,n.insert=e.setDefaultValues(t,n.insert||{}),n.update=e.setDefaultValues(t,n.update||{})}const o=e.setDefaultValues(e.protoColumnConfig,n);return null==o.class&&o.columnClass&&(o.class=o.columnClass),o.update&&"displayonly"===o.update.type&&!o.update.template&&o.display&&o.display.template&&(o.update.template=o.display.template),["display","insert","update"].forEach(e=>{o[e]&&"object"==typeof o[e]&&(Array.isArray(o[e].events)||(o[e].events=[]))}),o}}(window.KGrid),function(e){e.resolveHostElement=function(e){if(null==e)throw new TypeError("KGrid.init(host, opts): host is required");if("object"==typeof e&&e.jquery){if(!e.length)throw new Error("KGrid.init(host, opts): empty jQuery selection");return e}if("object"==typeof e&&1===e.nodeType&&"string"==typeof e.nodeName)return $(e);throw new TypeError("KGrid.init(host, opts): host must be a DOM Element or jQuery object")},e.uuid=function(){return Math.random().toString(36).substring(2,15)+Math.random().toString(36).substring(2,15)},e.syncActionColumnColgroup=function(t,n,o,r,a){let i=t.children("colgroup.kgrid-colgroup");i.length||(i=$("<colgroup>").addClass("kgrid-colgroup").prependTo(t)),i.empty();const l=Array.isArray(a)?a:null;if(l&&l.length)l.forEach(function(e){const t=$("<col>");e&&e.name&&t.attr("data-name",e.name),e&&e.userHidden&&t.addClass("kgrid-user-hidden"),i.append(t)});else for(let e=0;e<n;e++)i.append($("<col>"));o&&i.append($("<col>").addClass("kgrid-row-actions-col").css("width",e.actionColumnWidth(r)))},e.anchorRowForm=function(e,t){if(!(e&&e.length&&t&&t.length))return e;e.attr("hidden","hidden").attr("aria-hidden","true");const n=t.children("td").first();return n.length&&e.prependTo(n),e},e.filterFormField=function(e,t){if(!e||!t)return $();const n=e.elements&&e.elements.namedItem(t);if(n)return $(n);if(e.id){const n=document.querySelector(`[form="${e.id}"][name="${t}"]`);if(n)return $(n)}return $()},e.columnClassName=function(e){if(!e)return null;const t=null!=e.class&&""!==e.class?e.class:e.columnClass;return null!=t&&""!==t?String(t):null},e.applyColumnCellMeta=function(t,n){if(!t||!t.length||!n)return t;n.name&&t.attr("data-name",n.name);const o=e.columnClassName(n);return o&&t.addClass(o),t.toggleClass("kgrid-user-hidden",!!n.userHidden),t}}(window.KGrid),function(e){function t(e){"undefined"!=typeof console&&"function"==typeof console.warn&&console.warn(e)}function n(e){return e?"<i class='"+e+"'></i>":""}function o(e,t,o){const r=$("<button>").addClass(t.btnClass||"btn btn-sm btn-outline-secondary").attr("type","save"===t.action?"submit":"button").attr("title",t.title||t.label||"");return t.class&&r.addClass(t.class),"save"!==t.action&&"cancel"!==t.action||(r.attr("name","save"===t.action?"save":"cancel"),o&&r.attr("form",o)),"cancel"===t.action&&r.attr("onclick","$(this).parents('[data-type=item]').data().instance.loadFromRemote()"),t.id&&r.attr("data-kgrid-action",t.id),t.action&&r.attr("data-kgrid-builtin",t.action),t.icon?(r.html(n(t.icon)),t.showLabel&&t.label&&r.append(document.createTextNode(" "+t.label))):t.label&&r.text(t.label),r.appendTo(e),r}e.BUILTIN_ROW_ACTIONS={clone:{action:"clone",icon:"fa-regular fa-copy",label:"Clone",title:"Clone item",when:"idle",btnClass:"btn btn-sm btn-outline-secondary clone-item",groupClass:"clone-item-grp"},delete:{action:"delete",icon:"fas fa-trash",label:"Delete",title:"Delete item",when:"idle",btnClass:"btn btn-sm btn-danger delete-item",groupClass:"delete-item-grp"},save:{action:"save",icon:"fas fa-save",label:"Save",title:"Save item",when:"editing",btnClass:"btn btn-sm btn-success save-item",groupClass:"edit-item-grp"},cancel:{action:"cancel",icon:"fas fa-undo",label:"Cancel",title:"Cancel edit",when:"editing",btnClass:"btn btn-sm btn-secondary cancel-edit",groupClass:"edit-item-grp"}},e.normalizeRowActionItem=function(n,o,r){if(!n||"object"!=typeof n)return null;const a=n.action;if("save"===a||"cancel"===a)return t("KGrid: rowActions items should not list '"+a+"' — it is added automatically when features.update is true"),null;let i={};if(a&&e.BUILTIN_ROW_ACTIONS[a])i={...e.BUILTIN_ROW_ACTIONS[a]};else{if(!n.id)return t("KGrid: custom rowAction requires id: "+JSON.stringify(n)),null;i={id:n.id,when:"idle",btnClass:"btn btn-sm btn-outline-secondary",groupClass:"kgrid-custom-action-grp"}}const l={...i,...n};if(a&&e.BUILTIN_ROW_ACTIONS[a]&&(l.action=a),l.when||(l.when=l.action&&i.when||"idle"),!l.title&&l.label&&(l.title=l.label),!l.label&&l.title&&(l.label=l.title),"string"==typeof l.callback){const e=function(e,t,n){if(!e||"string"!=typeof e)return null;const o=t&&t[e]||n.functions&&n.functions[e];return"function"==typeof o?o:null}(l.callback,o,r);if(!e)throw new Error("rowAction callback "+l.callback+" not found or is not a function");l.callback=e}if(l.id&&"function"!=typeof l.callback&&!l.action)throw new Error("Custom rowAction '"+l.id+"' requires a callback");return l},e.resolveRowActions=function(n,o){if(n&&n._resolvedRowActions&&arguments.length<2)return n._resolvedRowActions;const r=n&&n.features||{};let a="buttons",i=[];if(n&&null!=n.rowActions){const o=n.rowActions;Array.isArray(o)?i=o:e.isPlainObject(o)&&(a="dropdown"===o.display?"dropdown":"buttons",i=Array.isArray(o.items)?o.items:[]),(r.delete||r.clone)&&t("KGrid: features.delete / features.clone are ignored when rowActions is set")}else r.clone&&i.push({action:"clone"}),r.delete&&i.push({action:"delete"});const l=[];i.forEach(function(t){const r=e.normalizeRowActionItem(t,o,n||{});r&&l.push(r)});const s=[];r.update&&(s.push({...e.BUILTIN_ROW_ACTIONS.save}),s.push({...e.BUILTIN_ROW_ACTIONS.cancel}));const c={display:a,menuItems:l,editingItems:s};return n&&(n._resolvedRowActions=c),c},e.hasActionColumn=function(t){const n=t&&t.features;if(n&&n.create)return!0;const o=e.resolveRowActions(t);return o.menuItems.length>0||o.editingItems.length>0},e.actionColumnWidth=function(t){const n=e.resolveRowActions(t),o=t&&t.features||{},r=n.editingItems.length,a=o.create?1:0;let i;i="dropdown"===n.display&&n.menuItems.length>0?1:n.menuItems.filter(function(e){return"editing"!==e.when}).length;return(2.5*Math.max(i,r,a,1)+.75).toFixed(2)+"rem"},e.escapeHtml=e.escapeHtml||function(e){return String(e).replace(/&/g,"&").replace(/</g,"<").replace(/>/g,">").replace(/"/g,""")},e.renderRowActions=function(t,r,a){const i=e.resolveRowActions(r),l=i.menuItems.filter(function(e){return"editing"!==e.when}),s=i.menuItems.filter(function(e){return"editing"===e.when});if("dropdown"===i.display&&l.length>0){const o=$("<div>").addClass("btn-group kgrid-row-actions-menu").appendTo(t);$("<button>").addClass("btn btn-sm btn-outline-secondary dropdown-toggle").attr({type:"button","data-bs-toggle":"dropdown","aria-expanded":"false",title:"Actions"}).html("<i class='fas fa-ellipsis-v'></i>").appendTo(o);const r=$("<ul>").addClass("dropdown-menu dropdown-menu-end").appendTo(o);l.forEach(function(t){const o=$("<li>").appendTo(r),a=$("<button>").addClass("dropdown-item").attr("type","button").appendTo(o);"clone"===t.action?a.addClass("clone-item"):"delete"===t.action&&a.addClass("delete-item text-danger"),t.id&&a.attr("data-kgrid-action",t.id),t.action&&a.attr("data-kgrid-builtin",t.action),t.class&&a.addClass(t.class);const i=t.label||t.title||t.action||t.id;t.icon?a.html(n(t.icon)+" "+e.escapeHtml(i)):a.text(i)})}else l.forEach(function(e){const n=$("<div>").addClass(e.groupClass||"btn-group kgrid-custom-action-grp").appendTo(t);"always"===e.when&&n.addClass("kgrid-action-always"),o(n,e,a)});const c=i.editingItems.concat(s);if(c.length){const e=$("<div>").addClass("btn-group edit-item-grp").appendTo(t);c.forEach(function(t){o(e,t,a)})}}}(window.KGrid),function(e){e.DEFAULT_EMPTY_ROW_MESSAGE="No records match your search.",e.TABLE_SHELL_TEMPLATE='\n<table class="custom-table" style="table-layout: fixed;">\n <thead class="thead-labels">\n <tr>\n <th class="align-top">\n <a class="sort" data-sortfld="" style="cursor: pointer;">\n <span class="column-label"></span>\n <i class="fas fa-sort-up sort-up" style="display: none"></i>\n <i class="fas fa-sort-down sort-down" style="display: none"></i>\n <i class="fas fa-sort sort-default"></i>\n </a>\n </th>\n </tr>\n </thead>\n <thead class="thead-filters"></thead>\n <tbody class="before-main-tbody"></tbody>\n <tbody class="main-tbody"></tbody>\n <tbody class="after-main-tbody"></tbody>\n <tbody class="no-data-tbody">\n <tr><td>{{EMPTY_ROW_MESSAGE}}</td></tr>\n </tbody>\n <tfoot class="paging-footer">\n <tr>\n <td>\n <div class="btn-group pages" data-pagesize="{{PAGES_DATA_PAGESIZE}}">\n <button type="button" name="first" class="btn btn-sm btn-outline-secondary"><<</button>\n <button type="button" name="prev" class="btn btn-sm btn-outline-secondary"><</button>\n <button type="button" name="page" class="btn btn-sm btn-outline-secondary">1</button>\n <button type="button" name="next" class="btn btn-sm btn-outline-secondary">></button>\n <button type="button" name="last" class="btn btn-sm btn-outline-secondary">>></button>\n </div>\n <select class="pagesize">\n{{PAGE_SIZE_OPTIONS}}\n </select>\n {{PAGING_FOOTER_LABEL}} <span class="totalrecscount"></span>\n </td>\n </tr>\n </tfoot>\n</table>'.trim(),e._escapeTableShellText=function(e){return String(e).replace(/&/g,"&").replace(/</g,"<").replace(/>/g,">").replace(/"/g,""")},e._renderPageSizeOptions=function(e,t){return e.map(e=>{const n=String(e);return` <option value="${n}"${n===String(t)?" selected":""}>${n}</option>`}).join("\n")},e.renderTableShellHtml=function(t,n){const o=Array.isArray(t.pagingPageSizes)?t.pagingPageSizes:[10,25,50,75],r=null!=t.pagingDefaultSize?t.pagingDefaultSize:o[0],a=e._escapeTableShellText(t.emptyRowMessage||e.DEFAULT_EMPTY_ROW_MESSAGE),i=e._escapeTableShellText(t.pagingFooterLabel||"records per page. Total");return(n||e.TABLE_SHELL_TEMPLATE).replace(/\{\{EMPTY_ROW_MESSAGE\}\}/g,a).replace(/\{\{PAGES_DATA_PAGESIZE\}\}/g,String(r)).replace(/\{\{PAGE_SIZE_OPTIONS\}\}/g,e._renderPageSizeOptions(o,r)).replace(/\{\{PAGING_FOOTER_LABEL\}\}/g,i)},e.createTableShell=function(t){const n=e.renderTableShellHtml(t),o=$.parseHTML(n,document,!0),r=$(o).filter("table").first();if(!r.length)throw new Error("KGrid TABLE_SHELL_TEMPLATE must contain a root <table> element");return t.tableAttrs&&e.isPlainObject(t.tableAttrs)&&(Object.keys(t.tableAttrs).forEach(e=>{"class"!==e&&r.attr(e,t.tableAttrs[e])}),"string"==typeof t.tableAttrs.class&&t.tableAttrs.class&&r.addClass(t.tableAttrs.class)),r},e.mountTableShell=function(t,n){const o=t.find("table.custom-table, table").first();if(o.length)return o;const r=e.getTableInteractionHost(t);r.hasClass("custom-table-shell")||r.addClass("custom-table-shell");const a=e.createTableShell(n);return r.append(a),a}}(window.KGrid),function(e){e._fieldTypes=Object.create(null),e._configuredCustomInputTypeNames=[],e.registerFieldType=function(t,n,o){if(!t||"string"!=typeof t)throw new TypeError("registerFieldType(name, plugin): name must be a string");if(!n||"function"!=typeof n.create)throw new TypeError("registerFieldType("+t+"): plugin.create is required");if(e._fieldTypes[t]&&(!o||!o.overwrite))throw new Error("Field type already registered: "+t);return e._fieldTypes[t]=Object.assign({name:t},n),e},e.unregisterFieldType=function(t){return t&&e._fieldTypes[t]&&delete e._fieldTypes[t],e},e.getFieldType=function(t){return t&&e._fieldTypes[t]||null},e.listFieldTypes=function(){return Object.keys(e._fieldTypes)},e.createFieldInput=function({mode:t,col:n,config:o}){const r=o.type??"text",a=e.getFieldType(r);if(!a)return null;"function"==typeof a.validate&&a.validate(o,t,n);const i=a.create({mode:t,col:n,config:o});if(!i||!i.$input||!i.$input.length)throw new Error('Field type "'+r+'" create() must return { $input: jQuery }');return i.$input.attr("data-type",r),i},e.mountField=function(t){const n=t.config?.type??t.type,o=e.getFieldType(n);o&&"function"==typeof o.mount&&o.mount(t)},e.resolveFilterEvents=function({plugin:e,$input:t,createResult:n}){let o;return n&&Object.prototype.hasOwnProperty.call(n,"filterEvents")?o=n.filterEvents:e&&Object.prototype.hasOwnProperty.call(e,"filterEvents")&&(o=e.filterEvents),!1===o||null===o?null:"string"==typeof o&&o.trim()?o.trim():t.is("select")?"change":"input"},e.normalizeFilterDebounceMs=function(e,t){if(!1===e)return 0;if(void 0===e)return t;if(null===e)return t;const n=Number(e);return!Number.isFinite(n)||n<0?0:n},e.resolveFilterDebounceMs=function({filterConfig:t,plugin:n}){return t&&Object.prototype.hasOwnProperty.call(t,"debounceMs")&&null!==t.debounceMs?e.normalizeFilterDebounceMs(t.debounceMs,0):n&&Object.prototype.hasOwnProperty.call(n,"filterDebounceMs")&&null!==n.filterDebounceMs?e.normalizeFilterDebounceMs(n.filterDebounceMs,0):e.normalizeFilterDebounceMs(e._config.filterDebounceMs,0)},e.shouldDebounceFilterSubmit=function(e,t){return!(!t||t<=0)&&!!e},e.bindFieldFilterSubmit=function(t,n,o){const r=e.getFieldType(t);r&&"function"==typeof r.bindFilterSubmit&&r.bindFilterSubmit(n,o)},e.bindFilterInputEvents=function({type:t,$input:n,onSubmit:o,createResult:r,filterConfig:a}){const i=t?e.getFieldType(t):null,l=e.resolveFilterEvents({plugin:i,$input:n,createResult:r}),s=e.resolveFilterDebounceMs({filterConfig:a,plugin:i}),c=e.wrapFilterSubmitHandler(n,o,l,s);l&&n.on(l,c),e.bindFieldFilterSubmit(t,n,c)},e.isPluggableFieldType=function(t){return!!e.getFieldType(t)},e.inputType=function(e,t){if("function"!=typeof e)throw new TypeError("inputType(mount, opts): mount must be a function");if(!t||"string"!=typeof t.element)throw new TypeError("inputType(mount, opts): opts.element is required (HTML string)");return{filterEvents:t.filterEvents,filterDebounceMs:t.filterDebounceMs,validate:t.validate,create({mode:e}){const n=$(t.element);return!t.formInputClass||"insert"!==e&&"update"!==e||n.addClass(t.formInputClass),{$input:n,skipValueAttr:!!t.skipValueAttr}},mount(t){e(t.$input,t.config?.options??t.config,t)},bindFilterSubmit:t.bindFilterSubmit}},e._getCustomInputTypesConfig=function(){return e._config.customInputTypes??e._config.fieldTypes??null},e._syncCustomInputTypes=function(){const t=e._getCustomInputTypesConfig(),n=t&&"object"==typeof t?Object.keys(t).filter(e=>null!=t[e]):[];e._configuredCustomInputTypeNames.forEach(t=>{n.includes(t)||e.unregisterFieldType(t)}),n.forEach(n=>{const o=t[n];if(!o||"object"!=typeof o||"function"!=typeof o.create){if("function"==typeof o)throw new Error("customInputTypes."+n+' is a function — use a plugin, e.g. KGrid.select2(fn) or KGrid.inputType(fn, { element: "..." })');throw new TypeError("customInputTypes."+n+" must be a plugin with create()")}e.registerFieldType(n,o,{overwrite:!0})}),e._configuredCustomInputTypeNames=n.slice()}}(window.KGrid),function(e){const t="kgrid-multi-select-value",n=";";function o(e,t,n){if(!e.length)return n;if(1===e.length){const n=t.find(function(t){return t.value===e[0]});return n?n.label:e[0]}return e.length+" selected"}function r(r,a,i){const l=a.separator||n,s=a.options||[],c=function(e){return null!=e.placeholder&&""!==e.placeholder?String(e.placeholder):"All"}(a),u="filter"===i;r.data("kgridMultiSep",l),r.addClass(t);const d=$("<div>").addClass("kgrid-multi-select").attr("data-mode",i),f=$("<div>").addClass("kgrid-multi-select-panel");let p=null;function m(){const t=e.parseMultiSelectValue(r[0].value,l);f.find("input[type='checkbox']").each(function(){this.checked=-1!==t.indexOf(this.value)}),p&&p.text(o(t,s,c))}function g(e){p&&(e?(f.appendTo(document.body),f.addClass("kgrid-multi-select-panel-floating"),f.removeAttr("hidden"),d.addClass("kgrid-multi-select-open"),p.attr("aria-expanded","true"),h()):(f.attr("hidden","hidden"),d.removeClass("kgrid-multi-select-open"),p.attr("aria-expanded","false"),f.css({position:"",top:"",left:"",width:"",minWidth:"",maxWidth:"",zIndex:""}),f.removeClass("kgrid-multi-select-panel-floating"),f.insertAfter(p)))}function h(){if(!p)return;const e=p[0].getBoundingClientRect(),t=Math.max(e.width,192);let n=e.left;const o=window.innerWidth-t-8;n>o&&(n=Math.max(8,o));let r=e.bottom+2;const a=Math.min(224,28*s.length+16);r+a>window.innerHeight-8&&e.top>a+8&&(r=e.top-a-2),f.css({position:"fixed",top:r+"px",left:n+"px",width:t+"px",minWidth:t+"px",maxWidth:"min(18rem, calc(100vw - 16px))",zIndex:1080})}u?(p=$("<button>").attr({type:"button","aria-expanded":"false"}).addClass("kgrid-multi-select-toggle form-select form-select-sm"),f.attr("hidden","hidden"),d.append(p,f)):(d.addClass("kgrid-multi-select-open"),d.append(f)),s.forEach(function(t,n){const o="kgrid_ms_"+e.uuid()+"_"+n,r=$("<label>").addClass("kgrid-multi-select-option").attr("for",o);$("<input>").attr({type:"checkbox",id:o,value:t.value,class:"kgrid-multi-select-check"}).appendTo(r),$("<span>").addClass("kgrid-multi-select-label").text(t.label).appendTo(r),f.append(r)}),r.before(d),d.append(r);const y=".kgridMultiSelect_"+e.uuid();f.on("change","input[type='checkbox']",function(){!function(e){const t=[];f.find("input[type='checkbox']:checked").each(function(){t.push(this.value)});const n=t.join(l);r[0].value!==n&&(r[0].value=n,e&&r.trigger("change")),p&&p.text(o(t,s,c))}(!0)}),r.on("kgrid:multiselect:set",function(){m()}),p&&(p.on("click",function(e){e.preventDefault(),e.stopPropagation(),g(!d.hasClass("kgrid-multi-select-open"))}),$(document).on("mousedown"+y,function(e){d.hasClass("kgrid-multi-select-open")&&($(e.target).closest(d).length||$(e.target).closest(f).length||g(!1))}),$(window).on("resize"+y+" scroll"+y,function(){d.hasClass("kgrid-multi-select-open")&&h()}));const b=function(){const e=r.prop("form")||r[0]&&r[0].form;e&&$(e).off("reset"+y).on("reset"+y,function(){setTimeout(m,0)})};return b(),setTimeout(b,0),m(),d}e.normalizeMultiSelectValue=function(e,t){const o=t||n;return null==e||""===e?"":Array.isArray(e)?e.filter(function(e){return null!=e&&""!==e}).map(String).join(o):String(e)},e.parseMultiSelectValue=function(t,o){const r=e.normalizeMultiSelectValue(t,o);return r?r.split(o||n).filter(Boolean):[]},function(){const o=$.valHooks.hidden||{};$.valHooks.hidden={get:function(e){return e&&e.classList&&e.classList.contains(t)?e.value:o.get?o.get(e):void 0},set:function(r,a){if(r&&r.classList&&r.classList.contains(t)){const t=$(r).data("kgridMultiSep")||n;return r.value=e.normalizeMultiSelectValue(a,t),$(r).triggerHandler("kgrid:multiselect:set"),!0}return o.set?o.set(r,a):void 0}}}(),e.registerFieldType("multi_select",{filterEvents:"change",filterDebounceMs:0,validate(e,t){!function(e,t){if(!Array.isArray(e.options))throw new Error("multi_select requires an options array ("+t+"): "+JSON.stringify(e,null,2));e.options.forEach(function(t){if(!t||"string"!=typeof t.label||"string"!=typeof t.value)throw new Error("multi_select options need string label and value: "+JSON.stringify(e,null,2))})}(e,t)},create({config:e}){const n=$("<input type='hidden'>").addClass(t);return e.separator&&n.data("kgridMultiSep",e.separator),{$input:n,skipValueAttr:!0}},mount(e){if(r(e.$input,e.config||{},e.mode),"update"===e.mode&&e.item&&e.col&&e.col.name){const t=e.item.attributes?e.item.attributes[e.col.name]:null;null!=t&&""!==t&&e.$input.val(t)}}}),e.registerFieldType("date_range",{create:()=>({$input:$("<input autocomplete='off' type='date' class='form-control form-control-sm'/>")})})}(window.KGrid),function(e){e.resolveDefaultInteraction=function(e){return"edit"===e.defaultInteraction||"view"===e.defaultInteraction?e.defaultInteraction:!0===e.editmode?"edit":(e.editmode,"view")},e.getTableInteractionHost=function(e){if(e.hasClass("custom-table-shell"))return e;const t=e.find(".custom-table-shell").first();return t.length?t:e},e.applyInteraction=function(t,n,o){const r=e.getTableInteractionHost(t),a="edit"===n?"edit":"view";r.attr("data-interaction",a),o&&"object"==typeof o?(void 0!==o.create&&r.attr("data-allow-insert",o.create?"true":"false"),void 0!==o.update&&r.attr("data-allow-update",o.update?"true":"false"),void 0!==o.delete&&r.attr("data-allow-delete",o.delete?"true":"false"),void 0!==o.clone&&r.attr("data-allow-clone",o.clone?"true":"false")):"edit"===a&&r.removeAttr("data-allow-insert data-allow-update data-allow-delete data-allow-clone")}}(window.KGrid),function(e){e.setupLabelsHeader=function(t,n){const o=t.children("tr"),r=o.children(),a=r.first().clone(!0);r.remove();return[...n.columns].forEach(t=>{if(t.hidden)return;let n=a.clone(!0);if(t.attrs&&"object"==typeof t.attrs&&Object.keys(t.attrs).forEach(e=>n.attr(e,t.attrs[e])),e.applyColumnCellMeta(n,t),!t.features?.sort){const r=n.empty().html(t.label??"");return e.applyColumnCellMeta(r,t),void o.append(r)}if(!t.name)throw new Error("Column must have a name when column.sortable is true: \n"+JSON.stringify(t,null,2));n.find("span.column-label").text(t.label??""),n.children("a").attr("data-sortfld",t.name),n.appendTo(o)}),e.hasActionColumn(n)&&$("<th>").addClass("kgrid-row-actions").attr("aria-label","Actions").appendTo(o),o}}(window.KGrid),function(e){const t="kgridFilterDebounceTimer";e.cancelFilterSubmit=function(e){const n=e.data(t);n&&(clearTimeout(n),e.removeData(t))},e.cancelFilterDebounces=function(t){const n=$(t).attr("id");n&&$(document).find("[form='"+n+"']").each(function(){e.cancelFilterSubmit($(this))})},e.flushFilterSubmit=function(e){const n=e.data(t);if(!n)return;clearTimeout(n),e.removeData(t);const o=e[0]&&e[0].form;o&&$(o).trigger("submit")},e.wrapFilterSubmitHandler=function(n,o,r,a){if(!e.shouldDebounceFilterSubmit(r,a))return o;const i=a;return function(){e.cancelFilterSubmit(n);const r=setTimeout(function(){n.removeData(t),o.call(this)}.bind(this),i);n.data(t,r)}},e.filterDefaultValue=function(e){return null!=e&&"object"==typeof e&&null!=e.value?e.value:e},e.columnFilterPersisted=function(e){const t=e&&e.filter?e.filter:{};return!(!e||!e.hidden&&"hidden"!==t.type&&!t.persist)},e.ensureFilterField=function(e,t,n,o){if(!e||!t||null==n||""===n)return null;let r=e.elements&&e.elements.namedItem(t);return r&&null!=r.length&&!r.tagName&&(r=r[0]),r&&r.tagName||(r=document.createElement("input"),r.type="hidden",r.name=t,e.appendChild(r)),r.setAttribute("data-operator",o||"="),r.value=String(n),r.defaultValue=String(n),r},e.applyColumnDefaultFilters=function(t,n){t&&n&&n.forEach(function(n){if(!n.name||n.features&&!1===n.features.filter)return;const o=n.filter;if(!o||null==o.default||""===o.default)return;const r=e.filterDefaultValue(o.default);if(null==r||""===r)return;const a=o.operator||(e.columnFilterPersisted(n)?"=":"~=~"),i=e.filterFormField(t,n.name);!n.hidden&&"hidden"!==o.type&&i.length?i.val()||(i.val(String(r)),i.attr("data-operator",a)):e.ensureFilterField(t,n.name,r,a)})},e.setupDefaultFilters=function(t,n,o,r){const a=$(t)[0];if(!(a&&n&&n.features&&n.features.filtering))return;const i=n.columns||[];if(e.applyColumnDefaultFilters(a,i),i.some(e.columnFilterPersisted)){let t=!1;$(a).off("reset.kgridDefaultFilters").on("reset.kgridDefaultFilters",function(n){if(!t){n.preventDefault(),e.cancelFilterDebounces(a),t=!0;try{a.reset(),e.applyColumnDefaultFilters(a,i),o&&o.filtering&&"function"==typeof o.filtering.handleSubmit?o.filtering.handleSubmit(a):$(a).trigger("submit")}finally{t=!1}}})}if(!o||!o.filtering)return;const l=i.filter(function(t){return t.name&&t.filter&&null!=t.filter.default&&""!==t.filter.default&&e.columnFilterPersisted(t)});if(!l.length)return;const s=String(o.url&&o.url.parameters&&o.url.parameters.filter||"");!l.some(function(e){return-1===s.indexOf(e.name+"=")})||r&&r.skipInitSubmit||o.filtering.handleSubmit(a)},e.setupFilterHeader=function(t,n){if(!n.features||!n.features.filtering)return null;const o=t.find(".thead-filters");o.empty();const r=[...n.columns],a=$("<tr>");a.appendTo(o);const i="filter_form_"+e.uuid(),l=$("<form>").attr("id",i).attr("hidden","hidden").attr("aria-hidden","true").addClass("table-filter-form").insertBefore(t);return r.forEach(t=>{const n=t.filter||{};if(t.hidden||"hidden"===n.type){if(t.features&&!1===t.features.filter)return;if(!t.name)return;const o=e.filterDefaultValue(n.default);return void(null!=o&&""!==o?e.ensureFilterField(l[0],t.name,o,n.operator||"="):e.columnFilterPersisted(t)&&e.ensureFilterField(l[0],t.name,"",n.operator||"="))}let o,r=$("<th>").appendTo(a).attr("data-label",t.label);if(e.applyColumnCellMeta(r,t),!1===t.features.filter)return;if(!t.name)throw new Error("Column must have a name when column.features.filter is true: \n"+JSON.stringify(t,null,2));let s=null;const c=e.createFieldInput({mode:"filter",col:t,config:n});if(c)s=c,o=c.$input,o.appendTo(r),e.mountField({mode:"filter",$input:o,col:t,config:n});else if("select"===n.type){if(!n.options)throw new Error("Column must have a filter.options array when column.filter.type is select: \n"+JSON.stringify(t,null,2));if(o=$("<select>").addClass("form-select form-select-sm"),!Array.isArray(n.options))throw new Error("Column must have a filter.options array when column.filter.type is select: \n"+JSON.stringify(t,null,2));n.options.forEach(e=>{if(!e.label||"string"!=typeof e.value)throw new Error("Column must have an filter.options object with label and value when column.filter.type is select: \n"+JSON.stringify(t,null,2));$("<option>").text(e.label).attr("value",e.value).appendTo(o)}),o.appendTo(r)}else{if(!e.isValidFilterType(n.type))throw new Error("Unknown filter type: "+n.type);o=$(`<input autocomplete='off' type='${n.type}' class='form-control form-control-sm'/>`),o.appendTo(r)}const u=n.operator||("multi_select"===n.type?"><":void 0);null!=u&&o.attr("data-operator",u),o.attr("form",i),o.attr("name",t.name);const d=e.filterDefaultValue(n.default);if(null!=d&&""!==d&&!o.val()){const t="multi_select"===n.type?e.normalizeMultiSelectValue(d,n.separator):String(d);o.val(t),o.attr("data-default",t),o[0]&&(o[0].defaultValue=t)}e.bindFilterInputEvents({type:n.type,$input:o,onSubmit:function(){const e=this.form;e&&$(e).trigger("submit")},createResult:s,filterConfig:n})}),e.hasActionColumn(n)&&$("<th>").addClass("kgrid-row-actions").attr("data-label","Actions").appendTo(a),l},e.syncFormFiltersToCollectionUrl=function(e,t){if(!e||!t||!t.url)return;t.url.parameters||(t.url.parameters={});const n=[],o=e.elements;if(o){for(let e=0;e<o.length;e++){const t=o[e];if(!t||!t.name)continue;const r=$(t),a=r.val();if(null==a||""===a)continue;const i=r.attr("data-operator")||r.data("operator")||"=";n.push(t.name+i+a)}t.offset=0,n.length?t.url.parameters.filter=n.join(","):delete t.url.parameters.filter}},e.FilterForm=function(t){this.form=$(t)[0],this.filter=(t,n,o="~=~")=>{if(!this.form)return this;let r=e.filterFormField(this.form,t);if(r.length||(e.ensureFilterField(this.form,t,n,o),r=e.filterFormField(this.form,t)),!r.length)return this;e.flushFilterSubmit(r),r.val(n);const a=r.attr("data-operator");return r.attr("data-operator",o),$(this.form).trigger("submit"),r.attr("data-operator",a),this},this.ensure=(t,n,o="=")=>(e.ensureFilterField(this.form,t,n,o),this),this.reset=()=>(this.form&&(e.cancelFilterDebounces(this.form),this.form.reset()),this)}}(window.KGrid),function(e){e.wrapFlagSwitch=function(e){return e.attr({type:"checkbox",role:"switch",value:"1"}).removeClass("form-control form-input form-control-sm").addClass("form-check-input"),$("<div class='form-check form-switch kgrid-flag-switch mb-0'>").append(e)},e.setupCell=function(t,n){const o=n?n.attr("id"):null,r={...t},a=$("<td>").attr("data-label",t.label);e.applyColumnCellMeta(a,t);const i=r.attrs&&"object"==typeof r.attrs?r.attrs:{};Object.keys(i).forEach(e=>a.attr(e,i[e]));let l=$("<div>").addClass("cell-content");if(l.html(r.display.template??`{{${r.name}}}`),l.appendTo(a),null==n||!t.features.update)return l.clone(!0).removeClass("cell-content").addClass("cell-input").appendTo(a),a;if(!r.name)throw new Error("Column must have a name when column.features.update is true: \n"+JSON.stringify(t,null,2));const s=r.update,c=s.type??"text";let u,d=!1;const f=e.createFieldInput({mode:"update",col:t,config:s});if(f)u=f.$input,d=!!f.skipValueAttr;else{switch(c){case"textarea":u=$(`<textarea class='form-input form-control form-control-sm'>{{${s.value??r.name}}}</textarea>`),d=!0;break;case"select":if(u=$("<select class='form-input form-control form-control-sm'/>"),!Array.isArray(s.options))throw new Error("Select column must have an update.options array when column.features.update is true: \n"+JSON.stringify(t,null,2));s.options.forEach(e=>{if("string"!=typeof e.label||void 0===e.value)throw new Error("Select update.options entries need label and value: \n"+JSON.stringify(t,null,2));$("<option>").text(e.label).attr("value",e.value).appendTo(u)}),d=!0;break;case"hidden":u=$("<input type='hidden' class='form-input form-control form-control-sm'/>");break;case"displayonly":{const e=s.template||r.display.template||`{{${r.name}}}`;return $("<div>").addClass("cell-input").append(e).appendTo(a),a}case"checkbox":u=$("<input autocomplete='off' type='checkbox' class='form-check-input'/>"),d=!0;break;default:if(!e.isValidInputType(c))throw new Error("Invalid update updateConfig type: "+JSON.stringify(s,null,2));u=$(`<input autocomplete='off' type='${c}' class='form-input form-control form-control-sm'/>`)}u.attr("data-type",c)}if(s.attrs&&"object"==typeof s.attrs&&Object.keys(s.attrs).forEach(e=>u.attr(e,s.attrs[e])),u.attr("form",o),u.attr("name",r.name),!d&&"textarea"!==c){const e=s.value??`{{${r.name}}}`;null!=e&&"object"!=typeof e&&u.attr("value",e)}if(r.hidden)return u.attr("type","hidden").appendTo(n),a;s.disabled&&u.attr("disabled",!0),s.readonly&&u.attr("readonly",!0),s.required&&u.attr("required",!0),s.attrs&&"object"==typeof s.attrs&&Object.keys(s.attrs).forEach(e=>u.attr(e,s.attrs[e])),s.disabled||s.readonly||u.attr("onchange","$(this).parents('tr').addClass('editing')");const p="checkbox"===c?e.wrapFlagSwitch(u):u;return $("<div>").addClass("cell-input").append(p).appendTo(a),a}}(window.KGrid),function(e){e.setupNoDataTbody=function(e,t,n){const o=e.find("td").attr("colspan",n);return t.noDataTemplate&&o.html(t.noDataTemplate),o},e.fillDataRow=function(t,n){const o=[...n.columns],r="data_row_form_"+e.uuid()+"_{{this.id}}",a=n.features&&n.features.update?$("<form class='edit-form table-row-form'>").attr("id",r):null;if(o.forEach(n=>{const o=e.setupCell(n,a);n.hidden||o.appendTo(t)}),e.hasActionColumn(n)){const o=$("<td>").addClass("kgrid-row-actions").appendTo(t);e.renderRowActions(o,n,r)}return a&&e.anchorRowForm(a,t),t},e.setupDataBody=function(t,n,o,r,a,i){const l=$("<tr>").appendTo(t);if(n.dataRowAttrs&&"object"!=typeof n.dataRowAttrs)throw new Error("options.dataRowAttrs must be an object");const s={...n.dataRowAttrs??{}};return Object.keys(s).forEach(e=>l.attr(e,s[e])),t.data("emptyview",i),n?.features?.sorting&&t.data("sort",o),a&&t.data("paging",a.find(".pages")).data("pagesizeinp",a.find(".pagesize")).data("totalrecscount",a.find(".totalrecscount")),r&&t.data("filter",r),n.type&&t.data("type",n.type),e.fillDataRow(l,n),t},e.setupPagingFooter=function(t,n,o){return e.log("setupPagingFooter",t,n,o),n.pagingFooterAttrs&&e.isPlainObject(n.pagingFooterAttrs)&&Object.keys(n.pagingFooterAttrs).forEach(e=>t.attr(e,n.pagingFooterAttrs[e])),e.log("noVisibleCols",o),t.find("td").attr("colspan",o),t}}(window.KGrid),function(e){e.setupNewRecordForm=function(t,n,o){if(!n.insertFormRow||!e.isPlainObject(n.insertFormRow))return t.find(".before-main-tbody").remove(),void t.find(".after-main-tbody").remove();const r=[...n.columns],a=$("<tr>").addClass("new-record-row");"top"===(n.insertFormRow?.position??"top")?(t.find(".after-main-tbody").remove(),a.appendTo(t.find(".before-main-tbody"))):(t.find(".before-main-tbody").remove(),a.appendTo(t.find(".after-main-tbody")));const i="new_record_row_form_"+e.uuid(),l=$("<form class='table-row-form'>").attr("id",i).off("submit").on("submit",t=>{t.preventDefault();const a=e.serializeForm(t.target,r);Object.keys(a).forEach(e=>{r.find(t=>t.name===e)?.insert?.dontsave&&delete a[e]}),o.instance.newItem(a).then(()=>{t.target.reset(),"function"==typeof n.onNewItemCreated&&n.onNewItemCreated(a,t.target)}).catch(e.onError)});r.forEach(t=>{if(t.hidden){if(n.features?.create&&t.features?.create){const e=$("<input type='hidden'>").attr("name",t.name).attr("form",i).appendTo(l);t.insert.default&&e.val(t.insert.default)}return}if(!t.features.create){const n=$("<td>").appendTo(a).attr("data-label",t.label);return void e.applyColumnCellMeta(n,t)}const o=t.insert;if(!o||!e.isPlainObject(o))throw new Error("Column must have an insert config object when column.features.create is true: \n"+JSON.stringify(t,null,2));if(!o.type)throw new Error("Column must have an insert.type when column.features.insert is true: \n"+JSON.stringify(t,null,2));let r;const s=o.type??"text",c=e.createFieldInput({mode:"insert",col:t,config:o});if(c)r=c.$input;else switch(s){case"textarea":r=$("<textarea class='form-input form-control form-control-sm'>");break;case"select":if(r=$("<select class='form-input form-control form-control-sm'/>"),!o.options||!Array.isArray(o.options))throw new Error("Column must have an insert.options array when column.features.insert is true: \n"+JSON.stringify(t,null,2));o.options.forEach(e=>{if("string"!=typeof e.label||void 0===e.value)throw new Error("Column must have an insert.options object with label and value when column.features.insert is true: \n"+JSON.stringify(t,null,2));$("<option>").text(e.label).attr("value",e.value).appendTo(r)});break;case"hidden":r=$("<input type='hidden' class='form-input form-control form-control-sm'/>");break;case"checkbox":r=$("<input autocomplete='off' type='checkbox' class='form-check-input'/>"),r.attr("data-type",s);break;default:if(!e.isValidInputType(s))throw new Error("Invalid type: "+JSON.stringify(o,null,2));r=$(`<input autocomplete='off' type='${s}' class='form-input form-control form-control-sm'/>`),r.attr("data-type",s)}const u="object"==typeof o.default&&o.default&&null!=o.default.value?o.default.value:o.default;if("checkbox"===s){const t=e.isFlagOn(u);r.prop("checked",t).prop("defaultChecked",t)}else null==o.default||""===o.default||r.val()||String(u).trim()&&(r.val(u).trigger("change"),r[0]&&"defaultValue"in r[0]&&(r[0].defaultValue=r[0].value));if(o.attrs&&"object"==typeof o.attrs&&Object.keys(o.attrs).forEach(e=>r.attr(e,o.attrs[e])),r.attr("form",i).attr("name",t.name),o.disabled&&r.attr("disabled",!0),o.readonly&&r.attr("readonly",!0),o.required&&r.attr("required",!0),o.attrs&&"object"==typeof o.attrs&&Object.keys(o.attrs).forEach(e=>r.attr(e,o.attrs[e])),"hidden"!==o.type){const n="checkbox"===s?e.wrapFlagSwitch(r):r,o=$("<td>").append(n).appendTo(a).attr("data-label",t.label);e.applyColumnCellMeta(o,t)}e.mountField({mode:"insert",$input:r,col:t,config:o,formEl:l[0],rowEl:a[0]}),o.events&&Array.isArray(o.events)&&o.events.forEach(e=>{r.off(e.event).on(e.event,function(t,...n){"function"==typeof e.callback&&e.callback(t,l[0],a[0],...n)})})}),e.anchorRowForm(l,a);const s=$("<td>").addClass("kgrid-row-actions").appendTo(a).attr("data-label","action"),c=$("<div>").addClass("btn-group").appendTo(s);return $("<button>").addClass("btn btn-sm btn-primary new-item-btn").html("<i class='fas fa-plus-square'></i>").attr("form",i).attr("type","submit").appendTo(c),"function"==typeof n.onInsertRowReady&&n.onInsertRowReady(l[0],a[0]),a}}(window.KGrid),function(e){e.setupEvents=function(t,n,o,r){const a=t.views[0];o.columns.forEach(n=>{n.display.events.forEach(e=>{if(!e.selector||!e.event||!e.callback)throw new Error("Invalid event: "+JSON.stringify(e,null,2));a.el.find(e.selector).off(e.event).on(e.event,n=>{if("function"!=typeof e.callback)throw new Error("Event callback must be a function: "+JSON.stringify(e,null,2));e.callback(n,t,a)})}),o.features.update&&n.update.events.forEach(o=>{if(!o.event||!o.callback)throw new Error("Invalid event: "+JSON.stringify(o,null,2));a.el.find("[name='"+n.name+"']").off(o.event).on(o.event,function(n,...r){if(e.log("event",o,n,this,r),"function"!=typeof o.callback)throw new Error("Event callback must be a function: "+JSON.stringify(o,null,2));o.callback(n,t,a,...r)})})}),o.features.update&&(a.el.find("[data-type]").each((n,o)=>{const i=o.getAttribute("data-type");if(!e.isPluggableFieldType(i))return;const l=r.get(o.name);l?.update&&e.mountField({mode:"update",$input:$(o),col:l,config:l.update,item:t,view:a})}),a.el.find("select[data-type='select']").each((e,n)=>{const o=r.get(n.name);if(!o)return;const a=t.attributes[o.name];null!=a&&""!==a&&$(n).val("boolean"==typeof a?String(a):a)}),a.el.find("input[type='checkbox']").each((n,o)=>{const a=r.get(o.name);a&&(o.checked=e.isFlagOn(t.attributes[a.name]))}),a.el.find("form.edit-form").off("submit").on("submit",t=>{const n=t.target;t.preventDefault();const r=$(n).parents("[data-type=item]").data().instance,a=e.serializeForm(n);Object.keys(a).forEach(e=>{o.columns.find(t=>t.name===e)?.update?.dontsave&&delete a[e]}),r.update(a).catch(e.onError)}));const i=e.resolveRowActions(o),l=i.menuItems.some(e=>"clone"===e.action),s=i.menuItems.some(e=>"delete"===e.action);l&&a.el.find(".clone-item").off("click").on("click",e=>{e.preventDefault(),"function"==typeof o.onClone&&o.onClone(t,a,e)}),s&&a.el.find(".delete-item").off("click").on("click",n=>{n.preventDefault(),a.el.addClass("confirm-delete");const r=()=>a.el.removeClass("confirm-delete");e.runDeleteConfirm({item:t,view:a,options:o},()=>{t.delete().catch(e.onError).finally(r)},r)});const c=new Map;i.menuItems.forEach(e=>{e.id&&"function"==typeof e.callback&&c.set(e.id,e.callback)}),c.size&&a.el.find("[data-kgrid-action]").off("click.kgridAction").on("click.kgridAction",e=>{const n=e.currentTarget.getAttribute("data-kgrid-action"),o=c.get(n);o&&(e.preventDefault(),o(e,t,a))}),"function"==typeof o.onRowFields&&o.onRowFields(t,a,n)}}(window.KGrid),function(e){e.PREFERENCES_VERSION=1,e.localStoragePreferences={get:function(e){try{const t="undefined"!=typeof window?window:globalThis,n=t&&t.localStorage;if(!n)return null;const o=n.getItem(e);return o?JSON.parse(o):null}catch(e){return null}},set:function(e,t){try{const n="undefined"!=typeof window?window:globalThis,o=n&&n.localStorage;if(!o)return;if(null==t)return void o.removeItem(e);o.setItem(e,JSON.stringify(t))}catch(e){}}},e.preferencesStorageFor=function(t){return t&&t.preferencesStorage?t.preferencesStorage:e._config&&e._config.preferencesStorage?e._config.preferencesStorage:e.localStoragePreferences},e.layoutStorageKey=function(e){return"kgrid:"+e+":layout"},e.filtersStorageKey=function(e,t){let n="kgrid:"+e+":filters";return null!=t&&""!==String(t)&&(n+=":"+String(t)),n},e.chooserColumns=function(e){return(e||[]).filter(function(e){return e&&e.name&&!e.hidden})},e.layoutFromColumns=function(t){return{v:e.PREFERENCES_VERSION,columns:e.chooserColumns(t).map(function(e){return{name:e.name,hidden:!!e.userHidden}})}},e.parseFilterExpression=function(e){const t=String(e||""),n=["~=~",">=","<=","!=","=",">","<"];for(let e=0;e<n.length;e++){const o=n[e],r=t.indexOf(o);if(r>0)return{name:t.slice(0,r),operator:o,value:t.slice(r+o.length)}}return null},e.isUserFilterColumn=function(e){return!(!e||!e.name||e.hidden||e.features&&!1===e.features.filter)},e.readUserFilters=function(t,n){if(!t)return[];const o=[];return(n||[]).forEach(function(n){if(!e.isUserFilterColumn(n))return;const r=e.filterFormField(t,n.name);if(!r.length)return;const a=r.val();if(null==a||""===a||Array.isArray(a)&&!a.length)return;const i=r.attr("data-operator")||n.filter&&n.filter.operator||"~=~";o.push({name:n.name,value:Array.isArray(a)?a:String(a),operator:i})}),o},e.applyUserFilters=function(t,n,o){t&&o&&Array.isArray(o.filters)&&o.filters.forEach(function(o){if(!o||!o.name)return;const r=(n||[]).find(function(e){return e&&e.name===o.name});if(!e.isUserFilterColumn(r))return;if(null==o.value||""===o.value)return;let a=e.filterFormField(t,o.name);a.length||(e.ensureFilterField(t,o.name,o.value,o.operator),a=e.filterFormField(t,o.name)),a.length&&(a.val(o.value),o.operator&&a.attr("data-operator",o.operator))})},e.ensureUrlFiltersOnForm=function(t,n){if(!(t&&n&&n.url&&n.url.parameters))return;const o=String(n.url.parameters.filter||"");o&&o.split(",").forEach(function(n){const o=e.parseFilterExpression(n.trim());if(!o||!o.name||""===o.value)return;const r=e.filterFormField(t,o.name);return r.length&&r.val()?void 0:r.length?(r.val(o.value),void r.attr("data-operator",o.operator)):void e.ensureFilterField(t,o.name,o.value,o.operator)})},e.preferencesLoadLayout=function(t){if(!t||!t.storageKey)return null;const n=e.preferencesStorageFor(t).get(e.layoutStorageKey(t.storageKey));return n&&n.v===e.PREFERENCES_VERSION&&Array.isArray(n.columns)?n:null},e.preferencesSaveLayout=function(t,n){t&&t.storageKey&&e.preferencesStorageFor(t).set(e.layoutStorageKey(t.storageKey),n)},e.preferencesLoadFilters=function(t){if(!t||!t.storageKey)return null;const n=e.preferencesStorageFor(t).get(e.filtersStorageKey(t.storageKey,t.filterStorageScope));return n&&n.v===e.PREFERENCES_VERSION&&Array.isArray(n.filters)?n:null},e.preferencesSaveFilters=function(t,n){t&&t.storageKey&&e.preferencesStorageFor(t).set(e.filtersStorageKey(t.storageKey,t.filterStorageScope),{v:e.PREFERENCES_VERSION,filters:n||[]})},e.reorderColumns=function(e,t){const n=new Map,o=[];(e||[]).forEach(function(e,t){e&&e.hidden?o.push({col:e,index:t}):e&&e.name&&n.set(e.name,e)});const r=[];(t||[]).forEach(function(e){n.has(e)&&(r.push(n.get(e)),n.delete(e))}),n.forEach(function(e){r.push(e)});const a=r.slice();return o.forEach(function(e){a.splice(Math.min(e.index,a.length),0,e.col)}),a},e.columnDefaultUserHidden=function(e){return!(!e||!e.defaultHidden||e.locked||e.hidden)},e.mergeLayoutIntoColumns=function(t,n){const o=(t||[]).slice();o.forEach(function(t){t&&!t.hidden&&(t.userHidden=e.columnDefaultUserHidden(t))});const r=e.chooserColumns(o),a=new Map(r.map(function(e){return[e.name,e]})),i=[],l=new Set;(n&&Array.isArray(n.columns)?n.columns:[]).forEach(function(e){if(!e||!e.name||!a.has(e.name))return;const t=a.get(e.name);t.userHidden=!!e.hidden&&!t.locked,i.push(e.name),l.add(e.name)}),r.forEach(function(e){l.has(e.name)||i.push(e.name)});const s=e.reorderColumns(o,i),c=e.chooserColumns(s);if(c.length&&c.every(function(e){return e.userHidden})){(c.find(function(e){return!e.locked})||c[0]).userHidden=!1}return s},e.applyLayoutToDom=function(t,n,o){if(!t||!t.length)return;const r=e.chooserColumns(n).map(function(e){return e.name}),a={};e.chooserColumns(n).forEach(function(e){e.userHidden&&(a[e.name]=!0)});t.find(".thead-labels tr, .thead-filters tr, .before-main-tbody tr, .main-tbody tr, .after-main-tbody tr").each(function(){const e=$(this),t=e.children(".kgrid-row-actions"),n={};e.children("[data-name]").each(function(){n[this.getAttribute("data-name")]=this}),r.forEach(function(o){const r=n[o];r&&(t.length?$(r).insertBefore(t):e.append(r),r.classList.toggle("kgrid-user-hidden",!!a[o]))})});const i=t.find(".kgrid-row-actions").length>0;e.syncActionColumnColgroup(t,r.length,i,o,e.chooserColumns(n))},e.refreshCollectionTemplate=function(t,n){if(!t||!t.instance||"function"!=typeof e.fillDataRow)return;const o=e.getKViews(n&&n.kviews);if(!o||"function"!=typeof o.template)return;const r=$("<tr>");n.dataRowAttrs&&e.isPlainObject(n.dataRowAttrs)&&Object.keys(n.dataRowAttrs).forEach(function(e){r.attr(e,n.dataRowAttrs[e])}),e.fillDataRow(r,n);const a=$("<div>").append(r).html(),i=o.template(a);t.instance.template=i,(t.instance.items||[]).forEach(function(e){(e.views||[]).forEach(function(e){e.template=i})})},e.setupFilterPersistence=function(t,n){t&&n&&n.storageKey&&n.features&&n.features.filtering&&$(t).off("submit.kgridFilterPrefs").on("submit.kgridFilterPrefs",function(){e.preferencesSaveFilters(n,e.readUserFilters(t,n.columns))})},e.applyColumnLayout=function(t,n,o){n.columns=e.mergeLayoutIntoColumns(n.columns,o);const r=t.$host.find("table").first();if(e.applyLayoutToDom(r,n.columns,n),e.refreshCollectionTemplate(t,n),"function"==typeof e.renderColumnChooserPanel){const o=t.$host.find(".kgrid-column-chooser-panel");o.length&&e.renderColumnChooserPanel(o,n,t)}return e.layoutFromColumns(n.columns)}}(window.KGrid),function(e){function t(t){const n=[];return t.find(".kgrid-column-chooser-list li[data-name]").each(function(){const e=this.getAttribute("data-name"),t=$(this).find("input[type='checkbox']").prop("checked");n.push({name:e,hidden:!t})}),{v:e.PREFERENCES_VERSION,columns:n}}e.renderColumnChooserPanel=function(n,o,r){n.empty();const a=$("<ul>").addClass("kgrid-column-chooser-list").appendTo(n);e.chooserColumns(o.columns).forEach(function(e){const t=$("<li>").attr("draggable","true").attr("data-name",e.name).appendTo(a);$("<span>").addClass("kgrid-column-chooser-handle").attr("aria-hidden","true").text("⋮⋮").appendTo(t);const n=$("<label>").appendTo(t),o=$("<input>").attr("type","checkbox").prop("checked",!e.userHidden).appendTo(n);e.locked&&o.prop("disabled",!0).attr("title","This column cannot be hidden"),n.append(document.createTextNode(" "+(e.label||e.name)))}),$("<button>").attr("type","button").addClass("btn btn-sm btn-outline-secondary kgrid-column-chooser-reset").text(o.columnChooserResetLabel||"Reset columns").appendTo(n),n.off("change.kgridChooser").on("change.kgridChooser","input[type='checkbox']",function(){const e=t(n);(function(e){return e.columns.filter(function(e){return!e.hidden}).length})(e)<1?this.checked=!0:r.setLayout(e)}),n.off("click.kgridChooserReset").on("click.kgridChooserReset",".kgrid-column-chooser-reset",function(){r.resetLayout()});let i=null;a.off(".kgridChooserDrag"),a.on("dragstart.kgridChooserDrag","li",function(e){i=this,$(this).addClass("kgrid-column-chooser-dragging"),e.originalEvent&&e.originalEvent.dataTransfer&&(e.originalEvent.dataTransfer.effectAllowed="move",e.originalEvent.dataTransfer.setData("text/plain",this.getAttribute("data-name")))}),a.on("dragend.kgridChooserDrag","li",function(){$(this).removeClass("kgrid-column-chooser-dragging"),i=null}),a.on("dragover.kgridChooserDrag","li",function(e){if(e.preventDefault(),!i||i===this)return;const t=this.getBoundingClientRect(),n=t.top+t.height/2;(e.originalEvent?e.originalEvent.clientY:0)<n?this.parentNode.insertBefore(i,this):this.parentNode.insertBefore(i,this.nextSibling)}),a.on("drop.kgridChooserDrag","li",function(e){e.preventDefault(),r.setLayout(t(n))})},e.setupColumnChooser=function(t,n,o){if(!n.features||!n.features.columnChooser)return;const r=e.getTableInteractionHost(t);r.find(".kgrid-column-chooser").remove();const a=n.columnChooserLabel||"Columns",i=$("<div>").addClass("kgrid-column-chooser"),l=$("<button>").attr("type","button").addClass("kgrid-column-chooser-toggle btn btn-sm btn-outline-secondary").attr("title",a).attr("aria-expanded","false").attr("aria-haspopup","true").html('<i class="fas fa-table-columns" aria-hidden="true"></i><span class="kgrid-column-chooser-toggle-label"> '+$("<div>").text(a).html()+"</span>"),s=$("<div>").addClass("kgrid-column-chooser-panel").attr("hidden","hidden");function c(){s.attr("hidden","hidden"),l.attr("aria-expanded","false")}i.append(l,s),r.prepend(i),e.renderColumnChooserPanel(s,n,o),l.on("click",function(e){e.stopPropagation();!s.attr("hidden")?c():(s.removeAttr("hidden"),l.attr("aria-expanded","true"))});const u="kgridChooser"+e.uuid();$(document).on("pointerdown."+u,function(e){document.body.contains(i[0])?i[0].contains(e.target)||c():$(document).off("pointerdown."+u)})}}(window.KGrid),function(e){e.init=async function(t,n){const o=e.resolveHostElement(t),r={...e.protoOptions,...n},a=e.mountTableShell(o,r);e.log("table config options",r);const i=e.resolveDefaultInteraction(r);e.applyInteraction(o,i);const l={$host:o,instance:null,filterForm:null,find:e=>o.find(e),setInteraction:(t,n)=>(e.applyInteraction(o,t,n),l),getInteraction:()=>"edit"===e.getTableInteractionHost(o).attr("data-interaction")?"edit":"view",setEditMode(e){if("boolean"!=typeof e)throw new TypeError("setEditMode(editMode) expects a boolean (true = edit, false = view)");return l.setInteraction(e?"edit":"view")},toggleEditMode:e=>(null!=e&&"object"==typeof e&&"function"==typeof e.preventDefault&&(e=void 0),"boolean"==typeof e?l.setInteraction(e?"edit":"view"):l.setInteraction("edit"===l.getInteraction()?"view":"edit")),getLayout:()=>e.layoutFromColumns(r.columns),setLayout:t=>(e.applyColumnLayout(l,r,t),e.preferencesSaveLayout(r,l.getLayout()),l.getLayout()),resetLayout(){const t=new Map;return r.columns.forEach(function(e){e&&e.name&&t.set(e.name,e)}),r.columns=s.map(function(e){return t.get(e)}).filter(Boolean),e.preferencesSaveLayout(r,null),e.applyColumnLayout(l,r,null),l.getLayout()}};r.columns=(r.columns||[]).map(t=>e.normalizeColumnConfig(t));const s=r.columns.map(function(e){return e.name});r.columns=e.mergeLayoutIntoColumns(r.columns,e.preferencesLoadLayout(r));const c=r.handlers??{};if(delete r.handlers,"string"==typeof r.onClone){const e=c[r.onClone]||r.functions&&r.functions[r.onClone];if(!e||"function"!=typeof e)throw new Error("onClone handler "+r.onClone+" not found or is not a function");r.onClone=e}e.resolveRowActions(r,c);{const t=r._resolvedRowActions;e.getTableInteractionHost(o).attr("data-has-row-menu",t&&t.menuItems&&t.menuItems.length?"true":"false")}r.columns.forEach(e=>{["insert","update","display"].forEach(t=>{const n=e[t].events;if(!n||!Array.isArray(n))throw new Error("Column "+e.name+" events are not an array");n.forEach(t=>{if("string"==typeof t.callback){const n=c[t.callback]||r.functions&&r.functions[t.callback];if(!n||"function"!=typeof n)throw new Error("Event callback function "+t.callback+" not found for column "+e.name+" or is not a function");t.callback=n}else if("function"!=typeof t.callback)throw new Error("Event callback must be a function for column "+e.name)})});const t=e.display;t&&t.events&&Array.isArray(t.events)&&t.events.forEach(e=>{if("string"==typeof e.callback){const t=c[e.callback]||r.functions&&r.functions[e.callback];t&&"function"==typeof t&&(e.callback=t)}})});const u=new Map;r.columns.forEach(e=>{u.set(e.name,e)});const d=e.setupLabelsHeader(a.find(".thead-labels"),r),f=e.hasActionColumn(r),p=d.find("th").length,m=p-(f?1:0);e.syncActionColumnColgroup(a,m,f,r,e.chooserColumns(r.columns));const g=r.filterForm??e.setupFilterHeader(a,r);let h;r.features&&r.features.paging?h=e.setupPagingFooter(a.find(".paging-footer"),r,p):(h=null,a.find(".paging-footer").remove());const y=e.setupNoDataTbody(a.find(".no-data-tbody"),r,p);r.features&&r.features.create&&e.setupNewRecordForm(a,r,l),l.filterForm=new e.FilterForm(g);const b=e.setupDataBody(a.find(".main-tbody"),r,d,g,h,y),w={dontload:!0,setAttrAsId:r.setAttrAsId??!1,itemListeners:{afterrender:t=>e.setupEvents(t,l.find("table"),r,u)}},v=e.getKViews(r.kviews);if(!v)throw new Error(e.KVIEWS_MISSING_MSG);l.instance=await v.createCollectionInstance(b,w),r.url&&(l.instance.setUrl(r.url),r.deleteUrl&&(e.log("set deleteUrl",r.deleteUrl),l.instance.setUrl(r.deleteUrl,"delete")),r.updateUrl&&(e.log("set updateUrl",r.updateUrl),l.instance.setUrl(r.updateUrl,"update")),r.insertUrl&&l.instance.setUrl(r.insertUrl,"insert")),e.setupDefaultFilters(g,r,l.instance,{skipInitSubmit:!0});const C=g&&(g.jquery?g[0]:g);if(e.applyUserFilters(C,r.columns,e.preferencesLoadFilters(r)),e.ensureUrlFiltersOnForm(C,l.instance),e.setupFilterPersistence(C,r),e.setupColumnChooser(o,r,l),r.url)try{r.features&&r.features.filtering&&C&&e.syncFormFiltersToCollectionUrl(C,l.instance),await l.instance.loadFromRemote()}catch(t){e.onError(t)}else{if(!r.data||r.data.constructor!==Array)throw new Error("Invalid data: missing datasource url or data for table");{const e=r.data.map(e=>({attributes:e}));l.instance.loadFromData(e)}}return l}}(window.KGrid);
|
package/docs/ai-guide.md
CHANGED
|
@@ -21,7 +21,7 @@ Human-readable references: [README](../README.md), [configuration.md](configurat
|
|
|
21
21
|
|-------------|--------|
|
|
22
22
|
| jQuery `>= 3.7.0` | Peer dependency |
|
|
23
23
|
| `@logimaxx/kviews` | Peer; must expose `createCollectionInstance` |
|
|
24
|
-
| `styles/table.css` | **Required** — view/edit modes, row-actions
|
|
24
|
+
| `styles/table.css` | **Required** — view/edit modes, row-actions collapse / compact width, cell visibility |
|
|
25
25
|
| Load order | jQuery → KViews → `kgrid.js` → (optional `kgrid-widgets.js`) → `configure({ customInputTypes })` → `init()` |
|
|
26
26
|
| Bootstrap + Font Awesome | Recommended (default template uses `btn-*`, `fa-sort-*`) |
|
|
27
27
|
|
|
@@ -62,7 +62,10 @@ const grid = await KGrid.init(document.getElementById("grid-host"), {
|
|
|
62
62
|
create: true,
|
|
63
63
|
update: true,
|
|
64
64
|
delete: true,
|
|
65
|
+
columnChooser: true,
|
|
65
66
|
},
|
|
67
|
+
storageKey: "catalog.products",
|
|
68
|
+
filterStorageScope: companyId,
|
|
66
69
|
columns: [/* see column shape below */],
|
|
67
70
|
});
|
|
68
71
|
|
|
@@ -82,7 +85,7 @@ const grid = await KGrid.init(document.getElementById("grid-host"), {
|
|
|
82
85
|
| `onError` | Always in production apps |
|
|
83
86
|
| `deleteConfirm(context, onConfirm, onCancel)` | Row delete UI (preferred over hardcoded messages) |
|
|
84
87
|
| `confirm(message, onConfirm, onCancel)` | Generic dialogs; default delete flow uses this if `deleteConfirm` unset |
|
|
85
|
-
| `serializeForm(form, columns?)` |
|
|
88
|
+
| `serializeForm(form, columns?)` | Override only for non-flat APIs. Default already emits checkbox flags as `"1"` / `"0"`. |
|
|
86
89
|
| `customInputTypes` | Map of type name → plugin (`KGrid.select2(fn)`, `KGrid.inputType(…)`, or `{ create, … }`) |
|
|
87
90
|
|
|
88
91
|
Per-table override: pass `deleteConfirm` in `init(host, { deleteConfirm, ... })`.
|
|
@@ -101,7 +104,7 @@ Per-table override: pass `deleteConfirm` in `init(host, { deleteConfirm, ... })`
|
|
|
101
104
|
**Features** (all default `false`):
|
|
102
105
|
|
|
103
106
|
```javascript
|
|
104
|
-
features: { filtering, sorting, paging, create, update, delete }
|
|
107
|
+
features: { filtering, sorting, paging, create, update, delete, columnChooser }
|
|
105
108
|
```
|
|
106
109
|
|
|
107
110
|
**Interaction:**
|
|
@@ -114,7 +117,7 @@ features: { filtering, sorting, paging, create, update, delete }
|
|
|
114
117
|
- `emptyRowMessage`, `pagingPageSizes`, `pagingDefaultSize`, `pagingFooterLabel`
|
|
115
118
|
- `noDataTemplate` — HTML for empty tbody (often `colspan` large, e.g. `99`)
|
|
116
119
|
|
|
117
|
-
**Insert row:** `insertFormRow: { position: "top" | "bottom" }`, `onNewItemCreated(data)`, `onInsertRowReady(form, row)`
|
|
120
|
+
**Insert row:** `insertFormRow: { position: "top" | "bottom" }`, `onNewItemCreated(data, form)`, `onInsertRowReady(form, row)`
|
|
118
121
|
|
|
119
122
|
**Row lifecycle:** `onRowFields(item, view, table)` — called after each data row’s `afterrender` / field mount (per-row enable/disable, show/hide).
|
|
120
123
|
|
|
@@ -128,7 +131,9 @@ Each column in `columns: []` is normalized via `KGrid.normalizeColumnConfig` (pr
|
|
|
128
131
|
{
|
|
129
132
|
name: "sku", // required for filter/sort/update
|
|
130
133
|
label: "SKU",
|
|
131
|
-
hidden: false,
|
|
134
|
+
hidden: false, // schema: omit from UI entirely
|
|
135
|
+
defaultHidden: false, // start collapsed; still in the column chooser
|
|
136
|
+
locked: false, // column chooser cannot hide this field
|
|
132
137
|
class: "col-sku", // CSS on th/td (alias: columnClass); also sets data-name
|
|
133
138
|
features: { create, update, filter, sort }, // per-column flags
|
|
134
139
|
// Shared insert+update defaults (explicit insert/update win):
|
|
@@ -154,18 +159,23 @@ Each column in `columns: []` is normalized via `KGrid.normalizeColumnConfig` (pr
|
|
|
154
159
|
|
|
155
160
|
**Hidden / persist filters:** columns with `hidden: true` or `filter.type: "hidden"` get a hidden form field (no filter-row cell). `filter.persist` (or hidden) re-applies `filter.default` on form reset.
|
|
156
161
|
|
|
162
|
+
**User column layout + filter reload:** `storageKey` persists layout (all companies) and filter values (`filterStorageScope` suffixes filters, e.g. company id) to `localStorage`. `features.columnChooser` adds a Columns panel (reorder + hide). Schema `hidden` columns stay out of the chooser. `defaultHidden: true` starts the column collapsed but still listed in the chooser (lean list defaults). `locked: true` columns cannot be hidden. User-hidden columns collapse in the table but keep filter/insert/update inputs. `grid.getLayout()` / `setLayout()` / `resetLayout()` (reset restores `defaultHidden`, not “all visible”).
|
|
163
|
+
|
|
157
164
|
---
|
|
158
165
|
|
|
159
166
|
## Row actions column (do not break)
|
|
160
167
|
|
|
161
|
-
|
|
168
|
+
Prefer `rowActions: { display, items }` for delete / clone / custom actions. `features.update` injects Save / Cancel. `features.create` keeps the insert submit cell. Legacy `features.delete` / `features.clone` still shim when `rowActions` is omitted.
|
|
169
|
+
|
|
170
|
+
When `KGrid.hasActionColumn(options)`:
|
|
162
171
|
|
|
163
172
|
- Trailing column: `.kgrid-row-actions` on `th`/`td`
|
|
164
173
|
- `<colgroup>` with `col.kgrid-row-actions-col` (synced at init)
|
|
165
|
-
- **View mode:** column collapsed — full width for data columns
|
|
166
|
-
- **Edit mode:** column visible
|
|
174
|
+
- **View mode:** column collapsed unless `data-has-row-menu` (idle menu actions present) — full width for data columns when collapsed
|
|
175
|
+
- **Edit mode:** column visible — menu/idle actions + save/cancel; insert row submit in `.new-record-row`
|
|
176
|
+
- **Dropdown mode:** `.kgrid-row-actions-menu` for idle items; save/cancel stay as buttons
|
|
167
177
|
|
|
168
|
-
Rule: `KGrid.hasActionColumn(options)` —
|
|
178
|
+
Rule: always use `KGrid.hasActionColumn(options)` — do not add action `<th>` only in header or only in body. Do not invent a data column for action buttons.
|
|
169
179
|
|
|
170
180
|
---
|
|
171
181
|
|
|
@@ -200,6 +210,7 @@ grid.filterForm // .filter(name, value, op), .reset()
|
|
|
200
210
|
grid.find(sel) // search under $host
|
|
201
211
|
grid.setInteraction(mode, overrides?)
|
|
202
212
|
grid.getInteraction() // "view" | "edit"
|
|
213
|
+
grid.getLayout() / setLayout() / resetLayout()
|
|
203
214
|
```
|
|
204
215
|
|
|
205
216
|
Deprecated: `setEditMode`, `toggleEditMode` — use `setInteraction`.
|
|
@@ -211,6 +222,8 @@ Deprecated: `setEditMode`, `toggleEditMode` — use `setInteraction`.
|
|
|
211
222
|
| Task | Approach |
|
|
212
223
|
|------|----------|
|
|
213
224
|
| Toggle edit UI | `grid.setInteraction("edit")` / `"view"` |
|
|
225
|
+
| Column chooser | `features.columnChooser` + `storageKey` |
|
|
226
|
+
| Persist filters on reload | `storageKey` (+ optional `filterStorageScope`) |
|
|
214
227
|
| Programmatic filter | `grid.filterForm.filter("name", "x", "~=~")` |
|
|
215
228
|
| Reload data | `grid.instance.loadFromRemote()` |
|
|
216
229
|
| Custom delete modal | `KGrid.configure({ deleteConfirm })` |
|
|
@@ -235,6 +248,7 @@ Deprecated: `setEditMode`, `toggleEditMode` — use `setInteraction`.
|
|
|
235
248
|
10. **Editing `dist/kgrid.js` in node_modules** — change `src/` in the package or fork; rebuild with `npm run build`.
|
|
236
249
|
11. **Assuming cancel edit reloads local `data`** — cancel button calls `loadFromRemote()`; local-only grids need a custom approach.
|
|
237
250
|
12. **Breaking class names** — `custom-table-shell`, `data-interaction`, `main-tbody`, `kgrid-row-actions` are required by CSS and KViews wiring.
|
|
251
|
+
13. **Host CSS `display: none` on `.kgrid-user-hidden`** — leaves width gaps under `table-layout: fixed`; keep `visibility: collapse` (clip text if Chrome stretches thead).
|
|
238
252
|
|
|
239
253
|
---
|
|
240
254
|
|
|
@@ -270,4 +284,4 @@ Run demo locally: `npm run demo` in the kgrid package → `http://localhost:5173
|
|
|
270
284
|
|
|
271
285
|
## Version
|
|
272
286
|
|
|
273
|
-
This guide matches **@logimaxx/kgrid@0.
|
|
287
|
+
This guide matches **@logimaxx/kgrid@0.4.1** (column chooser, `defaultHidden`, persisted layout/filters, row lifecycle hooks, `column.class`, persist filters, `input` shorthand). If APIs differ in another version, prefer `docs/api.md` in the installed package.
|
package/docs/api.md
CHANGED
|
@@ -12,10 +12,11 @@ Merge host integration hooks. Call before initializing tables.
|
|
|
12
12
|
| `onError` | `(err) => void` | `console.error` |
|
|
13
13
|
| `confirm` | `(message, onConfirm, onCancel?) => void` | `window.confirm` |
|
|
14
14
|
| `deleteConfirm` | `(context, onConfirm, onCancel?) => void` | `null` — falls back to `confirm` + `DEFAULT_DELETE_CONFIRM_MESSAGE` |
|
|
15
|
-
| `serializeForm` | `(form, columns?) => object` | `
|
|
15
|
+
| `serializeForm` | `(form, columns?) => object` | Named fields; checkboxes always `"1"` / `"0"` (unchecked included) |
|
|
16
16
|
| `kviews` | KViews module | `window.KViews` |
|
|
17
17
|
| `customInputTypes` | `Record<string, FieldTypePlugin>` | Each value: `{ create, mount?, … }` (use `KGrid.select2(fn)` etc.) |
|
|
18
18
|
| `filterDebounceMs` | `number` | Default delay (ms) before filter API submit on the resolved submit event (`input` or `change`); `0` = immediate (default `300`) |
|
|
19
|
+
| `preferencesStorage` | `{ get(key), set(key, value\|null) }` | Override `localStorage` for layout/filter prefs (tests) |
|
|
19
20
|
| `fieldTypes` | same as `customInputTypes` | **Deprecated** alias |
|
|
20
21
|
|
|
21
22
|
Returns `KGrid` (chainable). Re-syncs `customInputTypes` on every call.
|
|
@@ -53,7 +54,8 @@ See [field-types.md](field-types.md).
|
|
|
53
54
|
|
|
54
55
|
**Internal helpers:**
|
|
55
56
|
|
|
56
|
-
- `KGrid.log`, `onError`, `confirm`, `runDeleteConfirm`, `serializeForm`
|
|
57
|
+
- `KGrid.log`, `onError`, `confirm`, `runDeleteConfirm`, `serializeForm`, `serializeFormDefault`
|
|
58
|
+
- `KGrid.isFlagOn(v)` — `true` / `1` / `"1"` are on; used for checkbox flags
|
|
57
59
|
- `KGrid.DEFAULT_DELETE_CONFIRM_MESSAGE` — default text when `deleteConfirm` is not set
|
|
58
60
|
|
|
59
61
|
`KGrid.select2.helpers` — Select2 option helpers (after loading `kgrid-widgets.js`).
|
|
@@ -80,6 +82,7 @@ Async table initializer.
|
|
|
80
82
|
| `filterForm` | `FilterForm` or setup result |
|
|
81
83
|
| `find(sel)` | ` $host.find(sel)` |
|
|
82
84
|
| `setInteraction`, `getInteraction`, `toggleEditMode`, `setEditMode` | Interaction mode |
|
|
85
|
+
| `getLayout`, `setLayout`, `resetLayout` | Column order / user-hidden columns |
|
|
83
86
|
|
|
84
87
|
### Prototypes
|
|
85
88
|
|
|
@@ -111,8 +114,11 @@ See **[table-shell.md](table-shell.md)** for structure, placeholders, and custom
|
|
|
111
114
|
|
|
112
115
|
| Symbol | Description |
|
|
113
116
|
|--------|-------------|
|
|
114
|
-
| `KGrid.hasActionColumn(options)` | `true` when `features.
|
|
115
|
-
| `KGrid.
|
|
117
|
+
| `KGrid.hasActionColumn(options)` | `true` when `features.create`, or resolved `rowActions` / shimmed delete·clone / `features.update` (save/cancel) |
|
|
118
|
+
| `KGrid.actionColumnWidth(options)` | Compact CSS width for the actions column under `table-layout: fixed` |
|
|
119
|
+
| `KGrid.resolveRowActions(options, handlers?)` | Normalize `rowActions` (or shim from features); caches on `options` |
|
|
120
|
+
| `KGrid.renderRowActions($td, options, formId?)` | Fill a data-row actions cell (buttons or dropdown) |
|
|
121
|
+
| `KGrid.syncActionColumnColgroup($table, dataColumnCount, hasActions, options?)` | Prepends `<colgroup>` so the actions column can collapse in view mode; sets actions col width from `actionColumnWidth` |
|
|
116
122
|
|
|
117
123
|
Requires `styles/table.css` for view/edit visibility rules on `.kgrid-row-actions` and `col.kgrid-row-actions-col`.
|
|
118
124
|
|
|
@@ -153,6 +159,18 @@ Use `setInteraction`.
|
|
|
153
159
|
- `boolean` → set mode
|
|
154
160
|
- no arg / DOM event → toggle view ↔ edit
|
|
155
161
|
|
|
162
|
+
#### `grid.getLayout()`
|
|
163
|
+
|
|
164
|
+
`{ columns: [{ name, hidden }] }` — chooser columns in display order. `hidden` is user-hidden (schema-hidden columns are omitted).
|
|
165
|
+
|
|
166
|
+
#### `grid.setLayout(layout)`
|
|
167
|
+
|
|
168
|
+
Apply order + visibility, persist when `storageKey` is set, update DOM and the KViews row template.
|
|
169
|
+
|
|
170
|
+
#### `grid.resetLayout()`
|
|
171
|
+
|
|
172
|
+
Restore JSON column order and show all chooser columns; clears stored layout.
|
|
173
|
+
|
|
156
174
|
---
|
|
157
175
|
|
|
158
176
|
## `KGrid.FilterForm`
|
package/docs/configuration.md
CHANGED
|
@@ -155,16 +155,64 @@ features: {
|
|
|
155
155
|
update: false,
|
|
156
156
|
delete: false,
|
|
157
157
|
clone: false,
|
|
158
|
+
columnChooser: false,
|
|
158
159
|
}
|
|
159
160
|
```
|
|
160
161
|
|
|
162
|
+
### Column chooser and persisted preferences
|
|
163
|
+
|
|
164
|
+
| Option | Type | Description |
|
|
165
|
+
|--------|------|-------------|
|
|
166
|
+
| `storageKey` | `string` | Persist layout (order + user-hidden) and filter values. Layout key: `kgrid:{storageKey}:layout`. Filters: `kgrid:{storageKey}:filters` plus optional scope. |
|
|
167
|
+
| `filterStorageScope` | `string` | Suffix for saved filters only (e.g. company id). Layout is shared across scopes. |
|
|
168
|
+
| `features.columnChooser` | `boolean` | Columns panel (checkbox + drag). Works without `storageKey` (session only). |
|
|
169
|
+
| `columnChooserLabel` | `string` | Button label (default `"Columns"`) |
|
|
170
|
+
| `columnChooserResetLabel` | `string` | Reset button (default `"Reset columns"`) |
|
|
171
|
+
| `preferencesStorage` | `{ get, set }` | Per-table override of `configure({ preferencesStorage })`; default `localStorage` |
|
|
172
|
+
|
|
173
|
+
Column flags:
|
|
174
|
+
|
|
175
|
+
| Field | Meaning |
|
|
176
|
+
|-------|---------|
|
|
177
|
+
| `hidden: true` | Schema — omitted from UI and chooser (e.g. internal `id`) |
|
|
178
|
+
| `defaultHidden: true` | Start collapsed (`userHidden`); still in the chooser so users can show it. Ignored when `locked`. Reset columns restores this default. |
|
|
179
|
+
| `locked: true` | Visible; chooser cannot hide it (still reorderable). Use on required list fields such as name. |
|
|
180
|
+
| `userHidden` | Runtime only — set via chooser / `setLayout` |
|
|
181
|
+
|
|
182
|
+
User-hidden columns use `visibility: collapse` (not `display: none`) so insert/update/filter controls stay in the DOM and `table-layout: fixed` redistributes width to the remaining columns. Host CSS that forces `display: none` on `.kgrid-user-hidden` leaves gaps. Filter values on hidden columns remain until Reset.
|
|
183
|
+
|
|
184
|
+
`filter.persist` still means “keep `filter.default` on form reset” — it is not reload persistence. Reload persistence is `storageKey`.
|
|
185
|
+
|
|
161
186
|
### Row actions column
|
|
162
187
|
|
|
163
|
-
|
|
188
|
+
Prefer declarative **`rowActions`** for delete / clone / custom menu actions. `features.update` still enables inline edit and **automatically** adds Save / Cancel buttons. `features.create` still owns the insert-row submit cell.
|
|
189
|
+
|
|
190
|
+
```javascript
|
|
191
|
+
rowActions: {
|
|
192
|
+
display: "buttons", // or "dropdown"
|
|
193
|
+
items: [
|
|
194
|
+
{ action: "clone" },
|
|
195
|
+
{ action: "delete", title: "Șterge" },
|
|
196
|
+
{ id: "open", label: "Open", icon: "fas fa-external-link-alt", callback: "onOpen" },
|
|
197
|
+
],
|
|
198
|
+
},
|
|
199
|
+
features: { update: true, create: true }, // save/cancel injected; insert row unchanged
|
|
200
|
+
onClone: "cloneRow",
|
|
201
|
+
```
|
|
202
|
+
|
|
203
|
+
| Built-in `action` | Default icon | Shown | Behavior |
|
|
204
|
+
|-------------------|--------------|-------|----------|
|
|
205
|
+
| `clone` | `fa-regular fa-copy` | idle | `onClone(item, view, event)` |
|
|
206
|
+
| `delete` | `fas fa-trash` | idle | `deleteConfirm` then `item.delete()` |
|
|
207
|
+
| `save` / `cancel` | save / undo | editing | **Not listed in `items`** — added when `features.update` |
|
|
208
|
+
|
|
209
|
+
`display: "dropdown"` puts idle/menu items in a Bootstrap kebab menu; Save / Cancel stay as separate buttons.
|
|
210
|
+
|
|
211
|
+
**Deprecated:** `features.delete` / `features.clone` still work (shim into `rowActions`) when `rowActions` is omitted. If both are set, `rowActions` wins and KGrid warns.
|
|
164
212
|
|
|
165
213
|
```javascript
|
|
166
214
|
KGrid.hasActionColumn(options)
|
|
167
|
-
// true when
|
|
215
|
+
// true when create, or any resolved menu/editing action exists
|
|
168
216
|
```
|
|
169
217
|
|
|
170
218
|
| Markup | Role |
|
|
@@ -172,13 +220,13 @@ KGrid.hasActionColumn(options)
|
|
|
172
220
|
| `th` / `td.kgrid-row-actions` | Header, filters, data rows |
|
|
173
221
|
| `colgroup col.kgrid-row-actions-col` | Width control for `table-layout: fixed` (added at init via `syncActionColumnColgroup`) |
|
|
174
222
|
|
|
175
|
-
**View vs edit:** In **view** mode
|
|
223
|
+
**View vs edit:** In **view** mode, the row-actions column collapses **unless** there are idle menu actions (`rowActions.items` / shimmed delete·clone) — then the column stays visible so list screens can delete/clone without entering edit. Save / Cancel still only appear while a row is `.editing`. In **edit** mode, width comes from `KGrid.actionColumnWidth(options)`.
|
|
176
224
|
|
|
177
|
-
|
|
225
|
+
Do not use a fake data column named `actions` with HTML button templates — use `rowActions` + `handlers` instead.
|
|
178
226
|
|
|
179
|
-
|
|
227
|
+
Host must supply `onClone` when clone is configured. Override delete UX: `deleteConfirm` (see [integration.md](integration.md#deleteconfirm-row-delete)).
|
|
180
228
|
|
|
181
|
-
|
|
229
|
+
The new-record row (`.new-record-row`) uses the same `kgrid-row-actions` class on its submit cell; the whole insert row is hidden in view mode via existing CSS.
|
|
182
230
|
|
|
183
231
|
### Interaction mode
|
|
184
232
|
|
|
@@ -194,7 +242,7 @@ CSS on `.custom-table-shell`: `data-interaction="view|edit"`. Optional overrides
|
|
|
194
242
|
| Option | Type | Default | Description |
|
|
195
243
|
|--------|------|---------|-------------|
|
|
196
244
|
| `insertFormRow.position` | `'top' \| 'bottom'` | `'top'` | New-record row position |
|
|
197
|
-
| `onNewItemCreated` | `function(data)` | — | After successful insert |
|
|
245
|
+
| `onNewItemCreated` | `function(data, form)` | — | After successful insert (form already reset) |
|
|
198
246
|
| `onInsertRowReady` | `function(form, row)` | — | After insert row DOM is built |
|
|
199
247
|
| `onRowFields` | `function(item, view, table)` | — | After each data row render / field mount |
|
|
200
248
|
| `deleteConfirm` | `(context, onConfirm, onCancel?) => void` | — | Row delete UX for this table; overrides `KGrid.configure({ deleteConfirm })` |
|
|
@@ -246,7 +294,8 @@ Each element of `columns: []`:
|
|
|
246
294
|
|-------|------|-------------|
|
|
247
295
|
| `name` | `string` | Field name (**required** for sort, filter, create, update on that column) |
|
|
248
296
|
| `label` | `string` | Header text |
|
|
249
|
-
| `hidden` | `boolean` | Hide from UI; may still participate in forms (e.g. `id` as `hidden`) |
|
|
297
|
+
| `hidden` | `boolean` | Hide from UI; may still participate in forms (e.g. `id` as `hidden`). Not user-togglable. |
|
|
298
|
+
| `locked` | `boolean` | Column chooser cannot hide this column |
|
|
250
299
|
| `class` / `columnClass` | `string` | CSS class on label/filter/data/insert cells; sets `data-name` |
|
|
251
300
|
| `attrs` | `object` | HTML attributes on header/cells |
|
|
252
301
|
| `input` | `object` | Shared defaults for `insert` + `update` (explicit blocks win) |
|
|
@@ -286,10 +335,11 @@ Check types with `KGrid.isValidInputType(type)`.
|
|
|
286
335
|
| Field | Type | Default | Description |
|
|
287
336
|
|-------|------|---------|-------------|
|
|
288
337
|
| `type` | `string` | `text` | Control type |
|
|
289
|
-
| `operator` | `string` | `~=~` | `data-operator` for KViews (`~=~`, `=`, …) |
|
|
290
|
-
| `default` | `any` | | Initial value |
|
|
291
|
-
| `placeholder` | `string` | `""` | |
|
|
338
|
+
| `operator` | `string` | `~=~` (`><` for `multi_select`) | `data-operator` for KViews (`~=~`, `=`, `><`, …) |
|
|
339
|
+
| `default` | `any` | | Initial value (`string` / `string[]` for `multi_select`) |
|
|
340
|
+
| `placeholder` | `string` | `""` (`"All"` for empty `multi_select`) | Toggle label when nothing selected (`multi_select`) |
|
|
292
341
|
| `options` | `array` \| `object` | | For `select`, `multi_select`, `select2`, … |
|
|
342
|
+
| `separator` | `string` | `";"` | Only `multi_select`: join selected values |
|
|
293
343
|
| `persist` | `boolean` | `false` | Re-apply `default` on filter reset (also implied when column `hidden` or `type: "hidden"`) |
|
|
294
344
|
| `debounceMs` | `number` | `configure({ filterDebounceMs })` | Ms to wait after typing before filter API call; `0` = immediate |
|
|
295
345
|
|
|
@@ -304,7 +354,7 @@ Filter controls use `form=""` pointing at a hidden `<form>` (rows cannot wrap on
|
|
|
304
354
|
| Type | Context | Notes |
|
|
305
355
|
|------|---------|--------|
|
|
306
356
|
| Native HTML | filter, insert, update | `text`, `number`, `select`, … |
|
|
307
|
-
| `multi_select` | filter |
|
|
357
|
+
| `multi_select` | filter (also insert/update) | Checkbox list; values `a;b` with operator `><` |
|
|
308
358
|
| `date_range` | filter | Built-in single date input |
|
|
309
359
|
| `select2` | filter, insert, update | `customInputTypes: { select2: KGrid.select2(fn) }` + `kgrid-widgets.js` |
|
|
310
360
|
| `autosuggest` | filter, insert, update | `customInputTypes: { autosuggest: KGrid.autosuggest(fn) }` + `kgrid-widgets.js` |
|