Array binding changes #

Data binding now supports a wider range of array types, including:

• arrays of strings
• polymorphic arrays
• multidimensional arrays
• arrays containing other containers

Support for these arrays requires setting the BindElement field in the ArrayInfo struct.

Required changes #

If you have:

• custom Property implementations, or
• overrides of GetArrayValue<>::Invoke

you must populate the BindElement field in the returned ArrayInfo. The callback is the same one passed to TryBindArrayByRef and can be reused directly.

Performance considerations #

Arrays of boolean values, numbers, and user-defined types are directly evaluated without going through creating JavaScript values.

Arrays types that require using the BindElement callback have some overhead due to converting the elements to JavaScript values.

If this becomes a concern, you can continue using the previous workaround of wrapping nested containers in a user-defined type. For example, instead of std::vector<std::vector<Foo>> use std::vector<Wrapper>, where Wrapper contains std::vector<Foo>.