From 45205cd63d6e1fe17e7eae3ce9fbbf718ef973a9 Mon Sep 17 00:00:00 2001 From: Tsanie Date: Tue, 20 Feb 2024 14:31:24 +0800 Subject: [PATCH] . --- count.cjs | 95 +++++++++++++ lib/ui/grid/column.js | 317 +++++++++++++++++++++++++++++++++++++----- lib/ui/grid/grid.js | 152 ++++++++++---------- 3 files changed, 454 insertions(+), 110 deletions(-) create mode 100644 count.cjs diff --git a/count.cjs b/count.cjs new file mode 100644 index 0000000..f5eda9b --- /dev/null +++ b/count.cjs @@ -0,0 +1,95 @@ +/** + * @author HoPGoldy + * @source https://www.jianshu.com/p/333795b9893f + * @date 2020-1-7 + * + * 统计指定目录下代码行数及注释率 + * + * 用法: node count.js <路径> [后缀名]... + * 后缀名不填的话默认为统计 .js 和 .ts 文件 + * + * 示例 [统计 ./src 下的 js 文件]: node count.js ./src + * 示例 [统计 ./dist 下的 java 文件]: node count.js ./src .java + */ + +const fs = require('fs') +let path = require('path') + +// 获取命令行参数 +const parm = process.argv.splice(2) +// 第一个参数是路径 +const rootPath = parm[0] +// 后面的所有参数都是文件后缀 +let types = parm.splice(1) +if (types.length === 0) types = [ '.js', '.ts' ] +// 需要过滤的文件夹 +const filter = [ './node_modules', './.git', './.tscache' ] +// 总计 +let total = { + path: 'total', + length: 0, + comment: 0, + commentRatio: 1 +} +// 统计结果 +let result = [] + +/** + * 对指定文件进行统计 + * 包括获取文件行数、注释及计算注释率 + * + * @param {string} path 文件路径 + */ +async function count(path) { + const rep = await fs.readFileSync(path).toString() + const lines = rep.split('\n') + + // 匹配出注释的行数 + const commentNum = lines.filter(line => new RegExp('^(//|/\\*|\\*|\\*/)', 'g').test(line.trimStart())).length + + result.push({ + path, + length: lines.length, + comment: commentNum, + commentRatio: (Math.round(commentNum/lines.length * 10000) / 100) + '%' + }) + + updateTotal(lines.length, commentNum) +} + +/** + * 更新总计信息 + * + * @param {number} length 新增行数 + * @param {number} comment 新增注释 + */ +function updateTotal(length, comment) { + total.length += length + total.comment += comment + total.commentRatio = (Math.round(total.comment/total.length * 10000) / 100) + '%' +} + +/** + * 递归所有文件夹统计 + * + * @param {string} pt 根目录 + */ +async function start(pt) { + fs.readdirSync(pt).map(file => `${pt}/${file}`) + .forEach(file => { + const stat = fs.statSync(file) + // 是文件夹就递归 + if (stat.isDirectory()) { + if (filter.indexOf(pt) != -1) return + return start(file) + } + // 是文件并且后缀名符合就执行统计 + if (types.indexOf(path.extname(file)) != -1) count(file) + }) +} + +;(async () => { + await start(rootPath) + result.push(total) + console.table(result) +})() \ No newline at end of file diff --git a/lib/ui/grid/column.js b/lib/ui/grid/column.js index 5340f0a..e6a1894 100644 --- a/lib/ui/grid/column.js +++ b/lib/ui/grid/column.js @@ -6,6 +6,36 @@ import { createCheckbox } from "../checkbox"; import { Dropdown } from "../dropdown"; import { convertCssStyle } from "../extension"; import { createDateInput, formatDate, setDateValue, getDateValue } from "../date"; +// definition +import { DropdownOptions, GridItemBooleanCallback, GridDropdownSourceCallback, DateFormatterCallback, GridSourceItem, GridItemWrapper, Grid } from "./grid"; + +/** + * @ignore + * @callback DropExpandedCallback + * @param {Map} item - 行数据对象 + * @param {Dropdown} drop - 下拉框对象 + * @this GridColumnDefinition + */ + +/** + * 列定义接口 + * @ignore + * @typedef GridColumnDefinition + * @property {string} key - 列关键字，默认以该关键字从行数据中提取单元格值，行数据的关键字属性值里包含 DisplayValue 则优先显示此值 + * @property {(boolean | string | GridItemBooleanCallback)} [enabled] - 列是否可用（可编辑），允许以下类型 + * + * * `boolean` 则直接使用该值 + * * `string` 则以该值为关键字从行数据中取值作为判断条件 + * * `GridItemBooleanCallback` 则调用如下回调，以返回值作为判断条件 + * @property {DropdownOptions} [dropOptions] - 列为下拉列表类型时以该值设置下拉框的参数 + * @property {(GridSourceItem[] | Promise | GridDropdownSourceCallback)} [source] - 列为下拉列表类型时以该值设置下拉列表数据源，支持返回异步对象，也支持如下函数返回 + * @property {boolean} [sourceCache=false] - 下拉列表数据源是否缓存结果（即行数据未发生变化时仅从source属性获取一次值） + * @property {("fa-light" | "fa-regular" | "fa-solid")} [iconType=fa-light] - 列为图标类型时以该值设置图标样式 + * @property {string} [dateMin] - 列为日期类型时以该值作为最小可选日期值 + * @property {string} [dateMax] - 列为日期类型时以该值作为最大可选日期值 + * @property {DateFormatterCallback} [dateValueFormatter] - 列为日期类型时自定义日期格式化函数 + * @property {DropExpandedCallback} [onDropExpanded] - 列为下拉框类型时在下拉列表展开时触发的事件 + */ /** * 列定义基类 @@ -14,6 +44,7 @@ import { createDateInput, formatDate, setDateValue, getDateValue } from "../date * Column Refresh * @class * @static + * @hideconstructor */ export class GridColumn { /** @@ -49,7 +80,7 @@ export class GridColumn { * @param {Function} trigger - 编辑事件回调函数，`e` 参数会传递给 [getValue]{@linkcode GridColumn.getValue} 方法 * @param {GridColumnDefinition} col - 列定义对象 * @param {HTMLElement} container - 父容器元素 - * @param {GridItemWrapper} vals - 行包装对象，其 `values` 属性为行数据对象 + * @param {GridItemWrapper} wrapper - 行包装对象，其 `values` 属性为行数据对象 * @returns {HTMLElement} 返回创建的编辑状态的单元格元素 * @virtual */ @@ -67,7 +98,7 @@ export class GridColumn { * 获取编辑状态单元格值时调用的方法 * @method * @name GridColumn.getValue - * @param {any} `e` 由 [createEdit]{@linkcode GridColumn.createEdit} 方法中 `trigger` 函数传递来的对象 + * @param {any} e - 由 [createEdit]{@linkcode GridColumn.createEdit} 方法中 `trigger` 函数传递来的对象 * @param {GridColumnDefinition} col - 列定义对象 * @returns {(string | boolean | number)} 返回单元格的值 * @virtual @@ -77,7 +108,7 @@ export class GridColumn { * 设置单元格值时调用的方法 * @param {HTMLElement} element - 单元格元素 * @param {(string | boolean | number)} val - 待设置的单元格值 - * @param {GridItemWrapper} vals - 行包装对象 + * @param {GridItemWrapper} wrapper - 行包装对象 * @param {GridColumnDefinition} col - 列定义对象 * @param {Grid} grid - Grid 对象 * @virtual @@ -132,8 +163,7 @@ export class GridColumn { */ /** - * 复写 [toString]{@linkcode String#toString} 方法 - * @private + * @ignore */ static toString() { return '[object Column]' } } @@ -141,29 +171,44 @@ export class GridColumn { /** * 单行文本输入列 * @class + * @static * @extends GridColumn + * @hideconstructor */ export class GridInputColumn extends GridColumn { static get editing() { return true }; - static createEdit(trigger, col, _wrapper, vals) { + /** + * @ignore + * @param {Function} trigger + * @param {GridColumnDefinition} col + * @param {HTMLElement} _container + * @param {GridItemWrapper} wrapper + * @returns {HTMLElement} + */ + static createEdit(trigger, col, _container, wrapper) { const input = createElement('input'); input.setAttribute('type', 'text'); if (typeof trigger === 'function') { input.addEventListener('change', trigger); } input.addEventListener('input', () => { - if (vals.__editing == null) { - vals.__editing = { + if (wrapper.__editing == null) { + wrapper.__editing = { [col.key]: true } } else { - vals.__editing[col.key] = true; + wrapper.__editing[col.key] = true; } }); return input; } + /** + * @ignore + * @param {HTMLElement} element + * @param {string} val + */ static setValue(element, val) { if (element.tagName !== 'INPUT') { super.setValue(element, val); @@ -172,33 +217,67 @@ export class GridInputColumn extends GridColumn { } } + /** + * @ignore + * @param {Event} e + * @returns {string} + */ static getValue(e) { return e.target.value } + /** + * @ignore + * @param {HTMLElement} element + * @param {boolean} enabled + */ static setEnabled(element, enabled) { super.setEnabled(element, enabled); element.disabled = enabled === false; } } +/** + * 多行文本输入列 + * @class + * @static + * @extends GridInputColumn + * @hideconstructor + * @ignore + */ export class GridTextColumn extends GridInputColumn { - static createEdit(trigger, col, _wrapper, vals) { + /** + * @ignore + * @param {Function} trigger + * @param {GridColumnDefinition} col + * @param {HTMLElement} _container + * @param {GridItemWrapper} wrapper + * @returns {HTMLElement} + */ + static createEdit(trigger, col, _container, wrapper) { const input = createElement('textarea'); if (typeof trigger === 'function') { input.addEventListener('change', trigger); } input.addEventListener('input', () => { - if (vals.__editing == null) { - vals.__editing = { + if (wrapper.__editing == null) { + wrapper.__editing = { [col.key]: true } } else { - vals.__editing[col.key] = true; + wrapper.__editing[col.key] = true; } }); return input; } - static setValue(element, val, _item, _col, grid) { + /** + * @ignore + * @param {HTMLElement} element + * @param {string} val + * @param {GridItemWrapper} _wrapper + * @param {GridColumnDefinition} _col + * @param {Grid} grid + */ + static setValue(element, val, _wrapper, _col, grid) { if (element.tagName !== 'TEXTAREA') { super.setValue(element, val); } else { @@ -217,31 +296,49 @@ const SymbolDropdown = Symbol.for('ui-dropdown'); /** * 下拉选择列 * @class + * @static * @extends GridColumn + * @hideconstructor */ export class GridDropdownColumn extends GridColumn { - static createEdit(trigger, col, container, it) { + /** + * @ignore + * @param {Function} trigger + * @param {GridColumnDefinition} col + * @param {HTMLElement} container + * @param {GridItemWrapper} wrapper + * @returns {HTMLElement} + */ + static createEdit(trigger, col, container, wrapper) { const drop = new Dropdown({ ...col.dropOptions, wrapper: container.parentElement }); drop.onSelected = trigger; drop.onExpanded = () => { - if (it.__editing == null) { - it.__editing = { + if (wrapper.__editing == null) { + wrapper.__editing = { [col.key]: true } } else { - it.__editing[col.key] = true; + wrapper.__editing[col.key] = true; } if (typeof col.onDropExpanded === 'function') { - col.onDropExpanded.call(col, it.values, drop); + col.onDropExpanded.call(col, wrapper.values, drop); } }; return drop.create(); } + /** + * @private + * @param {HTMLElement} element + * @returns {Dropdown} + */ static _getDrop(element) { + /** + * @type {Map} + */ const dropGlobal = global[SymbolDropdown]; if (dropGlobal == null) { return null; @@ -256,32 +353,39 @@ export class GridDropdownColumn extends GridColumn { /** * @private - * @param {Map} item + * @param {GridItemWrapper} wrapper * @param {GridColumnDefinition} col * @returns {GridSourceItem[]} */ - static _getSource(item, col) { + static _getSource(wrapper, col) { let source; if (col.sourceCache !== false) { - source = item.source?.[col.key]; + source = wrapper.source?.[col.key]; if (source != null) { return source; } } source = col.source; if (typeof source === 'function') { - source = source(item.values); + source = source(wrapper.values); } if (col.sourceCache !== false) { - if (item.source == null) { - item.source = { [col.key]: source }; + if (wrapper.source == null) { + wrapper.source = { [col.key]: source }; } else { - item.source[col.key] = source; + wrapper.source[col.key] = source; } } return source; } + /** + * @private + * @param {GridSourceItem[]} source + * @param {HTMLElement} element + * @param {any} val + * @param {DropdownOptions} opts + */ static _setValue(source, element, val, opts) { const data = source?.find(v => v[opts?.valueKey ?? 'value'] === val); if (data != null) { @@ -290,9 +394,16 @@ export class GridDropdownColumn extends GridColumn { super.setValue(element, val); } - static setValue(element, val, item, col) { + /** + * @ignore + * @param {HTMLElement} element + * @param {any} val + * @param {GridItemWrapper} wrapper + * @param {GridColumnDefinition} col + */ + static setValue(element, val, wrapper, col) { if (element.tagName !== 'DIV') { - let source = this._getSource(item, col); + let source = this._getSource(wrapper, col); if (source instanceof Promise) { source.then(s => this._setValue(s, element, val, col.dropOptions)); } else { @@ -305,7 +416,7 @@ export class GridDropdownColumn extends GridColumn { return; } if (drop.source == null || drop.source.length === 0) { - let source = this._getSource(item, col); + let source = this._getSource(wrapper, col); if (source instanceof Promise) { source.then(s => { drop.source = s; @@ -319,10 +430,21 @@ export class GridDropdownColumn extends GridColumn { drop.select(val, true); } + /** + * @ignore + * @param {GridSourceItem} e + * @param {GridColumnDefinition} col + * @returns {any} + */ static getValue(e, col) { return e[col.dropOptions?.valueKey ?? 'value']; } + /** + * @ignore + * @param {HTMLElement} element + * @param {string} name + */ static setClass(element, name) { if (element.tagName === 'DIV') { element.className = `ui-drop-wrapper ${name ?? ''}`; @@ -331,6 +453,11 @@ export class GridDropdownColumn extends GridColumn { } } + /** + * @ignore + * @param {HTMLElement} element + * @param {boolean} enabled + */ static setEnabled(element, enabled) { super.setEnabled(element, enabled); const drop = this._getDrop(element); @@ -340,6 +467,11 @@ export class GridDropdownColumn extends GridColumn { drop.disabled = enabled === false; } + /** + * @ignore + * @param {HTMLElement} element + * @param {HTMLElement} container + */ static leaveEdit(element, container) { container.parentElement.querySelectorAll('.ui-drop-box.active').forEach(e => { if (e != null) { @@ -356,7 +488,20 @@ export class GridDropdownColumn extends GridColumn { } } +/** + * 复选框列 + * @class + * @static + * @extends GridColumn + * @hideconstructor + * @ignore + */ export class GridCheckboxColumn extends GridColumn { + /** + * @ignore + * @param {Function} trigger + * @returns {HTMLElement} + */ static createEdit(trigger) { const check = createCheckbox({ onchange: typeof trigger === 'function' ? trigger : null @@ -364,12 +509,27 @@ export class GridCheckboxColumn extends GridColumn { return check; } + /** + * @ignore + * @param {HTMLElement} element + * @param {boolean} val + */ static setValue(element, val) { element.querySelector('input').checked = val; } + /** + * @ignore + * @param {Event} e + * @returns {boolean} + */ static getValue(e) { return e.target.checked } + /** + * @ignore + * @param {HTMLElement} element + * @param {string} name + */ static setClass(element, name) { if (element.tagName === 'LABEL') { element.className = `ui-check-wrapper ${name ?? ''}`; @@ -378,19 +538,43 @@ export class GridCheckboxColumn extends GridColumn { } } + /** + * @ignore + * @param {HTMLElement} element + * @param {boolean} enabled + */ static setEnabled(element, enabled) { super.setEnabled(element, enabled); element.querySelector('input').disabled = enabled === false; } } +/** + * 图标列 + * @class + * @static + * @extends GridColumn + * @hideconstructor + * @ignore + */ export class GridIconColumn extends GridColumn { + /** + * @ignore + * @returns {HTMLElement} + */ static create() { return createElement('span', 'col-icon') } - static setValue(element, val, item, col) { + /** + * @ignore + * @param {HTMLElement} element + * @param {string} val + * @param {GridItemWrapper} wrapper + * @param {GridColumnDefinition} col + */ + static setValue(element, val, wrapper, col) { // let className = col.iconClassName; // if (typeof className === 'function') { - // className = className.call(col, item.values); + // className = className.call(col, wrapper.values); // } // if (className == null) { // element.className = 'col-icon'; @@ -399,7 +583,7 @@ export class GridIconColumn extends GridColumn { // } let type = col.iconType; if (typeof type === 'function') { - type = type.call(col, item.values); + type = type.call(col, wrapper.values); } type ??= 'fa-light'; if (element.dataset.type !== type || element.dataset.icon !== val) { @@ -412,10 +596,20 @@ export class GridIconColumn extends GridColumn { } } + /** + * @ignore + * @param {HTMLElement} element + * @param {string} name + */ static setClass(element, name) { element.className = `col-icon ${name ?? ''}`; } + /** + * @ignore + * @param {HTMLElement} element + * @param {boolean} enabled + */ static setEnabled(element, enabled) { super.setEnabled(element, enabled); if (enabled === false) { @@ -426,41 +620,72 @@ export class GridIconColumn extends GridColumn { } } +/** + * 日期选择列 + * @class + * @static + * @extends GridColumn + * @hideconstructor + */ export class GridDateColumn extends GridColumn { static get editing() { return true }; - static createEdit(trigger, col, _container, vals) { + /** + * @ignore + * @param {Function} trigger + * @param {GridColumnDefinition} col + * @param {HTMLElement} _container + * @param {GridItemWrapper} wrapper + * @returns {HTMLElement} + */ + static createEdit(trigger, col, _container, wrapper) { let enabled = col.enabled; if (typeof enabled === 'string') { - enabled = vals.values[enabled]; + enabled = wrapper.values[enabled]; } else if (typeof enabled === 'function') { - enabled = col.enabled(vals.values); + enabled = col.enabled(wrapper.values); } if (enabled === false) { return super.create(); } const date = createDateInput(col.dateMin, col.dateMax); date.addEventListener('change', () => { - if (vals.__editing == null) { - vals.__editing = { + if (wrapper.__editing == null) { + wrapper.__editing = { [col.key]: true } } else { - vals.__editing[col.key] = true; + wrapper.__editing[col.key] = true; } }); date.addEventListener('blur', trigger); return date; } + /** + * @ignore + * @param {HTMLElement} element + * @param {(string | number | Date)} val + */ static setValue(element, val) { setDateValue(element, val); } + /** + * @ignore + * @param {Event} e + * @param {GridColumnDefinition} col + * @returns {string} + */ static getValue(e, col) { return getDateValue(e.target, col.dateValueFormatter); } + /** + * @ignore + * @param {HTMLElement} element + * @param {string} name + */ static setClass(element, name) { if (element.tagName === 'INPUT') { element.className = `ui-date-cell ${name ?? ''}`; @@ -469,10 +694,26 @@ export class GridDateColumn extends GridColumn { } } + /** + * @ignore + * @param {HTMLElement} element + * @param {boolean} enabled + */ static setEnabled(element, enabled) { element.disabled = enabled === false; } + /** + * 格式化日期字符串 + * @param {(string | number | Date)} date - 要格式化的日期值 + * + * 支持以下几种数据类型 + * * `"2024-01-26"` + * * `"1/26/2024"` + * * `"638418240000000000"` + * * `new Date('2024-01-26')` + * @returns {string} 格式化为 M/d/yyyy 的日期字符串 + */ static formatDate(date) { return formatDate(date); } diff --git a/lib/ui/grid/grid.js b/lib/ui/grid/grid.js index 7edb7e2..9be64b4 100644 --- a/lib/ui/grid/grid.js +++ b/lib/ui/grid/grid.js @@ -339,39 +339,39 @@ class GridColumnDefinition { /** * 列关键字，默认以该关键字从行数据中提取单元格值，行数据的关键字属性值里包含 DisplayValue 则优先显示此值 * @type {string} - * @private + * @ignore */ key; /** * 列的类型，可以为 {@linkcode GridColumn} 的子类，或者内置类型 {@linkcode Grid.ColumnTypes} * @type {(GridColumnTypeEnum | GridColumn)} * @default Grid.ColumnTypes.Common - * @private + * @ignore */ type; /** * 列标题文本 * @type {string} - * @private + * @ignore */ caption; /** * 列标题的元素样式 * @type {any} - * @private + * @ignore */ captionStyle; /** * 大于 0 则设置为该宽度，否则根据列内容自动调整列宽 * @type {number} - * @private + * @ignore */ width; /** * 列对齐方式 * @type {("left" |"center" | "right")} * @default "left" - * @private + * @ignore */ align; /** @@ -381,199 +381,199 @@ class GridColumnDefinition { * * `string` 则以该值为关键字从行数据中取值作为判断条件 * * `GridItemBooleanCallback` 则调用如下回调，以返回值作为判断条件 * @type {(boolean | string | GridItemBooleanCallback)} - * @private + * @ignore */ enabled; /** * 单元格取值采用该函数返回的值 * @type {GridItemFilterCallback} - * @private + * @ignore */ filter; /** * 单元格以该值填充内容，忽略filter与关键字属性 * @type {string} - * @private + * @ignore */ text; /** * 列是否可见 * @type {boolean} * @default true - * @private + * @ignore */ visible; /** * 列是否允许调整宽度 * @type {boolean} * @default true - * @private + * @ignore */ resizable; /** * 列是否允许排序 * @type {boolean} * @default true - * @private + * @ignore */ sortable; /** * 列是否允许重排顺序 * @type {boolean} * @default true - * @private + * @ignore */ orderable; /** * 列为复选框类型时是否在列头增加全选复选框 * @type {boolean} * @default false - * @private + * @ignore */ allcheck; /** * 列为收缩列，禁用自动调整大小 * @type {boolean} * @default false - * @private + * @ignore */ shrink; /** * 单元格元素的额外样式类型字符串（仅在重建行元素时读取） * @type {string} - * @private + * @ignore */ class; /** * 单元格css样式对象（仅在重建行元素时读取） * @type {any} - * @private + * @ignore */ css; /** * 合计行样式（仅在重建合计行元素时读取） * @type {any} - * @private + * @ignore */ totalCss; /** * 单元格样式（填充行列数据时读取），支持直接返回样式对象或调用函数返回（若赋值则忽略 [styleFilter]{@linkcode GridColumnDefinition#styleFilter}） * @type {(any | GridItemObjectCallback)} - * @private + * @ignore */ style; /** * **已过时**
_根据返回值填充单元格样式（填充行列数据时读取）_ * @type {GridItemObjectCallback} - * @private + * @ignore * @deprecated */ styleFilter; /** * 设置单元格背景色（填充行列数据时读取），支持直接设置颜色字符串或调用函数返回（若赋值则忽略 [bgFilter]{@linkcode GridColumnDefinition#bgFilter}） * @type {(string | GridItemStringCallback)} - * @private + * @ignore */ background; /** * **已过时**
_根据返回值设置单元格背景色_ * @type {GridItemStringCallback} - * @private + * @ignore * @deprecated */ bgFilter; /** * 给单元格元素附加事件（事件函数上下文为数据行对象） * @type {Map} - * @private + * @ignore */ events; /** * 根据返回值设置单元格元素的附加属性，允许直接设置对象也支持调用如下函数返回对象 * @type {(any | GridItemObjectCallback)} - * @private + * @ignore */ attrs; /** * 是否允许进行列头过滤 * @type {boolean} * @default false - * @private + * @ignore */ allowFilter; /** * 过滤值的数组 * @type {any[]} - * @private + * @ignore */ filterValues; /** * 是否区分 `null` 与空字符串 * @type {boolean} * @default false - * @private + * @ignore */ filterAllowNull; /** * 自定义列过滤器的数据源，允许调用如下函数 * @type {(ValueItem[] | GridColumnFilterSourceCallback)} - * @private + * @ignore */ filterSource; /** * 自定义列排序函数 * @type {GridItemSortCallback} - * @private + * @ignore */ sortFilter; /** * 列为下拉列表类型时以该值设置下拉框的参数 * @type {DropdownOptions} - * @private + * @ignore */ dropOptions; /** * 列为下拉列表类型时以该值设置下拉列表数据源，支持返回异步对象，也支持如下函数返回 * @type {(GridSourceItem[] | Promise | GridDropdownSourceCallback)} - * @private + * @ignore */ source; /** * 下拉列表数据源是否缓存结果（即行数据未发生变化时仅从source属性获取一次值） * @type {boolean} * @default false - * @private + * @ignore */ sourceCache; /** * 列为图标类型时以该值设置图标样式 * @type {("fa-light" | "fa-regular" | "fa-solid")} * @default "fa-light" - * @private + * @ignore */ iconType; /** * 列为日期类型时以该值作为最小可选日期值 * @type {string} - * @private + * @ignore */ dateMin; /** * 列为日期类型时以该值作为最大可选日期值 * @type {string} - * @private + * @ignore */ dateMax; /** * 列为日期类型时自定义日期格式化函数 * @type {DateFormatterCallback} - * @private + * @ignore */ dateValueFormatter; /** * 额外设置单元格的 tooltip，支持直接使用字符串或者调用如下函数 * @type {(string | GridItemStringCallback)} - * @private + * @ignore */ tooltip; /** @@ -622,7 +622,7 @@ class GridColumnDefinition { * 列为下拉框类型时在下拉列表展开时触发的事件 * @event * @param {Map} item - 行数据对象 - * @param {Dropdown} drop - 拉框对象 + * @param {Dropdown} drop - 下拉框对象 * @this GridColumnDefinition */ onDropExpanded; @@ -736,6 +736,7 @@ const GridColumnDirection = { * @property {string} [langs.duplicatePrompt={column} is being sorted more than once...] * @property {number} [virtualCount=100] - 行数大于等于该值则启用虚模式 * @property {number} [rowHeight=36] - 表格行高 + * @property {number} [lineHeight=24] - 文本行高（多行文本列计算高度时使用） * @property {string} [filterIcon=filter] - 列头过滤图标，旧版本样式（横着三个点）需修改为 `"ellipsis-h"` * @property {number} [extraRows=0] - 列表底部留出额外的空白行 * @property {number} [filterRowHeight=30] - 过滤条件列表的行高 @@ -1023,108 +1024,108 @@ export class Grid { /** * 列定义的数组 * @type {GridColumnDefinition[]} - * @private + * @ignore */ columns = []; /** * 合计行数据 * @type {Map} - * @private + * @ignore */ total = null; /** * 多语言资源对象 - * @private + * @ignore */ langs = { /** * @type {string} * @default "( All )" - * @private + * @ignore */ all: null, /** * @type {string} * @default "OK" - * @private + * @ignore */ ok: null, /** * @type {string} * @default "Reset" - * @private + * @ignore */ reset: null, /** * @type {string} * @default "Cancel" - * @private + * @ignore */ cancel: null, /** * @type {string} * @default "( Null )" - * @private + * @ignore */ null: null, /** * @type {string} * @default "Add Level" - * @private + * @ignore */ addLevel: null, /** * @type {string} * @default "Delete Level" - * @private + * @ignore */ deleteLevel: null, /** * @type {string} * @default "Copy Level" - * @private + * @ignore */ copyLevel: null, /** * @type {string} * @default "Ascending" - * @private + * @ignore */ asc: null, /** * @type {string} * @default "Descending" - * @private + * @ignore */ desc: null, /** * @type {string} * @default "Column" - * @private + * @ignore */ column: null, /** * @type {string} * @default "Order" - * @private + * @ignore */ order: null, /** * @type {string} * @default "Sort" - * @private + * @ignore */ sort: null, /** * @type {string} * @default "All sort criteria must have a column specified. Check the selected sort criteria and try again." - * @private + * @ignore */ requirePrompt: null, /** * @type {string} * @default "{column} is being sorted more than once. Delete the duplicate sort criteria and try again." - * @private + * @ignore */ duplicatePrompt: null }; @@ -1132,110 +1133,117 @@ export class Grid { * 行数大于等于该值则启用虚模式 * @type {number} * @default 100 - * @private + * @ignore */ virtualCount = 100; /** * 表格行高 * @type {number} * @default 36 - * @private + * @ignore */ rowHeight = 36; + /** + * 文本行高（多行文本列计算高度时使用） + * @type {number} + * @default 24 + * @ignore + */ + lineHeight = 24; /** * 列头过滤图标，旧版本样式（横着三个点）需修改为 `ellipsis-h` * @type {string} * @default "filter" - * @private + * @ignore */ filterIcon = 'filter'; /** * 列表底部留出额外的空白行 * @type {number} * @default 0 - * @private + * @ignore */ extraRows = 0; /** * 过滤条件列表的行高 * @type {number} * @default 30 - * @private + * @ignore */ filterRowHeight = 30; /** * 列表高度值，为 0 时列表始终显示全部内容（自增高），为非数字或者小于 0 则根据容器高度来确定虚模式的渲染行数 * @type {number | null} - * @private + * @ignore */ height; /** * 是否允许多选 * @type {boolean} * @default false - * @private + * @ignore */ multiSelect = false; /** * 为 `false` 时只有点击在单元格内才会选中行 * @type {boolean} * @default true - * @private + * @ignore */ fullrowClick = true; /** * 单元格 tooltip 是否禁用 * @type {boolean} * @default false - * @private + * @ignore */ tooltipDisabled = false; /** * 列头是否显示 * @type {boolean} * @default true - * @private + * @ignore */ headerVisible = true; /** * 监听事件的窗口载体 * @type {(Window | HTMLElement)} * @default window - * @private + * @ignore */ window; /** * 排序列的索引 * @type {number} * @default -1 - * @private + * @ignore */ sortIndex = -1; /** * 排序方式，正数升序，负数倒序 * @type {GridColumnDirection} * @default GridColumnDirection.Ascending - * @private + * @ignore */ sortDirection = GridColumnDirection.Ascending; /** * 排序列数组 * @type {GridColumnSortDefinition[]} * @default null - * @private + * @ignore */ sortArray = null; /** * 是否支持点击扩展 * @type {boolean} * @default false - * @private + * @ignore */ expandable; /** * 扩展行生成器 * @type {GridExpandableObjectCallback} - * @private + * @ignore */ expandableGenerator;