标签分组与侧边栏筛选实现
【摘要】 前言笔记类应用里,标签是很常用的信息归类手段。本篇我们基于ArkTS,实现侧边标签栏、笔记绑定标签、按标签筛选笔记,同时支持标签新增、删除,联动列表刷新,适配HarmonyOS NEXT的声明式UI与状态管理。 效果预览左侧侧边栏展示全部标签,包含「全部笔记」默认选项点击标签,主列表自动过滤出对应标签的笔记新建/编辑笔记时,可多选标签绑定新增、删除标签实时同步,状态自动响应侧边栏支持收起,...
前言
笔记类应用里,标签是很常用的信息归类手段。本篇我们基于ArkTS,实现侧边标签栏、笔记绑定标签、按标签筛选笔记,同时支持标签新增、删除,联动列表刷新,适配HarmonyOS NEXT的声明式UI与状态管理。
效果预览
- 左侧侧边栏展示全部标签,包含「全部笔记」默认选项
- 点击标签,主列表自动过滤出对应标签的笔记
- 新建/编辑笔记时,可多选标签绑定
- 新增、删除标签实时同步,状态自动响应
- 侧边栏支持收起,适配手机小屏
技术选型
- 状态管理:
@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)
})
}
}
}
关键问题与优化点
- 多对多关联查询性能
笔记数量很多时,联表查询会变慢。优化方案:缓存标签-笔记映射关系,在内存维护Map,只在标签/笔记变更时刷新缓存。 - 标签重名校验
当前代码没有校验同名标签,添加标签前增加SQL查询判断是否存在同名。 - 侧边栏适配折叠屏
SideBarContainer可以根据窗口宽度自动切换Overlay/Embed模式,大屏常驻侧边栏,小屏悬浮侧边栏。 - 标签排序
可以增加置顶、自定义排序字段,替换默认按创建时间排序。 - 删除保护
删除标签前增加弹窗确认,避免误删。
后续扩展方向
- 标签拖拽排序
- 标签颜色自定义选择器
- 标签批量导入导出
- 标签和笔记搜索组合筛选
【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱:
cloudbbs@huaweicloud.com
- 点赞
- 收藏
- 关注作者
评论(0)