用于声音识别的高度可重用UI组件
oui的Python项目详细描述
用户界面组件
为声音识别管道制作高度可重用的UI组件。在
如果有更多的人使用一个组件,重用是必然的。 那么我们如何让更多的人使用组件呢? 组件应为:
- 有用的
- 易于使用
- 易于调整(因为一种尺寸很少适合所有人)
我们应该记住三个“语境”:
- 用于前端开发
- 使用python(dash——或其他pyjs bridgin工具)
- 使用python(jupyter笔记本)
什么成分? 一些非常高级的(列表、表、嵌套数据)? 一些更具体的:听/看声音,配置CRUD等
建筑注释
以下只是建议,但请遵循这些建议,除非您有 有理由不这么做。另外,如果您对 拥有。在
每个组件一个文件夹,下面的__init__.py
中有python接口。在
如果python和js需要共享一些资源(比如设置、默认值等), 把它们放在一个地方(例如一个json文件),python和js都从这个位置 会得到这些。在
注释和尽可能多的包含默认值。我们希望组件 开箱即用,只有在需要的时候才调校。 默认值可以是哑值,也可以是“smart” (根据上下文动态设置)
说出你的价值观。例如,在代码中不是24
或3600
,而是定义
HOURS_PER_DAY = 24
和{
从代码中提取尽可能多的变量,并在 接口(例如函数参数或模块常量)。在
组件
请记住:我们需要用户使用的抽象对象和操作是什么 我们能提供什么样的方法来完成这些任务。在
我可以用什么方式让用户查看、导航、搜索、创建, 或者编辑。。。列表、表格、嵌套数据?在
我们通常处理哪些类型的数据,以什么形式处理,以及处理什么 我们要处理这些数据吗?我们有声音和注释。 我们希望能够上传和下载声音,听到和观看他们,做 CRUD on annotations,从annotations转到annotated(sound),然后参阅 我们对给定的声音有什么注解。在
等等
列表
查看json列表的方法。 需要一个列表导航和一个json查看协议。在
表格
理想情况下,它能自动适应环境 (例如,当桌子在水平/垂直方向上太小/太大时,我们该怎么做), 但是有很多属性可以关闭/打开或参数化 (例如可分类、可搜索、可折叠等)
嵌套数据
是否折叠/展开文件树视图? 逐页平面视图?在
配置积垢
听到声音
声音大的时候我们怎么办?在
查看声音
声音大的时候我们怎么办?在
谱图
声音大的时候我们怎么办?在
波形图(和聚合)
视听合一
飞溅物
命名选择
指声音、注释等
目录
有用的
轻松
适应性强
重用技巧
有用的
轻松
适应性强
- 项目
标签: