标签分组与侧边栏筛选实现

举报
yd_284811271 发表于 2026/11/18 17:17:09 2026/11/18
【摘要】 前言笔记类应用里,标签是很常用的信息归类手段。本篇我们基于ArkTS,实现侧边标签栏、笔记绑定标签、按标签筛选笔记,同时支持标签新增、删除,联动列表刷新,适配HarmonyOS NEXT的声明式UI与状态管理。 效果预览左侧侧边栏展示全部标签,包含「全部笔记」默认选项点击标签,主列表自动过滤出对应标签的笔记新建/编辑笔记时,可多选标签绑定新增、删除标签实时同步,状态自动响应侧边栏支持收起,...

前言

笔记类应用里,标签是很常用的信息归类手段。本篇我们基于ArkTS,实现侧边标签栏、笔记绑定标签、按标签筛选笔记,同时支持标签新增、删除,联动列表刷新,适配HarmonyOS NEXT的声明式UI与状态管理。

效果预览

  1. 左侧侧边栏展示全部标签,包含「全部笔记」默认选项
  2. 点击标签,主列表自动过滤出对应标签的笔记
  3. 新建/编辑笔记时,可多选标签绑定
  4. 新增、删除标签实时同步,状态自动响应
  5. 侧边栏支持收起,适配手机小屏

技术选型

  • 状态管理:@State / @Watch / @StorageLink
  • 数据库:RDB(标签表、笔记-标签关联表,多对多)
  • UI组件:SideBarContainer、List、Checkbox、TextInput
  • 渲染:LazyForEach 懒加载标签与笔记列表

数据模型设计

标签实体 Tag.ets

export class Tag {
  id: number;
  name: string;
  color: string; // 标签配色,用于UI展示
  createTime: number;

  constructor(id: number, name: string, color: string, createTime: number) {
    this.id = id;
    this.name = name;
    this.color = color;
    this.createTime = createTime;
  }
}

笔记标签关联表(多对多):一条笔记可以绑定多个标签,一个标签可以对应多条笔记。字段:id, noteId, tagId。

核心代码实现

1. 标签管理工具类(RDB增删查)

import { relationalStore } from '@kit.RelationalStoreKit';
import { Tag } from '../model/Tag';

export class TagManager {
  static STORE_NAME = 'note_store.db';
  static TAG_TABLE = 'tag';
  static NOTE_TAG_TABLE = 'note_tag_rel';
  private rdbStore: relationalStore.RdbStore | null = null;

  async init(store: relationalStore.RdbStore) {
    this.rdbStore = store;
  }

  // 查询所有标签
  async getAllTags(): Promise<Tag[]> {
    if (!this.rdbStore) return [];
    const result = await this.rdbStore.querySql(`SELECT * FROM ${TagManager.TAG_TABLE} ORDER BY createTime DESC`);
    const tags: Tag[] = [];
    for (let i = 0; i < result.rowCount; i++) {
      const row = result.getRow(i);
      tags.push(new Tag(
        row.getLong(0),
        row.getString(1),
        row.getString(2),
        row.getLong(3)
      ));
    }
    return tags;
  }

  // 添加标签
  async addTag(name: string, color: string): Promise<number> {
    if (!this.rdbStore) return -1;
    const values = new relationalStore.ValuesBucket();
    values.put('name', name);
    values.put('color', color);
    values.put('createTime', Date.now());
    return await this.rdbStore.insert(TagManager.TAG_TABLE, values);
  }

  // 删除标签,同时清除关联关系
  async deleteTag(tagId: number): Promise<void> {
    if (!this.rdbStore) return;
    await this.rdbStore.executeSql(`DELETE FROM ${TagManager.TAG_TABLE} WHERE id = ?`, [tagId]);
    await this.rdbStore.executeSql(`DELETE FROM ${TagManager.NOTE_TAG_TABLE} WHERE tagId = ?`, [tagId]);
  }

  // 根据标签id查询对应的笔记id
  async getNoteIdsByTag(tagId: number): Promise<number[]> {
    if (!this.rdbStore) return [];
    const res = await this.rdbStore.querySql(`SELECT noteId FROM ${TagManager.NOTE_TAG_TABLE} WHERE tagId = ?`, [tagId]);
    const ids: number[] = [];
    for (let i = 0; i < res.rowCount; i++) {
      ids.push(res.getRow(i).getLong(0));
    }
    return ids;
  }
}

2. 侧边栏+标签筛选页面

import { Tag } from '../model/Tag';
import { TagManager } from '../manager/TagManager';
import { NoteManager } from '../manager/NoteManager';

@Entry
@Component
struct NoteTagPage {
  @State tagList: Tag[] = [];
  @State selectTagId: number | null = null; // null代表全部笔记
  @State noteList: Note[] = [];
  @State newTagName: string = '';
  @State sidebarShow: boolean = true;
  private tagMgr: TagManager = new TagManager();
  private noteMgr: NoteManager = new NoteManager();

  aboutToAppear() {
    this.loadData();
  }

  async loadData() {
    this.tagList = await this.tagMgr.getAllTags();
    await this.loadNoteByTag(this.selectTagId);
  }

  async loadNoteByTag(tagId: number | null) {
    if (tagId === null) {
      this.noteList = await this.noteMgr.getAllNotes();
    } else {
      const noteIds = await this.tagMgr.getNoteIdsByTag(tagId);
      this.noteList = await this.noteMgr.getNotesByIds(noteIds);
    }
  }

  async onAddTag() {
    if (this.newTagName.trim().length === 0) return;
    // 随机标签色
    const colorArr = ['#409EFF', '#67C23A', '#E6A23C', '#F56C6C'];
    const randomColor = colorArr[Math.floor(Math.random() * colorArr.length)];
    await this.tagMgr.addTag(this.newTagName.trim(), randomColor);
    this.newTagName = '';
    await this.loadData();
  }

  async onTagClick(tagId: number | null) {
    this.selectTagId = tagId;
    await this.loadNoteByTag(tagId);
  }

  async onDeleteTag(tagId: number) {
    await this.tagMgr.deleteTag(tagId);
    // 如果当前选中标签被删除,切回全部
    if (this.selectTagId === tagId) {
      this.selectTagId = null;
    }
    await this.loadData();
  }

  build() {
    SideBarContainer(SideBarContainerType.Embed) {
      // 侧边栏:标签列表
      Column() {
        TextInput({ text: this.newTagName, placeholder: "新建标签" })
          .onChange(v => this.newTagName = v)
          .margin(10)
        Button("添加标签")
          .width('90%')
          .onClick(() => this.onAddTag())
          .margin({ bottom: 12 })

        List() {
          ListItem() {
            Row() {
              Text("全部笔记")
            }
            .width('100%')
            .padding(12)
            .backgroundColor(this.selectTagId === null ? '#e8f4ff' : '#ffffff')
            .onClick(() => this.onTagClick(null))
          }
          LazyForEach(this.tagList, (tag: Tag) => {
            ListItem() {
              Row() {
                Circle().width(12).height(12).fill(tag.color).margin({ right: 8 })
                Text(tag.name).layoutWeight(1)
                Button("删除", { type: ButtonType.Normal, stateEffect: false })
                  .fontSize(12)
                  .fontColor('#f56c6c')
                  .backgroundColor(Color.Transparent)
                  .onClick(() => this.onDeleteTag(tag.id))
              }
              .width('100%')
              .padding(12)
              .backgroundColor(this.selectTagId === tag.id ? '#e8f4ff' : '#ffffff')
            }
            .onClick(() => this.onTagClick(tag.id))
          }, (tag: Tag) => tag.id.toString())
        }
        .layoutWeight(1)
      }
      .width(220)
      .backgroundColor('#f7f8fa')

      // 主区域:笔记列表
      Column() {
        List() {
          LazyForEach(this.noteList, (note: Note) => {
            ListItem() {
              NoteCard({ note: note })
            }
          }, (note: Note) => note.id.toString())
        }
        .layoutWeight(1)
      }
    }
    .showSideBar(this.sidebarShow)
    .sideBarWidth(220)
    .controlButton({
      left: 10,
      top: 10
    })
  }
}

3. 编辑笔记时标签多选组件

@Component
struct TagSelectPanel {
  @Link selectedTagIds: number[]
  @State tagList: Tag[] = []
  private tagMgr: TagManager = new TagManager()

  aboutToAppear() {
    this.tagMgr.getAllTags().then(res => this.tagList = res)
  }

  build() {
    Flex({ wrap: FlexWrap.Wrap }) {
      ForEach(this.tagList, (tag: Tag) => {
        Row() {
          Checkbox()
            .select(this.selectedTagIds.includes(tag.id))
            .onChange(checked => {
              if (checked) {
                this.selectedTagIds.push(tag.id)
              } else {
                const idx = this.selectedTagIds.indexOf(tag.id)
                if (idx > -1) this.selectedTagIds.splice(idx, 1)
              }
            })
          Text(tag.name).margin({ left: 4 })
        }
        .padding(6)
        .margin(4)
      })
    }
  }
}

关键问题与优化点

  1. 多对多关联查询性能
    笔记数量很多时,联表查询会变慢。优化方案:缓存标签-笔记映射关系,在内存维护Map,只在标签/笔记变更时刷新缓存。
  2. 标签重名校验
    当前代码没有校验同名标签,添加标签前增加SQL查询判断是否存在同名。
  3. 侧边栏适配折叠屏
    SideBarContainer 可以根据窗口宽度自动切换Overlay/Embed模式,大屏常驻侧边栏,小屏悬浮侧边栏。
  4. 标签排序
    可以增加置顶、自定义排序字段,替换默认按创建时间排序。
  5. 删除保护
    删除标签前增加弹窗确认,避免误删。

后续扩展方向

  • 标签拖拽排序
  • 标签颜色自定义选择器
  • 标签批量导入导出
  • 标签和笔记搜索组合筛选
【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。