KaiOS Development ( Cursor Control)

kaios cursor control script

+8

To use a cursor control script in KaiOS, you do not need a complex JavaScript mouse emulator. The operating system features a built-in emulated cursor controlled natively via the hardware D-Pad. 

Depending on your KaiOS version and architecture, you can implement cursor control using System-managed configuration or App-managed JavaScript injection. 

---

1. System-Managed Cursor (Recommended)

This approach tells KaiOS to display a virtual mouse cursor automatically. The system takes care of positioning and automatically toggles the cursor off when typing inside an input field. 

KaiOS 1.0 & 2.5

Add the "cursor": true flag to your root application manifest file: 

json

// manifest.webapp
{
  "name": "My KaiOS App",
  "subtitle": "App with a virtual pointer",
  "type": "web",
  "cursor": true,
  "launch_path": "/index.html"
}

Use code with caution.

KaiOS 3.0+

In newer versions of the operating system, this parameter goes inside the b2g_features array block: 

json

// manifest.webmanifest
{
  "name": "My KaiOS App",
  "b2g_features": {
    "cursor": true
  }
}

Use code with caution.

---

2. App-Managed Cursor Script (JavaScript Control)

If you need complete control over precisely when the cursor appears or disappears during app execution, you must request spatial navigation management privileges. 

Step A: Configure the Manifest

Update your manifest file to declare the app as privileged and request the navigation permission token: 

json

// manifest.webapp
{
  "type": "privileged",
  "permissions": {
    "spatialnavigation-app-manage": {
      "description": "Required to toggle the emulated mouse pointer via script."
    }
  }
}

Use code with caution.

Step B: Use the JavaScript APIs

Once permission is granted, use the designated environment functions to programmatically control cursor presence. 

For KaiOS 2.5:

javascript

// Turn the mouse cursor ON
navigator.spatialNavigationEnabled = true;

// Turn the mouse cursor OFF
navigator.spatialNavigationEnabled = false;

Use code with caution.

For KaiOS 3.0+:

javascript

// Turn the mouse cursor ON
navigator.b2g.virtualCursor.enable();

// Turn the mouse cursor OFF
navigator.b2g.virtualCursor.disable();

Use code with caution.

---

3. Pure JavaScript Custom Cursor Script (Fallback/Websites)

If you are optimizing an external website loading inside a standard container and cannot modify system permissions, you can construct a simple virtual mouse loop manually:

javascript

(function() {
  // Create visual cursor element
  const cursor = document.createElement('div');
  cursor.style.position = 'fixed';
  cursor.style.width = '12px';
  cursor.style.height = '12px';
  cursor.style.background = 'red';
  cursor.style.borderRadius = '50%';
  cursor.style.zIndex = '99999';
  cursor.style.pointerEvents = 'none'; // Prevent element blocking clicks
  document.body.appendChild(cursor);

  // Initial Coordinates
  let posX = window.innerWidth / 2;
  let posY = window.innerHeight / 2;
  const speed = 15; // Pixels per keypress

  function updatePosition() {
    cursor.style.left = posX + 'px';
    cursor.style.top = posY + 'px';
  }
  updatePosition();

  // Listen for hardware D-pad movements
  window.addEventListener('keydown', function(e) {
    switch(e.key) {
      case 'ArrowUp':
        posY = Math.max(0, posY - speed);
        break;
      case 'ArrowDown':
        posY = Math.min(window.innerHeight, posY + speed);
        break;
      case 'ArrowLeft':
        posX = Math.max(0, posX - speed);
        break;
      case 'ArrowRight':
        posX = Math.min(window.innerWidth, posX + speed);
        break;
      case 'Enter':
      case 'Accept': // Center Selection Key (CSK)
        const target = document.elementFromPoint(posX, posY);
        if (target) target.click();
        break;
      default:
        return; 
    }
    e.preventDefault(); // Lock default browser viewport scrolling
    updatePosition();
  });
})();

Use code with caution.

Would you like to tailor this script to work with specific front-end UI frameworks like React, or are you designing for a specific version of a KaiOS target device?