本文在官方文档的基础上增加了一些实例。
打开 Sorted³ 的 URL Scheme
打开特定视图
基础语句:sorted://x-callback-url/open?item=参数
可用的参数:today , inbox , new , search
示例:
打开今日视图:sorted://x-callback-url/open?item=today
打开 Inbox 视图:sorted://x-callback-url/open?item=inbox
打开新建视图:sorted://x-callback-url/open?item=new
打开搜索视图:sorted://x-callback-url/open?item=search
打开特定日期
基础语句:sorted://x-callback-url/open?date=2018–07–20
可用的日期参数:today , tomorrow , yesterday
也可以使用具体的日期,日期格式为 yyyy-MM-dd
。
示例:
打开 2018 年 7 月 20 日的任务视图:sorted://x-callback-url/open?date=2018–07–20
打开今日视图:sorted://x-callback-url/open?date=today
打开明日视图:sorted://x-callback-url/open?date=tomorrow
打开昨日视图:sorted://x-callback-url/open?date=yesterday
打开特殊日期
基础语句:sorted://x-callback-url/open?offset=1
特殊的日期参数:
offset
从今日算起的天数。比如明天是 1,后天是 2,以此类推。weekday
下一个工作日编号,比如周末是 1,周一是 2,以此类推。
示例:
打开 1 天后的视图:sorted://x-callback-url/open?offset=1
打开 2 天后的视图:sorted://x-callback-url/open?offset=2
打开下个周日的视图:sorted://x-callback-url/open?weekday=1
打开下个周二的视图:sorted://x-callback-url/open?weekday=3
打开特殊视图
基础语句:sorted://x-callback-url/open?参数
可用的参数:list
列表的名称tag
标签的名称search
项目的关键词filterByTags
可用多个标签筛选,用逗号分隔
示例:
打开名为 Meeting 的列表视图:sorted://x-callback-url/open?list=Meeting
打开名为 Meeting 的标签视图:sorted://x-callback-url/open?tag=Meeting
打开 Meeting 的搜索视图:sorted://x-callback-url/open?search=Meeting
在 Sorted³ 中添加任务的 URL Scheme
基础语句:sorted://x-callback-url/add?参数
参数可以是标题、列表、标签、日期等等。其中只有标题是必填项,其余都是选填项。形式为 参数={{内容}}
(不包含{{}}
),参数之间用 &
连接,可以模仿下面的示例。
可用的参数:
任务标题 title
:必填,如果标题中带有「空格」,则需要转码为 %20
。
任务类型 type
:可选,类型可以是任务 task
或是日程 event
。如果不填,默认为添加任务 task
。
任务日期 date
:可选,日期格式统一为 yyyy-MM-dd
或者详细到时间 yyyy-MM-dd HH:mm
。
任务时间 time
:可选,时间用 HH:mm
格式,如果已经在日期 date
中给出,这一项会被忽略。
任务持续时间 duration
:可选,格式以分钟为单位,也可以用事件的结束日期。
任务提醒 earlyAlert
:可选,提前几分钟通知,设置为 none
则没有警报。
仅适用于任务 Task 的参数
任务列表 list
:可选,列表的名称。
任务标签 tags
:可选,可添加多个标签,用逗号分隔。
任务锁定 lock
:可选,项目是否被锁定locked
,默认是不锁定 unlocked
。
任务完成日期 completionDate
:可选项,日期格式统一为 yyyy-MM-dd
或者详细到时间 yyyy-MM-dd HH:mm
。
仅适用于日程 Event 的参数
日历名称 calendar
:可选,日历的名称。
日程地点 location
:可选,地点的名称。
示例
添加一个简单任务:sorted://x-callback-url/add?title={{任务名称}}
添加一个日程:sorted://x-callback-url/add?title={{任务名称}}&type={{event}}&calendar={{默认日历}}&location={{上海市}}
添加一个带有列表和日期的普通任务:sorted://x-callback-url/add?title={{任务名称}}&list={{任务列表}}&date={{2018-08-30}}
添加一个所有可用参数的重度任务:sorted://x-callback-url/add?title={{任务名称}}&type={{task}}&date={{2018-08-30}}&duration={{30}}&earlyAlert={{15}}&tag={{标签名称}}
参考资料
Sorted³ 官方文档:https://medium.com/sorted-app/url-scheme-d05bc416d37c
少数派关于 Sorted³ 的介绍文章:https://sspai.com/post/46948