概述
本 Demo 展示了如何在单元格中配置滑动条下拉菜单,演示了四种不同的滑动条配置:水平数值滑动条、垂直温度滑动条、水平数值范围滑动条和垂直数值范围滑动条。
实现思路
创建滑动条样式生成函数 createSliderStyle,统一处理 cellButtons 和 dropDowns 配置
为每种滑动条配置不同的选项:刻度标记、步长、方向、格式字符串等
通过 sheet.setStyle() 将样式应用到目标单元格
为数值范围滑动条配置 formatter 公式和辅助显示单元格
使用 commandManager().execute() 自动打开第一个滑动条
代码解析
创建滑动条样式
这个辅助函数封装了滑动条样式的创建逻辑。cellButtons 配置下拉按钮的外观和行为,dropDowns 定义滑动条的类型和选项。
配置水平数值滑动条
设置刻度标记 [0, 50, 100],步长为 10,方向为水平。用户拖动滑块时,数值将以 10 为单位变化。
配置垂直温度滑动条
自定义数值范围为 32-45,使用 formatString 显示温度单位,垂直方向展示。
配置数值范围滑动条
通过 showNumberRange: true 启用范围选择模式,单元格值变为包含 start 和 end 属性的对象。formatter 公式用于格式化显示范围值。
运行效果
表格加载后,第一个滑动条(水平数值滑动条)自动打开
点击单元格右侧的下拉按钮可打开对应的滑动条
拖动滑块可以选择数值,数值会显示在单元格中
数值范围滑动条可以选择一个数值区间,并在相邻单元格中显示起始值和结束值
所有滑动条都支持刻度标记和步长配置
API 参考
Style.dropDowns
配置单元格的下拉菜单类型和选项。
SliderOptions 配置项
direction: 滑块方向,支持 "horizontal" 或 "vertical"
min、max: 数值范围,默认为 0 和 100
step: 步长,必须大于 0 且能被 (max - min) 整除
marks: 刻度标记数组,如 [0, 50, 100]
formatString: 显示格式字符串,如 "0°C"
showNumberRange: 是否启用范围选择模式,默认为 false
width、height: 滑动条尺寸,默认 350
tooltipVisible: 是否始终显示提示框,默认为 false
openSlider 命令
通过代码打开指定单元格的滑动条,无需用户点击下拉按钮。
var spreadNS = GC.Spread.Sheets;
window.onload = function () {
var spread = new GC.Spread.Sheets.Workbook(document.getElementById("ss"));
initSpread(spread);
};
function createSliderStyle(option) {
let sliderStyle = new GC.Spread.Sheets.Style();
sliderStyle.cellButtons = [{
imageType: GC.Spread.Sheets.ButtonImageType.dropdown,
command: "openSlider",
useButtonStyle: true
}];
sliderStyle.dropDowns = [{
type: GC.Spread.Sheets.DropDownType.slider,
option: option
}];
return sliderStyle
}
function initSpread(spread) {
var sheet = spread.getSheet(0);
sheet.suspendPaint();
sheet.setText(2, 7, "Horizontal Number Slider");
sheet.setStyle(3, 7, createSliderStyle({
marks: [0,50,100],
step: 10,
direction: GC.Spread.Sheets.LayoutDirection.horizontal,
}));
sheet.setText(2, 12, "Vertical Temperature Slider");
sheet.setStyle(3, 12, createSliderStyle({
max: 45,
min: 32,
marks: ["36"],
step: 1,
direction: GC.Spread.Sheets.LayoutDirection.vertical,
formatString: "0°C"
}));
sheet.setText(14, 7, "Horizontal Number Range Slider");
sheet.setText(16, 6, "Start Number:");
sheet.setFormula(16, 7, '=IF(ISBLANK(H16), "", H16.start');
sheet.setText(17, 6, "End Number:");
sheet.setFormula(17, 7, '=IF(ISBLANK(H16), "", H16.end');
sheet.setColumnWidth(6,150);
let rangeSliderStyle1 = createSliderStyle({
marks: [0, 50, 100],
step: 10,
direction: GC.Spread.Sheets.LayoutDirection.horizontal,
showNumberRange: true
});
rangeSliderStyle1.formatter = '=IF(ISBLANK(@), "", @.start&"~"&@.end)';
sheet.setStyle(15, 7, rangeSliderStyle1);
sheet.setText(14, 12, "Vertical Number Range Slider");
sheet.setText(16, 11, "Start Number:");
sheet.setFormula(16, 12, '=IF(ISBLANK(M16), "", M16.start');
sheet.setText(17, 11, "End Number:");
sheet.setFormula(17, 12, '=IF(ISBLANK(M16), "", M16.end');
sheet.setColumnWidth(11,150);
let rangeSliderStyle2 = createSliderStyle({
marks: [0, 50, 100],
step: 1,
direction: GC.Spread.Sheets.LayoutDirection.vertical,
showNumberRange: true
});
rangeSliderStyle2.formatter = '=IFERROR(@.start, 0)&"-"&IFERROR(@.end, 0)';
sheet.setStyle(15, 12, rangeSliderStyle2);
sheet.resumePaint();
spread.commandManager().execute({cmd:"openSlider",row:3,col:7,sheetName:"Sheet1"});
// spread.commandManager().execute({cmd:"openSlider",row:3,col:12,sheetName:"Sheet1"});
}
<!doctype html>
<html style="height:100%;font-size:14px;">
<head>
<meta name="spreadjs culture" content="zh-cn" />
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<link rel="stylesheet" type="text/css"
href="$DEMOROOT$/zh/purejs/node_modules/@grapecity-software/spread-sheets/styles/gc.spread.sheets.excel2013white.css">
<script src="$DEMOROOT$/zh/purejs/node_modules/@grapecity-software/spread-sheets/dist/gc.spread.sheets.all.min.js"
type="text/javascript"></script>
<script
src="$DEMOROOT$/zh/purejs/node_modules/@grapecity-software/spread-sheets-resources-zh/dist/gc.spread.sheets.resources.zh.min.js"
type="text/javascript"></script>
<script src="$DEMOROOT$/spread/source/js/license.js" type="text/javascript"></script>
<script src="app.js" type="text/javascript"></script>
<link rel="stylesheet" type="text/css" href="styles.css">
</head>
<body>
<div class="sample-tutorial">
<div id="ss" style="width:100%; height: 100%"></div>
</div>
</body>
</html>
.sample-tutorial {
position: relative;
height: 100%;
overflow: hidden;
}
body {
position: absolute;
top: 0;
bottom: 0;
left: 0;
right: 0;
}
