Introduction
In this article I describe how to create a Windows Store App for Composite Setting using JavaScript. Composite settings are used to group multiple settings. It is useful for storing related settings or settings that are always changed together. Note that these are treated as one atomic unit during roaming conflict resolution. Use the following to read, write, and delete a composite setting:
- Windows.Storage.ApplicationData.current.roamingSettings
- Windows.Storage.ApplicationDataCompositeValue
I assume you can create a simple Windows Store App using JavaScript. For more help visit Simple Windows Store Apps using JavaScript.
To start the creation of the app, add two JavaScript pages by right-clicking on the js folder in the Solution Explorer and select Add > new item > JavaScript Page and then give an appropriate name. In the same way, add one HTML page to your project.
![composite-setting-in-Windows-store-app.jpg]()
Write the following code in default.html:
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8" />
<title></title>
<link rel="stylesheet" href="//Microsoft.WinJS.1.0/css/ui-light.css" />
<script src="//Microsoft.WinJS.1.0/js/base.js"></script>
<script src="//Microsoft.WinJS.1.0/js/ui.js"></script>
<link rel="stylesheet" href="/css/default.css" />
<script src="/js/script1.js"></script>
<script src="/js/default.js"></script>
</head>
<body role="application" style="background-color: lightgray">
<center><div id="rootGrid">
<div id="content">
<h1 id="featureLabel"></h1>
<div id="contentHost"></div>
</div>
</div></center>
</body>
</html>
Write the following code in default.js:
(function () {
"use strict";
var sampleTitle = "";
var scenarios = [
{ url: "page.html" }
];
function activated(eventObject) {
if (eventObject.detail.kind === Windows.ApplicationModel.Activation.ActivationKind.launch) {
eventObject.setPromise(WinJS.UI.processAll().then(function () {
var url = WinJS.Application.sessionState.lastUrl || scenarios[0].url;
return WinJS.Navigation.navigate(url);
}));
}
}
WinJS.Navigation.addEventListener("navigated", function (eventObject) {
var url = eventObject.detail.location;
var host = document.getElementById("contentHost");
host.winControl && host.winControl.unload && host.winControl.unload();
WinJS.Utilities.empty(host);
eventObject.detail.setPromise(WinJS.UI.Pages.render(url, host, eventObject.detail.state).then(function () {
WinJS.Application.sessionState.lastUrl = url;
}));
});
WinJS.Namespace.define("SdkSample", {
sampleTitle: sampleTitle,
scenarios: scenarios
});
WinJS.Application.addEventListener("activated", activated, false);
WinJS.Application.start();
})();
Write the following code in page.html:
<!DOCTYPE html>
<html>
<head>
<title></title>
<link rel="stylesheet" href="/css/default.css" />
<script src="/js/script.js"></script>
</head>
<body>
<div data-win-control="SdkSample.ScenarioInput">
<button id="compositeSettingsWriteCompositeSetting">Write </button>
<button id="compositeSettingsDeleteCompositeSetting">Delete </button>
</div>
<div data-win-control="SdkSample.ScenarioOutput">
<div id="compositeSettingsOutput"></div>
</div>
</body>
</html>
Write the following code in script.html:
(function () {
"use strict";
var page = WinJS.UI.Pages.define("page.html", {
ready: function (element, options) {
document.getElementById("compositeSettingsWriteCompositeSetting").addEventListener("click", compositeSettingsWriteCompositeSetting, false);
document.getElementById("compositeSettingsDeleteCompositeSetting").addEventListener("click", compositeSettingsDeleteCompositeSetting, false);
compositeSettingsDisplayOutput();
}
});
var roamingSettings = Windows.Storage.ApplicationData.current.roamingSettings;
var settingName = "exampleCompositeSetting";
var settingName1 = "one";
var settingName2 = "hello";
function compositeSettingsWriteCompositeSetting() {
var composite = new Windows.Storage.ApplicationDataCompositeValue();
composite[settingName1] = 1;
composite[settingName2] = "world";
roamingSettings.values[settingName] = composite;
compositeSettingsDisplayOutput();
}
function compositeSettingsDeleteCompositeSetting() {
roamingSettings.values.remove(settingName);
compositeSettingsDisplayOutput();
}
function compositeSettingsDisplayOutput() {
var composite = roamingSettings.values[settingName];
if (!composite) {
document.getElementById("compositeSettingsOutput").innerText = "Composite Setting: <empty>";
} else {
document.getElementById("compositeSettingsOutput").innerText = "Composite Setting: {"
+ settingName1
+ " = "
+ composite[settingName1]
+ ", "
+ settingName2
+ " = \""
+ composite[settingName2]
+ "\"}";
}
}
})();
Write the following code in script1.html:
(function () {
var ScenarioOutput = WinJS.Class.define(
function (element, options) {
element.winControl = this;
this.element = element;
new WinJS.Utilities.QueryCollection(element)
.setAttribute("role", "region")
.setAttribute("aria-labelledby", "outputLabel")
.setAttribute("aria-live", "assertive");
element.id = "output";
this._addOutputLabel(element);
this._addStatusOutput(element);
}, {
_addOutputLabel: function (element) {
var label = document.createElement("h2");
label.id = "outputLabel";
label.textContent = "";
element.parentNode.insertBefore(label, element);
},
_addStatusOutput: function (element) {
var statusDiv = document.createElement("div");
statusDiv.id = "statusMessage";
element.insertBefore(statusDiv, element.childNodes[0]);
}
}
);
var currentScenarioUrl = null;
WinJS.Navigation.addEventListener("navigating", function (evt) {
currentScenarioUrl = evt.detail.location;
});
WinJS.log = function (message, tag, type) {
var statusDiv = document.getElementById("statusMessage");
};
function activated(e) {
WinJS.Utilities.query("#featureLabel")[0].textContent = SdkSample.sampleTitle;
}
WinJS.Application.addEventListener("activated", activated, false);
WinJS.Namespace.define("SdkSample", {
ScenarioOutput: ScenarioOutput
});
})();
Output:
![composite-setting-in-Windows-store-apps.jpg]()
Summary
In this app I described Composite Settings in the Windows Store using JavaScript. I hope this article has helped you to understand this topic. Please share if you know more about this. Your feedback and constructive contributions are welcome.