O2M 移动端原生能力 API 文档
由 0x400 发布于
### 1. alert(obj)
- **描述**:原生 Alert 提示弹出窗
- **参数**:
```javascript
{
title: "提示", // 消息标题(可选)
message: "消息内容", // 消息内容
buttonName: "确定", // 确定按钮名称
onSuccess: function, // 成功回调
onFail: function // 失败回调
}
```
- **示例**:
```javascript
o2m.notification.alert({
message: "亲爱的",
buttonName: "收到",
onSuccess: () => {}
});
```
### 2. confirm(obj)
- **描述**:原生 Confirm 提示弹出窗
- **参数**:
```javascript
{
title: "提示", // 消息标题(可选)
message: "消息内容",
buttonLabels: ["确定", "取消"], // 按钮名称数组
onSuccess: function(buttonIndex), // 回调参数:被点击按钮的索引(0 开始)
onFail: function
}
```
### 3. prompt(obj)
- **描述**:原生 Prompt 输入提示窗
- **参数**:
```javascript
{
title: "提示", // 消息标题(可选)
message: "消息内容",
buttonLabels: ["继续", "不玩了"],
onSuccess: function(result), // 回调参数:{ buttonIndex: 0, value: "输入值" }
onFail: function
}
```
### 4. toast(obj)
- **描述**:轻量级 Toast 提示
- **参数**:
```javascript
{
message: "提示信息",
onSuccess: function,
onFail: function
}
```
## 二、日期与时间选择
### 1. datePicker(obj)
- **描述**:日期选择器
- **参数**:
```javascript
{
value: "2023-10-01", // 默认显示日期
onSuccess: function(result), // 回调参数:{ value: "选中日期" }
onFail: function
}
```
### 2. timePicker(obj)
- **描述**:时间选择器
- **参数**:
```javascript
{
value: "14:30", // 默认显示时间
onSuccess: function(result), // 回调参数:{ value: "选中时间" }
onFail: function
}
```
### 3. chooseInterval(obj)
- **描述**:日期区间选择器
- **参数**:
```javascript
{
startDate: "2023-10-01",
endDate: "2023-10-03",
onSuccess: function(result), // 回调参数:{ startDate: "开始日期", endDate: "结束日期" }
onFail: function
}
```
## 三、设备相关功能
### 1. scan(obj)
- **描述**:扫码功能
- **参数**:
```javascript
{
onSuccess: function(result), // 回调参数:扫码结果字符串
onFail: function
}
```
### 2. location(obj)
- **描述**:单次定位功能
- **参数**:
```javascript
{
onSuccess: function(result), // 回调参数:{ latitude, longitude, address }
onFail: function
}
```
### 3. localAuth(obj)
- **描述**:生物识别认证
- **参数**:
```javascript
{
onSuccess: function(result), // 回调参数:{ value: Boolean }
onFail: function
}
```
## 四、导航与页面控制
### 1. close()
- **描述**:关闭当前原生页面
- **示例**:
```javascript
o2m.util.navigation.close();
```
### 2. openInnerApp(obj)
- **描述**:打开内部应用(如待办、考勤等)
- **参数**:
```javascript
{
appKey: "attendance", // 应用标识
portalFlag: "门户标识", // 门户专用参数
portalTitle: "门户标题",
portalPage: "页面 ID",
onSuccess: function,
onFail: function
}
```
### 3. openWindow(obj)
- **描述**:新窗口打开网页
- **参数**:
```javascript
{
url: "https://www.o2oa.net",
onSuccess: function,
onFail: function
}
```
## 五、通讯录选择器
### 1. PersonPicker(obj)
- **描述**:人员选择器
- **参数**:
```javascript
{
multiple: true, // 是否多选
maxNumber: 0, // 最大选择数
pickedUsers: [], // 已选人员 DN 列表
onSuccess: function(result), // 回调参数:{ users: Array<Person> }
onFail: function
}
```
### 2. ComplexPicker(obj)
- **描述**:复合选择器(支持部门、身份、群组、人员)
- **参数**:
```javascript
{
pickMode: ["departmentPicker", "identityPicker"], // 选择器类型
multiple: true,
onSuccess: function(result), // 回调参数包含所有选中类型的数据
onFail: function
}
```
## 六、其他实用方法
### 1. setTitle(obj)
- **描述**:设置页面标题
- **参数**:
```javascript
{
title: "新标题",
onSuccess: function,
onFail: function
}
```
### 2. vibrate(obj)
- **描述**:手机震动
- **参数**:
```javascript
{
duration: 300, // 震动时长(Android 有效)
onSuccess: function,
onFail: function
}
```
## 注意事项
1. **使用范围**:仅在 O2OA 移动端 APP 中生效
2. **回调处理**:所有异步方法需通过 `onSuccess`/`onFail` 处理结果
3. **权限要求**:部分功能(如定位、扫码)需确保已获取对应权限
评论