# winset and winget (JavaScript)

Source: https://ref.dm-lang.org/skin/control/browser/winset

Browser controls can interact with the skin via JavaScript, by setting `window.location` to a special URL.

## Winset

`byond://winset?id=*[control ID]*&*[property]*=*[value]*&...`

This works like an ordinary [winset()](https://ref.dm-lang.org/proc/winset.md) call from the server. If `id` is omitted, it's the same as a winset with a null ID. You can also leave the `id` blank if you use "fully decorated" property names such as `mybutton.is-checked` instead of just `is-checked`.

Any text you use other than letters, numbers, hyphens, commas, and periods should be encoded via the `encodeURIComponent()` function in JavaScript.

## Winget

`byond://winget?callback=*[callback function]*&id=*[control ID/list]*&property=*[property/list]*`

In this winget, the IDs and properties you want can be separated by commas if you want to retrieve more than one. The winget operation works via a callback function you must define in JavaScript. The callback is given just one argument, a JavaScript object with all of the properties you requested. For example, this URL:

```
byond://winget?callback=wgcb&id=button1&property=is-checked,size,background-color
```

...might send this to the callback function `wgcb`:

```
{
    "is-checked": true,
    "size": {
        "x": 60,
        "y": 20
    },
    "background-color": {
        "value": "none",
        "isDefault": true,
        "red": 236,
        "green": 233,
        "blue": 216,
        "alpha": 255,
        "css": "#ece9d8"
    }
}
```

The property names will be in the same format you would expect from [winget()](https://ref.dm-lang.org/proc/winget.md), so when you're looking at multiple elements' properties, you'll get the full names in `id.property` format. The values are always sent back in a convenient form for JavaScript to work with; in the case of size, position, and color these will always be objects.

An optional `control` parameter for the winget call can be used if you want to send data to a callback in a different browser control.

### See also
- [browser control (skin)](https://ref.dm-lang.org/skin/control/browser/index.md)
- [BYOND object (JavaScript)](https://ref.dm-lang.org/skin/control/browser/BYOND.md)
- [winset proc](https://ref.dm-lang.org/proc/winset.md)
- [winget proc](https://ref.dm-lang.org/proc/winget.md)