问题标签 [design-guidelines]

For questions regarding programming in ECMAScript (JavaScript/JS) and its various dialects/implementations (excluding ActionScript). Note JavaScript is NOT the same as Java! Please include all relevant tags on your question; e.g., [node.js], [jquery], [json], [reactjs], [angular], [ember.js], [vue.js], [typescript], [svelte], etc.

0 投票
1 回答
705 浏览

rest - REST API 设计指南合规性测试

给定一个 REST 接口的正式规范——比如一个 Swagger 2.0 文件——我想在设计时针对接口本身的一组简单的预定义设计指南对其进行测试。指南由强制(MUST)和非强制(SHOULD、COULD)语句组成,其中只有 MUST 需要强制执行。

事实:

  • 编写 API 和相应 Swagger 文件的人不是 REST 专家,尽管他们应该应用上述设计规则,但他们不会这样做 - 至少不完全如此
  • 很多 Swagger 文件,所以我需要一个自动工具来实现这个目的。不偏爱任何技术或编程语言
  • 验证规则将来可能会改变

例子:

要强制执行的规则:REST API 的任何 URI 都不能包含“进程”一词

测试用例 n.1

测试用例 n.2

你知道有什么工具可以完成这项工作吗?

0 投票
0 回答
240 浏览

android - 带有滚动的 ConstraintLayout 指南

我正在使用 ConstraintLayout 构建一个屏幕,我的屏幕需要滚动,因为它是一个很长的数据列表。对于普通屏幕,我使用指南并根据百分比安排视图。如何使用 Guideline 制作可滚动屏幕?

0 投票
0 回答
151 浏览

swift - Swift API 设计指南 - 初始化器和工厂方法调用

Swift API 设计指南说:

初始化器和工厂方法调用的第一个参数不应形成以基本名称开头的短语

特别是,它建议我们不要写这样的东西:

但在 Swift 标准库或 UIKit 中,我们发现如下代码:

这是对的吗?

0 投票
2 回答
140 浏览

ios - 是否可以在 iOS 应用启动时请求日历和推送通知访问权限?

我的应用程序需要日历和通知访问。我知道这不是要求用户在应用程序首次启动时接受一堆请求的最佳方法,但目前无法重新考虑应用程序设计。所以我在这个阶段的问题是——如果我在应用启动时一一提出这两个请求,App Store 会批准我的应用吗?还是我会违反一些重要的 Apple 准则?

更新

找到https://developer.apple.com/ios/human-interface-guidelines/app-architecture/requesting-permission/

如果我在启动时提出 2 个请求,我的应用程序是否会被拒绝,目前尚不清楚。

0 投票
1 回答
88 浏览

junit - 使用 JUnit 和 Mockito 测试方法结果的最佳方法

我正在尝试测试该方法:

我的第一个猜测是通过以下方式对其进行测试:

但它给了我错误信息:

org.mockito.exceptions.misusing.MissingMethodInvocationException: when() 需要一个参数,该参数必须是“模拟的方法调用”。例如:when(mock.getArticles()).thenReturn(articles);

所以我最终做了:

这里的问题是,您何时建议使用 Mockinto.when() 方法以及何时使用 Assert.equals()。

任何帮助将不胜感激!

0 投票
2 回答
125 浏览

c# - 为什么指南说“避免异步无效”而不是说“不要避免等待任务”

为什么指南说“避免async void”。我不知道,但我觉得指南应该说-“ await task”。问题async void是调用者将不知道它是否需要await完成并且控制将继续执行以下语句。我能理解这带来的不良影响。但是即使async方法返回task而不是void,调用者仍然可能错过等待并遇到相同的问题,对吗?因此问题是,为什么不指导方针而不是说 -不要避免等待任务

0 投票
1 回答
70 浏览

abap - ABAP 真实生活计划使用指南

ABAP 指南中,包含使用指南的对象的包 SABAP_DEMOS_CAR_RENTAL 被提及,但我正在寻找使用此指南的 SAP 程序。

一般来说,SAP程序太大了,我迷失在源代码中,所以有人知道一些易于识别使用指南的程序吗?

谢谢

0 投票
1 回答
2052 浏览

ios - 如果钱包里没有卡,Apple Pay 按钮的首选行为是什么?

我查看了苹果指南,但没有发现任何关于这个问题的信息。

附加信息:

我已将 Apple Pay 按钮添加到应用程序,如果没有可用于支付的功能(例如卡),则将其隐藏。但是客户不喜欢它并想要其他方法。我认为我们可能会像要求用户添加卡一样打开钱包,但我不确定 Apple 指南对此有何看法。

有没有关于它的明确建议?

0 投票
2 回答
59 浏览

android - Android - 如何根据为不同屏幕附加的图像创建布局?

Android - 如何根据为不同屏幕附加的图像创建布局? 截屏

0 投票
1 回答
562 浏览

macos - 更改 Atom 编辑器复制/粘贴行为

Atom 编辑器是一个非常好的产品,但在某些方面它试图偏离操作系统长期存在的用户界面标准,这可能非常烦人。

例如,在运行 OS/X 的 Mac 上,所有符合 Apple 指南的应用程序都将通过保持剪贴板完好无损来处理没有选择的复制命令。在 Atom 上,如果该行为空,此操作将删除剪贴板的内容,或者用整行的内容覆盖它们。

偏离这种非常基本的用户界面指南并不是一个好主意,但如果要这样做,偏离应该是一个选项,而不是默认设置。

有没有办法通过选项或脚本强制 Atom 在 Mac 上表现得像它应该的那样?