android html属性,h5-plus/android.html at master · lichunqiang/h5-plus · GitHub

本文详细介绍了如何在H5中通过Android Native.js调用Java接口,包括importClass、newObject、getAttribute、setAttribute、invoke等方法,实现JavaScript与Android的深度交互,支持调用系统API和获取主Activity实例。
摘要由CSDN通过智能技术生成
Hello H5+
Android Document

android

Native.js for Android封装一条通过JS语法直接调用Native Java接口通道,通过plus.android可调用几乎所有的系统API。

方法:

对象:

权限:

permissions

 
  

"Invocation": {

"description": "Javascript桥"

}

importClass

导入Java类对象

 
  

ClassObject plus.android.importClass( String classname );

说明:

导入类对象后,就可以通过.操作符直接调用对象(类对象/示例对象)的常量和方法。

注意:导入类对象将会消耗较多的系统资源,通常不应该导入过多的类对象。

参数:

  • classname:

    (

    String

    )

    必选 要导入的Java类名,使用"."分割命名空间

    在类名中可以使用"*"来导入指定命名空间下的所有类对象;

    如果指定的类名无效,则导入类对象失败;

返回值:

ClassObject

: Java类对象,如果导入类对象失败则返回null。

示例:

 
  

<!DOCTYPE html>

<html>

<head>

<meta charset="utf-8"/>

<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>

<title>Android Javascript Bridge</title>

<script type="text/javascript">

// 监听plusready事件

document.addEventListener( "plusready", function(){

// 扩展API加载完毕,现在可以正常调用扩展API

}, false );

</script>

</head>

<body>

</body>

</html>

newObject

创建实例对象

 
  

void plus.android.newObject( String classname, Object..args );

参数:

  • classname:

    (

    String

    )

    必选 要创建实例对象的类名,使用"."分割命名空间
    如果指定的类名不存在,则创建对象失败,不会抛出异常。

  • args:

    (

    Object

    )

    可选 创建实例对象的构造参数
    如果指定的构造参数类型不区配,则创建对象失败,不会抛出异常。

返回值:

InstanceObject

: Android实例对象,如果创建对象失败则返回null。

示例:

 
  

<!DOCTYPE html>

<html>

<head>

<meta charset="utf-8"/>

<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>

<title>Android Javascript Bridge</title>

<script type="text/javascript">

// 监听plusready事件

document.addEventListener( "plusready", function(){

// 扩展API加载完毕,现在可以正常调用扩展API

}, false );

</script>

</head>

<body>

</body>

</html>

getAttribute

获取对象(类对象/示例对象)的属性值

 
  

Object plus.android.getAttribute( Object obj, String name );

参数:

  • obj:

    (

    Object

    )

    必选 要获取属性值的对象,也可以是类的名称

    如果obj为类对象,则获取的是类的静态属性值;如果obj为实例对象,则获取的是实例的属性值;

    如果obj为字符串类型,其值必须是类的名称,则获取是类的静态属性值;

  • name:

    (

    String

    )

    必选 要获取的属性名称
    如果指定的属性名称不存在,则获取属性失败,不会抛出异常。

返回值:

Object

: 属性值对象,如果获取属性失败则返回null。

示例:

 
  

<!DOCTYPE html>

<html>

<head>

<meta charset="utf-8"/>

<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>

<title>Android Javascript Bridge</title>

<script type="text/javascript">

// 监听plusready事件

document.addEventListener( "plusready", function(){

// 扩展API加载完毕,现在可以正常调用扩展API

}, false );

</script>

</head>

<body>

</body>

</html>

setAttribute

设置对象(类对象/示例对象)的属性值

 
  

void plus.android.setAttribute( Object obj, String name, Object value );

参数:

  • obj:

    (

    Object

    )

    必选 要设置属性值的对象,也可以是类的名称

    如果obj为类对象,则设置的是类的静态属性值;如果obj为实例对象,则设置的是实例的属性值;

    如果obj为字符串类型,其值必须是类的名称,则设置是类的静态属性值;

  • name:

    (

    String

    )

    必选 要设置的属性名称
    如果指定的属性名称不存在,则操作不生效,不会抛出异常。

  • value:

    (

    Object

    )

    必选 要设置的属性值
    如果指定的属性值类型不区配,则操作不生效,不会抛出异常。

返回值:

void

: 无

示例:

 
  

<!DOCTYPE html>

<html>

<head>

<meta charset="utf-8"/>

<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>

<title>Android Javascript Bridge</title>

<script type="text/javascript">

// 监听plusready事件

document.addEventListener( "plusready", function(){

// 扩展API加载完毕,现在可以正常调用扩展API

}, false );

</script>

</head>

<body>

</body>

</html>

invoke

调用对象(类对象/示例对象)的方法

 
  

Object plus.android.invoke( Object obj, String name, Object... args );

参数:

  • obj:

    (

    Object

    )

    必选 调用方法所属的对象,也可以是类的名称

    如果obj为类对象,则调用的是类的静态方法;如果obj为实例对象,则调用的是实例的方法;

    如果obj为字符串类型,其值必须是类的名称,则调用的是类的静态方法;

  • name:

    (

    String

    )

    必选 要调用的方法名称

    方法名称中使用":"分隔参数。

    如果指定的方法名称不存在,则调用方法失败,不会抛出异常。

  • args:

    (

    Object

    )

    可选 调用方法的参数
    如果指定的参数数目或类型不区配,则调用方法失败,不会抛出异常。

返回值:

Object

: 调用方法的返回值,如果调用方法失败,则返回undefined。

示例:

 
  

<!DOCTYPE html>

<html>

<head>

<meta charset="utf-8"/>

<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>

<title>Android Javascript Bridge</title>

<script type="text/javascript">

// 监听plusready事件

document.addEventListener( "plusready", function(){

// 扩展API加载完毕,现在可以正常调用扩展API

}, false );

</script>

</head>

<body>

</body>

</html>

implements

实现Interface的方法

 
  

Object plus.android.implements( String name, Object obj );

参数:

  • name:

    (

    String

    )

    必选 Interface的名称,也可以是自定的字符串名称

    如果name为自定的字符串名称,则自定义一个Interface;

  • obj:

    (

    Object

    )

    必选 JSON对象类型,Interface实现方法的定义

    JSON对象中key值为Interface方法的名称;value值为Function。

返回值:

InstanceObject

: Interface实例对象。

示例:

 
  

<!DOCTYPE html>

<html>

<head>

<meta charset="utf-8"/>

<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>

<title>Android Javascript Bridge</title>

<script type="text/javascript">

// 监听plusready事件

document.addEventListener( "plusready", function(){

// 扩展API加载完毕,现在可以正常调用扩展API

}, false );

</script>

</head>

<body>

</body>

</html>

runtimeMainActivity

获取应用主Activity实例对象

 
  

InstanceObject plus.android.runtimeMainActivity();

参数:

返回值:

InstanceObject

: 主Activity实例对象。

示例:

 
  

<!DOCTYPE html>

<html>

<head>

<meta charset="utf-8"/>

<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>

<title>Android Javascript Bridge</title>

<script type="text/javascript">

// 监听plusready事件

document.addEventListener( "plusready", function(){

// 扩展API加载完毕,现在可以正常调用扩展API

}, false );

</script>

</head>

<body>

</body>

</html>

ClassObject

Java类对象

 
  

interface ClassObject {

// ...

function Object plusGetAttribute( String name );

function Object plusSetAttribute( String name, Object value );

// ...

}

说明:

Java类对象,可通过其属性获取类的常量,可通过方法来操作类的静态变量和方法,也通过new方法来创建类的实例对象。

对于类的常量,则直接通过.后面跟随常量名称调用即可。

方法:

plusGetAttribute

获取Java类对象的静态属性

 
  

Object clsobj.plusGetAttribute( String name );

参数:

  • name:

    (

    String

    )

    必选 要获取的静态属性名称
    如果指定的属性名称不存在,则返回null。

返回值:

Object

: 静态属性实例对象

示例:

 
  

<!DOCTYPE html>

<html>

<head>

<meta charset="utf-8"/>

<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>

<title>Android Javascript Bridge</title>

<script type="text/javascript">

// 监听plusready事件

document.addEventListener( "plusready", function(){

// 扩展API加载完毕,现在可以正常调用扩展API

}, false );

</script>

</head>

<body>

</body>

</html>

plusSetAttribute

设置Java类对象的静态属性

 
  

void clsobj.plusSetAttribute( String name, Object value );

参数:

  • name:

    (

    String

    )

    必选 要设置的静态属性名称
    如果指定的属性名称不存在,则操作不生效,不会抛出异常。

  • value:

    (

    Object

    )

    必选 要设置的静态属性值
    如果指定的属性值类型不区配,则操作不生效,不会抛出异常。

返回值:

void

: 无

示例:

 
  

<!DOCTYPE html>

<html>

<head>

<meta charset="utf-8"/>

<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>

<title>Android Javascript Bridge</title>

<script type="text/javascript">

// 监听plusready事件

document.addEventListener( "plusready", function(){

// 扩展API加载完毕,现在可以正常调用扩展API

}, false );

</script>

</head>

<body>

</body>

</html>

InstanceObject

Java实例对象

 
  

interface InstanceObject {

// ...

function Object plusGetAttribute( String name );

function Object plusSetAttribute( String name, Object value );

// ...

}

说明:

Java实例对象,可通过其方法来操作示例的变量和方法。

注意:必须通过plusGetAttribute()方法读取示例对象的属性值,通过plusSetAttribute()方法设置示例对象的属性值。

方法:

plusGetAttribute

获取Java实例对象的属性

 
  

Object insobj.plusGetAttribute( String name );

参数:

  • name:

    (

    String

    )

    必选 实例属性的名称
    如果指定的属性名称不存在,则返回null。

返回值:

Object

: 属性的实例对象

示例:

 
  

<!DOCTYPE html>

<html>

<head>

<meta charset="utf-8"/>

<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>

<title>Android Javascript Bridge</title>

<script type="text/javascript">

// 监听plusready事件

document.addEventListener( "plusready", function(){

// 扩展API加载完毕,现在可以正常调用扩展API

}, false );

</script>

</head>

<body>

</body>

</html>

plusSetAttribute

设置Java示例对象的属性

 
  

void insobj.plusSetAttribute( String name, Object value );

参数:

  • name:

    (

    String

    )

    必选 要设置的属性名称
    如果指定的属性名称不存在,则操作不生效,不会抛出异常。

  • value:

    (

    Object

    )

    必选 要设置的属性值
    如果指定的属性值类型不区配,则操作不生效,不会抛出异常。

返回值:

void

: 无

示例:

 
  

<!DOCTYPE html>

<html>

<head>

<meta charset="utf-8"/>

<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>

<title>Android Javascript Bridge</title>

<script type="text/javascript">

// 监听plusready事件

document.addEventListener( "plusready", function(){

// 扩展API加载完毕,现在可以正常调用扩展API

}, false );

</script>

</head>

<body>

</body>

</html>

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值