npmpackage.info

Gathering detailed insights and metrics for cordova-plugin-ios-screen-orientation

Gathering detailed insights and metrics for cordova-plugin-ios-screen-orientation

cordova-plugin-ios-screen-orientation - 1.0.14-dev | npmpackage.info

cordova-plugin-ios-screen-orientation

Apache Cordova Screen Orientation Plugin

1.0.14-dev

217

Apache-2.0

JavaScript

Installations

npm install cordova-plugin-ios-screen-orientation

Developer Guide

BETA

Typescript

No

Module System

N/A

Node Version

6.9.4

NPM Version

3.10.10

Pull Requests

Open

5

Total

87

Closed

33

Merged

49

Issues

Open

15

Total

44

Closed

29

Releases

Unable to fetch releases

Languages

3

JavaScript

Objective-C

Java

JavaScript (52.32%)

Objective-C (33.45%)

Java (14.23%)

Developer

Download Statistics

Total Downloads

0

Last Day

0

Last Week

0

Last Month

0

Last Year

0

GitHub Statistics

Apache-2.0 License

217 Stars

220 Commits

232 Forks

32 Watchers

7 Branches

47 Contributors

Updated on May 27, 2025

Maintainers

1

View All 47 Contributors

Package Meta Information

Latest Version

1.0.14-dev

Package Id

cordova-plugin-ios-screen-orientation@1.0.14-dev

Size

11.33 kB

NPM Version

3.10.10

Node Version

6.9.4

Total Downloads

Cumulative downloads

Total Downloads

NaN

Last Day

0%

NaN

Compared to previous day

Last Week

0%

NaN

Compared to previous week

Last Month

0%

NaN

Compared to previous month

Last Year

0%

NaN

Compared to previous year

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dev Dependencies

1

Android 4.4	Android 5.1	iOS 9.3	iOS 10.0	Windows 10 Store

Cordova Screen Orientation Plugin

Cordova plugin to set/lock the screen orientation in a common way for iOS, Android, WP8 and Blackberry 10. This plugin is based on Screen Orientation API so the api matches the current spec.

The plugin adds the following to the screen object (window.screen):

1// lock the device orientation
2.orientation.lock('portrait')
3
4// unlock the orientation
5.orientation.unlock()
6
7// current orientation
8.orientation

Install

1cordova plugin add cordova-plugin-screen-orientation

Supported Orientations

portrait-primary

The orientation is in the primary portrait mode.

portrait-secondary

The orientation is in the secondary portrait mode.

landscape-primary

The orientation is in the primary landscape mode.

landscape-secondary

The orientation is in the secondary landscape mode.

portrait

The orientation is either portrait-primary or portrait-secondary (sensor).

landscape

The orientation is either landscape-primary or landscape-secondary (sensor).

any

orientation is unlocked - all orientations are supported.

Usage

1// set to either landscape
2screen.orientation.lock('landscape');
3
4// allow user rotate
5screen.orientation.unlock();
6
7// access current orientation
8console.log('Orientation is ' + screen.orientation.type);

Events

Both android and iOS will fire the orientationchange event on the window object. For this version of the plugin use the window object if you require notification.

Example usage

1window.addEventListener("orientationchange", function(){
2    console.log(screen.orientation.type); // e.g. portrait
3});

The 'change' event listener has also been added to the screen.orientation object.

Example usage

1screen.orientation.addEventListener('change', function(){
2    console.log(screen.orientation.type); // e.g. portrait
3});
4    // OR
5
6screen.orientation.onchange = function(){console.log(screen.orientation.type);
7};
8

Android Notes

The screen.orientation property will not update when the phone is rotated 180 degrees.

BB10 Notes

Wraps the com.blackberry.app plugin functions, auto installed as a dependancy.

WP8 Notes

Windows phone does not support specification or primary and secondary orientations. If called with a specific orientation the plugin will just apply the landscape or portait orientation.

W8.1 Notes

Windows 8.1 Applicaitons (runtime/metro applications) will only display orientation changes if the device has some sort of accelerometer. The internal state of the "orientation" will still be kept, but the actual screen won't rotate unless the device supports it.

Legacy Changelog

See RELEASENOTES.md for the automated changelog.

Changelog

2.0.0

Common javascript for iOS, Android and Windows.

1.4.2

#101 make iOS rotate as needed when lockOrientation is called

1.4.1

#89 Fix for cordova >= 3.6.3

1.4.0

Added Windows 8.1 Support
#54 Background thread for ios
#64 Orientation naming bug fixed
Add portrait upside down to iOS default orientations

1.3.5-6

Plugin added to npm

1.3.4

Readme update

1.3.3

#53 WP8 Support

1.3.2

#33 iOS8 Delay Block

1.3.0

#23 iOS8 flicker

1.2.0-1.2.1

#19 iOS8 Crash

Pull requests welcome.

Empty State

No vulnerabilities found.

10

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

10

Dangerous-Workflow

Determines if the project's GitHub Action workflows avoid dangerous patterns.

10

License

Determines if the project has defined a license.

10

Security-Policy

Determines if the project has published a security policy.

7

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

7

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

3

Pinned-Dependencies

Determines if the project has declared and pinned the dependencies of its build process.

Reason

dependency not pinned by hash detected -- score normalized to 3

Details

Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/android.yml:97: update your workflow using https://app.stepsecurity.io/secureworkflow/apache/cordova-plugin-screen-orientation/android.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/android.yml:98: update your workflow using https://app.stepsecurity.io/secureworkflow/apache/cordova-plugin-screen-orientation/android.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/android.yml:101: update your workflow using https://app.stepsecurity.io/secureworkflow/apache/cordova-plugin-screen-orientation/android.yml/master?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/android.yml:132: update your workflow using https://app.stepsecurity.io/secureworkflow/apache/cordova-plugin-screen-orientation/android.yml/master?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/android.yml:146: update your workflow using https://app.stepsecurity.io/secureworkflow/apache/cordova-plugin-screen-orientation/android.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/chrome.yml:45: update your workflow using https://app.stepsecurity.io/secureworkflow/apache/cordova-plugin-screen-orientation/chrome.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/chrome.yml:46: update your workflow using https://app.stepsecurity.io/secureworkflow/apache/cordova-plugin-screen-orientation/chrome.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ios.yml:66: update your workflow using https://app.stepsecurity.io/secureworkflow/apache/cordova-plugin-screen-orientation/ios.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ios.yml:67: update your workflow using https://app.stepsecurity.io/secureworkflow/apache/cordova-plugin-screen-orientation/ios.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/lint.yml:40: update your workflow using https://app.stepsecurity.io/secureworkflow/apache/cordova-plugin-screen-orientation/lint.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/lint.yml:41: update your workflow using https://app.stepsecurity.io/secureworkflow/apache/cordova-plugin-screen-orientation/lint.yml/master?enable=pin
Warn: npmCommand not pinned by hash: .github/workflows/android.yml:125
Warn: npmCommand not pinned by hash: .github/workflows/android.yml:131
Warn: npmCommand not pinned by hash: .github/workflows/chrome.yml:60
Warn: npmCommand not pinned by hash: .github/workflows/chrome.yml:66
Warn: npmCommand not pinned by hash: .github/workflows/ios.yml:84
Warn: npmCommand not pinned by hash: .github/workflows/ios.yml:90
Info: 0 out of 9 GitHub-owned GitHubAction dependencies pinned
Info: 1 out of 3 third-party GitHubAction dependencies pinned
Info: 4 out of 10 npmCommand dependencies pinned

0

Maintained

Determines if the project is "actively maintained".

0

Token-Permissions

Determines if the project's workflows follow the principle of least privilege.

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

Fuzzing

Determines if the project uses fuzzing.

0

Branch-Protection

Determines if the default and release branches are protected with GitHub's branch protection settings.

0

SAST

Determines if the project uses static code analysis.

Score

4.6

/10

Last Scanned on 2025-07-14

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.