场景一:
可结合自定义直尺线类RulerLine用以实现刻度尺的效果,具体步骤如下:
完整代码如下:
import { display, window } from '@kit.ArkUI';
@Entry
@Component
struct RulerComponent {
@State cellWidthInPixels: number = 0; // 屏幕上1mm对应的像素值px
textWidth: number = 80; // 文本的宽度px
@State rulerLines: RulerLine[] = []; // 尺子每个刻度的索引对应的高度
aboutToAppear(): void {
window.getLastWindow(this.getUIContext()?.getHostContext()).then((windowClass) => {
windowClass.setPreferredOrientation(window.Orientation.LANDSCAPE);
});
this.cellWidthInPixels = display.getDefaultDisplaySync().yDPI / 25.4; // 计算当前屏幕上每毫米对应的像素值px
for (let i = 0; i <= 15 * 10; i++) {
let lineHeight: number = (i % 10 === 0) ? 90 : (i % 5 === 0) ? 60 : 45;
this.rulerLines.push(new RulerLine(i, lineHeight)); // 初始化直尺每个刻度高
}
}
build() {
Column() {
Stack() {
// 遍历直尺线数组
ForEach(this.rulerLines, (line: RulerLine, index: number) => {
// 生成直尺的刻度
Line()
.width(1)
.height(`${line.height}px`)
.backgroundColor(Color.Black)
.margin({ left: `${this.cellWidthInPixels * index}px` })
.stroke(Color.Black);
// 生成刻度值数字
Text(line.showNumber())
.fontColor(Color.Black)
.fontSize(18)
.width(`${this.textWidth}px`)
.height(`${this.textWidth}px`)
.textAlign(TextAlign.Center)
.margin({
left: `${this.cellWidthInPixels * index - this.textWidth / 2}px`,
top: `${line.height}px`
});
});
}
.width('100%')
.height('30%')
.align(Alignment.TopStart);
}
.height('100%')
.width('100%')
.padding({ left: 30, right: 10 });
}
}
// 直尺线类
class RulerLine {
index: number; // 刻度索引
height: number; // 当前刻度的高度
constructor(index: number, height: number) {
this.index = index;
this.height = height;
}
// 10的倍数展示刻度值
showNumber(): string {
return this.index % 10 === 0 ? `${this.index / 10}` : '';
}
} 场景二:
使用横向List实现一个可滚动的刻度尺,通过滚动偏移计算当前值并传递给回调函数。
代码实现如下:
@ComponentV2
export struct RulerComponent {
@Param value: number = 0;
@Param min: number = 0;
@Param max: number = 60;
private itemWidth: number = 20; // 每个刻度的宽度
private scroller: Scroller = new Scroller();
@Local isTouching: boolean = false;
@Event onValueChange?: (value: number) => void;
arr: Array<number> = [];
aboutToAppear() {
// 延迟滚动到初始位置
setTimeout(() => {
let offset = this.value * this.itemWidth + Math.floor(this.itemWidth / 2);
console.info(`start offset: ${offset}`);
this.scroller.scrollTo({ xOffset: offset, yOffset: 0, animation: { duration: 200 } });
}, 100);
for (let index = 0; index < this.max + 1; index++) {
this.arr.push(index);
}
}
build() {
RelativeContainer() {
// 刻度列表
List({ scroller: this.scroller }) {
// 头部占位,使0刻度能居中
ListItem()
.width('50%')
.height(60);
ForEach(this.arr, (index: number) => {
ListItem() {
Column() {
// 刻度线
if (index % 10 === 0) {
// 长刻度
Column()
.width(2)
.height(30)
.backgroundColor('#333333');
// 刻度值
Text(index.toString())
.fontSize(12)
.fontColor('#333333')
.margin({ top: 8 });
} else if (index % 5 === 0) {
// 中刻度
Column()
.width(1.5)
.height(20)
.backgroundColor('#666666');
} else {
// 短刻度
Column()
.width(1)
.height(12)
.backgroundColor('#999999');
}
}
.width(this.itemWidth)
.height(60)
.justifyContent(FlexAlign.Start)
.alignItems(HorizontalAlign.Center);
}
})
// 尾部占位,使最大刻度能居中
ListItem()
.width('50%')
.height(60);
}
.listDirection(Axis.Horizontal)
.edgeEffect(EdgeEffect.None)
.scrollBar(BarState.Off)
.width('100%')
.height(80)
.onDidScroll(() => {
const x = this.scroller.currentOffset().xOffset;
let newValue = Math.floor(x / this.itemWidth);
if (newValue < this.min) {
newValue = this.min;
}
if (newValue > this.max) {
newValue = this.max;
}
this.onValueChange?.(newValue);
})
.onTouch((event: TouchEvent) => {
if (event.type === TouchType.Down) {
this.isTouching = true;
} else if (event.type === TouchType.Up) {
this.isTouching = false;
// 手指抬起时吸附到最近的刻度
const x = this.scroller.currentOffset().xOffset;
const targetValue = Math.round(x / this.itemWidth);
// 让刻度居中
let offSet = (targetValue * this.itemWidth) + Math.floor(this.itemWidth / 2);
this.scroller.scrollTo({
xOffset: offSet,
yOffset: 0,
animation: { duration: 200, curve: Curve.EaseOut }
});
}
})
.alignRules({
bottom: { anchor: '__container__', align: VerticalAlign.Bottom },
middle: { anchor: '__container__', align: HorizontalAlign.Center }
});
// 中间指示器
Column() {
Column()
.width(2)
.height(30)
.backgroundColor(Color.Yellow)
.margin({ top: 20 });
}
.alignRules({
top: { anchor: '__container__', align: VerticalAlign.Top },
middle: { anchor: '__container__', align: HorizontalAlign.Center }
});
}
.width('100%')
.height(100);
}
}
@Entry
@Component
struct Index {
@State value: number = 0;
build() {
Column() {
Text(`${this.value}`)
.fontSize(20)
.margin({ top: 50 });
RulerComponent({
min: 0,
max: 90,
value: this.value,
onValueChange: (v: number) => {
this.value = v;
}
})
.width('100%')
.margin({ top: 10 });
}.width('100%')
.height('100%')
}
}