需求描述#

Obsidian Bases 可以通过 Sort 设置卡片的查询顺序，但原生 Card 视图不能通过拖动任意调整卡片顺序。

Kanban Bases View 支持拖动卡片，但该顺序无法存储在显式属性或被其他视图复用。

本次开发的目标是在保留原有隐式排序方式的基础上，新增一个可选的 Card order 属性：用户需要可见序号时，将拖动结果写入笔记；不配置该属性时，继续使用原有的隐式配置，不增加笔记字段。

功能设计#

新增可选的 Card order 属性#

在视图设置中新增一个可选属性。未选择时维持原有的 cardOrders 隐式存储；选择后，该属性成为卡片顺序的读取和写入位置。两种模式之间不迁移或清理数据。

1
private cardOrderPropertyId: BasesPropertyId | null = null;
2

3
private loadConfig(): void {
4
  this.cardOrderPropertyId = this.config.getAsPropertyId('cardOrderProperty');
5
}
6

7
{
8
  displayName: 'Card order',
9
  type: 'property',
10
  key: 'cardOrderProperty',
11
  filter: (prop: string) => prop.startsWith('note.'),
12
  placeholder: 'Optional: card order property',
13
}

校验显式属性#

Card order 必须是可写的 note.* 属性，并且不能与 Group by 或 Swimlane by 使用同一属性。否则重新编号可能改变卡片所属的列或泳道，插件会停止渲染并显示配置错误。

1
if (
2
  this.cardOrderPropertyId &&
3
  (!this.cardOrderPropertyId.startsWith('note.') ||
4
    this.cardOrderPropertyId === this.groupByPropertyId ||
5
    this.cardOrderPropertyId === this.swimlaneByPropertyId)
6
) {
7
  this.fullReset();
8
  this.containerEl.createDiv({
9
    text: EMPTY_STATE_MESSAGES.CARD_ORDER_PROPERTY_INVALID,
10
    cls: CSS_CLASSES.EMPTY_STATE,
11
  });
12
  return;
13
}

按显式序号排列卡片#

显式属性接受有限数字和可转换为有限数字的字符串，按数值升序排列。空值和非法值没有显式顺序，统一放在已有序号之后。

1
export function readCardOrderValue(value: unknown): number | null {
2
  if (typeof value === 'number') return Number.isFinite(value) ? value : null;
3
  if (typeof value !== 'string') return null;
4
  const trimmed = value.trim();
5
  if (trimmed === '') return null;
6
  const numeric = Number(trimmed);
7
  return Number.isFinite(numeric) ? numeric : null;
8
}
9

10
export function compareCardOrderValues(a: number | null, b: number | null): number {
11
  if (a === null) return b === null ? 0 : 1;
12
  if (b === null) return -1;
13
  return a - b;
14
}

每个列或“泳道 + 列”单元格分别调用该比较逻辑：

1
private sortCardEntriesByOrderProperty(entries: BasesEntry[]): BasesEntry[] {
2
  if (!this.cardOrderPropertyId) return entries;
3
  return [...entries].sort((a, b) =>
4
    compareCardOrderValues(
5
      readCardOrderValue(a.getValue(this.cardOrderPropertyId)?.toString()),
6
      readCardOrderValue(b.getValue(this.cardOrderPropertyId)?.toString()),
7
    ),
8
  );
9
}

拖动后写回显式序号#

同列拖动后，显式模式不再写入 cardOrders ，而是按照当前 DOM 顺序更新选定属性。

1
const paths = getColumnPaths(evt.to);
2
if (this.cardOrderPropertyId) {
3
  await this.writeVisibleCardOrder(paths);
4
} else {
5
  this._prefs.cardOrders[newKey] = paths;
6
  this._persistPrefs();
7
}

写回值使用从 1 开始的连续整数。已有值正确时不重复修改； skipPath 用于跳过已经与分组属性一起写入的跨列移动卡片。

1
private async writeVisibleCardOrder(paths: string[], skipPath?: string): Promise<void> {
2
  const propertyId = this.cardOrderPropertyId;
3
  if (!propertyId) return;
4
  if (!propertyId.startsWith('note.')) {
5
    throw new Error(`Card order property must be a writable note property: ${propertyId}`);
6
  }
7
  if (!this.app?.fileManager) {
8
    throw new Error('File manager not available');
9
  }
10

11
  const propertyName = parsePropertyId(propertyId).name;
12
  const updates = paths.flatMap((path, index) => {
13
    if (path === skipPath) return [];
14
    const entry = this._entryMap.get(path);
15
    if (!entry) throw new Error(`Entry not found for card order: ${path}`);
16
    const order = index + 1;
17
    if (readCardOrderValue(entry.getValue(propertyId)?.toString()) === order) return [];
18
    return [
19
      this.app.fileManager.processFrontMatter(entry.file, (frontmatter: Record<string, unknown>) => {
20
        frontmatter[propertyName] = order;
21
      }),
22
    ];
23
  });
24
  await Promise.all(updates);
25
}

跨列拖动新增两步处理：先将移动卡片的新分组值和目标序号写入同一次 frontmatter 更新，再重新编号来源单元格和目标单元格。

1
const cardOrderPropertyName = this.cardOrderPropertyId
2
  ? parsePropertyId(this.cardOrderPropertyId).name
3
  : null;
4
const cardOrder = newPaths.indexOf(entryPath) + 1;
5

6
if (cardOrderPropertyName) frontmatter[cardOrderPropertyName] = cardOrder;
7

8
if (this.cardOrderPropertyId) {
9
  await Promise.all([
10
    this.writeVisibleCardOrder(oldPaths),
11
    this.writeVisibleCardOrder(newPaths, entryPath),
12
  ]);
13
}

允许 Base Sort 下保存拖动顺序#

原实现检测到 Base Sort 后会取消同列拖动，并用 Notice 提示用户清除 Sort。本次移除了 sortActive 、 hasActiveSort() 和该提示。现在显式属性始终决定卡片顺序；未配置显式属性时，已有的隐式拖动顺序也不再被 Base Sort 跳过。

Obsidian Kanban Bases View 卡片排序功能开发